Working with Data Acquisition assets
Data acquisition assets in ryze refer to data capture assets such as Visit Schedules, Visits and Forms. When working with data acquisition assets, you can enable plugins to integrate with electronic data capture (EDC) systems and view visualizations for these tools. See also, Plugins.
Form design in ryze allows you to follow a series of logical steps. When editing a Form asset, you can quickly create a new Section. Similarly, when you’re editing a Section, you can quickly create or associate Questions from the editor. Form assets may be referenced in Visits. The following example steps show how you can start building a new Form in ryze.
From a Data Acquisition Asset Group:
Creating a Form
Most often, it is easier to import Forms, Sections, Questions and other referenced content. You can create content manually or do a combination of creating and importing content (depending on configured Rules ).
To create a new Form Asset, click Create form and complete the required properties fields. Enter details for the following:
- Label - Label is a brief description of the Form. For example, ‘Adverse Events’. This is a mandatory field when creating a Form.
- Name - Name is the standardized name for the Form. For example, ‘AE’.
- Identifier - Identifier is the Object Identifier (OID) and should be unique for every Form.
Click Save.
See also, Forms

Adding a Section
From the Form editor, you can click Create section or Associate sections. To Associate a Section, you must have Imports available.
Enter properties details similar to the previous step and click Save.
See also, Sections.

Adding a Question
Once you have a Section you can click Create question or Associate questions.

When creating a new Question, enter details for the following:
- Label - Label is a brief description of the Question. For example, ‘Adverse Event Start Date’. This is a mandatory field when creating a Question.
- Name - Name is the CDASH name for the Question. For example, ‘AESTDAT’.
- Identifier - Identifier is the Object Identifier (OID) and should be unique for every Question.
- Question - Contains the question text that is presented to the user.
Click Save.
See also, Questions.
Adding Terminology
Some Questions may require Terminology (code list). You can add Terminology once you have saved the Question.

- Click the options icon next to the Question. This displays options for managing Terminology.
- You can Create a new Terminology or Associate an imported Terminology.
See also, Terminologies
Types of Data Acquisition Asset
Data Acquisition assets include the following:
- Visit Schedules
- Visits
- Forms
- Sections
- Questions
- Units
- Conditions
- Terminologies
- Terms
- Methods
- Comments
- Files
- Links
For more details on each type of asset, see Asset Properties.
CRF Annotations
The CRF plugin generates customizable CRFs in PDF format.
The plugin lets you output visualizations including an annotated CRF. For more information on using the CRF Plugin, see the CRF Plugin Guide.
CRF Plugin Properties are used to customize your CRF, including annotations.
Customizing Annotations
To display annotations on CRF visualizations,
- Edit the plugin properties at Asset Group level
- Set Annotations to .

Note:
- Dataset properties format Form and Section assets.
- Variable properties format Question and Terminology assets.
- You can apply custom formatting to each Annotation Group

Aliases
The Alias property is used to add annotations to assets, such as Forms, Questions, and Terminologies.
Aliases can be displayed on CRF and other plugin visualizations as they are core properties and are not specifically associated with one specific plugin.
Aliases consist of a Name and Context property:

Name
The Name property can be any string of text.
Context
The position of the Alias Context can be set using one of the following methods:
- Alias Type: Choose which alias type to display (text string e.g "SDTM"). Alias Types can be set using ‘Annotation Alias Type’ in Asset Group properties
- Delimiter: Use “.” See the Multiple Annotations Tutorial for examples.
- Target Position (Question Assets only): Choose whether the annotation appears next to the Question or Value text (default: Value)
- Question : places the annotation next to the Question text
- Value : (default) places the annotation next to the Value text.
See the Multiple Annotations Tutorial for examples of using the Alias Context.
Styling Annotations
Annotation styles can be set globally from Asset Group > Edit Properties > Edit CRF Properties or individually at property level.
Positioning Annotations
Annotation positions are set automatically but can be adjusted using horizontal and vertical offsets at the asset group or individual asset level.

CRF Multiple Annotations Tutorial
In this example, we'll add two annotation groups for a Section, and then two annotations to a Question. We can set annotation properties at Asset Group level (CRF Properties) or on individual Assets.
Asset Annotations
To define annotations in ryze, you can use the Alias property on Forms, Sections, Questions, or Terminologies directly. The Alias includes a Name and Context field. Name is the annotation text and Context groups the annotations.
Asset Group Annotations
To annotate multiple domains on the same Form, you define multiple Alias Contexts at the Asset Group Level, then declare them at the Alias level.
Example
In this example, we start with a simple Form > Section. You can create the form by importing assets or recreate it manually.

To annotate the Section for both Demographics and Disposition:
- Add two Annotation groups at Asset Group Level (Asset Group > Edit Properties > Edit CRF Properties). For example, SDTM and SDTM_1:

2. Add two Aliases to the Form > Section:

3. The CRF - Preview Visualization generates the following:

Question Annotations
Next, we'll apply Annotations to a Question on the Form.
You can apply the same style to multiple Alias contexts at the Question by adding .1, .2, to the [context].
For example, if the first alias is SDTM_1, the second would be SDTM_1.1:
Add two Aliases to the SUBJID Question:

This allows you to add multiple annotations to a Question with similar styling.

Add :value or :question after the alias context to place the annotation over the Value or Question. For example, SDTM:question or SDTM:value


See also, Styling Annotations