Skip to main content

Objects - Object Search​

The Object text search/replace tab of the Object finder window searches the properties of VisualCron objects for a text and can replace it.

To open it, click Tools -> Objects -> Object search.

Object finder window on the Object text search/replace tab with the object type list open and search results

  • Object(s) type: the object types to search. The list has Certificate, Condition, Connection, Credential, Job, Notification, PGPKeyRing, SSHKey, Task, TimeException and Variable
  • Search text: the text to search for
  • Use exact search: when checked, a property matches only when its whole value is the search text. When unchecked, a value that contains the text matches
  • Case sensitive: when checked, upper and lower case must match
  • Search encrypted values: when checked, encrypted values, such as passwords, are also searched. This takes longer
  • Text is the name of the user variable: when checked, the search text is treated as the name of a user Variable

Click Search to start. Cancel stops a running search.

Search result​

The grid shows Name/Description, the object class, Property Name and Property Value for each match. Each row has a check box that marks it for replacement. Double-click a row to open the object. The Filter: field narrows the list.

Replace​

warning

Replace changes the objects on the Server as soon as you confirm, and cannot be undone here; use Versions to revert an object. Every row is marked by default, including rows hidden by the Filter: field. Replace searches the Server again with the current search text and options; when most rows are marked, it changes every match except the unmarked rows, so a search text or option changed after the search changes values that are not in the list. If you click Replace before running a search, or when the list is empty, every value on the Server that matches the search text is replaced; the confirmation then says "all objects". With Partial replacement unchecked, each marked value is replaced as a whole, so an empty replace text clears the whole value.

The Replace text (in all marked entries in the list) group replaces values in the marked rows.

  • Partial replacement: when checked, only the matched text in each value is replaced, at its first occurrence. When unchecked (the default), the whole value is replaced by the new text
  1. Run a search.
  2. Clear the check box of each row that must not change.
  3. Enter the new text.
  4. Click Replace.
  5. Click Ok in the confirmation.

For example, a search for test with the new text test example changes This is a test to test example when Partial replacement is unchecked. With Partial replacement checked, This is a test becomes This is a test example.