Selective Pass Through
The Selective Pass Through component lets you send a specific value through your workflow only when a chosen condition is true. Think of it as a simple “if‑then” filter that outputs a value only when the input matches your criteria.
How it Works
When you drop this component into your dashboard, you give it five pieces of information:
- Input Value – the text you want to check.
- Comparison Value – the text you want to compare it against.
- Operator – the rule that decides if the two texts match (equals, not equals, contains, starts with, ends with).
- Value to Pass – the text that will be sent forward if the rule is satisfied.
- Case Sensitive – a switch that tells the component whether “Apple” is the same as “apple”.
The component evaluates the rule locally (no external calls). If the rule is true, it outputs the Value to Pass; otherwise it outputs nothing.
Inputs
- Input Value: The primary input value to evaluate.
- Comparison Value: The value to compare against the input value.
- Operator: Condition to evaluate the input value.
- Value to Pass: The value to pass if the condition is met.
- Case Sensitive: If true, the comparison will be case sensitive.
Outputs
- Passed Output: The value you specified in Value to Pass when the condition is met. If the condition is not met, this output is empty.
Usage Example
Suppose you want to forward a customer’s email address only if it ends with “@example.com”.
- Set Input Value to the customer’s email.
- Set Comparison Value to “@example.com”.
- Choose Operator “ends with”.
- Set Value to Pass to the same email address (or any other value you want to forward).
- Leave Case Sensitive off if you don’t care about letter case.
If the email ends with “@example.com”, the component outputs the email; otherwise it outputs nothing.
Related Components
- Conditional Router – Directs data to different paths based on a condition.
- Text Filter – Removes or keeps text that matches a pattern.
- Value Mapper – Transforms input values into new values using a mapping table.
Tips and Best Practices
- Use Operator “contains” for quick substring checks.
- Keep Case Sensitive off for user‑friendly comparisons unless exact casing matters.
- Combine this component with a Conditional Router to branch workflows based on the output.
Security Considerations
The component processes data locally and does not send information outside the Nappai system. Ensure that any sensitive text you pass through is handled according to your organization’s data‑privacy policies.