Автозапуск Бизнес-процессов

Штатный автозапуск: запуск БП только при изменении или добавления сущности.
Наше решение: позволяет запускать БП как в определенное время, так и с указанной периодичностью.
Можно также выбрать кратность запуска (однократно или многократно). 

Кнопка "Добавить БП" - после нажатия появляется меню настройки сценария автозапуска БП.
Доступные для настройки параметры: 

• Тип сущности (обязательно);
• ID сущности (обязательно);
• Шаблон БП (обязательно);
• Запускать периодически (опционально);
• Месяц запуска (опционально);
• Час запуска (опционально);
• Минута запуска (опционально);
• Тип запуска (опционально);
• Активировать шаблон автозапуска БП.

Тип сущности: выпадающий список, в котором нужно выбрать в каком типе сущности будет происходить автозапуск.
Этот параметр обязателен к заполнению.

Для каждого сценария можно выбрать только 1 тип сущности, с которым он будет работать.
Если вы хотите чтобы сценарий работал с другим типом сущности, то нужно настраивать сценарий для другого типа сущности отдельно.
Типы сущности, доступные к выбору: Лид, Сделка, Контакт, Компания, БП в живой Ленте, Универсальные списки, Смарт-процессы, Диск.

ID сущности: указывается идентификатор сущности, с которой будет работать БП.
Этот параметр обязателен к заполнению.

Шаблон БП: позволяет выбрать из списка БП, который есть на портале.
Этот параметр обязателен к заполнению.

Этот БП будет автоматически запускаться согласно настроенного вами сценария.

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

Месяц запуска, Час запуска, Минута запуска - позволяют указать месяц, час и минуту запуска БП.
Поля заполняются в числовом виде.
Т.е если вы хотите, чтобы БП запускался 9 марта в 14:38, то нужно заполнить поля как на скриншоте ниже.

Тип запуска: позволяет выбрать из выпадающего списка сколько раз будет запущен БП, один раз или несколько.
Варианты:

• Многократно;
• Однократно;

Активировать шаблон автозапуска БП: данный параметр служит для активации или деактивации сценария автозапуска.
Если параметр не активировать, то сценарий автозапуска работать не будет.

Статус: отображает статус активности сценария автозапуска.

• Зеленый - сценарий активен;
• Красный - сценарий не активен (отключен).

Данные БП: отображает краткий набор данных о сущности с которой работает БП.
Отображаемые данные:

• Тип сущности с которой работает БП;
• ID сущности;
• Название БП, который задействован в сценарии автозапуска.

Последнее редактирование: отображает данные о времени последнего редактирования сценария автозапуска и пользователя, который проводил редактирование.

Интервал запуска: отображает данные об интервале запуска БП, который задан в сценарии автозапуска.

Тип запуска: отображает сколько раз будет запущен БП согласно настроек сценария, один раз или несколько.

Следующий запуск: отображает дату и время следующего автозапуска БП.

Прошлый запуск: отображает дату и время предыдущего автозапуска БП в сценарии.

Статус запуска: отображает статус запуска БП, срабатывал ли автозапуск или нет.

Значек карандаша: позволяет отредактировать сценарий автозапуска.

Значок "урны": позволяет удалить сценарий автозапуска после подтверждения процедуры удаления.

Массовый запуск Бизнес-процессов

При работе с бизнес-процессами и сущностями, в Битрикс24 бывают сценарии при которых необходимо запустить БП (бизнес-процесс) для нескольких сущностей.
Можно запускать БП из меню в каждой сущности, но если их много, 50,100 и более, то это будет довольно затратно по времени, и не эффективно.
Именно для таких случаев мы разработали данный функционал.

Цветовая расшифровка статусов в таблице:

• Белый - шаблон сохранен, но не выполняется и не был запущен;
• Синий - шаблон выполняется;
• Зеленый - шаблон успешно завершил работу;
• Красный - шаблон завершил работу с ошибкой;
• Оранжевый - работа шаблона остановлена сотрудником.

Для того чтобы запустить множество сущностей, нужно эти сущности определить, для этого нужен раздел "Фильтр".

Для настройки шаблона массового запуска, нужно нажать кнопку "Добавить шаблон".
После этого откроется меню настройки шаблона, с активной вкладкой "Фильтр":

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

Выберите тип сущности: позволяет выбрать из выпадающего списка тип сущности, с которой будет работать шаблон массового запуска БП. Так же, выбор в этом поле определяет для поля "Список шаблонов БП", для какой сущности подгружать бизнес-процессы из конструктора БП.

Поддерживаются следующие типы сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• БП в живой ленте;
• Универсальные списки;
• Смарт-процессы.

Список шаблонов БП: позволяет выбрать из выпадающего списка, БП, которые будут запущены этим шаблоном массвого запуска после настройки.

Ограничить количество элементов до: позволяет указать максимальное количество элементов, с которыми шаблон будет работать за 1 проход.
Т.е если вам нужно обработать к примеру 150 элементов и в поле вы укажите 30, то шаблон за раз будет работать максимум с 30 элементами.
Это нужно для того, чтобы не "заливать" наше приложение либо сервер Б24 эвентами и не попасть в очередь или блокировку по лимиту.
Параметры фильтров Обновить : эта кнопка позволяет произвести обновление подгрузившихся параметров фильтра, в случае если это потребуется.

Кнопка Поиск по фильтру : активирует поиск сущностей по заранее заданным в фильтре параметрам.
После поиска будут отображены (если найдены) сущности с которыми будет работать шаблон массового запуска.

Набор фильтров состоит из кастомных и пользовательских полей, которые существуют в рамках выбранного типа сущности.
Если бы добавили новое кастомное поле в какую-то из сущностей и хотите чтобы она отобразилась в фильте, нужно воспользоваться кнопкой "Обновить".

Найденные фильтром элементы будут отображены во вкладке "Найдено".
После того, как фильтр нашел необходимые элементы и вы удалили (или нет) лишние, Вы можете сразу запустить шаблон массового запуска в работу, нажатием кнопки Выполнить запуск.
Вкладка "История операций" - отображает операции, время их выполнения и ФИО сотрудника, от имени которого эти операции были выполнены.

 

Статус: отображает статус выполнения шаблона.
Значение цветовой палитры статусов описано выше.

Шаблон БП: Отображает название БП, который работает в шаблоне массвого запуска.

Тип сущности: отображает тип сущности с которой работает шаблон массвого запуска.

Кол. найденных: отображает количество сущностей с которыми работает шаблон массвого запуска.

Последний запуск: отображает дату и время последнего запуска в формате год-месяц-день, часы-минуты-секунды.

Когда создан: отображает дату и время создания шаблона. 

Кем создан: отображает имя и ID пользователя, который создал шаблон.

Бизнес-процессы

Запуск бизнес-процесса для Лида

Данное активити позволяет запускать бизнес-процесс для сущности "Лид" после выбора необходимых БП из списка.


Бизнес-процесс: в данном поле из выпадающего списка можно выбрать какие активити будут запущены в результате работы БП "Запуск бизнес-процесса для лида".
Все доступные варианты являются ранее созданными шаблонами БП для сущности данного типа.

ID сущности: в данном пункте указывается ID сущности "Лид" для которой будут запущены активити, выбранные в п. меню "Бизнес-процесс".

Параметры для бизнес-процесса: в данном пункте указываются параметры, которые нужно передать в БП.
Заполняется по такому принципу: название параметра: содержимое параметра
Пример ввода параметра: Title:123 
Параметр,указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для лида". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID лида, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID лида).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.
Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Запуск бизнес-процесса для Компании

Данное активити позволяет запускать бизнес-процесс для сущности "Компания" после выбора необходимых БП из списка.

 
Пример ввода параметра: Title:123 
Параметр, указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для компании". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID компании, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID компании).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.
Схема: Название переменной:содержимое. Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Запуск бизнес-процесса для Контакта

Данное активити позволяет запускать бизнес-процесс для сущности "Контакт" после выбора необходимых БП из списка.


Бизнесс-процес: в данном поле из выпадающего списка можно выбрать какие активити будут запущены в результате работы БП "Запуск бизнесс-процесса для Контакта".
Все доступные варианты являются ранее созданными шаблонами БП для сущности данного типа.

ID сущности: в данном пункте указывается ID сущности "Контакт" для которой будут запущены активити, выбранные в п. меню "Бизнесс-процесс".

Параметры для бизнес-процесса: в данном пункте указываются параметры, которые нужно передать в БП.
Заполняется по такому принципу: название параметра: содержимое параметра
Пример ввода параметра: Title:123 
Параметр, указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для компании". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID компании, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID компании).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Запуск бизнес-процесса для Сделки

Данное активити позволяет запускать бизнес-процесс для сущности "Сделка" после выбора необходимых БП из списка.


Бизнес-процесс: в данном поле из выпадающего списка можно выбрать какие активити будут запущены в результате работы БП "Запуск бизнесс-процесса для сделки".
Все доступные варианты являются ранее созданными шаблонами БП для сущности данного типа.

Параметры для бизнес-процесса: в данном пункте указываются параметры, которые нужно передать в БП.
Заполняется по такому принципу: название параметра: содержимое параметра
Пример ввода параметра: Title:123 
Параметр, указанный в данной строке должен быть создан как "шаблон параметра" в запускаемом БП.
Шаблон параметра создается во вкладке Параметры шаблона -> Параметры. и будет выглядеть так (Взято из примера "Title:123"), где Title - сам параметр.

Далее этот параметр нужно указать в тех активити, которые будут запущены с помощью "Запуск бизнес-процесса для компании". При этом сам параметр нужно вставлять только в те поля БП, в которых требуются передаваемые параметром данные (т.е если нужно передать ID компании, и параметр под это заточен, то в запускаемом активити параметр вставляется в поле, где требуется ID компании).
Чтобы выбрать параметр для добавления в нужное поле, нужно возле этого поля нажать "..." -> Параметры шаблона -> Выбрать подходящий шаблон с параметрами.

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Задание в карточке сущности

Данное активити позволяет добавить поле "Задача" в тело выбранной сущности, тем самым позволяя ставить задания из карточки сущности определенным пользователям.

Сценарий работы активити бизнес-процесса

Тип сущности: в данном пункте указывается тип сущности, в которой появится поле для указания задачи.
ID сущности: в данном поле указывается ID сущности, в которой будет добавлено поле задания.
Файлы: в данном поле указывается публичная ссылка на ресурс, где размещен файл для скачивания. Доступно увеличение количества полей с помощью кнопки "Добавить".

Название	Описание
Разрешить ответственному перепоручить выполнение другому пользователю (Да\Нет):	Позволяет ответственному за сущность перепоручить задание другим пользователям.
Требуется комментарий пользователя? (Да\Нет):	Выберите данный пункт, чтобы в карточке появилось поле для ввода комментария.

Показывать задание только выбранному(выбранным): Данное поле позволяет ограничить круг пользователей, которые могут видеть поле задания в данной сущности. Выбирать можно только пользователей, группы пользователей выбирать нельзя.

Название	Описание
Цвет рамки (например #FFFFFF):	Позволяет выбрать цвет рамки вокруг карточки задания, в виде шестнадцатеричного кода палитры.
Включить мигание рамки задания (Да\Нет):	Позволяет активировать мигание рамки задания в карточке сущности.
Заголовок задания:	Позволяет указать заголовок задания.
Содержание задания:	Позволяет указать содержание задания.
Название Кнопки 1:	Позволяет указать название первой кнопки, которая расположена в левом нижнем углу задания.
Цвет текста Кнопки 1 (например #FFFFFF):	Позволяет указать цвет текста в кнопке 1, в виде шестнадцатеричного кода палитры.
Цвет кнопки 1 (например #d2f95f):	Позволяет указать цвет кнопки 1, в виде шестнадцатеричного кода палитры.
Название Кнопки 2:	Позволяет указать название второй кнопки, которая расположена в левом нижнем углу задания, после первой кнопки.
Цвет текста Кнопки 2 (например #FFFFFF):	Позволяет указать цвет текста в кнопке 2, в виде шестнадцатеричного кода палитры.
Цвет кнопки 2 (например #cc1a00):	Позволяет указать цвет кнопки 2, в виде шестнадцатеричного кода палитры.
Название Кнопки 3:	Позволяет указать название третьей кнопки, которая расположена в левом нижнем углу задания.
Цвет текста Кнопки 3 (например #FFFFFF):	Позволяет указать цвет текста в кнопке 3, в виде шестнадцатеричного кода палитры.
Цвет кнопки 3 (например #ff0000):	Позволяет указать цвет кнопки 3, в виде шестнадцатеричного кода палитры.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

ВАЖНО! 
Данное активити не совместимо с одноименным активити из "Лаборатории БП" и самим приложением "Лаборатория БП".
Это значит, что если установлено приложение "Лаборатория БП" и активити "Задание в карточке сущности" из лаборатории БП, то такое же активити из приложения "Лаборатория роботов" работать не будет, до тех пор, пока не будет удалено приложение "Лаборатория БП".

Группы

Добавление группы (проекта)

Данное активити позволяет создавать группу или проект с настройками, указанными в активити.

Название	Описание
Название группы:	в данном поле указывается название группы (проекта)
Владелец группы:	Владельцем группы (проекта) будет тот пользователь, от имени которого произошел запуск активити. Если данный вариант вам не подходит, то в следующем активити можно запустить смену владельца группы (проекта).
Описание группы:	в данном указывается описание группы (проекта)
Видна ли группа в списке:	Выбор из выпадающего списка: да/нет. Позволяет выбрать видна ли группа в списке групп.
Открыта ли группа для свободного вступления:	позволяет открыть и закрыть свободное вступление в группу
Ключевые слова (через запятую):	В данном пункте указываются ключевые слова.
Кто может приглашать пользователей?:	Выбор из выпадающего списка тех, кто может приглашать кого-либо в группу. Это могут быть пользователи, модераторы, владелец группы.
Кто может писать в группу?:	Выбор из выпадающего списка тех, кто может писать в группу. Это могут быть пользователи, модераторы, владелец группы.
Тип группы:	Выбор из выпадающего списка типа группы:обычная группа, либо проект.
Дата старта проекта:	В данном пункте указывается дата начала проекта.
Дата окончания проекта:	В данном пункте указывается дата окончания проекта.
Пригласить пользователей в группу (укажите через точку с запятой):	В данном поле указываются пользователи, которые будут приглашены в группу. Выбор пользователей происходит из выпадающего меню.
Текст приглашения:	В данном пункте указывается текст приглашения, который пользователи получат при приглашении в группу.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
   

Смена владельца группы (проекта)

Данное активити позволяет сменить владельца группы (проекта).


ID группы: в данном пункте указывается ID группы (проекта, владельца в которой надо сменить).

Владелец группы: в данном пункте указывается новый владелец группы(проекта).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Изменение группы (проекта)

Данное активити позволяет изменять группу или проект с настройками, указанными в активити.

Название	Описание
ID группы:	В данном пункте указывается ID группы (проекта) в котором будут произведены изменения.
Название группы:	В данном поле указывается название группы (проекта)
Описание группы:	В данном указывается описание группы (проекта)
Видна ли группа в списке:	Выбор из выпадающего списка: да/нет. Позволяет выбрать видна ли группа в списке групп.
Открыта ли группа для свободного вступления:	Позволяет открыть и закрыть свободное вступление в группу
Ключевые слова (через запятую):	В данном пункте указываются ключевые слова.
Кто может приглашать пользователей?:	Выбор из выпадающего списка тех, кто может приглашать кого-либо в группу. Это могут быть пользователи, модераторы, владелец группы.
Кто может писать в группу?:	Выбор из выпадающего списка тех, кто может писать в группу. Это могут быть пользователи, модераторы, владелец группы.
Тип группы:	Выбор из выпадающего списка типа группы:обычная группа, либо проект.
Дата старта проекта:	В данном пункте указывается дата начала проекта.
Дата окончания проекта:	В данном пункте указывается дата окончания проекта.
Пригласить пользователей в группу (укажите через точку с запятой):	В данном поле указываются пользователи, которые будут приглашены в группу. Выбор пользователей происходит из выпадающего меню.
Текст приглашения:	В данном пункте указывается текст приглашения, который пользователи получат при приглашении в группу.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Добавление сообщения в живую ленту

Данное активити позволяет добавлять сообщения в живую ленту и группу (проект).

ID автора сообщения (только один): данное поле позволяет указать ID автора сообщения.

Получатели сообщения (сотрудники): данное поле позволяет выбрать получателей сообщения, указав их ID, либо передав в поле массив с ID пользователей.

Получатели сообщения (группы): позволяет указать ID групп, проектов или отделов, (можно указать несколько) тогда все сотрудники вышеперечисленных структур получат сообщение в разделе "Лента".
Чтобы указать получателями группу или подразделение, нужно:
1. Рядом с полем "получатели сообщения "нажать "..." .
2. Выбрать пункт категории "пользователей" (как на скриншоте).

3. Выбрать пункт "Группы социальной сети".
4. Выбрав пункт "Группы социальной сети", нужно выбрать фильтр справа "Мои группы".
5. Выбрать нужную Вам группу/подразделение.

Заголовок сообщения: данное поле позволяет указать заголовок сообщения. 

Текст сообщения: в данном поле указывается текст сообщения.

Важное сообщение: позволяет выбрать, является ли данное сообщение важным или нет.

Дата(время) до которого сообщение будет важным:  позволяет указать дату и время, до наступления которых сообщение будет находиться в статусе "Важно".

Прикрепить файл(ы) к сообщению (ID файлов с диска) : в данном поле указывается ID файлов, расположенных на диске, которые должны быть прикреплены к сообщению.

Добавить видео в сообщение: в данном поле необходимо указать код видео Youtube.
Пример:
Ссылка на видео https://www.youtube.com/watch?v=jWlAPx4Z40g, где код этого видео jWlAPx4Z40g .

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

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Добавление участника(ов) в группу

Данное активити позволяет добавить участника в группу (проект).


ID рабочей группы: в данном полу указывается ID группы (проекта)

ID пользователя (или массив ID). : в этом поле нужно указать ID пользователя, которого активити добавит в группу.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Удаление участника(ов) из группы

Данное активити позволяет удалить участника из группы (проекта).


ID рабочей группы: в данном полу указывается ID группы (проекта)

ID пользователя (или массив ID). : в этом поле нужно указать ID пользователя, которого активити удалит из группы (проекта).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Поиск группы (проекта)

Данное активити позволяет искать группу или проект с настройками, указанными в активити.

 

Название	Описание
ID рабочей группы:	В этом поле нужно указать ID рабочей группы, если таковая есть.
Код сайта:	В этом поле нужно указать код сайта, если такой используется.
Название группы:	В этом поле нужно ввести название искомой группы.
Описание группы:	В этом поле заполняется текст - описание искомой группы.
Дата создания:	В этом поле нужно выбрать в календаре дату и время создания искомой группы.
Дата последнего изменения параметров группы:	В этом поле нужно выбрать в календаре дату и время последнего изменения параметров искомой группы.
Активность:	Нужно указать активна группа или нет, варианты на выбор: да/нет.
Видима ли группа в списках:	Нужно указать, видима ли искомая группа в списках. Варианты для выбора: да/нет.
Открыта ли группа для свободного вступления:	Нужно указать, открыта искомая группа для свободного вступления или нет. Варианты для выбора: да/нет.
Является ли группа архивной:	Нужно указать, является ли искомая группа архивной (удаленной). Варианты для выбора: да/нет.
Код темы группы:	В этом поле нужно указать код темы группы.
Код пользователя - владельца группы:	В этом поле нужно указать код пользователя, владеющего группой, т.е его ID.
Ключевые слова:	Указываются ключевые слова.
Количество членов группы:	Нужно указать количество членов группы (цифрами).
Кто имеет право на прием в группу новых членов:	Из выпадающего списка нужно выбрать кто имеет права на прием в группу новых членов. Доступно несколько вариантов на выбор:  Владелец группы. Владелец группы и модераторы. Все члены группы.
Кто имеет право на написание сообщений членам группы:	Из выпадающего списка нужно выбрать кто имеет права на написание сообщений членам группы. Доступно несколько вариантов на выбор:  Владелец группы. Владелец группы и модераторы. Все члены группы.
Дата последней активности в группе:	В этом поле нужно выбрать в календаре дату и время последней активности в группе.
Название темы группы:	В этом поле указывают название темы искомой группы (текстом).
Имя владельца группы:	В этом поле указывают имя владельца искомой группы. (текстом).
Фамилия владельца группы:	В этом поле указывают фамилия владельца искомой группы (текстом).
Логин владельца группы:	В этом поле указывают логин владельца искомой группы (текстом).

Делать отладочные сообщения в журнал БП:  в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Возвращаемые параметры данного активити:
- Результат поиска (массив для итератора).
- Результат поиска (строка).
- Количество найденных элементов.
- Соответствует условиям.
- Сообщение об ошибке.

Дата, время и календарь

Ближайший день месяца

Данное активити позволяет задавать повторение какого-либо процесса в определенный промежуток дня/времени с помощью возврата параметра день месяца/время либо другого указанного параметра. 

День месяца (условие): Позволяет выбрать из выпадающего списка нужный день месяца. Выбрав 1: первое число месяца, 15: пятнадцатое число месяца.

Время: Указывается время к которому будет возвращено ближайшее значение ближайшего дня месяца, в формате ЧЧ:ММ.
Например: 11:00.
Если не корректно заполнить данное поле, то активити вернет в результатах не корректные данные.

Часовой пояс: указывается часовой пояс, используемый в пункте "Время", в формате "+3"

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.  

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Ближайший день недели

Данное активити позволяет задавать повторение какого-либо процесса заранее заданный промежуток дня/времени с помощью возврата параметра день недели/время либо другого указанного параметра. 
Т.е если сегодня четверг 21.02, то выставив в параметре "День недели (условие)": 6 , мы получим 6й день недели относительно текущей недели, т.е субботу 23.02. Однако если выставить в четверг 21.02 , значение параметра "День недели (условие)" 2, то мы получим вторник 26.02,т.е дату, расположенную на следующей неделе.

День недели (условие):   1: понедельник, 2: вторник, 3: среда, 4: четверг, 5: пятница, 6: суббота, 7: воскресенье.

Дата для расчета: в этом поле указывается дата для расчета ближайшего дня недели. Дата указывается в формате ДД.ММ.ГГГГ.
Если в сущности, в поле тип "дата и время" указано время, то в активити поле "Время" можно не заполнять.
Если в  сущности, в поле тип "дата и время" время не указано, т.е по умолчанию 00:00:00, то нужно заполнить поле "Время" в настройках активити, иначе вы получите результат (к примеру) 23,04,2021 00:00:00.

Время: Указывается время к которому будет возвращено ближайшее значение ближайшего дня недели, в формате ЧЧ:ММ.
Например: 11:00.
Если не корректно заполнить данное поле, то активити вернет в результатах не корректные данные.

Часовой пояс: указывается часовой пояс, используемый в пункте "Время", в формате "+3".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.           

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Добавить событие календаря

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

Тип календаря: в данном поле нужно выбрать тип календаря. Это может быть календарь сотрудника (user), календарь группы (group) либо календарь Компании (company).

Идентификатор владельца календаря: в данном поле следует указывать id сотрудника, либо id группы (ID группы указывается именно цифрой и никак иначе).
Значение указывается простой цифрой (без квадратных скобок). 

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

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

Идентификатор календаря: в данном поле требуется указать id календаря пользователя, группы, компании или переговорной комнаты.

Чтобы понять, какое значение сюда требуется прописать, необходимо:

1. Для календаря пользователя (или Компании).
Перейдите в список календарей и нажмите "Настройки"

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

2. Для календаря группы.
Перейдите в календарь группы и нажмите F12.
Нажмите на инструмент выбора блока и наведите на календарь.

В классе bxec-sect: содержится id календаря.

Значение даты передается без времени: эта опция позволит устанавливать даты события без указания времени.

Наименование события: в данном поле вы указываете тему создаваемого события.

Описание события: в данном поле вы указываете текстовое описание создаваемого события.

Цвет фона события: в данном поле вы указываете цвет создаваемого события в календаре. Применяется код цвета HTML.

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

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

Частное событие: при указании значения "да" в данном поле, Вы ограничиваете видимость содержания создаваемого события. В календаре будет отображаться что событие есть, но прочесть другим сотрудникам его не получится.

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

НАПОМИНАНИЕ (за сколько): в данном поле вы можете указать, что система должна Вас уведомить за какое-то время. Значение указывается в целых числах.

НАПОМИНАНИЕ (единица измерения): в данном поле вы можете указать, в каких единицах измерения вести отсчет времени до напоминания (дни, часы, минуты)

Список участников события: в данном поле указываются участники создаваемого события. Поле является множественным. Значение указывается через контекстное меню, либо в ручную в формате: Администратор KOSAS [1234].

Организатор события: в данном поле указывается организатор создаваемого события.  Значение указывается простой цифрой (без квадратных скобок). Это поле важно заполнять, когда это событие календаря типа встреча и в него будут приглашаться другие участники.
Создать встречу: данное поле позволяет создавать событие тип встреча, на которую приглашаются участники.

ВСТРЕЧА: Текст приглашения - в данном поле указывается описание для события типа встреча.

ВСТРЕЧА: признак открытой встречи - в данном поле указывается тип события. Встреча может быть общедоступная или закрытая.

ВСТРЕЧА: флаг оповещения о подтверждении\отказе участников - данная опция позволит (с помощью системного механизма Битрикс24) отправить оповещение о событии.

ВСТРЕЧА: флаг запроса повторного подтверждения участия (при редактировании события) - в данной опции (с помощью системного механизма Битрикс24) указывается необходимость повторно уведомлять участников события если в него будут вноситься изменения.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Изменение события календаря

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

Название	Описание
ID события:	В данном поле указывается ID события, которое планируется изменить.
Тип календаря:	В данном поле можно выбрать из выпадающего списка тип календаря:пользовательский/для групп.
Идентификатор владельца календаря:	В данном поле указывается ID владельца календаря.
Дата начала события:	В данном поле указывается дата начала изменяемого события
Дата завершения события:	В данном поле указывается дата завершения изменяемого события
Идентификатор календаря:	В данном поле указывается ID календаря, который планируется изменить.

Название	Описание
Наименование события:	В данном поле указывается наименование изменяемого события.
Описание события:	В данном поле указывается описание изменяемого события.
Цвет фона события:	В данном поле указывается цвет фона изменяемого события в формате HTML.
Цвет текста события:	В данном поле указывается цвет текста изменяемого события в формате HTML.
Доступность на время события:	В данном поле указывается доступность на время события участника этого события.
Важность события:	В данном поле указывается важность изменяемого события.
Место проведения:	В данном поле указывается место проведения изменяемого события.
НАПОМИНАНИЕ (за сколько):	В данном поле указывается напоминание (за сколько) для изменяемого события.
НАПОМИНАНИЕ (единица измерения):	В данном поле указывается напоминание (единица измерения) для изменяемого события .

Список участников события: в поле указываются участники создаваемого события.
Поле является множественным.
Значение указывается через контекстное меню, либо в ручную в формате: Администратор KOSAS [1234].

Название	Описание
Организатор события:	В данном поле указывается организатор события, указывается его ID или данный пользователь выбирается из списка пользователей портала.
Создать встречу:	Варианты: да/нет. Позволяет параллельно измененному событию создать встречу.
ВСТРЕЧА: Текст приглашения:	В данном поле указывается текст приглашения для встречи.
ВСТРЕЧА: признак открытой встречи:	В данном поле указывается, будет - ли открыта встреча или нет.
ВСТРЕЧА: флаг оповещения о подтверждении\отказе участников:	В данном поле указывается наличие флага оповещения об отказе или согласии участников, приглашенных на встречу.
ВСТРЕЧА: флаг запроса повторного подтверждения участия (при редактировании события):	В данном поле указывается флаг для повторного подтверждения об повторном подтверждении участия в событии.
Делать отладочные сообщения в журнал БП:	В данном поле указывается, будет ли сделано отладочное сообщение в журнале БП или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Удаление события календаря

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

Сценарий работы активити бизнес-процесса

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

Идентификатор владельца календаря: в данном поле указывается ID владельца календаря.

Идентификатор события: в данном поле указывается ID события, которое планируется изменить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Получить список календарей

Данное активити позволяет получить идентификаторы календарей Пользователя, Групп, Компании и Переговорных комнат.


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

• Календарь пользователя;
• Календарь группы;
• Календарь компании;
• Календарь переговорной комнаты.

Идентификатор владельца календаря: в этом поле нужно указать ID владельца календаря.
Ограничить количество результатов до: позволяет указать количество выводимых результатов до указанного значения.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Дела

Создание своего дела в CRM

Данное активити позволяет создать дело с прикреплением его к выбранной Вами сущности с указанными вами параметрами дела и возвращает в бизнес-процесс ID созданного дела.

Сценарий работы активити бизнес-процесса

Тип сущности: в данном поле указывается тип сущности к которой будет привязан бизнес-процессу данного дела.

ID Сущности: 

в данном пункте указывается ID сущности, которую необходимо изменить

.

Заголовок дела: в данном пункте указывается текстовый заголовок дела.

Содержание дела: в данном пункте указывается содержание и описание создаваемого дела.

Дата начала:

в данном поле указывается дата начала выполнения дела из выпадающего меню календаря.

Дата завершения: в данном поле указывается дата завершения выполнения дела из выпадающего меню календаря.

Ответственный за дело: сотрудник, который должен выполнить дело и отчитаться о проделанной работе. Выбирается из выпадающего списка.

Важное дело: статус уведомляющий о том, что выполнение данного дела в приоритете.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Удаление дела

Позволяет удалять дела, соответствующие указанным параметрам в активити.

Сценарий работы активити бизнес-процесса

ID дела (условие): в данном пункте указывается ID дела, которое необходимо удалить.

Владелец (условие): в данном пункте указывается человек, создавший данное дело.

Тип дела, ID (условие):
Доступно 6 условий: 1: Встреча, 2: Звонок, 3: Задача, 4: Письмо, 5: Действие, 6: Пользовательское действие.

ВАЖНО!
Удалить данным активити дело - тип "Задача" не получится, т.к "Задача", это не дело.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Создание e-mail

Данное активити добавляет e-mail в сущность CRM (лид, дело и.т.п) с помощью бизнес-процесса. Главным преимуществом является отображение письма к сущности.
Т.е. по сути позволяет создать, отправить и прикрепить письмо к указанной сущности.

Тип сущности: в данном поле указывается тип сущности, в котором будет создан e-mail.

ID Сущности: в данном пункте указывается ID сущности, в которую , будет добавлен e-mail.

Направление письма: в данном пункте указывается направление письма.
Доступны 2 варианта: Входящие, Исходящие.

Письмо выполнено: так как письмо, это тип дело, то выставляется статус как для дела, т.е письмо выполнено? - да / нет.
Доступен выбор из списка: да / нет. 

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

Отправитель письма: в данном пункте указывается отправитель письма, т.е электронная почта отправителя.

Получатели письма: в данном пункте указываются получатели письма, т.е электронная почта получателя.

Тема письма: в данном пункте указывается тема письма.

Тип содержания письма: в данном пункте указывается тип информации, содержащийся в письме. Доступно 3 варианта: TEXT, BBCODE, HTML.
Содержание письма: в данном пункте указывается сообщение или любая другая информация, которую Вы хотите сообщить получателю.

Приоритет письма: данный пункт позволяет установить приоритетный статус для письма (Важное / Не важное).

Дата начала: так как письмо, это тип дело, то нужно указать дату начала работу над делом.
Т.е в этом пункте указывается дата начала работы над делом "Создание e-mail" 

Дата завершения: так как письмо, это тип дело, то нужно указать дату завершения работ над делом.
Т.е в этом пункте указывается дата завершения работы над делом "Создание e-mail".

Вложенные файлы: позволяет прикрепить файлы к письму, указав ID файла с диска Б24.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.  

Период ожидания(Время ожидания ответа от приложения):
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск звонков в сущности

Данное активити позволяет выполнить поиск звонков в сущностях Компания, Контакт, Лид по - телефонному REST. 
Результатом работы будет получение ID звонков (реально совершенных), произведённых в рамках искомой сущности в виде массива для итератора и строки, которые соответствуют настройкам поиска.

Тип сущности: в данном поле указывается тип сущности, к которой будет привязан бизнес-процесс. Выбирается из выпадающего списка.

Искать звонки, в контактах, привязанных к Сделке: позволяет выбрать искать звонки в контактах, прикрепленных к сделке или нет.
Искать звонки, в компании, привязанной к Сделке: позволяет выбрать искать звонки в компании, привязанной к сделке или нет.
ID Сущности: в данном пункте указывается ID сущности, в которой, будет осуществлен поиск звонков.
Если указан ID сущности, то ID звонка выведен не будет, будет просто выведено значение "Y"- найдено или "N"- не найдено.

ID звонка (если заполнено, то ID сущности не учитывается): в данном поле указывается ID звонка.
ID ответившего (звонящего) оператора: в данном поле можно указать ID оператора, который отвечал, либо производил звонок.

Номер на который поступил звонок: данное поле позволяет указать номер, на который поступил звонок.

Номер клиента на который звонили: данное поле позволяет указать номер телефона клиента, на который происходил звонок.

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

Длительность звонка в секундах: в данном пункте указывается длительность искомого звонка в секундах.

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

• Успешный звонок;
• Пропущенный звонок;
• Отклонено;
• Вызов отменен;
• Запрещено;
• Неверный номер;
• Занято;
• Данное направление не доступно;
• Временно не доступен;
• Недостаточно средств на счету;
• Заблокировано.

Выбрать звонки от указанной даты: позволяет указать дату, начиная с которой будет осуществлен поиск звонков.

Выбрать звонки до указанной даты: позволяет указать дату, до которой будет осуществлен поиск звонков.

Делать отладочные сообщения в журнал БП: позволяет выбрать вносить ли отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения):
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск писем в сущности

Данное активити позволяет осуществлять поиск писем в сущности (дела). Выводит ID писем.
Результатом работы активити, будет получение ID писем в виде списка, массива для итератора, соответствие условиям поиска и количество найденных элементов (писем).

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

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

ID письма: в данном пункте указывается ID искомого письма.

Тип письма: в данном пункте указывается тип исходного письма (Входящее / Исходящее). Выбирается из выпадающего списка.

Состояние письма: в данном пункте указывается статус искомого письма (Прочитано / Не прочитано).
Выбирается из выпадающего списка.

Выполнено дело: так как письмо, это тип дело, то выставляется статус выполнено дело или нет, т.е  Да / Нет.

Выбрать письма от указанной даты: позволяет указать дату, начиная с которой будет осуществлен поиск писем.

Выбрать письма до указанной даты: позволяет указать дату, до которой будет осуществлен поиск писем.

Делать отладочные сообщения в журнал БП: позволяет выбрать вносить ли отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения):
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.  

Поиск встреч в сущности

Данное активити позволяет осуществлять поиск тип дела "Встреча" по выбранным в настройках полям, в сущностях лид, контакт, сделка, компания. 
Результатом работы является получение списка ID найденных встреч, массива для итератора, количества найденных встреч и соответствия условиям поиска.

Тип сущности:в данном поле указывается тип сущности в которой будет осуществлен поиск встреч.

ID сущности: в данном поле указывается ID сущности, в которой будет осуществлен поиск встреч.
ID встречи (если заполнено, то учитывается только статус): в данном поле можно указать ID искомой встречи.
ID встречи можно найти в пункте меню "мои дела". Статус встречи: в данном поле указывается статус искомой встречи.
Доступно 2 варианта: завершена и не завершена.

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

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

Тема встречи: в данном поле можно указать тему искомой встречи в формате TEXT

Содержание встречи: в данном поле можно указать содержание встречи в формате TEXT.

Место встречи:в данном поле можно указать место встречи в формате TEXT.

Делать отладочные сообщения в журнал БП: позволяет выбрать будут ли выводится отладочные сообщения в журнал БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени.
Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Поиск визитов в сущности

Данное активити позволяет осуществлять поиск тип дел "Визит по выбранным в настройках полям, в сущностях лид, контакт, сделка, компания.
Результатом работы является получение списка ID, найденных визитов, массива для итератора, количество найденных элементов (визитов) и соответствие условиям поиска.

Тип сущности: в данном поле указывается тип сущности в которой будет осуществлен поиск визитов.

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

ID визитов (если заполнено, то учитывается только статус): в данном поле можно указать ID искомого визита.
ID визита можно найти в пункте меню "мои дела".
Статус визита: в данном поле указывается статус искомого визита.
Доступно 2 варианта: завершен и не завершен.

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

Выбрать визиты до указанной даты: позволяет выставить дату и время, до наступления которых могли проходить искомые визиты.

Тема визита содержит: в данном поле можно указать содержание темы искомого визита в формате TEXT.

Содержание визита содержит: в данном поле можно указать содержание визита в формате TEXT.

Делать отладочные сообщения в журнал БП: позволяет выбрать будут ли выводится отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Парсинг содержимого дела

Данное активити парсит (собирает данные) содержимое дела согласно указанным параметрам.

ID Дела: в данном пункте указывается ID данные которого подвергнутся парсингу.

Параметры парсинга TITLE: в данном пункте настраивается как активити, будет искать и выдавать, описания темы или часть текста по следующим параметрам из заголовка:

Для примера рассмотрим фразу - Хитрую сороку поймать морока.

1##word -- вернет слово до слова или фразы, которые вы указали вместо word
1##морока - вернёт в дополнительные параметры процесса слово "поймать".

2##word - вернет слово после слова или фразы, которые вы указали вместо word
2##хитрую - вернёт в дополнительные параметры процесса слово "сороку".

3##word1##word2 - вернет текст, который находиться между word1 и word2
3##Хитрую##морока - вернёт в дополнительные параметры процесса текст "сороку поймать"

Для команды 4 возьмем аббревиатуру счета с его номером: НФР-190188
4##word - вернет номер счета по поисковому под слову word
4##НФР  - вернет номер счета 190188
Параметры парсинга DESCRIPTION: в данном пункте настраивается, как активити будет искать и выдавать, описания темы или часть текста по параметрам из описания.
Настраивается аналогично параметрам TITLE.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения):
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Завершение дел

Данное активити позволяет автоматически закрывать неактуальные дела (письма, встречи, звонки и т.д.), если вы знаете их ID

Сценарий работы активити бизнес-процесса

ID дела: в данном поле указывается ID дел, которое планируется закрыть.

ВАЖНО!
Удалить данным активити дело-тип "Задача" не получится, т.к "Задача", это не дело.

Ответственный: в данном поле указывается ID ответственного который указан в закрываемом деле, либо данный ответственный выбирается из списка по нажатию кнопки "..."

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Получение параметров дела

Данное активити позволяет искать параметры дел, указав их ID в настройках.

Сценарий работы активити бизнес-процесса

ID Дела: в данном поле указывается ID дела, которое нужно найти.

Делать отладочные сообщения в журнал БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Поиск дел

Данное активити позволяет искать дела по выбранным в настройках полям. Результатом работы является получение списка ID найденных дел, массива для итератора, результата поиска в виде строки, соответствие условиям поиска и количество найденных элементов(Дел).

Сценарий работы активити бизнес-процесса

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

Тип сущности: в этом поле, из выпадающего списка нужно выбрать тип сущности, к которой привязано дело.
Активити поддерживает следующие типы сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Предложение;
• Заказ;
• Счет (Новый) (смарт-счет);
• Смарт-процесс.

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

• Универсальное;
• Встреча;
• Звонок;
• задачи в Моих делах;
• Письмо;
• Дело приложения (фейс Битрикса);
• Дело приложения (фейс фрейма);
• Чат;
• Обзвон;
• SMS;
• CRM форма;
• Сообщение в живую ленту (экстранет);
• Комментарий в живую ленту (экстранет);
• Визит;
• Дело, добавленное через REST (конфигурируемое);
• Слоты;
• Доставка;
• Документ подписания;
• Дело, добавленное через REST (устаревшее);
• Сообщение в WhatsApp через ЕЦУ;
• Оплата;
• Задача, новая реализация;
• Комментарий к задаче;
• Документ складского учета;
• Zoom-конференция;
• Дело подписания документа с сотрудниками;
• Дело бронирования;
• Дело бизнес-процесса.

Тип дела "Обзвон" не привязывается к сущности, т.е его нужно искать оставив настройку "Тип сущности" к которому привязано дело" в положении "не установлено", а тип дела выбрав "обзвон".

Тема: в данном поле указывается тема указанная в искомом деле.
Начало: в данном поле указывается дата начала искомого дела.

Срок: в данном поле указывается срок искомого дела.

Срок исполнения: в данном поле указывается срок исполнения искомого дела.

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

Описание: в данном поле указывается описание искомого дела.

Место: в данном поле указывается место искомого дела.

Внешний код: в данном поле указывается внешний код для искомого дела.

Внешний источник: в данном поле указывается внешний источник искомого дела.

Делать отладочные сообщения в журнал БП:  в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Изменение дела

Данное активити позволяет изменить данные в указанном Вами деле, согласно выбранным параметрам.
Активити берет автоматически данные полей Bitrix 24.

Название	Описание
ID:	В этом поле указывается ID изменяемого дела. Данное поле работает только с возвращаемыми параметрами тип "Строка", с Массивами не работает.
ID владельца:	В этом поле указывается ID владельца дела, указывать или передавать в это поле нужно числовое значение, без доп. символов.
Тип владельца:	В этом поле указывается тип сущности к которой привязано дело, типы сущности выбираются из выпадающего списка.
Тема:	В этом поле указывается тема дела в текстовом формате.
Начало:	В данном поле указывается дата начала дела.
Срок:	В данном поле указывается срок дедлайна дела, т.е когда оно должно быть завершено.
Срок исполнения:	В данном поле указывается срок окончания исполнения дела.
Ответственный:	В этом поле нужно указать ответственного задело в виде его ID или выбрать с помощью меню "Вставка значения" (...) -> "Пользователи".
Параметр уведомления:	В данном поле указывается числовое значение, в деле это число указывает на то, за сколько часов уведомлять о деле.
Описание:	В данном поле указывается описание искомого дела.
Место:	В данном поле указывается место, где проводилось дело, т.е заполняется текстовым значением.
Внешний код:	В данном поле указывается внешний код для искомого дела.
Внешний источник:	В данном поле указывается внешний источник для искомого дела.
Автозаполнение:	В данном поле указывается значение 1 или 0, это поле регулирует параметр "Авто завершение дела" после наступления даты его завершения.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.  

Период ожидания(Время ожидания ответа от приложения):
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Слежение за делом

Данное активити позволяет срабатывать, когда в системе появиться дело с подходящими (согласно настройкам) параметрам.

Сценарий работы активити бизнес-процесса

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

ID CRM сущности: в этом поле указывается ID сущности, к которой дело привязано.

Тип дела: в данном поле нужно выбрать тип дела на которое будет реагировать активити.

Направление дела: в этом поле нужно выбрать на какое действие нужно реагировать при слежении (создание дела или обновление дела).
Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Запланировать звонок

Данное активити позволяет запланировать дело тип "звонок" в выбранной Вами сущности. 

Тип сущности: в данном поле указывается тип сущности в которой будет создано дело тип "звонок".

ID Сущности:  в данном поле указывается ID сущности к которой будет создано дело тип "звонок".

ID сделки: в данном поле указывается ID сделки, в которой дело будет создано.
Это поле нужно заполнять, когда нужна привязка и к Контакту (или Компании) и к сделке одновременно.

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

Заголовок дела: в данном пункте указывается текстовый заголовок дела.

Содержание дела: в данном пункте указывается содержание и описание создаваемого дела.

Ответственный за дело: сотрудник, который должен выполнить дело и отчитаться о проделанной работе.

Важное дело: статус уведомляющий о том, что выполнение данного дела в приоритете.

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

Дата завершения: в данном поле указывается дата завершения выполнения дела из выпадающего меню календаря.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Добавление привязки к CRM сущности

Позволяет добавить привязку к сущностям CRM

Сценарий работы активити бизнес-процесса

Идентификатор дела: в данном поле нужно указать ID дела, которое будет привязано к сущности CRM.

Идентификатор типа CRM сущности: в этом поле нужно выбрать из выпадающего списка тип сущности, к которой будет осуществлена привязка. Этот список содержит список сущностей, к которым дело всегда имеет привязку. Для привязки дела к некоторым дополнительным типам сущностей, необходимо иметь привязку к основным. 

Идентификатор CRM сущности: в данном поле указывается ID CRM сущности к которой будет привязано дело.

Идентификатор типа CRM сущности 2: это поле, в отличии от поля "Идентификатор типа CRM сущности" имеет меньше вариантов в выпадающем списке в виду того, что в данном поле выбирается дополнительная сущность для привязки, т.е оно не обязательно к заполнению.

Идентификатор CRM сущности 2: в этом поле указывается ID второй CRM сущности, к которой дело будет привязано.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Удаление привязки к CRM сущности

Позволяет удалить привязку к сущностям CRM

Сценарий работы активити бизнес-процесса

Идентификатор дела: в данном поле нужно указать ID дела, привязка которого к CRM сущности или сущностям будет удалена.

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

• Удалить все привязки: позволяет удалить все привязки к CRM сущностям кроме какой-то одной, какую оставить, активити выбирает самостоятельно и выбранный идентификатор элемента, для данного параметра значения не имеет.
  
• Только одну: если Дело имеет несколько привязок, к сущностям CRM, то выбрав данную настройку, можно будет удалить одну конкретную привязку, с конкретным типом CRM сущности;
• Все кроме: эта настройка позволяет удалить все имеющиеся привязки к CRM сущностям (указанного типа), кроме той, ID которой указан в поле "Идентификатор CRM сущности".

Идентификатор типа CRM сущности: в данном поле нужно выбрать из выпадающего списка тип CRM сущности/ей к которой дело привязано на данный момент. Если дело имеет привязку к нескольким типам сущностей, то привязка к каждому типу сущности удаляется отдельно.

Идентификатор CRM сущности: в этом поле указывается ID СRM сущности, привязку к которой нужно удалить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Получить список CRM сущностей, привязанных к делу

Позволяет получить список сущностей CRM, к которым привязано дело.

Сценарий работы активити бизнес-процесса

Идентификатор дела: в данном поле нужно указать ID дела, список привязок которого нужно получить.

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Задачи

Задачи

Создание задачи

Данное активити позволяет создавать задачи в рамках текущей сущности (лид, дело и.т.п).
Это значит, что согласно настройкам активити, внутри бизнес-процесса создается задача и возвращается ID этой задачи в "обратные параметры".

Остановить процесс во время выполнения задачи: данное поле позволяет остановить Бизнес процесс, до тех пор пока задача не будет выполнена, после выполнения задачи, Бизнес-процесс продолжит работу.
Доступно несколько значений: Да, Нет. 
Так же есть соседнее поле, в котором нужно указать значение, для которого будет применяться остановка процесса, т.е указываются параметры, которые должны быть запущены.

Название задачи: данное поле позволяет идентифицировать задачу в дизайнере бизнес-процессов. Рекомендуем использовать модель именования задач по типу - Задача №1, Задача №2  и т.д. Так Вы сможете избежать многих проблем при проектировании и использовании в дальнейшем.

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

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

Соисполнители: сотрудники, которые тоже участвуют в рабочем процессе, но важно понимать, что они не будут участвовать в последующих отчетах. Это сотрудники, которые будут получать уведомления об изменениях. 
В данном поле указывается ID соисполнителя задачи, выбор можно сделать из выпадающего списка, нажав "..." и выбрав "пользователи", либо просто указав ID нужных пользователей.

Наблюдатели: сотрудники, которые тоже участвуют в рабочем процессе просто наблюдая за изменениями в задаче.  Это сотрудники, которые будут получать уведомления об изменениях.
В данном поле указывается ID наблюдателей за задачей, выбор можно сделать из выпадающего списка, нажав "..." и выбрав "пользователи", либо просто указав ID нужных пользователей.

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

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

Крайний срок: дата крайнего срока по задаче. По данной дате система считает её просрочку. Если данное поле не будет указано, то задача не будет никогда просрочена и не попадёт в негативную статистику по работе менеджера.  В данном пункте устанавливается дата крайнего срока по задаче, и в соседнем поле выбор формата даты.

Описание задачи: в данное поле заносится что необходимо сделать в рамках данной задачи. Указывайте всегда подробное описание, которое позволит Вашим коллегам понять что от них хотят.

Важность: данное поле позволяет установить приоритетность задачи. Задачи, которые отмечены как Важные отмечаются на экране специальным маркером (огонёк). Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

Задача в проекте (группе): в этом поле можно сделать привязку задачи к конкретной группе (проекту). Это нужно, чтобы удобнее было разделять задачи по конкретным проектам в отчетах. В данном пункте указывается ID задачи, группы.

Разрешить ответственному менять крайний срок: эта опция позволяет давать разрешение ответственному за задачу передвигать сроки её выполнения. Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

Включить учет времени по задаче: данная опция позволит включить в задаче функцию замера времени. После нажатия кнопки "Начать учет моего времени", включится счетчик по задаче. Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

Принять работу после завершения задачи: включение данной опции потребует от постановщика задачи (после нажатия ответственным кнопки "Завершить") принять задачу ознакомившись с ней. Такие задачи отображаются в разделе "Поручил" с пометкой "Ожидает контроля". Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

Включить задачу в отчет по эффективности: добавляет задачу с данной отметкой в отчет по эффективности менеджера. Следует тщательно подходить к установке данной опции, т.к. не занеся все задачи в отчет, Вы не получите грамотной статистики. Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

Привязать задачу к текущей сущности (CRM): данная опция позволяет привязывать к задаче сущность  из которой она запускается бизнес-процессов.
В данном пункте выбирается тип сущности, привязывающийся к задаче (Лид, Контакт, Компания, Сделка).

Привязать задачу к нескольким сущностям:  позволяет привязать задачу нескольким CRM сущностям.
Указывается тип сущности_ID сущности.

Обозначения сущностей CRM: 
L_ - Лид
D_ - Сделка
C_ - Контакт
CO_ - Компания
SI_ - Счёт
Q_ - Предложение
Символьный код СП из поля ниже_ID элемента СП - Смарт-процесс
Пример заполнения поля: T84_1234. 

Коды смарт-процессов: позволяет посмотреть и выбрать значение символьного кода для СП.
Для каждого СП этот код уникален.
Теги: идентификаторы для уточнения категории, описания, поиска данных и задания внутренней структуры. Вы можете промаркировать определённые задачи тегами, чтобы было удобнее их отбирать в поиске.  В данном поле указываются теги - слова или словосочетания, по которой можно быстро найти задачи.

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

Идентификатор родительской задачи: в данном поле вы можете указать id задачи, являющейся родительской для той задачи, которая создаётся. Это позволит Вам сделать вложенные задачи.

Плановые трудозатраты (в секундах):

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

Время указывается в секундах, т.е если вы хотите указать 24ч, 3ч, 5м, то вам необходимо перевести их в секунды. 

Планируемая длительность в часах или днях: эта опция позволяет автоматически рассчитывать сроки, отведенные на выполнение задачи. Например, если Вы укажите 1 час, то при установке в поле “дата начала задачи” 01.01.2017 10:00, поле “дата завершения задачи” автоматически заполнится значением 01.01.2017 11:00.
Значение указывается в числовом эквиваленте(5,10,15), единицы измерения указываются в следующем пункте.

Тип единицы измерения в планируемой длительности: данная опция позволит определить в каких единицах рассчитывать даты выполнения задач (днях, часах или минутах).
Значение указывается так: days, hours или minutes.

Идентификатор задачи для зависимости: в данном пункте указывается ID задачи, которая будет привязана к создаваемой задаче.

При необходимости привязки более одной задачи, нужно заполнять данное поле по следующим правилам:
Поле заполняется следующим образом: id Задачи#индикатор типа зависимости.
Пример: 123456#1.

Несколько задач между собой делятся запятой:
Пример: 123456#1, 985#2, 737#1

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

Индекс типа зависимости	Наименование зависимости
1	Когда начнется указанная (до решетки) - начнется эта (редактируемая задача)
2	Когда начнется указанная (до решетки)   - закончится эта (редактируемая задача)
3	Когда закончится указанная (до решетки) - начнется эта (редактируемая задача)
4	Когда закончится указанная (до решетки) - закончится эта (редактируемая задача)
11	Когда начнется эта (редактируемая задача) - начнется указанная   (до решетки)
12	Когда начнется эта (редактируемая задача) - закончится указанная (до решетки)
13	Когда закончится эта(редактируемая задача) -  начнется указанная (до решетки)
14	Когда закончится эта(редактируемая задача) -  закончится указанная (до решетки)

Пример использования: 123456#2
Это значит, что для задачи с ID 123456 установить зависимость "Когда начнется указанная - закончится эта" 

Прикрепить файл к задаче: в данном поле указывается ID файла с диска Б24, по которой можно беспрепятственно скачать этот файл, при условии, что он общедоступен.

Идентификатор сайта: по умолчанию в это поле записывается идентификатор сайта, на котором создается задача.

Крайний срок должен всегда устанавливаться в рабочее время: данная опция позволит автоматически увеличить сроки  выполнения задачи в рамках рабочих дней. Например, если Вы установите крайний срок на воскресенье, то крайний срок перенесётся на ближайший понедельник.
Второе поле в данном пункте не функционально.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Изменение задачи

Данное активити (робот) позволяет при знании ID задачи указать нужные поля для изменения.

Название поля	Описание и примеры использования
ID задачи	В данном пункте указывается ID задачи, которую необходимо изменить. Это обязательный параметр. Пример: {=Variable:TASK_ID} или 123456.
Название задачи	Поле позволяет указать название, которое задача получит при запуске активити "Изменение задачи". Рекомендуем использовать модель именования задач по типу - Задача №1, Задача №2 и т.д. Так Вы сможете избежать многих проблем при проектировании и использовании в дальнейшем. Пример: {=Variable:TASK_TITLE} или "Задача №{=Document:ID}".
Описание задачи	В этом поле указывается что необходимо сделать в рамках данной задачи. Рекомендуем заполнять описание максимально подробно, для облегчения понимания задачи вашими коллегами. Пример: {=Variable:TASK_DESCRIPTION}.
Дата начала	Дата начала задачи. В поле указывается дата начала задачи, и есть возможность выбора формата даты. Пример: {=Variable:START_DATE} или {{=dateadd({=System:Now}, "1d")}}.
Дата завершения	Дата окончания задачи. В поле указывается дата завершения задачи и есть возможность выбора формата даты. Пример: {=Variable:END_DATE} или {{=dateadd({=System:Now}, "7d")}}.
Крайний срок	Крайний срок задачи. В поле указывается дата и время крайнего срока по задаче. ВАЖНО!  Изменение данной даты ведёт к смещению сроков зависимых задач на диаграмме Ганта. Пример: {=Variable:DEADLINE} или {{=dateadd({=System:Now}, "5d")}}.
Приоритет	Данное поле позволяет установить приоритетность задачи. Задачи, которые отмечены как Важные отмечаются на экране специальным маркером (огонёк). Примеры значений: 1 (обычная), 2 (важная).
Идентификатор ответственного	Указывается ID сотрудника, который должен выполнить задачу и отчитаться о проделанной работе. Можно указывать в форматах: {=Document:ASSIGNED_BY_ID}, [1] или user_1. Пример: {=Document:ASSIGNED_BY_ID}.
Идентификатор постановщика	Указывается ID сотрудника, который будет принимать задачу в случае, если она требует этого. Можно указывать в форматах: {=User:ID}, [1] или user_1. ВАЖНО!  Постановщик будет получать уведомления по каждому изменению задачи, поэтому подумайте внимательно кого нужно устанавливать в это поле. Пример: {=User:ID}.
Соисполнители (идентификаторы пользователей)	Указывается ID сотрудников, которые тоже участвуют в рабочем процессе, но важно понимать, что они не будут участвовать в последующих отчетах, однако будут получать уведомления об изменениях в задаче. Можно указывать в форматах: {=Variable:ACCOMPLICES}, [1] или user_1. Можно указать несколько ID через запятую или использовать массив. Пример: {=Variable:ACCOMPLICES}.
Наблюдатели (идентификаторы пользователей)	Указывается ID сотрудников, которые тоже участвуют в рабочем процессе просто наблюдая за изменениями в задаче, а так же получать уведомления об изменениях. Можно указывать в форматах: {=Variable:AUDITORS}, [1] или user_1. Можно указать несколько ID через запятую или использовать массив. Пример: {=Variable:AUDITORS}.
Теги	В данном поле указываются теги задач, по которым их в дальнейшем можно будет найти. Маркировка определенных задач тегами нужна для более удобной фильтрации и поиска задач. Теги, это идентификаторы для уточнения категории, описания, поиска данных и задания внутренней структуры. Пример: {=Variable:TAGS} или можно указать несколько тегов как массив.
Флаг "Разрешить ответственному менять крайний срок"	Эта опция позволяет давать разрешение ответственному за задачу передвигать сроки её выполнения. Варианты: да/нет.
Флаг "Привязать к текущей сущности CRM"	Привязка задачи к сущности из которой запускается бизнес-процесс. Варианты: да/нет. При установке в "да" задача будет автоматически привязана к текущей сущности (сделке, лиду, контакту, компании).
Привязать задачу к нескольким сущностям	Позволяет привязать задачу нескольким CRM сущностям. Указывается тип сущности_ID сущности. Обозначения сущностей CRM: L_ - Лид D_ - Сделка C_ - Контакт CO_ - Компания SI_ - Счёт Q_ - Предложение Символьный код СП из поля ниже_ID элемента СП - Смарт-процесс Пример заполнения поля: L_123, D_456, C_789 или T84_1234. Можно указать несколько сущностей через запятую или использовать массив. Пример: {=Variable:CRM_ENTITIES}.
Коды смарт-процессов	Позволяет посмотреть и выбрать значение символьного кода для СП. Для каждого СП этот код уникален. Если вы добавляете новый СП, то активити нужно переустановить, т.к значения в поле обновляются не динамически.
Флаг "Принять работу после завершения задачи"	Включение данной опции потребует от постановщика задачи (после нажатия ответственным кнопки "Завершить") принять задачу ознакомившись с ней. Такие задачи отображаются в разделе "Поручил" с пометкой "Ожидает контроля". Варианты: да/нет.
Идентификатор родительской задачи	Позволяет указать id задачи, которая является родительской для той, что создаётся. Эта опция нужна для создания вложенных задач. Пример: {=Variable:PARENT_TASK_ID}.
Идентификатор рабочей группы	Позволяет сделать привязку задачи к конкретной группе (проекту). Это нужно, чтобы удобнее было разделять задачи по конкретным проектам в отчетах. В данном пункте указывается ID группы. Пример: {=Variable:GROUP_ID}.
Плановые трудозатраты (в секундах)	В этом поле вы можете указать запланированное время на выполнение задачи ответственным. Это необходимо, чтобы замерять план и факт по затратам часов. Время указывается в секундах, т.е если вы хотите указать 24ч, 3ч, 5м, то вам необходимо перевести их в секунды. Пример: для 2 часов нужно указать 7200 (2*60*60).
Флаг включения учета затраченного времени по задаче	Включение учета времени по задаче. Варианты: да/нет.
Флаг включения задачи в отчет по эффективности	Включение задачи в отчет по эффективности. Варианты: да/нет.
Идентификатор задачи для зависимости	В данном пункте указывается ID задачи, которая будет привязана к редактируемой задаче. При необходимости привязки более одной задачи, нужно заполнять данное поле по следующим правилам: Поле заполняется следующим образом: id Задачи#индикатор типа зависимости. Пример: 123456#1. Несколько задач между собой делятся запятой: Пример: 123456#1, 985#2, 737#1 Типы зависимостей: 1 - Когда начнется указанная (до решетки) - начнется эта (редактируемая задача) 2 - Когда начнется указанная (до решетки) - закончится эта (редактируемая задача) 3 - Когда закончится указанная (до решетки) - начнется эта (редактируемая задача) 4 - Когда закончится указанная (до решетки) - закончится эта (редактируемая задача) 11 - Когда начнется эта (редактируемая задача) - начнется указанная (до решетки) 12 - Когда начнется эта (редактируемая задача) - закончится указанная (до решетки) 13 - Когда закончится эта (редактируемая задача) - начнется указанная (до решетки) 14 - Когда закончится эта (редактируемая задача) - закончится указанная (до решетки) Изменить привязку можно только после того как Вы вручную удалите привязку связей. Потому, что нет метода, который бы позволил автоматически получить данные для удаления связи.
Тип зависимости	Позволяет указать очередность запуска зависимой и редактируемой задачи. Доступные варианты: 1 - Когда начнется указанная - начнется эта 2 - Когда начнется указанная - закончится эта 3 - Когда закончится указанная - начнется эта 4 - Когда закончится указанная - закончится эта 11 - Когда начнется эта - начнется указанная 12 - Когда начнется эта - закончится указанная 13 - Когда закончится эта - начнется указанная 14 - Когда закончится эта - закончится указанная
Прикрепить файл к задаче	В данном поле указывается ID файлов, которые располагаются на облачном диске, которые нужно прикрепить к задаче. Можно указать несколько ID через запятую или использовать массив. Пример: {=Variable:FILE_IDS} или 123, 456, 789.
Идентификатор сайта	По умолчанию в это поле записывается идентификатор сайта, на котором создается задача. Пример: {=Variable:SITE_ID}.
Крайний срок должен всегда устанавливаться в рабочее время	Данная опция позволит автоматически увеличить сроки выполнения задачи в рамках рабочих дней. Например, если Вы установите крайний срок на воскресенье, то крайний срок перенесётся на ближайший понедельник. Варианты: да/нет.
Делать отладочные сообщения в журнал БП	Варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания	Время ожидания ответа от приложения. Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Описание примера	Решение
Перенос крайнего срока задачи на следующий рабочий день	Параметры: ID задачи - {=Variable:TASK_ID}, Крайний срок - {{=workdateadd({=System:Now}, "1d")}}, Крайний срок должен всегда устанавливаться в рабочее время - да.
Изменение ответственного при перераспределении нагрузки	Параметры: ID задачи - {=Variable:TASK_ID}, Идентификатор ответственного - {=Variable:NEW_RESPONSIBLE_ID}, Текст статуса - "Ответственный изменен".
Добавление соисполнителей при расширении команды	Параметры: ID задачи - {=Variable:TASK_ID}, Соисполнители - {=Variable:NEW_ACCOMPLICES}, Текст статуса - "Добавлены соисполнители".
Привязка задачи к нескольким CRM сущностям	Параметры: ID задачи - {=Variable:TASK_ID}, Привязать задачу к нескольким сущностям - "D_{=Document:ID}, L_{=Variable:LEAD_ID}", Текст статуса - "Задача привязана к сущностям".
Создание зависимости между задачами проекта	Параметры: ID задачи - {=Variable:TASK_ID}, Идентификатор задачи для зависимости - "{=Variable:PARENT_TASK_ID}#3" (когда закончится родительская - начнется эта), Текст статуса - "Зависимость установлена".
Изменение приоритета задачи на "Важную" при критической ситуации	Параметры: ID задачи - {=Variable:TASK_ID}, Приоритет - 2, Название задачи - "СРОЧНО: {=Variable:ORIGINAL_TITLE}", Текст статуса - "Приоритет повышен".
Прикрепление отчетного файла к задаче	Параметры: ID задачи - {=Variable:TASK_ID}, Прикрепить файл к задаче - {=Variable:REPORT_FILE_ID}, Текст статуса - "Файл прикреплен".
Обновление плановых дат задачи при изменении графика проекта	Параметры: ID задачи - {=Variable:TASK_ID}, Дата начала - {=Variable:NEW_START_DATE}, Дата завершения - {=Variable:NEW_END_DATE}, Крайний срок - {=Variable:NEW_DEADLINE}, Текст статуса - "Даты обновлены".
Добавление тегов к задаче для фильтрации	Параметры: ID задачи - {=Variable:TASK_ID}, Теги - "проект, {=Document:TITLE}, важное", Текст статуса - "Теги добавлены".
Изменение постановщика задачи при смене руководителя	Параметры: ID задачи - {=Variable:TASK_ID}, Идентификатор постановщика - {=Variable:NEW_MANAGER_ID}, Текст статуса - "Постановщик изменен".
Включение контроля выполнения задачи	Параметры: ID задачи - {=Variable:TASK_ID}, Флаг "Принять работу после завершения задачи" - да, Текст статуса - "Контроль включен".

Завершение задач

Данное активити позволяет автоматически закрывать неактуальные задачи, при условии знания их ID
   Логика активити подразумевает, что если не указаны данные, необходимые для выбора конкретной задачи, то будут закрываться все задачи, которые находятся в статусах 1,2,3,4 (о значениях статусов смотрите в описании активити "Получить текущий статус и мета - статус задачи") в той сущности, где запущен данный бизнес-процесс (Лид, Сделка, Контакт, Компания). 

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

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

Ответственный (условие) - позволяет отобрать все задачи в которых ответственным будет выбранный сотрудник. Выбор происходит из выпадающего списка.

Закрывать все задачи указанной сущности: варианты да/нет.
Данное поле позволяет выбрать, нужно ли автоматически закрыть все задачи для указанной сущности или нет. Т.е если указана сущность, то все ее задачи будут или не будут закрыты.
Так же, если указать да/нет в данном поле, но не указать сущность, то активити выдаст ошибку.

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

ID сущности: в данном поле указывается ID сущности, либо переменная, указывающая на этот ID.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания (Время ожидания ответа от приложения): это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Удаление задачи

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

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Владелец (условие): указывается автор задачи из выпадающего списка.

Статус задачи, ID (условие): в данном поле указывается номер статуса задачи.

Номер   статуса	Расшифровка статуса задачи
1	Новая задача
2	Задача принята ответственным
3	Задача выполняется (пользователь нажал начать выполнение)
4	Условно завершена (пользователь закрыл задачу и ждёт согласования от постановщика)
5	Задача выполнена (пользователь завершил выполнение задачи)
6	Задача отложена (пользователь нажал отложить)
7	Задача отклонена ответственным.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:  в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Поиск задачи (v.2)

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

Название	Описание
ID задачи:	В данном пункте указывается ID задачи, которую Вам необходимо найти.
Название задачи:	В данном пункте указывается название задачи, которую необходимо найти.
Истинный статус задачи:	В данном поле выбирается один из вариантов истинного статуса задачи: новая задача,  принята ответственным, выполняется, условно завершена, выполнена, отложена. При поиске задач, нельзя искать по 2 типам статусов одновременно, это приведет к тому, что активити попросту ничего не найдет. Т.е одновременный поиск с фильтрами "Истинный статус" и "Мета статус" - невозможен.
Мета - статус задачи:	В данном поле устанавливается мета - статус искомой задачи: задача почти просрочена, не просмотренная задача, просроченная задача. При поиске задач, нельзя искать по 2 типам статусов одновременно, это приведет к тому, что активити попросту ничего не найдет. Т.е одновременный поиск с фильтрами "Истинный статус" и "Мета статус" - невозможен.
Дата начала:	В данном пункте указывается дата начала выполнения задачи.
Дата окончания:	В данном пункте указывается дата завершения задачи.
Крайний срок:	В данном пункте указывается дата крайнего срока задачи.
ID задачи	В данном пункте указывается ID задач
Привязать к текущей сущности	В данном пункте указывается привязана ли задача к текущей сущности или нет.
ID ответственного:	В данном пункте указывается ID ответственного.
ID постановщика:	В данном пункте указывается ID постановщика, которую Вам необходимо найти.
ID соисполнителей:	В данном пункте указывается ID соисполнителей, которых Вам нужно найти.
ID наблюдателей:	В данном пункте указывается ID наблюдателей, которых Вам нужно найти.
ID родительской задачи:	В данном пункте указывается ID родительской задачи, которую Вам необходимо найти.
ID рабочей группы:	В данном пункте указывается ID рабочей группы, которую Вам необходимо найти.
Плановые трудозатраты (в секундах):	В данном поле указывается плановые трудозатраты на выполнение задачи в виде времени, указывается значение в секундах.
Планируемая длительность в часах или днях:	В данном пункте указывается планируемая длительность задачи в часах или днях.
ID сайта:	В данном пункте указывается ID сайта, который Вам нужно найти.
Дата и время исполнения только в рабочее время:	В данном пункте указывается дата и время исполнения задачи, только в рабочее время.
Стадия:	В данном пункте указывается стадия, в которой находится задача.
Изменил:	В данном поле указывается ID пользователя, который внес какие-либо изменения в задаче.
Дата изменения:	В данном поле указывается дата последнего изменения в задаче.
Изменил статус:	В данном поле указывается ID сотрудника, изменившего статус.
Дата изменения статуса:	В данном поле указывается дата изменения статуса задачи.
Закрыл задачу:	В данном полу указывается ID сотрудника, закрывшего задачу.
Затраченное время из истории изменений:	В данном поле указывается затраченное время из истории изменений задачи.
Дата последнего просмотра:	В данном поле указывается дата последнего просмотра искомой задачи.
Индекс сортировки:	В данном поле указывается индекс сортировки задачи в виде цифры. Данный индекс можно найти в параметрах задачи.
Затрачено (фактически):	В данном поле указывается время, фактически затраченное на выполнение задачи.

Номер  статуса	Расшифровка статуса задачи
1	Новая задача
2	Задача принята ответственным
3	Задача выполняется (пользователь нажал начать выполнение)
4	Условно завершена (пользователь закрыл задачу и ждёт согласования от постановщика)
5	Задача выполнена (пользователь завершил выполнение задачи)
6	Задача отложена (пользователь нажал отложить)
7	Задача отклонена ответственным.

Номер   статуса	Расшифровка мета - статуса задачи
-1	Просроченная задача
-2	Непросмотренная задача
-3	Почти просрочена (осталось менее 24х часов до даты крайнего срока)

Поиск по привязке к сущностям CRM: в поле указывается CRM сущность, к которой привязана искомая задача или задачи.
Поле заполняется в определенном формате.
Пример: L_12345
L_ - обозначение лида.
12345 - ID этого лида.

Обозначения сущностей CRM:
L_ - Лид
D_ - Сделка
C_ - Контакт
CO_ - Компания
SI_ - Счёт
Q_ - Предложение
Символьный код СП из поля ниже_ID элемента СП - Смарт-процесс
Пример заполнения поля: T84_1234. 

Коды смарт-процессов: позволяет посмотреть и выбрать значение символьного кода для СП.
Для каждого СП этот код уникален.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получить статус и мета-статус задачи

Данное активити позволяет получить статус задачи для того, чтобы понять что с ней происходит. Исходя из нашей логики, получив статус, можно далее реагировать как необходимо. Результатом работы данного активити будет число, которое обозначает конкретный статус задачи.
Результат работы активити можно вывести в ленту с помощью активити "Cоздание сообщения в ленту сущностей CRM"

Номер  статуса	Расшифровка статуса задачи
1	Новая задача
2	Задача принята ответственным
3	Задача выполняется (пользователь нажал начать выполнение)
4	Условно завершена (пользователь закрыл задачу и ждёт согласования от постановщика)
5	Задача выполнена (пользователь завершил выполнение задачи)
6	Задача отложена (пользователь нажал отложить)
7	Задача отклонена ответственным.

Номер   статуса	Расшифровка мета - статуса задачи
-1	Просроченная задача
-2	Непросмотренная задача
-3	Почти просрочена (осталось менее 24х часов до даты крайнего срока)

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.   

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, Вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Перенос затраченного времени в задаче

Данное активити позволяет переносить информацию о затраченном времени из одной задачи в другую.
Перенос осуществляется путем указания ID-задачи из которой нужно перенести время и ID-задачи в которую необходимо перенести время.

Взять ID гл. задачи из родительской задачи: варианты "да" или "нет". Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.
Данный пункт используется, когда у Вас связаны между собой 2 задачи, одна из этих задач "родительская" (главная), вторая "дочерняя". Сам процесс запускается из "дочерней" задачи, но при этом видит ID "родительской" (главной) задачи.

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

ID главной задачи: указывается ID главной задачи.

ID задачи из которой будет взято затраченное время: указывается ID задачи из которой будут взяты данные о затраченном времени.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Получить все данные по задаче

Данное активити позволяет получить итоги активити из дополнительных результатов выбранной задачи.

Сценарий работы бизнес-процесса

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:

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

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов.
Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, Вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Слежение за изменением в задаче

Данное активити позволяет отслеживать изменения в указанной Вами задаче.

ID задачи (условие):  в данном поле указывается ID задачи, за изменениями в которой требуется вести наблюдение.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Слежение за статусом задачи

Данное активити позволяет отслеживать статус в указанной Вами задаче.

ID задачи (условие): в данном поле указывается ID задачи, за статусом которой требуется вести наблюдение.

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Чек-лист

Проверка чек-листа к задаче

Данное активити проверяет чек-лист в задаче, ID которого Вы указали, и возвращает в БП значение «ложь» или «правда», что означает статус «не выполнено» или «выполнено»

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Сценарий работы робота

Информация о чек-листе в задаче

Активити предоставляет информацию о чек-листа в задаче, ID которой Вы указали.

ID задачи (условие): указывается идентификатор задачи из которой необходимо получить данные чек-листа.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Добавить чек-лист к задаче

Данное активити позволяет добавить пункты чек-листа в задачи, соответствующие указанному ID.

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Пункт чек-листа - в данном поле пишется важный момент, который должен выполнить ответственный за выполнение задачи. 

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Удаление пункта чек-листа в задаче

Активити позволяет удалить пункты чек-листа из указанной задачи.

ID задачи (условие): указывается идентификатор задачи из которой необходимо удалить пункты чек-листа.

ID пункта чек-листа: указывается идентификатор удаляемого пункта чек-листа.
Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Изменение пункта чек-листа в задаче

Активити позволяет изменить пункты чек-листов указанной задачи.

ID задачи: указывается ID задачи, в которой нужно изменить пункт чек-листа.

ID пункта чек-листа: указывается идентификатор пункта чек-листа.
ID родительского пункта чек-листа: идентификатор чек-листа к которому привязан изменяемый пункт чек-листа.

Текст пункта чек-листа: указывается содержание пункта чек-листа.

Признак выполнения пункта чек-листа: варианты да/нет.
Позволяет указать, выполнен или нет пункт чек-листа.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Комментарии в задачах

Создать комментарии в задаче

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


ID задачи:  в этом поле указывается идентификатор задачи, в которой будет создан комментарий.

ID пользователя: в этом поле указывается идентификатор пользователя от имени которого будет создан комментарий.

Текст сообщения: в этом поле указывается текст комментария.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Изменить комментарий к задаче

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


ID задачи:  в этом поле указывается идентификатор задачи, в которой находится комментарий.

ID комментария:  в этом поле указывается идентификатор комментария.
Идентификатор комментария можно получить с помощью активити "Создать комментарий" (если вы его создавали этим активити).

ID пользователя: в этом поле указывается идентификатор пользователя от имени которого был создан комментарий.

Текст сообщения: в этом поле указывается текст комментария.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получить данные по комментарию в задаче

Активити позволяет получить данные о комментарии в задаче.


ID комментария:  в этом поле нужно указать идентификатор комментария, данные о котором вы хотите получить.

ID задачи:  в этом поле указывается идентификатор задачи, в которой находится комментарий.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Перенос комментариев в другую задачу

Данное активити позволяет переносить комментарии из одной задачи в другую. Это можно сделать задав ID задачи из которой будет произведен перенос и ID задачи в которую будет осуществлен перенос комментариев.

Сценарий работы активити бизнес-процесса

Взять ID гл. задачи из родительской задачи: варианты: да/нет. Позволяет получить автоматически ID главной задачи из подзадач для пункта "ID главной задачи".

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

ID задачи из которой будут взяты комментарии: в данном поле указывается ID задачи из которой будут взяты комментарии.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск комментариев в задаче

Активити позволяет получить id комментариев в указанной задаче.


ID задачи: в этом поле указывается идентификатор задачи, в которой будет производиться поиск комментариев.

ID пользователя: в этом поле указывается идентификатор пользователя, по которому будет произведен поиск комментариев в задаче.

Имя пользователя: в этом поле указывается имя пользователя, по которому будет произведен поиск комментариев в задаче.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Особенно это важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Интеграции

SENLER - Удаление из группы подписки VK сообщества

Данное активити позволяет удалить подписчика из группы подписки VK сообщества.
Senler, это сервис, который позволяет отправлять рассылки через социальную сеть VK, и наше активити работает только с уже импортированными из базы подписчиками. 

Ключ из Callback API: в данное поле вставляется специальный секретный ключ.
Для получения ключа перейдите в следующие пункты меню настроек в личном кабинете Senler: Настройки -> Подключение ->  Ручная настройка (в п. Подключение) -> Секретный ключ. 
Скопируйте ключ (для того, чтобы это сделать, нужно сделать ключ видимым с помощью иконки "Показать ключ" в конце строки с ключем). 

Тип сущности: в этом поле указывается тип сущности с которой будет происходить работа активити.

ID сущности: в этом поле указывается ID сущности, с которой будет происходить работа.

Идентификатор пользователя ВКонтакте: в данном поле указывается ID пользователя в VK, в формате id12345678. 
Если ID не указан, то он будет сам подгружаться из сущности.

Числовой идентификатор сообщества ВКонтакте: в данном поле указывается ID группы в VK. 
ID группы можно получить несколькими способами:
1. Скопировать ID группы из адресной строки браузера.
2. В личном кабинете senler, во  вкладке  "Мои сообщества", есть список сообществ, под каждым из сообществ есть перечень данных об этом сообществе, среди этих данных есть ID этого сообщества.
Пример: @club123456789, где 123456789 -  ID сообщества.
3. Если ID сообщества буквенный, а для активити нужно только числовой вариант, то нужно воспользоваться специальным сервисом по получению ID сообщества, таких сервисов довольно много, и их довольно легко найти воспользовавшись поиском в google.
Идентификатор группы подписчиков (0 - без группы): в данном поле указывается ID группы подписчиков (цифрами, без доп знаков)
Сам идентификатор выглядит так:#123456. 
Для его получения личном кабинете Senler нужно: 
1. Выбрать интересующую Вас группу в VK.
2. Перейти во вкладку "Группы подписчиков".
3. Найти нужную группу подписчиков и в правом верхнем углу этой группы будет указан ID этой группы в формате #123456 

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

SENLER - Добавление в группу подписки VK сообщества

Данное активити позволяет добавить подписчика VK в базу данных сервиса Senler.
Senler, это сервис, который позволяет отправлять рассылки через социальную сеть VK, и наше активити работает только с уже импортированными из базы подписчиками. 

Ключ из Callback API: в данное поле вставляется специальный секретный ключ.
Для получения ключа перейдите в следующие пункты меню настроек в личном кабинете Senler: Настройки -> Подключение ->  Ручная настройка (в п. Подключение) -> Секретный ключ. 
Скопируйте ключ (для того, чтобы это сделать, нужно сделать ключ видимым с помощью иконки "Показать ключ" в конце строки с ключем). 

Тип сущности: в этом поле указывается тип сущности с которой будет происходить работа активити.

ID сущности: в этом поле указывается ID сущности, с которой будет происходить работа.

Идентификатор пользователя ВКонтакте: в данном поле указывается ID пользователя в VK (id12345678), в формате 12345678. 
Если ID не указан, то он будет сам подгружаться из сущности.

Числовой идентификатор сообщества ВКонтакте: в данном поле указывается ID группы в VK. 
ID группы можно получить несколькими способами:
1. Скопировать ID группы из адресной строки браузера.
2. В личном кабинете senler, во  вкладке  "Мои сообщества", есть список сообществ, под каждым из сообществ есть перечень данных об этом сообществе, среди этих данных есть ID этого сообщества.
Пример: @club123456789, где 123456789 -  ID сообщества.
3. Если ID сообщества буквенный, а для активити нужно только числовой вариант, то нужно воспользоваться специальным сервисом по получению ID сообщества, таких сервисов довольно много, и их довольно легко найти воспользовавшись поиском в google.
Идентификатор группы подписчиков (0 - без группы): в данном поле указывается ID группы подписчиков (цифрами, без доп знаков)
Сам идентификатор выглядит так:#123456. 
Для его получения личном кабинете Senler нужно: 
1. Выбрать интересующую Вас группу в VK.
2. Перейти во вкладку "Группы подписчиков".
3. Найти нужную группу подписчиков и в правом верхнем углу этой группы будет указан ID этой группы в формате #123456 

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается, нужно ли создавать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Комментарии (таймлайн)

Поиск комментариев из таймлайн сущности CRM

Данное активити позволяет получить список всех комментариев для определенной CRM сущности, указав для фильтра параметры этой сущности.
Результатом работы активити, будет получение списка комментариев из определенной CRM сущности в виде массива для итератора, строки, а так же количества найденных элементов (комментариев), которые соответствуют условиям поиска.

ID сущности: в данном поле указывается ID сущности к которой привязаны записи в тайм лайне.

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

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• Смарт-процесс.

Автор:в данном поле указывается автор искомых сообщений, в виде его ID, при этом ID должен быть указан без скобок или каких-либо лишних данных.

Текст комментария: в данном поле указывается текст комментария.

Делать отладочные сообщения в журнале БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

Данное активити позволяет изменить комментарий в тайм лайне сущности.

Сценарий работы активити бизнес-процесса

ID комментария: в данном поле указывается ID изменяемого комментария.
Текст комментария: в данном поле указывается новый текст для изменяемого комментария

ВАЖНО! 
Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

Если вы планируете через интегратор произвести изменение более 1000 сущностей, то нужно встраивать в БП счетчик, и после 1000 изменений делать паузу на 15 минут, если этого не сделать, то это приведет к тормозам в обработке на стороне Б24 и остальные сущности могут не отработаться.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли делать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Список привязок к записи в таймлайне

Данное активити позволяет получить список привязок к записи в тайм лайне.

Сценарий работы активити бизнес-процесса

ID записи в тайм лайне: в данном полу указывается ID записи в тайм лайне CRM сущности.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Установка-снятие привязки коментария с сущности crm

Данное активити позволяет установить или снять привязку комментария с сущности CRM .

Сценарий работы активити бизнес-процесса

Операция с привязкой: в данном полу указывается тип операции привязки: снять привязку или установить привязку.

ID комментария в тайм лайне: в данном поле указывается ID комментария в тайм лайне.

ID сущности: в данном поле указывается ID сущности, к которой привязаны комментарии.

Тип сущности: в данном поле указывается тип сущности, к которой привязан комментарий.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Удаление коментария из таймлайна

Данное активити позволяет удалить комментарий из тайм лайна.

Сценарий работы активити бизнес-процесса

ID комментария: в данном поле указывается ID комментария, который нужно удалить.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Получение данных о коментарии из таймлайн сущности CRM

Данное активити позволяет получить данные о комментарии, прикрепленном к сущности CRM.

Сценарий работы активити бизнес-процесса

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

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Создание комментария в тайм лайн сущности CRM

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

Тип сущности: в данном поле указывается тип сущности к которой будет привязан бизнес-процессу данного дела. Выбирается из выпадающего списка.

Активити работает со следующими типами сущностей:

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• Смарт-процесс.

ID Сущности: в данном пункте указывается ID сущности, которую необходимо изменить.

Заголовок сообщения: в данной графе указывается текстовый заголовок сообщения.

Текст сообщения: в данной графе указывается текст сообщения.
Так же в данном поле можно вывести возвращаемые параметры из предшествующих активити.
Для этого нужно нажать кнопку "...", а далее выбрать пункт "Дополнительные результаты", после чего выбрать результаты, который необходимо вывести.

Добавить видео в сообщение: в данном поле необходимо указать код видео Youtube.
Пример:
Ссылка на видео https://www.youtube.com/watch?v=jWlAPx4Z40g, где код этого видео jWlAPx4Z40g .

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

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания(Время ожидания ответа от приложения):
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

 

Получение всех коментариев из таймлайн сущности CRM

Данное активити позволяет поучить список ID всех комментариев выбранной CRM сущности.

Сценарий работы активити бизнес-процесса

ID сущности: в данном поле указывается ID сущности, к которой привязан комментарий.

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

• Лид;
• Сделка;
• Контакт;
• Компания;
• Счет;
• Предложение;
• Смарт-процесс.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Компании

Изменение компании

Данное активити позволяет менять значение полей в сущности компания, при условии знания ее ID.

ID компании:	В данном пункте указывается ID компании, данные о которой необходимо изменить. Если поле имеет привязку к элементам инфо блоков (привязка к спискам), то для изменения значения нужно указывать ID элемента.
Очистить почты и(или) телефоны:	Данное поле отвечает за удаление почт или телефонов в указанной сущности, из выпадающего списка можно выбрать что именно будет очищено: почта, телефон, почта и телефон или не нужно очищать вовсе.
Название компании:	В данном пункте указывается название компании.
Тип компании:	В данном поле указывается тип к которому принадлежит компания.
Фактический адрес:	В данном пункте указывается фактический адрес расположения компании.
Адрес (стр. 2):	В данном пункте указывается квартира/офис компании.
Город:	В данном пункте указывается город, в котором находится компания.
Почтовый индекс:	В данном пункте указывается почтовый индекс компании.
Район:	В данном пункте указывается район, в котором находится компания.

Область:	В данном пункте указывается область, в которой находится компания.
Страна:	В данном пункте указывается страна,в которой находится компания.
Код страны:	В данном пункте указывается код страны, в котором находится компания.
Юридический адрес:	В данном пункте указывается юридический адрес, компании, т.е адрес, по которому она зарегистрирована например в налоговой.
Банковские реквизиты:	В данном пункте указываются банковские реквизиты компании.
Сфера деятельности:	В данном поле из выпадающего списка можно выбрать сферу деятельности изменяемой компании.
Валюта:	В данном поле выбирается валюта для расчетов с данной компанией.
Годовой оборот:	В данном пункте указывается годовой оборот компании.
Комментарии:	В данном пункте указывается: Комментарии
Ответственный:	В данном пункте указывается: Идентификатор ответственного
Контакт:	В данном пункте указывается: ID контакта.
Внешний источник:	В данном пункте указывается: Идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Рекламная система:	В данном пункте указывается: Внешний ключ, используется для операций обмена. Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Тип трафика:	В данном пункте указывается: UTM MEDIUM из UTM-метки.
Обозначение рекламной кампании:	В данном пункте указывается: UTM CAMPAIGN из UTM-метки.
Содержание кампании:	В данном пункте указывается: UTM CONTENT из UTM-метки.
Условие поиска кампании:	В данном пункте указывается: UTM TERM из UTM-метки.
Телефон:	В данном поле указывается телефон, указанный в аналогичном пункте контактных данных компании.
E-MAIL	В данном пункте указывается E-mail, указанный в аналогичном поле контактных данных компании
Сайт:	В данном полу указывается короткая ссылка на страницу в одной из социальных сетей, выбранных в соседнем поле.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

  

Получение данных по сущности: Компания

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

Сценарий работы активити бизнес-процесса

ID сущности: в данном поле указывается ID сущности компании, данные которой требуется получить.

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

Сообщение об ошибке:да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания(Время ожидания ответа от приложения):
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.  

Поиск Компаний (v.2)

Данное активити позволяет искать "Компанию" или "Компании" по выбранным в настройках полям.
Результатом работы является получение списка ID компаний в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сообщение об ошибке:	В данном поле указывается, будет ли выводится сообщение об ошибке или нет.
ID:	В данном пункте указывается ID компании.
Название компании:	В данном пункте указывается название компании.
Фактический адрес:	В данном пункте указывается фактический адрес расположения компании.
Адрес (стр. 2):	В данном пункте указывается квартира/офис компании.
Город:	В данном пункте указывается город, в котором находится компания.
Почтовый индекс:	В данном пункте указывается почтовый индекс компании.
Район:	В данном пункте указывается район, в котором находится компания.
Область:	В данном пункте указывается область, в которой находится компания.
Страна:	В данном пункте указывается страна, в которой находится компания.
Код страны:	В данном пункте указывается код страны, в котором находится компания.
Юридический адрес:	В данном пункте указывается юридический адрес, компании, т.е адрес, по которому она зарегистрирована например в налоговой.
Юридический адрес (стр. 2):	В данном пункте указывается офис/квартира и.т.п. , по которому компания зарегистрирована юридически.
Юридический адрес город:	В данном пункте указывается город, где компания зарегистрирована юридически.
Юридический адрес почтовый индекс:	В данном пункте указывается юридический почтовый индекс.
Юридический адрес район:	В данном пункте указывается район, где компания юридически зарегистрирована.
Юридический адрес область:	В данном пункте указывается область, где компания юридически зарегистрирована.
Юридический адрес страна:	В данном пункте указывается страна, где компания зарегистрирована юридически.
Юридический адрес код страны:	В данном пункте указывается юридический код страны.
Банковские реквизиты:	В данном пункте указываются банковские реквизиты компании.
Годовой оборот:	В данном пункте указывается годовой оборот компании.
Комментарий:	В данном пункте указывается комментарий, прикрепленный к сущности "Компания"
Дата создания:	В данном пункте указывается дата создания компании.
Дата изменения:	В данном пункте указывается дата последнего изменения данных о компании.
Внешний источник:	В данном пункте указывается: Идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Идентификатор элемента во внешнем источнике:	В данном пункте указывается: Внешний ключ, используется для операций обмена. Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Версия оригинала:	В данном пункте указывается: версия внешнего ключа, используемого для операций обмена.
Рекламная система:	В данном пункте указывается: UTM SOURSE из UTM-метки.
Тип трафика:	В данном пункте указывается: UTM MEDIUM из UTM-метки.
Обозначение рекламной кампании:	В данном пункте указывается: UTM CAMPAIGN из UTM-метки.
Содержание кампании:	В данном пункте указывается: UTM CONTENT из UTM-метки.
Условие поиска кампании:	В данном пункте указывается: UTM TERM из UTM-метки.
Телефон:	В данном поле указывается телефон, указанный в аналогичном пункте контактных данных компании.
E-MAIL:	В данном пункте указывается E-mail, указанный в аналогичном поле контактных данных компании
Сайт:	В данном поле можно добавить разные адреса сайтов компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
Мессенджер:	В данном пункте указывается данные мессенджера или любые web-адреса

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

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

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Умный поиск компаний по реквизитам

Данное активити позволяет получить список ID компаний у которых заполнены или не заполнены реквизиты.

Заполнены реквизиты: в данном поле указывается заполнены реквизиты или нет.

ИНН, КПП, ОГРН, ОГРНИП, КБЕ, ИИН: в данных полях указываются реквизиты, по которым будет осуществлен поиск компании.
Для поиска любого значения, укажите в поле "##"

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов.
Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания.
Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Поиск Компаний с реквизитами и без них

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

Заполнены реквизиты у компании: в данном поле указывается заполнены реквизиты компании или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск Компании по ИНН КПП

Данное активити позволяет получить список ID компании по ИНН КПП.
Результатом работы является получение списка ID компаний в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

ИНН:  в данном поле указываются реквизиты компаний, которые нужно найти.
Для поиска любого значения ИНН введите "##", если же нужна компания с конкретным ИНН, то нужно указать ИНН этой компании.
Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск компаний по адресу

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

Тип адреса: в данном поле указывается тип адреса, который указан в сущности компания: фактический адрес, адрес регистрации, юр. Адрес, адрес бенефициара.
Улица, дом, корпус, строение: в данном поле указывается адрес дома, корпуса, строения, указанный в адресных данных компании.

Квартира / офис: в данном поле указывается квартира или офис, которые указанны в адресных данных компании.

Город: в данном поле указывается город, в котором расположена компания.

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

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

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

Страна: в данном поле указывается страна, в котором расположена и зарегистрирована компания.

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


Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Удаление компании

Данное активити позволяет удалить сущность "Компания", указав её ID.

ID компании: в данном поле нужно указать ID удаляемой компании.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Контакты

Изменение Контакта

Данное активити позволяет изменять контакт и данные в нем, если известен ID контакта, который необходимо изменить.

Сценарий работы активити бизнес-процесса

Название	Описание
ID Контакта	В данном поле необходимо указать ID Контакта, которого мы будем редактировать. Если поле имеет привязку к элементам инфо блоков (привязка к спискам), то для изменения значения нужно указывать ID элемента.
Очистить почты и(или) телефоны:	Данное поле отвечает за удаление почт или телефонов в указанной сущности, из выпадающего списка можно выбрать что именно будет очищено: почта, телефон, почта и телефон или не нужно очищать вовсе.
Обращение:	Обращение к клиенту (мистер, товарищ, госпожа и т.д.)
Имя:	В данном поле можно указать новое значение имени Контакта.
Фамилия:	В данном поле можно указать новое значение фамилии Контакта.
Отчество:	В данном поле можно указать новое значение отчества Контакта.
Дата рождения:	В данном поле можно указать новое значение даты рождения Контакта.
Тип контакта:	В данном поле можно изменить тип контакта. Значения берутся из одноимённого справочника CRM.
Источник:	В данном поле можно изменить источник контакта. Значения берутся из одноимённого справочника CRM.
Описание:	В данном пункте указывается тип источника из которого лид попал в CRM.
Должность:	В данном поле можно изменить должность Контакта.
Адрес:	В данном поле можно изменить фактический адрес Контакта (устаревшее поле, сейчас используются реквизиты).
Адрес_2 (квартира\офис фактического адреса)	В данном поле можно изменить адрес квартиры или офиса Контакта(устаревшее поле, сейчас используются реквизиты).

Город:	В данном поле можно изменить город расположения Контакта (устаревшее поле, сейчас используются реквизиты).
Почтовый индекс:	В данном поле можно изменить почтовый индекс Контакта (устаревшее поле, сейчас используются реквизиты).
Район:	В данном поле можно изменить район Контакта (устаревшее поле, сейчас используются реквизиты).
Область:	В данном поле можно изменить область Контакта (устаревшее поле, сейчас используются реквизиты).
Страна:	В данном поле можно изменить страну Контакта (устаревшее поле, сейчас используются реквизиты).
Код страны:	В данном поле можно код страны Контакта (устаревшее поле, сейчас используются реквизиты).
Комментарий:	В данном поле можно изменить комментарий компании.
Доступен для всех:	Варианты да/нет. Данное поле отвечает доступен ли данный контакт для всех сотрудников или только для некоторых.
Ответственный:	В данном поле можно изменить ответственного за компанию. Следует помнить, что поле должно принимать формат
Компания:	В данном поле можно изменить компанию, которая относятся к данному контакту.
Компании:	В данном поле можно изменить компании (сразу несколько), которые относятся к данной компании. Это требуется, когда один контакт может быть привязан сразу к множеству компаний.
Внешний источник:	Назначение поля может меняться конечным разработчиком. Это служебное поле, которое не следует трогать.
Идентификатор элемента во внешнем источнике:	Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком. Этот идентификатор используется при обмене компаниями со внешними системами, например 1С для того, чтобы сопоставить компанию в разных системах.
Версия оригинала:	В данном поле можно указать версию для внешнего обмена.
Привязка к лицам из модуля faceid:	В данном поле можно изменить идентификатор, который присваивается каждому контакту в случае использования системы фейс-id.
Рекламная система:	В данном поле можно изменить метку источника рекламной кампании.
Тип трафика:	В данном поле указывается метка типа трафика рекламной компании.
Обозначение рекламной кампании:	В данном поле можно изменить метку типа источника рекламной кампании.
Содержание кампании:	В данном поле можно изменить метку дополнительного контейнера рекламной кампании.
Условие поиска кампании:	В данном поле можно изменить метку ключевого слова рекламной кампании.
Телефон:	В данном поле можно добавить разные номера телефонов. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
EMAIL:	В данном поле можно добавить разные адреса электронной почты. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
Сайт:	В данном поле можно добавить разные адреса сайтов компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
Мессенджеры:	В данном поле можно добавить разные адреса интернет

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск Контакта (v.2)

Данное активити позволяет искать "Контакт" или "Контакты" по выбранным в настройках полям.
Результатом работы является получение списка ID контактов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сообщение об ошибке:	В данном поле указывается, будет ли выводится сообщение об ошибке или нет.
ID:	В данном пункте указывается ID компании.
Имя:	В данном пункте указывается имя искомого контакта
Отчество:	В данном пункте указывается отчество искомого контакта
Фамилия:	В данном пункте указывается фамилия искомого контакта
Описание:	В данном пункте указывается имя искомого контакта
Должность:	В данном пункте указывается тип источника из которого лид попал в CRM.
Адрес:	В данном поле можно указать фактический адрес Контакта (устаревшее поле, сейчас используются реквизиты).
Адрес (стр. 2):	В данном поле можно указать адрес квартиры или офиса Контакта(устаревшее поле, сейчас используются реквизиты).
Город:	В данном поле можно изменить город расположения Контакта (устаревшее поле, сейчас используются реквизиты).
Почтовый индекс:	В данном поле можно указать почтовый индекс Контакта (устаревшее поле, сейчас используются реквизиты).
Район:	В данном поле можно указать район Контакта.
Область:	В данном поле можно указать область Контакта.
Страна:	В данном поле можно страну область Контакта.
Код страны:	В данном поле можно указать код страны Контакта.
Комментарий:	В данном поле можно указать комментарии к контакту.
Дата создания:	В данном поле можно указать дату создания Контакта.
Дата изменения:	В данном поле можно указать дату последнего изменения сущности "Контакт".
Внешний источник:	В данном пункте указывается: Идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Идентификатор элемента внешнего источника:	В данном пункте указывается: Внешний ключ, используется для операций обмена. Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Версия оригинала:	В данном пункте указывается: версия внешнего ключа, используемого для операций обмена.
Рекламная система:	В данном пункте указывается: UTM SOURSE из UTM-метки.
Тип трафика:	В данном пункте указывается: UTM MEDIUM из UTM-метки.
Обозначение рекламной кампании:	В данном пункте указывается: UTM CAMPAIGN из UTM-метки.
Содержание кампании:	В данном пункте указывается: UTM CONTENT из UTM-метки.
Условие поиска кампании:	В данном пункте указывается: UTM TERM из UTM-метки.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Получение данных по сущности: Контакт

Данное активити позволяет получить все данные сущности "контакт", ID которой будет указан в настройках.

ID сущности: в данном поле указывается ID сущности "контакт", данные которой необходимо получить.

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

Сообщение об ошибке:да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Поиск Контактов по ИНН КПП

Данное активити позволяет получить список ID контактов по ИНН КПП.
Результатом работы является получение списка ID контактов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

ИНН: в данном поле указываются реквизиты контактов, которые нужно найти.
Для поиска любого значения ИНН введите "##", если же нужен контакт с конкретным ИНН, то нужно указать ИНН этого контакта.


Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск Контактов с реквизитами и без

Данное активити позволяет получить список ID контактов по наличию или отсутствию у них реквизитов.
Результатом работы является получение списка ID контактов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Заполнены реквизиты у контакта: в данном поле указывается заполнены реквизиты контакта или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Поиск контактов по адресу

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

Тип адреса: в данном поле указывается тип адреса реквизитов, который указан в искомом контакте: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.
Улица, дом, корпус, строение: в данном поле указываются адресные данные контакта, такие как улица, дом, корпус, строение, которые указан в адресном реквизите.

Квартира / офис: в данном поле указывается номер квартиры или офиса, который указан в адресном реквизите.

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

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

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

Область: в данном поле указывается область, которая указана в адресном реквизите.

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

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

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Удаление контакта

Данное активити позволяет удалить сущность "Контакт", указав её ID.

ID контакта: в данном поле нужно указать ID удаляемого контакта.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Лиды

Изменение Лида

Данное активити позволяет изменять лид согласно внесенным настройкам.

Название	Описание
ID лида:	В данном поле необходимо указать ID Лида, который Вы будете редактировать. Если поле имеет привязку к элементам инфо блоков (привязка к спискам), то для изменения значения нужно указывать ID элемента.
Очистить почты и(или) телефоны:	Данное поле отвечает за удаление почт или телефонов в указанной сущности, из выпадающего списка можно выбрать что именно будет очищено: почта, телефон, почта и телефон или не нужно очищать вовсе.
Ставка НДС:	В данном поле можно изменить ставку налога в Сделке. Изменение ставки налога в этом поле будет работать только если настроено поле "Способ начисления НДС".
Способ начисления НДС:	В этом поле можно выбрать, как будет начисляться НДС:сверху или уже включен в стоимость.
Тип скидки:	В этом поле выбирается тип скидки, доступно на выбор два варианта: сумма и процент.
Размер скидки:	В этом поле указывается размер предоставляемой скидки.
Название Лида:	В данном поле можно указать новое значение названия Лида.
Обращение:	Обращение к клиенту (мистер, товарищ, госпожа и т.д.)
Имя:	В данном поле можно указать новое значение имени Контакта.
Фамилия:	В данном поле можно указать новое значение фамилии Контакта.
Отчество:	В данном поле можно указать новое значение отчества Контакта.
Дата рождения:	В данном поле можно указать новое значение даты рождения Контакта.
Название компании:	В данном поле можно изменить название компании.
Источник:	В данном поле можно изменить источник Лида. Значения берутся из одноимённого справочника CRM.

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

Название	Описание
Статус:	В данном пункте вводится код статуса, который можно получить из специальной таблицы.
Дополнительно о статусе:	В данном пункте указывается тип источника статуса из которого лид попал в CRM.
Должность:	В данном поле можно изменить должность Контакта.
Адрес:	В данном поле можно изменить фактический адрес Контакта (устаревшее поле, сейчас используются реквизиты).
Адрес (стр. 2):	В данном поле можно изменить адрес квартиры или офиса Контакта (устаревшее поле, сейчас используются реквизиты).
Город:	В данном поле можно изменить город расположения Контакта (устаревшее поле, сейчас используются реквизиты).
Почтовый индекс:	В данном поле можно изменить почтовый индекс Контакта (устаревшее поле, сейчас используются реквизиты).
Район:	В данном поле можно изменить район Контакта (устаревшее поле, сейчас используются реквизиты).
Область:	В данном поле можно изменить область Контакта (устаревшее поле, сейчас используются реквизиты).
Страна:	В данном поле можно изменить страну Контакта (устаревшее поле, сейчас используются реквизиты).
Код страны:	В данном поле можно код страны Контакта (устаревшее поле, сейчас используются реквизиты).
Валюта расчетов:	В данном поле можно изменить валюту расчётов Лида. Значения берутся из одноимённого справочника CRM.
Сумма:	В данном поле можно изменить предполагаемую сумму по Лиду. Данное поле заполняется автоматически из товарного раздела и не следует его менять если у Вас заполнены в Лиде товары с ценами.
Комментарий:	В данном поле можно изменить комментарий компании.
Ответственный:	В данном поле можно изменить ответственного за компанию. Следует помнить, что поле должно принимать формат - user_ID (например user_1).
Компания:	В данном поле нужно указать ID компании.
Контакт:	В данном поле нужно указать ID контакта.
Внешний источник:	Назначение поля может меняться конечным разработчиком. Это служебное поле, которое не следует трогать.
Идентификатор элемента во внешнем источнике:	Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком. Этот идентификатор используется при обмене компаниями со внешними системами, например 1С, для того, чтобы сопоставить компанию в разных системах.
Телефон:	В данном поле можно добавить разные номера телефонов. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
EMAIL:	В данном поле можно добавить разные адреса электронной почты. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
Сайт:	В данном поле можно добавить разные адреса сайтов компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
Мессенджер:	В данном поле можно добавить разные адреса интернет - мессенджеров компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Получение данных по сущности: Лид

Данное активити позволяет получить все данные из полей лида, ID которого Вы указали в настройках.

ID сущности: в данном пункте указывается ID сущности Лид, которую необходимо изменить.

Для печати: вывод данных в пригодном для печати текстовом виде.

Сообщение об ошибке: да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Создание лида с товарами

Данное активити позволяет создавать лид, к которому перекреплены товарные позиции.

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
TITLE (Название Лида):	В данном поле можно указать значение названия Лида.
HONORIFIC(обращение):	Обращение к клиенту (мистер, товарищ, госпожа и т.д.)
NAME (Имя контакта):	В данном поле можно указать значение имени Контакта.
SECOND_NAME (Фамилия контакта):	В данном поле можно указать значение фамилии Контакта.
LAST_NAME (отчество контакта):	В данном поле можно указать значение отчества Контакта.
BIRTHDATE (Дата рождения):	В данном поле можно указать значение даты рождения Контакта.
COMPANY_TITLE (Название компании):	В данном поле можно указать название компании.
SOURCE_ID (Источник Лида):	В данном поле можно указать источник Лида. Значения берутся из одноимённого справочника CRM.

SOURCE_DESCRIPTION (описание источника):    в данном пункте указывается тип источника из которого лид попал в CRM. 

Название	Описание
STATUS_ID(обозначение статуса):	В данном пункте вводится код статуса, который можно получить из специальной таблицы.
STATUS_DESCRIPTION(описание статуса):	В данном пункте указывается тип источника статуса из которого лид попал в CRM.
STATUS_SEMANTIC_ID:	На текущий момент данное поле не используется. Оно будет необходимо для сквозной аналитики от Битрикс24.
POST (должность контакта):	В данном поле можно указать должность Контакта.
ADDRESS (Фактический адрес):	В данном поле можно указать фактический адрес Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_2 (квартира\офис фактического адреса):	В данном поле можно указать адрес квартиры или офиса Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_CITY (Город фактического адреса):	В данном поле можно указать город расположения Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_POSTAL_CODE (Почтовый индекс фактического адреса):	В данном поле можно указать почтовый индекс Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_REGION (Район фактического адреса):	В данном поле можно указать район Контакта (устаревшее поле, сейчас используются реквизиты).
ASSIGNED_BY_ID (Ответственный за компанию):	В данном поле можно указать ответственного за компанию. Следует помнить, что поле должно принимать формат
ADDRESS_PROVINCE (Область фактического адреса):	В данном поле можно указать область Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_COUNTRY (Страна фактического адреса):	В данном поле можно указать страну Контакта (устаревшее поле, сейчас используются реквизиты).
ADDRESS_COUNTRY_CODE (Код страны фактического адреса):	В данном поле можно указать код страны Контакта (устаревшее поле, сейчас используются реквизиты).
CURRENCY_ID (Валюта расчетов):	В данном поле можно указать валюту расчётов Лида. Значения берутся из одноимённого справочника CRM.
OPPORTUNITY (Предполагаемая сумма):	В данном поле можно указать предполагаемую сумму по Лиду. Данное поле заполняется автоматически из товарного раздела и не следует его менять если у Вас заполнены в Лиде товары с ценами.
COMMENTS (Комментарий):	В данном поле можно указать комментарий компании.
ASSIGNED_BY_ID (Ответственный за компанию):	В данном поле можно указать ответственного за компанию. Следует помнить, что поле должно принимать формат - user_ID (например user_1).
ORIGINATOR_ID (Идентификатор внешней информационной базы):	Назначение поля может меняться конечным разработчиком. Это служебное поле, которое не следует трогать.
ORIGIN_ID (Внешний ключ, используется для операций обмена):	Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком. Этот идентификатор используется при обмене компаниями со внешними системами, например 1С, для того, чтобы сопоставить компанию в разных системах.
UTM_SOURCE (метка источника):	В данном поле можно указать метку источника рекламной кампании.
UTM_MEDIUM (метка типа кампании):	В данном поле можно указать метку источника рекламной кампании.
UTM_CAMPAIGN (метка названия кампании):	В данном поле можно указать метку названия рекламной кампании.
UTM_CONTENT (метка контейнера кампании):	В данном поле можно указать метку дополнительного контейнера рекламной кампании.
UTM_TERM (метка ключевого слова кампании):	В данном поле можно указать метку ключевого слова рекламной кампании.
PHONE (Телефон):	В данном поле можно добавить разные номера телефонов. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
EMAIL (адрес электронно почты):	В данном поле можно добавить разные адреса электронной почты. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
WEB (адрес сайта):	В данном поле можно добавить разные адреса сайтов компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
IM (интернет мессенджеры):	В данном поле можно добавить разные адреса интернет - мессенджеров компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.

Товары (ID##количество##ед. измерения##цена): один из самых главных пунктов данного активити. В данный пункт заполняются товарные позиции, которые будут прикреплены к лиду.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Поиск Лида (v.2)

Данное активити позволяет осуществлять поиск лида, по заданным параметрам.
Результатом работы является получение ID лида в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Название	Описание
ID:	ID искомого лида
Название лида:	В данном поле указывается название искомого лида
Обращение:	В данном поле указывается обращение, которое содержится в искомом лиде
Имя:	В данном поле указывается Имя, указанное в искомом лиде
Отчество:	В данном поле указывается отчество, указанное в искомом лиде
Фамилия:	В данном поле указывается фамилия, указанное в искомом лиде
Название компании:	В данном пункте указывается название компании, которое указано в поле лида "Название компании"
Источник:	В данном поле можно выбрать источники искомого лида, выбрать можно несколько штук, зажав Ctrl и кликая по нужным источникам
Дополнительно об источнике:	в данном поле указываются дополнительные сведения об источнике лида, которые указаны в самом в искомом лиде
Статус:	В данном поле можно выбрать несколько статусов для искомого лида, выбрать можно несколько штук, зажав Ctrl и кликая по нужным статусам.
Дополнительно о статусе:	в данном поле указываются дополнительные сведения о статусе лида, которые указаны в самом в искомом лиде
Состояние статуса:	В данном пункте указывается состояние статуса искомого лида
Должность:	В данном пункте указывается должность, которая указана в поле лида "Должность"
Адрес:	В данном поле указывается значение "фактического адреса", заполненное в искомом лиде
Адрес (стр. 2):	В данном поле указывается значение "квартира\офис фактического адреса", заполненное в искомом лиде
Город:	В данном пункте указывается Город, который указан в поле лида "Город"
Телефон:	В данном поле указывается телефон, который был указан в лиде в соответствующем поле.
E-mail:	В данном поле указывается email, который был указан в лиде в соответствующем поле.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Возвращаемые параметры для данного активити:
- Результат поиска (массив ID звонков) для итератора.
- Результат поиска (массив ID дел) для итератора.
- Количество найденных элементов.
- Соответствует условиям.
- Сообщение об ошибке.

Удаление лида

Данное активити позволяет удалить сущность лид, указав её ID.

Сценарий работы активити бизнес-процесса

ID лида: в данном поле нужно указать ID удаляемого лида.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат выполнения (Y/N).
- Сообщение об ошибке.
- Таймаут операции.

Прочее

Разделение элементов массива

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

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

Сообщение об ошибке: да/нет.
Позволяет выводить ошибки в журнал БП.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры для данного активити:
- Элемент массива 1
- Элемент массива 2
- Элемент массива 3
- Элемент массива 4
- Элемент массива 5
- Элемент массива 6
- Элемент массива 7
- Элемент массива 8
- Элемент массива 9
- Элемент массива 10
- Сообщение об ошибке
- Таймаут операции 

Парсинг текста в бизнес-процессах

Данное активити парсит (собирает данные) текст в БП согласно указанным параметрам.

Сценарий работы активити бизнес-процесса

Контент для парсинга: в данном пункте указывается текст, в котором БП будет искать данные согласно заданным ниже параметрам.

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

Для примера рассмотрим фразу: У лукоморья дуб зеленый.   

Слово: слитный набор любых символов, отделенный от других пробелами слева и/или cправа.
Пример: "дуб-зеленый", это одно слово, а "дуб зеленый", это 2 слова, т.к между ними пробел.
Символ: первый встречающийся символ в строке. 

1##слово - вернет первое слово, расположенное до указанного искомого (обрабатывается вся строка, символы не возвращаются);
1##зеленый — вернёт в дополнительные параметры процесса слово дуб 

2##слово - вернет первое слово, расположенное после указанного искомого (обрабатывается вся строка, символы не возвращаются);
2##дуб — вернёт в дополнительные параметры процесса слово зелёный. 

3##символ/символы1##символ/символы2 - вернёт все символы или группы символов (включая пробел) в строке, расположенные меду указанными символом1 и символом2.
3##У##зе -  вернёт в дополнительные параметры процесса символ —  лукоморья дуб

Стоит учитывать, что регистр имеет значение.
Т.е возьмем фразу выше "У лукоморья дуб зеленый":
3##у##зе -  вернёт в дополнительные параметры процесса строку —  коморья дуб -строчная "у"
3##У##зе -  вернёт в дополнительные параметры процесса строку —  лукоморья дуб -заглавная "У"

Для команды 4 возьмем аббревиатуру счета с его номером: НФР-190188
4## - вернет все цифры в строке, без доп. символов.
Пример: Счет №21-сD1234 от 11.02.2020, вернет 21123411022020

5## - вернет ссылку из HTML-тега, который содержится в строке.
Пример: 5##Документ можно скачать перейдя по ссылке: https://test123.ru , вернет https://test123.ru. 

ВАЖНО!
В параметрах, при вводе искомого слова/символа - НЕЛЬЗЯ использовать пробел до этого слова/символа и/или после, т.к. пробел является разделителем.
1 - синтаксис команды.   ## - разделитель.

Учитывать регистр при парсинге: варианты да/нет.
Позволяет активировать либо деактивировать учет текстового регистра при парсинге (заглавная/строчная буква).
Пример: 
Звездное1небо5залито7звеЗдами
1. Учет регистра включен, параметр: 3##з##З 
Результат: "дное1небо5залито7зве".
2. Учет регистра выключен, параметр 3##з##З
Результат: "ве".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат поиска (1 - 10)
- Соответствует условиям ( Y / N )

Получение id элемента массива по ключу

Данное активити позволяет получить id элемента массива по ключу (порядковому номеру) при помощи БП.

Сценарий работы активити бизнес-процесса

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

Пример: Задан массив элементов 100,57,62,83,145,217 и нам нужно получить ID элемента 83.
Согласно логике отсчета 1=100,2=57, 3=62, 4=83, 5=145, 6=217.
Соответственно указываем 4.

Массив элементов: в данном поле через запятую указывается массив элементов.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID элемента по ключу.
- Таймаут операции. 

Постраничный вывод массива

Данное активити позволяет осуществить постраничный вывод массива при помощи бизнес-процесса.

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

Количество элементов на странице: в данном поле указывается какое количество элементов будет отображено на странице при выводе.

Номер страницы для вывода: в данном поле указывается какую страницу выводить.

Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Возвращаемые параметры для данного активити:
- Результат поиска (массив для интегратора)
- Результат поиска(строка)
- Соответствие условиям.
- Сообщение об ошибке.

Объединение массивов

Данное активити позволяет осуществить объединение массивов при помощи бизнес-процесса.

Тип операции: позволяет выбрать один из предложенных вариантов операции объединения "Сформировать результат из повторяющихся значений" или "Сформировать результат из уникальных значений".

• "Сформировать результат из повторяющихся значений"

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

• "Сформировать результат из уникальных значений"

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

Массив для итератора 1-10: Количество полей в каждом пункте этого типа можно увеличивать. Каждый пункт является массивом для итератора. Данный массив может бы получен разными путями: из параметров БП или являться результатом работы активити (возвращаемый параметр).

Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Возвращаемые параметры для данного активити:
- Результат поиска (массив для интегратора).
- Результат поиска(строка).
- Соответствие условиям.
- Сообщение об ошибке.

Выбор места расположения открытой линии

Данное активити позволяет изменить приоритет использования открытых линий в сущности, к которой они привязаны.

ID сущности: в этом поле указывается ID сущности.

Тип сущности: в этом поле указывается тип сущности, доступны варианты: лид, контакт, компания.

Укажите ID первой линии(не приоритетной): в этом поле указывается ID открытой линии, которая является менее приоритетной.

Укажите ID последней линии(приоритетной): в этом поле указывается приоритетная открытая линия (используется в активити для отправки сообщений через эту линию).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Возвращаемые параметры данного активити:
- Соответствует условиям.
- Идентификатор пользователей ВКонтакте.
- Сообщение об ошибке.

Поиск в массиве по фильтру

Данное активити ищет в массиве элементы которые отвечают условиям выбранного Вами фильтра.

Сценарий работы активити бизнес-процесса

Массив который нужно разделить: в это поле вставляется массив.
Пример: Вчера в магазине я купил:,картошка-250р,печения-55р,молотый кофе-600р
Запятая является делителем массива.

Условия: данном поле указывается условия для поиска: больше, меньше, больше чем, меньше чем и т.п
Пример заполнения:

• %картошка-250р
• %печения-55р
  
• %молотый кофе-600р
  

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Формат выводов результатов (число):Варианты да/нет.
Позволяет выделить цифры из строки, если выбрано да.
Пример: Вчера в магазине я купил:,картошка-250р,печения-55р,молотый кофе-600р

• нет == картошка-250р,печения-55р,молотый кофе-600р
•  да == 250,55,600

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры активити:
- Количество найденных элементов.
- Найденный элемент 1-10.
- Сообщение об ошибке.

Удаление ожидающего события

Данное активити позволяет удалять/завершать ожидающие в очереди или повторяющиеся события (ожидание задачи или статус счета).
Это активити работает со следующими активити:

• Слежение за статусом задаче.
  
• Слежение за изменением в задаче.
  
• Слежение за статусом счета.

Тип сущности: в данном поле указывается тип сущности в которой находится событие (счет/задача)

ID сущности: в этом поле нужно указать ID сущности.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Получение телефонов и email из сущности

Данное активити позволяет получить телефон или почты из сущности в формате строки.

Сценарий работы активити бизнес-процесса

Тип сущности: в этом поле из выпадающего списка выбирается тип сущности, из которой будут получены телефоны и e-mail.

ID Сущности: в этом поле указывается ID сущности из которой будут получать телефоны и e-mail.

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

• Почта
• Рабочая почта.
• Частная почта.
• Почта для рассылок.
• Другая.

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

• Телефон
• Рабочий телефон
  
• Мобильный телефон
  
• Факс телефон
• Домашний телефон
  
• Пейджер телефон
  
• Телефон для рассылок
  
• Другой

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Сценарий работы робота

Возвращаемые параметры активити:
- Результат получения почты (строка, первое значение).
- Результат получения почты (массив для итератора).
- Результат получения телефона (строка, первое значение).
- Результат получения телефона (массив для итератора).
- Количество почтовых ящиков.
- Количество телефонов.
- Сообщение об ошибке.

Преобразование из строки в массив и обратно

Данное активити может преобразовать данные (текст) из строки в массив и обратно.

Сценарий работы бизнес-процесса

Выберите операцию: в данном поле из выпадающего списка выбирается тип операции, которую будет выполнять активити:

• Из строки в массив.
• Из массива в строку.

Укажите массив:
ТОЛЬКО! Если выбрана операция из "из массива в строку" - в данном поле указывается массив для итератора, который нужно преобразовать.

ВАЖНО!
Максимальное количество элементов массива, доступных к преобразованию - 50

Укажите строку:
ТОЛЬКО! Если выбрана операция из "из строки в массив" - в данном поле указывается текст для преобразования.

Разделитель (объединитель): в данном поле указывается символ, либо несколько символов, которые участвуют в разделении или объединении.
По умолчанию в массивах получаемых в возвращаемых параметрах активити используется символ ";" (точка с запятой). Вы можете использовать любой другой разделитель, в т.ч и пробел, но в возвращаемых параметрах всегда приходит массив с делителем в виде точки с запятой.
Пример: 

• Строка: 1,2,3,4,5

Получиться массив
1
2
3
4
5
Разделителем будет в данном случае "," запятая.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Массив в виде строки.
- Массив в виде строки (массив для итератора).
- Результат: элемент массива 1-50.
- Сообщение об ошибке.

Получение значения элемента массива по ключу

Данное активити позволяет получить значение элемента массива по указанному вами ключу данного массива.

Сценарий работы бизнес-процесса

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

Ключ массива: в данном поле указывается ключ, по которому нужно получить значение.
Данный ключ можно получить из самого массива, т.е ключ, это порядковый номер элемента в массиве(считается от 0, и если знак препинания отделен от слова, то считается за элемент).
Пример: 
Передается массив: Звездное небо, но холодная ночь.
Ключ: 3 
Получаемое значение по ключу: холодная.

Массив передается в переменной.
Если вы добавляете данные вручную, то каждый элемент массива добавляется с новой строки (кнопка "добавить").

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат: значение по ключу.
- Сообщение об ошибке.

Удаление html тегов из тела письма

Данное активити позволяет удалить html теги из тела письма.

Сценарий работы бизнес-процесса

Тело письма: в поле добавляется текст, который нужно очистить от HTML - тегов.

Какие символы(слова) удалить: позволяет удалить символы, слова или текст, который был указан в поле (поле множественное).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Возвращаемые параметры данного активити:
- Тело письма - результат.
- Сообщение об ошибке.

Завершение по условиям

Данное активити завершается по указанным условиям.

Сценарий работы активити бизнес-процесса

Это активити подписывается на события и ждет, когда в сущности CRM (лид, контакт, компания, сделка) произойдут изменения, которые совпадут с условиями, указанными пользователем и по достижении этих условий завершает свою работу, давая тем самым запуститься следующему активити в цепочке БП.

Условия для завершения: в данном поле указываются условия для завершения активити.
Заполняются в следующем формате: код поля##условие (больше(>), меньше(<),равно(=)/неравно( ! ))##данные в поле.
Пример:
OPPORTUNITY##>##200
Условие означает: В поле OPPORTUNITY , сумма сделки больше 200.

Если Вы хотите узнать код поля для пользовательского поля, то вам нужно перейти в меню настроек "Пользовательские поля"-> тип сущности -> настройки нужного поля -> посмотреть в адресную строку браузера.
В адресной строке браузера, в ссылке на текущую страницу с настройками поля, вы увидите следующее: адрес портала/crm/configs/fields/CRM_DEAL/edit/UF_CRM_12345678/ , где UF_CRM_12345678 - код пользовательского поля.

Код штатных полей вы можете узнать либо через F12, либо из справки Б24 по коду полей и их описанию для разных типов сущностей.

• Коды полей сущности "Сделка"
• Коды полей сущности "Контакт"
  
• Коды полей сущности "Компания"
  
• Коды полей сущности "Лид"
  

Тип условия для всех параметров: в данном поле указывается один из вариантов  типа условий "и/или".
И - все поля должны совпасть (должны быть соблюдены).
Или - хотя бы одно из условий должно быть соблюдено.

Список событий: в этом поле выбирается вариант событий изменения сущности, на которые может реагировать активити.
Изменение лида/контакта/сделки/компании.

ВАЖНО!
Фактически, данное поле отвечает за выбор типа сущности с которой будет работать активити.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

   Возвращаемые параметры данного активити:
  - Сообщение об ошибке.

Генерация HTML(BBcode) таблицы

Данное активити генерирует HTML(BBcode) таблицу согласно указанным Вами параметрам.

Тип форматирования: в этом поле можно выбрать в каком формате таблицы будет осуществляться вывод, HTML или BBcode.

Основа заполнения: данное поле позволяет выбрать построчное (tr) или столбовое(td) заполнение строк. 

Построчное (tr): 

Столбовое (td):

Контент для таблицы: в данном поле записывается содержимое таблицы.
В каждом новом поле необходимо заполнить содержимое строки или столбца таким образом: строка1##строка2##строка3, в соответствии с основой заполнения.
Пример заполнения:
Построчное (tr): строка1##строка2##строка3
Столбовое (td): строка1##строка2##строка3
Т.е вне зависимости от выбранной основы заполнения, принцип заполнения одинаковый.
Если Вам нужно указать более трех строк/столбов (нет ограничения), то это тоже возможно, главное, чтобы последующее заполнение соответствовало тому, что вы указали изначально.
Пример:
Правильно:
Построчное (tr): строка1##строка2##строка3##строка4##строка5
                            строка1##строка2##строка3##строка4##строка5
Неправильно:
Построчное (tr):  строка1##строка2##строка3##строка4##строка5
                             строка1##строка2##строка3##строка4

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры для данного активити:
- Таблица HTML
- Сообщение об ошибках.

Отправить PUSH уведомление

Данное активити позволяет отправить PUSH уведомление. 

Сценарий работы активити бизнес-процесса

Идентификаторы пользователей получателей push-уведомлений: в данном поле нужно указать пользователя, который получит PUSH-уведомление.
В данных пользователя должен быть указан номер мобильного телефона.

Произвольный текст: В данном поле указывается текст PUSH-уведомления.

Ссылка на изображение (аватар): в данном поле можно указать ссылку на изображение (аватар) отправителя.
Ссылка должна быть общедоступной, иначе аватар не будет добавлен.

Делать отладочные сообщения в журнал БП: вывод отладочных данных в журнале бизнес-процесса.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Реквизиты

Поиск реквизитов

Данное активити позволяет найти главный (родительский) реквизит.
Результатом работы является получение ID родительского реквизита в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сценарий работы активити бизнес-процесса

ВАЖНО:
  УНП (Беларусь) фактически хранится в поле ИНН (Россия) сейчас столкнулись с проблемой получения данных из реквизита.

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

Название:	Описание:
Тип сущности:	В данном поле из выпадающего списка выбирается тип сущности к которой привязан реквизит.
ID сущности:	В данном поле указывается ID сущности, к которой привязан реквизит.
Тип пресета:	В данном поле указывается тип шаблона реквизита, к которому относится данный (искомый) реквизит.
Название:	В данном поле указывается название искомого реквизита.
Код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.
Идентификатор внешней информационной базы:	В данном поле указывается идентификатор внешней информационной базы, например: 1С
Активен:	Из выпадающего списка можно выбрать активен реквизит или нет.
Сортировка:	В данном поле указывается индекс сортировки.
Ф.И.О.:	В данном поле указывается фамилия, имя и отчество владельца реквизита.
Имя:	В данном поле указывается имя владельца реквизита.
Фамилия:	В данном поле указывается фамилия владельца реквизита.
Отчество:	В данном поле указывается отчество владельца реквизита.
Сокращенное наименование организации:	В данном поле указывается сокращенное наименование организации, указанное в ее документах.
Полное наименование организации:	В данном поле указывается полное наименование организации, указанное в ее документах.
Ген. директор:	В данном поле указывается Ф.И.О ген. директора.
Гл. бухгалтер:	В данном поле указывается Ф.И.О главного бухгалтера.
ФИО первого руководителя:	В данном поле указывается Ф.И.О первого руководителя.
Должность первого руководителя:	В данном поле указывается должность первого руководителя.
Контактное лицо:	В данном поле указывается контактное лицо.
E-Mail:	В данном поле указывается e-mail.
Телефон:	В данном поле указывается телефон.
Факс:	В данном поле указывается факс.
Вид документа:	В данном поле указывается вид документа привязанный к реквизиту, например паспорт.
Серия:	В данном поле указывается серия документа.
Номер:	В данном поле указывается номер документа.
RQ_IDENT_DOC_PERS_NUM:	В данном поле указываются данные иностранных документов.
Дата выдачи:	В данном поле указывается дата выдачи документа.
Кем выдан:	В данном поле указывается кем был выдан данный документ.
Код подразделения:	В данном поле указывается код подразделения, которое выдавало документ.
ИНН:	В данном поле указывается ИНН организации.
КПП:	В данном поле указывается КПП организации.
Handelsregisternummer (для страны DE).:	В данном поле указывается, но номер национального реестра юр лиц Германии.
ИФНС:	В данном поле указывается ИФНС организации.
ОГРН:	В данном поле указывается ОРГН организации.
ОГРНИП:	В данном поле указывается ОРГНИП организации.
ОКПО:	В данном поле указывается ОКПО организации.
ОКТМО:	В данном поле указывается ОКТМО организации.
ОКВЭД:	В данном поле указывается ОКВЭД организации.
ЄДРПОУ:	В данном поле указывается ЄДРПОУ организации.
ДРФО:	В данном поле указывается ДРФО организации.
КБЕ:	В данном поле указывается КБЕ организации.
ИИН:	В данном поле указывается ИИН организации.
БИН:	В данном поле указывается БИН организации.
Серия св. о гос. регистрации:	В данном поле указывается серия свидетельства о гос. регистрации.
Номер св. о гос. регистрации:	В данном поле указывается номер свидетельства о гос. регистрации.
Дата св. о гос. регистрации:	В данном поле указывается дата выдачи свидетельства о гос. регистрации.
Платник ПДВ (для страны UA):	В данном поле указывается регистрационный номер плательщика ПДВ в Украине.
VAT ID (идентификационный номер (плательщика) НДС):	В данном поле указывается идентификационный номер (плательщика) НДС. Т.е номер, под которым налогоплательщик зарегистрирован в бюро учета НДС. Может практически совпадать с номером ИНН.
Серия свидетельства по НДС:	В данном поле указывается серия свидетельства по НДС.
Номер свидетельства по НДС:	В данном поле указывается номер свидетельства по НДС.
Дата свидетельства по НДС:	В данном поле указывается дата выдачи свидетельства по НДС.
Страна резидента:	В данном поле указывается страна резидента.
RQ_BASE_DOC:	В данном поле указываются данные иностранных документов.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив ID звонков) для итератора;
- Результат поиска (массив ID дел) для итератора;
- Количество найденных элементов.
- Соответствует условиям.
- Сообщение об ошибке.

Добавление реквизита

Данное активити позволяет добавить главный (родительский) реквизит.

ВАЖНО!
УНП (Беларусь) фактически хранится в поле ИНН (Россия) сейчас столкнулись с проблемой получения данных из реквизита.

Название:	Описание:
ID типа сущности:	В данном поле указывается тип сущности к которой будет привязан реквизит.
ID сущности:	В данном поле указывается ID сущности, к которой привязывается создаваемый реквизит.
ID пресета:	В данном поле указывается тип пресета реквизита, к которому относится данный (создаваемый) реквизит.
Название:	В данном поле указывается название изменяемого реквизита.
Код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24.
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.
Идентификатор внешней информационной базы:	в данном поле указывается идентификатор внешней информационной базы, например: 1С
Активен:	Из выпадающего списка можно выбрать активен реквизит или нет.
Сортировка:	В данном поле указывается индекс сортировки.
Ф.И.О.:	В данном поле указывается фамилия, имя и отчество владельца реквизита.
Имя:	В данном поле указывается имя владельца реквизита
Фамилия:	В данном поле указывается фамилия владельца реквизита.
Отчество:	В данном поле указывается отчество владельца реквизита.
Сокращенное наименование организации:	В данном поле указывается сокращенное наименование организации, указанное в ее документах.
Полное наименование организации:	В данном поле указывается полное наименование организации, указанное в ее документах.
Ген. Директор:	В данном поле указывается Ф.И.О ген. Директора.
Гл. Бухгалтер:	В данном поле указывается Ф.И.О главного бухгалтера.
ФИО первого руководителя:	В данном поле указывается Ф.И.О первого руководителя.
Должность первого руководителя:	В данном поле указывается должность первого руководителя…
Контактное лицо:	В данном поле указывается контактное лицо.
E-Mail:	В данном поле указывается e-mail.
Телефон:	В данном поле указывается телефон.
Факс:	В данном поле указывается факс.
Вид документа:	В данном поле указывается вид документа привязанный к реквизиту, например паспорт.
Серия:	В данном поле указывается серия документа.
Номер:	В данном поле указывается номер документа.
RQ_IDENT_DOC_PERS_NUM:	В данном поле указываются данные иностранных документов.
Дата выдачи:	В данном поле указывается дата выдачи документа.
Кем выдан:	В данном поле указывается кем был выдан данный документ.
Код подразделения:	В данном поле указывается код подразделения, которое выдавало документ.
ИНН:	В данном поле указывается ИНН организации.
КПП:	В данном поле указывается КПП организации.
Handelsregisternummer (для страны DE).:	В данном поле указывается, но номер национального реестра юр лиц Германии.
ИФНС:	В данном поле указывается ИФНС организации.
ОГРН:	В данном поле указывается ОРГН организации.
ОГРНИП:	В данном поле указывается ОРГНИП организации.
ОКПО:	В данном поле указывается ОКПО организации.
ОКТМО:	В данном поле указывается ОКТМО организации.
ОКВЭД:	В данном поле указывается ОКВЭД организации.
ЄДРПОУ:	В данном поле указывается ЄДРПОУ организации.
ДРФО:	В данном поле указывается ДРФО организации.
КБЕ:	В данном поле указывается КБЕ организации.
ИИН:	В данном поле указывается ИИН организации.
БИН:	В данном поле указывается БИН организации.
Серия св. о гос. регистрации:	В данном поле указывается серия свидетельства о гос. регистрации.
Номер св. о гос. регистрации:	В данном поле указывается номер свидетельства о гос. регистрации.
Дата св. о гос. регистрации:	В данном поле указывается дата выдачи свидетельства о гос. регистрации.
Платник ПДВ (для страны UA):	В данном поле указывается регистрационный номер плательщика ПДВ в Украине.
VAT ID (идентификационный номер (плательщика) НДС):	В данном поле указывается идентификационный номер (плательщика) НДС. Т.е номер, под которым налогоплательщик         зарегистрирован в бюро учета НДС. Может практически совпадать с номером ИНН.
Серия свидетельства по НДС:	В данном поле указывается серия свидетельства по НДС.
Номер свидетельства по НДС:	В данном поле указывается номер свидетельства по НДС.
Дата свидетельства по НДС:	В данном поле указывается дата выдачи свидетельства по НДС.
Страна резидента:	В данном поле указывается страна резидента.
RQ_BASE_DOC:	В данном поле указываются данные иностранных документов.

ВАЖНО!
Добавление шаблонов и полей реквизитов должно происходить ДО установки активити, если их добавить после, то в активити эти поля и шаблоны не отобразятся до переустановки активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: 

в д

анном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Возвращаемые параметры для данного активити:
- Идентификатор нового реквизита.
- Сообщение об ошибке.

  

Получение данных по сущности: реквизит

Данное активити позволяет получить все данные по сущности реквизит.

Сценарий работы активити бизнес-процесса

ID реквизита: в данном поле указывается ID реквизита.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Все данные по сущности реквизит.

Изменение реквизита

Данное активити позволяет изменить главный (родительский) реквизит.

ВАЖНО!
УНП (Беларусь) фактически хранится в поле ИНН (Россия) сейчас столкнулись с проблемой получения данных из реквизита.

Название:	Описание:
ID реквизита:	в данном поле указывается ID изменяемого реквизита.
Название:	в данном поле указывается название изменяемого реквизита.
Идентификатор внешней информационной базы:	в данном поле указывается идентификатор внешней информационной базы, например: 1С
Активен:	из выпадающего списка можно выбрать активен реквизит или нет.
Сортировка:	в данном поле указывается индекс сортировки.
Ф.И.О.:	в данном поле указывается фамилия, имя и отчество владельца реквизита.
Имя:	в данном поле указывается имя владельца реквизита
Фамилия:	в данном поле указывается фамилия владельца реквизита.
Отчество:	в данном поле указывается отчество владельца реквизита.
Сокращенное наименование организации:	в данном поле указывается сокращенное наименование организации, указанное в ее документах.
Полное наименование организации:	в данном поле указывается полное наименование организации, указанное в ее документах.
Ген. директор:	в данном поле указывается Ф.И.О ген. директора.
Гл. бухгалтер:	в данном поле указывается Ф.И.О главного бухгалтера.
ФИО первого руководителя:	в данном поле указывается Ф.И.О первого руководителя.
Должность первого руководителя:	в данном поле указывается должность первого руководителя...
Контактное лицо:	в данном поле указывается контактное лицо.
E-Mail:	в данном поле указывается e-mail.
Телефон:	в данном поле указывается телефон.
Факс:	в данном поле указывается факс.
Вид документа:	в данном поле указывается вид документа привязанный к реквизиту, например паспорт.
Серия:	в данном поле указывается серия документа.
Номер:	в данном поле указывается номер документа.
RQ_IDENT_DOC_PERS_NUM:	в данном поле указываются данные иностранных документов.
Дата выдачи:	в данном поле указывается дата выдачи документа.
Кем выдан:	в данном поле указывается кем был выдан данный документ.
Код подразделения:	в данном поле указывается код подразделения, которое выдавало документ.
ИНН:	в данном поле указывается ИНН организации.
КПП:	в данном поле указывается КПП организации.
Handelsregisternummer (для страны DE).:	в данном поле указывается но номер национального реестра юр лиц Германии.
ИФНС:	в данном поле указывается ИФНС организации.
ОГРН:	в данном поле указывается ОРГН организации.
ОГРНИП:	в данном поле указывается ОРГНИП организации.
ОКПО:	в данном поле указывается ОКПО организации.
ОКТМО:	в данном поле указывается ОКТМО организации.
ОКВЭД:	в данном поле указывается ОКВЭД организации.
ЄДРПОУ:	в данном поле указывается ЄДРПОУ организации.
ДРФО:	в данном поле указывается ДРФО организации.
УНП:	в данном поле указывается УНП организации (Беларусь)
КБЕ:	в данном поле указывается информация о получателе денежных средств (бенефициаре Казахстан)
ИИН:	в данном поле указывается ИИН предпринимателя организации (Казахстан).
БИН:	в данном поле уникальный номер, формируемый для юридического лица (филиала и представительства Казахстане)
Серия св. о гос. регистрации:	в данном поле указывается серия свидетельства о гос. регистрации.
Номер св. о гос. регистрации:	в данном поле указывается номер свидетельства о гос. регистрации.
Дата св. о гос. регистрации:	в данном поле указывается дата выдачи свидетельства о гос. регистрации.
Платник ПДВ (для страны UA):	в данном поле указывается регистрационный номер плательщика ПДВ в Украине.
VAT ID (идентификационный номер (плательщика) НДС):	в данном поле указывается идентификационный номер (плательщика) НДС. Т.е номер, под которым налогоплательщик зарегистрирован в бюро учета НДС. Может практически совпадать с номером ИНН.
Серия свидетельства по НДС:	в данном поле указывается серия свидетельства по НДС.
Номер свидетельства по НДС:	в данном поле указывается номер свидетельства по НДС.
Дата свидетельства по НДС:	в данном поле указывается дата выдачи свидетельства по НДС.
Страна резидента:	в данном поле указывается страна резидента.
RQ_BASE_DOC:	в данном поле указываются данные иностранных документов.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: 

в д

анном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Возвращаемые параметры для данного активити:
- Сообщение об ошибке.

  

Удаление реквизита

Данное активити позволяет удалить реквизит, ID которого указанно в настройках.

Сценарий работы активити бизнес-процесса

ID реквизита: в данном поле указывается ID реквизита, который нужно удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

 Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Подразделения

Поиск подразделений

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

Сценарий работы активити бизнес-процесса

ID: в данном поле нужно указать ID искомого подразделения.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Название подразделения: в этом поле указывается название искомого подразделения.

Вышестоящее подразделение: в этом поле указывается ID выше стоящего подразделения (только цифра)
Получить ID этого подразделения можно перейдя в искомое подразделение и посмотрев его ID в адресной строке, либо выбрав из списка в соответствующем меню.
К примеру, содержимое адресной строки TEST.bitrix24.ru/company/structure.php?set_filter_structure=Y&amp;structure_UF_DEPARTMENT=1706, 1706 - это ID подразделения.

Руководитель: в этом поле указывается руководитель подразделения, путем выбора из списка сотрудников портала, либо если указать его ID.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат работы (массив для итератора).
- Результат работы (строка).
- Количество найденных элементов.
- Соответствует условиям.
- Сообщение об ошибке.

Реквизиты (адресные)

Добавление адресного реквизита

Данное активити позволяет добавить адресный реквизит. 

Тип адреса: в данном поле из выпадающего списка можно выбрать тип адресного реквизита.Доступны варианты: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.

ID родительского реквизита: в данном поле указывается ID родительского реквизита в которому привяжется адресный реквизит.

Важно понимать, что данный реквизит не является родительским. Банковский реквизит привязывается к родительскому, а родительский привязывается уже к сущности.
По такому же принципу привязывается и адресный реквизит.
Для создания родительского реквизита вы можете использовать наше активити "Добавление реквизита" из категории "Реквизиты"

Улица, дом, корпус, строение: в данном поле указывается адрес улицы,дома/строения и корпус.

Квартира / офис:  в данном поле указывается квартира /офис.

Город: в данном поле указывается город.

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

Район: в донном поле указывается раен.

Область: в данном поле указывается область.

Страна: в данном поле указывается страна.

Код страны: в данном поле указывается код страны.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-ID нового адресного реквизита.
-Сообщение об ошибке.

Изменение адресного реквизита

Данное активити позволяет изменить адресный реквизит, привязанный к родительскому реквизиту.

Тип адреса: в данном поле из выпадающего списка можно выбрать тип адресного реквизита.Доступны варианты: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.

ID родительского реквизита: в данном поле указывается ID родительского реквизита в которому привяжется адресный реквизит.

Улица, дом, корпус, строение: в данном поле указывается адрес улицы,дома/строения и корпус.

Квартира / офис: в данном поле указывается номер квартиры/офиса.

Город: в данном поле указывается город.

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

Район: в донном поле указывается раен.

Область: в данном поле указывается область.

Страна: в данном поле указывается страна.

Код страны: в данном поле указывается код страны.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-Сообщение об ошибке.

Удаление адресного реквизита

Данное активити позволяет выполнить удаление адресного реквизита.

Тип адреса: в данном поле из выпадающего списка можно выбрать тип адресного реквизита.Доступны варианты: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.

ID родительского реквизита: в данном поле указывается ID родительского реквизита в которому привяжется адресный реквизит.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращенаемые параметры данного активити:
-Сообщение об ошибке.

Получение данных по адресному реквизиту

Данное активити позволяет получить все данные по адресному реквизиту.

Сценарий работы активити бизнес-процесса

Тип адреса: в данном поле из выпадающего списка можно выбрать тип адресного реквизита. Доступны варианты: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.

ID родительского реквизита: в данном поле указывается ID родительского реквизита в которому привяжется адресный реквизит.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли делать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы активити бизнес-процесса

Возвращаемые параметры данного активити:
- Все данные по адресному реквизиту.

Реквизиты (банковские)

Добавление банковского реквизита

Данное активити позволяет добавить банковский реквизит в сущность, указав её ID.

ID родительского реквизита: в данном поле указывается ID родительского реквизита, к которому будет привязан банковский реквизит.

Важно понимать, что данный реквизит не является родительским. Банковский реквизит привязывается к родительскому, а родительский привязывается уже к сущности.
По такому же принципу привязывается и адресный реквизит.
Для создания родительского реквизита вы можете использовать наше активити "Добавление реквизита" из категории "Реквизиты"

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

Название: в данном поле указывается название банковского реквизита.

Код: в данном поле указывается код внешней системы,например 1С.

Внешний код: в данном поле указывается внутренний код Б24.

Активен: в данном поле выбирается активен реквизит или не активен.

Сортировка: в данном поле указывается номер сортировки реквизита.

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

Адрес банка: в банном поле указывается адрес банка к которому относятся добавляемые реквизиты.

Bank Routing Number: в данном поле вводится номер банка США (это поле заполняется только если счет в банке США).

БИК: в данном поле указывается банковский идентификационный код.

МФО: в данном поле указывается идентификационный код банка.

Bank Account Holder Name: в данном поле указывается имя держателя/владельца банковской карты/счета.

Расчетный счёт: в данном поле указывается номер расчетного счета в банке.

ИИК: в данном поле указывается индивидуальный идентификационный код.

Валюта счёта: в данном поле указывается валюта в которой открыт банковский счет.

Кор. счёт: в данном поле указывается номер корреспондентского счета.

IBAN: в данном поле указывается номер банковского счета клиента IBAN.

SWIFT: в данном поле указывается SWIFT-код банка.

BIC: в данном поле указывается BIC-код данка (он же БИК).

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

Идентификатор внешней информационной базы: в данном поле указывается идентификатор внешней информационной базы,например 1С.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-Идентификатор нового банковского реквизита.
-Сообщение об ошибке.

Поиск банковских реквизитов

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

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

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

Название: в данном поле указывается название банковского реквизита.

Код: в данном поле указывается код внешней системы, например 1С.

Внешний код: в данном поле указывается внутренний код Б24.

Активен: в данном поле выбирается активен реквизит или не активен.

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

Адрес банка: в банном поле указывается адрес банка к которому относятся добавляемые реквизиты.

Bank Routing Number: в данном поле вводится номер банка США (это поле заполняется только если счет в банке США).

БИК: в данном поле указывается банковский идентификационный код.

МФО: в данном поле указывается идентификационный код банка.

Bank Account Holder Name: в данном поле указывается имя держателя/владельца банковской карты/счета.

Расчетный счёт: в данном поле указывается номер расчетного счета в банке.

ИИК: в данном поле указывается индивидуальный идентификационный код.

Валюта счёта: в данном поле указывается валюта в которой открыт банковский счет.

Кор. cчёт: в данном поле указывается номер корреспондентского счета.

IBAN: в данном поле указывается номер банковского счета клиента IBAN.

SWIFT: в данном поле указывается SWIFT-код банка.

BIC: в данном поле указывается BIC-код банка (он же БИК).

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

Идентификатор внешней информационной базы: в данном поле указывается идентификатор внешней информационной базы, например 1С.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа:данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат поиска (массив для итератора)
- Результат поиска (строка)
- Количество найденных элементов
- Соответствие условиям
- Сообщение об ошибке.

Получение данных по банковскому реквизиту

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

Идентификатор банковского реквизита: в данном поле указывается идентификатор банковского реквизита.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-Все данные из банковского реквизита.

Изменение банковского реквизита

Данное активити позволяет изменить банковский реквизит.

Идентификатор банковского реквизита: в данном поле указывается ID банковского реквизита,который планируется изменить.

ВАЖНО!
Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

Если вы планируете через интегратор произвести изменение более 1000 сущностей, то нужно встраивать в БП счетчик, и после 1000 изменений делать паузу на 15 минут, если этого не сделать, то это приведет к тормозам в обработке на стороне Б24 и остальные сущности могут не отработаться.

Название: в данном поле указывается название банковского реквизита.

Код: в данном поле указывается код внешней системы,например 1С.

Внешний код: в данном поле указывается внутренний код Б24.

Активен: в данном поле выбирается активен реквизит или не активен.

Сортировка: в данном поле указывается номер сортировки реквизита.

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

Адрес банка: в банном поле указывается адрес банка к которому относятся добавляемые реквизиты.

Bank Routing Number: в данном поле вводится номер банка США (это поле заполняется только если счет в банке США).

БИК: в данном поле указывается банковский идентификационный код.

МФО: в данном поле указывается идентификационный код банка.

Bank Account Holder Name: в данном поле указывается имя держателя/владельца банковской карты/счета.

Расчетный счёт: в данном поле указывается номер расчетного счета в банке.

ИИК: в данном поле указывается индивидуальный идентификационный код.

Валюта счёта: в данном поле указывается валюта в которой открыт банковский счет.

Кор. счёт: в данном поле указывается номер корреспондентского счета.

IBAN: в данном поле указывается номер банковского счета клиента IBAN.

SWIFT: в данном поле указывается SWIFT-код банка.

BIC: в данном поле указывается BIC-код данка (он же БИК).

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

Идентификатор внешней информационной базы: в данном поле указывается идентификатор внешней информационной базы,например 1С.

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-Сообщение об ошибке.

Удаление банковcкого реквизита

Данное активити позволяет удалить банковский реквизит,указав его ID.

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

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли дделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-Сообщение об ошибке.

Сделки

Изменение Сделки

Активити (робот) "Изменение Сделки" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое обновление полей сделки на основе данных из других систем или документов;
• Массовое изменение сделок (стадия, ответственный, сумма, вероятность) по определённым условиям;
• Автоматизация перехода сделок между стадиями в зависимости от событий;
• Обновление данных сделки после выполнения определённых действий (подписание договора, оплата и т.д.);
• Синхронизация данных сделки с внешними системами;
• Автоматическое назначение ответственного в зависимости от суммы, типа или других параметров;
• Расчёт и применение НДС и скидок к товарам сделки;
• Прикрепление файлов к сделке из других сущностей CRM.

Как работает активити (робота):
- Активити (робот) автоматически получает список всех доступных полей сделки из CRM вашего портала;
- Для каждого поля (кроме недоступных для редактирования) создаётся параметр, который можно заполнить для изменения значения;
- Можно изменить одно или несколько полей одновременно;
- При указании параметров для работы с товарами (НДС, скидки) активити (робота) автоматически пересчитывает цены всех товаров в сделке;
- Поддерживается прикрепление файлов через ID файлов на диске;
- Активити (робот) возвращает ID изменённой сделки для использования в дальнейших шагах бизнес-процесса.

Сценарий работы активити (робота) бизнес-процесса

Описание параметров активити (робота)

Основные параметры:

Название поля

Описание и примеры использования

ID Сделки (o_deal_id):

Обязательное поле. В данном поле необходимо указать числовой идентификатор (ID) сделки, которую необходимо изменить. Примеры: - 123 - изменить сделку с ID 123; - {=Document:ID} - изменить текущую сделку из документа; - {=A1988_22222_92566_99999:search_results} - изменить сделку из результата предыдущего активити (робота) (первый элемент массива); - {=Iterator:Value} - изменить сделку для каждого элемента в итераторе; - Если поле имеет привязку к элементам инфо блоков (привязка к спискам), то для изменения значения нужно указывать ID элемента. Важно: Если ID сделки указан в формате [123] (в квадратных скобках), активити (робота) автоматически извлечёт числовое значение.

Параметры для работы с полями сделки:
Активити (робот) автоматически создаёт параметры для всех полей сделки, доступных для редактирования в вашем портале. Ниже описаны основные и наиболее часто используемые поля. Обратите внимание, что названия полей могут отличаться в зависимости от настроек вашего портала.

Название поля	Описание и примеры использования
Название (TITLE):	В данном поле можно указать новое значение названия сделки. Примеры: - Договор поставки №123; - ={Договор {={=Document:ID}}}; - Для очистки поля передайте пробел: ={ }
Тип (TYPE_ID):	В данном поле можно изменить тип сделки. Значения берутся из одноимённого справочника CRM. Примеры: - SALE - тип "Продажа"; - COMPLEX - тип "Комплексная сделка"; - Необходимо указывать символьный код типа сделки из настроек CRM. Как узнать символьный код типа сделки: - Перейдите в CRM → Настройки → Типы сделок; - Или используйте активити (робот) для получения типов сделок.
Стадия сделки (STAGE_ID):	В данном поле можно изменить стадию сделки. Примеры: - NEW - стадия "Новая"; - QUALIFICATION - стадия "Квалификация"; - Необходимо указывать символьный код стадии. Как узнать символьный код стадии: 1. В сделке нужно добавить штатное активити "Изменение документа" или штатное "Изменение стадии"; 2. В этом активити (роботе) выбрать поле "стадия"; 3. Нажать F12 и выбрать инструмент "выбор элемента страницы", и выбрать поле напротив поля "стадия"; 4. Появится расшифровка всех Стадий, выбираете название нужной и прописываете данное название в активити (робот) "Изменение сделки". ВАЖНО! НЕЛЬЗЯ изменить одновременно направление и стадию сделки, только поочередно. Сначала измените направление, затем стадию (или наоборот) в отдельных активити (роботах).
Направление (CATEGORY_ID):	ВАЖНО! Активити (робот) не может изменить направление сделки, т.к механизм REST Api Б24 не позволяет это делать напрямую. Для изменения направления сделки используйте штатное активити Битрикс24 "Смена направления сделки" или "Изменение документа".
Вероятность (PROBABILITY):	В данном поле можно изменить вероятность заключения сделки в процентах (от 0 до 100). Примеры: - ={50} - установить вероятность 50%; - ={{=min({=Variable:PROBABILITY} + 50, 100)}} - увеличить вероятность на 50 (используйте переменную из предыдущего активити (робота), результат не превысит 100); - ={0} - сбросить вероятность (сделка неактивна).
Сумма (OPPORTUNITY):	В данном поле можно изменить предполагаемую сумму в сделке. Данное поле заполняется автоматически из товарного раздела и не следует его менять, если у вас заполнены в сделке товары с ценами. Примеры: - ={100000} - установить сумму 100 000; - ={{={=Variable:OPPORTUNITY} * 1.1}} - увеличить сумму на 10% (используйте переменную из предыдущего активити (робота)); - Для очистки поля передайте: ={"##"} Важно: Изменение суммы вручную может конфликтовать с автоматическим расчётом суммы из товаров. Рекомендуется изменять товары, а не сумму напрямую.
Валюта расчетов (CURRENCY_ID):	В данном поле можно изменить валюту расчётов сделки. Значения берутся из одноимённого справочника CRM. Примеры: - RUB - рубли; - USD - доллары США; - EUR - евро. Необходимо указывать символьный код валюты из настроек CRM.
Ставка налога (TAX_VALUE):	В данном поле указывается ставка налога, применяемая к сделке (в процентах). Примеры: - ={20} - установить ставку НДС 20%; - ={0} - установить ставку 0% (без НДС); Важно: Изменение ставки налога в этом поле будет работать только если настроено поле "Способ начисления НДС" (i_active_nds). Для работы с товарами используйте параметры i_tax_rate и i_active_nds, которые автоматически пересчитывают цены товаров.
Компания (COMPANY_ID):	В данном поле можно изменить компанию, которая привязана к данной сделке. Примеры: - ={123} - привязать компанию с ID 123; - {=Document:COMPANY_ID}} - привязать компанию из текущего документа; - Для отвязки компании передайте 0 или пустое значение.
Контакт (CONTACT_ID):	В этом поле указывается ID только одного контакта (устаревшее поле, сохраняется для совместимости). Примеры: - ={456} - привязать контакт с ID 456; - {=Document:CONTACT_ID}} - привязать контакт из текущего документа; Рекомендация: Для работы с несколькими контактами используйте поле "Контакты (CONTACT_IDS)" вместо этого поля.
Контакты (CONTACT_IDS):	В данном поле можно изменить контакты, которые привязаны к данной сделке. Можно указать несколько ID через запятую или использовать массив значений. Примеры: - ={456,789,101112} - привязать контакты с ID 456, 789 и 101112; - {=Document:CONTACT_IDS}} - использовать массив контактов из документа; - В переменной типа "Множественное значение" указать список ID контактов. Важно: Это поле заменяет все существующие связи. Если нужно добавить контакт к существующим, сначала получите текущие контакты через активити (робот) "Получение данных Сделки", затем добавьте новый ID к списку.
Лид (LEAD_ID):	В данном поле можно указать идентификатор привязанного к сделке лида. Примеры: - ={789} - привязать лид с ID 789; - {=Document:LEAD_ID}} - привязать лид из текущего документа.
Дата начала (BEGINDATE):	В данном поле можно изменить дату начала сделки. Примеры: - ={01.01.2025 00:00:00} - установить дату начала; - {=System:NowLocal}} - установить текущую дату и время; - ={{={=Variable:BEGINDATE}}}} - использовать дату из другой сделки (используйте переменную из предыдущего активити (робота)).
Дата завершения (CLOSEDATE):	В данном поле можно изменить предполагаемую дату завершения сделки. Примеры: - ={31.12.2025 23:59:59} - установить дату завершения; - ={{=dateadd({=Variable:CLOSEDATE}, "30d")}} - установить дату на 30 дней позже (используйте переменную с датой из предыдущего активити (робота)); - Используется для автоматизации контроля сроков и напоминаний.
Ответственный (ASSIGNED_BY_ID):	В данном поле можно изменить ответственного за сделку. Примеры: - ={user_25} - назначить пользователя с ID 25 (формат: user_ID); - ={25} - также можно указать только ID (активити (робота) автоматически добавит префикс user_); - {=Document:ASSIGNED_BY_ID}} - назначить ответственного из текущего документа; - Используйте условие в бизнес-процессе: если {=Variable:OPPORTUNITY} > 1000000, то назначить user_50. Важно: При выборе сотрудника, в поле "привязка к пользователю" должен быть только его ID без лишних символов и букв (или в формате user_ID). Если пользователь не найден по указанному ID, поле не будет изменено.
Источник (SOURCE_ID):	В данном поле указывается источник сделки (символьный код источника). Примеры: - WEB - источник "Веб-сайт"; - CALL - источник "Звонок"; - EMAIL - источник "Email"; - Необходимо указывать символьный код источника из настроек CRM.
Дополнительно об источнике (SOURCE_DESCRIPTION):	В этом поле указывается дополнительная информация об источнике. Примеры: - Реклама в Google; - Рекомендация партнёра; - Для очистки поля передайте пробел: ={ }
Комментарий (COMMENTS):	В данном поле можно изменить комментарий сделки. Примеры: - Важная сделка, требует особого внимания; - ={{={=Variable:COMMENTS}}}} - скопировать комментарий из другой сделки (используйте переменную из предыдущего активити (робота)); - ={{={=Variable:COMMENTS} & " | Дополнительная информация"}} - добавить информацию к существующему комментарию (используйте переменную и оператор & для конкатенации); - Для очистки поля передайте пробел: ={ }
Дополнительная информация (ADDITIONAL_INFO):	В данном поле можно изменить дополнительную информацию о сделке. Примеры: - Специфические требования клиента; - Информация для внутреннего использования; - Для очистки поля передайте пробел: ={ }
Рекламная система (UTM_SOURCE):	В данном поле указывается рекламная система в сделке (из UTM-меток). Примеры: - google; - yandex; - Используется для анализа эффективности рекламных каналов.
Тип трафика (UTM_MEDIUM):	В данном поле указывается тип трафика в сделке (из UTM-меток). Примеры: - cpc; - organic; - banner.
Обозначение рекламной кампании (UTM_CAMPAIGN):	В данном поле указываются обозначения рекламной кампании в сделке (из UTM-меток). Примеры: - летняя_распродажа; - новый_год_2025; - Используется для отслеживания эффективности конкретных рекламных кампаний.
Содержание кампании (UTM_CONTENT):	В данном поле указывается содержание кампании в сделке (из UTM-меток). Примеры: - баннер_верхний; - текст_ссылка; - Используется для детального анализа эффективности элементов рекламы.
Условие поиска кампании (UTM_TERM):	В данном поле указывается условие поиска кампании в сделке (из UTM-меток, обычно ключевое слово). Примеры: - купить_телефон; - доставка_бесплатно; - Помогает анализировать эффективность конкретных ключевых слов в рекламе.
Завершена (CLOSED):	В данном поле указывается статус завершённости сделки. Примеры: - Y или 1 - сделка завершена; - N или 0 - сделка не завершена.
Доступен для всех (OPENED):	В данном поле указывается доступность сделки для всех пользователей. Примеры: - Y или 1 - сделка доступна для всех; - N или 0 - сделка с ограниченным доступом.
Пользовательские поля (UF_*):	Пользовательские поля, созданные администратором портала. Тип и формат заполнения зависит от настроек поля в вашем портале. Важно: Названия полей могут отличаться в зависимости от настроек вашего портала. Активити (робот) автоматически создаёт параметры для всех доступных пользовательских полей.

Специальные параметры для работы с товарами:

Название поля	Описание и примеры использования
Ставка НДС (i_tax_rate):	В данном поле можно выбрать ставку налога для всех товаров в сделке. При указании этого параметра активити (робот) автоматически пересчитает цены всех товаров в сделке с учётом НДС. Варианты выбора: - 0% - без НДС; - 5% - ставка НДС 5%; - 7% - ставка НДС 7%; - 10% - ставка НДС 10%; - 20% - ставка НДС 20%. Важно: Изменение ставки налога в этом поле будет работать только если настроено поле "Способ начисления НДС" (i_active_nds). Обязательно укажите способ начисления НДС вместе со ставкой.
Способ начисления НДС (i_active_nds):	В этом поле можно выбрать, как будет начисляться НДС для всех товаров в сделке. При указании этого параметра активити (робот) автоматически пересчитает цены всех товаров в сделке. Варианты выбора: - НДС включён в стоимость - НДС уже учтён в цене товара; - НДС сверху - НДС добавляется к цене товара. Важно: Этот параметр необходимо указывать вместе со ставкой НДС (i_tax_rate) для корректного пересчёта цен товаров.
Тип скидки (discount_type):	В этом поле выбирается тип скидки, которая будет применена ко всем товарам в сделке. При указании этого параметра активити (робот) автоматически пересчитает цены всех товаров в сделке с учётом скидки. Варианты выбора: - Сумма - скидка указывается в денежных единицах (рубли, доллары и т.д.); - Процент - скидка указывается в процентах от стоимости товара. Важно: Этот параметр необходимо указывать вместе с размером скидки (discount_sums) для корректного пересчёта цен товаров.
Размер скидки (discount_sums):	В этом поле указывается размер предоставляемой скидки для всех товаров в сделке. Значение зависит от типа скидки: Примеры: - Если тип скидки "Сумма", укажите размер скидки в денежных единицах: ={1000} (скидка 1000 рублей); - Если тип скидки "Процент", укажите размер скидки в процентах: ={10} (скидка 10%); Важно: Этот параметр необходимо указывать вместе с типом скидки (discount_type) для корректного пересчёта цен товаров.

ВАЖНО! Очистка полей:
Чтобы очистить поля тип "строка", нужно передать пробел в настройках поля, находящегося в БП. Пример: ={ }
Для очистки поля тип "список" и "множественный список" - в настройках поля, находящегося в БП нужно передать кавычки, выглядит это так: =" "
Для очистки поля тип "число", нужно указать в поле ="##".

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

Работа с файлами:
Наше активити (робот) может прикрепить файл к сущности "Сделка", однако только при условии, что будет указан непосредственно ID файла на диске.
Активити (робот) не может перенести файл из одной сущности в другую, для этого используйте штатное активити Б24.

Примеры:
- ={12345} - прикрепить файл с ID 12345 на диске;
- Для множественных файлов используйте массив ID файлов.

Важно о динамических полях:
Активити (робот) автоматически создаёт параметры для всех полей сделки, доступных для редактирования в вашем портале. Помимо описанных выше, могут быть доступны:
- Пользовательские поля (UF_*), созданные администратором;
- Дополнительные поля настроек CRM;
- Специальные поля интеграций.

Некоторые поля недоступны для редактирования через REST API (например, CATEGORY_ID - направление сделки) и не будут отображаться в настройках активити (робота).

Дополнительные параметры активити (робота)

Название поля	Описание и примеры использования
Делать отладочные сообщения в журнал БП:	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени:	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса:	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса:	В данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.
Ожидать ответа:	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения:	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Сценарий работы активити (робота)

Примеры использования активити (робота)

Описание примера	Решение
Пример использования №1 - Автоматическое изменение стадии после события: Необходимо изменить стадию сделки (на стадию AGREEMENT) после подписания договора или выполнения определённого условия. Используется ID текущей сделки из документа ({=Document:ID}).	ID Сделки: {=Document:ID} Стадия сделки: AGREEMENT После успешного выполнения активити (робота) сделка будет переведена на стадию "Согласование". Используйте возвращаемый параметр ID для дальнейших операций.
Пример использования №2 - Назначение ответственного в зависимости от суммы: Необходимо автоматически назначить ответственного менеджера в зависимости от суммы сделки. Если сумма >= 1 000 000, назначается user_50 (директор), если сумма >= 500 000, назначается user_25 (старший менеджер).	Шаг 1 - Получение данных: Используйте активити (робот) "Получение данных Сделки" для получения суммы. Шаг 2 - Изменение с использованием функции if: ID Сделки: {=Document:ID} Ответственный: ={{=if({=Document:OPPORTUNITY} >= 1000000, "user_50", if({=Document:OPPORTUNITY} >= 500000, "user_25", {=Document:ASSIGNED_BY_ID}))}} Функция if проверяет условия по порядку: если сумма >= 1 000 000, назначается user_50 (директор), если сумма >= 500 000, назначается user_25 (старший менеджер), иначе остаётся текущий ответственный из документа.
Пример использования №3 - Обновление вероятности и суммы после переговоров: Необходимо обновить вероятность успешного завершения (75%) и сумму сделки (1 500 000) после переговоров с клиентом. Используется ID текущей сделки из документа.	ID Сделки: {=Document:ID} Вероятность: ={75} Сумма: ={1500000} Активити (робот) обновит оба поля одновременно. Вероятность будет установлена в 75%, а сумма - 1 500 000.
Пример использования №4 - Применение НДС и скидки к товарам сделки: Необходимо применить НДС 20% (способ начисления: НДС сверху) и скидку 10% (тип: процент) ко всем товарам в сделке. Параметры: Ставка НДС - 20%, Способ начисления НДС - НДС сверху, Тип скидки - Процент, Размер скидки - 10.	ID Сделки: {=Document:ID} Ставка НДС: 20% Способ начисления НДС: НДС сверху Тип скидки: Процент Размер скидки: ={10} Активити (робот) автоматически пересчитает цены всех товаров: 1. Применит скидку 10% (уменьшит цену); 2. Добавит НДС 20% сверху к цене со скидкой. Итоговая сумма сделки будет обновлена автоматически.
Пример использования №5 - Массовое изменение сделок через итератор: Необходимо изменить стадию всех найденных сделок в итераторе на стадию CLOSED. Используется ID из итератора ({=Iterator:Value}) для каждой сделки.	Шаг 1 - Поиск сделок: Используйте активити (робот) "Поиск Сделки" для получения массива ID. Шаг 2 - Итерация и изменение: В итераторе для каждого ID: ID Сделки: {=Iterator:Value} Стадия сделки: ={CLOSED} Все сделки из массива будут переведены на стадию "Закрыто".
Пример использования №6 - Синхронизация данных из другой системы: Необходимо обновить данные сделки (Сумма, Вероятность, Дата завершения, Комментарий) на основе информации, полученной из внешней системы через API. Используются переменные из предыдущего активити (робота) (A1988_22222_92566_99999:external_*).	ID Сделки: {=A1988_22222_92566_99999:external_deal_id} Сумма: {=A1988_22222_92566_99999:external_amount} Вероятность: {=A1988_22222_92566_99999:external_probability} Дата завершения: {=A1988_22222_92566_99999:external_deadline} Комментарий: {=A1988_22222_92566_99999:external_comment} Все поля будут обновлены одновременно на основе данных из внешнего источника.
Пример использования №7 - Привязка контактов и компании к сделке: Необходимо связать несколько контактов (ID: 456, 789, 101112) и компанию (ID из документа) с сделкой при её создании или обновлении. Параметры: Компания (111), Контакты (456,789,101112).	ID Сделки: {=Document:ID} Компания: ={111} Контакты: ={456,789,101112} К сделке будут привязаны указанная компания и три контакта. Обратите внимание: поле "Контакты" заменяет все существующие связи, поэтому если нужно добавить контакт к существующим, сначала получите текущие контакты через активити (робот) "Получение данных Сделки".
Пример использования №8 - Обновление дат и назначение напоминаний: Необходимо обновить дату завершения сделки (на 7 дней позже текущей даты) и установить напоминание ответственному. Параметр: Дата завершения (={{=dateadd({=Document:CLOSEDATE}, "7d")}}).	Шаг 1 - Изменение даты: ID Сделки: {=Document:ID} Дата завершения: ={{=dateadd({=Document:CLOSEDATE}, "7d")}} Шаг 2 - Создание напоминания: Используйте возвращаемый ID и поле Ответственный из активити (робота) "Получение данных Сделки" для создания задачи ответственному.
Пример использования №9 - Очистка полей сделки: Необходимо очистить определённые поля сделки: Комментарий и Дополнительная информация. Используется пробел ({ }) для очистки строковых полей.	ID Сделки: {=Document:ID} Комментарий: ={ } (пробел для очистки строкового поля) Дополнительная информация: ={ } (пробел для очистки строкового поля) Оба поля будут очищены. Для очистки поля типа "список" используйте: ={" "} Для очистки числового поля используйте: ={"##"}
Пример использования №10 - Обновление UTM-меток для аналитики: Необходимо обновить информацию о рекламной кампании в сделке для правильной аналитики. Параметры: Рекламная система (google), Тип трафика (cpc), Обозначение рекламной кампании (летняя_распродажа_2025), Содержание кампании (баннер_главная).	ID Сделки: {=Document:ID} Рекламная система: ={google} Тип трафика: ={cpc} Обозначение рекламной кампании: ={летняя_распродажа_2025} Содержание кампании: ={баннер_главная} Все UTM-метки будут обновлены для корректного отслеживания эффективности рекламных кампаний.

Возвращаемые параметры данного активити (робота):
- ID - числовой идентификатор изменённой сделки, который можно использовать для дальнейших операций в бизнес-процессе.

Примеры использования:
- Передать ID в следующее активити (робота) для получения данных сделки;
- Использовать в условиях для проверки успешности изменения;
- Сохранить в переменную для использования в других шагах процесса.

ВАЖНО! Ограничения и рекомендации:

Ограничение по количеству изменений:
Запускать изменение сразу более 1000 сущностей не стоит. Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

Если вы планируете через интегратор произвести изменение более 100 сущностей, то нужно использовать наш модуль массовый БП "Массовый запуск Бизнес-процессов". Настройте бизнес-процесс на использование одной сделки где ID сделки будет браться из той сущности, из которой вы хотите произвести изменения. Потом зайдите в модуль "Массовый БП" отфильтруйте по типу сущности "Сделка" и нужным вам параметрам и активируйте массовый запуск. Наше приложение равномерно распределит нагрузку.

Изменение направления сделки:
Активити (робот) не может изменить направление сделки (CATEGORY_ID), т.к механизм REST Api Б24 не позволяет это делать. Для изменения направления используйте штатное активити Битрикс24 "Смена направления сделки".

Изменение направления и стадии:
НЕЛЬЗЯ изменить одновременно направление и стадию сделки, только поочередно. Сначала измените направление в одном активити (роботе), затем стадию в другом активити (роботе) (или наоборот).

Перенос элементов списка между сущностями:
Если вам нужно перенести элементы поля тип "Список" из одной сущности в другую, к примеру из Компании в Контакт, то просто так это сделать не получится, даже если это одно и то же поле, которое было конвертировано из Лида в любую другую сущность.
ID элементов в поле тип "Список" в каждом типе сущности будут свои.
Т.е для переноса нужно сопоставлять элементы списка в переменной.
Для этого создаётся переменная тип "Список" (множественный/нет зависит от типа поля), и в поле "Варианты значений" указываются все элементы списка которые нужно сопоставить и перенести.
Каждый сопоставленный элемент указывается с новой строки в формате:
[6891] 10671
[6893] 10673
[6895] 10675
Где значение в квадратных скобках - ID элементов списка в поле сущности, в которую будет происходить перенос, а за скобками - из которой.
Перенос осуществляется с заменой значений в том поле, куда переносят.
Если значений в поле А больше, чем в поле Б, то перенесутся только те значения, которые были сопоставлены в переменной.
БП должен запускаться из той сущности, из которой планируется переносить данные, т.е если нужно перенести данные поля тип "Список" из Компании в Контакт, то БП должен запускаться из Компании.

Работа с файлами:
Активити (робот) может прикрепить файл к сущности "Сделка", однако только при условии, что будет указан непосредственно ID файла на диске. Активити (робот) не может перенести файл из одной сущности в другую, для этого используйте штатное активити Б24.

Поля типа "Список":
Поля тип "Список" требуют формата передачи данных для изменения поля "тип список" или "привязка к списку" в виде ID элемента, а не названия. Убедитесь, что вы передаёте корректные ID элементов списка.

Получение данных по сущности: Сделка

Данное активити позволяет получить данные всех полей сущности сделка,при условии,что вы знаете ее ID.

Сценарий работы активити бизнес-процесса

ID сущности: в данном поле указывается ID сущности "сделка", данные которой необходимо получить.

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

Сообщение об ошибке:да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке.
- Все данные полей по сущности Сделка.

Создание сделки с товарами

Активити (робот) "Создание Сделки с товарами" предназначено для использования в роботах и может быть полезно в следующих сценариях:

• Автоматическое создание сделок с заранее определённым набором товаров при выполнении определённых условий;
• Создание сделок на основе данных из других систем или документов с автоматическим добавлением товарных позиций;
• Массовое создание сделок с товарами через бизнес-процессы;
• Автоматизация создания сделок из лидов с товарными позициями;
• Создание сделок с товарами при обработке заказов из интернет-магазина;
• Формирование коммерческих предложений в виде сделок с товарами;
• Дублирование сделок с сохранением товарных позиций для новых клиентов.

Как работает активити (робота):
- Активити (робот) автоматически получает список всех доступных полей сделки из CRM вашего портала;
- Для каждого поля (кроме недоступных для редактирования) создаётся параметр, который можно заполнить при создании сделки;
- Обязательными для заполнения являются только поля "Название" (TITLE) и "Ответственный" (ASSIGNED_BY_ID);
- После создания сделки активити (робот) автоматически добавляет указанные товарные позиции к созданной сделке;
- Формат товаров: ID##количество##ед. измерения##цена##название товара;
- Активити (робот) возвращает ID созданной сделки для использования в дальнейших шагах бизнес-процесса.

Сценарий работы активити (робота) бизнес-процесса

Описание параметров активити (робота)

Обязательные параметры:

Название поля	Описание и примеры использования
Название (TITLE):	Обязательное поле. В данном поле необходимо указать название создаваемой сделки. Примеры: - Договор поставки №123; - ={Договор {=Document:ID}}; - ={Новая сделка от {=System:NowLocal}};
Ответственный (ASSIGNED_BY_ID):	Обязательное поле. В данном поле необходимо указать ответственного за создаваемую сделку. Примеры: - ={user_25} - назначить пользователя с ID 25 (формат: user_ID); - ={25} - также можно указать только ID (активити (робота) автоматически добавит префикс user_); - ={=Document:ASSIGNED_BY_ID} - назначить ответственного из текущего документа; - Используйте условие в бизнес-процессе: если {=Variable:OPPORTUNITY} > 1000000, то назначить user_50. Важно: При выборе сотрудника, в поле "привязка к пользователю" должен быть только его ID без лишних символов и букв (или в формате user_ID). Если пользователь не найден по указанному ID, сделка не будет создана.

Параметры для работы с полями сделки:
Активити (робот) автоматически создаёт параметры для всех полей сделки, доступных для редактирования в вашем портале. Ниже описаны основные и наиболее часто используемые поля. Обратите внимание, что названия полей могут отличаться в зависимости от настроек вашего портала.

Название поля	Описание и примеры использования
Тип (TYPE_ID):	В данном поле можно указать тип создаваемой сделки. Значения берутся из одноимённого справочника CRM. Примеры: - SALE - тип "Продажа"; - COMPLEX - тип "Комплексная сделка"; - Необходимо указывать символьный код типа сделки из настроек CRM. Как узнать символьный код типа сделки: - Перейдите в CRM → Настройки → Типы сделок; - Или используйте активити (робот) для получения типов сделок.
Стадия сделки (STAGE_ID):	В данном поле можно указать стадию создаваемой сделки. Примеры: - NEW - стадия "Новая"; - QUALIFICATION - стадия "Квалификация"; - Необходимо указывать символьный код стадии. Как узнать символьный код стадии: 1. В сделке нужно добавить штатное активити "Изменение документа" или штатное "Изменение стадии"; 2. В этом активити (роботе) выбрать поле "стадия"; 3. Нажать F12 и выбрать инструмент "выбор элемента страницы", и выбрать поле напротив поля "стадия"; 4. Появится расшифровка всех Стадий, выбираете название нужной и прописываете данное название в активити (робот) "Создание Сделки с товарами".
Направление (CATEGORY_ID):	В данном поле можно указать направление создаваемой сделки. Направление сделки указывается в виде ID направления. Примеры: - ={0} - направление по умолчанию (ID 0); - ={=Document:CATEGORY_ID} - использовать направление из текущего документа; Важно: Для корректного указания направления необходимо знать его числовой ID. Используйте активити (робот) "Получение данных Сделки" для получения ID направления существующей сделки.
Вероятность (PROBABILITY):	В данном поле можно указать вероятность заключения сделки в процентах (от 0 до 100). Примеры: - ={50} - установить вероятность 50%; - ={100} - установить вероятность 100% (высокая вероятность успеха); - ={0} - установить вероятность 0% (сделка неактивна).
Сумма (OPPORTUNITY):	В данном поле можно указать предполагаемую сумму создаваемой сделки. Данное поле может заполняться автоматически из товарного раздела, если товары указаны с ценами и количествами. Примеры: - ={100000} - установить сумму 100 000; - ={{={=Variable:AMOUNT} * 1.1}} - установить сумму на основе переменной из предыдущего активити (робота) с увеличением на 10%; Примечание: Если указаны товары с ценами и количествами, сумма сделки может быть рассчитана автоматически на основе товарных позиций.
Валюта расчетов (CURRENCY_ID):	В данном поле можно указать валюту расчётов создаваемой сделки. Значения берутся из одноимённого справочника CRM. Примеры: - RUB - рубли; - USD - доллары США; - EUR - евро. Необходимо указывать символьный код валюты из настроек CRM.
Ставка налога (TAX_VALUE):	В данном поле указывается ставка налога, применяемая к создаваемой сделке (в процентах). Примеры: - ={20} - установить ставку НДС 20%; - ={0} - установить ставку 0% (без НДС);
Компания (COMPANY_ID):	В данном поле можно указать компанию, которая будет привязана к создаваемой сделке. Примеры: - ={123} - привязать компанию с ID 123; - ={=Document:COMPANY_ID} - привязать компанию из текущего документа;
Контакт (CONTACT_ID):	В этом поле указывается ID только одного контакта (устаревшее поле, сохраняется для совместимости). Примеры: - ={456} - привязать контакт с ID 456; - ={=Document:CONTACT_ID} - привязать контакт из текущего документа; Рекомендация: Для работы с несколькими контактами используйте поле "Контакты (CONTACT_IDS)" вместо этого поля.
Контакты (CONTACT_IDS):	В данном поле можно указать контакты, которые будут привязаны к создаваемой сделке. Можно указать несколько ID через запятую или использовать массив значений. Примеры: - ={456,789,101112} - привязать контакты с ID 456, 789 и 101112; - ={=Document:CONTACT_IDS} - использовать массив контактов из документа; - В переменной типа "Множественное значение" указать список ID контактов.
Лид (LEAD_ID):	В данном поле можно указать идентификатор привязанного к создаваемой сделке лида. Примеры: - ={789} - привязать лид с ID 789;
Дата начала (BEGINDATE):	В данном поле можно указать дату начала создаваемой сделки. Примеры: - ={01.01.2025 00:00:00} - установить дату начала; - ={=System:NowLocal} - установить текущую дату и время; - ={=Variable:BEGINDATE} - использовать дату из другой сделки (используйте переменную из предыдущего активити (робота)).
Дата завершения (CLOSEDATE):	В данном поле можно указать предполагаемую дату завершения создаваемой сделки. Примеры: - ={31.12.2025 23:59:59} - установить дату завершения; - ={{=dateadd({=System:NowLocal}, "30d")}} - установить дату на 30 дней позже текущей даты; - Используется для автоматизации контроля сроков и напоминаний.
Источник (SOURCE_ID):	В данном поле указывается источник создаваемой сделки (символьный код источника). Примеры: - WEB - источник "Веб-сайт"; - CALL - источник "Звонок"; - EMAIL - источник "Email"; - Необходимо указывать символьный код источника из настроек CRM.
Дополнительно об источнике (SOURCE_DESCRIPTION):	В этом поле указывается дополнительная информация об источнике. Примеры: - Реклама в Google; - Рекомендация партнёра;
Комментарий (COMMENTS):	В данном поле можно указать комментарий к создаваемой сделке. Примеры: - Важная сделка, требует особого внимания; - ={=Variable:COMMENTS} - скопировать комментарий из другой сделки (используйте переменную из предыдущего активити (робота)); - ={Сделка создана автоматически из лида {=Document:ID}};
Дополнительная информация (ADDITIONAL_INFO):	В данном поле можно указать дополнительную информацию о создаваемой сделке. Примеры: - Специфические требования клиента; - Информация для внутреннего использования;
Рекламная система (UTM_SOURCE):	В данном поле указывается рекламная система в создаваемой сделке (из UTM-меток). Примеры: - google; - yandex; - Используется для анализа эффективности рекламных каналов.
Тип трафика (UTM_MEDIUM):	В данном поле указывается тип трафика в создаваемой сделке (из UTM-меток). Примеры: - cpc; - organic; - banner.
Обозначение рекламной кампании (UTM_CAMPAIGN):	В данном поле указываются обозначения рекламной кампании в создаваемой сделке (из UTM-меток). Примеры: - летняя_распродажа; - новый_год_2025; - Используется для отслеживания эффективности конкретных рекламных кампаний.
Содержание кампании (UTM_CONTENT):	В данном поле указывается содержание кампании в создаваемой сделке (из UTM-меток). Примеры: - баннер_верхний; - текст_ссылка; - Используется для детального анализа эффективности элементов рекламы.
Условие поиска кампании (UTM_TERM):	В данном поле указывается условие поиска кампании в создаваемой сделке (из UTM-меток, обычно ключевое слово). Примеры: - купить_телефон; - доставка_бесплатно; - Помогает анализировать эффективность конкретных ключевых слов в рекламе.
Завершена (CLOSED):	В данном поле указывается статус завершённости создаваемой сделки. Примеры: - Y или 1 - сделка завершена; - N или 0 - сделка не завершена (по умолчанию).
Доступен для всех (OPENED):	В данном поле указывается доступность создаваемой сделки для всех пользователей. Примеры: - Y или 1 - сделка доступна для всех; - N или 0 - сделка с ограниченным доступом (по умолчанию).
Пользовательские поля (UF_*):	Пользовательские поля, созданные администратором портала. Тип и формат заполнения зависит от настроек поля в вашем портале. Важно: Названия полей могут отличаться в зависимости от настроек вашего портала. Активити (робот) автоматически создаёт параметры для всех доступных пользовательских полей.

Специальный параметр для работы с товарами:

Название поля

Описание и примеры использования

Товары (i_products_adds):

Один из самых главных пунктов данного активити (робота). В данный пункт заполняются товарные позиции, которые будут прикреплены к создаваемой сделке. Формат указания товаров: ID##количество##ед. измерения##цена##название товара Параметры формата: - ID - идентификатор товара в каталоге CRM (можно указать 0, если товар ещё не добавлен в каталог); - количество - количество товара (числовое значение); - ед. измерения - единица измерения товара (буквенное обозначение, например: шт, кг, м и т.д.); - цена - цена товара за единицу (числовое значение); - название товара - название товарной позиции (текстовое значение). Примеры заполнения: - 123##10##шт##5000##Ноутбук Dell - товар с ID 123, количество 10 штук, цена 5000 за единицу, название "Ноутбук Dell"; - 0##5##кг##150##Сахар - товар без ID в каталоге (ID=0), количество 5 кг, цена 150 за кг, название "Сахар"; - 456##2##м##1200##Кабель витая пара - товар с ID 456, количество 2 метра, цена 1200 за метр, название "Кабель витая пара". Множественные товары: Для указания нескольких товаров используйте множественное значение (каждый товар в отдельной строке или отдельном элементе массива). Активити (робот) поддерживает параметр с типом "Множественное значение". Примеры для множественных товаров: В переменной типа "Множественное значение" укажите: 123##10##шт##5000##Ноутбук Dell 456##2##м##1200##Кабель витая пара 789##5##шт##800##Мышь компьютерная Важно: - Разделитель между параметрами - двойной символ ## (решетка); - Все параметры обязательны для заполнения, даже если ID товара равен 0; - Цена указывается за единицу измерения товара (не за общее количество); - Если товар не найден в каталоге по указанному ID, будет использовано указанное название товара; - Активити (робот) автоматически добавит товары к сделке после её создания.

Примечание о полях сделки:
Активити (робот) автоматически создаёт параметры для всех полей сделки, доступных для редактирования в вашем портале. Помимо описанных выше, могут быть доступны:
- Пользовательские поля (UF_*), созданные администратором;
- Дополнительные поля настроек CRM;
- Специальные поля интеграций.

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

Дополнительные параметры активити (робота)

Название поля	Описание и примеры использования
Делать отладочные сообщения в журнал БП:	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени:	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса:	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса:	В данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.
Ожидать ответа:	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения:	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается. Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити (робота) и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы активити (робота)

Примеры использования активити (робота)

Описание примера	Решение
Пример использования №1 - Создание сделки с товарами из лида: Необходимо создать сделку на основе данных лида с автоматическим добавлением товарных позиций. Используются данные из текущего документа (лида).	Название: ={Новая сделка от {=Document:TITLE}} Ответственный: {=Document:ASSIGNED_BY_ID} Компания: {=Document:COMPANY_ID} Контакты: {=Document:CONTACT_IDS} Товары: (множественное значение) 123##2##шт##50000##Ноутбук 456##1##шт##15000##Монитор После успешного выполнения активити (робота) будет создана сделка с указанными товарами. Используйте возвращаемый параметр ID сделки для дальнейших операций.
Пример использования №2 - Создание коммерческого предложения с товарами: Необходимо создать сделку типа "Коммерческое предложение" с набором товаров из каталога. Товары передаются через переменную из предыдущего активити (робота).	Название: ={КП для {=Variable:COMPANY_NAME}} Ответственный: ={user_25} Тип: COMPLEX Вероятность: ={30} Товары: {=Variable:PRODUCTS_LIST} Где переменная PRODUCTS_LIST содержит список товаров в формате: 789##10##шт##800##Мышь компьютерная 101##5##шт##2000##Клавиатура Активити (робот) создаст коммерческое предложение с указанными товарами.
Пример использования №3 - Создание сделки из заказа интернет-магазина: Необходимо автоматически создать сделку с товарами при получении заказа из интернет-магазина. Данные заказа передаются через переменные из предыдущего активити (робота) интеграции.	Название: ={Заказ №{=Variable:ORDER_NUMBER}} Ответственный: ={user_50} Сумма: {=Variable:ORDER_TOTAL} Компания: {=Variable:CLIENT_ID} Товары: {=Variable:ORDER_ITEMS} Стадия: NEW Источник: WEB Активити (робот) создаст сделку с товарами из заказа. Переменная ORDER_ITEMS должна содержать товары в формате ID##количество##ед. измерения##цена##название.
Пример использования №4 - Массовое создание сделок через итератор: Необходимо создать сделки с товарами для каждого элемента в итераторе. ID клиента берётся из итератора.	Шаг 1 - Подготовка данных: Используйте активити (робот) "Поиск Сделки" или другой источник для получения массива ID компаний. Шаг 2 - Создание сделок в итераторе: Для каждого ID компании: Название: ={Сделка для компании {=Iterator:Value}} Ответственный: ={user_25} Компания: {=Iterator:Value} Товары: (одинаковый набор для всех) 123##5##шт##10000##Товар 1 456##3##шт##5000##Товар 2 Для каждой компании будет создана сделка с указанными товарами.
Пример использования №5 - Создание сделки с товарами без ID в каталоге: Необходимо создать сделку с товарами, которые ещё не добавлены в каталог CRM. В этом случае ID товара указывается как 0.	Название: ={Специальное предложение} Ответственный: ={user_25} Товары: (ID = 0, товар не в каталоге) 0##1##шт##50000##Индивидуальный продукт 0##2##шт##15000##Кастомное решение Активити (робот) создаст сделку с товарами, указав их названия. ID товаров будет 0, что означает, что товары не привязаны к каталогу.
Пример использования №6 - Создание сделки с расчётом суммы из товаров: Необходимо создать сделку с товарами, сумма которой будет рассчитана автоматически на основе цен и количеств товаров.	Название: ={Сделка с автоматическим расчётом} Ответственный: ={user_25} Валюта: RUB Товары: 123##10##шт##5000##Ноутбук Dell (итого: 50 000) 456##5##шт##2000##Мышь (итого: 10 000) 789##2##шт##8000##Клавиатура (итого: 16 000) Примечание: Сумма сделки может быть рассчитана автоматически на основе товаров (10×5000 + 5×2000 + 2×8000 = 76 000) или указана вручную в поле "Сумма".
Пример использования №7 - Создание сделки с UTM-метками и товарами: Необходимо создать сделку с товарами и информацией о рекламной кампании для аналитики эффективности рекламы.	Название: ={Сделка из рекламы} Ответственный: ={user_30} Рекламная система: ={google} Тип трафика: ={cpc} Обозначение рекламной кампании: ={летняя_распродажа_2025} Товары: 123##1##шт##75000##Ноутбук Premium Активити (робот) создаст сделку с товаром и UTM-метками для отслеживания эффективности рекламной кампании.
Пример использования №8 - Дублирование сделки с товарами: Необходимо создать копию существующей сделки с теми же товарами для нового клиента. Данные берутся из активити (робота) "Получение данных Сделки".	Шаг 1 - Получение данных: Используйте активити (робот) "Получение данных Сделки" для получения всех данных сделки и товаров. Шаг 2 - Создание новой сделки: Название: ={Копия {=Variable:TITLE}} Ответственный: {=Variable:ASSIGNED_BY_ID} Тип: {=Variable:TYPE_ID} Вероятность: {=Variable:PROBABILITY} Компания: {=Variable:NEW_COMPANY_ID} (новая компания) Товары: {=Variable:PRODUCTS} (товары из исходной сделки) Будет создана новая сделка с теми же товарами, но для другой компании. Необходимо предварительно преобразовать данные товаров из формата активити (робота) "Получение данных Сделки" в формат активити (робота) "Создание Сделки с товарами".
Пример использования №9 - Создание сделки с товарами разных единиц измерения: Необходимо создать сделку с товарами, имеющими разные единицы измерения (штуки, килограммы, метры).	Название: ={Смешанный заказ} Ответственный: ={user_25} Товары: 123##10##шт##5000##Ноутбуки (10 штук) 456##50##кг##150##Сахар (50 килограмм) 789##100##м##80##Кабель (100 метров) Активити (робот) создаст сделку с товарами, имеющими разные единицы измерения. Каждый товар будет отображён с указанной единицей измерения.
Пример использования №10 - Создание сделки с условием на основе суммы товаров: Необходимо создать сделку с товарами и автоматически назначить ответственного в зависимости от общей суммы товаров.	Шаг 1 - Подготовка: Рассчитайте общую сумму товаров в переменной или используйте функцию суммирования. Шаг 2 - Создание с условием: Название: ={Крупная сделка} Ответственный: ={{=if({=Variable:TOTAL_AMOUNT} >= 1000000, "user_50", if({=Variable:TOTAL_AMOUNT} >= 500000, "user_25", "user_10"))}} Товары: {=Variable:PRODUCTS} Функция if проверяет общую сумму: если >= 1 000 000, назначается user_50 (директор), если >= 500 000, назначается user_25 (старший менеджер), иначе user_10 (менеджер).

Возвращаемые параметры данного активити (робота):
- ID сделки - числовой идентификатор созданной сделки, который можно использовать для дальнейших операций в бизнес-процессе;

Примеры использования:
- Передать ID в следующее активити (робота) для получения данных сделки;
- Использовать в условиях для проверки успешности создания;
- Сохранить в переменную для использования в других шагах процесса;
- Использовать для связи созданной сделки с другими сущностями CRM.

ВАЖНО! Ограничения и рекомендации:

Ограничение по количеству созданий:
Запускать создание сразу более 1000 сущностей не стоит. Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

Если вы планируете через интегратор произвести создание более 100 сущностей, то нужно использовать наш модуль массовый БП "Массовый запуск Бизнес-процессов". Настройте бизнес-процесс на использование одной сделки где данные будут браться из той сущности, из которой вы хотите произвести создания. Потом зайдите в модуль "Массовый БП" отфильтруйте по типу сущности "Сделка" и нужным вам параметрам и активируйте массовый запуск. Наше приложение равномерно распределит нагрузку.

Формат товаров:
Строго соблюдайте формат указания товаров: ID##количество##ед. измерения##цена##название товара. Разделитель - двойной символ ## (решетка). Все параметры обязательны для заполнения. Если товар не найден в каталоге по ID, будет использовано указанное название товара.

Обязательные поля:
Для успешного создания сделки обязательно должны быть заполнены поля "Название" (TITLE) и "Ответственный" (ASSIGNED_BY_ID). Без них активити (робот) не сможет создать сделку и вернёт ошибку.

Товары без ID в каталоге:
Если товар ещё не добавлен в каталог CRM, укажите ID = 0. В этом случае товар будет создан с указанным названием без привязки к каталогу. Рекомендуется добавлять товары в каталог заранее для корректной работы аналитики и отчётов.

Цена товара:
Цена указывается за единицу измерения товара, а не за общее количество. Например, если товар стоит 100 рублей за штуку, и количество 10 штук, то указывайте: ID##10##шт##100##Название. Общая стоимость товара будет рассчитана автоматически (10 × 100 = 1000).

Поля типа "Список":
Поля тип "Список" требуют формата передачи данных для изменения поля "тип список" или "привязка к списку" в виде ID элемента, а не названия. Убедитесь, что вы передаёте корректные ID элементов списка.

Работа с файлами:
Наше активити (робот) может прикрепить файл к создаваемой сделке, однако только при условии, что будет указан непосредственно ID файла на диске. Активити (робот) не может перенести файл из одной сущности в другую, для этого используйте штатное активити Б24.

Поиск Сделки (v.2)

Данное активити позволяет искать "Сделку" или "Сделки" по выбранным в настройках полям. Результатом работы является получение списка ID найденных сделок.
Активити динамически поддерживает все поля сделки, доступные в вашем портале Битрикс24, что позволяет искать сделки по любым критериям. Результатом работы является получение ID сделок в виде массива для итератора и строки, а также количество найденных элементов и их соответствие условиям поиска.

Активити "Поиск Сделки" предназначено для использования в роботах и бизнес-процессах и может быть полезно в следующих сценариях:

• Поиск сделок по определённым критериям для массовых операций (изменение стадии, назначение ответственного, обновление полей);
• Фильтрация сделок для создания отчётов и аналитики;
• Автоматический поиск связанных сделок при работе с другими сущностями CRM;
• Поиск дубликатов сделок для очистки базы данных;
• Поиск сделок по датам для автоматизации напоминаний и контроля сроков;
• Фильтрация сделок по ответственным для распределения нагрузки или отчётов;
• Поиск сделок по рекламным кампаниям для анализа эффективности маркетинга;
• Поиск сделок в определённых стадиях для автоматизации бизнес-процессов.

Как работает активити:
- Активити автоматически получает список всех доступных полей сделки из CRM вашего портала;
- Для каждого поля создаётся параметр поиска, который можно заполнить для фильтрации;
- Рядом с каждым полем создаётся дополнительное поле "Условие поиска" для выбора оператора сравнения;
- Можно комбинировать несколько полей для более точного поиска;
- Поиск выполняется по принципу "И" (AND) - все указанные условия должны выполняться одновременно.

Сценарий работы активити бизнес-процесса

Описание параметров активити

Основные параметры поиска:

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

Название поля	Описание и примеры использования
ID:	В данном поле указывается числовой идентификатор искомой сделки. Примеры: - ={123} - найти сделку с ID равным 123; - ={={=Document:ID}} - найти сделку с ID из текущего документа; - ={!123} - найти все сделки, кроме сделки с ID 123.
Заголовок (TITLE):	Позволяет указать заголовок искомой сделки. Поддерживает поиск по частичному совпадению. Примеры: - ={%договор} - найти все сделки, в заголовке которых содержится слово "договор"; - ={Договор поставки №123} - найти сделку с точным заголовком; - ={!%архив} - найти все сделки, в заголовке которых нет слова "архив".
Название:	Позволяет указать название искомой сделки. Обычно совпадает с заголовком или является его синонимом в зависимости от настроек портала. Примеры: - ={%поставка} - найти сделки с "поставка" в названии; - ={Поставка оборудования} - точное совпадение названия.
Тип (TYPE_ID):	В данном поле указывается тип сделки из настроек CRM. Типы сделок настраиваются администратором портала и могут быть различными для разных порталов. Примеры: - ={SALE} - найти сделки типа "Продажа"; - ={COMPLEX} - найти сделки типа "Комплексная сделка"; - Для поиска по типу необходимо знать символьный код типа сделки из настроек CRM. Как узнать символьный код типа сделки: - Перейдите в CRM → Настройки → Типы сделок; - Или используйте активити для получения типов сделок; - Символьный код обычно совпадает с символьным кодом в настройках портала.
Стадии сделки (STAGE_ID):	В данных полях выбираются стадии для искомой сделки. Название этого поля может быть иным, т.к. оно привязывается к названию стадий сделок на вашем портале. Важно: - Можно выбрать несколько дополнительных стадий, зажав Ctrl + кликнув по нужным стадиям; - Таких полей может быть ровно столько, сколько основных стадий сделок вы создали; - Каждое поле соответствует одной основной стадии и позволяет выбрать подстадии этой стадии. Примеры: - Выберите стадию "Квалификация" - будут найдены все сделки на этой стадии или её подстадиях; - Выберите несколько стадий из группы "Сделка в работе" - найдутся сделки на любой из выбранных стадий.
Группа стадии (STAGE_SEMANTIC_ID):	В данном поле указывается направление, в котором находится искомая сделка, с помощью символьного кода группы стадии. Основные группы стадий: - P - "Сделка в работе" (Process); - S - "Сделка заключена" (Success); - F - "Сделка провалена" (Failed). Как получить символьный код группы стадии: Перейдите в раздел CRM → Сделки; Выберите "Фильтр+поиск" и добавьте фильтр "Группа стадий"; Нажмите F12 (открыть инструменты разработчика); Селектором элементов выберите поле фильтра "Группа стадий"; Во вкладке Elements будет выделена строка с подобным содержимым: [{"NAME":"Группа стадий \"Сделка в работе\"","VALUE":"P"},{"NAME":"Стадия \"Сделка заключена\"","VALUE":"S"},{"NAME":"Группа стадий \"Сделка провалена\"","VALUE":"F"}] Значения VALUE и есть нужный символьный код. Пример использования: Для поиска всех сделок в работе в поле "Группа стадии" укажите: P Для поиска успешно закрытых сделок укажите: S Для поиска проваленных сделок укажите: F
Вероятность (PROBABILITY):	В данном поле указывается уровень вероятности успешной сделки (в процентах от 0 до 100). Примеры: - ={50} - найти сделки с вероятностью 50%; - ={>=75} - найти сделки с вероятностью 75% и выше; - ={={{20}}##{{60}}} - найти сделки с вероятностью от 20% до 60%; - Используйте операторы сравнения для поиска по диапазонам.
Сумма (OPPORTUNITY):	В данном поле указывается сумма искомой сделки. Можно указывать как целые числа, так и десятичные дроби. Примеры: - ={100000} - найти сделки с суммой 100 000; - ={>500000} - найти сделки с суммой больше 500 000; - ={={{100000}}##{{500000}}} - найти сделки с суммой от 100 000 до 500 000; - ={<=10000} - найти сделки с суммой не более 10 000.
Ставка налога (TAX_VALUE):	В данном поле указывается ставка налога для искомой сделки (в процентах). Примеры: - ={20} - найти сделки со ставкой налога 20%; - ={0} - найти сделки без налога (ставка 0%); - ={!0} - найти все сделки с ненулевой ставкой налога.
Комментарий (COMMENTS):	В данном поле указывается текст комментария для искомой сделки. Поддерживает поиск по частичному совпадению. Примеры: - ={%срочно} - найти сделки, в комментариях которых содержится слово "срочно"; - ={!%архив} - найти сделки, в комментариях которых нет слова "архив".
Дата создания (DATE_CREATE):	В данном поле указывается дата создания искомой сделки. Поддерживает поиск по точной дате и диапазонам дат. Примеры: - ={={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}}} - найти сделки, созданные в январе 2025 года; - ={>={{01.01.2025 00:00:00}}} - найти сделки, созданные после 1 января 2025 года; - Для полей типа "дата" и "дата/время" при поиске диапазона используйте формат: ={{дата начала}}##{{дата окончания}}.
Дата изменения (DATE_MODIFY):	В данном поле указывается дата изменения искомой сделки. Примеры: - ={={{01.03.2025 00:00:00}}##{{31.03.2025 23:59:59}}} - найти сделки, изменённые в марте 2025 года; - ={>={{15.03.2025 00:00:00}}} - найти сделки, изменённые после 15 марта 2025 года.
Ответственный (ASSIGNED_BY_ID):	В данном поле указывается ответственный за сделку. Можно указать ID пользователя или использовать переменные. Примеры: - ={25} - найти сделки, за которые отвечает пользователь с ID 25; - ={[U25]} - альтернативный формат указания пользователя; - ={={=Document:ASSIGNED_BY_ID}} - найти сделки текущего ответственного из документа; - Для пользователей поддерживаются все стандартные операторы сравнения.
Дополнительно об источнике (SOURCE_DESCRIPTION):	В данном поле указываются дополнительные сведения об источнике в искомой сделке. Примеры: - ={%реклама} - найти сделки, в источнике которых есть слово "реклама"; - Используйте поиск по частичному совпадению для текстовых полей.
Дата начала (BEGINDATE):	В данном поле указывается дата начала искомой сделки. Поддерживает поиск по точной дате и диапазонам дат. Примеры: - ={={{01.01.2025 00:00:00}}##{{31.12.2025 23:59:59}}} - найти сделки с датой начала в 2025 году; - ={>={{01.01.2025 00:00:00}}} - найти сделки, которые начались после 1 января 2025 года; - Для полей типа "дата" и "дата/время" при поиске диапазона используйте формат: ={{дата начала}}##{{дата окончания}}.
Внешний источник (SOURCE_ID):	В данном поле указывается внешний источник в искомой сделке (символьный код источника). Примеры: - ={WEB} - найти сделки из источника "Веб-сайт"; - ={CALL} - найти сделки из источника "Звонок"; - Необходимо знать символьные коды источников из настроек CRM.
Идентификатор элемента во внешнем источнике (ORIGIN_ID):	В данном поле указывается идентификатор элемента во внешнем источнике искомой сделки. Используется для интеграций с внешними системами. Примеры: - ={EXT123456} - найти сделку по внешнему идентификатору; - Используется при синхронизации с внешними CRM или системами учёта.
Рекламная система (UTM_SOURCE):	В данном поле указывается рекламная система в искомой сделке (из UTM-меток). Примеры: - ={%google} - найти сделки из рекламной системы Google; - ={%yandex} - найти сделки из рекламной системы Yandex; - Используется для анализа эффективности рекламных каналов.
Тип трафика (UTM_MEDIUM):	В данном поле указывается тип трафика в искомой сделке (из UTM-меток). Примеры: - ={%cpc} - найти сделки с типом трафика "cost per click"; - ={%organic} - найти сделки с органическим трафиком; - Помогает анализировать источники привлечения клиентов.
Обозначение рекламной кампании (UTM_CAMPAIGN):	В данном поле указываются обозначения рекламной кампании в искомой сделке (из UTM-меток). Примеры: - ={%летняя} - найти сделки из кампании "летняя распродажа"; - Используется для отслеживания эффективности конкретных рекламных кампаний.
Содержание кампании (UTM_CONTENT):	В данном поле указывается содержание кампании в искомой сделке (из UTM-меток). Примеры: - ={%баннер} - найти сделки, пришедшие по баннерной рекламе; - Используется для детального анализа эффективности элементов рекламы.
Условие поиска кампании (UTM_TERM):	В данном поле указывается условие поиска кампании в искомой сделке (из UTM-меток, обычно ключевое слово). Примеры: - ={%купить} - найти сделки по ключевому слову "купить"; - Помогает анализировать эффективность конкретных ключевых слов в рекламе.
Направление (CATEGORY_ID):	В данном поле указывается идентификатор направления сделки. Направления настраиваются администратором портала. Если не указано, то сделка принадлежит к общему направлению. Примеры: - ={0} - найти сделки в общем направлении; - ={5} - найти сделки в направлении с ID 5; - ={!0} - найти все сделки, которые не в общем направлении.
Новая сделка (IS_NEW):	В данном поле указывается флаг новой сделки (сделки в первой стадии). Примеры: - ={Y} - найти новые сделки; - ={N} - найти не новые сделки; - Используется для фильтрации по стадиям сделок.
Шаблон регулярной сделки (IS_RECURRING):	В данном поле указывается флаг шаблона регулярной сделки. Если значение Y, то это шаблон, а не обычная сделка. Примеры: - ={Y} - найти шаблоны регулярных сделок; - ={N} - найти обычные сделки (исключить шаблоны).
Повторный лид (IS_RETURN_CUSTOMER):	В данном поле указывается признак повторного лида. Примеры: - ={Y} - найти сделки с повторными лидами; - ={N} - найти сделки с первичными лидами.
Повторное обращение (IS_REPEATED_APPROACH):	В данном поле указывается признак повторного обращения. Примеры: - ={Y} - найти сделки с повторными обращениями; - ={N} - найти сделки с первичными обращениями.
Валюта (CURRENCY_ID):	В данном поле указывается идентификатор валюты сделки. Примеры: - ={RUB} - найти сделки в рублях; - ={USD} - найти сделки в долларах США; - ={EUR} - найти сделки в евро; - Для поиска по валюте необходимо знать символьный код валюты из настроек CRM.
Ручная сумма (IS_MANUAL_OPPORTUNITY):	В данном поле указывается признак того, что сумма сделки установлена вручную. Примеры: - ={Y} - найти сделки с суммой, установленной вручную; - ={N} - найти сделки с автоматически рассчитанной суммой.
Компания (COMPANY_ID):	В данном поле указывается идентификатор привязанной к сделке компании. Примеры: - ={123} - найти сделки, привязанные к компании с ID 123; - ={={=Document:COMPANY_ID}} - найти сделки текущей компании из документа; - ={!0} - найти все сделки, у которых привязана компания.
Контакт (CONTACT_ID):	В данном поле указывается идентификатор привязанного к сделке контакта. Устаревшее поле, сохраняется для совместимости. Рекомендуется использовать связанные контакты через другие методы. Примеры: - ={456} - найти сделки, привязанные к контакту с ID 456; - ={={=Document:CONTACT_ID}} - найти сделки текущего контакта из документа.
Дата завершения (CLOSEDATE):	В данном поле указывается дата завершения искомой сделки. Поддерживает поиск по точной дате и диапазонам дат. Примеры: - ={={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}}} - найти сделки, завершённые в январе 2025 года; - ={<={=System:NowLocal}} - найти сделки с просроченной датой завершения; - ={>={{01.01.2025 00:00:00}}} - найти сделки, которые должны завершиться после 1 января 2025 года.
Доступен для всех (OPENED):	В данном поле указывается доступность сделки для всех пользователей. Примеры: - ={Y} - найти сделки, доступные для всех; - ={N} - найти сделки с ограниченным доступом.
Завершена (CLOSED):	В данном поле указывается статус завершённости сделки. Примеры: - ={Y} - найти завершённые сделки; - ={N} - найти незавершённые сделки.
Создано пользователем (CREATED_BY_ID):	В данном поле указывается идентификатор пользователя, создавшего сделку. Примеры: - ={25} - найти сделки, созданные пользователем с ID 25; - ={={=User:ID}} - найти сделки, созданные текущим пользователем; - Используется для фильтрации по автору создания сделки.
Изменено пользователем (MODIFY_BY_ID):	В данном поле указывается идентификатор пользователя, который последним изменял сделку. Примеры: - ={30} - найти сделки, изменённые пользователем с ID 30; - Используется для отслеживания последней активности по сделке.
Перемещено пользователем (MOVED_BY_ID):	В данном поле указывается идентификатор пользователя, который переместил сделку на текущую стадию. Примеры: - ={35} - найти сделки, перемещённые на текущую стадию пользователем с ID 35; - Используется для анализа переходов между стадиями.
Дата перемещения (MOVED_TIME):	В данном поле указывается дата перемещения сделки на текущую стадию. Примеры: - ={={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}}} - найти сделки, перемещённые на текущую стадию в январе 2025 года; - ={>={{01.01.2025 00:00:00}}} - найти сделки, перемещённые после 1 января 2025 года.
Дополнительная информация (ADDITIONAL_INFO):	В данном поле указывается дополнительная информация об искомой сделке. Текстовое поле. Примеры: - ={%важно} - найти сделки, в дополнительной информации которых содержится слово "важно"; - Используйте поиск по частичному совпадению для текстовых полей.
Лид (LEAD_ID):	В данном поле указывается идентификатор привязанного к сделке лида. Примеры: - ={789} - найти сделки, привязанные к лиду с ID 789; - ={={=Document:LEAD_ID}} - найти сделки текущего лида из документа; - Используется для поиска сделок по связанным лидам.
Местоположение (LOCATION_ID):	В данном поле указывается местоположение клиента. Служебное поле, не рекомендуется к использованию. Примеры: - ={1} - найти сделки с местоположением ID 1; - Используется редко, так как является служебным полем.
Источник данных (ORIGINATOR_ID):	В данном поле указывается идентификатор источника данных. Используется только для привязки к внешнему источнику. Примеры: - ={EXT_SYSTEM} - найти сделки из внешней системы с идентификатором "EXT_SYSTEM"; - Используется при интеграциях с внешними CRM или системами учёта.
Последняя активность пользователем (LAST_ACTIVITY_BY):	В данном поле указывается идентификатор пользователя, ответственного за последнюю активность в сделке. Примеры: - ={40} - найти сделки, где последняя активность была от пользователя с ID 40; - Используется для анализа активности по сделкам.
Время последней активности (LAST_ACTIVITY_TIME):	В данном поле указывается время последней активности в сделке. Примеры: - ={={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}}} - найти сделки с активностью в январе 2025 года; - ={<={=System:NowLocal}} - найти сделки, где активность была недавно.

Важно о динамических полях:
Активити автоматически создаёт параметры для всех полей сделки, доступных в вашем портале. Помимо описанных выше, могут быть доступны:
- Пользовательские поля (UF_*), созданные администратором;
- Связанные сущности (контакты, компании, лиды);
- Дополнительные поля настроек CRM;
- Специальные поля интеграций.

Для каждого поля поиска рядом создаётся дополнительное поле "Условие поиска" (например, "Заголовок - условие поиска"), которое позволяет выбрать оператор сравнения:
- Равно (=) или = (по умолчанию)
- Не равно (!) или !=
- Больше или равно (>=)
- Меньше или равно (<=)
- Больше (>)
- Меньше (<)
- Содержит (%) - LIKE (поиск по подстроке)
- Не содержит (!%)
- IN (@) - входит в список значений
- NOT IN (!@) - не входит в список значений
- LIKE с позицией (=% или %=) - поиск с явным указанием позиции подстроки

Примечание: Доступность операторов зависит от типа поля. Некоторые операторы (например, LIKE) могут быть недоступны для полей типа перечисления (enumeration), стадий (crm_status) и связанных сущностей.

Символы и операторы поиска

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


={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример: ={%груша} - вернёт все ID сделок, в которых, в выбранном вами поле, содержится слово "груша".
Дополнительный пример: ={%договор} - найдёт все сделки с "договор" в заголовке, комментарии или другом текстовом поле.

={!%ваше значение} - не содержит.
Пример: ={!%123} - это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).
Дополнительный пример: ={!%архив} - найдёт все сделки, в которых нет слова "архив".

={ваше значение} - равно (точное совпадение).
Пример: ={123} - это значит, что значение в выбранном поле равно 123 (только для полей типа "строка" и "число").
Пример: ={Договор поставки} - найдёт только сделки с точно таким заголовком (регистр имеет значение).

Важно: Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдёте.

={!ваше значение} - не равно.
Пример: ={!123} - это значит, что значение в выбранном поле не равно 123 (только для полей типа "строка" и "число").
Дополнительный пример: ={!0} - найдёт все сделки с ненулевой суммой.

={>ваше значение} - больше.
Пример: ={>123} - это значит, что значение в выбранном поле больше 123 (только для поля тип "число").
Дополнительный пример: ={>500000} - найдёт все сделки с суммой больше 500 000 рублей.

={<ваше значение} - меньше.
Пример: ={<123} - это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").
Дополнительный пример: ={<10000} - найдёт все сделки с суммой меньше 10 000 рублей.

={>=ваше значение} - больше или равно.
Пример: ={>=123} - это значит, что значение в поле больше или равно 123 (только для поля тип "число").
Дополнительный пример: ={>=75} - найдёт все сделки с вероятностью 75% и выше.

={<=ваше значение} - меньше или равно.
Пример: ={<=123} - это значит, что значение в поле меньше или равно 123 (только для поля тип "число").
Дополнительный пример: ={<=10000} - найдёт все сделки с суммой не более 10 000 рублей.

={@массив значений} - IN (входит в список). В качестве значения передаётся массив значений, одно из которых должно совпадать с полем.
Пример: ={@{123,456,789}} - найдёт все сделки, у которых ID равен 123, 456 или 789.
Дополнительный пример: ={@{WEB,CALL,EMAIL}} - найдёт все сделки из источников "Веб-сайт", "Звонок" или "Email".

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

={!@массив значений} - NOT IN (не входит в список). В качестве значения передаётся массив значений, ни одно из которых не должно совпадать с полем.
Пример: ={!@{123,456}} - найдёт все сделки, у которых ID не равен 123 и не равен 456.
Дополнительный пример: ={!@{F}} - найдёт все сделки, которые не находятся в группе стадий "Провалена" (исключает проваленные сделки).

={%ваше значение} - LIKE (поиск по подстроке). Ищет значение в любой позиции строки. Символ % в значении фильтра передавать не нужно - он применяется автоматически.
Пример: ={%договор} - найдёт все сделки, в которых содержится слово "договор" в любой позиции строки.
Дополнительный пример: ={%123} - найдёт все сделки, в которых в любом месте встречается "123".
Важно: Этот оператор работает аналогично поиску "содержит", но является более явным указанием типа поиска LIKE.

={=значение с %} - LIKE (поиск по подстроке с явным указанием позиции). Символ % нужно передавать в значении для контроля позиции поиска.
Примеры:
- ={=мол%} - найдёт все значения, начинающиеся с "мол" (например: "молоко", "молния");
- ={=%мол} - найдёт все значения, заканчивающиеся на "мол" (например: "мол", "армол");
- ={=%мол%} - найдёт все значения, где "мол" может быть в любой позиции с любыми символами до и после (аналогично простому ={%мол}).
Важно: Используйте этот оператор, когда нужно точно контролировать позицию искомой подстроки в строке. Символ % означает "любые символы" в SQL-подобном синтаксисе LIKE. Помещайте % в нужное место значения: в начале для поиска окончания, в конце для поиска начала, с обеих сторон для поиска в любой позиции.

={%=значение с %} - LIKE (аналогично =%). Альтернативный синтаксис для поиска с явным указанием позиции.
Примеры:
- ={%=мол%} - найдёт все значения, начинающиеся с "мол";
- ={%=%мол} - найдёт все значения, заканчивающиеся на "мол";
- ={%=%мол%} - найдёт все значения, где "мол" может быть в любой позиции.
Примечание: Операторы =% и %= работают идентично, используйте тот, который вам удобнее. Оба требуют явного указания символа % в значении для контроля позиции поиска.

={=ваше значение} - равно (точное совпадение, используется по умолчанию). Явное указание оператора равенства.
Пример: ={=123} - найдёт только сделки с точным значением 123 (эквивалентно ={123}).
Примечание: Если оператор не указан, по умолчанию используется оператор равенства (=).

={!=ваше значение} - не равно. Альтернативный синтаксис для оператора "не равно".
Пример: ={!=123} - найдёт все сделки, значение которых не равно 123 (эквивалентно ={!123}).
Примечание: Операторы != и ! работают идентично, используйте тот, который вам удобнее.

Важные ограничения для операторов LIKE:
Фильтр LIKE (операторы %, =%, %=) не работает с полями следующих типов:
- crm_status (стадии сделок, например поле STAGE_ID);
- crm_contact (связанные контакты);
- crm_company (связанные компании);
- TYPE_ID (тип сделки) и другие поля типа перечисления (enumeration).

Для этих полей используйте только операторы:
- = (равно) - для точного совпадения;
- != или ! (не равно) - для исключения значений;
- @ (IN) - для поиска по списку значений;
- !@ (NOT IN) - для исключения списка значений.

Особое ограничение - поле CONTACT_IDS:
Фильтр не поддерживает поле CONTACT_IDS (идентификаторы связанных контактов).

Для фильтрации сделок по контактам используйте альтернативные методы:
- Используйте активити для работы с контактами, а затем связывайте их со сделками;
- Используйте метод crm.item.list через другие активити для более сложных связей;
- Фильтруйте сделки по другим связанным полям (например, через поле "Контакт" если оно доступно).

Список доступных полей для фильтрации:
Полный список всех доступных полей для фильтрации сделок можно узнать с помощью метода crm.deal.fields.

Активити автоматически создаёт параметры для всех полей, доступных через этот метод в вашем портале.
Если поле не отображается в настройках активити, значит оно либо недоступно для фильтрации, либо имеет ограничения.

Особенности для полей даты и времени:
Если поле не является строкой (число, дата, дата/время), то содержимое ячейки должно заполняться так: ={>=14.03.2020 15:10}, в фигурных скобках указывается необходимый оператор и значение.

Использование переменных:
В случае с переменной, содержимое ячейки должно заполняться так: ={>={=A1988_22222_92566_99999:search_results}} - сначала оператор, затем переменная в фигурных скобках.

Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:
={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}
Первая дата в двойных фигурных скобках - начало диапазона, вторая - конец диапазона, разделённые символами ##.
Пример: ={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}} - найдёт все сделки, созданные в январе 2025 года.

Дополнительные параметры активити

Название поля	Описание и примеры использования
Делать отладочные сообщения в журнал БП:	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени:	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса:	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса:	В данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.
Ожидать ответа:	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения:	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Примеры использования активити

Описание примера	Решение
Пример использования №1 - Поиск крупных сделок в работе: Необходимо найти все сделки на стадии "В работе" с суммой больше 500 000 рублей. Результат можно использовать для отправки уведомлений менеджерам или автоматического повышения приоритета.	Группа стадии: P (Сделка в работе) Сумма: ={>500000}
Пример использования №2 - Поиск сделок за период: Найти все сделки, созданные в январе 2025 года с вероятностью выше 50%. Результат можно использовать для формирования отчёта или массовой рассылки.	Дата создания: ={{01.01.2025 00:00:00}}##{{31.01.2025 23:59:59}} Вероятность: ={>50}
Пример использования №3 - Поиск сделок конкретного менеджера: Найти все незакрытые сделки определённого менеджера. Можно использовать для контроля работы менеджера или распределения задач.	Ответственный: ={25} (ID менеджера) Группа стадии: P (Сделка в работе)
Пример использования №4 - Поиск сделок по рекламной кампании: Найти все сделки из конкретной рекламной кампании. Результат можно использовать для анализа эффективности кампании и ROI.	Обозначение рекламной кампании: ={%летняя_распродажа} Рекламная система: ={%google}
Пример использования №5 - Поиск сделок с просроченными сроками: Найти все сделки, которые должны были закрыться, но ещё не закрыты. Результат можно использовать для автоматического создания задач на контроль или напоминаний.	Дата завершения (CLOSEDATE): ={<={=System:NowLocal}} Группа стадии: P (Сделка в работе)
Пример использования №6 - Поиск сделок по списку источников (оператор IN @): Найти все сделки из определённых источников для анализа эффективности каналов привлечения. Дополнительный пример: Поиск сделок по списку ID.	Внешний источник (SOURCE_ID): ={@{WEB,CALL,EMAIL,REFERRAL}} Группа стадии: P (Сделка в работе) ID: ={@{123,456,789,101112}}
Пример использования №7 - Исключение проваленных сделок (оператор NOT IN !@): Найти все активные сделки, исключая проваленные и закрытые. Результат можно использовать для формирования отчётов только по активным сделкам. Дополнительный пример: Исключить сделки определённых типов.	Группа стадии: ={!@{F}} (исключить группу "Провалена") Группа стадии: ={!@{S}} (исключить группу "Заключена") Или комбинированно: Группа стадии: ={P} (только "В работе") Тип: ={!@{SALE,COMPLEX}}
Пример использования №8 - Поиск сделок с уточнением позиции подстроки (оператор =%): Найти все сделки, названия которых начинаются с определённого префикса. Используется для систематизации и организации сделок с определённой нумерацией или префиксами. Дополнительный пример: Поиск сделок с конкретным окончанием.	Заголовок: ={=ДОГОВОР%} Найдёт все сделки, заголовок которых начинается с "ДОГОВОР" (например: "ДОГОВОР-123", "ДОГОВОР поставки") Комментарий: ={=%готово} Найдёт все сделки, в комментариях которых есть "готово" в конце строки.

Возвращаемые параметры данного активити:
- Результат поиска (массив для итератора) (search_results_array) - массив ID найденных сделок, который можно использовать в итераторах для обработки каждой сделки отдельно;
- Результат поиска (строка) (search_results_string) - строка с ID найденных сделок, разделённых запятыми (например: "123,456,789");
- Количество найденных элементов (count_search) - числовое значение, указывающее сколько сделок было найдено;
- Соответствие условиям поиска (math_search_results) - значение "Y" (найдены результаты) или "N" (результатов не найдено), можно использовать для условий ветвления;
- Сообщение об ошибке (s_error_logs) - текст с описанием результатов поиска или ошибки выполнения.

Важно о возвращаемых параметрах:
Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделённых запятыми работать не будут, так как параметр ждёт только одно число.

Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, т.к. данный параметр предназначен для полей с типом заполнения "множественное".

Рекомендации:
- Для итераторов используйте параметр "Результат поиска (массив для итератора)";
- Для простых числовых полей используйте параметр "Результат поиска (строка)" и извлекайте первый ID через функции обработки строк;
- Используйте параметр "Количество найденных элементов" для проверки успешности поиска и условий ветвления.

Обработка ошибок:
Если при поиске возникла ошибка или не указаны параметры для поиска, активити вернёт ошибку с описанием проблемы.
Возможные причины ошибок:
- Не указаны параметры для поиска (все поля пустые);
- Ошибка при выполнении запроса к API Битрикс24;
- Недостаточно прав доступа у указанного пользователя;
- Технические ошибки подключения к серверу.

При успешном поиске, но отсутствии результатов, возвращается:
- Пустой массив и строку;
- Количество найденных элементов: 0;
- Соответствие условиям поиска: "N".

Удаление Сделки

Данное активити позволяет удалить сущность "Сделка", указав её ID.

Сценарий работы активити бизнес-процесса

ID сделки: в данном поле нужно указать ID удаляемой сделки.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат выполнения (Y/N);
- Сообщение об ошибке;
- Таймаут операции.

Сотрудники

Выбор сотрудника по должности

Данное активити позволяет получить id сотрудника, который работает на портале зная всего лишь название его должности. Это особенно удобно когда у вас множество бизнес-процессов и в них приписаны должности людей, а не конкретные люди, т.к. при увольнении сотрудника вам придётся переписывать все бизнес-процессы в которых уволенный сотрудник участвовал.

Сценарий работы активити бизнес-процесса

Должность: наш специальный алгоритм собирает в данное поле все доступные на портале должности, выбрать  необходимую должность можно из выпадающего списка… Стоит учитывать, что если у вас есть несколько одинаковых названий должностей, то следует их именовать по другому, например, используя цифры: Менеджер 1 или Менеджер 2. 

Добавлять "user_" к ID пользователя: в данном поле указывается, будет ли добавлена текстовая приставка "user_" к ID пользователя.

ВАЖНО!
Необходимо помнить, что система не принимает просто ID пользователя и требуется делать дополнительное действие через изменение переменных, чтобы получить на выходе следующую конструкцию - user_{ID которое получили}. Например, если Вы получили через наше активити ID 13, то для вставки в конкретную сущность необходимо привести его к форме - user_13.

Резервный пользователь: данное поле обязательно для заполнения и заполняется на тот случай, если сотрудник с искомой должностью уволен. Если сотрудник не был уволен, то данные, заполненные в этом поле игнорируются, а если был, то активити выдаст ID резервного пользователя.

Результатом работы приложения будет получение ID конкретного сотрудника, который Вы уже сможете вставлять в свои бизнес-процессы.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.  

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Сценарий работы робота

   
   Возвращаемые параметры данного активити:
   - ID пользователя (первый, если он в списке)
   - ID пользователей (массив для итератора).
   - Количество найденных элементов.

Выбор сотрудника по e-mail

Данное активити позволяет выбрать сотрудника по его e-mail адресу. Это особенно важно, когда вы хотите назначать задачи экстранет пользователям, т.к. по другому у вас не получится это сделать в рамках бизнес-процесса. 

Сценарий работы активити бизнес-процесса

Email - в это поле необходимо вставить E-mail сотрудника, которого вы хотите выбрать.
На текущий момент, нет возможности удобно получать список экстранет-пользователей в бизнес-процессах и приходится выстраивать систему через e-mail.
Чтобы получить e-mail, необходимо либо создавать пользовательское поле типа список и туда заносить всех ваших экстранет пользователей, а потом с помощью бизнес-процесса сопоставлять полученного человека и его e-mail. Можно пойти проще. Сделать сразу список e-mail и в нём выбирать значение. 

Добавлять "user_" к ID пользователя: в данном поле указывается, будет ли добавлена текстовая приставка "user_" к ID пользователя.

ВАЖНО!
Необходимо помнить, что система не принимает просто ID пользователя и требуется делать дополнительное действие через изменение переменных, чтобы получить на выходе следующую конструкцию - user_{ID которое получили}. Например, если Вы получили через наше активити ID 13, то для вставки в конкретную сущность необходимо привести его к форме - user_13.

Результатом работы приложения будет получение ID конкретного сотрудника, который Вы уже сможете вставлять в свои бизнес-процессы.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Сценарий работы робота

Возвращаемые параметры данного активити:
- ID сотрудника.
- Сообщение об ошибке.

Получение отдела сотрудника

Данное активити даёт возможность получить id отдела в котором работает выбранный для анализа сотрудник портала. Это необходимо, когда нужно выбрать другого пользователя из отдела в котором состоит конкретный сотрудник, участвующий в бизнес-процессе.

Сценарий работы активити бизнес-процесса

ID сотрудника - в данное поле необходимо вставить ID сотрудника, отдел которого Вы хотите узнать.

Вывести информацию по названию отдела: варианты: да/нет.
Данный пункт позволяет вывести информацию об отделе сотрудника в текстовом виде.

Результатом работы приложения будет получение ID отдела сотрудника, который Вы уже сможете вставлять в свои бизнес-процессы.

ВАЖНО!
Если у Вас сотрудник участвует сразу в нескольких отделах, то наше активити Вам не поможет, т.к. всегда будет возвращать первый попавшейся.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.  

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы роботов

   
   Возвращаемые параметры данного активити:
   - ID отдела (первый, если он в списке)
   - ID отделов пользователя (массив для итератора).
   - Названия отделов пользователя (массив для интегратора)
   - Количество найденных элементов.

Поиск сотрудников

Данное активити позволяет найти сотрудника по заданным параметрам.

При настройке данного активити, доступно к заполнению довольно обширное количество пользовательских полей, заполнение этих полей опционально и является обязательным, при условии, что это одни из параметров, по которым будет осуществляться поиск.
Результатом работы данного активити, является вывод в ленту CRM ID искомого сотрудника, а так же данных его профиля, если таковые заполнены.

Сценарий работы активити бизнес-процесса

ID: указание ID искомого сотрудника.
Данный пункт рассчитан на вывод данных только 1 сотрудника.

Подразделения: в данном поле указывается код подразделения, т.е его ID, так же можно выбрать подразделение из контекстного меню "..."/ "Категории пользователей"/"Сотрудники и отделы"/ выбрать подходящий отдел. Подразделение/отдел или департамент, это по сути одно и тоже.
Пример заполнения: [D1] , где "1", это ID подразделения, так если выбирать через контекстное меню, то поле может быть заполнено так: BITRIX: Все сотрудники отдела [D1];

Какие параметры выводить: данное поле позволяет ограничить перечень доступных к выводу параметров.
Варианты выбора:

• Только ID/Все данные/Сокращенный список параметров;
• Только ID: активити выдаст только ID пользователя;
• Все данные: Все доступные данные о пользователе;
• Сокращенный список параметров: 24 поля , ID пользователя, e-mail, фамилия, имя , отчество, пол, должность, день рождения, номер телефона мобильный и рабочий, факс, сайт или ссылка на соц сети, улица, город, индекс, страна, номер подразделения в котором работает.

Уволен ли сотрудник(сотрудники)?: варианты да/нет, позволяет указать, уволен ли искомый сотрудник или нет.

Данное поле ЖЕЛАТЕЛЬНО к заполнению, если не указать уволен ли сотрудник или нет, то в результате поиска вы получите всех сотрудников, которые когда-либо работали в отделе, включая уволенных.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Какие параметры выводить: в данном пункте доступны варианты выбора из выпадающего списка.
1. Только ID: в результате поиска выводит только ID искомого сотрудника.
2. Все данные: выводит все доступные данные о сотруднике.
3. Сокращенный список параметров: выводятся только основные параметры о сотруднике(ID, имя, e-mail).

Если какие-либо данные у сотрудников будут совпадать, то активити будет выводить данные сотрудников, у которых эти данные совпадают.
Т.е если у 2 сотрудников совпал телефон или e-mail, то в результате активити выдаст ID этих пользователей.
Однако изначально активити рассчитано на поиск 1 сотрудника.
Если вы хотите вывести один из возвращаемых параметров "Результат.." , то вам необходимо выбрать из выпадающего списка параметр "Все данные".

Если нужно осуществить поиск по полю "Рабочий телефон", то в активити это поле называется "Телефон компании".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса:  данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:  в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат..(ID,EMAIL и пр.)
- ID сотрудника.
- Данные, которые указаны в учетной записи сотрудника(Ф.И.О., почта, телефон и пр.).

Пригласить сотрудника

Данное активити позволяет отправить сотруднику приглашение на портал.

Сценарий работы активити бизнес-процесса

Почта, куда должно прийти приглашение: в данном поле указывается e-mail адрес для отправки приглашения.

Данное поле не поддерживает работу с массивами.

Экстранет:  будет ли данный сотрудник экстанет пользователем или нет.

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

ID группы (проекта): в данном поле указывается ID группы (проекта), в которой будет состоять приглашенный на портал сотрудник.

ID подразделения: в данном поле указывается ID подразделения,в котором будет состоять приглашенный на портал сотрудник.

Если сотрудник штатный, то поле "ID подразделения" обязательно к заполнению.

Текст приветствия: в данном поле указывается текст приветствия для приглашенного сотрудника.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: 

в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID приглашенного пользователя.
- Сообщение об ошибке.

Изменить данные сотрудника

Данное активити позволяет изменить данные сотрудника по заданным в настройках параметрам.

Сценарий работы активити бизнес-процесса

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

ID сотрудника: в данном поле указывается ID сотрудника, данные которого нужно изменить.

Активность: в данном поле выбирается активен пользователь и может совершать действия или нет. Если нет, то пользователь даже не сможет зайти на портал.

В данном активити значительно больше полей, однако их назначение довольно легко понять, если у Вас возникли сложности, то вы можете обратиться за разъяснением их функционала в нашу ТП. 

Делать отладочные сообщения в журнале БП: в данном поле указывается нужно ли доделать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Списки

Поиск элемента списка

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

Сценарий работы активити бизнес-процесса

Где искать элемент: из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находится.
Если поле является списком, то нужно искать ID элемента, а не его значение.
Для этого нужно:
1. Перейти в режим редактирования элемента списка
2. Нажать F12 и выбрать селектор элементов страницы. 
3. Выбрать поле со списком.
4. Внизу появится список с ID.
Если осуществляется поиск списка групп, то поле "Где искать элемент" не заполняется.

Если в выпадающем списке нет списка, в котором расположен искомый элемент, то причин может быть 3:

• Вы создали список уже после установки активити, и чтобы активити "увидело" этот список, его (активити) нужно переустановить.
• Количество списков более 100, либо у списков слишком большая вложенность. У Б24 есть ограничение по размеру файла, в котором описан перечень списков и элементов, которые они содержат. Если размер файла превышает лимит, то активити попросту не увидит некоторые списки.
  
• У меню с выпадающим списком есть ограничение на отображение не более 50 элементов.

ID группы: в данном поле указывается ID группы, в которой лежит список. Данное поле заполняется цифрой, без каких-либо дополнительных знаков (пробелов тоже не должно быть).

ID списка: в данном поле указывается ID списка, который расположен в группе. Данное поле заполняется цифрой, без каких-либо дополнительных знаков (пробелов тоже не должно быть).

По какому полю выполнять поиск: позволяет выбрать тип поля, по которому будет выполняться поиск.
Доступно 4 варианта типов полей:

1. Вид поля "Код" (Код пользовательского поля); 
2. Тип "Детальное описание"; 
3. Тип "Анонс" (Предварительное описание); 
4. Тип "Название элемента"; 
5. Тип "Код штатного поля". Узнать тип поля можно в редакторе полей (действия>настроить поля).

1. Если выбран тип "Привязка к элементам CRM" и указана только одна сущность (любая), то осуществлять поиск нужно по ID.

2. Если установлен тип "Код" и указанно несколько сущностей(любых), то поиск нужно осуществлять по ID с префиксом.

Префиксы(Содержимое искомого поля):
L_26635 - Лид
C_843 - Контакт
CO_709 - Компания
D_839 - Сделка

Тип поля "код" устанавливается при создании поля в редакторе полей.
Поиск элемента по типу поля "код" не будет работать, если не указать данный тип поля при создании его в редакторе полей.
Это же правило распространяется на тип поля "Строка" или "Число".

CODE - это обозначение вида пользовательских полей при вводе параметров поиска. Оно относится к любым пользовательским полям, вне зависимости от того, какого ого типа (Например: Число, строка, дата  и.т.д)
NAME, DETAIL_TEXT, PREVIEW_TEXT - это системные виды полей.

Код искомого поля: данный код берется из пункта "настройка полей", в выбранном инфо блоке списка.
Если код искомого поля пуст, то активити будет искать согласно полю "Название".
Данное поля только для полей тип "Код".

Если поиск элементов осуществляется по "Код штатного поля", то коды штатных полей Б24 можно узнать перейдя в справку.
В случае, когда осуществляется поиск по штатному полю с кодом "DATE_CREATE" (Дата создания элемента), правильное заполнение поля выглядит так: #DTДата.Месяц.Год.

Пример: #DT23.06.2022.

Пример: NAIMENOVANIE_MATERIALA

Тип условия поиска: в данном поле указывается условие для поиска элемента.
Доступны варианты: равно, не равно, больше или равно, меньше или равно, больше, меньше, содержит, не содержит.

ВАЖНО!
Для полей тип "Список" нельзя использовать числовые значения, например "Содержит 283".

Содержимое искомого элемента: в данном пункте указывается название искомого элемента списка.
Пример: Трос

Данные символы ставятся перед содержимым ячейки:
={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=> больше или равно.
Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<  меньше или равно.
Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так: Вид пользовательского поля##Код поля##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}
Вид пользовательского поля: это тип пользовательского поля (строка, число и прочее смотря какой у вас) заполняется на английском.
Код поля: берется в настройках поля из адресной строки. 
Пример заполнения:
datetime##UF_CRM_1611588337##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Сообщение об ошибке
- Соответствует условиям
- ID элемента списка (первый, если больше 1)
- Результат поиска (массив для итератора) 

Удаление элемента списка

Данное активити позволяет удалять элементы списка, указав где расположен удаляемый элемент и указав его ID.

Сценарий работы активити бизнес-процесса

Где искать элемент: из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находиться.

ВАЖНО!
Если список создан после установки активити, то его не будет в выпадающем списке, для того, чтобы он появился, нужно переустановить активити. Это происходит из-за того, что активити получает перечень списков в момент установки.

ID группы: в этом поле указывается ID группы в которой находится удаляемый список.

ID списка: в этом поле нужно указать ID списка, который расположен в указанной выше группе.

ID удаляемого элемента: в этом поле указывается ID удаляемого элемента списка.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Соответствует условиям.
- ID элемента списка.
- Сообщение об ошибке.

Поиск элемента списка по нескольким полям

Данное активити позволяет находить элементы списков, указав несколько полей по которым нужно искать данный элемент. 
Результатом работы данного активити, будет вывод найденных элементов в массив, а так же вывод ID элемента (первый, если больше 1).

Сценарий работы активити бизнес-процесса 

Где искать элемент: из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находится.
Если поле является списком, то нужно искать ID элемента, а не его значение.
Для этого нужно:
1. Перейти в режим редактирования элемента списка
2. Нажать F12 и выбрать селектор элементов страницы. 
3. Выбрать поле со списком.
4. Внизу появится список с ID.
Если осуществляется поиск списка групп, то поле "Где искать элемент" не заполняется.

Если в выпадающем списке нет списка, в котором расположен искомый элемент, то причин может быть 3:

• Вы создали список уже после установки активити, и чтобы активити "увидело" этот список, его (активити) нужно переустановить.
• Количество списков более 100, либо у списков слишком большая вложенность. У Б24 есть ограничение по размеру файла, в котором описан перечень списков и элементов, которые они содержат. Если размер файла превышает лимит, то активити попросту не увидит некоторые списки.
  
• У меню с выпадающим списком есть ограничение на отображение не более 50 элементов.

Параметры поиска элемента(ов): в данном поле указываются параметры, согласно которых будет осуществлен поиск элементов.
Параметры указываются в следующем порядке: Тип поля##буквенный код поля(если он есть)##код условия##искомое значение.

Пример: 
CODE##NAIMENOVANIE_MATERIALA##1##Трос
DETAIL_TEXT##1##СПБ 
NAME##7##Название
PREVIEW_TEXT##7##Луна-спутник Земли
Очередность заполнения обязательна.

CODE - это обозначение вида пользовательских полей при вводе параметров поиска. Оно относится к любым пользовательским полям, вне зависимости от того, какого ого типа (Например: Число, строка, дата  и.т.д)
NAME, DETAIL_TEXT, PREVIEW_TEXT - это системные виды полей.

CODE##NAIMENOVANIE_MATERIALA##1##Трос
1. Поле код (Code).
2. Буквенный код поля: по сути буквенное название поля, которое можно найти в настройках полей. (действия>настроить поля>нужный тип поля>Код)
3. Код условия: условие вводится в виде цифрового значения, как в примере выше.
Расшифровка значений кодов: 
   Равно - 1 
   Не равно - 2 
   Больше или равно - 3
   Меньше или равно - 4
   Больше - 5 
   Меньше - 6
   Содержит - 7
   НЕ Содержит - 8
4. Искомое значение:название искомого значения, может быть текстом, цифрой.
Т.е если ищем значение "Трос" в поле тип список, то так и вводим "Трос" (либо ID элемента поля тип список), если стоимость материала вв виде числа, то вводим искомое число, например 100.

DETAIL_TEXT##7##СПБ
1. Тип поля DETAIL_TEXT (детальный текст)
2. Буквенный код поля: по сути буквенное название поля, которое можно найти в настройках полей. (действия>настроить поля>нужный тип поля>Код).
3. Содержимое поля "детальный текст" искомого списка.
  
NAME##7##Название
1. Тип поля NAME (название).
2. Буквенный код поля: по сути буквенное название поля, которое можно найти в настройках полей.
3. Текст из поля "Название" из искомого списка.

PREVIEW_TEXT##7##Луна-спутник Земли
1. Тип поля PREVIEW_TEXT (Анонс)
2. Буквенный код поля: по сути буквенное название поля, которое можно найти в настройках полей.
3. Текст из поля "Анонс" или "Текст анонса" из искомого списка.

Тип условия для всех параметров: в данном поле можно указать один из 2 типов условий для поиска элементов списка "и/или". 
И - используют, когда осуществляется поиск по одному полю, либо нескольким, но главное, чтобы поля искомого элемента удовлетворяли всем указанным условиям.
Т.е если указано 2 условия, то должно быть удовлетворено оба.
Или - используют, когда поиск будет происходить по нескольким полям и результат должен удовлетворять хотя бы одному из них.

Данные символы ставятся перед содержимым ячейки:
={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=> больше или равно.
Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<  меньше или равно.
Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так: Вид пользовательского поля##Код поля##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}
Вид пользовательского поля: это тип пользовательского поля (строка, число и прочее смотря какой у вас) заполняется на английском.
Код поля: берется в настройках поля из адресной строки. 
Пример заполнения:
datetime##UF_CRM_1611588337##{{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы активити робота

Возвращаемые параметры данного активити:
- Сообщение об ошибке
- Соответствует условиям
- ID элемента списка (первый, если больше 1)
- Результат поиска (массив для итератора) 

Добавление элемента списка

Данное активити позволяет добавлять элементы списка.

Сценарий работы активити бизнес-процесса

В каком списке добавляем элемент: в этом поле нужно выбрать из выпадающего списка, список в который будет добавлен новый элемент.

Если список добавлен после установки данного активити, то он не будет отображен в списке.

Название элемента (NAME): в этом поле указываем название добавляемого элемента.

Поле нового элемента списка: при заполнении этого пункта, новое поле не создается, а добавляется в созданный элемент, это значит, что поле, которое Вы указываете должно быть уже создано.
Заполняется поле так: код поля##новое значение. Пример: KovroviyGazon##321
Чтобы все верно заполнить, нужно:

• Знать код поля которое планируется добавить в элемент (его можно посмотреть в настройках полей)
  
• Получить значение(я) поля. Пример получения значения приведен на скриншоте ниже, на примере поля тип "Список". (Если смотреть значение поля в настройках полей, то в пункте 4, нужно выбирать значение в LIST [код] [value]) 

Если вы решили добавить в список файл через переменную тип "файл", то добавить можно только один файл за раз.

Делать отладочные сообщения в журнал БП:варианты да/нет.

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

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- ID нового элемента списка.

Изменение элемента списка

Данное активити позволяет добавлять элементы списка.

Сценарий работы активити бизнес-процесса

В каком списке меняем элемент: в этом поле нужно выбрать из выпадающего списка, список в котором будет изменен элемент.

Если список добавлен после установки данного активити, то он не будет отображен в выпадающем списке.

ID элемента: в этом поле указывается ID элемента, который нужно изменить.

Какое поле меняется: в этом поле указывается код поля и его значение через решетку (код поля##новое значение)
Пример: KovroviyGazon##321.

Чтобы все верно заполнить, нужно:

• Знать код поля которое планируется изменить в элементе (его можно посмотреть в настройках полей)
  
• Получить значение(я) поля. Пример получения значения приведен на скриншоте ниже, на примере поля тип "Список". (Если смотреть значение поля в настройках полей, то в пункте 4, нужно выбирать значение в LIST [код] [value]) 

Если вы решили добавить в список файл через переменную тип "файл", то добавить можно только один файл за раз.

Делать отладочные сообщения в журнал БП:варианты да/нет.

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

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Первый или последний элемент в списке

Данное активити позволяет выводить первый или последний элементы списка, указав ID и тип этого списка.

Сценарий работы активити бизнес-процесса

Тип инфоблока(списка): из выпадающего списка нужно выбрать тип инфоблока (списка), в котором содержится первый или последний элемент в списке.
Доступно 2 варианта:

• Инфоблок списка;
• Инфоблок процессов;

ID инфоблок (списка): в этом поле указывается ID списка, в котором содержится первый или последний элементы.

Расположение элемента: в этом поле нужно выбрать из выпадающего списка какой элемент нужно вывести: первый или последний.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Соответствует условиям.
- ID выбранного элемента списка.
- Сообщение об ошибке.

Счета (старые)

Перезаполнение товаров счета

Данное активити позволяет автоматически перезаполнять товары в Счёте при изменении Сделки. Это позволяет облегчать работу менеджерам. Особенно актуально, когда в счетах более 10 позиций.

Сценарий работы бизнес-процесса

ID Счёта: в данном пункте указывается ID счета, который планируется перезаполнять.

Данное активити работает только со "старыми" счетами, а новый тип счетов относится к смарт-процессам, и счета в нем являются элементами смарт-процесса. Т.е для работы с элементами смарт-процесса "счет" (его ID_31), нужно использовать соответствующее активити из категории "Смарт-процессы".

ID Сделки (Если ID счета не задано): в данном пункте указывается ID сделки к которой привязан счет. Если указан ID счета, то ID сделки не обязателен к заполнению.

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

Принудительно выставлять НДС: позволяет выбрать из выпадающего списка будет ли НДС добавлен в стоимость или поверх счета.

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

Предустановленные товары (ID##количество##ед. измерения##цена): в данном пункте добавляются товары, которые ранее были предустановлены.

Поле "Предустановленные товары" нужно для того, чтобы добавлять дополнительные товары в счет помимо тех, что уже есть в сделке. Т.е если у вас в сделке есть некий товар "Чашка" и выставлен счет на эту чашку, то указав в поле "Предустановленные товары"  товар "доставка", этот товар будет дополнительно добавлен в счет и в счете будет уже 2 товара.
Если Вам не нужно добавлять дополнительный товар в счет, то это поле нужно оставить пустым.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Создание счета

Данное активити создаёт сущность Счет на основании Сделки из которой оно запускается. Если в Сделке правильно указаны все реквизиты контрагента, то они все будут перенесены в созданный счет. Так же активити позволяет возвращать динамическую ссылку на счет, чтобы Вы могли её отправить клиенту в письме из бизнес-процесса.

Название	Описание
Префикс для номера счёта:	позволяет указать префикс для счета.
Использовать номерацию Битрикс24:	позволяет выбрать,будет ли использована нумерация Б24 или нет.
Принудительно выставлять счет только на:	данное поле позволяет принудительно выставлять счет только на Компанию либо на контакт. При работе с данным полем есть ньюансы: Если выбрать "Не важно", то при наличии Компании и Контакта, счет выставляется на Компанию и привязывается Контакт. Если выбрать "Компания", то счет будет выставлен на Компанию без привязки Контакта, даже если он есть в сделке.
Ответственный за счет:	в данном поле можно указать ответственного за созданный счет. Если данное поле не заполнить, то ответственный будет взят из настроек поля "Запускать от имени".
Статус счета:	в данном поле из выпадающего меню выбирается подходящий статус счета.
Срок оплаты в днях:	в данном пункте указывается срок оплаты счета в днях.
ID компании продавца:	в данном пункте указывается ID компании-продавца .
ID реквизита организации продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита организации продавца.
ID банковского реквизита продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID банковского реквизита продавца.
ID способа оплаты из настроек CRM (для контакта): (Это поле обязательно к заполнению)	в данном пункте указывается ID способа оплаты из настроек CRM для контакта. Из-за ошибки в переводе со стороны Б24, это поле отвечает за вывод печатной формы счета для контакта.
ID способа оплаты из настроек CRM (для компании): (Это поле обязательно к заполнению)	в данном пункте указывается ID способа оплаты из настроек CRM для компании. Из-за ошибки в переводе со стороны Б24, это поле отвечает за вывод печатной формы счета для компании.
ID реквизита покупателя (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита покупателя. Если данное поле заполнено, то реквизиты будут браться не автоматически из контакта или компании, а именно из этого поля.
Создавать реквизит для физ. лица (если пустой):	в данном пункте указывается, создавать ли реквизиты для физического лица.
Какой тип реквизита создавать:	в данном поле указывается какой тип реквизита создавать из выпадающего меню.
ID пресета ИП для физ. лица (если не указан, будет искаться с именем "ИП"):	в данном поле указывается ID пресета ИП для физ. лица
ID пресета для физ. лица (шаблон для реквизитов):	в данном поле указывается ID пресета(шаблона) для физ. лица
Ставка НДС:	позволяет выбрать из выпадающего списка ставку НДС.
Принудительно выставлять НДС:	позволяет принудительно выставить НДС, выбрав нужный параметр из выпадающего меню.

Данное активити создает счета "старого" типа. Новый тип счетов относится к смарт-процессам.
Т.е для создания счета нового типа, нужно использовать соответствующее активити и в смарт-процессе с ID_31 (данный смарт-процесс скрыт, однако он отвечает за создание новых счетов) создать элемент смарт-процесса.

Если Вы хотите создать счет для физ. лица, у которого нет реквизитов, то следующие поля обязательны к заполнению:

• Статус счета;
  
• Срок оплаты в днях;
  
• ID компании продавца;
  
• ID реквизита организации продавца (если реквизитов несколько, то и поле "ID банковского реквизита продавца);
  
• ID способа оплаты из настроек CRM (для контакта. печатная форма);
  
• Создавать реквизит для физ. лица (если пустой);
  
• Какой тип реквизита создавать.
• ID пресета для физ. лица (Настройки CRM-->С чего начать-->Шаблоны реквизитов)
  

Предустановленные товары (ID##количество##ед. измерения##цена):  позволяет добавить в счет товары из каталога. 

Если Вам нужно добавить товар из каталога, но при этом его название в счете должно быть отличным от каталожного, то после указания цены нужно добавить ## и указать нужное название товара. Это не изменит название товара в каталоге, но в конкретно созданном счете оно будет другим.  
Пример:Название товара по каталогу "Продление интернета_50Мбит" , в счете нужно назвать Продление интернета_50Мбит для ООО "КаршерингMSK".
Заполняем так: 1684##1##шт##35000##Продление интернета_50Мбит для ООО "КаршерингMSK" 

Название	Описание
Выставить счёт на остаток товаров в сделке:	позволяет выставить счет на разницу товаров указанных в сделке и товаров, которые уже имеются в счетах, при условии, что количество товаров и суммы в счетах не будут превышать аналогичные значения в сделке. Т.е если есть счет, где к примеру продано 5 авто и 4 сникерса, а новый счет выставляется с количеством 7 авто и 4 сникерсами, то активировав данную настройку, в новом счете будет 2 авто, а сникерсы в счет не попадут.
Частичная оплата (в процентах, по-умолчанию 100):	в данном пункте указывается процентная составляющая предоплаты.
Фиксированная сумма предоплаты:	позволяет указать фиксированную сумму предоплаты.
Сократить сумму за счет:	в данном поле можно выбрать за счет чего будет сокращена сумма за счет.
Округлять до целых (при расчете частичной оплаты):	в данном пункте указывается, округлять ли до целых чисел, при расчете частичной оплаты.
Комментарий к счёту (скрытый для покупателя):	позволяет добавить комментарий к счету, который будете видеть только Вы.
Делать отладочные сообщения в журнал БП:	позволяет выводить отладочные сообщения в журнал БП.

Если Сделка создана с компанией у которой нет реквизитов, то счет не выставится даже когда они будут добавлены в компанию, т.к. реквизиты привязываются к сделке.
Решение - перевыбрать компанию в Сделке.

Если вы столкнулись с такой ошибкой при выполнении активити: во время создания счета была обнаружена ошибка: Не введено значение обязательного поля "Печатная форма счёта", нужно заполнять поле "ID способа оплаты из настроек CRM (для компании)".
ID этого способа можно посмотреть в настройках способов оплаты вашего портала.

Возможности:

1. Счёт создаётся автоматически нашим активити.
2. При создании отдаёт ссылку для отправки на почту, поэтому можно в БП это сразу организовать.
3. Счет отслеживает нумерацию и может её сам устанавливать в рамках нескольких юр. лиц (Префиксы допускаются) Нумерация в рамках 1 года, т.е. с первого января другого года будут опять с нуля.
4. Есть возможность автоматически дробить счет на части (предоплата несколькими счетами)
5. Есть возможность отслеживать статус оплаты счета или любой другой статус.
6. Есть возможность выбирать разные платёжные реквизиты плательщика (в одной компании несколько юр. лиц)
7. Есть возможность выставлять счета от разных юр. лиц.
8. Есть возможность автоматически создавать реквизиты для физ. лиц, чтобы можно было выстроить грамотный обмен с 1С.

Обратите внимание на данную схему.
Она отображает все возможные сценарии, которые вам следует учитывать при проектировании бизнес-процесса в Битрикс24, т.к. каждая ветка является отдельным сценарием и его придётся выделять в бизнес-процессе.

Описание полей:

ID компании продавца: в данном поле необходимо указать ID Вашего юридического лица от которого будет выставляться счёт. Для того, чтобы узнать какое число необходимо вписывать это поле, следует перейти в CRM > НАСТРОЙКИ > РЕКВИЗИТЫ ВАШИХ КОМПАНИЙ

В этом списке следует выбрать необходимую Вам компанию и посмотреть её id. Если Вы не видите данное поле, то настройте в шестерёнке его (ID) отображение.

Обращаем Ваше внимание на то, что в созданной вами компании от которой вы собираетесь выставлять счета, должен быть только 1 набор реквизитов (ИНН, КПП и так далее). Если Вы не заполните реквизиты, то счет будет создаваться с пустыми графами.

Для создания реквизитов следует зайти внутрь компании и добавить реквизиты.

 

ID реквизита организации продавца (если не указан, берется 1-й из списка):  в данном поле следует указать id набора реквизитов компании-продавца. Бывают такие случаи, что у одной Вашей компании могут быть несколько реквизитов. Если поле не заполнено, то приложение выберет первый попавшийся из списка реквизитов.

К сожалению, в новой карточке не выводится ID реквизитов и Вам потребуется переключится на отображение старой карточки CRM, чтобы уточнить ID реквизитов. CRM > НАСТРОЙКИ > ДРУГИЕ > ОБЩЕЕ > ВКЛЮЧИТЬ НОВУЮ КАРТОЧКУ CRM - НЕТ

Потом вы возвращаетесь к CRM > НАСТРОЙКИ > РЕКВИЗИТЫ ВАШИХ КОМПАНИЙ 

На вкладке "Реквизиты" Вы можете увидеть ID реквизита. Если вы не видите данного поля, то в настройках заголовка следует его отобразить. 

ID банковского реквизита продавца: в данном поле следует указывать ID банковских реквизитов продавца. Бывают случаи, когда у одной компании с одним набором реквизитов существует несколько наборов банковских реквизитов (открыты счета в разных банках и их требуется указывать в счетах на оплату).

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

Вы нажимаете на значок выбора элемента и потом указываете на поле "Названия банка". Внизу появится код элемента. Вам нужен будет код типа BANK_DETAILS[n0] ... цифра в квадратных скобках будет тем самым ID. Его нужно использовать без буквы N. 

Для корректного создания счета, вы должны учитывать следующие моменты:
1. Для сущности Контакт реквизиты нужны из-за коллизий при обмене с 1С, и счет мы можем выставлять только с реквизитами.
2. Для сущности Компания реквизиты нужны в обязательном порядке!
3. Тип сущности покупателя должен совпадать с типом платёжной системы, т.е. если покупатель контакт, то и тип платёжной системы должен быть для контакта.
4. Смотрите результат запуска создания счёта в журнале бизнес-процесса. Там будут отображаться все шаги и вы сможете увидеть ошибку, если счёт не создался.

Реквизиты создаются по следующей логике:

• Если в сущности Сделка выбрана Компания, то реквизиты будут браться только из компании.
  
• Если в сущности Сделка выбран Контакт, то реквизиты будут браться только из Контакт.
• Если в сущности Сделка выбраны и Контакт и Компания, то реквизиты будут браться только из Компании.

ID реквизита покупателя: в данном поле следует указать id набора реквизитов покупателя. Бывают такие случаи, что у покупателя могут быть несколько реквизитов. Если поле не заполнено, то приложение выберет первый попавшийся из списка реквизитов. В описании поля ID реквизита продавцам (выше в данной инструкции) вы можете найти информацию как можно найти значение.

Если поле ID реквизита покупателя заполнено, то реквизиты будут браться не автоматически из контакта или компании, а именно из этого поля.

Создавать реквизит для физ. лица: эта опция необходима когда у Вас имеется обмен Битрикс24 и 1С конфигурации, которая не поддерживает сопоставление по e-mail. Если Вы установите "Да", то при создании счёта для физического лица система проверит наличие реквизитов. Если она их не найдёт, то создаст новый набор реквизитов тип ИП и автоматически проставит ИНН 000000000001 или очередной. Для каждого физ. лица будет присвоен ИНН и это позволит Вам сопоставлять клиента в двух системах.

ID пресета для физ. лица (если не указан, будет искаться с именем "ИП"): данная опция позволяет выбрать id типа набора реквизитов. Если Вы не трогали настройка типов реквизитов, то можете оставить эту опцию. Если Вы меняли название типов реквизитов, то вам необходимо зайти в настройки Битрикс24 и посмотреть ID типа реквизитов ИП.  CRM > НАСТРОЙКИ > ШАБЛОНЫ РЕКВИЗИТОВ

Тип реквизита Компании/Контакта "по умолчанию" для каждого типа сущности можно настроить отдельно.
Т.е если у вас в Сделке есть Компания или Контакт, у которого по умолчанию выбраны реквизиты для ИП, то при переходе в карточку Контакта или Компании вы можете обнаружить, что там по умолчанию указан другой тип реквизитов.
При выставлении счета из Сделки будет браться именно тот тип реквизита, который выбран по умолчанию в Сделке.
Стоит учитывать этот момент при выставлении счетов, т.к при срабатывании БП это может вызывать ошибку.

ID способа оплаты из настроек CRM: в данном поле необходимо указать способ оплаты. Для того, чтобы узнать какое число необходимо вписывать сюда, следует перейти: "CRM > НАСТРОЙКИ > СПОСОБЫ ОПЛАТЫ

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

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

Срок оплаты в днях: в данном поле можно установить количество дней для оплаты счета.

Тип плательщика: в данном поле вы выбираете тип плательщика (юр. лицо или физическое). Это требуется для того, чтобы бланк правильно сформировался, т.к. есть внутренние требования системы и когда вы выбираете физ. лицо, то плательщиком будет на название компании, а ФИО вашего клиента. Это нужно учитывать при создании бизнес-процесса.  

Частичная оплата (в процентах, по-умолчанию 100): это поле позволит Вам делить количество позиций, указанных в счете. Например, у вас в рамках сделки выставляется два счета по 50% (предоплата и окончательная оплата). В данном поле Вы устанавливаете 50 и при создании счета количество всех позиций будет поделено на 2. При этом сами позиции останутся такими, как вы укажите в сделке. Сумма и налоги пересчитаются автоматически исходя из нового количества.

Округлять до целых (при расчете частичной оплаты): в данном поле можно установить округление количества в позициях сделки если выбрали не 100%, а меньшее значение, Например, в одной из позиций сделки у Вас указано количество 3. При делении получится значение 1,5. Эта опция позволит округлить полученное число до целого значения.

ID реквизита плательщика (если не указан, берется 1-й из списка): в данном поле вы можете указать какие выбрать реквизиты клиента для выставления счета. Не редко бывают случаи, когда в рамках одной компании бывают несколько юридических лиц, которые вам могут оплатить. Если в Сделке выбран один набор из множества реквизитов, то он автоматически будет использован нами при создании счета.

Если вы будете использовать наши процессы из примера, то следует учитывать следующие моменты:
1. Вы можете скачать готовый бизнес-процесс, который требуется импортировать в ваш портал.
2. При импортировании затрётся ваш процесс, в который вы будете грузить пример.
3. При импорте в вашем портале будут созданы все поля, которые участвуют в нашем примере сущности Сделка. Вам необходимо будет сделать их отображаемыми в карточке Сделки.
4. Перед импортом необходимо установить наше приложение и в его настройках установить активити "Создание Счета" и "Слежение за статусом счета"
5. Особенностью Битрикс24 (при импорте сторонних бизнес-процессов) является тот факт, что нужно будет проверить правильность подставленных дополнительных значений в местах:
- во всех элементах изменение документа (Прописываем ID счета) - нужно прописать значение из доп. результатов - Создание Счета - ID Созданного Счета
- во всех элементах изменение переменных (Прописываем значение) - нужно прописать значение из доп. результатов - Получение статуса счета - Статус счета
- во всех элементах отправки писем.

Кейс № 1 - Простое создание Счёта

Давайте рассмотрим пример в котором мы просто создаём Счёт от одной организации автоматически с помощью нашего приложения. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

В данном бизнес-процессе рассматривается модель создания счета без наличия проверки его оплаты. Такой сценарий подходит в тех случаях, когда сотрудники компании вручную присваивают счетам оплату и можно настроить робот в автоматизации, который переведёт стадию сделки после получения оплаты счета. Бизнес-процесс проверяет наличие компании в Сделке и если он её не обнаруживает, то автоматически выставляет счет контакту.

В этой схеме мы заложили проверку на зависание приложения, чтобы ответственный за сделку смог вовремя вмешаться в процесс. Так же в процесс добавлена проверка на повторное создание счета, чтобы не делать дубликатов.  

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 1

Кейс № 2 - Простое создание Счёта и слежение за оплатой

Давайте рассмотрим пример, в котором мы создаём Счёт от одной организации автоматически с помощью нашего приложения и начинаем следить за его статусом. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

В данном бизнес-процессе рассматривается модель создания счета с наличием проверки его оплаты. При обмене данными с 1С конфигурациями, робот в Битрикс24 не получает сведений от системы, что счет был оплачен и Вы не можете ничего делать. Наше активити "Слежение за статусом счета" решает данный вопрос простым методом. Оно (активити) обращается через наш сервер к вашему порталу и опрашивает конкретный счет на предмет оплаты. Если говорить конкретнее, то оно может не только отслеживать оплату, а любой статус счета.

Мы не рекомендуем делать проверку статуса счета чаще чем 1 раз в час, т.к. вы будете создавать большую нагрузку на сервера 1С-Битрикс и наш сервер, а это неминуемо приведёт к блокировке вашего портала.

В рамках данного кейса рассматривается вариант при котором проверяется создавался ли ранее счет или нет. Если бизнес-процесс обнаруживает, что ранее он создавался, то автоматически запускается механизм проверки его статуса. Это позволяет огородить вас от дубликатов счетов, которые возникают по причине ошибок персонала.

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 2

Кейс № 3 - Создание Счета со слежением и отправкой на почту клиенту

Давайте рассмотрим пример, в котором мы создаём Счёт от одной организации автоматически с помощью нашего приложения, отправляем его клиенту и начинаем следить за его статусом. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

В данном бизнес-процессе появляются дополнительные проверки и поля, которые необходимы для нормальной работы всего процесса. Самое главное в автоматических алгоритмах - это не создавать неприятностей для ваших клиентов из-за своей беспечности, поэтому приходится проверять логику процесса несколько раз, чтобы убедиться в правильности выбранного пути. Мы дополнительно вынесли e-mail адрес для отправки писем, чтобы можно было точно его указать, т.к. в раках компании или контакта может быть куча адресов и какой из них правильный знает только менеджер, а машина может ошибиться. 

После завершения нескольких проверок бизнес-процесс получает от нашего активити ссылку на счет и вставляет её в письмо. В теле письма представленного бизнес-процесса уже внесена соответствующая переменная. 

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 3

Кейс № 4 - Создание Счёта от нескольких ваших организаций.

Давайте рассмотрим пример в котором мы создаём Счёт от разных ваших компаний в зависимости от условий оплаты (компания с НДС и без НДС). Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

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

Если мы говорим про 1С-конфигурации, то важно использовать и префиксы, чтобы при выгрузке документов номер назначался такой, какой необходимо. Если в 1С ведётся работа по нескольким организациям и счета грузятся из Битрикс24, то нужно учитывать следующее:

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

2. При проведении документа в 1С номер будет затираться на тот, который 1С считает очередным для проведённых документов.

3. Все счета нужно будет создавать ТОЛЬКО! в Битрикс24 если Вы не хотите, чтобы нумерация у Вас сбилась.

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 4

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логик

Возвращаемые параметры для данного активити:
- ID созданного счета.
- Номер созданного счета.
- Публичная ссылка на созданного счета.
- ID нового реквизита.
- Сообщение об ошибке.

Поиск счетов в сделке по статусу

Данное активити ищет в сделке все счета у которых нет статуса "Оплачено" или у них статус указан в параметрах.
Результатом работы является получение списка ID счетов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сценарий работы активити бизнес-процесса

ID Сделки (обязательное): в данном пункте указывается ID сделки, в которой будет осуществлен поиск счета.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Данное активити работает только со "старым" типом счетов. Новый тип счетов относится к смарт-процессам (ID_31), а сами счета являются элементами этого смарт-процесса. Для поиска элементов смарт-процесса используйте соответствующее активити из категории "Смарт-процессы".

Статус счета: в данном поле указывается статус искомого счета.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры данного активити:
- Найденные счета;
- Найденные счета (массив для итератора);
- Сообщение об ошибке.

Получение данных по сущности счет

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

Сценарий работы активити бизнес-процесса

ID сущности: в данном поле указывается ID сущности "Счет", из которой планируется получить все данные. 

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

Для печати: выводит данные в доступном для печати виде.

Ссылка на счет: варианты да/нет.
Указав "Да", активити выведет в возвращаемых параметрах ссылку на необходимый счет.

Сообщение об ошибке: да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы активити бизнес-процесса

Возвращаемые параметры для данного активити:
- Все параметры из сущности "Счет" 

Слежение за статусом счета

Данное активити позволяет следить за любым статусом счета если вы знаете его id. Результатом его работы является возвращение статуса счета в виде одной латинской буквы через дополнительные результаты.

Сценарий работы активити бизнес-процесса

ID счета (условие): в данном поле указывается ID статуса счета, за которым необходимо проследить.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), так же у смарт-процессов нет статусов, но есть направления по этому используйте соответствующее активити из категории "Смарт-процессы" --> "Мониторинг событий элементов СП".

Подходящий статус счета (условие): выбор из выпадающего списка подходящего статуса счета.

ВАЖНО!
Период слежения длится в течении  одного месяца, после чего останавливается.
Это связанно с тем, что забивается база данных сведениями, которые не востребованы, что ведет за собой ухудшение быстродействия приложения в целом. 

Количество запросов зависит от общего количества счетов в системе т.к. "слежение" получает ВСЕ обновления ВСЕХ счетов, даже тех, результат обновления которых нас не интересует.

Пример:
БП создал один счёт и следит за его статусом, а в ручную создали 1000 счетов и за ними никто не следит.
В таком случае события будут приходить по 1001 счету, т.е по любому изменению любого счета. Т.е количество запросов зависит от таких изменений.
Как только вы получаете нужное событие, "слежение" срабатывает и мы перестаем получать эти запросы.

Сообщение об ошибке:да/нет.
Позволяет выводить ошибки в журнал БП.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

ВАЖНО!
Данное поле на данный момент не доступно для корректировки.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
Возвращаемыми параметрами будут статус счета, которому присвоено значение. Эти значения будут уникальны для каждого портала. Это значение можно узнать, выбрав "просмотр элементов" в пункте, где можно выбрать подходящий статус счета.
Должен появится выделенный пункт с HTML-кодом "select-id", если нажать радом с ним стрелку,то появится список статусов и присвоенные для них значения.

Получение статуса счета

Данное активити позволяет следить за любым статусом счета если вы знаете его id. Результатом его работы является возвращение статуса счета в виде одной латинской буквы через дополнительные результаты.

Сценарий работы активити бизнес-процесса

ID счета (условие): в данный пункт вводится ID статуса счета, за которым необходимо проследить.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), так же у смарт-процессов нет статусов, но есть направления, т.е для получения направления смарт-процесса используйте соответствующее активити из категории "Смарт-процессы".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
Возвращаемыми параметрами будут статус счета, которому присвоено значение. Эти значения будут уникальны для каждого портала.
Это значение можно узнать, установив активити "Слежение за статусом счета", нажав F12 и выбрав "просмотр элементов" в пункте, где можно выбрать подходящий статус счета.
Должен появится выделенный пункт с HTML-кодом "select-id", если нажать радом с ним стрелку, то появится список статусов и присвоенные для них значения.

Поиск счетов

Данное активити позволяет осуществлять поиск счетов по выбранным параметрам.
Результатом работы является получение списка ID счетов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сценарий работы активити бизнес-процесса

Название	Описание
Номер:	В данном поле указывается номер искомого счета.
Валюта:	В данном пункте указывается валюта, указанная в искомом счете.
Дата создания:	В данном поле указывается дата создания, искомого счета.
Дата комментария к статусу:	В данном поле указывается дата комментария к статусу.
Дата оплаты:	В данном поле указывается дата оплаты искомого счета.
Дата изменения статуса:	В данном поле указывается дата изменения статуса искомого счета.
Дата изменения:	В данном поле указывается дата изменения искомого счета.
Кем создан:	В данном пункте указывается кем создан искомый счет.
Кто изменил поле оплаты:	В данном поле указывается кто изменил поле оплаты.
Кто изменил статус:	В данном поле указывается кто изменил статус искомого счета.
ID:	В данном пункте указывается ID искомого счета.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), т.е для поиска счета, который является элементом смарт-процесса, используйте соответствующее активити из категории "Смарт процессы".

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы активити бизнес-процесса

Возвращаемые параметры для данного активити:
- Массив для итератора;
- Результат поиска (строка);
- Количество найденных элементов;
- Соответствует условиям;
- Сообщение об ошибке.

Редактирование счета

Данное активити позволяет редактировать все поля сущности "Счет", включая пользовательские.

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
ID счета:	В данном поле указывается ID счета, который необходимо редактировать.
Номер:	В данном поле указывается номер редактируемого счета.
Комментарий:	В данном поле указывается комментарий менеджера.
Дата выставления:	В данном поле указывается дата выставления счета.
Дата создания:	В данном поле указывается дата создания счета.
Дата комментария к статусу:	В данном поле указывается дата комментария к статусу счета
Срок оплаты:	В данном пункте указывается до какой даты необходимо оплатить счет.
Тема:	В данном поле указывается тема выставленного счета.
Печатная форма счёта:	В данном поле указывается идентификатор печатной формы счета. (printable)
Дата оплаты:	В данном поле указываются дата оплаты счета. Дата указывается в формате Битрикс: 2019-07-30T03:00:00+03:00 (Год - месяц - дата - время + часовой пояс)
Номер документа оплаты:	В данном поле указывается номер документа оплаты.
Тип плательщика:	В данном поле указывается ID типа плательщика. ID плательщика, это ID платежной системы.  ID берется из списка плательщиков.
Комментарий к статусу:	В данном поле указываются комментарии к статусу.
Ответственный:	В данном поле указывается ID ответственного.
Статус:	В данном поле из выпадающего меню выбирается подходящий статус счета.
UF_COMPANY_ID:	В данном поле указывается ID компании, которой выставлен счет. Указывается, если плательщик Юридическое лицо
UF_CONTACT_ID:	В данном поле указывается ID плательщика, если тот является Физическим лицом, либо в виде контакта компании.
UF_MYCOMPANY_ID:	В данном поле указывается ID фирмы, которая выставляет счет.
UF_DEAL_ID:	В данном поле указывается идентификатор связанной сделки.
UF_QUOTE_ID:	В данном поле указывается идентификатор связанного коммерческого предложения.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), сам счет является элементом смарт-процесса, т.е для редактирования элемента используйте соответствующее активити из категории "Смарт-процессы".

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логик.

Возвращаемые параметры данного активити:
- Сообщение об ошибке.
- Успех редактирования.
- Таймаут операции.

Удаление счета

Данное активити позволяет удалить сущность "Счет", указав её ID.

Сценарий работы активити бизнес-процесса

ID счета: в данном поле нужно указать ID удаляемого счета.

Данное активити работает только со "старыми" типами счетов. Новые счета относятся к смарт-процессам (смарт процесс с ID_31), т.е для удаления элемента смарт-процесса используйте соответствующее активити из категории "Смарт процессы".

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат выполнения (Y/N).
- Сообщение об ошибке.
- Таймаут операции.

Счета (новые)

Создать новый счет(новый)

Данное активити позволяет создавать новые элементы внутри смарт-процесса тип "счет".
Созданные этим активити элементы будут являться "счетами" и отобразятся в сущности, во вкладке "Счета".

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса: в этом поле указывается ID типа смарт-процесса в котором будет создан элемент (смарт-счет).
Для смарт-процессов тип "счет" этот ID всегда 31.

Тип реквизита Компании/Контакта "по умолчанию" для каждого типа сущности можно настроить отдельно.
Т.е если у вас в Сделке есть Компания или Контакт, у которого по умолчанию выбраны реквизиты для ИП, то при переходе в карточку Контакта или Компании вы можете обнаружить, что там по умолчанию указан другой тип реквизитов.
При выставлении счета из Сделки будет браться именно тот тип реквизита, который выбран по умолчанию в Сделке.
Стоит учитывать этот момент при выставлении счетов, т.к при срабатывании БП это может вызывать ошибку.

Направление: это поле доступно только при первичной настройке и позволяет указать направление, к которому относятся элементы смарт-процесса с которыми планируется работать.

Название	Описание
ID сделки:	в данном поле указывается ID сделки, к которой будет привязан созданный счет.
Ответственный за счет:	в этом поле нужно указать ID сотрудника, который будет ответственен за созданный счет
Количество платежей, на которое разделить сумму сделки:	в данном поле цифрой указывается количество платежей на которое можно разделить сумму сделки. При активации данной настройки (заполнение поля), нужно учитывать, что разделение работает ТОЛЬКО тогда, когда товарная позиция в счете 1 и количество этого товара тоже равно 1. Если позиций товара или его количество будет более 1, то приложение выдаст ошибку с уведомлением.
Принудительно выставлять счет только на:	данное поле позволяет принудительно выставлять счет только на Компанию либо на контакт. При работе с данным полем есть нюансы:  Если выбрать "Не важно", то при наличии Компании и Контакта, счет выставляется на Компанию и привязывается Контакт. Если выбрать "Компания", то счет будет выставлен на Компанию без привязки Контакта, даже если он есть в сделке.
Статус счета:	в этом поле из выпадающего списка нужно выбрать статус, в котором будет находиться счет при создании.
Срок оплаты в днях:	в данном пункте указывается срок оплаты счета в днях.
ID компании продавца:	в данном пункте указывается ID компании-продавца.
ID реквизита организации продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита организации продавца.
ID банковского реквизита продавца (если не указан, берется 1-й из списка):	в данном пункте указывается ID банковского реквизита продавца.
ID способа оплаты из настроек CRM (для контакта. Печатная форма):	в данном пункте указывается ID способа оплаты из настроек CRM для контакта.
ID способа оплаты из настроек CRM (для компании. Печатная форма):	в данном пункте указывается ID способа оплаты из настроек CRM для компании.
ID реквизита покупателя (если не указан, берется 1-й из списка):	в данном пункте указывается ID реквизита покупателя. Если данное поле заполнено, то реквизиты будут браться не автоматически из контакта или компании, а именно из этого поля.
Создавать реквизит для физ. лица (если пустой):	варианты да/нет. в данном пункте указывается, создавать ли реквизиты для физического лица или нет. Если Вы хотите создать счет для физ. лица, у которого нет реквизитов, то следующие поля обязательны к заполнению: Статус счета; Срок оплаты в днях; ID компании продавца; ID реквизита организации продавца (если реквизитов несколько, то и поле "ID банковского реквизита продавца); ID способа оплаты из настроек CRM (для контакта. печатная форма); Создавать реквизит для физ. лица (если пустой); Какой тип реквизита создавать. ID пресета для физ. лица (Настройки CRM-->С чего начать-->Шаблоны реквизитов)
Какой тип реквизита создавать:	в данном поле нужно выбрать тип реквизита, который нужно создавать, Физ. лицо или ИП.
ID пресета ИП для физ. лица (если не указан, будет искаться с именем "ИП"):	в данном поле указывается ID пресета ИП для физ. лица.
ID пресета для физ. лица:	в данном поле указывается ID пресета(шаблона) для физ. лица.
Ставка НДС:	в данном поле нужно выбрать из выпадающего списка ставку НДС, которая будет применяться при выставлении счета. Сами ставки настраиваются в настройках CRM в пункте "налоги".
Принудительно выставлять НДС:	позволяет принудительно выставить НДС, выбрав нужный параметр из выпадающего меню.
Предустановленные товары (ID##количество##ед. измерения (буквами)##цена):	позволяет добавить в счет товары из каталога. Если Вам нужно добавить товар из каталога, но при этом его название в счете должно быть отличным от каталожного, то после указания цены нужно добавить ## и указать нужное название товара. Это не изменит название товара в каталоге, но в конкретно созданном счете оно будет другим.   Пример:  Название товара по каталогу "Продление интернета_50Мбит" , в счете нужно назвать Продление интернета_50Мбит для ООО "КаршерингMSK" Заполняем так: 1684##1##шт##35000##Продление интернета_50Мбит для ООО "КаршерингMSK"
Выставить счёт на остаток товаров в сделке:	варианты да/нет. Позволяет выставить счет на разницу товаров указанных в сделке и товаров, которые уже имеются в счетах, при условии, что количество товаров и суммы в счетах не будут превышать аналогичные значения в сделке. Т.е если есть счет, где к примеру продано 5 авто и 4 сникерса, а новый счет выставляется с количеством 7 авто и 4 сникерсами, то активировав данную настройку, в новом счете будет 2 авто, а сникерсы в счет не попадут.
Частичная оплата (в процентах, по-умолчанию 100):	в данном пункте указывается процентная составляющая предоплаты.
Фиксированная сумма предоплаты:	позволяет указать фиксированную сумму предоплаты.
Сократить сумму за счет:	в данном поле можно выбрать за счет чего будет сокращена сумма за счет. Варианты: стоимость товара/количество товара.
Округлять до целых (при расчете частичной оплаты):	варианты да/нет. Позволяет указать округлять ли до целых чисел, при расчете частичной оплаты или нет.
Комментарий к счёту (скрытый для покупателя):	позволяет добавить комментарий к счету, который будете видеть только Вы.

Если Сделка создана с компанией у которой нет реквизитов, то счет не выставится даже когда они будут добавлены в компанию, т.к. реквизиты привязываются к сделке.
Решение - перевыбрать компанию в Сделке.

Если вы столкнулись с такой ошибкой при выполнении активити: во время создания счета была обнаружена ошибка: Не введено значение обязательного поля "Печатная форма счёта" , нужно заполнять поле "ID способа оплаты из настроек CRM (для компании)". ID этого способа можно посмотреть в настройках способов оплаты вашего портала.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID созданного счета.
- ID нового реквизита.
- Сообщение об ошибке.

Поиск счета(новые)

Данное активити позволяет осуществлять поиск элементов смарт-процесса тип "счет".

Сценарий работы активити бизнес-процесса

Название	Описание
Название:	в данном поле нужно указать название искомого счета.
Ответственный:	в данном поле указывается ответственный за счет, который будет искать активити.
Доступно для всех:	выпадающий список с вариантами да/нет. Позволяет указать доступен ли данный счет для всех или для конкретных пользователей.
Создано CRM-формой:	в данном поле указывается ID CRM формы (Контакт-центр->Форма на сайт), с помощью которой элемент был создан.
Поля "Дата начала" и "Дата завершения":	в этих полях указывается дата начала и завершения работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
ID компании:	в данном поле указывается ID компании с которой искомый элемент (счет) связан.
ID контакта:	в данном поле указывается ID контакта с которым искомый элемент (счет) связан.
ID связанной сделки:	в данном поле указывается ID сделки с которой искомый элемент (счет) связан.
Стадия:	в этом поле из выпадающего списка нужно выбрать стадию, на которой элемент (счет) находится.
Источник:	в данном поле указывается источник элемента. Значения берутся из одноимённого справочника CRM.
Дополнительно об источнике:	в этом поле указываются дополнительные данные об источнике.
Сумма:	в этом поле указывается общая денежная сумма по элементу.
Сумма налога:	в этом поле указывается сумма налога в денежном эквиваленте. Т.е если у Вас сумма товаров в сделке на 3000р и ставка налога составляет 10%, то сумма налога будет 10% от 3000, т.е 300р.
Валюта:	в этом поле указывается валюта, в которой выставлен счет.
Реквизиты Вашей компании:	в этом поле указывается ID реквизита Вашей компании, в которой был выставлен счет.

Для поиска счета с суммой 0, нужно в поле "Сумма" указать не 0, а ##.
Так же, стоит учитывать, что поиск по названию не поддерживает спец. символы. Т.е если в названии есть "№" или подобные символы, то активити не найдет счет с таким названием.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Сообщение об ошибке.

Слежение за статусом счета(новые)

Данное активити позволяет отслеживать статус смарт счета, при условии, что известен его ID.

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса: в этом поле указывается ID типа смарт-процесса за статусом которого наблюдает активити. Для смарт процессов тип "счет" этот ID всегда 31.

Направление: это поле доступно только при первичной настройке и позволяет указать направление, к которому относятся элементы смарт процесса с которыми планируется работать.

ID счета (условие): в данном поле нужно указать ID счета, за статусом которого активити будет наблюдать.

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

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Статус счета;
- Название статуса счета;
- ID счета;
- Сообщение об ошибке.

 

Удалить счет(новый)

Данное активити позволяет удалить элемент смарт процесса тип "счет".

Сценарий работы активити бизнес-процесса

ID счета: в данном поле нужно указать ID элемента смарт-процесса тип "счет", который нужно удалить. Этот элемент сп, по сути и является счетом.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Изменить счет(новый)

Данное активити позволяет изменить элемент смарт-процесса тип "счет".
Созданные этим активити элементы будут являться "счетами" и отобразятся в сущности, во вкладке "Счета".

Сценарий работы активити бизнес-процесса

Название	Описание
ID счета:	в этом поле нужно указать ID элемента смарт-процесса тип "счет".
Название:	в данном поле указывается название изменяемого счета.
Ответственный за счет:	в этом поле нужно указать ID сотрудника, который будет ответственен за измененный счет.
Доступно для всех:	в данном поле указывается, будет ли данный счет общедоступным или нет.
Создано CRM-формой:	в данном пункте указывается ID компании указываются специфические данные, которые можно получить при создании счет с помощью CRM-форм.
ID компании:	в этом поле указывается ID компании, на которую выставлен счет.
ID контакта:	в этом поле указывается ID контакта, на который выставлен счет.
ID связанной сделки:	в этом поле указывается ID сделки, к которой данный счет имеет отношение.
Наблюдатели:	в данном поле можно указать сотрудника, который будет наблюдателем в счете после его изменения.
Статус счета:	в этом поле из выпадающего списка нужно выбрать статус, в котором будет находиться счет после изменения.
Источник:	в этом поле можно указать идентификатор источника из соответствующего каталога
Сумма:	в этом поле нужно указать общую сумму за товары в счете.
Сумма налога:	в данном поле указывается сумма налога, в которой был создан счет, значение указывается не в процентной составляющей.
Валюта:	в данном поле указывается валюта в которой выставлен счет.
Реквизиты Вашей компании:	в этом поле нужно указать ID реквизитов компании-продавца из каталога реквизитов (CRM-> Настройки-> С чего начать-> Реквизиты ваших компаний)

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения.
- Сообщение об ошибке.

 

Получение данных по счету(новому)

Данное активити позволяет получить данные по элементу смарт-процесса тип "счет".

Сценарий работы активити бизнес-процесса

ID счета: в данном поле нужно указать ID элемента смарт-процесса тип "счет", данные которого нужно получить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Название;
- Ответственный;
- Создано CRM-формой;
- Дата начала;
- Дата завершения;
- ID компании;
- ID контакта;
- ID связанной сделки;
- Статус счета;
- Источник;
- Дополнительно об источнике;
- Сумма;
- Сумма налога;
- Валюта;
- Реквизиты Вашей компании;
- Результат выполнения;
- Сообщение об ошибке.

 

Товары

Получение товара из сущности

Данное активити позволяет отобразить товарные позиции сущности в виде таблицы. 

Сценарий работы активити бизнес-процесса

Тип Сущности: выбор типа сущности, товарные позиции которой будут отображены.

Способ вывода таблицы: позволяет вывести получаемый результат в виде таблицы.
На выбор доступно 2 способа вывода: В виде HTML и BBCode.

ID сущности: ID сущности, из которой будут взяты товарные позиции.

Если в возвращаемых параметрах с названием "ID товаров (массив)" у Вас есть нули, то позиция не является товаром, а является текстовым описанием.
Такое является следствием ручного ввода товара, а не выбором его из списка.

Тип Сущности (при выбранных смарт-процессах): этот параметр работает только при условии, если в обязательном для заполнения поле "Тип сущности" выбрано "Смарт-процесс".
Позволяет выбрать из списка смарт-процесс из которого активити будет получать товары.

Включить количество в таблицу: включение данных о количестве товара в выводимую таблицу.

Включить цену в таблицу:  включение данных о цене товара в выводимую таблицу.

Включить сумму в таблицу: включение данных об общей сумме товара в выводимую таблицу.

Делать отладочные сообщения в журнал БП: вывод отладочных данных в журнале бизнес-процесса.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов.
Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания.
Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Товарные позиции;
- ID товаров (массив);
- Сообщение об ошибке;

Перенос товаров в другую сущность

Данное активити позволяет осуществить перенос и копирование товаров из одной сущности в другую, зная ID и тип сущности из и в которую необходимо осуществить перенос.

Сценарий работы бизнес-процесса

Тип сущности (из которой берутся товары):  выбор типа сущности из которой будет осуществлен перенос товаров.

Активити работает со следующими типами товаров: Лид, Сделка, Счет, Ком. предложение, Смарт-процесс.

ID сущности (из которой берутся товары): в данном поле указывается ID сущности из которой будет осуществлен перенос товаров.

Тип сущности (куда перемещаются товары): выбор типа сущности в которую будет осуществлен перенос товаров.

ID сущности (куда перемещаются товары): в данном поле указывается ID сущности в которую будет осуществлен перенос товаров.

Что делаем с существующими товарами: действие этой настройки относится к сущности, в которую происходит перенос товара. Данный пункт меню позволяет выбрать, оставить или удалить товар, который уже есть в сущности.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:  в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Добавление товаров к сущности

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

Сценарий работы бизнес-процесса

Тип сущности: в данном поле указывается в какой тип сущности будет добавлен товар.

Если вы работаете с новыми счетами, то вы должны использовать роботы из категории "смарт процессы" и ID смарт процесса всегда будет "31", именно ID, а не идентификатор типа. Данный смарт-процесс присутствует на портале, но по умолчанию скрыт в компонентах. Перейти в него можно отредактировав ссылку в браузере.

Внимание! Режим работы с заказами больше не поддерживается в Битрикс24.

• Если вы уже работаете в режиме «Сделки + Заказы», то он продолжит работать без изменений.
• При переходе в «Сделки» вернуться в режим «Сделки + Заказы», не получится.
• Информация в данной статье применима к режиму «Сделки + Заказы».

Подробнее читайте в статье Как в магазине работать без заказов.

ID сущности: в данном пункте указывается ID  сущности, в которую будет добавлен товар.

Товары (ID##количество##ед. измерения##цена##название): в данный пункт добавляют товары из предустановленного списка.
Заполняется в таком порядке и через разделители "##" : ID##количество##ед. измерения##цена##название.

Указав название отличное от того, что в каталоге, товар в сущность будет добавлен с указанным в настройках активити названием.

Что делаем с существующими товарами: в данном пункте выбирается оставить товары, которые уже были в сущности или удалить.

ВАЖНО!
Данное активити не работает с типом поля "Деньги".
Так же данным активити нельзя добавлять более 3 одинаковых товаров в рамках одного БП.

Сообщение об ошибке: в данном пункте указывается надо выводить сообщения об ошибке или нет.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы бизнес-процесса

Возвращаемые параметры для данного активити:
Результат выполнения (good_operation): Y - удачно, N - ошибка.
Результат выполнения - текст (да/нет)

Удаление товара

Данное активити позволяет удалять товар из каталога, указав его ID.

Сценарий работы бизнес-процесса

 






















ID товара: в данном пункте указывается ID товара, который планируется удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
1 - успешное удаление.
0 - удалить товар не удалось.

Редактирование товара

Данное активити позволяет изменять поля сущности "Товар".

Сценарий работы бизнес-процесса

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
ID:	В данном пункте указывается ID редактируемого товара.
Каталог:	В данном пункте указывается ID каталога.
Цена:	В данном пункте указывается цена товара.
Валюта:	В данном пункте указывается валюта расчетов, указанная в товаре
Название:	В данном пункте указывается название товара.
Описание:	В данном пункте указывается описание товара.
Тип описания:	В данном пункте указывается значение:1,2,3. Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Активен:	Доступно значение: да/нет. В данном поле указывается доступность товара.
Раздел:	В данном пункте указывается ID раздела.
Сортировка:	В данном поле указывается индекс сортировки товара.
Ставка НДС:	В данном пункте указывается ставка НДС, указанная в товаре.
НДС включён в цену:	Доступно значение: да/нет. В данном пункте указывается включен ли НДС в стоимость товара.
Единица измерения:	В данном пункте указывается единица измерения, указанная в товаре
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Для работы с полем тип "Привязка к сотруднику" используйте числовое значение без доп. символов или букв.
Пример заполнения поля: 12345 , где 12345 - ID сотрудника.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Создание товара

Данное активити позволяет создать товар в CRM.

Сценарий работы бизнес-процесса

Название	Описание
Каталог:	В данном пункте указывается ID каталога.
Цена:	В данном пункте указывается цена товара
Валюта:	В данном пункте указывается валюта, указанная в товаре
Название:	В данном пункте указывается название товара
Описание:	В данном пункте указывается описание товара
Тип описания:	В данном пункте указывается значение:1,2,3. Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Активен:	Доступно значение: да/нет. В данном поле указывается доступность товара.
Раздел:	В данном пункте указывается ID раздела.
Сортировка:	В данном поле указывается индекс сортировки товара.
Ставка НДС:	В данном пункте указывается ставка НДС.
НДС включен в цену:	Доступно значение: да/нет. В данном пункте указывается включен ли НДС в стоимость товара.
Единица измерения:	В данном пункте указывается единица измерения, указанная в товаре
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- ID нового товара.
- Сообщение об ошибке.

Поиск Товара (v.2)

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

Активити работает с товарами CRM, корректная работа с товарами каталога - НЕ ГАРАНТИРУЕТСЯ

Сценарий работы активити бизнес-процесса

Поле "Условие для…" : в данных полях указывается условия для соответствия для полей (равно/неравно, больше или равно, меньше или равно,больше/меньше).

Название	Описание
Сообщение об ошибке:	Варианты:да/нет. Позволяет выводить ошибки в журнал БП.
ID:	В данном пункте указывается ID искомого товара.
Каталог:	В данном пункте указывается ID каталога.
Цена:	В данном пункте указывается цена товара
Валюта:	В данном пункте указывается валюта, указанная в товаре
Название:	В данном пункте указывается название товара
Описание:	В данном пункте указывается описание товара
Тип описания:	В данном пункте указывается значение:1,2,3. Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Раздел:	В данном пункте указывается ID раздела.
Ставка НДС:	В данном пункте указывается ставка НДС, указанная в товаре.
Единица измерения:	В данном пункте указывается единица измерения, указанная в товаре
Внешний код:	Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:<варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска для итератора;
- Результат поиска строка;
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Соответствует условиям;
- Сообщение об ошибке.

Получение данных по сущности товар

Данное активити позволяет получить все данные по сущности "товар" в том числе и из пользовательских полей.

Сценарий работы активити бизнес-процесса

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

ВАЖНО!
Данное активити не работает с массивами.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Все параметры из сущности "Товар", включая данные пользовательских полей.

Получение товаров из сущности заказ

Данное активити позволяет получить ID товаров из сущности "заказ"

Сценарий работы бизнес-процесса

ID заказа: в этом поле указывается ID заказа из которого планируется получить ID товаров.

Внимание! Режим работы с заказами больше не поддерживается в Битрикс24.

• Если вы уже работаете в режиме «Сделки + Заказы», то он продолжит работать без изменений.
• При переходе в «Сделки» вернуться в режим «Сделки + Заказы», не получится.
• Информация в данной статье применима к режиму «Сделки + Заказы».

Подробнее читайте в статье Как в магазине работать без заказов.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле нужно для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это нужно для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно нужно для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Результат поиска (Массив для итератора); - ID товаров+ количество (Массив для итератора);
- ID товаров+ сумма (Массив для итератора);
- ID товаров+ количество+ цена (Массив для итератора);
- Всего найдено (Массив для итератора);
- Результат поиска;
- ID товаров+ количество;
- ID товаров+ количество+ цена;
- ID товаров+ сумма;
- Соответствует условиям;
- Сообщение об ошибке.

Получение параметров товаров из сущности

Данное активити позволяет отобразить товарные позиции сущности в виде таблицы. 

Сценарий работы активити бизнес-процесса

Тип Сущности: выбор типа сущности, товарные позиции которой будут отображены.

ID сущности: ID сущности, из которой будут взяты товарные позиции.

Условие отбора: в этом поле нужно указать параметры, которые вы хотите получить в результате работы активити.
Пример заполнения:  1#1, где 1 до решетки - номер товарной позиции, 1 после решетки - номер параметра товарной позиции.
Разделителем между параметрами является пробел.
Товарные позиции:

• 1- ID товара;
• 2- Название товара;
• 3 - Количество товара;
• 4 - Цена;
• 5 - Сумма;
• 6 - Налог;
• 7- Скидка.
  

 1#1 1#2 1#3 - вернет в доп. параметрах 2658 Tesla Model X 10 , где 2658- ID товара, Tesla Model - название товара, 10 - количество товара.

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

Делать отладочные сообщения в журнал БП: вывод отладочных данных в журнале бизнес-процесса.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы активити бизнес-процесса

Возвращаемые параметры данного активити:
- Данные товара.
- Сообщение об ошибке.

Редактирование количества и перенос товара между сущностями

Активити позволяет изменить количество товара (прибавить/вычесть), удалить совпадающие позиции, либо взять товар из одной сущности и перенести в другую. Кроме того можно добавить или удалить товар из каталога в выбранную CRM сущность.

Сценарий работы активити бизнес-процесса

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

1. Добавить товар - позволяет добавить товар параметры которого указаны в поле "Товар"; 
2. Удалить товар - позволяет удалить товар, ID которого указан в поле "Товар"; 
3. Вычесть количество от существующего товара - позволяет вычесть количество ед. товара из товарной позиции, ID которой указан в п.м "Товары".
   
   Если активна опция "Взять товары из текущей сущности", то данная операция позволяет вычитать количество товара, который есть в сущности А из количества товаров аналогичной товарной позиции в сущности Б.
   БП в таком случае должен запускаться из сущности A, а ID сущности Б должен быть указан в п.м "ID сущности".
   
4. Прибавить количество к существующему товару - позволяет прибавить количество ед. товара к товарной позиции, ID которой указан в п.м "Товары".
   
   Если активна опция "Взять товары из текущей сущности", то данная операция позволяет прибавить количество товара, который есть в сущности А к количеству товаров аналогичной товарной позиции в сущности Б.
   БП в таком случае должен запускаться из сущности A, а ID сущности Б должен быть указан в п.м "ID сущности".
   
5. Удалить совпадения товаров в сущности - работает в паре с п.м "Взять товары из текущей сущности", и позволяет уравнять количество ед. товара товарной позиции, ID которой указан в п.м "Товары".
   "Уравнивание" происходит на основе сущности из которой произошел запуск БП.

Принцип работы операций, если включена опция "Взять товары из текущей сущности":

Вычесть количество от существующего товара: А-B;
Если в п.м "Товар" указано количество товара (С), то товар будет вычтен по формуле: (А-В)-С; 

Прибавить количество к существующему товару: A+B;
Если в п.м "Товар" указано количество товара (С), то товар будет добавлен по формуле: (А+В)+С;

Удалить совпадения товаров в сущности: количество ед. товара товарной позиции в сущности Б, становится равным количеству Аналогичному товару в сущности из которой запустили БП. 

Вычитание, добавление и "Удаление совпадения" товара из других типов сущностей в смарт процесс ВОЗМОЖЕН и работает так же, как и с другим типом сущностей.

Тип сущности: позволяет выбрать из выпадающего списка тип сущности с которой будет работать активити.
Доступны варианты: Лид, Сделка, Счет (обычный, не смарт), Ком. Предложение, Смарт-процесс. 

Активити поддерживает перенос товаров ТОЛЬКО в рамках одного типа сущности.
Если вы хотите перенести товар из сущности одного типа в сущность другого типа, то это работать не будет.

ID сущности: указывается ID сущности с которой будут проводиться те или иные операции.

При работе с типом сущности "Смарт-процесс", содержимое поля заполняется так:  ID см.-процесса_ID элемента см.-процесса.
Пример: 182_7.

Взять товары из текущей сущности: варианты да/нет.
Активация данного п.м необходима при использовании параметров "Вычесть количество от существующего товара", "Прибавить количество к существующему товару", "Удалить совпадения товаров в сущности".

Заполнение поля "Товары" опционально, если активен п.м "Взять товары из текущей сущности", т.к товар берется из сущности, где он уже есть. 

Товары: поле предназначено для указания ID товара, а так же его количества, цены, и названия.
Указание количества, цены и названия опционально.

Поле заполняется в формате ID##количество##цена## название.
Когда требуется указать только ID товара, то в поле указывается только ID товара, без разделителя "##".
Если требуется указать ID товара и количество, то указывается ID##количество , без разделителя "##" после количества.
С ценой и названием по той же логике.

Активити работает ТОЛЬКО с товарами из каталога.
Если не указать количество товара, то по умолчанию будет прибавлена или вычтена 1 ед. товара.
Для параметра "Удалить совпадения товаров в сущности", указание единиц товара не требуется.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:

- Результат выполнения Да/Нет(Y/N).
- Сообщение об ошибке.

Замена товара в товарной позиции

Данное активити позволяет отобразить товарные позиции сущности в виде таблицы. 

Сценарий работы активити бизнес-процесса

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

ID сущности: указывается идентификатор сущности в которой будет заменен товар.

Товар под замену:указывается ID товара, который будет заменен в сущности.

Товар на который надо заменить: указывается ID товара, который будет добавлен в сущность вместо товара, который там был до этого.

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

Запускать от имени:  данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает.
Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге.
Особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.
Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов.
Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания.
Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

Возвращаемые параметры данного активити:
- Товарные позиции;
- ID товаров (массив);
- Сообщение об ошибке;

Чат и боты

Для того, чтобы сделать чат-бота, наносящего пользу вашему бизнесу, не нужно сложное программирование - нужны дополнительные действия в бизнес-процессах Битрикс24 из Приложений24. Мы пройдёмся по всем этапам создания чатботов от момента регистрации на портале до обучения чатбота понимать клиента или коллегу по работе. Покажем, как создать чат-бота в Битрикс24 с помощью приложения "Лаборатория бизнес-процессов" и решать следующие задачи: 

1. 17:42 - Провести первичное общение с клиентом в открытой линии. 

2. 01:10:00 - Создать чат-бота помощника, который будет подсказывать наличие товара в интернет-магазине. 

3. 29:55 - Создать чат-бота для согласования документов и дел в карточках CRM и чате. 

4. 01:30:34 - Создать чат-бота, который может давать ответы на часто задаваемые вопросы как клиентов, так и сотрудников.

Примеры бизнес-процессов, которые описаны в видеоролике - СКАЧАТЬ

Создание чата

Данное активити позволяет создать новый чат и пригласить туда участников.

Сценарий работы активити бизнес-процесса

Тип чата: данное поле позволяет указать тип чата, который будет создан, т.е открытый для вступления или внутренний чат (закрытый).

Заголовок чата: в данном поле указывается заголовок чата.

Создавать чаты с помощью активити из нашего приложения "Лаборатория роботов" или "Лаборатория БП" и писать сообщения в них (как и любые другие действия) могут только чат-боты, которые созданы с использованием нашего приложения, т.к у них есть права доступа к приложению, сторонние чат-боты работать не будут.

Описание чата: в данном поле указывается заголовок чата.

Цвет чата: в данном поле можно выбрать из выпадающего списка цвет чата.

Единственный способ создать чат с привязкой к сущности, это с помощью штатного активити "Изменение наблюдателей".
В данной процедуре очень Важна очередность действий, и это де-факто костыль.

Процедура такая:
1. Создаете БП с активити "Изменение наблюдателей" и указываете одного или нескольких наблюдателей в его настройках.
2. Далее в ручную или роботом из сущности запускаете этот БП, у Вас добавятся наблюдатели, но сам созданный чат вы не увидите.
3. Далее, инициируете создание чата, нажатием на область чата в самой сущности, и после этих действий, все наблюдатели в него подтянутся.
  

Но есть нюанс: все наблюдатели, которые будут добавлены после создания чата с уже имеющимися наблюдателями в чат добавлены не будут и их придется приглашать, а для этого нужно знать ID чата.

Тип сущности (Тип сущности для привязки): в этом поле указывается тип сущности к которой будет прикреплен чат.
На данный момент для работы доступны 3 типа сущностей: Лид, Сделка, Контакт, Компания, Счет, Предложение, Смарт-процесс.
Сущность выбирается из выпадающего списка, однако можно указать тип сущности в дополнительном поле.

Пример заполнения типов сущностей:
Лид: LEAD
Сделка: DEAL
Контакт: CONTACT
Компания: COMPANY
Счет: SMART_INVOICE
Предложение: QUOTE
Смарт-процесс: DYNAMIC_ID Типа СП

ID сущности:ID сущности (число) в этом поле указывается идентификатор сущности, к которой будет привязан чат.
Для Смарт-процесса формат заполнения поля немного иной: DYNAMIC_id смарт-процесса|id элемента смарт-процесса.
Пример заполнения:
Лид: 123
Сделка: 456
Смарт-процесс: DYNAMIC_123|456

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

Участники чата(указать одного или более пользователя): в данном поле указываются ID участников чата. 

Участники чатов добавляются только поименно, нельзя добавлять участников отделами или как-либо еще.
Правильное заполнение участников чата: Николай Администратор [13]; Вадим Кириленко [1643]; Игорь Куницын [2868], при этом ID пользователей должны быть внутри квадратных скобок.

Аватар чата (ссылка на картинку): в данном поле ссылка на картинку, которая будет аватаркой чата. Ссылка должна быть публично - доступной для скачивания.
Даже если картинка находится на диске облака, то указывается ссылка, а не ID файла из облака. 

Создавая чат, нужно сразу же добавлять в него хотя бы 1 пользователя и чат-бота (при необходимости).

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- ID созданного чата
- Успех создания чата
- Таймаут операции

Исключение участников из чата

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

Сценарий работы активити бизнес-процесса

ID чата: указывается идентификатор чата, из которого планируется удалить сотрудника(ов).

Удалять сотрудников из чата может только владелец чата, это значит, что активити должно быть запущено от имени владельца чата.
При этом владелец чата должен быть администратором приложения, чтобы активити сработало.

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

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.

Возвращаемые параметры для данного активити:
- Успех операции;
- Сообщение об ошибке.

Отправить сообщение в чат от человека

Данное активити позволяет отправить сообщение в чат от человека от имени которого запускается данное активити.

Сценарий работы активити бизнес-процесса

Куда отправить сообщение: в этом поле из выпадающего списка можно выбрать куда или кому будет отправлено сообщение.
Варианты :

Сотруднику.

В чат.

Если выбрано значение "сотрудник", то ID сотрудника нужно указать в поле ID чата.

ID чата: в данном пункте указывается ID чата, в который планируется отправить сообщение. (или ID сотрудника, если в поле выше выбрано значение "сотрудник")
Примеры заполнения:

12345 , где 12345, это ID чата.

Если в поле передается массив с ID - {=A12345_6789_98745_43210:search_results_array} , где {=A12345_6789_98745_43210:search_results_array} - массив.

Если в поле передается строка с ID -  {=A42670_95917_50084_86351:search_results_string} , где {=A42670_95917_50084_86351:search_results_string} - строка.

Если в поле передается переменная с ID - {=Variable:Variable1} ,где {=Variable:Variable1} - переменная.

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

Текст сообщения: в этом поле нужно указать текст отправляемого сообщения в формате TEXT или BBcode.

В виде системного сообщения: варианты да/нет , выбрав "ДА", сообщение в чат будет выведено в виде системного сообщения, но не от имени пользователя.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Сообщение об ошибке.

Создание сообщения в чат от робота

Данное активити позволяет создать сообщение в чат от имени робота.

Сценарий работы активити бизнес-процесса

ID чат-бота: в данном поле указывается ID чат-бота, от имени которого будет отправлено сообщение.
ID чат-бота можно узнать, перейдя в его профиль в структуре компании (раздел сотрудники ->чат-боты) и просмотрев в URL его ID
Пример: 
URL: xxx.xxxxxx.ru/company/personal/user/1679/, где 1679 является ID, бота.

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

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

ВАЖНО!
В конструкторе БП нельзя использовать более 5 наших активити подряд, т.к на 6 активити, БП зависнет, ввиду того, что Б24 не разрешает использование более 5 активити подряд.

Создавать чаты с помощью активити из нашего приложения "Лаборатория роботов" или "Лаборатория БП" и писать сообщения в них (как и любые другие действия) могут только чат-боты, которые созданы с использованием нашего приложения, т.к у них есть права доступа к приложению, сторонние чат-боты работать не будут.

Название Кнопки 1: в данном поле указывается название кнопки 1, которая располагается под текстом сообщения.
Цвет текста Кнопки 1 (например, черный - 000): в данном поле указывается цвет текста кнопки 1 в формате "hex".
Цвет кнопки 1 (например, зеленый - d2f95f): в данном поле указывается цвет кнопки 1 в формате "hex".

Название Кнопки 2: в данном поле указывается название кнопки 2, которая располагается под текстом сообщения.
Цвет текста Кнопки 2 (например, черный - 000): в данном поле указывается цвет текста кнопки 2 в формате "hex".
Цвет кнопки 2 (например, красный - f1361b): в данном поле указывается цвет кнопки 2 в формате "hex".

Название Кнопки 3: в данном поле указывается название кнопки 3, которая располагается под текстом сообщения.
Цвет текста Кнопки 3 (например, черный - 000): в данном поле указывается цвет текста кнопки 2 в формате "hex".
Цвет кнопки 3 (например, прозрачный - f9fafb): в данном поле указывается цвет кнопки 2 в формате "hex".

Вариант работы чат-бота: в данном поле можно указать по какому сценарию чат-бот будет отправлять сообщение.
Доступно 3 варианта:

• Отправить сообщение без кнопок, и ожидать ответ.
• Отправить сообщение без кнопок, и не ожидать ответ.
  
• Отправить сообщение с кнопками, и ожидать ответ.

Текст сообщения: в данном поле указывается текст отправляемого сообщения.

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

Делать отладочные сообщения в журнал БП: варианты да/нет.
В данном поле указывается нужно ли делать отладочные сообщения в журнале БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

ВАЖНО!
Запускать данное активити необходимо от имени Чат-бота, иначе активити может не сработать и вывести сообщение об ошибке.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Ответ пользователя(вернет текст ответа только если выбран вариант "Отправить сообщение без кнопок, и ожидать ответ" ). - Какая кнопка нажата.
- ID привязанной сущности.
- ID чата.
- Сообщение об ошибке.

Поиск ID чата по названию или ФИО участников

Данное активити позволяет искать ID чата по названию чата или ФИО участников при помощи бизнес-процесса.
Результатом работы данного активити будет получение ID чата в виде массива для итератора, строки и соответствия условиям поиска.

Сценарий работы активити бизнес-процесса 

Поисковая фраза: в данном поле указывается название чата или ФИО его участников.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса данное поле позволяет включать возможность установки статуса бизнес-процесса.
Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".

Возвращаемые параметры данного активити:
- Результат поиска (Массив для интегратора)
- Результат поиска (строка)
- Соответствует условиям

Добавление пользователя в чат открытой линии по CRM сущности

Данное активити позволяет искать ID чата открытой линии по сущности CRM и добавлять туда пользователя при помощи бизнес-процесса.

Сценарий работы активити бизнес-процесса

Тип CRM сущности: в данном поле указывается тип сущности CRM, к которой привязан чат, в который планируется добавлять пользователя.

ID CRM сущности: в данном поле указывается идентификатор сущности CRM к которой привязан чат.

С помощью данного активити НЕЛЬЗЯ добавлять пользователей в обычный чат, только в чат открытых линий.
Так же, другие активити для работы с обычными (открытыми/закрытыми) чатами не совместимы с данным активити.

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

Указывается только один ID бота или пользователя.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Успех добавления участников.

Добавление участников в чат

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

Сценарий работы активити бизнес-процесса

ID чата: в данном поле указывается ID чата.
Получить данный параметр можно их возвращаемых параметров активити "Создание чата" или "Создание сообщения в чат от робота".

Добавление участников в чат(указать одного или более пользователя): в данном поле указывается ID участников чата.

ID участника нужно указывать с использованием квадратных скобок. Пример: [12345].

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения.

Возвращаемые параметры для данного активити:
- Успех добавления участников.

Выход чат-бота из указанного чата

Данное активити позволяет вывести чат-бота из указанного диалога при помощи бизнес-процесса.

Сценарий работы активити бизнес-процесса

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

ID бота: в данном поле указывается ID бота выводимого из чата.
ID чат-бота можно узнать, перейдя в его профиль в структуре компании (раздел сотрудники ->чат-боты) и просмотрев в URL его ID.

ID нового владельца чата: в данном поле указывается ID пользователя, которого бот добавил в чат вместо себя.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Успех добавления участников.

Создание Чат-бота

Данное активити позволяет добавить чат-бота в ваш портал, чтобы потом вести диалоги от него через бизнес-процессы.

Сценарий работы активити бизнес-процесса

ID чата (если хотите добавить туда бота): в данном поле указывается ID чата, в который планируется добавить бота.
Получить данный параметр можно из возвращаемых параметров активити "Создание чата" или "Создание сообщения в чат от робота".

Код бота: в данном поле указывается уникальный идентификатор (латиницей), по которому можно распознать бота.

Имя бота: в данном поле указывается имя бота, которого планируется создать (латиницей)…

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

Чат-боты для открытых линий не поддерживают работу с кнопками из активити "создание сообщения в чат от робота"

Цвет бота: в данном поле указывается цвет используемый  для иконки бота или диалогового окна.

Почта для связи (если сообщение не прочитано, то отправиться на почту): в данном поле указывается e-mail на который будут присылаться уведомления, если бот недоступен.

ВАЖНО!
НЕЛЬЗЯ ИСПОЛЬЗОВАТЬ email зарегистрированного сотрудника на портале, для регистрации БОТА, нужно использовать технический адрес почты, не фигурирующий на портале.

Аватар бота (ссылка на картинку): в данном поле указывается ссылка на публично доступное изображение.
Даже если картинка находится на диске облака, то указывается ссылка, а не ID файла из облака.
Ограничение на тип изображений и их размер регулируются настройками портала.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

 Возвращаемые параметры для данного активити:
-ID созданного чат-бота

Смена владельца чата от лица чат-бота

Данное активити позволяет сменить владельца чата на другого от лица чат-бота.

Сценарий работы активити бизнес-процесса

ID чата: в данном пункте указывается ID чата, владельца которого надо сменить.

Новый владелец чата: в данном пункте указывается ID нового владельца чата.

ID чат-бота:в данном пункте указывается ID чат-бота, который участвует в чате, и от имени которого должна произойти смена владельца.

Чат-бот, от имени которого происходит смена владельца чата, должен быть его владельцем.
Данное активити можно использовать только для смены владельца чата с чат-бота на сотрудника или другого чат-бота.
Если владельцем чата является сотрудник, то данное активити не сможет сделать владельцем чата чат-бота из-за особенностей метода REST Б24.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- Успех смены владельца

Удаление чат-бота

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

Сценарий работы активити бизнес-процесса

ID бота: в данном поле указывается ID бота, которого надо удалить.
ID чат-бота можно узнать, перейдя в его профиль в структуре компании (раздел сотрудники ->чат-боты) и просмотрев в URL его ID

Код бота: в данном поле указывается код бота, которого надо удалить.
Данный код указывается при создании чат-бота, т.е тот, кто его создавал должен знать этот код. 

Имя бота: в данном поле указывается имя бота, которого надо удалить.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 

Возвращаемые параметры для данного активити:
- успех удаления чат-бота.

Смарт-процессы

Смарт-процессы

Создать новый смарт-процесс

Данное активити позволяет создать новый смарт-процесс.

Сценарий работы активити бизнес-процесса

Название:	В данном поле указывается название создаваемого смарт-процесса.
Символьный код:	В данном поле нужно указать латиницей символьный код смарт-процесса.
Использовать в смарт-процессе свои направления и туннели продаж:	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться пользовательские направления и туннели продаж.
Использовать в смарт-процессе свои стадии и канбан:	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться пользовательские стадии и канбан.
Поля "Дата начала" и "Дата завершения":	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться поля "Дата начала" и "Дата завершения" .
Поле "Клиент":	Данное поле позволяет выбрать, будет ли в созданном смарт-процессе использоваться поле "Клиент".
Использовать в пользовательском поле:	Данная настройка активирует возможность привязки пользовательских полей сущностей к смарт-процессу.
Привязка товаров каталога:	Данное поле позволяет активировать возможность привязки товаров из каталога. На данный момент работа с товарами в смарт процессах пока не доступна.
Поле "Реквизиты вашей компании":	Данное поле позволяет выбрать, будет ли в созданном смарт-процессе использоваться поле "Реквизиты вашей компании".
Печать документов:	Данный пункт меню позволяет активировать работу с печатной формой отчетов.
Поля "Источник" и "Дополнительно об источнике":	Данное поле позволяет выбрать, будут ли в созданном смарт-процессе использоваться поля "Источник" и "Дополнительно об источнике".
Поле "Наблюдатели":	Данное поле позволяет выбрать, будет ли в созданном смарт-процессе использоваться поле  "Наблюдатели".
Использовать корзину:	Данный пункт меню позволяет активировать использование корзины.
Использовать в смарт-процессе роботы и триггеры:	Позволяет активировать работу с роботами и триггерами в смарт процессе (аналогично запуску роботов и триггеров в сделках или лидах).
Использовать в смарт-процессе дизайнер бизнес-процессов:	Позволяет активировать работу с дизайнером БП в смарт процессе.
Делать новые направления доступными для всех:	Данная опция позволяет сделать новые направления при создании доступными для всех ролей пользователей.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового смарт-процесса;
- Сообщение об ошибке.

 

Удалить смарт-процесс

Данное активити позволяет удалить смарт-процесс.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в данном поле указывается ID удаляемого смарт-процесса.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Получить данные по смарт-процессу

Данное активити позволяет получить данные указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в этом поле нужно указать ID смарт-процесса, данные которого нужно получить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID;
- Название;
- Символьный код;
- Кем создан;
- Идентификатор типа смарт-процесса;
- Результат выполнения;
- Сообщение об ошибке.

 

Поиск смарт-процессов

Данное активити позволяет найти смарт-процесс по указанным параметрам.

Сценарий работы активити бизнес-процесса

Название:	В данном поле указывается название искомого смарт-процесса.
Символьный код:	В данном поле нужно указать латиницей символьный код смарт-процесса.
Использовать в смарт-процессе свои направления и туннели продаж:	Данное поле позволяет указать, используются ли в искомом смарт-процессе пользовательские направления и туннели продаж.
Использовать в смарт-процессе свои стадии и канбан:	Данное поле позволяет указать, используются ли в искомом смарт-процессе пользовательские стадии и канбан.
Поля "Дата начала" и "Дата завершения":	Данное поле позволяет указать, используются ли в искомом смарт-процессе поля "Дата начала" и "Дата завершения" .
Поле "Клиент":	Данное поле позволяет указать, используется ли в искомом смарт-процессе поле "Клиент".
Использовать в пользовательском поле:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данная настройка активирует возможность привязки пользовательских полей сущностей к смарт-процессу.
Привязка товаров каталога:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данное поле позволяет активировать возможность привязки товаров из каталога. На данный момент работа с товарами в смарт процессах пока не доступна.
Поле "Реквизиты вашей компании":	Данное поле позволяет указать, используется ли в искомом смарт-процессе поле "Реквизиты вашей компании".
Печать документов:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данный пункт меню позволяет активировать работу с печатной формой отчетов.
Поля "Источник" и "Дополнительно об источнике":	Данное поле позволяет указать, используются ли в искомом смарт-процессе поля "Источник" и "Дополнительно об источнике".
Поле "Наблюдатели":	Данное поле позволяет указать, используется ли в искомом смарт-процессе поле "Наблюдатели".
Использовать корзину:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром. Данный пункт меню позволяет активировать использование корзины.
Использовать в смарт-процессе роботы и триггеры:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром.  Позволяет активировать работу с роботами и триггерами в смарт процессе (аналогично запуску роботов и триггеров в сделках или лидах).
Использовать в смарт-процессе дизайнер бизнес-процессов:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром.  Позволяет активировать работу с дизайнером БП в смарт процессе.
Делать новые направления доступными для всех:	Если в искомом смарт-процессе активна данная настройка, то данное поле послужит доп. фильтром.  Данная опция позволяет сделать новые направления при создании доступными для всех ролей пользователей.

Если при запуске поиска смарт-процессов по фильтру "Ответственный" по конкретному сотруднику (обычно один из администраторов портала), активити выдает идентификаторы как реально существующих СП, привязку которых вы видите наглядно, так и тех, которые вы не видите наглядно (к примеру смарт-процесс с ID_31 (смарт-счета)), то стоит учитывать, что это может быть особенностью работы метода crm.type.list.

Ограничить количество результатов до: в этом поле указывается предельное количество результатов, которое вернет активити, значение указывается цифрой.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Сообщение об ошибке.

Изменить смарт-процесс

Данное активити позволяет изменить смарт-процесс.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в данном поле указывается ID изменяемого смарт-процесса.

Название:	В данном поле указывается название изменяемого смарт-процесса.
Символьный код:	В данном поле нужно указать латиницей символьный код смарт-процесса.
Идентификатор типа смарт-процесса:	В этом поле нужно указать ID типа смарт-процесса.
Использовать в смарт-процессе свои направления и туннели продаж:	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться пользовательские направления и туннели продаж.
Использовать в смарт-процессе свои стадии и канбан:	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться пользовательские стадии и канбан.
Поля "Дата начала" и "Дата завершения":	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться поля "Дата начала" и "Дата завершения".
Поле "Клиент":	Данное поле позволяет выбрать, будет ли в изменяемом смарт-процессе использоваться поле "Клиент".
Использовать в пользовательском поле:	Данная настройка активирует возможность привязки пользовательских полей сущностей к смарт-процессу.
Привязка товаров каталога:	Данное поле позволяет активировать возможность привязки товаров из каталога. На данный момент работа с товарами в смарт процессах пока не доступна.
Поле "Реквизиты вашей компании":	Данное поле позволяет выбрать, будет ли в изменяемом смарт-процессе использоваться поле "Реквизиты вашей компании".
Печать документов:	Данный пункт меню позволяет активировать работу с печатной формой отчетов.
Поля "Источник" и "Дополнительно об источнике":	Данное поле позволяет выбрать, будут ли в изменяемом смарт-процессе использоваться поля "Источник" и "Дополнительно об источнике".
Поле "Наблюдатели":	Данное поле позволяет выбрать, будет ли в изменяемом смарт-процессе использоваться поле  "Наблюдатели".
Использовать корзину:	Данный пункт меню позволяет активировать использование корзины.
Использовать в смарт-процессе роботы и триггеры:	Позволяет активировать работу с роботами и триггерами в смарт процессе (аналогично запуску роботов и триггеров в сделках или лидах).
Использовать в смарт-процессе дизайнер бизнес-процессов:	Позволяет активировать работу с дизайнером БП в смарт процессе.
Делать новые направления доступными для всех:	Данная опция позволяет сделать новые направления при создании доступными для всех ролей пользователей.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Мониторинг событий смарт-процессов

Данное активити позволяет мониторить события указанного Вами смарт-процесса.

Сценарий работы активити бизнес-процесса

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

Выпадающий список пункта меню "Смарт-процесс" содержит штатные смарт-процессы Б24, которые обычно скрыты от пользователя и не отображаются в в общем списке СП, созданных пользователями вручную или через бизнес-процесс.
Ответственным в этих смарт-процессах обычно является 1 из сотрудников, с правами администратора портала. 

Событие: в этом поле нужно из выпадающего списка нужно выбрать один из видов событий за которыми активити будет следить.
Варианты событий: Добавление/Изменение.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.

Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID смарт-процесса;
- Сообщение об ошибке.

 

Стадии

Добавить стадию смарт-процесса

Данное активити позволяет добавить новую стадию для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором будет добавлена стадия.

ID направления: в этом поле нужно указать ID направления в рамках которого будет создана стадия.

Название стадии: в данном поле указывается название стадии.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID новой стадии;
- Сообщение об ошибке.

 

Удалить стадию смарт-процесса

Данное активити позволяет удалить стадию указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором будет удалена стадия.

ID стадии: в данном поле указывается ID удаляемой стадии.

ID направления: в данном поле указывается ID направления в котором находится удаляемая стадия.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Получить данные по стадии смарт-процесса

Данное активити позволяет получить данные по стадии указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Идентификатор типа смарт процесса;
- ID направления;
- Сущность;
- Статус;
- Название стадии;
- Результат выполнения;
- Сообщение об ошибке.

 

Получить все стадии смарт-процесса

Данное активити позволяет получить все стадии указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором находится стадия.

ID направления: в данном поле указывается ID направления в котором находится стадия.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Сообщение об ошибке.

 

Изменить стадию смарт-процесса

Данное активити позволяет изменить стадию в указанном смарт-процессе.

Сценарий работы активити бизнес-процесса

ID стадии: в данном поле указывается ID изменяемой стадии.

Идентификатор типа смарт-процесса: в данном поле указывается ID смарт-процесса в котором находится стадия.

ID направления: в этом поле нужно указать ID направления в котором содержится стадия.

Название стадии: в данном поле указывается название стадии.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Направления

Создать новое направление смарт-процесса

Данное активити позволяет создать новое направление для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID смарт-процесса в котором будет создано направления.

Имя направления: в этом поле нужно указать имя создаваемого направления.

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового направления;
- Сообщение об ошибке.

 

Удалить направление смарт-процесса

Данное активити позволяет удалить направление для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID смарт-процесса в котором будет удалено направление.

ID направления: в этом поле нужно указать ID удаляемого направления.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Получить данные по направлению смарт-процесса

Данное активити позволяет получить данные о направлении для указанного смарт-процесса.

Сценарий работы активити бизнес-процесса.

Идентификатор процесса: в данном поле указывается ID смарт-процесса в котором содержится направление, данные по которому планируется получить.

ID направления: в этом поле нужно указать ID направления.

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Имя направления;
- Результат выполнения;
- Сообщение об ошибке.

 

Получить все направления смарт-процесса

Данное активити позволяет получить все направления указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID смарт-процесса направления которого нужно получить.

Ограничить количество до: в этом поле нужно указать ограничение по количеству получаемых результатов в виде числового значения.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Сообщение об ошибке.

 

Изменить данные направления смарт-процесса

Данное активити позволяет изменить данные направления указанного смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в данном поле указывается ID процесса в котором находится изменяемое направление.

ID направления: в этом поле нужно указать ID направления, данные которого будут изменены.

Имя направления: в этом поле нужно указать имя изменяемого направления.

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

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Элементы

Создать новый элемент смарт-процесса

Данное активити позволяет создать новый элемент смарт-процесса.

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса:	в данном поле нудно указать ID типа смарт-процесса, в котором будет создан новый элемент.
Название:	в этом поле указывается название нового элемента.
Ответственный:	в данном поле указывается ID сотрудника, который будет ответственным за создаваемый элемент.
Доступно для всех:	в данном поле из выпадающего списка нужно выбрать будет ли данный элемент общедоступен (виден), варианты да/нет.
Создано CRM-формой:	в данном поле указывается ID CRM формы (Контакт-центр --> Форма на сайт), с помощью которой элемент был создан.
Дата начала:	в этом поле указывается дата начала работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Дата завершения:	в этом поле указывается дата завершения работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Компания:	в данном поле указывается ID компании с которой данный элемент будет связан.
Контакт:	в данном поле указывается ID контакта с которым данный элемент будет связан.
Наблюдатели:	в данном поле указывается ID сотрудника, который будет в роли наблюдателя в создаваемом элементе.
Направление:	в данном поле указывается ID направления, к которому создаваемый элемент будет относиться.
Реквизиты Вашей компании:	в данном поле указываются ID реквизитов Вашей компании.

   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового элемента;
- Сообщение об ошибке.

Получить данные по элементу смарт-процесса

Данное активити позволяет получить данные по элементу смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID типа смарт-процесса.

ID элемента: в этом поле нужно указать ID элемента смарт-процесса, данные которого нужно получить.

Активити работает только с простыми типами полей: строка, целое число, число, дата/время, дата, да/нет, адрес, ссылка, приваязка к справочникам CRM, привязка к элементам CRM. Поля, которых нет в данном списке - не поддерживаются ввиду того, что БП используют ограниченные типы полей, которые нельзя считать и передать. Если у Вас возникают вопросы по расширению списка поддерживаемых полей, рекомендуем обратиться в ТП Б24.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Название;
- Внешний код;
- Создано CRM-формой;
- ID компании;
- ID контакта;
- Направление;
- ID связанного лида;
- ID связанной сделки;
- ID связанного предложения;
- ID связанного заказа;
- Стадия;
- Предыдущая стадия;
- Источник;
- Сумма;
- Валюта;
- Реквизиты Вашей компании;
- Результат выполнения;
- Сообщение об ошибке.

Удалить элемент смарт-процесса

Данное активити позволяет удалить элемент смарт-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор типа смарт-процесса: в данном поле указывается ID типа смарт-процесса.

ID элемента: в этом поле нужно указать ID элемента смарт-процесса, который нужно удалить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Изменить данные элемента смарт-процесса

Данное активити позволяет изменить элемент смарт-процесса.

Сценарий работы активити бизнес-процесса

ID типа смарт-процесса:	в данном поле нудно указать ID типа смарт-процесса, в котором будет изменен элемент.
ID элемента:	в этом поле нужно указать ID изменяемого элемента смарт-процесса.
Название:	в этом поле указывается название изменяемого элемента.
Внешний код:	в данном поле нужно указать внешний код элемента.
Ответственный:	в данном поле указывается ID сотрудника, который будет ответственным за элемент.
Доступно для всех:	в данном поле из выпадающего списка нужно выбрать будет ли данный элемент общедоступен (виден), варианты да/нет.
Создано CRM-формой:	в данном поле указывается ID CRM формы (Контакт-центр->Форма на сайт), с помощью которой элемент был создан.
Дата начала:	в этом поле указывается дата начала работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Дата завершения:	в этом поле указывается дата завершения работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
ID Компании:	в данном поле указывается ID компании с которой данный элемент будет связан.
ID Контакта:	в данном поле указывается ID контакта с которым данный элемент будет связан.
ID связанного лида:	в этом поле нужно указать ID связанного с элементом лида.
ID связанного контакта:	в этом поле нужно указать ID связанного с элементом контакта.
ID связанной сделки:	в этом поле нужно указать ID связанной с элементом сделки.
ID связанного предложения:	в этом поле нужно указать ID связанного с элементом предложения.
ID связанного заказа:	в этом поле нужно указать ID связанного с элементом заказа.
Наблюдатели:	в данном поле указывается ID сотрудника, который будет в роли наблюдателя в изменяемом элементе.
Направление:	в данном поле указывается ID направления, к которому изменяемый элемент будет относиться.
Стадия:	в этом поле указывается ID стадии в которой находится элемент.
Источник:	в данном поле можно изменить источник элемента. Значения берутся из одноимённого справочника CRM.
Дополнительно об источнике:	в этом поле указываются дополнительные данные об источнике.
Сумма:	данное поле аналогично по функционалу полю из сущности сделка, т.е в нем отображается/заполняется общая денежная сумма по элементу.
Режим расчета суммы:	в данном поле из выпадающего списка нужно выбрать активен ли режим автоматического расчета суммы или нет.
Валюта:	в данном поле указывается валюта с в которой происходит расчет.
Реквизиты Вашей компании:	в данном поле указываются ID реквизитов Вашей компании.

   

Если вам нужно перенести элементы поля тип "Список" из одной сущности в другую, к примеру из Компании в Контакт, то, просто так это сделать не получится, даже если это одно и то же поле, которое было конвертировано из Лида в любую другую сущность.
Однако, для полей элементов Смарт-процесса данное правило не актуально, т.к в рамках одного смарт-процесса, элементы поля тип "Список" имеют идентичные ID.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Поиск элементов смарт-процесса

Данное активити позволяет осуществлять поиск элементов смарт-процесса.

Сценарий работы активити бизнес-процесса

Тип смарт-процесса:	в данном поле нужно выбрать из выпадающего списка смарт-процесс, в котором будет осуществляться поиск элементов.
Воронка:	в этом поле, из выпадающего списка нужно выбрать направление (воронку), в которой находится искомый элемент СП.
Стадия:	в этом поле указывается ID стадии в которой находится элемент.
ID:	в этом поле нужно указать ID искомого элемента смарт-процесса.
Название:	в этом поле указывается название искомого элемента.
Ответственный:	в данном поле указывается ID сотрудника, который указан как ответственный в элементе.
Доступно для всех:	в данном поле из выпадающего списка нужно выбрать данный элемент общедоступен (виден), варианты да/нет.
Создано CRM-формой:	в данном поле указывается ID CRM формы (Контакт-центр->Форма на сайт), с помощью которой элемент был создан.
Дата начала:	в этом поле указывается дата начала работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Дата последней коммуникации:	указывается дата и/или время последненй коммуникации с клиентом.
Дата завершения:	в этом поле указывается дата завершения работы с элементом. Заполняется в таком виде: день.месяц.год час:минута:секунда.  Пример: 08.12.2021 14:00:00.
Компании:	в данном поле указывается ID компании с которой искомый элемент связан.
ID Контакта:	в данном поле указывается ID контакта с которым искомый элемент связан.
ID связанного лида:	в этом поле нужно указать ID связанного с элементом лида.
Контакт:	в этом поле нужно указать ID связанного с элементом контакта.
ID связанного предложения:	в этом поле нужно указать ID связанного с элементом предложения.
ID связанного заказа:	в этом поле нужно указать ID связанного с элементом заказа.
Наблюдатели:	в данном поле указывается ID сотрудника, который является наблюдателем искомом элементе.
Направление:	в данном поле указывается ID направления, к которому искомый элемент относится.
Источник:	в данном поле можно изменить источник элемента. Значения берутся из одноимённого справочника CRM.
Дополнительно об источнике:	в этом поле указываются дополнительные данные об источнике.
Сумма:	данное поле аналогично по функционалу полю из сущности сделка, т.е в нем отображается/заполняется общая денежная сумма по элементу.
Режим расчета суммы:	в данном поле из выпадающего списка нужно выбрать активен ли режим автоматического расчета суммы или нет.
Валюта:	в данном поле указывается валюта с в которой происходит расчет.
Реквизиты Вашей компании:	в данном поле указываются ID реквизитов Вашей компании.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Сообщение об ошибке.

Мониторинг событий элементов смарт-процессов

Активити наблюдает за событиями внутри смарт-процесса и если происходит событие указанное в настройках,  возвращает в виде результата ID нового элемента, Смарт процесса или результат выполнения.

Сценарий работы активити бизнес-процесса

ID смарт-процесса: в этом поле указывается ID смарт-процесса за событиями которого наблюдает активити.

ID-элемента: в этом поле указывается ID элемента смарт-процесса.
Данное поле нужно для тех случаев когда требуется отслеживать события по конкретному элементу смарт-процесса. Если необходимо отслеживать все элементы смарт-процесса, то данное поле не заполняется.

Событие: в данном поле из выпадающего списка нужно выбрать тип события, на которое будет реагировать данное активити.
Доступно на выбор 3 типа событий: Добавление, Изменение, Удаление элемента любого смарт-процесса

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Данное активити в первую очередь предназначено для использования в конструкторе БП.
Использование в конструкторе роботов может привести к самопроизвольным срабатываниям из-за несовершенства логики работы мехнизма роботов с методами слежения за сущностями.

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового элемента;
- ID смарт-процесса;
- Сообщение об ошибке.

Роботизация бизнеса (RPA)

Записи таймлайна

Создать новую запись таймлайна у элемента

Данное активити создает новую запись таймлайна у элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

Идентификатор элемента: в данном поле нужно указать ID элемента RPA - бизнес-процесса, в таймлайне которого планируется добавлять новую запись.

ID пользователя: в этом поле указывается ID пользователя от имени которого запись будет добавлена.

Заголовок: в этом поле указывается заголовок добавляемой записи.

Описание: в этом поле указывается описание добавляемой записи.

Флаг прикрепления записи: в этом поле из выпадающего списка можно выбрать, будет ли запись прикреплена к элементу или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID новой записи таймлайна;
- Результат выполнения;
- Сообщение об ошибке.

Удалить запись таймлайна у элемента

Данное активити удаляет запись таймлайна у элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID записи таймлайна: в этом поле нужно указать ID записи таймлайна, которую нужно удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Массив записей таймлайна для элемента

Данное активити позволяет получить массив записей таймлайна для элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

Идентификатор элемента: в данном поле нужно указать ID элемента RPA - бизнес-процесса, в таймлайне которого планируется добавлять новую запись.

ID записи таймлайна: в этом поле указывается ID пользователя от имени которого запись будет добавлена.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID пользователя;
- Заголовок;
- Описание;
- Результат поиска (Массив для итератора);
- Результат поиска (строка);
- Последний результат поиска;
- Количество найденных элементов;
- Результат выполнения;
- Сообщение об ошибке.

Изменить запись таймлайна у элемента

Данное активити изменяет запись таймлайна у элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID записи таймлайна: в этом поле указывается ID записи таймлайна в элементе RPA - бизнес-процесса.

ID пользователя: в этом поле указывается ID пользователя от имени которого запись будет изменена.

Заголовок: в этом поле указывается заголовок изменяемой записи.

Описание: в этом поле указывается описание изменяемой записи.

Флаг прикрепления записи: в этом поле из выпадающего списка можно выбрать, будет ли запись прикреплена к элементу или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Открепить/прикрепить запись

Данное активити позволяет прикрепить/открепить запись таймлайна для элемента RPA бизнес-процесса.

Сценарий работы активити бизнес-процесса

ID записи таймлайна: в этом поле указывается ID записи таймлайна, которую нужно открепить или прикрепить.

Флаг прикрепления записи: в этом поле из выпадающего списка можно выбрать, будет ли запись прикреплена к элементу или нет.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Задания

Удалить задание с процесса

Данное активити позволяет удалить задание для робота из процесса RPA

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса.

Имя робота: в этом поле указывается имя робота.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Добавить пользователя к существующему заданию

Данное активити позволяет добавить пользователя к существующему заданию процесса RPA

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса.

Имя робота: в этом поле указывается имя робота.

Cтрока с пользователем формата "Имя Фамилия [ид пользователя]": в этом поле указывается ID пользователя, которого нужно добавить в задание.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Коментарии

Добавить комментарий в таймлайне элементов

Данное активити позволяет добавить комментарий в таймлайне элементов процесса RPA.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса.

Идентификатор элемента: в этом поле указывается ID элемента RPA - бизнес-процесса.

Описание: в этом поле вводится комментарий.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID комментария;
- Сообщение об ошибке.

Изменить комментарий

Данное активити позволяет изменить комментарий в таймлайне элементов процесса RPA.

Сценарий работы активити бизнес-процесса

ID комментария: в этом поле указывается ID комментария в списке RPA - бизнес-процесса.

Описание: в этом поле вводится комментарий.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Удалить комментарий

Данное активити позволяет удалить комментарий в таймлайне элементов процесса RPA

Сценарий работы активити бизнес-процесса

ID комментария: в этом поле указывается ID комментария элемента RPA - бизнес-процесса.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Стадии

Создать новую стадию

Данное активити создает новую стадию процесса RPA.

Сценарий работы активити бизнес-процесса

Название стадии: в этом поле указывается название создаваемой стадии RPA - бизнес-процесса.

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором стадия будет создана.

Символьный код: в этом поле вводится символьный код стадии на латинице.

Цвет стадии в виде НЕХ: в это полу нужно вставить цветовой код стадии в виде HEX кода.
К примеру зеленый цвет в HEX: #008000.
Таблицу с HEX-кодами цветов можно найти в интернете, либо просто перейдя по данной ссылке: ТЫЦ

Код семантики стадии: в этом поле нужно выбрать семантический код стадии, т.е то, что данная стадия означает.
Доступно 2 варианта: Success и FAIL , что в дословном переводе "Успех" и "Провал/неудача".

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID новой стадии;
- Результат выполнения;
- Сообщение об ошибке.

Удаление стадии

Данное активити удаляет стадию RPA процесса.

Сценарий работы активити бизнес-процесса

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса которая будет удалена.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Информация о стадии

Данное активити отдает информацию о стадии RPA процесса.

Сценарий работы активити бизнес-процесса

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса о которой нужно получить информацию.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Название стадии;
- Символьный код;
- HEX-код цвета стадии (в виде 6 символов);
- Идентификатор процесса;
- Результат выполнения;
- Сообщение об ошибке.

Список стадий процесса

Данное активити вернет список стадий RPA - процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса список стадий которого надо получить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат поиска (массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Последний результат поиска;
- Количество найденных элементов;
- Результат выполнения;
- Сообщение об ошибке.

Изменить стадию

Данное активити позволяет изменять стадии RPA - процесса.

Сценарий работы активити бизнес-процесса

ID стадии: в этом поле указывается ID стадии RPA - бизнес-процесса которую надо изменить.

Название стадии: в этом поле указывается название изменяемой стадии RPA - бизнес-процесса.

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором стадия будет изменена.

Символьный код: в этом поле вводится символьный код стадии на латинице.

Цвет стадии в виде HEX: в это полу нужно вставить цветовой код стадии в виде HEX кода.
К примеру зеленый цвет в HEX: #008000.
Таблицу с HEX-кодами цветов можно найти в интернете, либо просто перейдя по данной ссылке: ТЫЦ

Код семантики стадии: в этом поле нужно выбрать семантический код стадии, т.е то, что данная стадия означает.
Доступно 2 варианта: Success и FAIL , что в дословном переводе "Успех" и "Провал/неудача".

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

Элементы

Удаление элемента процесса

Данное активити позволяет удалить элемент RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент.

Идентификатор элемента: в этом поле нужно указать ID элемента RPA БП, который вы планируете удалить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Поиск по элементам RPA - процесса

Данное активити выполняет поиск по элементам RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором будет осуществлен поиск.

Идентификатор стадии на которой находится элемент: в этом поле нужно указать ID стадии, в которой находится искомый элемент RPA БП.

Идентификатор предыдущей стадии элемента: в этом поле указывается ID стадии, в которой элемент находился до перехода на текущую стадию.

Название элемента: в этом поле указывается название искомого элемента RPA БП.

ID пользователя, создавшего элемент: в данном поле нужно указать ID пользователя, который создал элемент.

ID пользователя, изменившего элемент: в данном поле нужно указать ID пользователя, который последним изменил элемент.

Время создания элемента: в этом поле нужно указать дату и время создания элемента.

Количество заданий на элементе для пользователя: в данном поле указывается количество заданий, которое было в элементе для пользователя.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити.
Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.

Текст статуса: в данном поле указывается текстовый вариант статуса.
Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется.
Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат (Массив для итератора);
- Результат поиска (строка);
- Первый результат поиска;
- Количество найденных элементов;
- Результат выполнения;
- Сообщение об ошибке.

Получить данные о текущих заданиях элемента

Данное активити позволяет получить данные о текущих заданиях элемента RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент, информацию о заданиях которого нужно получить.

Идентификатор элемента: в этом поле указывается ID элемента в котором содержатся задания, данные о которых нужно получить.

ID задания: в этом поле указывается ID задания, данные которого нужно получить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- ID задания;
- Заголовок задания;
- Описание задания;
- Ответственный;
- Задания (массив для итератора);
- Результат выполнения;
- Сообщение об ошибке.

 

Создание нового элемента процесса

Данное активити позволяет создать новый элемент RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором будет создан новый элемент.

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

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- ID нового элемента;
- Сообщение об ошибке.

 

Обновление данных элемента процесса

Данное активити обновляет данные элемента RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент, данные которого нужно обновить.

Идентификатор элемента: в этом поле указывается ID элемента который будет обновлен.

Идентификатор стадии, на которой находится элемент: в этом поле нужно указать ID стадии на которой находится обновляемый элемент RPA процесса.

Название элемента: в этом поле нужно указать название элемента.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Результат выполнения;
- Сообщение об ошибке.

 

Данные по элементу процесса

Данное активити позволяет получить данные по элементу RPA - бизнес-процесса.

Сценарий работы активити бизнес-процесса

Идентификатор процесса: в этом поле указывается ID RPA - бизнес-процесса в котором содержится элемент, данные которого нужно получить.

Идентификатор элемента: в этом поле указывается ID элемента данные по которому нужно получить.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
   
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса: в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

Возвращаемые параметры для данного активити:
- Идентификатор стадии, на которой находится элемент;
- Идентификатор предыдущей стадии элемента;
- Название элемента;
- Идентификатор процесса;
- ID пользователя, создавшего элемент;
- ID пользователя, изменившего элемент;
- Время создания элемента;
- Время изменения элемента;
- Время изменения стадии элемента;
- Ссылка на карточку элемента;
- Количество заданий на элементе для пользователя;
- Кто выполнил задание;
- Кто выполняет задание;
- Результат выполнения;
- Сообщение об ошибке.

 

Партнерский REST

Получить список клиентов (коробка)

Информация по-данному активити будет добавлена в ближайшее время.

Получить список клиентов Б24 (облако)

Информация по-данному активити будет добавлена в ближайшее время.

Часовые пояса в активити

Параметры дат и часовые пояса в активити.

Когда вы заполняете поля с датами, нужно учитывать, что значение "Время сервера" не сохраняет часовой пояс для формул {-System:Now}. 
Это значение работает только со статическим значением даты и времени. На практике такой сценарий обычно не используется.  Дата и время рассчитываются динамически.

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

В переменной типа "Дата" и "Дата\Время" в БП сейчас уже имеется информация о смещении, поэтому там оно не нужно.

=toUserDate({=Document:ASSIGNED_BY_ID})  - эта формула используется для того, чтобы привести текущее значение даты и времени к времени пользователя.

=workdateadd({=System:Now}, "2h", {=Document:ASSIGNED_BY_ID}) - эта функция позволяет добавлять определенное время к текущему времени (согласно настройкам часового пояса на ПК пользователя), т.е если по МСК 12:00, то эта формула прибавит N-е количество часов, например 2 и получится 14:00.

Установка и удаление активити на коробочном портале

Установка

1. Заходим в административный раздел, в папку "Контент".
2. Далее "файлы и папки" и переходим в раздел  bitrix/modules/
   
3. Распакуйте архив в папку bitrix/modules/ в корневом каталоге портала с помощью "загрузить".
   
4. Выбираем архив и загружаем.
   
5. Находим архив, нажимаем ПКМ (прав кн мыши) и распаковать (обязательно проверяем, чтобы адрес распаковки был bitrix/modules/)
   
6. После распаковки появится директория kosasrobots
   
7. Далее переходим в настройки/модули и находим модуль "Лаборатория роботов (kosasrobots)" и нажимаем "Установить".
8. После установки, переходите в конструктор БП и используете.
   

Удаление

1. В административном разделе переходим в настройки/модули и находим модуль "Лаборатория роботов (kosasrobots)" и нажимаем "Удалить".
   
2. Далее переходим в "файлы и папки", потом в раздел  bitrix/modules/
3. Находим папку kosasrobots и удаляем её.
4. Удаление завершено.

Пункт меню "настройки"

В данном уроке описан функционал пункта меню "Настройки" в приложениях "Лаборатория БП" и "Лаборатория роботов".

Процент запросов для уведомлений: эта опция позволяет настроить уведомление об исчерпании запросов к REST.
Т.е вы указываете цифрой значение, которое отображает остаточный процент от общего числа запросов,
при котором администраторы приложения получат уведомление, о том, что запросы к REST скоро закончатся.
Например у Вас 300 000 запросов и Вы поставили 10%, то уведомление придет когда, останется меньше 30 000 запросов.

Введите количество offline событий:эта опция нужна для создания отложенной очереди обработки эвентов на портале.
Делается это для того, чтобы некоторые активити, обработка событий (эвентов) которых не приоритетна, не мешали обработке других БП и их эвентов. 
Для настройки, нужно указать количество (число) эвентов, которые система сохранит, но выполнит, только после превышения указанного числа эвентов.

Обратите внимание, что более 100 эвентов в очереди оставить нельзя. Даже если вы укажите более, например 101, то при сохранении настроек останется все равно 100 эвентов.
Это нужно для того, чтобы Ваш портал не был заблокирован нашей автоматикой или Б24, когда отложенные 100 (или меньше) эвентов пойдут в обработку.

Offline События: эта настройка позволяет выбрать события REST, которые будут храниться на портале.
Портал хранит указанное количество offline событий для каждого метода, т.е если у вас отмечены для хранения событий методы ONCRMINVOICESETSTATUS и ONCRMLEADUPDATE,
то для каждого из них будет сохранено не более 100 эвентов.
Количество событий, которое представлены фиксировано и не зависит от количества установленных активити, т.к некоторые активити работают с использованием данных событий.
Перечень offline событий и активити, которые его используют:

• ONCRMINVOICESETSTATUS: Слежение за статусом счета.
• ONCRMLEADUPDATE: Завершение по условиям.
• ONCRMDEALUPDATE: Изменение сделки.
• ONCRMCOMPANYUPDATE: Изменение компании.
• ONCRMCONTACTUPDATE: Изменение контакта.
• ONCRMACTIVITYADD, ONCRMACTIVITYUPDATE: Слежение за делом.
• ONTASKUPDATE: Слежение за изменением в задаче.
• ONIMBOTMESSAGEADD, ONIMCOMMANDADD: Создание сообщения в чат от робота.

Режим отладки

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

Для активации режима отладки требуется в настройках активити, в поле "Делать отладочные сообщения в журнал БП" выбрать "Да".

После активации этой опции, активити в случае ошибки или неисправности, будет выводить сообщение в журнал БП.

ВАЖНО!
Нужно не забывать выключать режим отладки после использования, т.к данный режим может более - чем в двое увеличить количество запросов к REST Api.

Подробности ошибок описываются после слова ОШИБКА(ERROR).

Если в поле "Делать отладочные сообщения в журнал БП", выбрано значение "Не установлено", то по умолчанию, это значит, что отладочные сообщения выводиться не будут.

Нет описания

Информация по данному активити будет добавлена в ближайшее время.