Модуль «Поручения»
=====================

.. _ecos-assignments:

Модуль предназначен для постановки поручений на исполнение, и проверки результатов их исполнения при необходимости. 
Поручение может быть назначено с проверяющим сотрудником, или без него.

.. contents::
		:depth: 3

Схема бизнес-процесса
----------------------

 .. image:: _static/tasks/tasks_1.png
       :width: 800
       :align: center 

Роли
-----

.. list-table::
      :widths: 20 40
      :class: tight-table 
      
      * - **Инициатор**
        - Сотрудник, создающий поручение
      * - **Исполнитель**
        - Сотрудник, выполняющий поставленное Инициатором поручение
      * - **Проверяющий**
        - Сотрудник, проверяющий исполнение поручения

Статусы
-------

.. list-table::
      :widths: 20 40
      :class: tight-table 
      
      * - **Создано**
        - | Инициатор создал поручение, Система формирует уведомление Исполнителю.    
      * - **Проверка**
        - | В поручении выставлен чекбокс «Проверять результат». 
          | Назначенным сотрудникам поступает уведомление о проверке выполнения поручения.
      * - **Доработка**
        - | Проверяющий сотрудник направляет поручение Исполнителю на доработку.   
          | Система формирует уведомление Исполнителю.
      * - **Выполнено**
        - | Смена статуса, свидетельствующая о завершении процесса.  
          | Инициатор получает уведомление о выполнении поручения.

Журнал
-------

 .. image:: _static/tasks/tasks_2.png
       :width: 800
       :align: center 

Журнал содержит поля:
    -	Дата создания;
    -	Имя;
    -	Название;
    -	Статус;
    -	Инициатор;
    -	Срок.

Например, https://host/v2/journals?journalId=assignments-journal

Карточка
----------

 .. image:: _static/tasks/tasks_3.png
       :width: 700
       :align: center 

.. list-table::
      :widths: 20 40
      :class: tight-table 
      
      * - **Название**
        - | Текстовое поле. Наименование поручения. 
      * - **Описание**
        - | Текстовое поле. Описание поручения. 
      * - **Срок**
        - | Выбирается из календаря, заполняется вручную. Срок выполнения поручения.      
      * - **Приоритет**
        - | Выбирается из выпадающего списка. Приоритет поручения.
      * - **Инициатор**
        - | Заполняется по умолчанию данными сотрудника, создающего поручение. Не может быть изменено.
      * - **Исполнитель**
        - | Выбирается из оргструктуры. Сотрудник, выполняющий поставленное Инициатором поручение.
      * - **Проверять результат**
        - | Чекбокс. Если необходима проверка результата выполнения поручения.
      * - **Проверяющий**
        - | Добавляется при выставлении чекбокса «Проверять результат».
          | Проверяющим по умолчанию будет выставлен Инициатор, по кнопке «Изменить» можно сделать иной выбор из оргструктуры.
      * - **Связанные элементы**
        - | Выбор из журнала. Задается связь с другими элементами ECOS.

Создание поручения
--------------------

1.	Создание поручения возможно как с помощью кнопки быстрого создания: 

 .. image:: _static/tasks/tasks_4.png
       :width: 300
       :align: center 

или из журнала **«Поручения»**:

 .. image:: _static/tasks/tasks_5.png
       :width: 800
       :align: center 

2.	Для конкретного кейса может быть создана из журнала по нажатию на:

 .. image:: _static/tasks/tasks_6.png
       :width: 800
       :align: center 

.. _ecos-assignments-action:

3.	Из карточки кейса на дашборде **«Действия»**:

 .. image:: _static/tasks/tasks_7.png
       :width: 300
       :align: center 

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

 .. image:: _static/tasks/tasks_8.png
       :width: 700
       :align: center 

При создании поручения из кейса автоматически проставляется связь:

 .. image:: _static/tasks/tasks_9.png
       :width: 700
       :align: center 

В зависимости от выставленного чекбокса **«Проверять результаты»** могут быть 2 варианта развития бизнес-процесса:

    -	без проверки результата исполнения;
    -	с проверкой результата исполнения.

Ниже рассмотрим оба варианта.


Поручение без проверки исполнения
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 .. image:: _static/tasks/tasks_10.png
       :width: 600
       :align: center 

Заполните обязательные поля, отмеченные звездочкой.

В разделе **«Связанные элементы»** можно задать связь поручения с другими элементами ECOS – сначала необходимо **«Выбрать тип»**:

 .. image:: _static/tasks/tasks_11.png
       :width: 300
       :align: center 

И далее выбрать связанные элементы:

 .. image:: _static/tasks/tasks_12.png
       :width: 500
       :align: center 

Для начала процесса нажмите **«Создать»**. Система создает поручение на Исполнителя.

Связанные с поручением элементы будут представлены в виджете **«Связи документа»**:

 .. image:: _static/tasks/tasks_18.png
       :width: 300
       :align: center

Выполнение поручения Исполнителем
"""""""""""""""""""""""""""""""""""""

Перейти к Поручению в статусе **«Создано»** Исполнитель может любым из способов:

    -	из полученного уведомления;
    -	из журнала **«Активные задачи»**;
    -	открыв поручение в журнале **«Поручения»**.


 .. image:: _static/tasks/tasks_13.png
       :width: 800
       :align: center 

Нажмите **«Выполнить»**, так же можно указать комментарий в поле **«Комментарий»**.

Поручение перейдет в статус **«Выполнено»**, Инициатор получит уведомление.

Поручение с проверкой исполнения
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 .. image:: _static/tasks/tasks_14.png
       :width: 600
       :align: center 

В разделе **«Общее»** заполните обязательные поля, отмеченные звездочкой.

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

Для начала процесса нажмите **«Создать»**. Система создает поручение на Исполнителя.

Выполнение поручения Исполнителем
"""""""""""""""""""""""""""""""""""

Перейти к Поручению в статусе **«Создано»** Исполнитель может любым из способов:

    -	из полученного уведомления;
    -	из журнала **«Активные задачи»**;
    -	открыв поручение в журнале **«Поручения»**.

 .. image:: _static/tasks/tasks_15.png
       :width: 800
       :align: center 

Нажмите **«Выполнить»**, так же можно указать комментарий в поле **«Комментарий»**.

Поручение перейдет в статус **«Проверка»**, Инициатор получит уведомление.

Проверка поручения Проверяющим
"""""""""""""""""""""""""""""""""

Перейти к Поручению в статусе **«Проверка»** Проверяющий может любым из способов:

    -	из полученного уведомления;
    -	из журнала **«Активные задачи»**;
    -	открыв поручение в журнале **«Поручения»**.

 .. image:: _static/tasks/tasks_16.png
       :width: 800
       :align: center 

Выполнение поручения можно:

  - принять, нажав **«Принято»**, статус изменится на **«Выполнено»**.

  - отправить Исполнителю, нажав **«На доработку»**, статус изменится на **«Доработка»**. Исполнитель получит уведомление.

Так же можно указать комментарий в поле **«Комментарий проверяющего»**.

Доработка поручения Исполнителем
"""""""""""""""""""""""""""""""""""""

Перейти к Поручению в статусе **«Доработка»** Исполнитель может любым из способов:

    -	из полученного уведомления;
    -	из журнала **«Активные задачи»**;
    -	открыв поручение в журнале **«Поручения»**.

 .. image:: _static/tasks/tasks_17.png
       :width: 800
       :align: center 

Нажмите **«Выполнить поручение повторно»**, так же можно указать комментарий в поле **«Результат выполнения поручения»**.

Поручение перейдет в статус **«Проверка»**, Проверяющий получит уведомление.