Asset Properties
The following guide lists each asset and provides a description of any associated properties. Assets share the common properties described in this guide as well as asset-specific properties that relate to their use in a standard or study. The type of properties available depends on the type of asset, for example Section assets can have a ‘Repeating’ property or File assets can include a ‘Source’ property to indicate the origin of the file. Assets can also share common properties such as a Name, Label or Identifier.
Common Properties
These properties may be found in any of the assets found in this guide.
Label
The Label property is a non-unique classification of the asset, for example “Adverse Event Start Date”.
Name
Indicates the name of the asset, this property should be unique when applied to an asset.
Identifier
Identifier maps to the unique object Identifier (OID). A unique value is added automatically.
Data Type
Specifies the type of data, for example, Text, Integer, Date etc.
Length
Specifies the maximum number of characters permitted for this Data Type (does not apply to Date, Time or Datetime)
Aliases
Aliases allow you to provide a mapping value to metadata elements in another system. Assets can have multiple Aliases associated.
Description
The Description tab provides a human readable description of the metadata element. You can enter descriptions in multiple languages (locales).
Therapeutic area
This allows you to specify any therapeutic areas that this asset relates to, for example, Cardiology.
Clinical Stage
This allows you to specify any stages in the clinical life cycle this asset relates to. For example “study setup”, “submission”, “analysis” and “reporting” etc.
Origins
Used to capture metadata to define the traceability. You can provide a Source and Type for the Origin and attach any relevant Files.
Updated
Displays the last time and date that this asset was updated.
Mandatory
Relates to the relationship between a Section or Question on a Form. Mandatory Questions or Sections must be completed by the end user.
Do not collect if
This property allows you to create or associate a Condition with an asset.
Visit Schedules
The Visit Schedule lists the Visits that are included within a study and their expected order. A Visit Schedule does not have any properties other than the Visits that it references.
Visits
A Visit can take place during a study or at any data-collection event. For example, a study may require two visits; Screening and Lab Assessment.
Available Properties
- Repeating - Indicates that this type of Visit can occur repeatedly within the containing study.
- Category - The study phase appropriate to this type of visit. For example, a screening visit, pre-treatment, treatment, or follow-up.
- Visit Type - Indicates the type of Visit. There are three types of Visit:
- Scheduled - a Visit that is expected to occur for each subject as part of the ordinary progress of the study.
- Unscheduled - an event that is not expected to occur, but may occur as circumstance dictates.
- Common - an event that is not associated with a particular time. For example, Adverse Event forms which may happen at any point during a study.
Forms
Forms are used to collect data. A series of Forms are collected as part of a Visit. For example, a Vital Signs form may contain one Section, this Section may contain the following Questions:
- Vital signs time
- Systolic blood pressure
- Diastolic blood pressure
- Pulse
Available Properties
- Repeating - Indicates that a Form can occur repeatedly within any containing Visit.
Sections
A Section describes a group of related Questions that can be found on a Form. A Form can contain a number of Sections. For example, a Section called Demographics may be contained on an Informed Consent and Demographics Form. The Section may contain the following Questions:
- Sex
- Date of birth
- Race
Available Properties
- Repeating - Indicates that a Section can occur repeatedly within any containing Form.
Questions
A Question is used to capture data that is collected within a study, for example, sex, date of birth, race. A Section may contain several Questions.
Available Properties
- Question - Contains the question text that is presented to the user.
- Submission Variable - Submission Variables can be selected from a hardcoded list of CDISC standard submission variables, for example, AEBODSYS.
- Range checks - Defines a range of acceptable values for an item. For example, for the variable ‘Age’ you could specify a lower range of 16 and an upper range of 65. A Question can have multiple range checks.
- Type - Comparator operators can be used to compare values. Expression operators can be used to provide a machine readable range check.
- Severity - Soft values generate a warning. Hard values are rejected.
- Comparator - The following comparator operators can be used to check for strings (Values) in the selected Question.
- Less than
- Less than or equal to
- Greater than
- Greater than or equal to
- Equals
- Not equal to
- In list
- Not in list
- Error Message - displayed to the user if the Range is not valid.
Units
Unit assets can be referenced by other assets in ryze.
Conditions
Conditions are statements that evaluate to true or false, for example "Sex is not Female". These conditions can be used to specify when a particular metadata element should not be collected, for example do not collect "Pregnant?" if the condition "Sex is not Female" is true. Conditions can be assigned to any of the following metadata elements to stop them being collected under certain circumstances: Visits, Forms, Sections and Questions. Conditions can also be created or associated by using the Do not collect if property.
Available Properties
- Formal expression -Formal Expressions can be provided to give machine readable implementations of the Condition in different systems. For example, ItemData[@OID='I.SEX']/@Value != 'F' . Enter the language of the expression in the Context column, for example XPath
Datasets
A dataset is a collection of data, such as laboratory test results or a subject's medical history. Datasets can include SDTM, SEND, ADaM, proprietary and generic datasets.
Available Properties
- Domain - a unique two letter code, this field is already completed for some Domain Collections but is required for some ADaM datasets, datasets from the General SDTM Classes and proprietary datasets.
- Class - the class that the dataset belongs to. For example 'Events'.
- Structure - The structure of the dataset. For example 'one record per subject'.
- Purpose - The purpose of the dataset. This can be 'Tabulation' or 'Analysis'.
- Is reference data - Indicates if the dataset contains subject level data.
- Location - The location of the xpt file associated with the dataset.
Variables
Variables are individual data points that relate to an observation or analysis. For example, Severity, Epoch or Toxicity.
Available Properties
- Display format - Text value defining how the variable should be displayed. For submission, this should be a SAS display format.
Values
Values enable the specification of metadata for a Variable and can be used to provide further information describing the possible values for a particular Variable.
Selection Criteria
Values may require a Selection Criteria to be provided. The Selection Criteria defines where that Value is relevant. Selection Criteria may also be used with Supplemental Qualifiers.
Selection Criteria are used to describe the conditions under which the definition of a Value applies. You can define multiple Selection Criteria and these 'where' conditions are defined by a logical OR operation. The OR operation is dependent on the order of the associated Selection Criteria.
For example, if we have Terms in the VSTESTCD variable below that correspond to collected data.

