0  /  156

Приложение для Битрикс24 "Лаборатория бизнес-процессов"

Содержание

Дела

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

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

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

activity_add_to_crm_lab.gif

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

ID Сущности: 

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

.


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

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

Дата начала:

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


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

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

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

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

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

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

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

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

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

activity_add_to_crm_robot.gif

Возвращаемые параметры данного активити:
- Сообщение об ошибке.


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

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

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

activity_delete_lab.gif


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

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

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

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

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

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

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

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

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

activity_delete_robot.gif

Возвращаемые параметры данного активити:
- ID удаленного дела.
- Сообщение об ошибке.

Создание e-mail

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

activity_email_add_lab.gif

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

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

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

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

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

ВАЖНО!
Если указать данный пункт - да, то будет отправлено письмо получателю.
Если указать данный пункт - нет, то письмо будет создано и не будет отправлено получателю.
Отправитель письма: в данном пункте указывается отправитель письма, т.е электронная почта отправителя.

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

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

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

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

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

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

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

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

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

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

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

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

Период ожидания(Время ожидания ответа от приложения):

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

activity_email_add_robot.gif


  Возвращаемые параметры данного активити:
ID созданного email
- Список получателей
- Сообщение об ошибке

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

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

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

activity_calls_search_lab

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

Искать звонки, в контактах, привязанных к Сделке:
позволяет выбрать искать звонки в контактах, прикрепленных к сделке или нет.

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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так:
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.


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

ВАЖНО!
Данное активити не ищет тип дела "звонок", поиск осуществляется телефонному REST, соответственно найдется только фактически совершенный звонок, а не созданное дело "звонок".
Если нужно искать дело тип "звонок", то нужно воспользоваться активити "Поиск дел"
ID Сущности: в данном пункте указывается ID сущности, в которой , будет осуществлен поиск звонков.
Если указан ID сущности, то ID звонка выведен не будет, будет просто выведено значение "Y"- найдено или "N"- не найдено.

ID звонка (если заполнено, то ID сущности не учитывается): в данном поле указывается ID звонка.
ВАЖНО!
Из-за архитектуры Б24, данное активити не осуществляет поиск звонков в сделках, так как через REST-API связи сделки и звонка нет.
Существует связь между делом тип "звонок" и сделкой, но не существует связи между звонком и сделкой из-за отсутствия номера телефона.
ID ответившего (звонящего) оператора:
в данном поле можно указать ID оператора, который отвечал, либо производил звонок.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

activity_calls_search_robot.gif

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

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

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

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

activity_letters_search_lab.gif

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

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

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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

ВАЖНО!
Если данный пункт заполнен, то ID сущности не учитывается. 
Так же, если указан ID сущности, то ID письма выведено не будет, будет просто выведено значение "Y"- найдено или "N"- не найдено.
Тип письма: в данном пункте указывается тип исходного письма (Входящее / Исходящее). Выбирается из выпадающего списка.

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

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

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

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

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

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

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

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

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

Период ожидания(Время ожидания ответа от приложения):

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

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

activity_calls_search_robot.gif

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



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

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

activity_meeting_search_lab.gif

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

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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
ID встречи (если заполнено, то учитывается только статус): в данном поле можно указать ID искомой встречи.
ID встречи можно найти в пункте меню "мои дела".
Бывают случаи, когда при попытке поиска встреч, активити выводит нулевой результат.
Это может являться следствием того, что к примеру встреча закреплена в сделке или лиде однако открыв  сущность "контакт", которая принимает участие во встрече данная встреча отображается,
что и может вызвать проблему с поиском. Т.е в таком случае искать "встречи" нужно не в сущности контакт, а в сделке.

Статус встречи: в данном поле указывается статус искомой встречи.
Доступно 2 варианта: завершена и не завершена.

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

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

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

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

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

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

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

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

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

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

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

activity_meeting_search_robot.gif

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

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

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

activity_vizit_search_lab.gif


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

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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

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

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

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

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

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

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

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

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

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

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

activity_meeting_search_robot.gif

    Возвращаемые параметры данного активити:
   
- Список ID визитов.
   - Массив для итератора.
   - Количество найденных элементов.
   - Соответствует условиям.

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

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

activity_parsing_words_lab.gif

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

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

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

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

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

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

Для команды 4 возьмем аббревиатуру счета с его номером: НФР-190188
4##word - вернет номер счета по поисковому под слову word
4##НФР  - вернет номер счета 190188
ВАЖНО!

В параметрах, в месте word (маркер заменяемый словом или фразой) НЕЛЬЗЯ использовать пробел до этого слова и/или после.
## - разделитель.
1 - синтаксис команды.

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

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

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

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

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

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

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

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

activity_parsing_words_robot.gif

Возвращаемые параметры данного активити:
- Результат поиска (1 - 10)
- Соответствует условиям (Y / N)

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

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

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

activity_end_lab.gif


ID дела:
в данном поле указывается ID дел, которое планируется закрыть.
ВАЖНО!
Удалить данным активити дело-тип "Задача" не получится, т.к "Задача", это не дело.
Ответственный:
в данном поле указывается ID ответственного который указан в закрываемом деле, либо данный ответственный выбирается из списка по нажатию кнопки "..."

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

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

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

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

activity_end_robot.gif

Возвращаемые параметры данного активити:
- Сообщение об ошибке

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

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

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

activity_get_data_name_lab.gif


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

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

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

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

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

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

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

activity_get_data_name_robot.gif

Возвращаемые параметры данного активити:
- ID владельца.
- ID провайдера.
- Тип провайдера.
- Тип коннектора.
- Тема.
- Параметр уведомления.
- Описание.
- Место.
- Внешний код.
- Внешний источник.
- Данные провайдера.
- Автозаполнение.
- Ссылка на запись звонка.
- ID файла записи звонка.
- Сообщение об ошибке.


Поиск дел

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

activity_search_name_lab.gif


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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
Тип сущности: в данном поле указывается тип сущности, к которой привязано искомое дело. Тип сущности можно выбрать из выпадающего списка.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

activity_search_name_robot.gif

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

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

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

activity_monitoring_lab.gif


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

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

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

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

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

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

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

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

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

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

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

Возвращаемые параметры активити:
- ID дела.
- Сообщение об ошибке.



Реквизиты (адресные)

Добавление адресного реквизита

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

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

ID родительского реквизита:
в данном поле указывается ID родительского реквизита в которому привяжется адресный реквизит.
Важно понимать, что данный реквизит не является родительским. Банковский реквизит привязывается к родительскому, а родительский привязывается уже к сущности.
По такому же принципу привязывается и адресный реквизит.
Для создания родительского реквизита вы можете использовать наше активити "Добавление реквизита" из категории "Реквизиты"
Улица, дом, корпус, строение:
в данном поле указывается адрес улицы,дома/строения и корпус.

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

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

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

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

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

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

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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

Изменение адресного реквизита

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

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

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

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

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

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

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

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

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

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

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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

-Сообщение об ошибке.

Удаление адресного реквизита

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

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

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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

-Сообщение об ошибке.

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

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

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

address_get_data_lab.gif


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

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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

address_get_data_robot.gif

Возвращаемые параметры данного активити:
- Все данные по адресному реквизиту.

Реквизиты (банковские)

Добавление банковского реквизита

Данное активити позволяет добавить банковский реквизит в сущность, указав её ID.

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

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

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

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

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

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

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

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

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

Bank Routing Number: в данном поле вводится номер банка США (это поле заполняется только если счет в банке США).

БИК: в данном поле указывается банковский идентификационный код.

МФО: в данном поле указывается идентификационный код банка.

Bank Account Holder Name: в данном поле указывается имя держателя/владельца банковской карты/счета.

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

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

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

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

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

SWIFT: в данном поле указывается SWIFT-код банка.

BIC: в данном поле указывается BIC-код данка (он же БИК).

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

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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

Возвращаемые параметры данного активити:
-Идентификатор нового банковского реквизита.
-Сообщение об ошибке.


Поиск банковских реквизитов

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

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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

Страна: в данном поле указывается 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 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры данного активити:
-Сообщение об ошибке.

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

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

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

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

lead_bizproc_start__lab.gif

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

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

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

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

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

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

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

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

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

   
   Возвращаемые параметры данного активити:
   - 
ID бизнес-процесса.
   - Сообщение об ошибке. 

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

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

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

company_bizproc_start_lab.gif


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

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

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

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

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

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

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

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

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

   
   Возвращаемые параметры данного активити:
   - 
ID бизнес-процесса.
   
- Сообщение об ошибке.  

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

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

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

contact_bizproc_start_lab.gif

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

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

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

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

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

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

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

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

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

   
   Возвращаемые параметры данного активити:
   - 
ID бизнес-процесса.
   - Сообщение об ошибке. 

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

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

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

deal_bizproc_start_lab.gif



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

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

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

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

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

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

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

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

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

   
   Возвращаемые параметры данного активити:
   - 
ID бизнес-процесса. 
   - Сообщение об ошибке.

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

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

task_in_card_crm_lab.gif


Тип сущности: 
в данном пункте указывается тип сущности, в которой появится поле для указания задачи.
ВАЖНО!
Период слежения за результатом работы длится в течение 30 дней, после чего останавливается.
Это связанно с тем, что забивается база данных сведениями, которые не востребованы, что ведет за собой ухудшение быстродействия приложения в целом.
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 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

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

Чат и боты

Для того, чтобы сделать чат-бота, наносящего пользу вашему бизнесу, не нужно сложное программирование - нужны дополнительные действия в бизнес-процессах Битрикс24 из Приложений24. Мы пройдёмся по всем этапам создания чатботов от момента регистрации на портале до обучения чатбота понимать клиента или коллегу по работе. Покажем, как создать чат-бота в Битрикс24 с помощью приложения "Лаборатория бизнес-процессов" и решать следующие задачи: 

1. 17:42 - Провести первичное общение с клиентом в открытой линии. 

2. 01:10:00 - Создать чат-бота помощника, который будет подсказывать наличие товара в интернет-магазине. 

3. 29:55 - Создать чат-бота для согласования документов и дел в карточках CRM и чате. 

4. 01:30:34 - Создать чат-бота, который может давать ответы на часто задаваемые вопросы как клиентов, так и сотрудников.



Примеры бизнес-процессов, которые описаны в видеоролике - СКАЧАТЬ



Удаление чат-бота

Данное активити позволяет удалить чат-бота, указав его данные.
Активити ищет бота последовательно по указанным данным и если находит, то удаляет бота.
А если не находит, то возвращает "N".
Сценарий работы активити бизнес-процесса

chat_imbot_delete_lab.gif

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

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

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

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

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

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

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

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


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

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

chat_add_lab.gif


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

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

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

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

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

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

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

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

Участники чата(указать одного или более пользователя):
в данном поле указываются ID участников чата. 
ВАЖНО! 
Участники чатов добавляются только поименно, нельзя добавлять участников отделами или как-либо еще.
Правильное заполнение участников чата: Николай Администратор [13]; Вадим Кириленко [1643]; Игорь Куницын [2868] 
Аватар чата (ссылка на картинку): в данном поле ссылка на картинку, которая будет аватаркой чата. Ссылка должна быть публично-доступной для скачивания.
Даже если картинка находится на диске облака, то указывается ссылка, а не ID файла из облака.
ВАЖНО! 
Создавая чат, нужно сразу же добавлять в него хотя бы 1 пользователя и чат-бота (при необходимости).
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

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

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

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

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. 
 Возвращаемые параметры для данного активити:
ID созданного чата
- Успех создания чата
- Таймаут операции


Создание Чат-бота

Данное активити позволяет добавить чат-бота в ваш портал, чтобы потом вести диалоги от него через бизнес-процессы.
Сценарий работы активити бизнес-процесса

chat_imbot_add_lab.gif

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

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

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

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

Чат-боты для открытых линий не поддерживают работу с кнопками из активити "создание сообщения в чат от робота"

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

Почта для связи (если сообщение не прочитано, то отправиться на почту):
в данном поле указывается e-mail на который будут присылаться уведомления, если бот недоступен.
ВАЖНО!
НЕЛЬЗЯ ИСПОЛЬЗОВАТЬ email зарегистрированного сотрудника на портале, для регистрации БОТА, нужно использовать технический адрес почты, не фигурирующий на портале.
Аватар бота (ссылка на картинку): в данном поле указывается ссылка на публично доступное изображение.
Даже если картинка находится на диске облака, то указывается ссылка, а не ID файла из облака.
Ограничение на тип изображений и их размер регулируются настройками портала.

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

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

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

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

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


Выход чат-бота из указанного чата

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

chat_imbot_leave_lab.gif

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

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

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

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

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

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

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

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


Поиск ID чата по названию или ФИО участников

Данное активити позволяет искать ID чата по названию чата или ФИО участников при помощи бизнес-процесса.
Результатом работы данного активити будет получение ID чата в виде массива для итератора, строки и соответствия условиям поиска.
Сценарий работы активити бизнес-процесса 

chat_search_name__lab.gif


Поисковая фраза: 
в данном поле указывается название чата или ФИО его участников
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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


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

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

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

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

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

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



Создание сообщения в чат от робота

Данное активити позволяет создать сообщение в чат от имени робота.

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

message_add_lab.gif






















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 чата.
- Сообщение об ошибке.

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

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

chat_user__add_lab.gif


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

ID CRM сущности:
в данном поле указывается идентификатор сущности CRM к которой привязан чат.
С помощью данного активити НЕЛЬЗЯ добавлять пользователей в обычный чат, только в чат открытых линий.
Так же, другие активити для работы с обычными (открытыми/закрытыми) чатами не совместимы с данным активити.
ID пользователя или бота: 
в данном поле указывается ID бота или пользователя, которого нужно добавить в чат.
Указывается только один ID бота или пользователя.
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

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

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

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

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

Добавление участников в чат

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

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

chat_users_append_lab.gif


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

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

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

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

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

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

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


