Filters

On this page:

Filters in Project Snapshots

Configuration Manager allows you to include filters in snapshots (project or system). For project snapshots, you can perform this on the "Filters" page (second page) of the snapshot creation wizard.

Include Project Filters

On the Select phase of the snapshot creation wizard, you can use Configuration Manager's "Include all Filters" option.

The option "Include Project Filters" automatically includes all filters with direct references to the projects in the snapshot.

Direct project reference means that the filter contains the snapshot project(s) in the "project" operand in the JQL syntax.

When you enable this option, on the "Filters" page from the "Create Configuration Snapshot" wizard, you can select additional filters beside the project filters already included in the snapshot.

Include Selected Filters

If you would like to include only specific filters in the snapshot and not all project filters, do not enable the "Include Project Filters" option. Then, on the "Filters" page from the "Create Configuration Snapshot" wizard, select the filters you would like to include in the snapshot.

 

Preview Snapshot Details

On the "Preview" page of the wizard, you can review the snapshot details and the selected filters. Additionally, on this page, you can exclude filters from the snapshot.

On this page, you will see listed only the additional/explicitly selected filters in the snapshot.

After you click the 'Create' button, a message is presented with a summary about the snapshot and its status.

Error Handling

Configuration Manager warns you about potential problems related to the filters during a snapshot creation or deployment. You can use this information to take measures to avoid future configuration errors.

External References

When filters are included, some of them may refer to configuration objects which are not part of this snapshot's project configuration. In this case, a warning message will be presented with a link to the Audit log page where more details are available.

Snapshots with warnings can still be deployed. If the configurations missing from the snapshot are not present on the target system, a warning will be shown during the analysis phases in the deployment wizard. The filter will still be deployed, but will not be fully functional. You can review the filter after the deployment

Missing Configuration Objects

During deployment, if configuration objects referenced by filters in the snapshot are missing on the target system, a warning is shown with the names of the filter and the missing object.

Filters in System Snapshots

You can also include all filters when you create snapshots of System Configuration. On the Select phase of the snapshot creation wizard, you can use Configuration Manager's "Include all Filters" option.

Enable the "Include all Filters" option to include all filters from the system in the snapshot.