Изменение данных

Запуск процесса при изменении данных в Бипиуме: создании, изменении, удалении записей.

События делятся на уведомления, запросы и действия:

  • Уведомления срабатывают после сохранения изменений
  • Запросы срабатывают перед тем как данные сохранены, они могут отменить операцию.
  • Действия срабатывают во время редактирования записи сотрудником и могут подменять значения полей

Подробнее о типах событий смотрите в статье «События».

Создание подписки на событие об изменении данных

  • В разделе «Управление» в каталоге «События» добавьте новую запись (событие, по которому будет запускаться процесс).
  • Укажите название. Например, ту задачу, которую выполняет процесс.
  • Выберите каталог, в котором хотите отслеживать изменение записей.
  • Выберите тип события для запуска сценария. Подробнее в статье «События».
  • В поле «Выполнить» выберите или создайте новый сценарий.


Входные параметры

Бипиум запускает процесс, передавая ему входных переменные от события. Эти переменные можно использовать внутри процесса.

Уведомления

Уведомления — события, которые срабатывают после того как изменения сохранены в базу Бипиума.

Уведомление о создании записи

Входные переменные:

  • catalogId(строка) — идентификатор каталога, в котором создали запись
  • recordId(строка) — идентификатор созданной записи
  • values(объект) — коллекция значений заполненных полей созданной записи. Ключи объекта — идентификаторы (ID) заполненных полей. Пример:
values: {
    "2": "Record Title", // текстовое поле
    "14": 123 // числовое поле
}

Уведомление об изменении записи

Входные переменные:

  • catalogId(строка) — идентификатор каталога, в котором изменили запись
  • recordId(строка) — идентификатор удаленной записи
  • values(объект) — коллекция значений измененных полей измененной записи. Ключи объекта — идентификаторы (ID) измененных полей. Пример:
values: {
    "2": "Title",
    "14": 4562,
    "15": "2017-10-11T08:01:28:000Z1" // поле дата
}

Уведомление об удалении записи

Входные переменные:

  • catalogId(строка) — идентификатор каталога, в котором удалили запись
  • recordId(строка) — идентификатор измененной записи
  • values(объект) — коллекция значений всех полей удаленной записи. Ключи объекта — идентификаторы (ID) всех полей. Пример:
values: {
    "2": "Title",
    "14": 4562,
    "15": "2017-10-11T08:01:28:000Z1",
    "16": [ // поле связанный объект
        {
            "sectionId": "3",
            "catalogId": "5",
            "catalogTitle": "Клиенты",
            "catalogIcon": "users-10",
            "recordId": "33",
            "recordTitle": "Место работы"
        }
    ]
}

Запросы

Запросы — события, которые срабатывают до того как изменения сохранены базу Бипиума. Они позволяют блокировать применение изменений.

Запрос на создание записи

Входные переменные:

  • catalogId(строка) — идентификатор каталога, в котором хотят создать запись
  • values(объект) — коллекция значений заполненных полей создаваемой записи. Ключи объекта — идентификаторы (ID) заполненных полей. Пример:
values: {
    "2": "Record Title", // текстовое поле
    "14": 123 // числовое поле
}

Запрос на изменение записи

Входные переменные:

  • catalogId(строка) — идентификатор каталога, в котором хотят изменить запись
  • recordId(строка) — идентификатор записи, которую хотят изменить.
  • values(объект) — коллекция значений измененных полей редактируемой записи. Ключи объекта — идентификаторы (ID) измененных полей. Пример:
values: {
    "2": "Title",
    "14": 4562,
    "15": "2017-10-11T08:01:28:000Z1" // поле дата
}

Запрос на удаление записи

Входные переменные:

  • catalogId(строка) — идентификатор каталога, в котором хотят удалить запись
  • recordId(строка) — идентификатор записи, которую хотят удалить.
  • values(объект) — коллекция значений всех полей удаляемой записи. Ключи объекта — идентификаторы (ID) всех полей. Пример:
values: {
    "2": "Title",
    "14": 4562,
    "15": "2017-10-11T08:01:28:000Z1", // поле дата
    "16": []
}

Действия

Действия — события, которые срабатывают в момент редактирования сотрудником карточки записи, до того когда сотрудник решил сохранить запись. Они позволяют изменять данные на лету.

Событие пока не доступно.

Изменение поля во время редактирования записи

Входные переменные:

  • catalogId(строка) — идентификатор каталога, в котором редактируют запись
  • recordId(строка) — идентификатор редактируемой записи
  • allValues(объект) — коллекция значений полей редактируемой записи. Ключи объекта — идентификаторы (ID) всех полей. Пример:
values: {
    "2": "Title",
    "14": 4562,
    "15": "2017-10-11T08:01:28:000Z1", // поле дата
    "16": []
}
  • values(объект) — коллекция значений отслеживаемых полей редактируемой записи. Ключ объекта — идентификатор (ID) измененного отслеживаемого поля. Пример:
values: {
    "2": "Title"
}

Выходные параметры

Названия всех служебных выходные переменных начинается с знака доллара ($).

Уведомления

Создание, изменение и удаление записи

Уведомления не ожидают возвращаемых значений от процесса.

Запросы

Запросы ожидают от процесса разрешения применить или заблокировать изменение данных.

Создание, изменение и удаление записи

«Запрос на создание записи», «Запрос на изменение записи» и «Запрос на удаление записи» ожидают возвращаемые значения:

  • $status(строка) — код http-ответа: 200 — успех, 4xx (например, 400) — отказ сотруднику в операции
  • $body(объект) — объект содержащий свойство message для отображения сотруднику сообщения, в случае запрета изменения данных. Пример:
$body = {
    "message": "Вы не можете удалить эту запись."
}

Также message может содержать объект с заголовком для всплывающего окна и текстом. Пример:

$body = {
    "message": {
        "title": "Информация",
        "text": "Отказано в доступе!"
    }
}

Чтобы вернуть эти значения как результат процесса, должны быть созданы переменные с такими названиями в сценарии до компонента «Конец процесса», например с помощью компонента «Назначение переменных».

Действия

Изменение полей во время редактирования

Событие пока не доступно.


results matching ""

    No results matching ""