Процесс заявки на закупку оборудования. Добавление справочника. Журнал и форма не по умолчанию
===============================================================================================

.. contents::
	:depth: 3

.. note::

    Данная статья является продолжением работы с созданным ранее бизнес-процессом :ref:`Заявка на закупку оборудования<sample_request>` 

Справочник «Тип оборудования»
-------------------------------

Добавим справочник **«Тип оборудования»**, который мы будем использовать в заявке на закупку оборудования.

**Справочник (datalist)** - тип для хранения набора данных, который будет использоваться в качестве статических данных для документов, не участвующие непосредственно в бизнес-процессах. 

Для создания типа данных перейдите в рабочее пространство администратора в разделе **Модель** перейдите в пункт **Типы данных**:

  .. image:: _static/equipment_request/adm_ws.png
       :width: 700
       :align: center

Для создания типа данных перейдите в журнал **«Типы данных» (Раздел администратора - Модель - Типы данных)**:

.. image:: _static/equipment_request_complicated/01.png
       :width: 700
       :align: center

нажмите **+ - Создать новый тип**:

.. image:: _static/equipment_request_complicated/02.png
       :width: 600
       :align: center

Основное
~~~~~~~~~~

На вкладке расположены основные данные по типу данных (объекту):

.. list-table:: 
      :widths: 10 20 30
      :align: center
      :class: tight-table 

      * - **1**
        - id
        - equipment-type
      * - **2**
        - Имя
        - Тип оборудования
      * - **3**
        - Родитель
        - Справочник
      * - **4**
        - Форма
        - Оставить по умолчанию (система автоматически сгенерирует форму по тем атрибутам, которые мы укажем далее, но автоматически сгенерированные формы нельзя редактировать)
      * - **5**
        - Журнал
        - Оставить по умолчанию (система автоматически сгенерирует журнал по тем атрибутам, которые мы укажем далее, но автоматически сгенерированные журналы нельзя редактировать)

Конечная настройка вкладки:

.. image:: _static/equipment_request_complicated/03.png
       :width: 700
       :align: center

Атрибуты
~~~~~~~~~~

Заполните следующие атрибуты (свойства объекта):

.. list-table:: 
      :widths: 10 20 30
      :header-rows: 1
      :align: center
      :class: tight-table 

      * - Id (1)
        - Имя (2)
        - Тип (3)
      * - type
        - Наименование
        - Text

.. image:: _static/equipment_request_complicated/04.png
       :width: 700
       :align: center

Для сохранения нажмите **«Сохранить»**.

Добавьте журнал **type$equipment-type** в меню, аналогично, как описано в :ref:`статье<journal_to_menu>` и заполните его данными:

.. image:: _static/equipment_request_complicated/04_1.png
       :width: 700
       :align: center

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

Добавление дополнительного атрибута
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Далее в существующий тип данных необходимо добавить атрибут **«Тип оборудования»**. Найдите тип данных **«Заявка на покупку оборудования»**, перейдите в режим редактирования:

.. image:: _static/equipment_request_complicated/05.png
       :width: 700
       :align: center

На вкладке **«Атрибуты»** нажмите **«+Добавить еще»** и заполните строку следующими данными:

.. image:: _static/equipment_request_complicated/06.png
       :width: 700
       :align: center

.. list-table:: 
      :widths: 10 20 30
      :header-rows: 1
      :align: center
      :class: tight-table 

      * - Id (1)
        - Имя (2)
        - Тип (3)
      * - type
        - Тип
        - Association

Нажмите **«Настроить»**:

.. image:: _static/equipment_request_complicated/07.png
       :width: 500
       :align: center

Нажмите **«Выбрать»** и из списка типов данных выберите **«Тип оборудования»**:

.. list-table::
      :widths: 20 20
      :align: center

      * - |

            .. image:: _static/equipment_request_complicated/08.png
                  :width: 600
                  :align: center

        - |

            .. image:: _static/equipment_request_complicated/09.png
                  :width: 500
                  :align: center

Переместите добавленную строку под строку **Название оборудования**:

.. image:: _static/equipment_request_complicated/10.png
       :width: 600
       :align: center

Так же добавим атрибут **Комментарий согласующего**, который позже добавим и на форму согласования.

.. list-table:: 
      :widths: 10 20 30
      :header-rows: 1
      :align: center
      :class: tight-table 

      * - Id (1)
        - Имя (2)
        - Тип (3)
      * - attributeForComment
        - Комментарий согласующего
        - Text

.. image:: _static/equipment_request_complicated/attributeForComment.png
       :width: 600
       :align: center


Шаблон нумерации
~~~~~~~~~~~~~~~~~~~

Номер можно присваивать автоматически. И номер можно отражать в шаблоне отображения имени. Для этого необходимо задать и настроить :ref:`Шаблон нумерации<number_template>`