Смена владельца чата от лица чат-бота

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

chat_imbot_setowner_lab.gif


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

Новый владелец чата:
в данном пункте указывается ID нового владельца чата.

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

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

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

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

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


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

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

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

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

timeline_comment_search_lab.gif

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

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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

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

timeline_comment_search_robot.gif

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

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

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

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

timeline_comment_update_lab.gif



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

ID комментария можно получить с помощью активити "Поиск комментариев из тайм лайн сущности CRM".
Текст комментария: в данном поле указывается новый текст для изменяемого комментария
ВАЖНО! 
Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

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

timeline_comment_update_robot.gif

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Список привязок к записи в таймлайне

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

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

контакты в Битрикс24 crm


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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

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

контакты в Битрикс24 crm

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

Установка-снятие привязки коментария с сущности crm

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

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

timeline_bindings_un_bind_lab.gif


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

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

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

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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

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

timeline_bindings_un_bind_robot.gif

Возвращаемые параметры данного активити:
- Тип операции.
- Результат.
- Сообщение об ошибке.

Удаление коментария из таймлайна

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

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

timeline_comment_delete_lab.gif

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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

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

timeline_comment_delete_robot.gif

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

Получение данных о коментарии из таймлайн сущности CRM

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

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

timeline_comment_get_lab.gif


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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

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

timeline_comment_get_robot.gif

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

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

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

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

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

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

Заголовок сообщения: в данной графе указывается текстовый заголовок сообщения.

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

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

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

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

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

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

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

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

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

Сценарий работы робота
message_to_crm
 
Возвращаемые параметры данного активити:
- Сообщение об ошибке. 

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

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

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

timeline_comment_list_lab.gif


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

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

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

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

timeline_comment_list_robot.gif

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

Компании

Изменение компании

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

company_update_lab.gif

При выборе сотрудника, в поле "привязка к пользователю" должен быть только его ID без лишних символов и букв.
ID компании: В данном пункте указывается ID компании, данные о которой необходимо изменить.
Если поле имеет привязку к элементам инфо блоков (привязка к спискам), то для изменения значения нужно указывать ID элемента.
Очистить почты и(или) телефоны: Данное поле отвечает за удаление почт или телефонов в указанной сущности, из выпадающего списка можно выбрать что именно будет очищено: почта, телефон, почта и телефон или не нужно очищать вовсе.
Название компании: В данном пункте указывается название компании.
Тип компании: В данном поле указывается тип к которому принадлежит компания.
Фактический адрес:
В данном пункте указывается фактический адрес расположения компании.
Адрес (стр. 2):
В данном пункте указывается квартира/офис компании.
Город:
В данном пункте указывается город, в котором находится компания.
Почтовый индекс:
В данном пункте указывается почтовый индекс компании.
Район:
В данном пункте указывается район, в котором находится компания.
Область:
В данном пункте указывается область, в которой находится компания.
Страна:
В данном пункте указывается страна,в которой находится компания.
Код страны:
В данном пункте указывается код страны, в котором находится компания.
Юридический адрес:
В данном пункте указывается юридический адрес, компании, т.е адрес, по которому она зарегистрирована например в налоговой.
Банковские реквизиты:
В данном пункте указываются банковские реквизиты компании.
Сфера деятельности: В данном поле из выпадающего списка можно выбрать сферу деятельности изменяемой компании.
Валюта: В данном поле выбирается валюта для расчетов с данной компанией.
Годовой оборот:
В данном пункте указывается годовой оборот компании.
Комментарии: В данном пункте указывается: Комментарии
Ответственный:
В данном пункте указывается: Идентификатор ответственного
Контакт:
В данном пункте указывается: ID контакта.
Внешний источник:
В данном пункте указывается: Идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Рекламная система:
В данном пункте указывается: Внешний ключ, используется для операций обмена. Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Тип трафика:
В данном пункте указывается: UTM MEDIUM из UTM-метки.
Обозначение рекламной кампании:
В данном пункте указывается: UTM CAMPAIGN из UTM-метки.
Содержание кампании:
В данном пункте указывается: UTM CONTENT из UTM-метки.
Условие поиска кампании: В данном пункте указывается: UTM TERM из UTM-метки.
Телефон:
В данном поле указывается телефон, указанный в аналогичном пункте контактных данных компании.
E-MAIL В данном пункте указывается E-mail, указанный в аналогичном поле контактных данных компании
Сайт: В данном полу указывается короткая ссылка на страницу в одной из социальных сетей, выбранных в соседнем поле.
ВАЖНО!
Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

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

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

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

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

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

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


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

company_update_robot.gif

Возвращаемые параметры для данного активити:
-ID компании.
  

Получение данных по сущности: Компания

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

all_data_from_essense_company_lab.gif

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

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

Сообщение об ошибке:да/нет.
Позволяет выводить ошибки в журнал БП.

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

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

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

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

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

all_data_from_essense_company_robot.gif

Возвращаемые параметры для данного активити:
- Все параметры из сущности "Компания" 

Поиск Компаний (v.2)

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

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

search_essense_company_lab.gif

Сообщение об ошибке: В данном поле указывается, будет ли выводится сообщение об ошибке или нет.
ID: В данном пункте указывается ID компании.
Название компании: В данном пункте указывается название компании. 
Фактический адрес: В данном пункте указывается фактический адрес расположения компании.
Адрес (стр. 2): В данном пункте указывается квартира/офис компании.   
Город: В данном пункте указывается город, в котором находится компания.
Почтовый индекс: В данном пункте указывается почтовый индекс компании.
Район: В данном пункте указывается район, в котором находится компания.
Область: В данном пункте указывается область, в которой находится компания.
Страна: В данном пункте указывается страна, в которой находится компания.
Код страны: В данном пункте указывается код страны, в котором находится компания.   
Юридический адрес: В данном пункте указывается юридический адрес, компании, т.е адрес, по которому она зарегистрирована например в налоговой.
Юридический адрес (стр. 2):
В данном пункте указывается офис/квартира и.т.п. , по которому компания зарегистрирована юридически.   
Юридический адрес город:
В данном пункте указывается город, где компания зарегистрирована юридически.
Юридический адрес почтовый индекс:
В данном пункте указывается юридический почтовый индекс.
Юридический адрес район:  В данном пункте указывается район, где компания юридически зарегистрирована.   
Юридический адрес область:  В данном пункте указывается область, где компания юридически зарегистрирована. 
Юридический адрес страна:
В данном пункте указывается страна, где компания зарегистрирована юридически.
Юридический адрес код страны:
В данном пункте указывается юридический код страны. 
Банковские реквизиты:
В данном пункте указываются банковские реквизиты компании.
Годовой оборот:
В данном пункте указывается годовой оборот компании.
Комментарий:
В данном пункте указывается комментарий, прикрепленный к сущности "Компания"
Дата создания: В данном пункте указывается дата создания компании.
Дата изменения:
В данном пункте указывается дата последнего изменения данных о компании.
Внешний источник:
В данном пункте указывается: Идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Идентификатор элемента во внешнем источнике:
В данном пункте указывается: Внешний ключ, используется для операций обмена. Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Версия оригинала:
В данном пункте указывается: версия внешнего ключа, используемого для операций обмена.
Рекламная система:
В данном пункте указывается: UTM SOURSE из UTM-метки. 
Тип трафика:
В данном пункте указывается: UTM MEDIUM из UTM-метки.
Обозначение рекламной кампании:
В данном пункте указывается: UTM CAMPAIGN из UTM-метки.
Содержание кампании: В данном пункте указывается: UTM CONTENT из UTM-метки.
Условие поиска кампании:
В данном пункте указывается: UTM TERM из UTM-метки.
Телефон:
В данном поле указывается телефон, указанный в аналогичном пункте контактных данных компании.
E-MAIL:
В данном пункте указывается E-mail, указанный в аналогичном поле контактных данных компании
Сайт: В данном поле можно добавить разные адреса сайтов компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
Мессенджер: В данном пункте указывается данные мессенджера или любые web-адреса 
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

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

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

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

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

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

search_essense_company_robot.gif

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

Умный поиск компаний по реквизитам

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

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

company_search_from_requisite_name_lab.gif


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

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

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

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

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

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

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

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

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

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

company_search_from_requisite_name_robot.gif

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

Поиск Компаний с реквизитами и без них

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

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

company_search_requisite_name_lab.gif

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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

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

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

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

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

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

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

company_search_requisite_name_robot.gif

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

Поиск Компании по ИНН КПП

Данное активити позволяет получить список ID компании по ИНН КПП.
Результатом работы является получение списка ID компаний в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.
Сценарий работы активити бизнес-процесса

company_search_rq_inn_name_lab.gif


ИНН: в данном поле указываются реквизиты компаний, которые нужно найти. Для поиска любого значения ИНН введите "##", если же нужна компания с конкретным ИНН, то нужно указать ИНН этой компании.
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

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

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

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

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

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

contact_search_rq_inn_name_robot.gif

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

Поиск компаний по адресу

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

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

company_search_from_address_lab.gif


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

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

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

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

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

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

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

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

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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

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

company_search_from_address_robot.gif

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

Контакты

Изменение Контакта

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

contact_update_lab.gif

При выборе сотрудника, в поле "привязка к пользователю" должен быть только его ID без лишних символов и букв.
Название Описание
ID Контакта   В данном поле необходимо указать ID Контакта, которого мы будем редактировать.
Если поле имеет привязку к элементам инфо блоков (привязка к спискам), то для изменения значения нужно указывать ID элемента.
Очистить почты и(или) телефоны:
Данное поле отвечает за удаление почт или телефонов в указанной сущности, из выпадающего списка можно выбрать что именно будет очищено: почта, телефон, почта и телефон или не нужно очищать вовсе.
Обращение:  Обращение к клиенту (мистер, товарищ, госпожа и т.д.)
Имя:  В данном поле можно указать новое значение имени Контакта.
Фамилия:  В данном поле можно указать новое значение фамилии Контакта.
Отчество:  В данном поле можно указать новое значение отчества Контакта.
Дата рождения:  В данном поле можно указать новое значение даты рождения Контакта.
Тип контакта:  В данном поле можно изменить тип контакта. Значения берутся из одноимённого справочника CRM.
Источник:  В данном поле можно изменить источник контакта. Значения берутся из одноимённого справочника CRM.
Описание:  В данном пункте указывается тип источника из которого лид попал в CRM.
Должность:    В данном поле можно изменить должность Контакта.
Адрес:  В данном поле можно изменить фактический адрес Контакта (устаревшее поле, сейчас используются реквизиты).
Адрес_2 (квартира\офис фактического адреса)  В данном поле можно изменить адрес квартиры или офиса Контакта(устаревшее поле, сейчас используются реквизиты).
Город:  В данном поле можно изменить город расположения Контакта (устаревшее поле, сейчас используются реквизиты).
Почтовый индекс:  В данном поле можно изменить почтовый индекс Контакта (устаревшее поле, сейчас используются реквизиты).
Район:  В данном поле можно изменить район Контакта (устаревшее поле, сейчас используются реквизиты).
Область:  В данном поле можно изменить область Контакта (устаревшее поле, сейчас используются реквизиты).
Страна:  В данном поле можно изменить страну Контакта (устаревшее поле, сейчас используются реквизиты).
Код страны:  В данном поле можно код страны Контакта (устаревшее поле, сейчас используются реквизиты).
Комментарий:  В данном поле можно изменить комментарий компании.
Доступен для всех:  Варианты да/нет. Данное поле отвечает доступен ли данный контакт для всех сотрудников или только для некоторых.
Ответственный:  В данном поле можно изменить ответственного за компанию. Следует помнить, что поле должно принимать формат 
Компания:  В данном поле можно изменить компанию, которая относятся к данному контакту.
COMPANY_IDS (Компании)  В данном поле можно изменить компании (сразу несколько), которые относятся к данной компании. Это требуется, когда один контакт может быть привязан сразу к множеству компаний.
Внешний источник:
 Назначение поля может меняться конечным разработчиком. Это служебное поле, которое не следует трогать.
Идентификатор элемента во внешнем источнике:
 Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком. Этот идентификатор используется при обмене компаниями со внешними системами, например 1С для того, чтобы сопоставить компанию в разных системах.
Версия оригинала:
 В данном поле можно указать версию для внешнего обмена.
Привязка к лицам из модуля faceid:
 В данном поле можно изменить идентификатор, который присваивается каждому контакту в случае использования системы фейс-id.
Рекламная система:
 В данном поле можно изменить метку источника рекламной кампании.
Тип трафика:  В данном поле указывается метка типа трафика рекламной компании.
Обозначение рекламной кампании:
 В данном поле можно изменить метку типа источника рекламной кампании.
Содержание кампании:
 В данном поле можно изменить метку дополнительного контейнера рекламной кампании.
Условие поиска кампании:
 В данном поле можно изменить метку ключевого слова рекламной кампании.
Телефон:  В данном поле можно добавить разные номера телефонов. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
EMAIL:  В данном поле можно добавить разные адреса электронной почты. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
Сайт:  В данном поле можно добавить разные адреса сайтов компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
Мессенджеры:  В данном поле можно добавить разные адреса интернет
ВАЖНО!
Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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


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

contact_update_robot.gif

Возвращаемые параметры данного активити:
-ID контакта

Поиск Контакта (v.2)

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

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

search_contact_lab.gif

