Performing a Data Element Search - 2021-06-09

When you search for Common Data Elements (CDEs) in OneData, keep in mind the following points:

• CDEs follow the ISO/IEC 11179 standard, so you can search for data elements using ISO/IEC 11179-based attributes.
• 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 CDE Public ID. 
• For some fields, you can adjust the search scope (you can specify IS NULL, IS NOT NULL, NOT LIKE, Exact Phrase Match, All Of The Words, or One Of The Words) by clicking the Advanced Filter icon. 
• For text fields, using a percent sign such as "gene%" will find values that start with "gene".
• (TBD: Will users be able to use an asterisk as a wildcard in any editable text field?)
• The system processes search criteria as AND statements, so only CDEs that fulfill all the criteria are returned.
• To reset a list of values, click the Clear Values icon next to that list. 
• 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:
   • TBD
   • TBD

2. Navigate to the following portal:

   https://wmonedata.nci.nih.gov/

   The home page appears. 

3. From the View menu, select Browse and then select one of the following options:

   • Data Elements - View/Browse: Search for data elements used by or owned by any context. 
   • NCI Standard Data Elements: Search for data elements used by or owned by context NCI Standards only. This menu option is a shortcut to find all the data elements that have been deemed "NCI Standard", which is a subset of the data elements available in Data Elements- View/Browse.

4. If necessary, you can clear the saved filter from the upper right corner of the search criteria panel, or select a different one:

   • The default saved filter excludes retired (from Workflow Status), excludes test and training (from Owned By), and includes the latest version. 
   • Another saved filter excludes only test and training (from Owned By).
   • Another saved filter includes only test and training (from Owned By).
   • To clear the saved filter, set this field to Select a Filter.

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

   Field	Instructions
   Enter Search String	Enter a search string, complete or partial. The search is not case-sensitive. (TBD: If possible, I'd like to include here a list or description of the fields in which the system searches when the user specifies a search term here.) (To adjust search scope, click the Advanced Filter icon.)
   CDE Public ID	Enter a public ID. You cannot use wildcards in this field.
   CDE Long Name	Enter a CDE long name, complete or partial. The search is not case-sensitive. (To adjust search scope, click the Advanced Filter icon.)
   Multiple Public ID Search	Enter a public ID, complete or partial. 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.). (TBD: Considering the word "Multiple" in the field label, I'm surprised users have to take these extra steps.)
   CDE Short Name	Enter a CDE short name, complete or partial. (To adjust search scope, click the Advanced Filter icon.) (TBD: Finish copying this parenthetical about Advanced Filter to all relevant rows.)
   Latest Version	Data elements are assigned version numbers by the context administrator. Select one of the following options: To search for the latest version of the CDE, select Yes. To search for all versions except the latest version, select No. To search for all versions, clear this field. (That is, set it to Select Value.)
   Owned By	Specify the context that has administrative authority to edit and update the CDE.
   Registration Status	Registration status filters your results based on the data element registration status. For details, refer to (link TBD).
   Workflow Status	Workflow status filters your results based on the administrative workflow status of the data element. In most cases, you will want to search for released data elements, but any status is available. For details, refer to (link TBD).
   Origin	Specify the source of the administered item.
   Origin Description	Specify a search string for the origin description. (TBD: This field doesn't seem to work for me.)
   Program Area	Select a program area.
   Created Date	TBD

6. 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. 

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

   Specify Criteria for Question Texts

   Field	Instructions
   Question Text	TBD
   Question Type	TBD
   Question Text Name	TBD
   Context	TBD
   Language	TBD
   Enter Search String	TBD

   Specify Criteria for Alternate Names

   Field	Instructions
   Alternate Name	A data element may have multiple alternate names in multiple contexts. Enter an alternate name or keyword, and then specify an Alternate Name Type.
   Alternate Name Type	(TBD: The CDE Browser User Guide said a type is required if you specify an alternate name, but that doesn't seem to be true in OneData.) You can select multiple items in the list. (TBD: This statement is true for several fields. Say it once at the top, or repeat it for each field?)
   Context	TBD
   Language	TBD

   Specify Criteria for Alternate Definitions

   Field	Instructions
   Definition	TBD
   Definition Type	TBD
   Context	TBD
   Language	TBD

   Specify Criteria for Associated Concepts

   Field	Instructions
   Primary	TBD
   Concept	TBD
   Concept Definition	TBD
   Integer Value	TBD

   Specify Criteria for Classifications

   Field	Instructions
   CS|CSI	TBD
   CS Context	TBD
   CS Long Name	TBD
   Enter Search String	TBD

   Specify Criteria for Permissible Values

   Field	Instructions
   Permissible Value	Enter a permissible value to return a list of data elements based on or limited to that permissible value. (To adjust search scope, click the Advanced Filter icon.)
   Value Meaning	TBD
   Concept Codes	TBD
   VM Description	TBD
   PV Parent Concept	TBD
   Enter Search String	TBD

   Specify Criteria for VM Alternate Names

   Field	Instructions
   Permissible Value	TBD
   Value Meaning	TBD
   VM Alternate Name	TBD
   Name Type	TBD
   Context	TBD
   Language	TBD

   Specify Criteria for VM Alternate Definitions

   Field	Instructions
   Permissible Value	TBD
   Value Meaning	TBD
   VM Public ID	TBD
   VM Alternate Definition	TBD
   Definition Type	TBD
   Context	TBD

   Specify Criteria for Forms/Modules

   Field	Instructions
   Form	TBD
   Module Name	TBD

   Specify Criteria for Reference Documents

   Field	Instructions
   Document Name	TBD
   Document Type	TBD
   Document Text	TBD
   Context	TBD
   Language	TBD
   Enter Search String	TBD

   Specify Criteria for Derivation Components

   Field	Instructions
   Component CDE	TBD
   Component CDE Public ID	TBD

   (To view all derived data elements, select the Derivation Components child filter, leave all fields blank, and click Apply Filter.)

   Specify Criteria for Used By

   This child filter is available only for Data Elements - View/Browse. 

   Field	Instructions
   Context	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. Selecting a particular Context Use allows you to return only data elements that are Used, Owned, or Owned By/Used By the current context. Owned By/Used By is the default setting. (TBD: This text came from the CDE Browser User Guide, but it doesn't make sense with the fields in the Used By child filter. I need help understanding these fields.)
   Owner Context?	TBD

   Specify Criteria for Data Element Details

   Field	Instructions
   DEC Long Name	Enter a keyword to return CDEs with the specified data element concepts.
   DEC Public ID	TBD
   VD Long Name	TBD
   VD Public ID	TBD
   Derived DE	TBD
   Derivation Type	TBD
   VD Maximum Length	TBD
   VD Minimum Length	TBD
   VD Type	Specify whether to search for an Enumerated or Non-Enumerated value domain. To search for both, clear this field. (That is, set it to Select a Value.)
   VD Display Format	TBD
   Unit of Measure	TBD
   Source Data Type	TBD
   Standard Data Type	TBD
   Object Class Long Name	Enter a keyword to return CDEs with the specified object class name.
   Property Long Name	Enter a keyword to return CDEs with the specified property name.
   Object Class Concept Codes	TBD
   Property Concept Codes	TBD

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

At this point, you have the following choices:

• To compare two or more data elements, select the rows of interest and click Compare CDE. The Data Element Compare page appears. 
• To compare permissible values in two or more data elements, select the rows of interest and click Compare PV. The Permissible Value Comparison page appears. 
• To view details about a data element, click the value in the CDE Long Name column.