Advanced Search features

Advanced Search lets you construct complex searches in the repository using many different criteria.

The following diagram shows the Advanced Search panel:
Advanced Search panel

You enter one search criterion per line. You can enter as many criteria as required to make a truly detailed search of the CMS repository.

The first column specifies a search operator. You can specify three operators:
  • and: The search result must contain the specified value.
  • or: The search result may contain the specified value.
  • without: The search result must not contain the specified value.

The first row always starts with the and operator. This serves as a reminder that the results of the Advanced Search panel will be aggregated with the results of the other search panels, using the and operator.

Use the line management buttons (Line management buttons) to add, remove, and organize your criteria. The Advanced Search rows are executed from the top down.

The selections that appear when you construct your search criteria differ according to your choice of Type. You can specify four types of advanced searches:
  • Elements: Search within a specific XML element.
  • Attributes: Search for XML elements having specific attribute values.
  • Index: Search according to indexed criteria.
  • Dates: Search for documents created or modified on fixed or relative dates.

The following sections show the various criteria Types that are available and the Names and Values that may be used with them. For detailed examples, see the Advanced Search examples in this document.

Elements

Lets you search within a specific XML element. Select the element Name and then enter the Value of the expression you are looking for.

For example, you could search with the values shown below.

Operator Type Name Value
And elements title Publish*

This search returns files where the string "Publish" is part of any title in the document. This would include, for example, topics having sections titled "Publishing Output" and tables with the title "Published books". The asterisk character is a wildcard that replaces one or more characters.

Attributes

Lets you search for XML elements having specific attribute values.

For example, you could search with the values shown below.

Operator Type Name Value
And attribute alt map*

This search would return image files where the alt attribute contains words that begin with the string "map". This would, for example, include "topics and maps" or "mapping data". The alt attribute is the text that displays if for some reason the image cannot be loaded.

Index

Lets you search according to other useful indexed criteria.

Indexes available for selection are:

  • ID - lets you search for the map, topic, or image ID.

    For example, if you are looking for all the places that a specific document is referenced, you could enter the following values.

    Operator Type Name Value
    And index ID mal1159463936986

    This search returns a list of all the files that contain the ID "mal1159463936986".

  • title - lets you search for files using the topic title as it appears in the Search Results view.

    For example, you might set up your search with the following values.

    Operator Type Name Value
    And index title *map*

    This search returns all files having the string "map" somewhere in the title. This list might include a topic called "set map variables", an image called "DITA topics and maps", and a map called "test_map".

  • image description - lets you search for any of the information contained in the image description.

    For example if you are looking for all the descriptions that contain the word "status", you could enter the following values.

    Operator Type Name Value
    And index image description status

    This search returns all the images whose descriptions contain the word "status".

  • topic type - lets you search by topic type.

    For example, you could search using the following parameters.

    Operator Type Name Value
    And index topic type task

    This search returns all topics of the type task. You could combine this with the string "image*" if you wanted to narrow your search to all tasks that contained words starting with "image".

  • status - lets you search for all files having the specified status.

    For example you might select the following values.

    Operator Type Name Value
    And index status Localization:in translation

    If you select the Localization cycle, this search returns all files with the status Localization:in translation.

  • state - lets you search for all files in the specified state.

    For example you could search for the following values in the Authoring cycle.

    Operator Type Name Value
    And index state done

    This search returns all topics in the Authoring cycle whose state is done.

  • version - lets you search the Published or Localization cycles for all files having the specified version.

    For example you could select the following values.

    Operator Type Name Value
    And index version *alpha*

    This search returns all files that contain a word that begins with the string "alpha" in their version field. This would include versions such as "alpha1" or "alpha_1_b" or " Ixiasoft alpha".

  • locale - lets you search the Localization cycle for all files of the specified locale.

    For example you could select the following values.

    Operator Type Name Value
    And index locale dan

    This search returns all the files that are being localized in Danish.

  • created by - lets you search for all files created by the specified user.

    For example, if you wanted to search for all files created by a user called SmithJ@ixiasoft.com, you'd set the search field as follows.

    Operator Type Name Value
    And index created by SmithJ@ixiasoft.com
  • modified by - lets you search for all files modified by the specified user.

    For example, if you wanted to search for all files last modified by a user called SmithJ@ixiasoft.com, you'd set the search field as follows.

    Operator Type Name Value
    And index modified by SmithJ@ixiasoft.com
  • label - lets you search for all files that have a particular label.

    For example, if you are looking for all the files whose labels contain the word "obsolete", you could enter the following values.

    Operator Type Name Value
    And index label obsolete

    This search would return files with labels such as "obsoleted in 2009" and "provisionally obsolete".

  • contains elements - lets you search for all files that contain the selected element.

    For example, if you wanted to find all the files that contained images, you could search as shown below.

    Operator Type Name Value
    And index contains elements image