Working with filter types

Last modified by Sabrina V. on 2024/10/08 11:35

Creating a filter

Within the Containers, you can use the Filters to display more specific results. These are used within the Wizard (Dynamic Client Assignment page) when adding a new Container or subsequently editing an existing one.
Drag and drop the required field onto the Drop item here to create a new filter or to regroup area. This will add the field to the filter. Then use the drop down box to select the required comparison operator and enter the comparison value. After clicking Next > the result set of your filter will be displayed.

65_Container_Dynamische Clientverknüpfung_976.png

Dynamic Client assignment in Containers

Filter options

As with queries, filter options are made up of the various fields and the filter options themselves. The results that you have previously defined are retrieved and filtered according to them. The options in ACMP also allow you to set up complex filters, e.g. to query a specific set of results for software without having to select them manually each time. A distriction is made between SingleValue fields (image-20240702133351-1.png) and MultiValue fields (image-20240702133351-2.png):

SingleValue field 
(singlevalue.png)
These fields can only return one record at a time.
For example: The Client can only have one computer name, one operating system installed and one computer domain. These fields are always filled with only one basic record.
MultiValue field
(multivalue.png)
These are fields that in principle provide multiple records.
For example: A Client can have a variety of software installed and connected to the same type of hardware (e.g. monitors or access to multiple hard drives).

Filter modes and basic elements of the filter

In the Dynamic Client assignment, you can choose between three different filter modes: Tree filter (deprecated), Advanced SQL filter and Standard filter. To populate the filter, follow the step-by-step instructions in the  Creating a filter section.
The filter is initially displayed as a single line and begins with the  plus (Add group) button. You can use this button to easily add multiple levelts to the filter to get more targeted results.

Hinweis  Note:  

Note that in most  cases the simple negation of a MultiValue field will not produce the desired result.
Instead, use the EXCEPT (AND) or EXCEPT (OR).

The filter is made up of four different operators: AND, OR, EXCEPT (AND) or EXCEPT (OR):

Filter optionDescription
ANDAll arguments must apply to the result set.
For example, if you create a filter in which only Clients are displayed where both the caption of the computer (filter: Computer Name) and the IP (filter: Primary IP) are in the value range, only these Clients are added to the Container.
OROne of the specified arguments must apply to the result set.
Example: You are either finding a Client with a specific computer name or with a specific IP address. As soon as a Client returns a correct result for one of the two search criteria, they would be dynamically linked to the Container.
EXCEPT (AND)The combination of all arguments must not apply to the result set.
Example: If you only want to link Clients in a container that do not have a specific operating system, you can filter by EXCEPT (AND).
EXCEPT (OR)A selected combination of all arguments must not apply to the result set.

If you want to use a wildcard when creating a filter, you can choose between the following:

WildcardDescription
%This character corresponds to any number of characters
_Corresponds to exactly one character

Hinweis  Note:  

If you want your Dynamic Client assignment to display all fields that are not clear, the filter must be "_%". If you would like to place a comparison value in inverted commas (""), you will only be shown the results where "exactly the value" is present in the field.

Once you have added a field, you will see the name of the field, a drop down box to select the comparison operator and an input box for the comparison value. You can also regroup a field (kreuz) and change the position manually. You can use the (minus) icon to remove fields or groups from the filter.

Examples of how to use the filters

Below are a number of examples of how you can use the filters in your work with the Containers. For example, you can find and select only certain Clients with or without certain operating systems, software or versions.

 Description 
All ClientsUse the following filter to output all Clients. To do this, create a filter with the Not equal comparison operator for a SingleValue field. As a comparison value, enter something that never occurs in this SingleValue field.66_Container_Dynamische Clientverknüpfung_All Clients_531.png
All Clients with a specific operating systemUse the following filter to display all Clients on which a specific operating system is installed (here: "Operating system name similar to %10.1%").65_Container_Filteroptionen_Alle Clients mit bestimmten Betriebssystem_557.png
All Clients without a specific operating systemThe following two filters can be used to output all Clients on which a specific operating system is not installed.
You can select this filter with the AND or EXCEPT (AND) option.
65_Container_Filteroptionen_Alle Clients ohne bestimmtes Betriebssystem_553.png
or
65_Container_Filteroptionen_Alle Clients ohne bestimmtes Betriebssystem (außer und)_553.png
All Clients that have a specific software installedUse the following filter to display all Clients on which a specific software (here: 7-Zip, written as %7-Zip%) is installed.65_Container_Filteroptionen_Alle Clients die eine bestimmte Software installiert haben_555.png
All Clients that do not have a specific software installedUse the following filter to display all Clients on which a specific software is not installed. This means that no Clients may be listed on which the 7-Zip software is installed (Setup Software Name field similar to the operator).65_Container_Filteroptionen_Alle Clients die eine bestimmte Software nicht installiert haben_556.png
All Clients that have a specific software version installedUse the following filter to display all Clients on which a specific software (here: 7-Zip) is installed in a specific version (17%). The percentage sign (Wildcard) allows you to specify a variable version number.65_Container_Filteroptionen_Alle Clients die eine bestimmte Software in einer bestimmten Version installiert haben_557.png
All Clients that do not have a specific software version installedUse the following filter to display all Clients on which a specific software version is not installed. This is the opposite filtering to the prior example, use the filter option EXCEPT (AND).65_Container_Filteroptionen_Alle Clients die eine bestimmte Software in einer bestimmten Version nicht installiert haben_557.png
All Clients that have software X and software Y installed