Сообщение об ошибке: В данном поле указывается, будет ли выводится сообщение об ошибке или нет.
ID: В данном пункте указывается ID компании.
Имя:
В данном пункте указывается имя искомого контакта
Отчество:
В данном пункте указывается отчество искомого контакта
Фамилия:
В данном пункте указывается фамилия искомого контакта
Описание:
В данном пункте указывается имя искомого контакта
Должность:
В данном пункте указывается тип источника из которого лид попал в CRM.
Адрес:
В данном поле можно указать фактический адрес Контакта (устаревшее поле, сейчас используются реквизиты).
Адрес (стр. 2):
В данном поле можно указать адрес квартиры или офиса Контакта(устаревшее поле, сейчас используются реквизиты).
Город:
В данном поле можно изменить город расположения Контакта (устаревшее поле, сейчас используются реквизиты).
Почтовый индекс:
В данном поле можно указать почтовый индекс Контакта (устаревшее поле, сейчас используются реквизиты).
Район:
В данном поле можно указать район Контакта.
Область:
В данном поле можно указать область Контакта.
Страна:
В данном поле можно страну область Контакта.
Код страны:
В данном поле можно указать код страны Контакта.
Комментарий:
В данном поле можно указать комментарии к контакту.
Дата создания:
В данном поле можно указать дату создания Контакта.
Дата изменения:
В данном поле можно указать дату последнего изменения сущности "Контакт".
Внешний источник:
В данном пункте указывается: Идентификатор внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Идентификатор элемента внешнего источника:
В данном пункте указывается: Внешний ключ, используется для операций обмена. Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком.
Версия оригинала:
В данном пункте указывается: версия внешнего ключа, используемого для операций обмена.
Рекламная система:
В данном пункте указывается: UTM SOURSE из UTM-метки.
Тип трафика:
В данном пункте указывается: UTM MEDIUM из UTM-метки.
Обозначение рекламной кампании:
В данном пункте указывается: UTM CAMPAIGN из UTM-метки.
Содержание кампании: В данном пункте указывается: UTM CONTENT из UTM-метки.
Условие поиска кампании:
В данном пункте указывается: UTM TERM из UTM-метки.
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

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

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

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

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


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

search_contact_robot.gif

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

Получение данных по сущности: Контакт

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

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

all_data_from_essense_contact_lab.gif

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

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

Сообщение об ошибке:да/нет.
Позволяет выводить ошибки в журнал БП.

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

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

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

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

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

all_data_from_essense_contact_robot.gif

Возвращаемые параметры данного активити:
- Все данные из сущности контакт.

Поиск Контактов по ИНН КПП

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

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

contact_search_rq_inn_name_lab.gif


ИНН: в данном поле указываются реквизиты контактов, которые нужно найти. Для поиска любого значения ИНН введите "##", если же нужен контакт с конкретным ИНН, то нужно указать ИНН этого контакта.
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

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

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

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

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

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

contact_search_rq_inn_name_robot.gif

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

Поиск Контактов с реквизитами и без

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

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

contact_search_requisite_name_lab.gif

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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

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

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

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

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

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

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

contact_search_requisite_name_robot.gif

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

Поиск контактов по адресу

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

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

contact_search_from_address_lab.gif


Тип адреса: в данном поле указывается тип адреса реквизитов, который указан в искомом контакте: фактический адрес, адрес регистрации, юридический адрес, адрес бенефициара.
В каждом реквизите компании может быть только 1 тип адреса.
Но у компаний может быть несколько реквизитов.
Улица, дом, корпус, строение: в данном поле указываются адресные данные контакта, такие как улица, дом, корпус, строение, которые указан в адресном реквизите.

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

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

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

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

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

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

Код страны:  в данном поле указывается код страны, который указан в адресном реквизите.
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

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

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

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

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

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

contact_search_from_address_robot.gif

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

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

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

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

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

get_nearest_month_day_lab.gif


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

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

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

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

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

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

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

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

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

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

get_nearest_month_day_robot.gif

Возвращаемые параметры для данного активити:
- Найденная дата и время.
Отображает дату в формате DD.MM.YY. , а так же часы, минуты, секунды. 

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

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

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

date_nearest_week_day_lab.gif


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

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

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

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

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

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

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

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

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

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

date_nearest_week_day_robot.gif

Возвращаемые параметры для данного активити:
- Найденная дата и время.
Отображает дату в формате DD.MM.YY. , а так же часы, минуты, секунды.



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

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

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

calendar_event_add_lab.gif


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

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

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

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

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

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

календарь Битрикс24

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

календарь в Битрикс24

К сожалению, в API Битрикс24 нет метода, который бы выбирал календарь пользователя по умолчанию для приглашений самостоятельно. 

календарь в Битрикс24

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

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

контакты в Битрикс24 crm

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

calendar_event_add_robot.gif

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

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

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

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

calendar_event_update_lab.gif

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

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

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

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

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

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

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

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

calendar_event_update_robot.gif

Возвращаемые параметры для данного активити:
- ID события.
- Сообщение об ошибке.

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

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

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

calendar_event_add_lab.gif


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

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

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

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

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

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

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

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

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

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

calendar_event_delete_robot.gif

Возвращаемые параметры для данного активити:
Сообщение об ошибке.

Сделки

Изменение Сделки

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

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

deal_update_lab.gif

Название Описание
ID Сделки (условие): В данном поле необходимо указать ID Сделки, которую мы будем редактировать.
Если поле имеет привязку к элементам инфо блоков (привязка к спискам), то для изменения значения нужно указывать ID элемента.
Название: В данном поле можно указать новое значение названия Сделки.
Тип сделки:

В данном поле можно изменить тип Сделки. Значения берутся из одноимённого справочника CRM.


Направление: В данном поле можно изменить направление Сделки, принцип заполнения данного поля аналогичен принципу поля "Стадия сделки", только штатное активити, необходимое для получения ID направления называется "Смена направления сделки", или можно использовать "Изменение документа". 
Данное поле заполняется так: С:ID направления.
Пример реального заполнения: С:7
При выборе сотрудника, в поле "привязка к пользователю" должен быть только его ID без лишних символов и букв.
Так же стоит учитывать, что НЕЛЬЗЯ изменить одновременно направление и стадию сделки, только поочередно.
Стадия сделки: в данном поле можно изменить стадию Сделки.
Чтобы добавить стадии сделок пользовательских направлений, необходимо в соседнем поле добавить эту стадию латинскими буквами, например "stage_ID"
Это значение можно получить следующим образом: 
1. В сделке нужно добавить штатное активити "Изменение документа" или штатное "Изменение стадии".
2. В этом активити выбрать поле "стадия"
3. Нажать F12 и выбрать инструмент "выбор элемента страницы", и выбрать поле напротив поля "стадия".
4. Появится расшифровка всех Стадий, выбираете название нужной и прописываете данное название в графе активити "Изменение сделки".

deal_update 2



Название Описание
Вероятность: В данном поле можно изменить вероятность заключения Сделки в %.
Валюта расчетов: В данном поле можно изменить валюту расчётов Сделки. Значения берутся из одноимённого справочника CRM.
Сумма: В данном поле можно изменить предполагаемую сумму в Сделке. Данное поле заполняется автоматически из товарного раздела и не следует его менять если у Вас заполнены в Лиде товары с ценами.
Ставка налога: В данном поле можно изменить ставку налога в Сделке.
Компания: В данном поле можно изменить компанию, которая относятся к данному контакту. 
Контакты: В данном поле можно изменить контакты, которые относятся к данной Сделке.
Дата начала: В данном поле можно изменить дату начала Сделки. 
Дата завершения: В данном поле можно изменить предполагаемую дату завершения Сделки. 
Комментарий: В данном поле можно изменить комментарий компании.
Ответственный: В данном поле можно изменить ответственного за Сделку. Следует помнить, что поле должно принимать формат - user_ID (например user_1).
ADDITIONAL_INFO (Дополнительная информация): В данном поле можно изменить дополнительную информацию за Сделку.
LOCATION_ID (Местоположение): Это служебное поле, которое используется для платёжных систем. 
ORIGINATOR_ID (Идентификатор внешней информационной базы): Назначение поля может меняться конечным разработчиком. Это служебное поле, которое не следует трогать.
ORIGIN_ID (Внешний ключ, используется для операций обмена):  Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком. Этот идентификатор используется при обмене компаниями со внешними системами, например 1С, для того, чтобы сопоставить компанию в разных системах.
UTM_SOURCE (метка источника): В данном поле можно изменить метку источника рекламной кампании. 
UTM_MEDIUM (метка типа кампании): В данном поле можно изменить метку источника рекламной кампании.
UTM_CAMPAIGN (метка названия кампании): В данном поле можно изменить метку названия рекламной кампании. 
UTM_CONTENT (метка контейнера кампании): В данном поле можно изменить метку дополнительного контейнера рекламной кампании.  
UTM_TERM (метка ключевого слова кампании): В данном поле можно изменить метку ключевого слова рекламной кампании. 
ВАЖНО!
Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

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

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

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

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

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

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


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

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

deal_update_robot.gif

Получение данных по сущности: Сделка

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

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

all_data_from_essense_deal_lab.gif


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

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

Сообщение об ошибке:
да/нет.
Позволяет выводить ошибки в журнал БП.

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

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

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

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

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

all_data_from_essense_deal_robot.gif

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

Создание сделки с товарами

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


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

creation_transaction_with_goods_lab.gif

Название Описание
Название: В данном поле можно указать новое значение названия Сделки.
Тип: В данном поле можно указать тип Сделки. Значения берутся из одноимённого справочника CRM.
Направление: В данном поле можно указать направление Сделки. 
Направление сделки указывается в виде ID направления.
Стадия сделки: В данном поле можно указать стадию сделки.
Группа стадии: В данном поле можно указать направление сделки.
Новая сделка: В данном пункте указывается, является ли данная сделка новой.
Регулярная сделка: В данном пункте указывается, будет ли данная сделка регулярной.
Повторная сделка: В данном пункте указывается, является ли данная сделка повторной.
Повторное обращение: В данном пункте указывается признак повторного лида, т.е указывается Y-yes, N-no
Вероятность: В данном пункте указывается вероятность сделки.
Валюта: В данном поле можно указать валюту сделки.
Сумма: В данном поле можно указать сумму сделки.
Ставка налога: В данном поле можно указать ставку налога.
Компания: В данном поле можно указать название компании с которой планируется сделка.
Контакт: В данном поле указываются контакт.
Контакты: В данном поле указывается через запятую ID  привязанных контактов.
Предложение: В данном пункте указывается предложение.
Дата начала: В данном поле можно указать дату начала сделки.
Дата завершения: В данном поле можно указать дату завершения сделки.
Доступна для всех: В данном пункте указывается доступна ли сделка для всех пользователей.
Закрыта: В данном пункте указывается закрыта ли данная сделка или нет.
Комментарий: В данном поле можно указать комментарий к сделке.
Ответственный: В данном поле можно указать ответственного за сделку.
Кем создана: В данном поле можно указать кем создана сделка.
Кем изменена: В данном поле можно указать кем сделка была изменена.
Дата создания: Дата начала сделки.
Дата изменения: Дата изменения сделки.
Источник: В данном поле можно указать источник сделки.
Дополнительно об источнике: В данном поле можно указать дополнительные данные об источнике.

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

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

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


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

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

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

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

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

creation_transaction_with_goods_robot.gif

Возвращаемые параметры данного активити:
- ID сделки.
- Сообщение об ошибке.



Поиск Сделки (v.2)

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

search_essence_transaction_lab.gif


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

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

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

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

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

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

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

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

search_essence_transaction_robot.gif

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

Группы

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

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

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

group_create_lab.gif

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

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

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

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

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

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

group_create_robot.gif

   
   Возвращаемые параметры данного активити:
   
- ID группы. 

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

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

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

group_setowner_lab.gif

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

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

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

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

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

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

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

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

group_setowner_robot.gif

Возвращаемые параметры для данного активити:
- ID события.
- Сообщение об ошибке.

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

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

group_update

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

Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

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

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

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

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

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

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

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

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

group_message_add_lab.gif

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

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

group_message_add2


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

group_message__add3


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

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

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

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

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

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

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

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

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

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

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

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

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

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

group_message_add_robot.gif

Возвращаемые параметры данного активити:
- Сообщение об ошибке.

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

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

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

group_user_add_lab.gif

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

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

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

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

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

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

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

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

Сценарий работы робота

group_user_add_robot.gif

Возвращаемые параметры для данного активити:
- Успех выполнения.

Удаление участника(ов) из группы

Данное активити позволяет удалить участника из группы (проекта).

Сценарий работы активити бизнес-процесса

group_user_delete_lab.gif

ID рабочей группы: в данном полу указывается ID группы (проекта)

ID пользователя (или массив ID). : в этом поле нужно указать ID пользователя, которого активити удалит из группы (проекта).

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: 
в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответ та от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Сценарий работы робота

group_user_delete_robot.gif

Возвращаемые параметры для данного активити:
- Успех выполнения.

Поиск группы (проекта)

Данное активити позволяет искать группу или проект с настройками, указанными в активити.

Сценарий работы активити бизнес-процесса

group_search_lab.gif

Название Описание
ID рабочей группы:
В этом поле нужно указать ID рабочей группы, если таковая есть.
Код сайта: В этом поле нужно указать код сайта, если такой используется.
Название группы: В этом поле нужно ввести название искомой группы.
Описание группы:
В этом поле заполняется текст - описание искомой группы.
Дата создания:
В этом поле нужно выбрать в календаре дату и время создания искомой группы.
Дата последнего изменения параметров группы:
В этом поле нужно выбрать в календаре дату и время последнего изменения параметров искомой группы.
Активность:
Нужно указать активна группа или нет, варианты на выбор: да/нет. 
Видима ли группа в списках:
Нужно указать, видима ли искомая группа в списках. Варианты для выбора: да/нет.
Открыта ли группа для свободного вступления:
Нужно указать, открыта искомая группа для свободного вступления или нет. Варианты для выбора: да/нет.
Является ли группа архивной:
Нужно указать, является ли искомая группа архивной (удаленной). Варианты для выбора: да/нет.
Код темы группы:
В этом поле нужно указать код темы группы.
Код пользователя - владельца группы:
В этом поле нужно указать код пользователя, владеющего группой, т.е его ID.
Ключевые слова:
Указываются ключевые слова.
Количество членов группы:
Нужно указать количество членов группы (цифрами).
Кто имеет право на прием в группу новых членов:
Из выпадающего списка нужно выбрать кто имеет права на прием в группу новых членов. Доступно несколько вариантов на выбор: 
  • Владелец группы.
  • Владелец группы и модераторы.
  • Все члены группы.
