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.