1.Introduction
The search is a full text search of all the data fields of the communication objects and their folder structure.
2.Search
The lower part of the window shows the three fields that can be used for the search and the "Search" button, the upper part shows the result of the search as a list.
2.1.Parameters
After the following parameters have been configured as desired, the search can be started.
2.2.Filter
The filter is set by selecting one of the list entries. This limits the search to the corresponding elements.
The following entries are available in the filter selection:
The following entries are available in the filter selection:
- No filter: Internal and KNX K objects and their respective folder structures are searched.
- Internal objects: Only the internal communication objects and the existing folder structure there are searched.
- KNX objects: Only the KNX communication objects and the existing folder structure there are searched.
- [Data type]: There is one additional entry in the list for each possible data type. Only K-objects with the data type selected here are searched.
- Remanent objects: Only K-objects with the Remanent flag set are searched.
- Query when starting: Only communication objects with the “Query when starting” flag set are searched.
- Only send in the event of change: Only K-objects with the "Only send on change" flag set are searched.
- Read flag: Only communication objects with the read flag set are searched.
- Transfer flag: Only communication objects with the transfer flag set are searched.
- Hide flag: Only K-objects with the Hide flag set are searched.
2.3.Comparison
The comparison mode is determined by selecting one of the list entries. This determines the way in which the elements to be searched are compared with the search term.
The five entries available for selection are always the same:
The five entries available for selection are always the same:
- Contains: Only elements containing the search term at any position are found.
- Does not contain: Only elements in which the search term does not occur will be found.
- Starts with: Only elements beginning with the search term are found.
- Ends with: Only items that end with the search term will be found.
- Is equal: Only items that match the search term exactly will be found.
If the search term is found in a folder name, all K-items that are below this folder are displayed in the result list. The folders themselves are not listed.
2.4.Search for
This is the search term for which all elements described by filters are searched with the Comparison method when the search is started.
If no search term is specified, or if a "*" is entered, all elements described by filters are found.
If no search term is specified, or if a "*" is entered, all elements described by filters are found.
2.5.Result list
The search results are listed here. If the search returns more than 1000 results, only the first 1000 are displayed.
The tooltip of an entry shows its name, the folder path and the data type.
In the context menu for each entry the functions "Remove", "Links" (if available) and "Quick Assignment" are available.
Several entries of the result list can be selected and all of them can be assigned the same value or property via the quick assignment.
The tooltip of an entry shows its name, the folder path and the data type.
In the context menu for each entry the functions "Remove", "Links" (if available) and "Quick Assignment" are available.
Several entries of the result list can be selected and all of them can be assigned the same value or property via the quick assignment.
2.5.1.Quick assignment
One of the following values or properties can be assigned simultaneously to all entries selected in the result list:
- Data type: The desired data type can be selected from a list.
- Remanent memory: With Yes, the remanent memory flag is set for all selected communication objects; with No, it is removed.
- Init. value: The entered value is assigned to all selected communication objects as an init. value.
Important: Whether this assignment makes sense for all selected communication objects is not checked here. - Min. value: The entered value is assigned as a minimum value to all selected communication objects that are not of type “14-byte”, “date” or “time”.
Important: Whether this assignment makes sense for all selected communication objects is not checked here. - Max. value: The entered value is assigned as a maximum value to all selected communication objects that are not of type “14-byte”, “date” or “time”.
Important: Whether this assignment makes sense for all selected communication objects is not checked here. - Step size: The entered value is assigned as a step size to all selected communication objects that are not of type “14-byte”, “date” or “time”.
Important: Whether this assignment makes sense for all selected communication objects is not checked here. - List: The entered value is assigned as a list to all selected communication objects that are not of type “14-byte”, “date” or “time”.
Important: Whether this assignment makes sense for all selected communication objects is not checked here. - Endpoints -> Edit tags: If this item is selected, a new window will open listing all endpoint tags that occur in all selected K-objects.
In front of each entry there is a checkbox with either a grey or black check mark. If the check mark is black, all selected K-objects have this tag, if it is grey, at least one, but not all of the selected K-objects have this tag.
In the input line below the list, you can enter one or more tags separated by commas. By clicking on the double arrow key, they are added to the list with a black checkmark. This operation can be performed several times.
By clicking on a checkmark in the list, it changes its status: from grey to black, from black to empty and from empty to grey.
By clicking the OK button, the selected K-objects are changed as follows:- Tags with an empty checkbox: This endpoint tag is deleted from all selected K-objects where it exists.
- Tags with a black check mark: This endpoint tag is created for all selected K objects where it does not yet exist.
- Tags with a gray checkmark: None of the selected K-objects are modified with regard to this endpoint tag.
- Endpoints-> User groups (read): IMPORTANT: Only available if the option “Use user groups” is activated in the project under “Project settings -> Miscellaneous ->User groups”!
If this item is selected, a new window will open in which the user groups (read) are listed.
In front of each entry there is a checkbox with either a grey or black check mark, or it is empty.
If the check mark is black, all marked K-objects belong to this user group, if it is grey, at least one, but not all of the marked K-objects belong to this user group. If the checkbox is empty, none of the selected K objects belong to this user group.
By clicking the checkbox, it changes its status: from gray to black, from black to empty, and from empty to gray.
By clicking on the "+" button on the right side of the window, all user groups are marked with a black check mark, by clicking on the "-" button, the check marks for all user groups are removed.
By clicking on the OK button, the marked communication objects are changed as follows:- User groups with empty checkbox: All marked K-objects will be removed from this user group.
- User groups with black check mark: All selected K-objects will be added to this user group.
- User groups with agrey check mark: The current user group status is not changed for any of the selected K-objects.
- Endpoints -> User Groups (Write): Just like user groups (read).