Кто имеет право на написание сообщений членам группы: Из выпадающего списка нужно выбрать кто имеет права на написание сообщений членам группы. Доступно несколько вариантов на выбор: 
  • Владелец группы.
  • Владелец группы и модераторы.
  • Все члены группы.
Дата последней активности в группе:
В этом поле нужно выбрать в календаре дату и время последней активности в группе.
Название темы группы: В этом поле указывают название темы искомой группы (текстом).
Имя владельца группы:  В этом поле указывают имя владельца искомой группы. (текстом).
Фамилия владельца группы:
В этом поле указывают фамилия владельца искомой группы (текстом).
Логин владельца группы: В этом поле указывают логин владельца искомой группы (текстом).

Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так:
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.


Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Сценарий работы робота

group_search_robot.gif

Возвращаемые параметры данного активити:
- Результат поиска (массив для итератора).
- Результат поиска (строка).
- Количество найденных элементов.
- Соответствует условиям.
- Сообщение об ошибке.

Счета

Перезаполнение товаров счета

Данное активити позволяет автоматически перезаполнять товары в Счёте при изменении Сделки. Это позволяет облегчать работу менеджерам. Особенно актуально, когда в счетах более 10 позиций.

ID Счёта: 
в данном пункте указывается ID счета, который планируется перезаполнить.

ID Сделки (Если ID счета не задано): 
в данном пункте указывается ID сделки к которой привязан счет.Если указан ID счета,то ID сделки не обязателен к заполнению.

Не менять Счёт в статусе:
позволяет выбрать из выпадающего списка статус, при котором счет не будет изменен.

Принудительно выставлять НДС:
позволяет выбрать из выпадающего списка будет ли НДС добавлен в стоимость или поверх счета.

Ставка налога:
позволяет выбрать из выпадающего списка, ставку налога.