Перейдите во вкладку **«Основные»**:

.. image:: _static/equipment_request_complicated/11.png
       :width: 600
       :align: center

В поле **«Шаблон нумерации»** нажмите **«Выбрать»**. Далее нажмите **«Создать - Создать новый шаблон»**:

.. image:: _static/equipment_request_complicated/12.png
       :width: 600
       :align: center

Заполните открывшуюся форму:

.. image:: _static/equipment_request_complicated/13.png
       :width: 500
       :align: center

.. list-table:: 
      :widths: 20 20 30
      :header-rows: 1
      :align: center
      :class: tight-table 

      * - Номер маркера (1)
        - Название поля (2)
        - Значение (3)
      * - 1
        - 2
        - 3
      * - id
        - Name
        - Counter key
      * - equipment-request-number-template
        - Equipment Request Number Template
        - equipment-request-counter

И выберите созданный шаблон:

.. image:: _static/equipment_request_complicated/14.png
       :width: 600
       :align: center

В поле **«Шаблон отображения имени»** укажите **Заявка_${_docNum}**:

.. image:: _static/equipment_request_complicated/15.png
       :width: 600
       :align: center

Журнал и форма не по умолчанию
---------------------------------

Для типа данных были созданы автоматически генерируемая форма и журнал, но отредактировать их нельзя.

.. image:: _static/equipment_request_complicated/16.png
       :width: 600
       :align: center

Добавление полей в журнал
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Перейдите в тип данных и чтобы скопировать журнал, нажмите:

.. image:: _static/equipment_request_complicated/17.png
       :width: 600
       :align: center

Откроется форма с названием по умолчанию: 

.. image:: _static/equipment_request_complicated/18.png
       :width: 500
       :align: center

Переименуйте в **equipment-request** и нажмите **«Подтвердить»**:

.. image:: _static/equipment_request_complicated/18_1.png
       :width: 500
       :align: center
 
После сохранения происходит создание нового журнала и в типе данных автосгенерированный журнал изменяется на созданный. 

Для его редактирования нажмите:

.. image:: _static/equipment_request_complicated/19.png
       :width: 600
       :align: center

Отроется журнал, в который можно внести изменения:

.. image:: _static/equipment_request_complicated/20.png
       :width: 600
       :align: center

Далее добавим в журнал системные поля (ссылка) аналогично, как добавляли выше **Тип оборудования**:

       - **_created**- дата и время создания объекта. Тип данных выбрать **«Дата»**
       - **_disp** - отображаемое имя (т.к выше мы задали **Шаблон отображения имени**, то в поле будет отражаться **Заявка_ {Номер}**)
       - **_status** – статус объекта
  
Нажмите **«+Добавить»** и заполните строки следующими данными:

.. image:: _static/equipment_request_complicated/21.png
       :width: 600
       :align: center

**Сохраните.**

.. note::

 Добавьте журнал **equipment-request** в меню, аналогично, как :ref:`описано <journal_to_menu>` 

 Автосгенериванный **type$equipment-request** журнал удалите из меню.

Откройте журнал **«Заявка на закупку оборудования»**. В него добавлены новые столбцы.

.. image:: _static/equipment_request_complicated/21_1.png
       :width: 700
       :align: center

Изменение полей формы
~~~~~~~~~~~~~~~~~~~~~~~~~~~

Перейдите в тип данных и чтобы скопировать форму, нажмите:

.. image:: _static/equipment_request_complicated/22.png
       :width: 600
       :align: center

Откроется форма с названием по умолчанию: 

.. image:: _static/equipment_request_complicated/23.png
       :width: 500
       :align: center

Переименуйте в **equipment-request** и нажмите **«Подтвердить»**:

.. image:: _static/equipment_request_complicated/23_1.png
       :width: 500
       :align: center

После сохранения происходит создание новой формы и в типе данных автосгенерированная форма изменяется на созданную. Для ее редактирования нажмите:

.. image:: _static/equipment_request_complicated/24.png
       :width: 600
       :align: center

Отроется форма, в которую можно внести изменения. 

.. image:: _static/equipment_request_complicated/24_1.png
       :width: 600
       :align: center

Для перехода к редактированию компонентов нажмите **«Редактировать форму»**.

.. image:: _static/equipment_request_complicated/25.png
       :width: 600
       :align: center

1.	Перетаскиванием перенесем поле **«Тип»** выше под поле **«Название оборудования»**.

.. image:: _static/equipment_request_complicated/25_1.png
       :width: 600
       :align: center

2.	Сделаем поле **«Название оборудования»** обязательным. Для перехода к редактированию компонента нажмите:

.. image:: _static/equipment_request_complicated/26.png
       :width: 600
       :align: center

Далее открывается форма редактирования свойств компонента. В правой части для удобства доступен предпросмотр настроенного компонента.

.. image:: _static/equipment_request_complicated/27.png
       :width: 600
       :align: center

