Рабочие пространства
========================

.. contents::
    :depth: 3

**Рабочее пространство** — отдельная область в Citeck для совместной работы пользователей над определённой функциональностью. Разделение данных, пунктов меню и вкладок по рабочим пространствам улучшает навигацию и позволяет изолировать объекты разных команд или направлений деятельности.

Подробнее о работе с рабочими пространствами со :ref:`стороны пользователя<workspaces>`.

Администратор управляет рабочими пространствами в разделе **«Администратор»** → подраздел **«Модель»**:

- создаёт, редактирует и удаляет пространства;
- настраивает пункты меню и типы данных для каждого пространства;
- задаёт принадлежность типов данных к конкретному пространству или к глобальному — чтобы объекты (например, общие справочники) были доступны во всех пространствах одновременно.

Тип данных
-----------

 .. image:: _static/ws/data_type_02.png
       :width: 600
       :align: center

**Видимость** в рабочих пространствах:

    - **По умолчанию** – назначается типу данных по умолчанию.
    - **Приватная** – экземпляры типа данных доступны в рамках рабочего пространства, в котором созданы.
    - **Публичная** – экземпляры типа данных доступны пользователям в соответствии с правами, независимо от рабочего пространства, в котором созданы.

**Рабочее пространство по умолчанию** – в каком рабочем пространстве будет отображаться по умолчанию.

Журнал Рабочие пространства
------------------------------

В разделе администратора в подразделе **«Модель»** добавлен журнал **«Рабочие пространства»**:

 .. image:: _static/ws/journal.png
       :width: 700
       :align: center

В журнале можно создать, отредактировать, удалить пространства.

Создание рабочего пространства
--------------------------------

См. :ref:`Создание рабочего пространства<new_workspace>`


.. _template_workspace:

Шаблоны рабочих пространств
--------------------------------

Шаблон содержит уже настроенные пункты меню, дашборды разделов и домашней страницы.

В разделе администратора в подразделе **«Модель»** добавлен журнал **«Шаблоны рабочих пространств»**:

 .. image:: _static/ws/template_1.png
       :width: 700
       :align: center

Создание шаблона
~~~~~~~~~~~~~~~~~~

1. Создайте новое **рабочее пространство**. Настройте в этом рабочем пространстве **меню** и **дашборд(ы)**.
2. Перейдите в журнал **«Шаблоны рабочих пространств»**, нажмите **+ - Создать**.
3. Выберите созданное в **п.1** **рабочее пространство**, укажите **id** и **Имя**, сохраните.

 .. image:: _static/ws/template_2.png
       :width: 600
       :align: center

4. Опционально скачайте новый шаблон и загрузите его в ecos-app или в микросервис по пути **artifacts/model/workspace-template**
5. Опционально загрузите шаблон на стенд (если необходимо его использовать не на том стенде, где он был создан) вручную или через деплой ecos-app/микросервиса.
6. Перейдите в журнал **«Рабочие пространства»**, нажмите **+ - Создать**.

 .. image:: _static/ws/template_4.png
       :width: 700
       :align: center

7. В поле **«Шаблон»** выберите шаблон, который создали в **п.3** Заполните остальные обязательные поля и нажмите **«Создать»**.

 .. image:: _static/ws/template_5.png
       :width: 600
       :align: center

8. Откройте созданное в **п.7** рабочее пространство - в нем меню и дашборд совпадают с теми, что были настроены в **п.1**

 .. image:: _static/ws/template_6.png
       :width: 700
       :align: center

При создании шаблона конфигурации меню и дашбордов копируются внутрь шаблона (т.е. последующие изменения меню/дашбордов шаблон автоматически не обновит).

Чтобы обновить артефакты в шаблоне предусмотрено действие **«Обновить шаблон»** в журнале **«Шаблоны рабочих пространств»**.

 .. image:: _static/ws/template_7.png
       :width: 700
       :align: center

При создании рабочего пространства на основе шаблона создаются новые конфигурации меню и дашбордов с автоматически сгенерированным id и явно указанным полем workspace.