---
title: Studies
slug: ryze/studies
description: Learn how to create, manage, and modify studies, visit schedules, forms, and datasets in a clinical trial. Discover how to set access permissions, change ownership, and publish pre-approved studies. Find out how to create, delete, search, open, and export
createdAt: 2023-08-31T10:24:24.452Z
---

A study is a collection of assets that represent part of the life cycle of a clinical trial. For example, a study will commonly contain a visit schedule, forms, terminologies and edit checks that define the EDC system used to collect the data, and also datasets that define the SDTM and ADaM submission.

When a user creates a Standard or Study, that user is set as the owner. The user can set access permissions for other users. Admin users can change the owner of a Standard or Study.&#x20;

Standards and studies group related content into one of the following asset group types:

- Data acquisition
- SDTM datasets
- SEND datasets
- ADaM datasets
- Proprietary datasets
- Generic

## Published Studies

Published studies are pre-approved studies that are provided by Formedix. Published studies can be imported to your repository from **Repository settings** > **Published&#xA0;**&#x74;ab.

Once imported, a published study cannot be removed from the repository.

Published studies are read-only, to update or edit assets in a published study , you must import the content into a new study.

## Creating a Study

When a user creates a Standard or Study, that user is set as the owner. The user can set access permissions for other users. Admin users can change the owner of a Standard or Study.

Access to studies is managed by granting roles to user groups.

To create a study:

