Skip to main content

Add Filters to a Task

Qalyptus allows you to apply filters to task reports before generation, so output data can be scoped to the required context.

Evaluation Order

Filters are evaluated in this order: task -> report -> object.

Adding Filters to a Task​

To add filters to a task report:

  1. Go to Tasks
  2. Click the task name to open it
  3. Go to the Reports tab
  4. Edit the target report
  5. Navigate to the Filters tab
  6. Select one or more filters
  7. Click Save
warning

If filter values do not match the field values, the filter has no effect and the report may contain all data without filtering.

Qalyptus task add filters

Filter Priority and Ordering​

When multiple filters are applied at the same level, their order affects the final result.

warning

Filter order is important. Arrange filters using the up and down arrows to get the expected output.

For best results:

  1. Apply broad filters first
  2. Apply more restrictive filters next
  3. Validate output with a test execution before enabling schedules

Managing Filter Changes​

If you modify a filter definition in Qalyptus Desktop, republish the project and review task report filters to ensure mappings and order are still correct.

If a filter is removed from the project, update affected task reports to avoid generation errors or unexpected output.

Example Use Cases​

  • Generate region-specific reports by applying a Region filter at task level
  • Apply a report-level Product Category filter only to specific reports in the same task
  • Combine filters to generate personalized output for different recipients

Dynamic filtring per user​

This scenario is available for iteration reports. It lets you generate one file per user while applying a user-specific filter so each output contains only that user's data.

The pattern is described in Distributing Iteration Reports to Different Recipients or Folders: each iteration value identifies the target user email, and the report distribution is routed dynamically.