8.2.1. События пользователей

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

  • event.users.account.change Изменение данных полей первичной карточки пользователя, т.е. параметров его учётной записи:

    • Фамилия
    • Имя
    • Отчество
    • Логин
    • Код для показателей
    • e-mail
    • JID
    • Личная папка пользователя
  • event.users.formdata.change Изменение данных карточек пользователей на основе форм, ассоциированных с ним посредством функциональности «Отдел кадров». Для данного события передаются следующие данные:

    • userID - идентификатор пользователя
    • formUUID - идентификатор формы карточки пользователя
    • dataUUID - идентификатор данных по форме
  • event.users.account.add Добавление новой записи учётной записи пользователя (и связанными с ней файлами по формам «отдела кадров»)

  • event.users.account.delete Удаление (пометка «удалённые») учётной записи пользователя (и связанных с ней файлов по формам «отдела кадров»)

  • event.users.contactdata.change Изменение «контактных данных» пользователя — изменение/добавление записей раздела «Контакты» профиля пользователя (модуль «Сотрудники») следующих типов:

    • Skype
    • Рабочий телефон
    • XMPP
    • Адрес
    • Мобильный телефон
    • Почта
    • Телефон

Для всех событий типа event.users.* передаваемые данные — идентификатор пользователя Synergy.

8.2.2. События должностей

Данные события генерируются для каждого из нижеописанных случаев c должностями:

  • event.orgstructure.position.add Добавление новой должности

  • event.orgstructure.position.change Изменение данных должности - добавление/изменение/удаление следующей информации:

    • Общее:
      • Название должности (на трех языках)
      • Код для показателей
      • Подразделение
      • Шифр
      • Необходимое количество штатных единиц
      • Тип назначения целей
      • Номер
    • Управление модулями
    • Показатели - статус активности
  • event.orgstructure.position.formdata.change Изменение данных карточки должности на основе формы, ассоциированной с ней посредством функциональности «Отдел кадров». Для данного события передаются следующие данные:

    • positionID - идентификатор должности
    • assistantID - идентификатор заместителя, передается только при изменении
      данных карточки заместителя
    • formUUID - идентификатор формы карточки должности
    • dataUUID - идентификатор данных по форме
  • event.orgstructure.position.delete Удаление должности

Для всех событий типа event.orgstructure.position.* передаваемые данные - идентификатор должности Synergy.

8.2.3. События подразделений

Данные события генерируются для каждого из нижеописанных случаев c подразделениями:

  • event.orgstructure.department.add Добавление нового департамента

  • event.orgstructure.department.change Изменение данных подразделения - добавление/изменение/удаление следующей информации:

    • Общее: * Информация о подразделении:

      • Название (на трех языках)
      • Номер
      • Код для показателей
      • Родительское подразделение (для всех узлов, кроме корневого)
      • Удаленный филиал
      • Информация о руководителе подразделения: * Название должности (на трех языках) * Тип назначения целей * Руководитель * И.О. руководителя

      • Заместители: * Название (на трех языках) * Номер * Пользователь * Подразделения, в которых данный пользователь будет

        выполнять обязанности заместителя

    • Управление модулями

    • Показатели - статус активности

    • Права на дела: * Наследовать права от родительского подразделения * Дело * Тип документа

    Примечание

    Ввиду особенностей реализации при сохранении подразделения отдельно сохраняется его карточка, отдельно - заместители. Таким образом, в данном случае событие 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.

8.2.4. События реестров

Событие для реестра не генерируются самостоятельно и не имеют предопределенных названий. Для того, чтобы для реестра было сгенерировано событие, необходимо в процесс активации / изменения / удаления реестра добавить процесс «Событие реестра» и указать в поле «Название» его название.

Название события должно начинаться со строки event.registries.formdata.. Для различных событий и для различных реестров могут быть указаны разные либо одинаковые названия событий в зависимости от целей решаемой задачи.

../_images/registries-event.png

Процесс «Событие реестра»

8.2.5. События адресной книги

Объекты адресной книги (люди, организации) могут генерировать следующие события:

  • event.addressbook.contact.add Добавление нового контакта адресной книги
  • event.addressbook.contact.change Изменение данных контакта адресной книги: добавление / изменение / удаление записей карточки контакта. Событие генерируется при изменении:
    • данных в дополнительной карточке
    • данных в стандартной карточке:
      • «Люди»: ФИО, дата рождения, изображение, телефон, мобильный, e-mail, адрес, IM, URL, место работы, примечание, ключевые слова, поля дополнительной карточки, а также доступность контакта
      • «Организации»: название, изображение, сайт, адрес, телефон, мобильный, e-mail, поля дополнительной карточки, а также доступность контакта
  • event.addressbook.contact.change Изменение данных контакта адресной книги
  • event.addressbook.contact.delete Удаление контакта адресной книги

Для всех событий типа event.addressbook.contact.* передаваемые данные - это идентификатор контакта адресной книги Synergy.

8.2.6. События работ

  • event.workflow.work.create Создание работы

  • event.workflow.work.change Изменение следующих параметров работы:

    • название
    • нагрузка
    • приоритет
    • сроки
    • ключевые слова
    • повторение
    • форма завершения
    • прогресс
  • event.workflow.work.completion Фактическое завершение работы

  • event.workflow.work.expired Работа просрочилась

  • event.workflow.work.delete Удаление работы

    Примечание

    При добавлении/изменении/удалении комментария к работе, аналогичное событие для документов в очередь не добавляется.