На вкладке **«Базовые»** выставите чекбокс **«Обязательное» (1)** и сохраните **(2)**.

3.	В поле **«Тип оборудования»** укажем тип по умолчанию. На вкладке **«Данные»**:

.. image:: _static/equipment_request_complicated/28.png
       :width: 600
       :align: center

выберите значение по умолчанию:

.. image:: _static/equipment_request_complicated/29.png
       :width: 500
       :align: center

|

.. image:: _static/equipment_request_complicated/30.png
       :width: 600
       :align: center

**Сохраните.**

4.	В поле **«Инициатор»** настроим так, чтобы создающий заявку пользователь указывался автоматически. На вкладке **«Кастомные»** выставите чекбокс **«Текущий пользователь по умолчанию»** и сохраните.

.. image:: _static/equipment_request_complicated/31.png
       :width: 600
       :align: center

**Сохраните.**

5. Поле **«Комментарий согласующего»** будет заполняться при согласовании. Тогда при создании заявки запретим ввод данных в него:

.. image:: _static/equipment_request_complicated/attributeForComment_form.png
       :width: 600
       :align: center

**Сохраните.**

Отредактированная форма:

.. image:: _static/equipment_request_complicated/32.png
       :width: 600
       :align: center

Нажмите **«Сохранить»**.

.. image:: _static/equipment_request_complicated/33.png
       :width: 600
       :align: center

Нажмите **«Сохранить»**.

Перейдите в журнал **«Заявка на закупку оборудования»** и нажмите **+**. Поля формы изменены:

.. image:: _static/equipment_request_complicated/34.png
       :width: 500
       :align: center


Добавление сохранения комментария согласующего в заявке
---------------------------------------------------------

В тип данных и, соответственно, на форму мы добавили атрибут **Комментарий согласующего**, теперь необходимо добавить атрибут в **форму задачи "На согласовании согласующим" (1)**, а так же компонент **Script task (2)** в бизнес-процесс.

.. image:: _static/equipment_request_complicated/comment_to_bp.png
       :width: 700
       :align: center

Добавление атрибута на форму (1)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- Перейдите в компонент **пользовательская задача «На согласовании согласующим»** и далее в режим редактирования формы:

.. image:: _static/equipment_request_complicated/comment_to_form_01.png
       :width: 700
       :align: center

- Нажмите **«Редактировать форму»**:

.. image:: _static/equipment_request_complicated/comment_to_form_02.png
       :width: 600
       :align: center

- Выберите компонент **Text area**, поскольку комментарий может содержать много символов:

.. image:: _static/equipment_request_complicated/comment_to_form_03.png
       :width: 600
       :align: center

- Укажите:

 * Название поля - **Комментарий согласующего**
 * Имя свойства - **comment**

и нажмите кнопку **«Сохранить»**:

.. image:: _static/equipment_request_complicated/comment_to_form_04.png
       :width: 600
       :align: center

- Сохраните форму:

.. image:: _static/equipment_request_complicated/comment_to_form_05.png
       :width: 600
       :align: center

- Выйдите из режима редактирования, нажав **«Сохранить»**:

.. image:: _static/equipment_request_complicated/comment_to_form_06.png
       :width: 600
       :align: center

Добавление скрипта в процесс (2)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Между элементами **пользовательская задача «На согласовании согласующим»**  и **Gateway** необходимо добавить :ref:`скриптовую задачу<script_task>`.

- Для этого сначала удалите стрелку:

 .. image:: _static/equipment_request_complicated/comment_to_bp_01.png
       :width: 300
       :align: center

- Далее в  контекстном меню нажмите на компонент **«Task»**:

 .. image:: _static/equipment_request_complicated/comment_to_bp_02.png
       :width: 250
       :align: center

- Измените его тип на **Script task**:

 .. image:: _static/equipment_request_complicated/comment_to_bp_03.png
       :width: 300
       :align: center

- Чтобы комментарий, введенный при согласовании, сохранялся в заявке, укажите в форме:

    *	Имя - **«Сохранение комментария»**,
    *	в **Скрипте**:

    .. code-block::

       document.att('attributeForComment', comment); 
       document.save();

 .. image:: _static/equipment_request_complicated/comment_to_bp_04.png
       :width: 300
       :align: center

- Добавьте стрелку от **Script task** до **Gateway**.

Процесс можно сохранить и опубликовать, нажав:

.. image:: _static/equipment_request_complicated/comment_to_bp_05.png
       :width: 700
       :align: center

Для проверки процесса создайте заявку, отправьте ее на согласование. Если согласующий вносит комментарий в задачу:

.. image:: _static/equipment_request_complicated/comment_01.png
       :width: 600
       :align: center

то он сохранится в карточке заявки:

.. image:: _static/equipment_request_complicated/comment_02.png
       :width: 600
       :align: center