NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Replaced many TBDs based on wording in legacy documentation & observations in the GUI on the QA tier.

...

  • 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 (with options such as 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. 
  • In any editable text fields, you can use a percent sign (%) as a wildcard. For examples, refer to Using Wildcards - 2021-06-09
  • 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.
  • (TBD: Are some fields case-sensitive and others case-insensitive? If so, which ones are which?)

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 within released data elements that are either owned by or used by the NCI Standards Context. NCI considers these data elements to be standard for the NCI. These elements are 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: 

    FieldInstructions
    Enter Search StringEnter a search string, complete or partial. The search is not case-sensitive. This field searches CDE Short Name, CDE Long Name, and any type of Question text. (To adjust search scope, click the Advanced Filter icon.)
    CDE Public IDEnter a public ID. You cannot use wildcards in this field. 
    CDE Long NameEnter 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 NameEnter a CDE short name, complete or partial. (To adjust search scope, click the Advanced Filter icon.) 
    Latest VersionData 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 BySpecify the context that has administrative authority to edit and update the CDE.
    Registration StatusRegistration status filters your results based on the data element registration status. For details, refer to Registration Status. (link TBD).TBD: I intend to move this page at the time of release.)
    Workflow StatusWorkflow 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 For details, refer to Workflow Status. (link TBD).TBD: I intend to move this page at the time of release.)
    OriginSpecify the source of the administered item.
    Origin DescriptionSpecify a search string for the origin description. 
    Program AreaSelect a program area.
    Created BySpecify the name of the person who created the item.
    Last Modified BySpecify the name of the person who last modified the item. (To adjust search scope, click the Advanced Filter icon.)
  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. For date criteria, click the Audit Columns icon and specify dates as described in the following table: 

    FieldInstructions
    Date CreatedClick the calendar icon and select the date on which the item was created.
    Date Last ModifiedClick 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 greater than, less than, and/or equal to the date you specify. (TBD: Does ">" mean dates later than the specified date?)

    • 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. 
  8. You can also specify an explicit "where" clause. Click the Advanced Filter icon. Under Filter Options, select a column and then click >>. (TBD: What would the user do next?)
  9. If necessary, you can specify additional criteria using a child filter. For details, click one of the following links:

    Expand
    titleSpecify Criteria for Question Texts
    FieldInstructions
    Question TextTBD Type all or part of the actual text that appears for the data element on a Form. (To adjust search scope, click the Advanced Filter icon.)
    Question TypeTBD

    Select a question type:

    • Alternate Question Text 
    • Application Standard Question Text 
    • CDASH Alternate Question Text 
    • NRDS Question Text 
    • Preferred Question Text 
    • Standard Alternate Question Text
    Question Text NameTBDType all or part of the question text name.
    ContextTBDSelect one or more contexts. 
    LanguageTBDSelect a language. 
    Enter Search StringEnter a search string, complete or partial. This field searches (TBD: which database fields?). (To adjust search scope, click the Advanced Filter icon.)
    Expand
    titleSpecify Criteria for Alternate Names
    FieldInstructions
    Alternate NameA data element may have multiple alternate names in multiple contexts. Enter an alternate name or keyword. (To adjust search scope, click the Advanced Filter icon.)
    Specify an Alternate Name TypeAlternate Name TypeSelect one or more alternate name types. (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.) (To adjust search scope, click the Advanced Filter icon.)
    ContextTBDSelect one or more contexts. 
    LanguageTBDSelect a language.
    Expand
    titleSpecify Criteria for Alternate Definitions
    FieldInstructions
    DefinitionTBD Type all or part of the definition. (To adjust search scope, click the Advanced Filter icon.)
    Definition TypeTBDSelect a definition type.
    ContextTBDSelect one or more contexts. 
    LanguageTBDSelect a language.
    Expand
    titleSpecify Criteria for Associated Concepts
    FieldInstructions
    PrimaryTBDSpecify whether the associated concept is primary (Yes) or not (No). 
    ConceptTBDSelect one or more concepts. 
    Concept DefinitionTBDType all or part of the concept definition. 
    Integer Value (wildcard string match)Specify all or part of the integer value. (TBD wildcard string match : I thought the % wildcard could be used in most of the search criteria fields. If that's true, then is it okay that this one field mentions it in the label?) (To adjust search scope, click the Advanced Filter icon.)
    Expand
    titleSpecify Criteria for Classifications
    FieldInstructions
    CS|CSITBDSelect one or more classification schemes or classification scheme items.
    CS ContextTBDType all or part of the classification scheme context.
    CS Long NameTBD Type all or part of the classification scheme long name. (To adjust search scope, click the Advanced Filter icon.)
    Enter Search StringEnter a search string, complete or partial. This field searches (TBD: which database fields?). (To adjust search scope, click the Advanced Filter icon.)
    Expand
    titleSpecify Criteria for Permissible Values
    FieldInstructions
    Permissible ValueEnter 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 MeaningTBD Type all or part of a value meaning. (To adjust search scope, click the Advanced Filter icon.)
    Concept CodesTBDType all or part of a concept code. 
    VM DescriptionTBDType all or part of value meaning description. 
    PV Parent ConceptTBDSelect one or more permissible value parent concepts. 
    Enter Search StringEnter a search string, complete or partial. This field searches (TBD: which database fields?). (To adjust search scope, click the Advanced Filter icon.)
    Expand
    titleSpecify Criteria for VM Alternate Names
    FieldInstructions
    Permissible ValueTBDType all or part of a permissible value. 
    Value MeaningTBDType all or part of a value meaning.
    VM Alternate NameTBD Type all or part of a value meaning alternate name. (To adjust search scope, click the Advanced Filter icon.)
    Name TypeTBDSelect one or more name types. 
    ContextTBD Type all or part of a context. (To adjust search scope, click the Advanced Filter icon.)
    LanguageSelect one or more languages. (TBD: Is it okay that this is a multi-select list, whereas the Language fields for other child filters are all drop-down lists?)
    Expand
    titleSpecify Criteria for VM Alternate Definitions
    FieldInstructions
    Permissible ValueTBD Type all or part of a permissible value. (To adjust search scope, click the Advanced Filter icon.)
    Value MeaningTBD Type all or part of a value meaning. (To adjust search scope, click the Advanced Filter icon.)
    VM Public IDTBDEnter a value meaning public ID.
    VM Alternate DefinitionTBD Type all or part of a value meaning alternate definition. (To adjust search scope, click the Advanced Filter icon.)
    Definition TypeTBDSelect one or more definition types.
    ContextTBDSelect one or more contexts. 
    Expand
    titleSpecify Criteria for Forms/Modules
    FieldInstructions
    FormTBDSelect one or more forms. 
    Module NameTBD Type all or part of a module name. (To adjust search scope, click the Advanced Filter icon.)
    Expand
    titleSpecify Criteria for Reference Documents
    FieldInstructions
    Document NameTBD Type all or part of a reference document name. (To adjust search scope, click the Advanced Filter icon.)
    Document TypeTBDSelect one or more reference document types.
    Document TextTBD Type all or part of a reference document text. (To adjust search scope, click the Advanced Filter icon.)
    ContextTBDSelect one or more contexts.
    LanguageTBDSelect a language.
    Enter Search StringEnter a search string, complete or partial. This field searches (TBD: which database fields?). (To adjust search scope, click the Advanced Filter icon.)
    Expand
    titleSpecify Criteria for Derivation Components
    FieldInstructions
    Component CDETBDSelect one or more component CDEs.
    Component CDE Public IDTBDEnter a component CDE public ID.

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

    Expand
    titleSpecify Criteria for Owned By or Used By

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

    FieldInstructions
    Owned By or Used By ContextSelect 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. 
    Expand
    titleSpecify Criteria for Data Element Details
    FieldInstructions
    DEC Long NameEnter a keyword to return CDEs with the specified data element concepts. (To adjust search scope, click the Advanced Filter icon.)
    DEC Public IDTBDEnter a data element concept public ID.
    VD Long NameTBD Type all or part of the value domain long name. (To adjust search scope, click the Advanced Filter icon.)
    VD Public IDTBDEnter a value domain public ID.
    Derived DETBDSpecify whether the data element is derived (Yes) or not (No).
    Derivation TypeTBDSelect a derivation type.
    VD Maximum LengthTBD Specify the value domain maximum length. (To adjust search scope, click the Advanced Filter icon.)
    VD Minimum LengthTBD Specify the value domain minimum length. (To adjust search scope, click the Advanced Filter icon.)
    VD TypeSpecify 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 FormatTBDSelect a value domain display format. 
    Unit of MeasureTBDSelect a unit of measure.
    Source Data TypeTBDSelect a source data type.
    Standard Data TypeTBDSelect a standard data type.
    Object Class Long NameEnter a keyword to return CDEs with the specified object class name. (To adjust search scope, click the Advanced Filter icon.)
    Property Long NameEnter a keyword to return CDEs with the specified property name. (To adjust search scope, click the Advanced Filter icon.)
    Object Class Concept CodesTBDType all or part of the object class concept code.
    Property Concept CodesTBDType all or part of the property concept code.
  10. Click Apply Filter. The system displays the search results. By default, the system also hides the search criteria.

...