> 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/reference/resources.md).

# Resources

Resources are the foundation of the authoring work of users. Resources can be viewed either by navigating to the [Dashboard](/snowray/reference/dashboard.md) page or visiting the dedicated Resources page.

## Resources Page

The Resources page provides a list-style overview of the resources available based on the currently selected [workspace](/snowray/reference/workspace-system.md).

{% hint style="info" %}
Depending on your access type, you might not have permission to all the content. For more information, check out the [Access management](/snowray/reference/resources/access.md) page.
{% endhint %}

Each [resource type](#resource-types) is indicated with its own icon, and they can be arranged into [Bundles](/snowray/reference/resources/bundles.md) to create a hierarchical and more organized structure.

![Resources Page](https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/QXk6gi6LEcuKSpy6djIk/resources_page.png)

Selecting a resource will activate the Quick Details section, which will be updated with useful information about the given resource, such as ID, status, creation date, or visibility.

<img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/c7RvLcMxtXfgxADtB0Sw/resources_details.png" alt="Resrouce Details Section" width="303">

{% hint style="info" %}
You can click the title of the resource in the Quick Details header to navigate to its ***Overview*** tab.
{% endhint %}

### Shared with me

Users can have access to certain resources owned by [organizations](/snowray/reference/profile-management/organization-profile.md) or other users, either by being members of said organization or through a direct invitation to a resource. These resources are listed in the ***Shared with me*** tab of the Resources page.&#x20;

The owner of the resource is displayed in front of the resource title.

<figure><img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/UZbDpgH1sQThsage6AxL/resources_shared_with_me.png" alt=""><figcaption><p>Shared With Me Page</p></figcaption></figure>

{% hint style="info" %}
You can visit the owner's profile by clicking on it in the title.
{% endhint %}

## Features

### Browsing

Resources can be accessed in two different ways: either from the [Dashboard](/snowray/reference/dashboard.md) or from the Resources Page. Clicking on the title of a resource, will always open it and take users to its ***Overview*** tab, where all the relevant information is displayed, such as title, ID, URL, language, usage, contact, purpose, copyright, and description.&#x20;

{% hint style="info" %}
If you want to access the ***Content*** tab of a resource, double-click on its row.
{% endhint %}

### Searching

The search bar at the top of the table allows users to find specific resources using term-based search.&#x20;

![Searching](https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/9tL7gKMFmZoBdbtpRUjq/resources_search.gif)

In addition, the advanced filter can be used to further refine the results by clicking on the <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/4qEsgUdwzLfjXfV4P99A/filter_icon.svg" alt="" data-size="line"> icon. Filtering options include refinement based on *Resource types*, *Status* and *Visibility*.&#x20;

Besides the filtering options, different sort options are also available.

Once the required filters and/or sort options are selected, pressing <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/KWQBqJNdgL4ktwik98pU/apply_button.png" alt="" data-size="line"> will restrict the list to the matching resources.

<img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/ysE8EqewnKnjhY09Wjt9/resources_filter.jpeg" alt="Resources Page Advanced Filter" width="242">

{% hint style="info" %}
You can combine the term search with filters to refine your searches even more.
{% endhint %}

{% hint style="info" %}
When you have filters applied, a counter next to the icon will indicate the number of active filters.
{% endhint %}

### Smart Search <a href="#quickaccess" id="quickaccess"></a>

A Smart Search bar is also available at the top header section. This is a global search that is accessible not only from the Resources page but throughout the whole application as well.

<img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/vQyUVBXJQ3FuUuHHXPdX/smart_search_bar.png" alt="Smart Search Bar" width="354">

{% hint style="info" %}
To activate the Smart Search, just press the **`CTRL+K`** combination wherever you are in the application or click in the search field, and start typing your search term.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/UCkS0QAdxeE0VsQE0qlN/smart_search_widget.png" alt="" width="563"><figcaption><p>Smart Search Widget Activated</p></figcaption></figure>

Clicking on one of the matching results from the drop-down widget will always navigate users to the ***Content*** tab of the corresponding resource.

<figure><img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/J8qgBnsxfxcVrNKgZReK/smart_search_widget_with_term_resource.png" alt="" width="563"><figcaption><p>Smart Search - Searching for a Resource</p></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/7UlMR1Xskf54LZGmnLcu/smart_search_widget_with_term_content.png" alt="" width="563"><figcaption><p>Smart Search - Searching within a Resource</p></figcaption></figure>

Alternatively, keyboard shortcuts are also available to support quick access and navigation.

| Keyboard Shortcut                                                                                                                                                                                                                                                                    | Definition                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **`ENTER`**                                                                                                                                                                                                                                                                          | Press to open the selected resource, i.e. the one highlighted in the result list.                                                                                                                                                                                                                                                                                  |
| **`TAB`**                                                                                                                                                                                                                                                                            | Press to go one level down, and search within the selected resource.                                                                                                                                                                                                                                                                                               |
| <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/BgGh982a0cnzdeeFu271/up_arrow_icon.svg" alt="" data-size="line"><img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/LFEe7ifV2xCzEMd2bgX2/down_arrow_icon.svg" alt="" data-size="line"> | Use the arrows to navigate up and down in the result list.                                                                                                                                                                                                                                                                                                         |
| **`CTRL+F`**                                                                                                                                                                                                                                                                         | <p>Press to display more results. <br><em>Note:</em> In case of searching for resources, the results will be filtered and displayed on the Dashboard page. While in case of searching within a resource, users will be navigated to a filtered state of the given resource's <em><strong>Content</strong></em> tab where the additional results are displayed.</p> |
| **`ESC`**                                                                                                                                                                                                                                                                            | Press to close the drop-down widget of the Smart Search.                                                                                                                                                                                                                                                                                                           |

{% hint style="info" %}
You can find hints related to the different keyboard shortcuts in the drop-down widget as well.
{% endhint %}

### Move

Users also have the option to reorganize their resource structure.&#x20;

Clicking <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/QjPRdvygsiAh15OhEF5U/bulk_select_button.jpeg" alt="" data-size="line"> enables selecting resources for moving between Bundles. Once the checkboxes of the required resources are selected, choosing *Move* from the context menu option will display the available Bundle structure, where the new location of the selected resources can be specified.

{% hint style="info" %}
Once you're happy with your selection, press <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/PL8slsCE1CH5Q3nsGtzR/move_button.jpeg" alt="" data-size="line"> to confirm.
{% endhint %}

![Organizing Resources](https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/bvbG0ylrbC3a14rcKQFA/resources_move.gif)

{% hint style="info" %}
When moving resources, you also have the option to drag and drop them to the desired Bundle.
{% endhint %}

### Create

Resources can be created by pressing the <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/EXnp2cmDYyq14BsCdlRq/new_resource_button.png" alt="" data-size="line"> button on the Resources page, followed by selecting the required resource type from the drop-down (<img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/yypUmdvxnZOTXFqnwB6v/bundle_icon.svg" alt="" data-size="line"> [Bundles](/snowray/reference/resources/bundles.md), <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/cKbVNOJmuI1GV65LEfNe/code_system_icon.svg" alt="" data-size="line"> [Code Systems](/snowray/reference/resources/codesystems.md), <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/47QLLrYXigm2ee2bnXXf/concept_map_icon.svg" alt="" data-size="line"> [Concept Maps](/snowray/reference/resources/conceptmaps.md), or <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/Ut3ahCCwE8KGE9Do2VWi/value_set_icon.svg" alt="" data-size="line"> [Value Sets](/snowray/reference/resources/valuesets.md)). This will update the right-hand side section of the page and open the creation wizard, where details, such as the title of the resource can be specified.

![Create a New Resource](https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/nCbYlrLtcnihrr4k3Kl1/resources_create.gif)

Once the necessary details are entered, pressing the <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/YOwddn8uObO6jT8YBtwj/create_button.png" alt="" data-size="line"> button will take users to the ***Overview*** tab of the newly created resource.

### Ownership

Newly created resources belong to the workspace in which they are created, meaning the owner can be either an individual user or an organization.

Ownership of a resource can be transferred from a private workspace to an organization workspace.

{% hint style="info" %}
To transfer ownership, go to the *Settings* section of the resource ***Overview*** page, select the destination organization, and press <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/qo0hnMOaTsNypbNrq8HF/transfer_button.png" alt="" data-size="line">.
{% endhint %}

## Resource Types

There available resource types to work with are: <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/cKbVNOJmuI1GV65LEfNe/code_system_icon.svg" alt="" data-size="line">Code Systems,<img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/Ut3ahCCwE8KGE9Do2VWi/value_set_icon.svg" alt="" data-size="line">Value Sets, <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/SVpltBCgfuhEaCO1U19b/refset_icon.svg" alt="" data-size="line"> Reference Sets, <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/47QLLrYXigm2ee2bnXXf/concept_map_icon.svg" alt="" data-size="line"> Concept Maps, <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/yypUmdvxnZOTXFqnwB6v/bundle_icon.svg" alt="" data-size="line">Bundles, and <img src="https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/zHnzbTpwn0avH2rYV39S/collection_icon.svg" alt="" data-size="line"> Reference Set Collections. For more information please visit the pages below:

{% content-ref url="/pages/-MfXh4MUr9NBwoM3fOaJ" %}
[Code Systems](/snowray/reference/resources/codesystems.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MfXh70QhOJClYDY4VNp" %}
[Value Sets](/snowray/reference/resources/valuesets.md)
{% endcontent-ref %}

{% content-ref url="/pages/-MfXhC\_KSezs1AOMsNRZ" %}
[Concept Maps](/snowray/reference/resources/conceptmaps.md)
{% endcontent-ref %}

{% content-ref url="/pages/7ShO0S3YYC6oBTt7FMv2" %}
[Bundles](/snowray/reference/resources/bundles.md)
{% endcontent-ref %}

## Lifecycle

After creating a resource, its status will automatically be set to *draft*. Once the content reaches its desired state and is released, the status of the resource will be updated to *active*. If a resource is still in draft status and is not intended to be used later on, it can be *deleted*. On the other hand, if a resource becomes outdated or out of use after being released, it can only be *retired* at that point.

{% hint style="info" %}
Resources can still be viewed after transitioning to *retired* status, however, *deleted* resources will not be available in the app anymore.
{% endhint %}

![Resource Lifecycle](https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/hcc34FFt1KRXtYxYLrOi/resources_lifecycle.png)

## Refresh Page

When working with resources, the page of the resource will not be refreshed automatically. If a page gets outdated because of modifications made by other users, a dialog will appear in the bottom right corner to indicate this.

![Refresh Page](https://content.gitbook.com/content/qCGAqlIn2vgCXJQadBh7/blobs/sIXxha9GKaKRWrsg5Nc9/page_refresh_dialog.png)

{% hint style="info" %}
To refresh the page, simply click on the button prompted in the notification.
{% endhint %}

{% hint style="warning" %}
Refreshing the page will discard all the uncommitted changes.
{% endhint %}