Then the Selection Criteria can be used to define where that Value is collected in the results Variable, VSORRES.

Available Properties
- Where - Select a Variable to check for appropriate Values. Variables can be selected from a list of Variables within the asset group. The following comparator operators can be used to check for Values in the selected Variable.
- Less than
- Less than or equal to
- Greater than
- Greater than or equal to
- Equals
- Not equal to
- In list
- Not in list
Terminologies
A Terminology defines a set of permitted values, for example, for a Question. In ryze, there are three types of controlled terminology:
- Code/Decode - Each Term has a Code with an accompanying Decode (Display) - used in Forms and EDCs
- Enumerated - Each Term has a Coded Value only - used in datasets
- External - This type of Terminology links to an external system or dictionary. For example, MedDRA Dictionary.
For more information, see Controlled Terminology.
Available Properties
- External dictionary - links to an external system or dictionary. For example, MedDRA Dictionary. A Terminology can not have a link to an external dictionary and Terms associated.
Terms
Terms are the permitted values associated with a Terminology. Terms can be created for a Terminology or existing Terms can be associated with a Terminology.
For more information, see Controlled Terminology.
Methods
Methods are statements that evaluate to a value, for example, “Weight (in kilograms) divided by height squared (in meters)”. Methods can be used for deriving values such as Age and Body Mass Index. Methods are referenced from Question references within a Section, allowing a Question to have a different Method depending on the Section it is used in.
Available Properties
- Type - the type of Method for example, Computation, Imputation, Transpose or Other
- Formal expression - formal expressions can be provided to give machine readable implementations of the Method.
Comments
Comments can be added to provide context or additional information, for example, to help reviewers. Comments can be associated with multiple assets and may be associated to the following:
- Datasets
- Terminologies
- Variables
- Values
- Supplemental Qualifiers
Documents
Comments can include referenced external Documents. For external Documents, a page reference can be included to specify pages within the document.
Files
File assets can be used to reference or store files, for example, a PDF document.
Available Properties
- Source - Specify a file location or place that the file originates from.
Links
Link assets contain a URL link to external files.