---
title: Working with Data Acquisition assets
slug: ryze/working-with-data-acquisition-assets
description: Learn how to effectively work with data acquisition assets in Ryze with this comprehensive document. Discover the functionalities of visit schedules, visits, and forms, and gain insights on enabling plugins for seamless integration with electronic data ca
createdAt: 2023-08-31T10:45:26.947Z
---

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](https://docs.formedix.com/ryze/plugins). 

:::Iframe{code="<div style=&#x22;padding:57.02% 0 0 0;position:relative;&#x22;><iframe src=&#x22;https://player.vimeo.com/video/577144756?h=ace0ec7855&#x26;amp;badge=0&#x26;amp;autopause=0&#x26;amp;player_id=0&#x26;amp;app_id=58479&#x22; frameborder=&#x22;0&#x22; allow=&#x22;autoplay; fullscreen; picture-in-picture&#x22; style=&#x22;position:absolute;top:0;left:0;width:100%;height:100%;&#x22; title=&#x22;Working with Data Acquisition Assets&#x22;></iframe></div><script src=&#x22;https://player.vimeo.com/api/player.js&#x22;></script>"}

:::

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](https://docs.formedix.com/ryze/asset-properties#visits). The following example steps show how you can start building a new Form in ryze.

From a Data Acquisition Asset Group:

1. [Create a Form](https://docs.formedix.com/ryze/working-with-data-acquisition-assets#creating-a-form)
2. [Add a Section](https://docs.formedix.com/ryze/working-with-data-acquisition-assets#adding-a-section)
3. [Add a Question](https://docs.formedix.com/ryze/working-with-data-acquisition-assets#adding-a-question)
4. [Add Terminology](https://docs.formedix.com/ryze/working-with-data-acquisition-assets#adding-terminology)

## 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](https://docs.formedix.com/ryze/rules) ).&#x20;

To create a new Form Asset, click **Create form** and complete the required properties fields. Enter details for the following:

- **Label&#x20;**- Label is a brief description of the Form. For example, ‘Adverse Events’. This is a mandatory field when creating a Form.
- **Name&#x20;**- Name is the standardized name for the Form. For example, ‘AE’. 
- **Identifier&#x20;**- Identifier is the Object Identifier (OID) and should be unique for every Form. 

Click **Save**.

See also, [Forms](https://docs.formedix.com/ryze/asset-properties#forms)

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/RzSvIBG3h5r46JSbiIgXL_image.png)

## Adding a Section

From the Form editor, you can click **Create section** or **Associate sections**. To Associate a Section, you must have [Imports](https://docs.formedix.com/ryze/imports) available.&#x20;

Enter properties details similar to the previous step and click **Save**.

See also, [Sections](https://docs.formedix.com/ryze/asset-properties#sections).

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/8pLLFaScEAqjg6gija_tn_image.png)

## Adding a Question

Once you have a Section you can click **Create question** or **Associate questions**.&#x20;

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/gBOtj89oqJVjbFpRBhkOR_image.png)

When creating a new Question, enter details for the following: 

- **Label -&#x20;**&#x4C;abel is a brief description of the Question. For example, ‘Adverse Event Start Date’. This is a mandatory field when creating a Question.
- **Name&#x20;**- Name is the CDASH name for the Question. For example, ‘AESTDAT’.  
- **Identifier&#x20;**- Identifier is the Object Identifier (OID) and should be unique for every Question. 
- **Question&#x20;**- Contains the question text that is presented to the user.

Click **Save**.

See also, [Questions](https://docs.formedix.com/ryze/asset-properties#questions).

## Adding Terminology

Some Questions may require Terminology (code list). You can add Terminology once you have saved the Question. 

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/Q-y3NBD_ITpC4sPN-J-jt_image.png)

- Click the options icon next to the Question. This displays options for managing Terminology.&#x20;
- You can Create a new Terminology or Associate an imported Terminology.

See also, [Terminologies](https://docs.formedix.com/ryze/asset-properties#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](https://docs.formedix.com/ryze/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](https://docs.formedix.com/ryze/introduction).

CRF [Plugin Properties](https://docs.formedix.com/ryze/plugin-properties) are used to customize your CRF, including annotations. &#x20;

### Customizing Annotations

To display annotations on CRF visualizations,

1. Edit the plugin properties at Asset Group level
2. Set Annotations to .

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/cqQw50Cln_L_pCCp28Nlf_image.png)

**Note**:

- **Dataset&#x20;**&#x70;roperties format Form and Section assets.
- **Variable&#x20;**&#x70;roperties format Question and Terminology assets.
- You can apply custom formatting to each Annotation Group

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/X-Otu1wJlw9v6v6wPeQ1G_image.png)

### 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:

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/EIm3i0HrgYhA2wbcIFdaV_image.png)

**Name**

The Name property can be any string of text.&#x20;

**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 ](https://docs.formedix.com/ryze/working-with-data-acquisition-assets#crf-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 ](https://docs.formedix.com/ryze/working-with-data-acquisition-assets#crf-multiple-annotations-tutorial)for examples of using the Alias Context.&#x20;

### Styling Annotations

Annotation styles can be set globally fro&#x6D;**&#x20;Asset Group > Edit Properties > Edit CRF Properties&#x20;**&#x6F;r individually at property level.

:::Iframe{code="<div style=&#x22;padding:56.6% 0 0 0;position:relative;&#x22;><iframe src=&#x22;https://player.vimeo.com/video/1006925411?badge=0&#x26;amp;autopause=0&#x26;amp;player_id=0&#x26;amp;app_id=58479&#x22; frameborder=&#x22;0&#x22; allow=&#x22;autoplay; fullscreen; picture-in-picture; clipboard-write&#x22; style=&#x22;position:absolute;top:0;left:0;width:100%;height:100%;&#x22; title=&#x22;Styling CRF Annotations&#x22;></iframe></div><script src=&#x22;https://player.vimeo.com/api/player.js&#x22;></script>"}

:::

### Positioning Annotations

Annotation positions are set automatically but can be adjusted using horizontal and vertical offsets at the asset group or individual asset level.

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/UDDHpyUbRBXNQ84mNfCEr_image.png)

## CRF Multiple Annotations Tutorial

:::Iframe{code="<div style=&#x22;padding:56.6% 0 0 0;position:relative;&#x22;><iframe src=&#x22;https://player.vimeo.com/video/1006955548?badge=0&#x26;amp;autopause=0&#x26;amp;player_id=0&#x26;amp;app_id=58479&#x22; frameborder=&#x22;0&#x22; allow=&#x22;autoplay; fullscreen; picture-in-picture; clipboard-write&#x22; style=&#x22;position:absolute;top:0;left:0;width:100%;height:100%;&#x22; title=&#x22;Multiple CRF Annotations and Annotation Groups&#x22;></iframe></div><script src=&#x22;https://player.vimeo.com/api/player.js&#x22;></script>"}

:::

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.&#x20;
The Alias includes a Name and Context field. **Name&#x20;**&#x69;s the annotation text and **Context&#x20;**&#x67;roups 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.

### <u>Example</u>

In this example, we start with a simple Form > Section. You can create the form by importing assets or recreate it manually.

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/Lp8_x2D8G8GxSYSltWW2h_image.png)

To annotate the Section for both Demographics and Disposition:

1. Add two Annotation groups at Asset Group Level (**Asset Group > Edit Properties > Edit CRF Properties**).&#x20;
   For example, SDTM and SDTM\_1:

   ![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/icuY-sOd1VO-1JvPFZGKi_image.png)

2\. Add two Aliases to the Form > Section:

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/CX8x-vzjT4LYFjNPCu6En_image.png)

3\. The **CRF - Preview&#x20;**&#x56;isualization generates the following:

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/zVvdBI6yZTKV8C1T1vA3g_image.png)

**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].&#x20;

For example, if the first alias is SDTM\_1, the second would be SDTM\_1.1:

Add two Aliases to the SUBJID Question:

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/ZbJN1px6RDF0pkLLS29Se_image.png)

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

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/IlbTwA_pQWW6ZusEUFh20_image.png)

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

::Image[]{src="https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/bPVOPB69bgRI3enEaurWT_image.png" size="70" width="486" height="675" position="center" showCaption="false"}

![](https://api.archbee.com/api/optimize/aRGXD44FysHcCUICvfsxc/XUF0Xr2y-oUng6yrPC9b1_image.png)

See also, [Styling Annotations](https://docs.formedix.com/ryze/working-with-data-acquisition-assets#styling-annotations)&#x20;