Для события event.workflow.work.expired используется системная настройка «Интервал проверки работ на просроченность (в минутах)» (Конфигуратор -> Настройки системы -> Параметры уведомлений)

Минимальный набор передаваемых данных для всех событий типа event.workflow.work.*:

  • идентификатор работы

Если работа запускается по реестру, то также обязательно передаются:

  • идентификатор данных по форме записи реестра (свойство с ключом dataUUID)
  • идентификатор документа реестра (свойство с ключом documentID)

В случае, если генерируется любое событие по работе, порожденной мероприятием проекта, в свойствах сообщения (ключ ArrangementID) передается идентификатор этого мероприятия (ParentID).

Для работ по процессу «работа по форме» (вызванного как непосредственно из маршрута реестра, так и из шаблона маршрута), кроме всего прочего, также передаются данные из дополнительных полей, настроенных непосредственно в самом процессе «работа по форме».

8.2.7. События по проектам

  • event.projects.arrangement.create Создание мероприятия проекта

  • event.projects.arrangement.delete Удаление мероприятия проекта

  • event.projects.arrangement.restore Восстановление мероприятия проекта

  • event.projects.arrangement.responsibles Фактическое изменение списка ответственных за мероприятие проекта

    Примечание

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

  • event.projects.arrangement.progress Выставление прогресса мероприятия

Минимальный набор передаваемых данных для всех событий типа event.projects.arrangement.* - это идентификатор мероприятия проекта.

8.2.8. События по документам

  • event.docflow.document.register Регистрация документа в журнале

    Минимальный набор передаваемых данных в сообщении для события event.docflow.document.register - идентификатор документа.

    В свойствах сообщения (ключ registerID) передаётся идентификатор журнала.

  • event.docflow.document.opened - открытие документа (генерируется только из UI Synergy):

    • documentID - идентификатор документа;
    • userID - идентификатор пользователя, сохранившего данные по форме;
    • date - дата и время открытия документа;
  • event.docflow.document.closed - закрытие документа (генерируется только из UI Synergy):

    • documentID - идентификатор документа;
    • userID - идентификатор пользователя, сохранившего данные по форме;
    • date - дата и время открытия документа.

8.2.9. События по формам

  • event.form.formdata.change Создание и сохранение данных по форме

Минимальный набор передаваемых данных в сообщении для события event.form.formdata.change:

  • dataUUID - идентификатор данных по форме;
  • formID - идентификатор формы;
  • formCode - код формы;
  • registryCode - код реестра, если данные формы по реестру;
  • userID - идентификатор пользователя, сохранившего данные по форме;
  • isNew - сохранены ли данные:
    • true - новые;
    • false - существующие.

В свойствах сообщения (ключ dataUUID) также передаётся идентификатор данных по форме.

8.2.10. События комментариев

Данные события генерируются для каждого из нижеописанных случаев:

Комментарии к работе

  • event.comment.work.add Добавление нового комментария к работе
  • event.comment.work.change Изменение комментария к работе
  • event.comment.work.delete Удаление комментария к работе

Примечание

При добавлении/изменении/удалении комментария к работе, аналогичное событие для документов в очередь не добавляется.

Комментарии к документу

  • event.comment.document.add Добавление нового комментария к документу
  • event.comment.document.change Изменение комментария к документу
  • event.comment.document.delete Удаление комментария к документу

Личные комментарии

  • event.comment.personal.add Добавление нового личного комментария
  • event.comment.personal.change Изменение личного комментария
  • event.comment.personal.delete Удаление личного комментария

Комментарии к проекту/мероприятию

  • event.comment.action.add Добавление нового комментария к мероприятию проекта
  • event.comment.action.change Изменение комментария к мероприятию проекта
  • event.comment.action.delete Удаление комментария к мероприятию проекта

Для всех событий типа event.comment.* передаваемые данные зависят от типа комментария и выглядят следующим образом:

  • Комментарий к работе:

    • идентификатор комментария (свойство с ключом message text)
    • идентификатор автора комментария (свойство с ключом userID)
    • идентификатор документа (свойство с ключом documentID)
    • идентификатор работы (свойство с ключом actionID)
  • Комментарий к документу:

    • идентификатор комментария (свойство с ключом message text)
    • идентификатор автора комментария (свойство с ключом userID)
    • идентификатор документа (свойство с ключом documentID)
  • Личный комментарий:

    • идентификатор комментария (свойство с ключом message text)
    • идентификатор автора комментария (свойство с ключом userID)
    • идентификатор документа (свойство с ключом documentID)
    • идентификатор работы (свойство с ключом actionID)
  • Комментарий к мероприятию:

    • идентификатор комментария (свойство с ключом message text)
    • идентификатор автора комментария (свойство с ключом userID)
    • идентификатор проекта (свойство с ключом projectID)
    • идентификатор мероприятия (свойство с ключом actionID)

    Примечание

    В случае, если объектом события является комментарий к проекту, то параметры projectID и actionID будут равны.

8.2.11. Генерация произвольных событий

В ARTA Synergy имеется метод API, позволяет генерировать произвольные события.

URL метода: rest/api/events/create. Тип запроса: POST.

Метод принимает следующие обязательные параметры:

  • eventName - название события (строка);
  • eventMsg - произвольный json (строка).

В случае успешного выполнения метода сервер вернет сообщение «Событие успешно сгенерировано».

Пример:

Событие, генерируемое мобильным клиентом по координатам GPS:

eventName=event.ext.gps&eventMsg={\"lat\":333.333,\"lon\":222.222}