Use the following filter to display all Clients on which a specific software X (here: 7-Zip) and a specific software Y (e.g. Adobe Reader) is installed.

Hinweis  Note:  

As this filter filters the same MultiValue field for software X and software Y, it is necessary to filter on two result sets. The intersection of both result sets corresponds to the Clients you are looking for.

66_Container_Dynamische Clientverknüpfung_Alle Clients die die Software X und Y installiert haben_532.png
All Clients that do not have software X and software Y installedUse the following filter to display all Clients on which a specific software X (in this example Adobe Reader) and a specific software Y (Microsoft Office) is not installed.65_Container_Filteroptionen_Alle Clients die Software X installiert haben aber nicht Software Y_572.png
All Clients that have installed software X in a specific version and software Y in a specific versionUse the following filter to display all Clients on which a specific software X (%Adobe Reader%) in a specific version (1.%) and a specific software Y (%Microsoft Office%) in a specific version (87.%) is installed.65_Container_Filteroptionen_Alle Clients die Software X und Software Y in einer bestimmten Version installiert haben_564.png
All Clients that have installed software X but not software YUse the following filter to display all Clients on which a certain software X (here: Microsoft Office) is installed and a certain software Y (e.g. Gimp) is not.66_Container_Dynamische Clientverknüpfung_Alle Clients die die Software X und nicht Y installiert haben_612.png
All Clients that have installed software X but not software Y OR have installed software Y but not software ZUse the following filter to display all Clients on which a specific software X (Firefox) but not software Y (Adobe) is installed OR software Y (Adobe) but not software Z (Microsoft Edge) is installed.66_Container_Dynamische Clientverknüpfung_Alle Clients die die Software X aber nicht Software Y installiert haben oder die Software Y installiert haben aber nicht Z_704.png
All Clients that have installed software X in a specific version or software Y in a specific versionUse the following filter to display all Clients on which either a specific software X in a specific version or a specific software Y in a specific version is installed.Query Management
All Clients on which the ACMP Agent is installed, except in version 7.1Use the following filter to display all Clients on which the ACMP Agent is installed in a version other than 7.1.65_Container_Filteroptionen_Alle Clients auf denen der ACMP Agent installiert ist außer in Version 7.1_573.png
All Clients on which the ACMP Agent is installed, except versions 7.0 or 7.1Use the following filter to display all Clients on which the ACMP Agent is installed in a version other than 7.0 or 7.1.66_Container_Dynamische Clientverknüpfung_Alle Clients auf denen der ACMO Agent installiert ist außer in Versionen 7.0 und 7.1_597.png
All Clients on which version 7.0 or 7.1 of the ACMP Agent is installedUse the following filter to display all Clients on which version 7.0 or 7.1 of the ACMP Agent is installed.65_Container_Filteroptionen_Alle Clients auf denen ACMP Agent in Version 7.0 oder 7.1 installiert ist_588.png

Multiple use of a field

It is possible to use a field more than once in an AND group, but in most cases it is unlikely to produce the correct result.

However, there are isolated cases where multiple use of a field will produce the correct result. The following filter shows all Clients where the ACMP Agent version is between 7 and 9.

65_Container_Filteroptionen_Mehrfachverwendung eines Feldes_558.png

Multiple use of a field

Hinweis  Note:  

If you want to use a field more than once in an AND group, we recommend that you check carefully in the result preview whether the displayed result is plausible.

Hierarchical filter structure

With the hierarchical structure, the result set of the subgroups is only displayed in relation to the result set of the superordinate groups. In the following short example, the result set will therefore include all Clients that

  • have installed %Firefox% software (top group) and
  • have installed a software (from the top group) in version 115.% or 116.%

65_Container_Hierarische Struktur_620.png

Hierarchical filter structure

The Setup Software Name and Setup Software Version conditions are not related in this filter structure.

Warning  Warning:  

Note that there was no hierarchical filter structure until ACMP 5.2.2.

© Aagon GmbH 2024
Besuchen Sie unsere neue Aagon-Community