RefNames

RefNames are names that are used to identify component definitions. In a Form definition window, the hierarchical representation of a form and its components shows each component by RefName. RefNames are also used to uniquely identify the path to a specific control when attaching a rule definition.

The following rules apply to the use of RefNames:

  • RefNames can have a maximum of 63 characters.
  • RefNames must be unique within a study and component type. For example, no two item definitions in a study could have the same RefName. However, a CRF and section can have the same RefName.
  • RefNames are case-sensitive.
  • After a definition containing a RefName is installed in the study database, you cannot change the RefName. After this point, to create a new RefName, you must create a new object.
  • The following terms are disallowed for use in RefNames because they will cause a failure during the Reporting and Analysis database set up:
    • CD_COUNT
    • AFROWID
    • SUBJECTID
    • SITEID
    • STUDYVERSIONID
    • SUBJECTVISITID
    • SUBJECTVISITREV
    • VISITID
    • VISITINDEX
    • FORMID
    • FORMREV
    • FORMINDEX
    • SUBJECTINITIALS
    • SITEMNEMONIC
    • VISITMNEMONIC
    • FORMMNEMONIC
    • VISITORDER
    • SITENAME
    • SITECOUNTRY
    • SECTIONID
    • ITEMSETID
    • ITEMSETINDEX
    • ITEMSETIDX
    • DELETEDITEM
    • DELETEDFORM
    • FORMIDX