1. Select **Repository** from the **Navigation** bar, then select **Study**.
2. Select **Create study**.
3. Enter a **Label**. This is a mandatory field.
   1. (Optional) Enter a **Name**
   2. (Optional) Enter an Identifier. This field is automatically populated but you can enter your own Identifier. This field can be edited after the Study has been created
   3. (Optional) Select a **Sponsor** 
   4. (Mandatory) Select a [Program](https://docs.formedix.com/ryze/reference-lists)&#x20;
   5. (Optional) Enter a **Therapeutic area** by typing and then choosing from the list. You can add multiple therapeutic areas by repeating this step
   6. (Optional) Enter a Version label. For example, '0.1'.
4. Select **Create**.

## Deleting a Study

You can only delete a study if it is the first version and in its initial state (for example, 'Draft' status, version '1').

To delete a study:

1. Select **Repository** from the **Navigation** bar, then select **Studies**.
2. Do one of the following:
   - Select the options icon next to the study you want to delete, then select **Remove this study**.
   - Open the study that you want to delete, then select the "Remove study" icon
3. Select **Yes, I'm sure**.

## Searching for Studies

1. Select **Repository** from the **Navigation** bar, then select **Studies**.
2. You can enter the **Study label** in the text box next to 
3.  and search by label.
4. You can also filter your results using the following fields:
   - Updated: use the calendar icon to select a date range.
   - Version number: enter the version number of the Study.&#x20;
   - Version label: enter the version label of the Study. This is the free text label that you can use to identify the version of a Study.
   - Name: enter the Study name.
   - Identifier: enter the identifier of the Study.
   - Therapeutic Area: select one or more therapeutic areas from the drop down list.
   - Sponsor: select one or more sponsors from the drop down list.
   - Program: select one or more programs from the drop down list.
   - State: select the state of the Study. For example, 'draft'.
   - Owner: select the current owner of the Study.

If you select more than one option from the drop down lists, an OR condition is created. For example, If you select 'Draft' and 'In progress' from the State drop down list. Formedix ryze searches for 'Draft' OR 'In progress'. 

To remove a filter option, click the close icon next to it. You can also select **CLEAR ALL&#xA0;**&#x61;t the top of the search screen to reset the search.

To view your filter settings, select **SHOW APPLIED FILTERS**.

## Opening and Viewing Studies

Opening a study:

1. Select **Repository** from the **Navigation** bar, then select **Studies**.
2. You can do one of the following:
   - Select the options icon next to study you want to view, then select **View**.
   - Click on the study you want to open

You can search and filter the list of studies to find the one you want.

If there are multiple versions of a study, you can view a specific version. Select the appropriate version using the drop down list in the Properties section.

## Exporting a Study

You can export a study or an asset group by clicking the download exports icon.

When you export a file (Asset group) as ODM-XML or Define-XML, ryze properties are mapped as follows:

- *Study&#x20;*&#x49;dentifier becomes *Study @OID*
- *Study&#x20;*&#x4C;abel becomes *Study Name*
- For Studies, *Protocol Title* becomes *Study Description*
- For Standards, *Standard Name* becomes *Study Description*
- For Studies, *Protocol Name* becomes *Protocol Name*
- For Standards, *Standard Name* becomes *Protocol Name &#xA0;*

## Adding a Study to Favorites

You can favorite specific studies so that you can access them quickly in the future. Favorite studies appear in the Favorites section of your home screen.

To favorite a study:

1. Select **Repository** from the **Navigation** bar, then select **Studies**.
2. Open the study that you want to favorite, then select the 'Add study to favorites' star icon.

## Viewing the repository log

You can view the history of a study and you can filter the results or change the columns displayed. You can also download a copy to your computer by selecting the **Download** button and and you can filter the results or change the columns displayed.

To add a filter:

1. Open the study that you want to view the history of and select the "View logs" icon 
2. Select the **Select a filter...** drop-down list.
3. Select a filter from the list.
4. Select or enter information into the **Contains** text-box as prompted.
5. Select **Add filter**.
6. Repeat steps above to add more filters.

 To change the table columns displayed:

1. Select the visible columns drop down list 
2. Select the columns that you want to view.
3. Click off the visible columns drop down list to close it.

## Editing Studies

You can edit the properties of a study including the Label, Name, Identifier and Version label.

1. Select **Repository** from the **Navigation** bar, then select **Studies**.
2. Do one of the following:
   - Select next to the Study you want to edit, then select **Edit**.
   - Open the study that you want to edit, then select the "Edit Study" icon.
3. Change or update **Label**,**Name**, **Identifier**, **Sponsor**, **Program, Therapeutic area** or **Version label** as required.
4. Select **Update**.

If the Study is in a non-editable state (for example, "Production"), it cannot be edited until a new draft version is created.&#x20;




The version label is a free text label that you can use to identify the version of a Study. It appears in the breadcrumbs for a Study.

## Changing Study Ownership

You can change the study owner if you have the correct permissions.

To change study ownership:

1. Open the study you want to view.
2. Select the "study owner" icon.
3. Select a name from the list and select **Assign**.

## Transitioning Studies

You can transition studies from one state to another in the lifecycle. See Metadata lifecycle for more information.

You may be prevented from transitioning a standard or study from one state to another if you are not in a specific user group.

To transition a study:

1. Select **Repository** from the **Navigation** bar, then select **Studies**.
2. Do one of the following:
   - Open the study that you want to transition, then select the "**Transition this study**" icon.
   - Select the cog icon next to the study you want to transition, then select **Transition this study**.
3. Select the **state** to transition to. If you want to transition from an editable state to a non editable state, a warning message will appear.
4. Select **Transition**.

 The lifecycle and lifecycle transitioning is entirely separate to, and unrelated to change requests.

##  Updating permissions

Access to studies is controlled through user groups. For a study, each user group can have one or more roles that define the permissions of the users in those groups. Study owners can update permissions and permissions can be updated after a study has been transitioned, see Transitioning studies.

 To add a role to a user group:

1. Open the study you want to update permissions for.
2. Select the "Update permissions" icon 
3. Select a user group from the **User groups** list
4. Select the **Role** you want to assign to that user group from the **Roles** drop down list.
5. Select **Add role**.

 To remove a role from a user group:

1. Select the down arrow icon next to the role you want to remove.
2. Select **Remove role**.

  Updating permissions will affect all versions. 

To view permissions:

1. Select the user group you want to view from the **User groups** list.
2. Select the down arrow icon next to the role you want to **View permissions** for.
3. Select **View permissions**.

## Viewing permissions

You can view the user permissions for a study:

1. Open the study you want to view permissions for.
2. Select the "View permissions"  icon.
3. You can set visible column options and you can download the report.

 The viewing permissions report has a column for "Container roles". This shows all roles which apply to the user for that study. If a user is the owner of the study, "Manager" and "Editor" roles are automatically assigned, and will show in the "Container roles" column.

## Associating Libraries

Associating a library allows you to import content from another source.

You can associate libraries to, and remove them from studies if you have the correct permissions. To do this, you must have the "Associate libraries" permission which is set in Admin / Repository / Roles.

To associate libraries:

1. Open the study you want to associate a library to.
2. Select the "Update libraries" icon.
3. Select **Studies** from the drop-down list.
4. (Optional) enter the name of the study to filter results.
5. Select the down arrow icon next to the study you want to associate.
6. Select the plus icon next to the study you want to associate.

To remove associated libraries, Select the cross icon next to the associated library in the associated libraries list you want to remove.

## Deleting a draft version

To delete a draft version:

1. Select **Repository** from the **Navigation** bar, then select **Studies**.
2. Do one of the following:
   - Open the study that you want to delete, then select the "Delete draft version" icon.
   - Select the cog icon next to the study you want to delete, then select **Delete draft version**.
3. Select **Yes, I'm sure**.