Предустановленные товары (ID##количество##ед. измерения##цена):
в данном пункте добавляются товары,которые ранее были предустановлены.

Сообщение об ошибке: 
да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: 
данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.


Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Создание счета

Данное активити создаёт сущность Счет на основании Сделки из которой оно запускается. Если в Сделке правильно указаны все реквизиты контрагента, то они все будут перенесены в созданный счет. Так же активити позволяет возвращать динамическую ссылку на счет, чтобы Вы могли её отправить клиенту в письме из бизнес-процесса.


Название Описание
Префикс для номера счёта: позволяет указать префикс для счета.
Использовать номерацию Битрикс24: позволяет выбрать,будет ли использована нумерация Б24 или нет.
Статус счета: в данном поле из выпадающего меню выбирается подходящий статус счета.
Срок оплаты в днях: в данном пункте указывается срок оплаты счета в днях.
ID компании продавца: в данном пункте указывается ID компании-продавца .
ID реквизита организации продавца (если не указан, берется 1-й из списка): в данном пункте указывается ID реквизита организации продавца.
ID банковского реквизита продавца (если не указан, берется 1-й из списка): в данном пункте указывается ID банковского реквизита продавца.
ID способа оплаты из настроек CRM (для контакта): в данном пункте указывается ID способа оплаты из настроек CRM для контакта.
ID способа оплаты из настроек CRM (для компании): в данном пункте указывается ID способа оплаты из настроек CRM для компании.
ID реквизита покупателя (если не указан, берется 1-й из списка): в данном пункте указывается ID реквизита покупателя.
Создавать реквизит для физ. лица (если пустой): в данном пункте указывается, создавать ли реквизиты для физического лица.
Какой тип реквизита создавать: в данном поле указывается какой тип реквизита создавать из выпадающего меню.
ID пресета ИП для физ. лица (если не указан, будет искаться с именем "ИП"):  в данном поле указывается ID пресета ИП для физ. лица
ID пресета для физ. лица: в данном поле указывается ID пресета(шаблона) для физ. лица 
Ставка НДС: позволяет выбрать из выпадающего списка ставку НДС.
Принудительно выставлять НДС: позволяет принудительно выставить НДС, выбрав нужный параметр из выпадающего меню. 
Предустановленные товары (ID##количество##ед. измерения##цена):  позволяет добавить в сделку предустановленные товары.
Выставить счёт на остаток товаров в сделке: позволяет выставить счет на остаток товаров в сделке.
Частичная оплата (в процентах, по-умолчанию 100): в данном пункте указывается процентная составляющая предоплаты.
Фиксированная сумма предоплаты: позволяет указать фиксированую сумму предоплаты.
Сократить сумму за счет: в данном поле можно выбрать за счет чего будет сокращена сумма за счет, 
Округлять до целых (при расчете частичной оплаты): в данном пункте указывается, округлять ли до целых чисел, при расчете частичной оплаты. 
Комментарий к счёту (скрытый для покупателя): позволяет добавить коментарий к счету, который будете видеть только Вы.
Сообщение об ошибке: варианты:да/нет.
Позволяет выводить ошибки в журнал БП.   
Делать отладочные сообщения в журнал БП: позволяет выводить отладочные сообщения в журнал БП.
ВАЖНО!
Если Сделка создана с компанией у которой нет реквизитов, то счет не выставится даже когда они будут добавлены в компанию, т.к. реквизиты привязываются к сделке.
Решение - перевыбрать компанию в Сделке.
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.


Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логик

Возможности:

1. Счёт создаётся автоматически нашим активити.
2. При создании отдаёт ссылку для отправки на почту, поэтому можно в БП это сразу организовать.
3. Счет отслеживает нумерацию и может её сам устанавливать в рамках нескольких юр. лиц (Префиксы допускаются) Нумерация в рамках 1 года, т.е. с первого января другого года будут опять с нуля.
4. Есть возможность автоматически дробить счет на части (предоплата несколькими счетами)
5. Есть возможность отслеживать статус оплаты счета или любой другой статус.
6. Есть возможность выбирать разные платёжные реквизиты плательщика (в одной компании несколько юр. лиц)
7. Есть возможность выставлять счета от разных юр. лиц.
8. Есть возможность автоматически создавать реквизиты для физ. лиц, чтобы можно было выстроить грамотный обмен с 1С.

Обратите внимание на данную схему. Она отображает все возможные сценарии, которые вам следует учитывать при проектировании бизнес-процесса в Битрикс24, т.к. каждая ветка является отдельным сценарием и его придётся выделять в бизнес-процессе.  

Схема автоматического создания счетов в Битрикс24

Описание полей:

ID компании продавца - в данном поле необходимо указать ID Вашего юридического лица от которого будет выставляться счёт. Для того, чтобы узнать какое число необходимо вписывать это поле, следует перейти в CRM > НАСТРОЙКИ > РЕКВИЗИТЫ ВАШИХ КОМПАНИЙ

Счета в Битрикс24

В этом списке следует выбрать необходимую Вам компанию и посмотреть её id. Если Вы не видите данное поле, то настройте в шестерёнке его (ID) отображение.

Обращаем Ваше внимание на то, что в созданной вами компании от которой вы собираетесь выставлять счета, должен быть только 1 набор реквизитов (ИНН, КПП и так далее). Если Вы не заполните реквизиты, то счет будет создаваться с пустыми графами.

Для создания реквизитов следует зайти внутрь компании и добавить реквизиты.

реквизиты компании в Битрикс24

реквизиты в Битрикс24 

ID реквизита организации продавца (если не указан, берется 1-й из списка) - в данном поле следует указать id набора реквизитов компании-продавца. Бывают такие случаи, что у одной Вашей компании могут быть несколько реквизитов. Если поле не заполнено, то приложение выберет первый попавшийся из списка реквизитов.

К сожалению, в новой карточке не выводится ID реквизитов и Вам потребуется переключится на отображение старой карточки CRM, чтобы уточнить ID реквизитов. CRM > НАСТРОЙКИ > ДРУГИЕ > ОБЩЕЕ > ВКЛЮЧИТЬ НОВУЮ КАРТОЧКУ CRM - НЕТ

Потом вы возвращаетесь к CRM > НАСТРОЙКИ > РЕКВИЗИТЫ ВАШИХ КОМПАНИЙ 

На вкладке "Реквизиты" Вы можете увидеть ID реквизита. Если вы не видите данного поля, то в настройках заголовка следует его отобразить. 

реквизиты в Битрикс24

ID банковского реквизита продавца - в данном поле следует указывать ID банковских реквизитов продавца. Бывают случаи, когда у одной компании с одним набором реквизитов существует несколько наборов банковских реквизитов (открыты счета в разных банках и их требуется указывать в счетах на оплату).

Для получения ID банковского реквизита вам необходимо открыть реквизиты компании и нажать F12 в браузере. Появится для отладки и просмотра кода. В данной панели есть режим, который позволяет выбирать графический элемент, чтобы увидеть код этого элемента. Посмотрите на картинку ниже.  

Банковские реквизиты в Битрикс24


Вы нажимаете на значок выбора элемента и потом указываете на поле "Названия банка". Внизу появится код элемента. Вам нужен будет код типа BANK_DETAILS[n0] ... цифра в квадратных скобках будет тем самым ID. Его нужно использовать без буквы N.

Тип покупателя - в данном поле следует указать кому Вы будете выставлять счет (контакту или компании). Чтобы бланк счета корректно отображался, следует явным образом указывать тип сущности. Если в рамках сделки Вы не знаете кому Вы будете выставлять счет, то следует делить сценарии на разные ветки бизнес-процесса (для контакта и компании отдельно) и выставлять счет в зависимости от того, что указано в Сделке (или делать доп. пользовательские поля с выбором типа сущности или проверять наличие компании в Сделке). Данное поле нужно, прежде всего, для того, чтобы понять из какой сущности мы будем брать реквизиты для оформления счета.

ВАЖНО! Для корректного создания счета, вы должны учитывать следующие моменты:
1. Следует явным образом указывать сущность (контакт или компания) в параметрах нашего активити из которой нужно брать реквизиты.
2. Для сущности Контакт реквизиты не требуются и счет мы можем выставлять без реквизитов.
3. Для сущности Компания реквизиты нужны в обязательном порядке!
4. Тип реквизита в сущности должен полностью совпадать с данными, т.е. нельзя в тип реквизита Организация заносить данные ИП и наоборот, т.к. вы получите ошибку. Лучше пользоваться автозаполнением реквизитов и тогда проблем не будет.
5. Тип сущности покупателя должен совпадать с типом платёжной системы, т.е. если покупатель контакт, то и тип платёжной системы должен быть для контакта.
6. Смотрите результат запуска создания счёта в журнале бизнес-процесса. Там будут отображаться все шаги и вы сможете увидеть ошибку, если счёт не создался.

ID реквизита покупателя - в данном поле следует указать id набора реквизитов покупателя. Бывают такие случаи, что у покупателя могут быть несколько реквизитов. Если поле не заполнено, то приложение выберет первый попавшийся из списка реквизитов. В описании поля ID реквизита продавцам (выше в данной инструкции) вы можете найти информацию как можно найти значение.

Создавать реквизит для физ. лица - эта опция необходима когда у Вас имеется обмен Битрикс24 и 1С конфигурации, которая не поддерживает сопоставление по e-mail. Если Вы установите "Да", то при создании счёта для физического лица система проверит наличие реквизитов. Если она их не найдёт, то создаст новый набор реквизитов тип ИП и автоматически проставит ИНН 000000000001 или очередной. Для каждого физ. лица будет присвоен ИНН и это позволит Вам сопоставлять клиента в двух системах.

ID пресета для физ. лица (если не указан, будет искаться с именем "ИП") - данная опция позволяет выбрать id типа набора реквизитов. Если Вы не трогали настройка типов реквизитов, то можете оставить эту опцию. Если Вы меняли название типов реквизитов, то вам необходимо зайти в настройки Битрикс24 и посмотреть ID типа реквизитов ИП.  CRM > НАСТРОЙКИ > ШАБЛОНЫ РЕКВИЗИТОВ

способы оплаты в Битрикс24

ID способа оплаты из настроек CRM  -  в данном поле необходимо указать способ оплаты. Для того, чтобы узнать какое число необходимо вписывать сюда, следует перейти CRM > НАСТРОЙКИ > СПОСОБЫ ОПЛАТЫ

способы оплаты в Битрикс24

В данном списке следует выбрать обработчик способа оплаты, который вы хотите использовать в счете. В способах оплаты указываются данные по ответственным лица, которые будут подписывать счет. Там же загружается бланк с фоном счета и картинка с печатями и подписями.

При наведении на название интересующей вас платёжной системы внизу появится ссылка на страницу редактирования. Для того чтобы использовать её в нашем активити вам необходимо взять последнюю цифру из данной ссылки, т.к. она является ID платёжной системы. 

Срок оплаты в днях - в данном поле можно установить количество дней для оплаты счета.

Тип плательщика - в данном поле вы выбираете тип плательщика (юр. лицо или физическое). Это требуется для того, чтобы бланк правильно сформировался, т.к. есть внутренние требования системы и когда вы выбираете физ. лицо, то плательщиком будет на название компании, а ФИО вашего клиента. Это нужно учитывать при создании бизнес-процесса.  

Частичная оплата (в процентах, по-умолчанию 100) - это поле позволит Вам делить количество позиций, указанных в счете. Например, у вас в рамках сделки выставляется два счета по 50% (предоплата и окончательная оплата). В данном поле Вы устанавливаете 50 и при создании счета количество всех позиций будет поделено на 2. При этом сами позиции останутся такими, как вы укажите в сделке. Сумма и налоги пересчитаются автоматически исходя из нового количества.

Округлять до целых (при расчете частичной оплаты) - в данном поле можно установить округление количества в позициях сделки если выбрали не 100%, а меньшее значение, Например, в одной из позиций сделки у Вас указано количество 3. При делении получится значение 1,5. Эта опция позволит округлить полученное число до целого значения.

ID реквизита плательщика (если не указан, берется 1-й из списка) - в данном поле вы можете указать какие выбрать реквизиты клиента для выставления счета. Не редко бывают случаи, когда в рамках одной компании бывают несколько юридических лиц, которые вам могут оплатить. Если в Сделке выбран один набор из множества реквизитов, то он автоматически будет использован нами при создании счета.

Запускать от имени - данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса - данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса - в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса.

Ожидать ответа - данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.  

Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

ВАЖНО! Если вы будете использовать наши процессы из примера, то следует учитывать следующие моменты:
1. Вы можете скачать готовый бизнес-процесс, который требуется импортировать в ваш портал.
2. При импортировании затрётся ваш процесс, в который вы будете грузить пример.
3. При импорте в вашем портале будут созданы все поля, которые участвуют в нашем примере сущности Сделка. Вам необходимо будет сделать их отображаемыми в карточке Сделки.
4. Перед импортом необходимо установить наше приложение и в его настройках установить активити "Создание Счета" и "Слежение за статусом счета"
5. Особенностью Битрикс24 (при импорте сторонних бизнес-процессов) является тот факт, что нужно будет проверить правильность подставленных дополнительных значений в местах:
- во всех элементах изменение документа (Прописываем ID счета) - нужно прописать значение из доп. результатов - Создание Счета - ID Созданного Счета
- во всех элементах изменение переменных (Прописываем значение) - нужно прописать значение из доп. результатов - Получение статуса счета - Статус счета
- во всех элементах отправки писем.
Простое создание счета в Битрикс24

Кейс № 1 - Простое создание Счёта

Давайте рассмотрим пример в котором мы просто создаём Счёт от одной организации автоматически с помощью нашего приложения. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

Простое создание счета в Битрикс24


В данном бизнес-процессе рассматривается модель создания счета без наличия проверки его оплаты. Такой сценарий подходит в тех случаях, когда сотрудники компании вручную присваивают счетам оплату и можно настроить робот в автоматизации, который переведёт стадию сделки после получения оплаты счета. Бизнес-процесс проверяет наличие компании в Сделке и если он её не обнаруживает, то автоматически выставляет счет контакту.

В этой схеме мы заложили проверку на зависание приложения, чтобы ответственный за сделку смог вовремя вмешаться в процесс. Так же в процесс добавлена проверка на повторное создание счета, чтобы не делать дубликатов.  

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 1

Кейс № 2 - Простое создание Счёта и слежение за оплатой

Давайте рассмотрим пример, в котором мы создаём Счёт от одной организации автоматически с помощью нашего приложения и начинаем следить за его статусом. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

создание счета в Битрикс24


В данном бизнес-процессе рассматривается модель создания счета с наличием проверки его оплаты. При обмене данными с 1С конфигурациями, робот в Битрикс24 не получает сведений от системы, что счет был оплачен и Вы не можете ничего делать. Наше активити "Слежение за статусом счета" решает данный вопрос простым методом. Оно (активити) обращается через наш сервер к вашему порталу и опрашивает конкретный счет на предмет оплаты. Если говорить конкретнее, то оно может не только отслеживать оплату, а любой статус счета.

Мы не рекомендуем делать проверку статуса счета чаще чем 1 раз в час, т.к. вы будете создавать большую нагрузку на сервера 1С-Битрикс и наш сервер, а это неминуемо приведёт к блокировке вашего портала.

В рамках данного кейса рассматривается вариант при котором проверяется создавался ли ранее счет или нет. Если бизнес-процесс обнаруживает, что ранее он создавался, то автоматически запускается механизм проверки его статуса. Это позволяет огородить вас от дубликатов счетов, которые возникают по причине ошибок персонала.

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 2

Кейс № 3 - Создание Счета со слежением и отправкой на почту клиенту

Давайте рассмотрим пример, в котором мы создаём Счёт от одной организации автоматически с помощью нашего приложения, отправляем его клиенту и начинаем следить за его статусом. Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

создание счета в Битрикс24 с отправкой на e-mail

В данном бизнес-процессе появляются дополнительные проверки и поля, которые необходимы для нормальной работы всего процесса. Самое главное в автоматических алгоритмах - это не создавать неприятностей для ваших клиентов из-за своей беспечности, поэтому приходится проверять логику процесса несколько раз, чтобы убедиться в правильности выбранного пути. Мы дополнительно вынесли e-mail адрес для отправки писем, чтобы можно было точно его указать, т.к. в раках компании или контакта может быть куча адресов и какой из них правильный знает только менеджер, а машина может ошибиться. 

После завершения нескольких проверок бизнес-процесс получает от нашего активити ссылку на счет и вставляет её в письмо. В теле письма представленного бизнес-процесса уже внесена соответствующая переменная. 

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 3

Кейс № 4 - Создание Счёта от нескольких ваших организаций.

Давайте рассмотрим пример в котором мы создаём Счёт от разных ваших компаний в зависимости от условий оплаты (компания с НДС и без НДС). Для этого мы добавляем бизнес-процесс в одну из стадий Сделки.

Простое создание счета в Битрикс24

В данном бизнес-процессе создаются две альтернативные ветки каждая из которых соответствует своей компании со своими реквизитами и платёжной системой, которые вы предварительно должны настроить. Особенностью такой схемы является то, что в рамках нашего активити присваивается своя нумерация для счетов. Для полноценного запуска вам необходимо будет создать в системе два счета (для каждой вашей компании отдельно) с каким-то номером (можно с префиксом) и при запуске наше активити начнёт считать очередной номер начиная с того, который будет указан в вашем счете. Это особенно актуально, когда вы вели до этого момента оформление счетов в других программах и нумерация у вас есть. Возьмите из программы, в которой оформлялись счета крайний номер и создайте пустой счет с этим номером.

Если мы говорим про 1С-конфигурации, то важно использовать и префиксы, чтобы при выгрузке документов номер назначался такой, какой необходимо. Если в 1С ведётся работа по нескольким организациям и счета грузятся из Битрикс24, то нужно учитывать следующее:

1. Счета будут выгружаться с номерами и префиксами.

2. При проведении документа в 1С номер будет затираться на тот, который 1С считает очередным для проведённых документов.

3. Все счета нужно будет создавать ТОЛЬКО! в Битрикс24 если Вы не хотите, чтобы нумерация у Вас сбилась.

СКАЧАТЬ ГОТОВЫЙ БИЗНЕС-ПРОЦЕСС ДЛЯ КЕЙСА 4


Поиск счетов в сделке по статусу

Данное активити ищет в сделке все счета у которых нет статуса "Оплачено" или у них статус указан в параметрах.
Результатом работы является получение списка ID счетов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.
Сценарий работы активити бизнес-процесса

search_transaction_status_lab.gif

ID Сделки (обязательное): в данном пункте указывается ID сделки, в которой будет осуществлен поиск счета.
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

Статус счета: в данном поле указывается статус искомого счета.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.


Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.
Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".
Сценарий работы робота

search_transaction_status_robot.gif

Возвращаемые параметры данного активити:
- Найденные счета.
- Найденные счета (массив для итератора).
- Сообщение об ошибке.

Получение данных по сущности счет

Данное активити получает все возможные данные из полей Счета (включая пользовательские), для того, чтобы их можно было использовать в рамках бизнес-процесса.
Сценарий работы активити бизнес-процесса

all_data_from_essence_invoice_lab.gif

ID сущности:
в данном поле указывается ID сущности "Счет", из которой планируется получить все данные. 

Для печати:
выводит данные в доступном для печати виде.

Ссылка на счет:
варианты да/нет.
Указав "Да", активити выведет в возвращаемых параметрах ссылку на необходимый счет.

Сообщение об ошибке: 
да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: 
данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Сценарий работы активити бизнес-процесса

all_data_from_essence_invoice_robot.gif

Возвращаемые параметры для данного активити:
- Все параметры из сущности "Счет" 

Слежение за статусом счета

Данное активити позволяет следить за любым статусом счета если вы знаете его id. Результатом его работы является возвращение статуса счета в виде одной латинской буквы через дополнительные результаты.

status_invoice_new

ID счета (условие):
в данном поле указывается ID статуча счета,за которым необходимо проследить.

Подходящий статус счета (условие):
выбор из выпадающего списка подходящего статуса счета.
ВАЖНО!
Период слежения длится в течении  одного месяца, после чего останавливается.
Это связанно с тем, что забивается база данных сведениями,которые не востребованы,что ведет за собой ухудшение выстродействия приложения в целом. 
Сообщение об ошибке:да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: 
данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

ВАЖНО!
Данное поле на данный момент не доступно для корректировки.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Возвращаемые параметры для данного активити:
Возвращаемыми параметрами будут статус счета, которому присвоено значение.Эти значения будут уникальны для каждого портала. Это значение можно узнать, выбрав "просмотр элементов" в пункте, где можно выбрать подходящий статус счета.
Должен появится выделеный пункт с HTML-кодом "select-id", если нажать радом с ним стрелку,то появится список статусов и присвоеные для них значения.


Получение статуса счета

Данное активити позволяет следить за любым статусом счета если вы знаете его id. Результатом его работы является возвращение статуса счета в виде одной латинской буквы через дополнительные результаты.

invoice_status


ID счета (условие):
в данный пункт вводится ID статуса счета,за которым необходимо проследить.

Сообщение об ошибке: 
Сообщение об ошибке:да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: 
данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Поиск счетов

Данное активити позволяет осуществлять поиск счетов по выбранным параметрам.
Результатом работы является получение списка ID счетов в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сценарий работы активити бизнес-процесса

search_invoice_lab.gif

Название Описание
Номер: В данном поле указывается номер искомого счета.
Валюта: В данном пункте указывается валюта, указанная в искомом счете.
Дата создания: В данном поле указывается дата создания, искомого счета.
Дата комментария к статусу: В данном поле указывается дата комментария к статусу.
Дата оплаты: В данном поле указывается дата оплаты искомого счета.
Дата изменения статуса: В данном поле указывается дата изменения статуса искомого счета.
Дата изменения: В данном поле указывается дата изменения искомого счета.
Кем создан: В данном пункте указывается кем создан искомый счет.
Кто изменил поле оплаты: В данном поле указывается кто изменил поле оплаты.
Кто изменил статус: В данном поле указывается кто изменил статус искомого счета.
ID: В данном пункте указывается ID искомого счета.
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ. 

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити. 

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.
Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".
Сценарий работы активити бизнес-процесса

search_invoice_robot.gif

Возвращаемые параметры для данного активити:
- Массив для итератора.
- Результат поиска (строка).
- Количество найденных элементов.
- Соответствует условиям.
- Сообщение об ошибке. 


Редактирование счета

Данное активити позволяет редактировать все поля сущности "Счет", включая пользовательские.

Название Описание
Сообщение об ошибке:
варианты:да/нет.
Позволяет выводить ошибки в журнал БП.
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: в данном поле указывается идентификатор связанного комерческого предложения.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.


Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа:  данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логик.

Возвращаемые параметры данного активити:

-Сообщение об ошибке.
-Успех редактирования.
-Таймаут операции.


Лиды

Изменение Лида

Данное активити позволяет изменять лид согласно внесенным настройкам.

Сценарий работы активити бизнес-процесса

lead_update_lab.gif

Название Описание
ID лида:    В данном поле необходимо указать ID Лида, который Вы будете редактировать.
Если поле имеет привязку к элементам инфо блоков (привязка к спискам), то для изменения значения нужно указывать ID элемента.
Очистить почты и(или) телефоны:
Данное поле отвечает за удаление почт или телефонов в указанной сущности, из выпадающего списка можно выбрать что именно будет очищено: почта, телефон, почта и телефон или не нужно очищать вовсе.
Название Лида:  В данном поле можно указать новое значение названия Лида.
Обращение:
 Обращение к клиенту (мистер, товарищ, госпожа и т.д.)
Имя:  В данном поле можно указать новое значение имени Контакта.
Фамилия:   В данном поле можно указать новое значение фамилии Контакта.
Отчество:  В данном поле можно указать новое значение отчества Контакта.
Дата рождения:  В данном поле можно указать новое значение даты рождения Контакта.
Название компании:  В данном поле можно изменить название компании.
Источник Лида:  В данном поле можно изменить источник Лида. Значения берутся из одноимённого справочника CRM.
При выборе сотрудника, в поле "привязка к пользователю" должен быть только его ID без лишних символов и букв.
Дополнительно об источнике:    в данном пункте указывается тип источника из которого лид попал в CRM.

Изменение лида



Название Описание
Статус:  В данном пункте вводится код статуса, который можно получить из специальной таблицы.
Дополнительно о статусе:  В данном пункте указывается тип источника статуса из которого лид попал в CRM.
Должность:  В данном поле можно изменить должность Контакта.
Адрес:  В данном поле можно изменить фактический адрес Контакта (устаревшее поле, сейчас используются реквизиты).
Адрес (стр. 2):  В данном поле можно изменить адрес квартиры или офиса Контакта (устаревшее поле, сейчас используются реквизиты).
Город:  В данном поле можно изменить город расположения Контакта (устаревшее поле, сейчас используются реквизиты).
Почтовый индекс:  В данном поле можно изменить почтовый индекс Контакта (устаревшее поле, сейчас используются реквизиты).
Район:  В данном поле можно изменить район Контакта (устаревшее поле, сейчас используются реквизиты).
Область:  В данном поле можно изменить область Контакта (устаревшее поле, сейчас используются реквизиты).
Страна:  В данном поле можно изменить страну Контакта (устаревшее поле, сейчас используются реквизиты).
Код страны:  В данном поле можно код страны Контакта (устаревшее поле, сейчас используются реквизиты).
Валюта расчетов:  В данном поле можно изменить валюту расчётов Лида. Значения берутся из одноимённого справочника CRM.
Сумма:  В данном поле можно изменить предполагаемую сумму по Лиду. Данное поле заполняется автоматически из товарного раздела и не следует его менять если у Вас заполнены в Лиде товары с ценами.
Комментарий:  В данном поле можно изменить комментарий компании.
Ответственный:  В данном поле можно изменить ответственного за компанию. Следует помнить, что поле должно принимать формат - user_ID (например user_1).
Компания:  В данном поле можно выбрать компанию из выпадающего списка.
Контакт:  В данном поле можно выбрать контакт из выпадающего списка.
Внешний источник:  Назначение поля может меняться конечным разработчиком. Это служебное поле, которое не следует трогать.
Идентификатор элемента во внешнем источнике:  Идентификатор объекта внешней информационной базы. Назначение поля может меняться конечным разработчиком. Этот идентификатор используется при обмене компаниями со внешними системами, например 1С, для того, чтобы сопоставить компанию в разных системах.
UTM_SOURCE (метка источника):  В данном поле можно изменить метку источника рекламной кампании.
UTM_MEDIUM (метка типа кампании):  В данном поле можно изменить тип метки источника рекламной кампании.
UTM_CAMPAIGN (метка названия кампании):  В данном поле можно изменить метку названия рекламной кампании.
UTM_CONTENT (метка контейнера кампании):  В данном поле можно изменить метку дополнительного контейнера рекламной кампании.
UTM_TERM (метка ключевого слова кампании):  В данном поле можно изменить метку ключевого слова рекламной кампании.
Телефон:   В данном поле можно добавить разные номера телефонов. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
EMAIL:   В данном поле можно добавить разные адреса электронной почты. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
Сайт:   В данном поле можно добавить разные адреса сайтов компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.
Мессенджер:   В данном поле можно добавить разные адреса интернет - мессенджеров компании. Наше приложение не предназначено для отбора значений. Оно может только вносить дополнительную информацию в данное поле.

ВАЖНО!

Запускать изменение сразу более 1000 сущностей не стоит.
Это может привести к проблемам с обработкой на стороне Б24, и остальные изменения могут не обработаться.

Если вы планируете через интегратор произвести изменение более 1000 сущностей, то нужно встраивать в БП счетчик, и после 1000 изменений делать паузу на 15 минут, если этого не сделать, то это приведет к тормозам в обработке на стороне Б24 и остальные сущности могут не отработаться.


Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:
 данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

lead_update_robot.gif

Возвращаемые параметры для данного активити:
- Сообщение об ошибке.

Получение данных по сущности: Лид

Данное активити позволяет получить все данные из полей лида, ID которого Вы указали в настройках.
Сценарий работы активити бизнес-процесса

all_data_from_essense_lead_lab.gif

ID сущности: в данном пункте указывается ID сущности Лид, которую необходимо изменить.

Для печати: вывод данных в пригодном для печати текстовом виде.

Сообщение об ошибке:
да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Сценарий работы робота

all_data_from_essense_lead_robot.gif

Возвращаемые параметры данного активити:
- Сообщение об ошибке.
- Все данные полей по сущности Лид.

Создание лида с товарами

Данное активити позволяет создавать лид, к которому перекреплены товарные позиции.
Сценарий работы активити бизнес-процесса

creation_lead_with_goods_lab.gif

Название Описание
Сообщение об ошибке:     Варианты:да/нет.
Позволяет выводить ошибки в журнал БП.
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 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы робота

creation_lead_with_goods__robot.gif

Возвращаемые параметры данного активити:
- ID лида.
- Сообщение об ошибке.


Поиск Лида (v.2)

Данное активити позволяет осуществлять поиск лида, по заданным параметрам.
Результатом работы является получение ID лида в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.
Сценарий работы активити бизнес-процесса

search_of_essence_lead_lab.gif

Название Описание
ID: ID искомого лида
Название лида:
В данном поле указывается название искомого лида
Обращение:
В данном поле указывается обращение, которое содержится в искомом лиде
Имя:
В данном поле указывается Имя, указанное в искомом лиде
Отчество:  В данном поле указывается отчество, указанное в искомом лиде
Фамилия: В данном поле указывается фамилия, указанное в искомом лиде
Название компании: В данном пункте указывается название компании, которое указано в поле лида "Название компании"
Источник: В данном поле можно выбрать источники искомого лида, выбрать можно несколько штук, зажав Ctrl и кликая по нужным источникам
Дополнительно об источнике: в данном поле указываются дополнительные сведения об источнике лида, которые указаны в самом в искомом лиде
Статус: В данном поле можно выбрать несколько статусов для искомого лида, выбрать можно несколько штук, зажав Ctrl и кликая по нужным статусам.
Дополнительно о статусе: в данном поле указываются дополнительные сведения о статусе лида, которые указаны в самом в искомом лиде
Состояние статуса: В данном пункте указывается состояние статуса искомого лида
Должность: В данном пункте указывается должность, которая указана в поле лида "Должность"
Адрес: В данном поле указывается значение "фактического адреса", заполненное в искомом лиде
Адрес (стр. 2):
В данном поле указывается значение "квартира\офис фактического адреса", заполненное в искомом лиде
Город: В данном пункте указывается Город, который указан в поле лида "Город"
Телефон: В данном поле указывается телефон, который был указан в лиде в соответствующем поле.
E-mail: В данном поле указывается email, который был указан в лиде в соответствующем поле.
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.
Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".
Сценарий работы робота 

search_of_essence_lead_robot.gif

Возвращаемые параметры для данного активити:
- Результат поиска (массив ID звонков) для итератора.
- Результат поиска (массив ID дел) для итератора.
- Количество найденных элементов.
- Соответствует условиям.
- Сообщение об ошибке.

Списки

Поиск элемента списка

Данное активити позволяет находить элементы списков, указав содержимое данного элемента и место, где стоит искать данный элемент. Поиск может быть осуществлен по любым полям, и результат поиска выводится в массив. 
Результатом работы является получение ID элемента списка.

Сценарий работы активити бизнес-процесса

search_in_elements_of_the_list_lab.gif


Где искать элемент:
 из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находится.
Если поле является списком, то нужно искать ID элемента, а не его значение.
Для этого нужно:
1. Перейти в режим редактирования элемента списка
2. Нажать F12 и выбрать селектор элементов страницы. 
3. Выбрать поле со списком.
4. Внизу появится список с ID.
Если осуществляется поиск списка групп, то поле "Где искать элемент" не заполняется.

search_in_elements_of_the_list

ID группы: в данном поле указывается ID группы, в которой лежит список. Данное поле заполняется цифрой, без каких-либо дополнительных знаков (пробелов тоже не должно быть).

ID списка: в данном поле указывается ID списка, который расположен в группе. Данное поле заполняется цифрой, без каких-либо дополнительных знаков (пробелов тоже не должно быть).

По какому полю выполнять поиск: 
позволяет выбрать тип поля, по которому будет выполняться поиск.
Доступно 4 варианта типов полей: Вид поля "Код"; Тип "Детальное описание"; Тип "Анонс"; Тип "Имя". Узнать тип поля можно в редакторе полей (действия>настроить поля).
1. Если выбран тип "Привязка к элементам CRM" и указана только одна сущность (любая), то осуществлять поиск нужно по ID.

2. Если установлен тип "Код" и указанно несколько сущностей(любых), то поиск нужно осуществлять по ID с префиксом.

Префиксы(Содержимое искомого поля):
L_26635 - Лид
C_843 - Контакт
CO_709 - Компания
D_839 - Сделка

Тип поля "код" устанавливается при создании поля в редакторе полей.
Поиск элемента по типу поля "код" не будет работать, если не указать данный тип поля при создании его в редакторе полей.
Это же правило распространяется на тип поля "Строка" или "Число"

CODE - это обозначение вида пользовательских полей при вводе параметров поиска. Оно относится к любым пользовательским полям, вне зависимости от того, какого ого типа (Например: Число, строка, дата  и.т.д)
NAME, DETAIL_TEXT, 
PREVIEW_TEXT - это системные виды полей.

Код искомого поля: данный код берется из пункта "настройка полей", в выбранном инфо блоке списка.
Если код искомого поля пуст, то активити будет искать согласно полю "Название".
Данное поля только для полей тип "Код".

Пример: NAIMENOVANIE_MATERIALA

search_in_elements_of_the_list_7.png


Тип условия поиска: в данном поле указывается условие для поиска элемента.
Доступны варианты: равно, не равно, больше или равно, меньше или равно, больше, меньше, содержит, не содержит.
ВАЖНО!
Для полей тип "Список" нельзя использовать числовые значения, например "Содержит 283".
Содержимое искомого элемента: в данном пункте указывается название искомого элемента списка.
Пример: Трос

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса:
данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:
в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".
Сценарий работы робота

search_in_elements_of_the_list_robot.gif

Возвращаемые параметры для данного активити:
Сообщение об ошибке
- Соответствует условиям
- ID элемента списка (первый, если больше 1)
- Результат поиска (массив для итератора) 


Удаление элемента списка

Данное активити позволяет удалять элементы списка, указав где расположен удаляемый элемент и указав его ID.

Сценарий работы активити бизнес-процесса

removal_of_an_element_of_the_list_lab.gif

Где искать элемент: 
из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находится.
ВАЖНО!
Если список создан после установки активити, то его не будет в выпадающем списке, для того, чтобы он появился, нужно переустановить активити, это происходит из-за того, что активити получает перечень списков в момент установки.
Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: 
данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: 
в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: 
данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.
Сценарий работы робота

removal_of_an_element_of_the_list_robot.gif

Возвращаемые параметры данного активити:
- Соответствует условиям.
- ID элемента списка.
- Сообщение об ошибке.

Поиск элемента списка по нескольким полям

Данное активити позволяет находить элементы списков, указав несколько полей по которым нужно искать данный элемент. 
Результатом работы данного активити, будет вывод найденных элементов в массив, а так же вывод ID элемента (первый, если больше 1).

Сценарий работы активити бизнес-процесса 

lists_element_group_search_lab.gif


Где искать элемент:
 из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находится.
Если поле является списком, то нужно искать ID элемента, а не его значение.
Для этого нужно:
1. Перейти в режим редактирования элемента списка
2. Нажать F12 и выбрать селектор элементов страницы. 
3. Выбрать поле со списком.
4. Внизу появится список с ID.
Если осуществляется поиск списка групп, то поле "Где искать элемент" не заполняется.

search_in_elements_of_the_list

Параметры поиска элемента(ов): в данном поле указываются параметры, согласно которых будет осуществлен поиск элементов.
Параметры указываются в следующем порядке: Тип поля##буквенный код поля(если он есть)##код условия##искомое значение.

Пример: 
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
   Больше - 
   Меньше - 6
   Содержит - 7
   НЕ Содержит - 8
4. Искомое значение:название искомого значения, может быть текстом, цифрой.
Т.е если ищем значение "Трос" в поле тип список, то так и вводим "Трос", если стоимость материала вв виде числа, то вводим искомое число, например 100.

DETAIL_TEXT##7##СПБ
1. Тип поля DETAIL_TEXT (детальный текст)
2. Буквенный код поля: по сути буквенное название поля, которое можно найти в настройках полей. (действия>настроить поля>нужный тип поля>Код).
3. Содержимое поля "детальный текст" искомого списка.
  
NAME##7##Название
1. Тип поля NAME (название).
2. Буквенный код поля: по сути буквенное название поля, которое можно найти в настройках полей.
3. Текст из поля "Название" из искомого списка.

PREVIEW_TEXT##7##Луна-спутник Земли
1. Тип поля PREVIEW_TEXT (Анонс)
2. Буквенный код поля: по сути буквенное название поля, которое можно найти в настройках полей.
3. Текст из поля "Анонс" или "Текст анонса" из искомого списка.

Тип условия для всех параметров: в данном поле можно указать один из 2 типов условий для поиска элементов списка "и/или". 
И - используют, когда осуществляется поиск по одному полю.
Или - используют, когда поиск будет происходить по нескольким полям

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса:
данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:
в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.
Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".
Сценарий работы активити робота

lists_element_group_search_robot.gif

Возвращаемые параметры данного активити:
Сообщение об ошибке
- Соответствует условиям
- ID элемента списка (первый, если больше 1)
- Результат поиска (массив для итератора) 


Добавление элемента списка

Данное активити позволяет добавлять элементы списка.
Сценарий работы активити бизнес-процесса

lists_element_add_lab.gif

В каком списке добавляем элемент: в этом поле нужно выбрать из выпадающего списка, список в который будет добавлен новый элемент.
Если список добавлен после установки данного активити, то он не будет отображен в списке.
Название элемента (NAME): в этом поле указываем название добавляемого элемента.

Поле нового элемента списка: при заполнении этого пункта, новое поле не создается, а добавляется в созданный элемент, это значит, что поле, которое Вы указываете должно быть уже создано.
Заполняется поле так: код поля##новое значение. Пример: KovroviyGazon##321
Чтобы все верно заполнить, нужно:
  • Знать код поля которое планируется добавить в элемент (его можно посмотреть в настройках полей)
  • Получить значение(я) поля. Пример получения значения приведен на скриншоте ниже, на примере поля тип "Список". (Если смотреть значение поля в настройках полей, то в пункте 4, нужно выбирать значение в LIST [код] [value]) 

lists_element_add.png

Делать отладочные сообщения в журнал БП:варианты да/нет.

Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.


Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

lists_element_add_robot.gif

Возвращаемые параметры данного активити:
- ID нового элемента списка.


Изменение элемента списка

Данное активити позволяет добавлять элементы списка.
Сценарий работы активити бизнес-процесса

lists_element_update_lab.gif

В каком списке меняем элемент: в этом поле нужно выбрать из выпадающего списка, список в котором будет изменен элемент.
Если список добавлен после установки данного активити, то он не будет отображен в выпадающем списке.

ID элемента: в этом поле указывается ID элемента, который нужно изменить.

Какое поле меняется: в этом поле указывается код поля и его значение через решетку (код поля##новое значение)
Пример: KovroviyGazon##321.

Чтобы все верно заполнить, нужно:
  • Знать код поля которое планируется изменить в элементе (его можно посмотреть в настройках полей)
  • Получить значение(я) поля. Пример получения значения приведен на скриншоте ниже, на примере поля тип "Список". (Если смотреть значение поля в настройках полей, то в пункте 4, нужно выбирать значение в LIST [код] [value]) 

lists_element_add.png

Делать отладочные сообщения в журнал БП:варианты да/нет.

Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.


Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

lists_element_update_robot.gif

Прочее

Разделение элементов массива

Данное активити позволяет разделять массив полученный, в активити "Поиск сущности" на отдельные элементы,для того, чтобы можно было запускать отдельные процессы для каждого элемента.

Массив который нужно разделить:
множество, которое нужно добавить в данный пункт.
Под множеством понимается несколько однотипных элементов. 
Пример: 

array_separate


Сообщение об ошибке: 
да/нет.
Позволяет выводить ошибки в журнал БП.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры для данного активити:
-Элемент массива 1
-Элемент массива 2
-Элемент массива 3
-Элемент массива 4
-Элемент массива 5
-Элемент массива 6
-Элемент массива 7
-Элемент массива 8
-Элемент массива 9
-Элемент массива 10
-Сообщение об ошибке
-Таймаут операции 


Парсинг текста в бизнес-процессах

Данное активити парсит (собирает данные) текст в БП согласно указанным параметрам.

Контент для парсинга: в данном пункте указывается текст, в котором БП будет искать данные согласно заданным ниже параметрам.

Параметры парсинга: в данном пункте настраивается параметр, отвечающий за поиск и выдачу  часть текста.

Для примера рассмотрим фразу - У лукоморья дуб зеленый.   

1##word - вернет слово, расположенное до указанного - word   
1##зеленый — вернёт в дополнительные параметры процесса слово дуб 

2##word - вернет слово, расположенное после указанного - word 
2##дуб — вернёт в дополнительные параметры процесса слово зелёный 

3##word1##word2 - вернёт все слова, расположенные меду указанными word1 и word2.
3##У##зелёный -  вернёт в дополнительные параметры процесса фразу — лукоморья дуб

Для команды 4 возьмем аббревиатуру счета с его номером: НФР-190188
4##word - вернет номер счета по поисковому слову word
4##НФР  - вернет номер счета 190188
ВАЖНО!

В параметрах, в месте word (маркер заменяемый словом или фразой) НЕЛЬЗЯ использовать пробел до этого слова и/или после, т.к. пробелом отделяются слова.
1 - синтаксис команды.   ## - разделитель.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Возвращаемые параметры данного активити:
-Результат поиска (1 - 10)
-Соответствует условиям ( Y / N )


Получение id элемента массива по ключу

Данное активити позволяет получить id элемента массива по ключу (порядковому номеру) при помощи БП.

Порядковый номер элемента: 
в данном поле указывается порядковый номер элемента массива,который необходимо вывести.
Порядковые номера элементов начинают отсчитывать с нуля.

Пример: Задан массив элементов 100,57,62,83,145,217 и нам нужно получить ID элемента 83.
Согласно логике отсчета 0=100,1=57, 2=62, 3=83, 4=145, 5=217.
Соответственно указываем 3.

Массив элементов: в данном поле через запятую указывается массив элементов.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры для данного активити:
-ID элемента по ключу.
-Таймаут операции 


Постраничный вывод массива

Данное активити позволяет осуществить постраничный вывод массива при помощи бизнес-процесса.

Массив элементов:
в данном поле вводится массив элементов для постраничного вывода, поле заполняется результатом работы предыдущего активити (возвращаемый параметр), либо вручную.

Количество элементов на странице: в данном поле указывается какое количество элементов будет отображено на странице при выводе.

Номер страницы для вывода: в данном поле указывается какую страницу выводить.

Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Возвращаемые параметры для данного активити:
Результат поиска (массив для интегратора)
- Результат поиска(строка)
- Соответствие условиям.
- Сообщение об ошибке.


Объединение массивов

Данное активити позволяет осуществить объединение массивов при помощи бизнес-процесса.

Тип операции:
позволяет выбрать один из предложенных вариантов операции объединения "Сформировать результат из повторяющихся значений" или "Сформировать результат из уникальных значений".
"Сформировать результат из повторяющихся значений" - результатом работы активити является получение массива для итератора, которое позволяет из нескольких массивов получить повторяющиеся значения , которые есть в этих массивах.
"Сформировать результат из уникальных значений" -  результатом работы активити является получение массива для итератора, которое позволяет  нескольких массивов получить уникальные значения из каждого из массивов.

Массив для итератора 1-10: Колличество полей в каждом пункте этого типа можно увеличивать. Каждый пункт является массивом для итератора.Данный массив может бы получен разными путями: из параметров БП или являться результатом работы активити (возвращаемый параметр).

Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Возвращаемые параметры для данного активити:

езультат поиска (массив для интегратора)
-Результат поиска(строка)
-Соответствие условиям. 
-Сообщение об ошибке.

Выбор места расположения открытой линии

Информация по данному активити будет добавлена в ближайшее время.

Поиск в массиве по фильтру

Информация по данному активити будет добавлена в ближайшее время.

Удаление ожидающего события

Информация по данному активити будет добавлена в ближайшее время.

Получение телефонов и email из сущности

Данное активити позволяет получить телефон или почты из сущности в формате строки.

Сценарий работы активити бизнес-процесса

контакты в Битрикс24 crm


Тип сущности: в этом поле из выпадающего списка выбирается тип сущности, из которой будут получены телефоны и e-mail.

ID Сущности: в этом поле указывается ID сущности из которой будут получать телефоны и e-mail.

Какой тип почты надо получить: значения нужно выбрать из выпадающего списка.
Доступно несколько вариантов:
  • Почта
  • Рабочая почта.
  • Частная почта.
  • Почта для рассылок.
  • Другая.

Какой тип телефона надо получить: значения нужно выбрать из выпадающего списка.
Доступно несколько вариантов:
  • Телефон
  • Рабочий телефон
  • Мобильный телефон
  • Факс телефон
  • Домашний телефон
  • Пейджер телефон
  • Телефон для рассылок
  • Другой
Делать отладочные сообщения в журнал БП: в данном поле указывается делать отладочные сообщения в журнал БП или нет.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике. 

Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Сценарий работы робота
other_getting_data_entity_robot.gif
































Возвращаемые параметры активити:
- Результат получения почты (строка, первое значение).
Результат получения почты (массив для итератора).
- Результат получения телефона (строка, первое значение).
Результат получения телефона (массив для итератора).
- Количество почтовых ящиков.
- Количество телефонов.
- Сообщение об ошибке.

Преобразование из строки в массив и обратно

Данное активити может преобразовать данные (текст) из строки в массив и обратно.

Сценарий работы бизнес-процесса
Выберите операцию: в данном поле из выпадающего списка выбирается тип операции, которую будет выполнять активити:
  • Из строки в массив.
  • Из массива в строку.

Укажите массив:
ТОЛЬКО! Если выбрана операция из "из массива в строку" - в данном поле указывается массив для итератора, который нужно преобразовать.

ВАЖНО!
Максимальное количество элементов массива, доступных к преобразованию - 50
Укажите строку:
ТОЛЬКО! Если выбрана операция из "из строки в массив" - в данном поле указывается текст для преобразования.

Разделитель (объединитель): в данном поле указывается символ, либо несколько символов, которые участвуют в разделении или объединении.
Пример: 
  • Строка: 1, 2,3,4,5
Получиться массив
1
2
3
4
5
Разделителем будет в данном случае "," запятая.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота
Возвращаемые параметры данного активити:
- Массив в виде строки.
- Массив в виде строки (массив для итератора).
- Результат: элемент массива 1-50.
- Сообщение об ошибке.

Получение значения элемента массива по ключу

Данное активити позволяет получить значение элемента массива по указанному вами ключу данного массива.

Сценарий работы бизнес-процесса
Массив для обработки: в данном поле указывается массив, значение из которого нужно получить.

Ключ массива: в данном поле указывается ключ, по которому нужно получить значение.
Данный ключ можно получить из самого массива, т.е ключ, это порядковый номер элемента в массиве(считается от 0, и если знак препинания отделен от слова, то считается за элемент).
Пример: 
Массив: Звездное небо , но холодная ночь. 
Ключ: 4 
Получаемое значение по ключу: холодная.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.


Сценарий работы робота
Возвращаемые параметры данного активити:
- Результат: значение по ключу.
- Сообщение об ошибке.

Товары

Получение товара из сущности

Данное активити позволяет отобразить товарные позиции сущности в виде таблицы. 

reseiving_goods_from_essence



Тип Сущности:
выбор типа сущности, товарные позиции которой будут отображены.

ID сущности:
ID сущности, из которой будут взяты товарные позиции.
Если в возвращаемых параметрах с названием "ID товаров (массив)" у Вас есть нули, то позиция не является товаром, а является текстовым описанием.
Такое является следствием ручного ввода товара, а не выбором его из списка.
Включить количество в таблицу: 
включение данных о количестве товара в выводимую таблицу.

Включить цену в таблицу:  
включение данных о цене товара в выводимую таблицу.

Включить сумму в таблицу: 
включение данных об общей сумме товара в выводимую таблицу.

Делать отладочные сообщения в журнал БП:
вывод отладочных данных в журнале бизнесс-процесса.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статусаданное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Перенос товаров в другую сущность

Данное активити позволяет осуществить перенос товаров из одной сущности в другую, зная ID и тип сущности из и в которую необходимо осуществить перенос.

Тип сущности (от куда):
выбор типа сущности из которой будет осуществлен перенос товаров.

ID сущности (от куда):
в данном поле указывается ID сущности из которой будет осуществлен перенос товаров.

Тип сущности (куда):
выбор типа сущности в которую будет осуществлен перенос товаров.

ID сущности (куда): 
в данном поле указывается ID сущности в которую будет осуществлен перенос товаров.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: 
Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Добавление товаров к сущности

Данное активити позволяет добавлять товары в сущности:лид,сделка,счет,предложение.

add_goods__to_essence


Тип сущности:
в данном поле указывается в какой тип сущности будет добавлен товар.

ID сущности:
в данном пункте указывается ID  сущности, в которую будет добавлен товар.

Товары (ID##количество##ед. измерения##цена): в данный пункт добавляют товары из предустановленого списка.
Заполняется в таком порядке и через разделители "##" : ID##количество##ед. измерения##цена.  

Что делаем с существующими товарами: в данном пункте выбирается оставить товары,которые уже были в сущности или удалить.

Сообщение об ошибке: в данном пункте указывается надо выводить сообщения об ошибке или нет.

Запускать от имени: 
данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Возвращаемые параметры для данного активити:

Результат выполнения (good_operation): 1 - удачно, 0 - ошибка.

Удаление товара

Данное активити позволяет удалять товар,указав его ID.

removal_of_goods


ID товара: в данном пункте указывается ID товара который планируется удалить.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Возвращаемые параметры для данного активити:

1 - успешное удаление.
0 - удалить товар не удалось.


Редактирование товара

Данное активити позволяет изменять поля сущности "Товар".

Название Описание
Сообщение об ошибке:
варианты:да/нет.
Позволяет выводить ошибки в журнал БП.
ID:
в данном пункте указывается ID редактируемого товара.
Каталог:
В данном пункте указывается ID каталога.
Цена:
В данном пункте указывается цена товара.
Валюта:
В данном пункте указывается валюта расчетов,указынная в товаре
Название:
В данном пункте указывается название товара.
Описание:
В данном пункте указывается описание товара.
Тип описания: В данном пункте указывается значение:1,2,3.Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Активен: Доступно значение: да/нет.
В данном поле указывается доступность товара.
Раздел:
В данном пункте указывается ID раздела.
Сортировка: В данном поле указывается индекс сортировки товара.
Ставка НДС:
В данном пункте указывается ставка НДС,указанная в товаре.
НДС включён в цену:
Доступно значение: да/нет. В данном пункте указывается включен ли НДС в стоимость товара.
Единица измерения:
В данном пункте указывается единица измерения,указанная в товаре 
Внешний код:
Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Создание товара

Данное активити позвляет создать товар в CRM.

Название Описание
Каталог:
В данном пункте указывается ID каталога.
Цена:
В данном пункте указывается цена товара
Валюта:
В данном пункте указывается валюта,указынная в товаре
Название:
В данном пункте указывается название товара 
Описание:
В данном пункте указывается описание товара
Тип описания: В данном пункте указывается значение:1,2,3.Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Активен: Доступно значение: да/нет.
В данном поле указывается доступность товара.
Раздел:
В данном пункте указывается ID раздела.
Сортировка: В данном поле указывается индекс сортировки товара.
Ставка НДС:
В данном пункте указывается ставка НДС.
НДС включен в цену: Доступно значение: да/нет. В данном пункте указывается включен ли НДС в стоимость товара.
Единица измерения:
В данном пункте указывается единица измерения,указанная в товаре 
Внешний код:
Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Поиск Товара (v.2)

Данное активити позволяет осуществлять поиск товара согласно заданных параметров.
Результатом работы является получение ID товара в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сценарий работы активити бизнес-процесса

search_of_goods_lab.gif

Поле "Условие для…" : в данных полях указывается условия для соответствия для полей (равно/неравно, больше или равно, меньше или равно,больше/меньше).
Название Описание
Сообщение об ошибке:
Варианты:да/нет.
Позволяет выводить ошибки в журнал БП.
ID:
В данном пункте указывается ID искомого товара.
Каталог:
В данном пункте указывается ID каталога.
Цена:
В данном пункте указывается цена товара
Валюта:
В данном пункте указывается валюта, указанная в товаре
Название:
В данном пункте указывается название товара 
Описание:
В данном пункте указывается описание товара
Тип описания: В данном пункте указывается значение:1,2,3. Данное значение соответствует:1=TEXT; 2=HTML; 3=BB-code
Раздел:
В данном пункте указывается ID раздела.
Ставка НДС:
В данном пункте указывается ставка НДС, указанная в товаре.
Единица измерения:
В данном пункте указывается единица измерения, указанная в товаре 
Внешний код:
Данное поле используется для заполнения артикулов систем взаимодействующих с Б24 и заполняется 16ричным кодом.
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:
 данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.
Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".
Сценарий работы робота

search_of_goods_robot.gif

Возвращаемые параметры для данного активити:
- Результат поиска (массив ID звонков) для итератора.
- Результат поиска (массив ID дел) для итератора.
- Количество найденных элементов.
- Соответствует условиям.
- Сообщение об ошибке.

Получение данных по сущности товар

Данное активити позволяет получить все данные по сущности "товар" в том числе и из пользовательских полей.

Сценарий работы активити бизнес-процесса
product_get_data_lab.gif

ID товара:
в данном пункте указывается ID товара, данные которого необходимо получить.

Запускать от имени:
 данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.

Сценарий работы активити бизнес-процесса

product_get_data_robot.gif

Возвращаемые параметры для данного активити:
- Все параметры из сущности "Товар" 

Получение товаров из сущности заказ

Информация по-данному активити будет добавлена в ближайшее время.

Реквизиты

Поиск реквизитов

Данное активити позволяет найти главный (родительский) реквизит.
Результатом работы является получение ID родительского реквизита в виде массива для итератора и строки, а так же количество найденных элементов и их соответствие условиям поиска.

Сценарий работы активити бизнес-процесса

requisite_search_error_1_lab.gif

ВАЖНО:
  УНП (Беларусь) фактически хранится в поле ИНН (Россия) сейчас столкнулись с проблемой получения данных из реквизита.
Если в сущности, данные реквизитов которой вы пытаетесь найти, реквизитов более одного, то для правильной работы активити, использующих найденные результаты, эти реквизиты нужно разделить.
     Название:      Описание:  
 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: В данном поле указываются данные иностранных документов.
Данные символы ставятся перед содержимым ячейки:
%  содержит, поиск в строке выглядит так (без пробелов):"%123", это значит, что мы ищем 123. (можно искать буквы и цифры в выбранной вами строке).

!%  не содержит, Пример заполнения !%123 , это значит, что значение в поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

= равно,  Пример заполнения: =123 , это значит, что значение в поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

=
> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени:
 данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: 

в д

анном поле указывается текстовый вариант статуса, который Вы можете изменять.


Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.


Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".
Сценарий работы робота

requisite_search_error_1_robot.gif

Возвращаемые параметры для данного активити:
- Результат поиска (массив 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 часа.

Возвращаемые параметры для данного активити:
- Идентификатор нового реквизита.
Сообщение об ошибке.
  

Получение данных по сущности: реквизит

Данное активити позволяет получить все данные по сущности реквизит.

Сценарий работы активити бизнес-процесса

контакты в Битрикс24 crm


ID реквизита:
в данном поле указывается ID реквизита.

Делать отладочные сообщения в журнале БП: 
в данном поле указывается нужно ли делать отладочные сообщения в журнале БП или нет.

Запускать от имени: 
данное поле необходимо для того, чтобы установить сотрудника с чьими правами выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес.        

Текст статуса:
 в данном поле указывается текстовый вариант статуса. Вы можете написать свой вариант названия статуса. 

Ожидать ответа: 
данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: 
Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Сценарий работы робота

контакты в Битрикс24 crm

Возвращаемые параметры данного активити:
- Все данные по сущности реквизит.

Изменение реквизита

Данное активити позволяет изменить главный (родительский) реквизит.
ВАЖНО!
УНП (Беларусь) фактически хранится в поле ИНН (Россия) сейчас столкнулись с проблемой получения данных из реквизита.
     Название:      Описание:  
 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 которого Вы указали, и возвращает в БП значение «ложь» или «правда», что означает статус «не выполнено» или «выполнено»

ВАЖНО!
В связи со сменой функционала со стороны Б24, текущее API устарело и активити может работать не корректно.

Сценарий работы активити бизнес-процесса

check_task_checklist__lab.gif

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.


Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.


Ожидать ответа:
 данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Период ожидания. Время ожидания ответа от приложения: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

ВАЖНО! 
Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того, чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Сценарий работы робота

check_task_checklist_robot.gif

Возвращаемые параметры данного активити:
- b_completed: Y или N, означает выполнен чек-лист или нет.


Завершение задач

Данное активити позволяет автоматически закрывать неактуальные задачи, при условии знания их ID
   Логика активити подразумевает, что если не указаны данные, необходимые для выбора конкретной задачи, то будут закрываться все задачи, которые находятся в статусах 1,2,3,4 (о значениях статусов смотрите в описании активити "Получить текущий статус и мета - статус задачи") в той сущности, где запущен данный бизнес-процесс (Лид, Сделка, Контакт, Компания). 

Сценарий работы активити бизнес-процесса

tasks_close__lab

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Постановщик (условие) - позволяет отобрать все задачи в которых постановщиком будет выбранный сотрудник. Выбор происходит из выпадающего списка.

Ответственный (условие) - позволяет отобрать все задачи в которых ответственным будет выбранный сотрудник. Выбор происходит из выпадающего списка.

Закрывать все задачи указанной сущности: варианты да/нет.
Данное поле позволяет выбрать, нужно ли автоматически закрыть все задачи для указанной сущности или нет. Т.е если указана сущность, то все ее задачи будут или не будут закрыты.
Так же, если указать да/нет в данном поле, но не указать сущность, то активити выдаст ошибку.

Если заполнено поле "ID задачи" и при этом активны и заполнены поля "Закрывать все задачи указанной сущности", "Тип сущности" и "ID сущности", то активити закроет только задачу, ID которой было указано в поле "ID задачи".
Тип сущности: в данном поле из выпадающего списка выбирается тип сущности, задачи которой будут закрыты.

ID сущности: в данном поле указывается ID сущности, либо переменная, указывающая на этот ID.

Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания (Время ожидания ответа от приложения): это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Сценарий работы робота

tasks_close__robot


Возвращаемые параметры данного активити:
- Список завершенных задач (строка).
- Список завершенных задач (массив для итератора).
- Количество завершенных задач.
- Соответствует условиям.
- Сообщение об ошибке.

Удаление задачи

Данное активити позволяет удалить задачу, согласно выбранным Вами параметрам.

Сценарий работы активити бизнес-процесса

delete_task_lab.gif

ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Владелец (условие):указывается автор задачи из выпадающего списка.

Статус задачи, ID (условие)-в данном поле указывается номер статуса задачи.

 Номер 
 статуса
 Расшифровка статуса задачи
1  Новая задача
2  Задача принята ответственным
3  Задача выполняется (пользователь нажал начать выполнение)
4  Условно завершена (пользователь закрыл задачу и ждёт согласования от постановщика)
5  Задача выполнена (пользователь завершил выполнение задачи)
6  Задача отложена (пользователь нажал отложить)
7  Задача отклонена ответственным.


Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.


Запускать от имени:
данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Сценарий работы робота

delete_task_robot.gif

Перенос затраченного времени в задаче

Данное активити позволяет переносить информацию о затраченном времени из одной задачи в другую.
Перенос осуществляется путем указания ID-задачи из которой нужно перенести время и ID-задачи в которую необходимо перенести время.


Сценарий работы активити бизнес-процесса

transfer_spent_time_in_task_lab.gif

Взять ID гл. задачи из родительской задачи: варианты "да" или "нет". Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.
Данный пункт используется, когда у Вас связаны между собой 2 задачи, одна из этих задач "родительская" (главная), вторая "дочерняя". Сам процесс запускается из "дочерней" задачи, но при этом видит ID "родительской" (главной) задачи.

Продублировать затраченное время в комментарий к главной задаче: варианты да/нет. Позволяет выбрать, нужно ли дублировать затраченное  время в комментарии  к главной задаче или нет.

ID главной задачи: указывается ID главной задачи.

ID задачи из которой будет взято затраченное время: указывается ID задачи из которой будут взяты данные о затраченном времени.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.


Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа.

Сценарий работы робота

transfer_spent_time_in_task_robot.gif

Добавить чек-лист к задаче

Данное активити позволяет добавить пункты чек-листа в задачи, соответствующие указанному ID.

Сценарий работы активити бизнес-процесса

task_add_checklist_lab.gif


ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

Пункт чек-листа
- в данном поле пишется важный момент, который должен выполнить ответственный за выполнение задачи. 

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.


Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска. 

Сценарий работы робота

task_add_checklist_robot.gif


Создание задачи

Данное активити позволяет создавать задачи в рамках текущей сущности (лид, дело и.т.п).
Это значит, что согласно настройкам активити, внутри бизнес-процесса создается задача и возвращается ID этой задачи в "обратные параметры".

Сценарий работы активити бизнес-процесса

create_task_lab.gif

Остановить процесс во время выполнения задачи: данное поле позволяет остановить Бизнес процесс, до тех пор пока задача не будет выполнена, после выполнения задачи, Бизнес-процесс продолжит работу.
Доступно несколько значений: Да, Нет. 
Так же есть соседнее поле, в котором нужно указать значение, для которого будет применяться остановка процесса, т.е указываются параметры, которые должны быть запущены.

ВАЖНО!
В конструкторе БП нельзя использовать более 5 наших активити подряд, так как на 6 активити, БП зависнет, ввиду того, что Б24 не разрешает использование более 5 активити подряд.

Название задачи: данное поле позволяет идентифицировать задачу в дизайнере бизнес-процессов. Рекомендуем использовать модель именования задач по типу - Задача №1, Задача №2  и т.д. Так Вы сможете избежать многих проблем при проектировании и использовании в дальнейшем.

Название должно заполнятся латиницей и без пробелов.
Постановщик: сотрудник, который будет принимать задачу в случае, если она требует этого. Важный момент заключается в том, что постановщик будет получать уведомления по каждому изменению задачи.
В данном поле указывается ID постановщика задачи, выбор можно сделать из выпадающего списка, нажав "..." и выбрав "пользователи", либо просто указав ID нужного пользователя.


Ответственный: сотрудник, который должен выполнить задачу и отчитаться о проделанной работе.
В данном поле указывается ID ответственного за задачу, выбор можно сделать из выпадающего списка, нажав "..." и выбрав "пользователи", либо просто указав ID нужных пользователей.

Соисполнители: сотрудники, которые тоже участвуют в рабочем процессе, но важно понимать, что они не будут участвовать в последующих отчетах. Это сотрудники, которые будут получать уведомления об изменениях. 
В данном поле указывается ID соисполнителя задачи, выбор можно сделать из выпадающего списка, нажав "..." и выбрав "пользователи", либо просто указав ID нужных пользователей.

Наблюдатели: сотрудники, которые тоже участвуют в рабочем процессе просто наблюдая за изменениями в задаче.  Это сотрудники, которые будут получать уведомления об изменениях.
В данном поле указывается ID наблюдателей за задачей, выбор можно сделать из выпадающего списка, нажав "..." и выбрав "пользователи", либо просто указав ID нужных пользователей.

Дата начала:  В данном пункте устанавливается дата начала задачи, и в соседнем поле выбор формата даты.

Дата окончания: В данном пункте устанавливается дата начала задачи, и в соседнем поле выбор формата даты.

ВАЖНО! 
Изменение данной даты ведёт к смещению сроков зависимых задач на диаграмме Ганта.
Крайний срок: дата крайнего срока по задаче. По данной дате система считает её просрочку. Если данное поле не будет указано, то задача не будет никогда просрочена и не попадёт в негативную статистику по работе менеджера.  В данном пункте устанавливается дата крайнего срока по задаче, и в соседнем поле выбор формата даты.

Описание задачи: в данное поле заносится что необходимо сделать в рамках данной задачи. Указывайте всегда подробное описание, которое позволит Вашим коллегам понять что от них хотят.

Важность: данное поле позволяет установить приоритетность задачи. Задачи, которые отмечены как Важные отмечаются на экране специальным маркером (огонёк). Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

Задача в проекте (группе): в этом поле можно сделать привязку задачи к конкретной группе (проекту). Это нужно, чтобы удобнее было разделять задачи по конкретным проектам в отчетах. В данном пункте указывается ID задачи, группы.

Разрешить ответственному менять крайний срок: эта опция позволяет давать разрешение ответственному за задачу передвигать сроки её выполнения. Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

Включить учет времени по задаче: данная опция позволит включить в задаче функцию замера времени. После нажатия кнопки "Начать учет моего времени", включится счетчик по задаче. Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

Принять работу после завершения задачи: включение данной опции потребует от постановщика задачи (после нажатия ответственным кнопки "Завершить") принять задачу ознакомившись с ней. Такие задачи отображаются в разделе "Поручил" с пометкой "Ожидает контроля". Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

Включить задачу в отчет по эффективности: добавляет задачу с данной отметкой в отчет по эффективности менеджера. Следует тщательно подходить к установке данной опции, т.к. не занеся все задачи в отчет, Вы не получите грамотной статистики. Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

Привязать задачу к текущей сущности (CRM): 

данная опция позволяет привязывать к задаче сущность  из которой она запускается бизнес-процессов.

В данном пункте выбирается тип сущности, привязывающийся к задаче (Лид, Контакт, Компания, Сделка).

Привязать задачу к нескольким сущностям: позволяет привязать задачу нескольким CRM сущностям.
Указывается тип сущности_ID сущности.

Обозначения сущностей CRM: 
L_ - Лид
D_ - Сделка
C_ - Контакт
CO_ - Компания

Пример заполнения поля: L_1234. 

Теги: идентификаторы для уточнения категории, описания, поиска данных и задания внутренней структуры. Вы можете промаркировать определённые задачи тегами, чтобы было удобнее их отбирать в поиске.  В данном поле указываются теги - слова или словосочетания, по которой можно быстро найти задачи.

Пункт чек - листа: Полей д