-

docs/integration/events.rst

@@ -21,11 +21,11 @@
     посредством функциональности «Отдел кадров». Для данного
     события передаются следующие данные:
 
-        * `userID` - `ID` пользователя
+        * ``userID`` - идентификатор пользователя
 
-        * `formUUID` - `ID` формы карточки пользователя
+        * ``formUUID`` - идентификатор формы карточки пользователя
 
-        * `dataUUID` - `ID` данных по форме
+        * ``dataUUID`` - идентификатор данных по форме
 
 *   ``event.users.account.add`` Добавление новой записи учётной
     записи пользователя (и связанными с ней файлами по формам
@@ -48,7 +48,7 @@
         * Телефон
 
 Для всех событий типа ``event.users.*`` передаваемые данные —
-``ID`` пользователя Synergy.
+идентификатор пользователя Synergy.
 
 События должностей
 ------------------
@@ -79,13 +79,76 @@
     посредством функциональности «Отдел кадров». Для данного события
     передаются следующие данные:
 
-        * ``positionID`` - ``ID`` должности
-        * ``assistantID`` - ``ID`` заместителя, передается только при изменении
+        * ``positionID`` - идентификатор должности
+        * ``assistantID`` - идентификатор заместителя, передается только при изменении
             данных карточки заместителя
-        * ``formUUID`` - ``ID`` формы карточки должности
-        * ``dataUUID`` - ``ID`` данных по форме
+        * ``formUUID`` - идентификатор формы карточки должности
+        * ``dataUUID`` - идентификатор данных по форме
 
 *   ``event.orgstructure.position.delete`` Удаление должности
 
 Для всех событий типа ``event.orgstructure.position.*`` передаваемые
-данные - ``ID`` должности ``Synergy``.
+данные - идентификатор должности ``Synergy``.
+
+События подразделений
+---------------------
+
+Данные события генерируются для каждого из нижеописанных случаев c
+*подразделениями*:
+
+*   ``event.orgstructure.department.add`` Добавление нового
+    департамента
+
+*   ``event.orgstructure.department.change`` Изменение данных
+    подразделения - добавление/изменение/удаление следующей
+    информации:
+
+    *   Общее:
+        *   Информация о подразделении:
+            *   Название (на трех языках)
+            *   Номер
+            *   Код для показателей
+            *   Родительское подразделение (для всех узлов, кроме
+                корневого)
+            *   Удаленный филиал
+        *   Информация о руководителе подразделения:
+            *   Название должности (на трех языках)
+            *   Тип назначения целей
+            *   Руководитель
+            *   И.О. руководителя
+        *   Заместители:
+            *   Название (на трех языках)
+            *   Номер
+            *   Пользователь
+            *   Подразделения, в которых данный пользователь будет
+                выполнять обязанности заместителя
+    *   Управление модулями
+    *   Показатели - статус активности
+    *   Права на дела:
+        *   Наследовать права от родительского подразделения
+        *   Дело
+        *   Тип документа
+
+    .. note:: Ввиду особенностей реализации при сохранении
+              подразделения отдельно сохраняется его карточка,
+              отдельно - заместители. Таким образом, в данном
+              случае событие ``event.orgstructure.department.change``
+              будет отправлено дважды, а при изменении заместителей
+              через метод API ``rest/api/positions/assistant/save`` -
+              единожды.
+
+*   ``event.orgstructure.department.formdata.change`` Изменение данных
+    *карточки подразделения* на основе *формы*, ассоциированной с ней
+    посредством функциональности «Отдел кадров». Для данного события
+    передаются следующие данные:
+
+        * ``departmentID`` - идентификатор подразделения
+
+        * ``formUUID`` - идентификатор формы карточки подразделения
+
+        * ``dataUUID`` - идентификатор данных по форме
+
+*   ``event.orgstructure.department.delete`` Удаление подразделения
+
+Для всех событий типа ``event.orgstructure.department.*`` передаваемые
+данные - идентификатор подразделения `Synergy`.