> For the complete documentation index, see [llms.txt](https://docs.b2ihealthcare.com/snowray/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.b2ihealthcare.com/snowray/v2.0.0/start.md).

# Getting Started

This page is dedicated to demonstrate a real-life workflow with the intention of helping users to get familiar with Snowray. As part of the workflow, users will start off by creating a [Value Set](/snowray/v2.0.0/reference/resources/valuesets.md) and then [editing ](/snowray/v2.0.0/reference/resources/valuesets.md#authoring)its content. Next, after learning how to browse and edit [Resources](/snowray/v2.0.0/reference/resources.md), users will be introduced to release management. Finally, the [released](/snowray/v2.0.0/reference/resources/valuesets/release.md) Value Set will be [exported](/snowray/v2.0.0/reference/resources/valuesets/export.md) enabling it to be shared.

{% hint style="info" %}
To benefit the most from the tutorial, start from the very beginning, and continue step by step, as it will walk you through the most important functionalities of Snowray.
{% endhint %}

### Contents

1. [Log in](#log-in)
2. [Create a Value Set](#create-a-value-set)
3. [Add Clauses](#add-clauses)
4. [Find Value Set](#find-value-set)
5. [Check Value Set Content](#check-member-details)
6. [Create a Release](#create-a-release)
7. [Edit Clauses](#edit-clauses)
8. [Delete Clauses](#delete-clauses)
9. [Create and Edit Value Set](#create-a-value-set-and-add-clauses)
10. [Merge Value Set](#merge-value-set)
11. [Create a Second Release](#create-a-second-release)
12. [Compare Value Sets](#compare-value-sets)
13. [Export Value Set](#export-value-set)

## Log in

To access Snowray, enter your username and password in the corresponding boxes of the login page, then press the![](/files/yvzjBIBKbh0hRb6MsliR)button. You will be taken to the [Dashboard](/snowray/v2.0.0/reference/dashboard.md) page.

{% hint style="info" %}
Snowray supports authentication via Google or Microsoft accounts.
{% endhint %}

## Create a Value Set

To create a resource, press the![](/files/pbj4A4OBOIC1cY1kuQrh)button from the [Resources page](/snowray/v2.0.0/reference/resources.md#resources-page). Then select Value Set as the resource type, fill out the required fields, and press![](/files/-MgF2GD2NiTeBCuCxmEP).

![Create a New Value Set](/files/oOAUqM5quw6nxuQMSVmM)

:paperclip: **Read more about creating Value Sets:**

{% content-ref url="/pages/-MgGqxbZagcfHkcqa4cL" %}
[Create](/snowray/v2.0.0/reference/resources/valuesets/create.md)
{% endcontent-ref %}

## Add Clauses

To add clauses, navigate to the authoring page by pressing the ![](/files/-MgKVp2L5HDY9DtV5zWv) button. After that, you can [drag and drop](/snowray/v2.0.0/reference/resources/valuesets/authoring/dnd.md) concepts from the terminology tree or create a new clause with the [basic clause editor](/snowray/v2.0.0/reference/resources/valuesets/authoring/editor.md).

![Add Clauses to a Value Set](/files/-Mj8mIEteIlTi-MgKFbi)

:paperclip: **Find out more about adding clauses:**

{% content-ref url="/pages/-MgLcMXzcbuGo0jbITv-" %}
[Authoring](/snowray/v2.0.0/reference/resources/valuesets/authoring.md)
{% endcontent-ref %}

## Find Value Set

To find an already created Value Set that is not visible on the [Dashboard](/snowray/v2.0.0/reference/dashboard.md) (e.g. after finishing a session in Snowray and starting a new one later on), navigate to [Resources](/snowray/v2.0.0/reference/resources.md) from the main menu bar and type the Value Sets name into the filter search box.

![Find a Value Set](/files/-MgpA8QI9MGRSyQe1ysd)

:paperclip: **To read more about finding a resource we suggest checking out the following page:**

{% content-ref url="/pages/-MfXhF4t206h-20AqLaP" %}
[Resources](/snowray/v2.0.0/reference/resources.md)
{% endcontent-ref %}

## Check Value Set Content

To take a look at the members of a Value Set in a hierarchical view, navigate to the ***Content*** tab.

If you would like to see where the concepts represented by the clauses are located within the hierarchy, press the![](/files/-MgKVp2L5HDY9DtV5zWv)button and sync the selected clauses with the tree.

![Review Value Set Content](/files/2V1CnRxWbjZzw8prFZps)

## Create a Release

To create a release, navigate back to the Value Set, click the ***Releases*** tab, and press the![](/files/-MgR-m0lypTaYO4eTvsq)button. Fill out the fields and press the![](/files/-MgR2W_5KEp6_bG0m4eC)button.

![Create a Value Set Release](/files/-MgpE5UKcwkaOFeQi-tZ)

{% hint style="info" %}
Creating a release automatically changes the Resource status to [active.](/snowray/v2.0.0/reference/resources.md#lifecycle)
{% endhint %}

:paperclip: **Find out more about creating a version:**

{% content-ref url="/pages/-MgGql6UbKK856TdmMb4" %}
[Release Management](/snowray/v2.0.0/reference/resources/valuesets/release.md)
{% endcontent-ref %}

## Edit Clauses

To edit the Value Set, navigate to the authoring page by pressing the ![](/files/-MgKVp2L5HDY9DtV5zWv) button. Hover over an existing clause to reveal the![](/files/-MgFTbE9zMYU9hrRCdDj)icon, which enables editing the selected clause. To persist the changes you made, click on the green checkmark.

![Edit Value Set Clauses](/files/-MgpI2rwm2mpzFuy5bKp)

:paperclip: **Read more about authoring:**

{% content-ref url="/pages/-MgLcMXzcbuGo0jbITv-" %}
[Authoring](/snowray/v2.0.0/reference/resources/valuesets/authoring.md)
{% endcontent-ref %}

## Delete Clauses

To edit the Value Set, navigate to the authoring page by pressing the ![](/files/-MgKVp2L5HDY9DtV5zWv) button. You can then delete clauses either individually or in a batch using the ![](/files/-MgP_8zoBo1jYQXSmqaW) icon.

![Delete Value Set Clauses](/files/-MgpLJQXkpbSCcfzy0V4)

:paperclip: **Find out more about deleting:**

{% content-ref url="/pages/-Mgk5U7Wfz9Y7QCnNWxv" %}
[Delete/Retire](/snowray/v2.0.0/reference/resources/valuesets/delete.md)
{% endcontent-ref %}

## Create and Edit Value Set

To create a resource, press the![](/files/pbj4A4OBOIC1cY1kuQrh)button from the [Resources page](/snowray/v2.0.0/reference/resources.md#resources-page). Then select Value Set as the resource type, fill out the required fields, and press![](/files/-MgF2GD2NiTeBCuCxmEP).

To add clauses, navigate to the authoring page by pressing the ![](/files/-MgKVp2L5HDY9DtV5zWv) button. After that, you can [drag and drop](/snowray/v2.0.0/reference/resources/valuesets/authoring/dnd.md) concepts from the terminology tree or create a new clause with the [basic clause editor](/snowray/v2.0.0/reference/resources/valuesets/authoring/editor.md).

![Create Value Set and Add Clauses](/files/-Mj9feDWG6oRTZsUoeLR)

:paperclip: **Read more about creating Value Sets:**

{% content-ref url="/pages/-MgGqxbZagcfHkcqa4cL" %}
[Create](/snowray/v2.0.0/reference/resources/valuesets/create.md)
{% endcontent-ref %}

:paperclip: **Find out more about adding clauses:**

{% content-ref url="/pages/-MgLcMXzcbuGo0jbITv-" %}
[Authoring](/snowray/v2.0.0/reference/resources/valuesets/authoring.md)
{% endcontent-ref %}

## Merge Value Set

To merge a Value Set into another, navigate to the authoring page of the Value Set into which you want to merge additional content by pressing the ![](/files/-MgKVp2L5HDY9DtV5zWv) button. Then press the![](/files/2Pde4e4u7yFLLT7H4tvC)button and select the *Merge value sets* option. In the pop-up wizard, select the Value Set which will be merged into the edited Value Set.

![Merge Existing Value Sets](/files/-Mj9mWwGziobvpNHYVqM)

:paperclip: **A more detailed description of merging Value Sets can be found here:**

{% content-ref url="/pages/-MiW\_4LxOgXb-GawJKg-" %}
[Merge](/snowray/v2.0.0/reference/resources/valuesets/merge.md)
{% endcontent-ref %}

## Create a Second Release

To create additional releases, simply follow and complete the same steps as in the [Create a Release](#create-a-release) section.

![Create a Second Release for Value Set](/files/-MgpWNyh-r87vQn61k2B)

## Compare Value Sets

To start comparing Value Sets, navigate to the ***Releases*** tab, and press the![](/files/-MgoDQrcJbTOevtAXpJr)button next to the version.

![Compare Value Set Versions](/files/-MgpXVg-xWty0Vh_9O-G)

:paperclip: **A more detailed description can be found on the following page:**

{% content-ref url="/pages/-Mgo7Cvj9dsIf22CviYn" %}
[Compare](/snowray/v2.0.0/reference/resources/valuesets/compare.md)
{% endcontent-ref %}

## Export Value Set

To export a Value Set, press the![](/files/-MgR72N8k7RHwPn9f1rh)button in the upper right corner of your resource's page, and select a format for your export file. Once you picked the desired format, the export process will start immediately.

{% hint style="info" %}
A progress indicator will notify you about the changes in the export process.
{% endhint %}

![Export a Value Set](/files/-MgpYiCelvWa4msqpbbF)

:paperclip: **Read more about supported export file formats:**

{% content-ref url="/pages/-MgGqpHPCIc3-TGfm2-g" %}
[Export](/snowray/v2.0.0/reference/resources/valuesets/export.md)
{% endcontent-ref %}