Searching for Conceptual Domains - 2022-02-28

When you search for conceptual domains in OneData, keep in mind the following points:

• Searches are not case sensitive. Searches for Gene and gene return the same results.
• In any editable text field, enter a search string, complete or partial. This does not apply to numeric fields such as Public ID. 
• In any editable text field, you can use a percent sign (%) as a wildcard. For examples, refer to Using Wildcards.  
• For some fields, you can adjust the search scope (with options such as NOT LIKE, Exact Phrase Match, All Of The Words, or One Of The Words) by clicking the Advanced Filter icon.
• The system processes search criteria as AND statements, so the results include only conceptual domains that fulfill all the criteria.
• To reset a list of values, click the Clear Values icon next to that list.
• You can specify the number of results returned: Type a number in the Number of Rows field and press <Enter>.
• When you remove or change search criteria, the system does not update search results until you click Apply Filter again.

To perform a data element search:

1. Open a supported browser (Google Chrome) and navigate to the https://cadsr.cancer.gov portal. The home page appears.

2. From the View menu, select Browse and then select Conceptual Domains - View/Browse. The Conceptual Domains - View/Browse page appears. (Logged in users can add pages like this to their favorites. For instructions, refer to Managing Your Favorites.)

3. Specify one or more search criteria, as described in the following table: 

   Field	Instructions
   Item Type	(TBD: This drop-down list currently has only 1 option. Will more options be added?)
   Latest Version	Select one of the following options: To search for the latest version of the conceptual domain, select Yes. To search for all versions except the latest version, select No.
   Long Name	Type all or part of the long name for the conceptual domain. (To adjust search scope, click the Advanced Filter icon.)
   Public ID	Specify the full numeric value for a single conceptual domain public ID. (You cannot use wildcards in numeric fields.)
   Short Name	Type all or part of the short name for the conceptual domain.
   Owned By	Select one or more of the contexts that have administrative authority to edit and update the conceptual domain.
   Registration Status	Select one or more registration statuses. For details, refer to Registration Status. (To adjust search scope, click the Advanced Filter icon.)
   Workflow Status	Select one or more workflow statuses. For details, refer to Workflow Status. (To adjust search scope, click the Advanced Filter icon.)
   Origin	Specify the source of the administered item. Select one or more sources.
   Origin Description	Specify a search string for the origin description.
   Created By	Select the person who created the item. You can select one or more people.
   Last Modified By	Select the person who last modified the item. You can select one or more people.

4. In the fields that have a Select a Value icon, you can select one or more values. Click the Select a Value icon next to the field. A Reference Data Panel appears. 

   • To select one value: Click the value name. The value name appears in the field. 
   • To select one or more values: Click the checkbox for each row you want to include. Click Set Values. The field indicates how many values you have set. 

5. For date criteria, click the Audit Columns icon and specify dates as described in the following table: 

   Field	Instructions
   Date Created	Click the calendar icon and select the date on which the item was created.
   Date Last Modified	Click the calendar icon and select the date on which the item was last modified.

   To adjust search scope, click the Advanced Filter icon and consider the following options:

   • The list to the left of each date field allows you to search for items later than (>), earlier than (<), and/or equal to the date you specify. 

   • The list to the right of each date field allows you to specify whether the date field is NULL or NOT NULL.
   • The check box below each date field allows you to specify a date range. 
6. You can also create your own query to search, by specifying an explicit "where" clause.
   1. Click the Advanced Filter icon.
   2. Under Filter Options, select a column and then click >>. The name of the selected column appears in the text box.
   3. Complete the query string. (For example, if your query string is "a.CURRNT_VER_IND=1" when you click Apply Filter, the system returns all items of the latest version.)

7. f necessary, you can specify additional criteria using a child filter. For details, click one of the following links:

   Specify Additional Search Criteria

   Field	Instructions
   Multiple Public ID Search	Type all or part of a public ID. To specify multiple public IDs, click the Advanced Filter icon. In the adjacent field, select One of the Words. Enclose each ID in periods and separate each value with a space (for example: .5. .6. .10.).
   Enter Search String	Type all or part of a search string. This field searches (TBD). (To adjust search scope, click the Advanced Filter icon.)

   Specify Criteria for Alternate Definitions

   Field	Instructions
   Alternate Definition	Type all or part of an alternate definition. (To adjust search scope, click the Advanced Filter icon.)
   Definition Type	Select a definition type.
   Context	Select one or more contexts.
   Language	Select a language.

   Specify Criteria for Alternate Names

   Field	Instructions
   Alternate Name	Type all or part of the alternate name. (To adjust search scope, click the Advanced Filter icon.)
   Alternate Name Type	Select an alternate name type.
   Context	Select one or more contexts.

   Specify Criteria for Associated Concepts

   Field	Instructions
   Primary	Specify whether the associated concept is primary (Yes) or not (No).
   Concept	Select one or more concepts.
   Concept Name	Type all or part of the concept name.
   Concept Code	Type all or part of the concept code.
   Integer Value	Specify all or part of the integer value. You can specify part of the value because this field is actually a text field. For example, if you specify "20" in this field and if items exist with "120" or ">=200", the system returns those items. (To adjust search scope, click the Advanced Filter icon.)

   Specify Criteria for Classifications

   Field	Instructions
   CS|CSI	Select one or more classification schemes or classification scheme items.
   CS Context	Type all or part of the classification scheme context. (To adjust search scope, click the Advanced Filter icon.)
   CS Long Name	Type all or part of the classification scheme long name.

   Specify Criteria for Owned By or Used By

   Field	Instructions
   Context	Select one or more contexts. Data elements are owned by the context that has administrative authority to edit and update them. In addition to the owning context however, a data element can be designated for use by another non-owning context.

   Specify Criteria for Reference Documents

   Field	Instructions
   Document Name	Type all or part of a reference document name. (To adjust search scope, click the Advanced Filter icon.)
   Document Type	Select a document type.
   Document Text	Type all or part of a search string. This field searches reference document text. (To adjust search scope, click the Advanced Filter icon.)
   Context	Select one or more contexts.

   Specify Criteria for Conceptual Domain Attributes

   Field	Instructions
   Conceptual Domain	Select one or more conceptual domains.

8. Click Apply Filter. The system displays the search results. By default, the system also hides the search criteria.

To view details about a conceptual domain, click the value in the Long Name column.

(TBD: On the QA tier, 2/28, in the Conceptual Domains - View/Browse page, I don't see a "delivery options" menu, an "add to cart" option, or a "Save Filter" option. Is this as expected?)