0  /  162

Приложение для Битрикс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 делегированного пользователя.

Группы

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

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

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

group_create_lab.gif

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

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

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

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

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

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

group_create_robot.gif

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

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

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

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

group_setowner_lab.gif

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

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

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

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

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

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

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

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

group_setowner_robot.gif

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

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

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

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

group_update_lab.gif

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

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

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

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

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

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

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

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

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

group_update_robot.gif

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

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

group_message_add_lab.gif

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

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

group_message_add2


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

group_message__add3

Категории получателей:
DR2 - Department Recursive (сотрудники отдела с ID = 2 и его подотделов);
SG3_A - Sonet Group (админ (владелец) группы соцсети с ID = 3);
SG3_E - Sonet Group (модераторы группы соцсети с ID = 3);
SG3_K - Sonet Group (все члены группы соцсети с ID = 3);

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

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

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

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

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

Прикрепить файл(ы) к сообщению (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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента(можно получить через F12+просмотр элементов). 

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

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

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

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

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

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

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

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

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

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

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

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

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

group_search_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 календаря.

group_or_project_calendar_ID.gif

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

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

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

Цвет фона события: в данном поле вы указываете цвет создаваемого события в календаре. Применяется код цвета 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

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

Дела

Создание своего дела в 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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента(можно получить через F12+просмотр элементов). 

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

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

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

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

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

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


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

ВАЖНО!
Данное активити не ищет тип дела "звонок", поиск осуществляется телефонному 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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента(можно получить через F12+просмотр элементов). 

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

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

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

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

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

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

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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента(можно получить либо через F12+просмотр элементов).


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

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

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

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

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

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}.
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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента(можно получить через F12+просмотр элементов).

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

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

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

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

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

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

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 провайдера.
- Тип провайдера.
- Тип коннектора.
- Тема.
- Параметр уведомления.
- Описание.
- Место.
- Выполнено (Y/N).
- Статус (выводится числовое значение)
- Внешний код.
- Внешний источник.
- Данные провайдера.
- Автозаполнение.
- Ссылка на запись звонка.
- ID файла записи звонка.
- Сообщение об ошибке.




Поиск дел

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

activity_search_name_lab.gif


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

activity_search_name_robot.gif

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

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

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

activity_monitoring_lab.gif


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

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

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

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

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

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

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

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

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

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

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

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



Задачи

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

Данное активити проверяет чек-лист в задаче, 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. 

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

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

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

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

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

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

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

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

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

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

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

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

  Индекс типа зависимости                   Наименование зависимости
                       1      Когда начнется указанная (до решетки) - начнется эта (редактируемая задача)  
                       2      Когда начнется указанная (до решетки)   - закончится эта (редактируемая задача)   
                       3      Когда закончится указанная (до решетки) - начнется эта (редактируемая задача)   
                       4      Когда закончится указанная (до решетки) - закончится эта (редактируемая задача)   
                       5      Когда начнется эта (до решетки) - начнется указанная (редактируемая задача)   
                       6      Когда начнется эта (до решетки) - закончится указанная (редактируемая задача)
                       7        Когда закончится эта (до решетки) - начнется указанная (редактируемая задача)
                       8      Когда закончится эта (до решетки) - закончится указанная (редактируемая задача)


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


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

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

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

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


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

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

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

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

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


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

create_task_robot.gif

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

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

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

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

update_task_lab.gif


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

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

Флаг "Привязать к текущей сущности":
привязка задачи к сущности из которой запускается бизнес-процесс.

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

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

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

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

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

Крайний срок:
крайний срок задачи.
В данном поле указывается дата крайнего срока по задаче, в соседнем поле указывается время крайнего срока.
ВАЖНО! 
Изменение данной даты ведёт к смещению сроков зависимых задач на диаграмме Ганта.
Приоритет:
данное поле позволяет установить приоритетность задачи. Задачи, которые отмечены как Важные отмечаются на экране специальным маркером (огонёк). Второе поле в данном пункте не функционально, иногда используется для точного определения параметра.

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

Флаг включения задачи в отчет по эффективности: 

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

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

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

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

Типы зависимостей:

  Индекс типа зависимости                   Наименование зависимости
                       1      Когда начнется указанная (до решетки) - начнется эта (редактируемая задача)  
                       2      Когда начнется указанная (до решетки)   - закончится эта (редактируемая задача)   
                       3      Когда закончится указанная (до решетки) - начнется эта (редактируемая задача)   
                       4      Когда закончится указанная (до решетки) - закончится эта (редактируемая задача)   
                       5      Когда начнется эта (до решетки) - начнется указанная (редактируемая задача)   
                       6      Когда начнется эта (до решетки) - закончится указанная (редактируемая задача)
                       7        Когда закончится эта (до решетки) - начнется указанная (редактируемая задача)
                       8      Когда закончится эта (до решетки) - закончится указанная (редактируемая задача)


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


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

Второе поле в данном пункте не функционально.

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

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


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

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

Крайний срок должен всегда устанавливаться в рабочее время: 

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

Второе поле в данном пункте не функционально.

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

Обозначения сущностей CRM: 
L_ - Лид
D_ - Сделка
C_ - Контакт
CO_ - Компания

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


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

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

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

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

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

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

update_task_robot.gif

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

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

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

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

get_task_status_and_meta_lab



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

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

ВАЖНО! 
Мета - статусы не будут работать если Вы и постановщик и исполнитель задачи.
ID задачи (условие): в данном пункте указывается ID задачи, которую необходимо изменить.

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


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

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

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

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

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

get_task_status_and_meta_robot

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

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

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

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

get_all_data_from_task_lab.gif



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

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

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

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

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

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

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


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

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

get_all_data_from_task_robot.gif


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


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

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

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

searsh_essense_tasks_lab.gif


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

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

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

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

Обозначения сущностей CRM: 
L_ - Лид
D_ - Сделка
C_ - Контакт
CO_ - Компания 

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

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

searsh_essense_tasks_robot.gif

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

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

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

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

task_transfer_comments_lab

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

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

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

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

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

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

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

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

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

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

task_transfer_comments_robot.gif

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

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

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

task_monitoring_status_name_lab.gif

ВАЖНО!
Период слежения длится в течение 30 дней, после чего останавливается.
Это связанно с тем, что забивается база данных сведениями, которые не востребованы, что ведет за собой ухудшение быстродействия приложения в целом.
ID задачи (условие): в данном поле указывается ID задачи, за статусом которой требуется вести наблюдение.

Статус задачи: в данном поле выбирается из выпадающего списка статус задачи.
Расшифровка статусов задач:
0 - любой.
1 - Ответственный не ознакомился с задачей.
3 - Задача выполняется (пользователь нажал "начать выполнение")
4 - Условно завершена (пользователь закрыл задачу и ждет согласования от постановщика)
5 - Задача выполнена (пользователь завершил выполнение задачи)
6 - Задача отложена (пользователь нажал "отложить")
8 - Закрывает задачу, требующую контроля.
9 - Задачу не принял контролер

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

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

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

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

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

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

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

task_monitoring_status_name_robot.gif

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

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

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

task_monitoring_update_name_lab.gif

ВАЖНО!
Период слежения длится в течение 30 дней, после чего останавливается.
Это связанно с тем, что забивается база данных сведениями, которые не востребованы, что ведет за собой ухудшение быстродействия приложения в целом.
ID задачи (условие): в данном поле указывается ID задачи, за изменениями в которой требуется вести наблюдение.

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


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

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

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

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

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

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

task_monitoring_update_name_robot.gif

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

Интеграции

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

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

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

integ_sender_del_subs_lab.gif


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

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

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

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

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


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

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

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

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

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

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

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

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


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

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

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

integ_sender_add_subs_lab.gif


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

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

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

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

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


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

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

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

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

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

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

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

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


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

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

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

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

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}в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}.

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

Автор: в данном поле указывается автор искомых сообщений, в виде его 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

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

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

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

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

timeline_bindings_list _lab.gif


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

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

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

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

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

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

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

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

timeline_bindings_list _robot.gif

Возвращаемые параметры данного активити:
- 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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
 
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента(можно получить через F12+просмотр элементов).


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

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

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

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

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

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

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

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

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

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

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

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

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

search_essense_company_robot.gif

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

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

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

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

company_search_from_requisite_name_lab.gif


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

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

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

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

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

search_of_goods 2.png


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

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

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

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

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

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

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

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

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

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

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

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

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

company_search_from_requisite_name_robot.gif

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

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

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

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

company_search_requisite_name_lab.gif

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

company_search_requisite_name_robot.gif

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

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

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

company_search_rq_inn_name_lab.gif


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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

contact_search_rq_inn_name_robot.gif

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

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

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

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

company_search_from_address_lab.gif


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента(можно получить через F12+просмотр элементов).


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

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

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

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

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

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

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

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

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

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

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

Период ожидания(Время ожидания ответа от приложения): Указывается в секундах, минутах, часах, днях, но не менее 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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента(можно получить через F12+просмотр элементов).
 

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

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

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

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

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

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

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

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

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

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

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

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

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

contact_search_rq_inn_name_robot.gif

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

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

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

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

contact_search_requisite_name_lab.gif

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

contact_search_requisite_name_robot.gif

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

Поиск контактов по адресу

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

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

contact_search_from_address_lab.gif


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

contact_search_from_address_robot.gif

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

Лиды

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

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

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

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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента (эти ID можно найти в свойствах товара, либо через F12+просмотр элементов). 

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

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

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

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

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

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

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

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

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

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

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

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

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

search_of_essence_lead_robot.gif

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

Подразделения

Поиск подразделений

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

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

department_search_lab


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

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

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

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

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

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

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

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

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

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

Вышестоящее подразделение: в этом поле указывается ID выше стоящего подразделения (только цифра)
Получить ID этого подразделения можно перейдя в искомое подразделение и посмотрев его ID в адресной строке, либо выбрав из списка в соответствующем меню.
К примеру, содержимое адресной строки TEST.bitrix24.ru/company/structure.php?set_filter_structure=Y&amp;structure_UF_DEPARTMENT=1706, 1706 - это ID подразделения.

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

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


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

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

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

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

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


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

department_search_robot

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

Прочее

Разделение элементов массива

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

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

array_separate


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

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


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

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

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

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

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

Возвращаемые параметры для данного активити:
- Элемент массива 1
- Элемент массива 2
- Элемент массива 3
- Элемент массива 4
- Элемент массива 5
- Элемент массива 6
- Элемент массива 7
- Элемент массива 8
- Элемент массива 9
- Элемент массива 10
- Сообщение об ошибке
- Таймаут операции 


Парсинг текста в бизнес-процессах

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

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

other_parsing_parametrs_lab.gif

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

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

Для примера рассмотрим фразу - У лукоморья дуб зеленый.   

1##word - вернет слово, расположенное до указанного - word   
1##зеленый — вернёт в дополнительные параметры процесса слово дуб 

2##word - вернет слово, расположенное после указанного - word 
2##дуб — вернёт в дополнительные параметры процесса слово зелёный 

3##word1##word2 - вернёт все слова, расположенные меду указанными word1 и word2.
3##У##зелёный -  вернёт в дополнительные параметры процесса слово —  дуб

Для команды 4 возьмем аббревиатуру счета с его номером: НФР-190188
4##word - вернет номер счета по поисковому слову word
4##НФР  - вернет номер счета 190188
ВАЖНО!
В параметрах, в месте word (маркер заменяемый словом или фразой) НЕЛЬЗЯ использовать пробел до этого слова и/или после, т.к. пробелом отделяются слова.
1 - синтаксис команды.   ## - разделитель.

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


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

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

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

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

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

other_parsing_parametrs_robot.gif

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

Получение id элемента массива по ключу

Данное активити позволяет получить id элемента массива по ключу (порядковому номеру) при помощи БП.

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

other_key_in_array_lab.gif

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

Пример: Задан массив элементов 100,57,62,83,145,217 и нам нужно получить ID элемента 83.
Согласно логике отсчета 1=100,2=57, 3=62, 4=83, 5=145, 6=217.
Соответственно указываем 4.

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

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


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

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

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

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

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

other_key_in_array_robot.gif

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


Постраничный вывод массива

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

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

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

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

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

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


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

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

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

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

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

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

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


Объединение массивов

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

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

Массив для итератора 1-10: Количество полей в каждом пункте этого типа можно увеличивать. Каждый пункт является массивом для итератора. Данный массив может бы получен разными путями: из параметров БП или являться результатом работы активити (возвращаемый параметр).

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

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


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

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

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

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

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

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

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

Выбор места расположения открытой линии

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

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

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

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

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

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

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

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

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

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

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

Поиск в массиве по фильтру

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



other_search_array_lab.gif

Массив который нужно разделить: в это поле вставляется массив.
Пример: Вчера в магазине я купил:,картошка-250р,печения-55р,молотый кофе-600р 
Запятая является делителем массива.

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

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

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

search_of_goods 2.png


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

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

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

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

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


  
Формат выводов результатов (число):Варианты да/нет.
Позволяет выделить цифры из строки, если выбрано да.
Пример: Вчера в магазине я купил:,картошка-250р,печения-55р,молотый кофе-600р
  • нет == картошка-250р,печения-55р,молотый кофе-600р
  •  да == 250,55,600
Это поле необходимо использовать тогда, когда вам нужно выделить из текста определенный формат данных для дальнейшего использования.

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

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


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

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

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

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

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

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

other_search_array_robot.gif

Возвращаемые параметры активити:
- Количество найденных элементов.
- Найденный элемент 1-10.
- Сообщение об ошибке.

Удаление ожидающего события

Данное активити позволяет удалять/завершать ожидающие в очереди или повторяющиеся события (ожидание задачи или статус счета).
Это активити работает со следующими активити:
  • Слежение за статусом задаче.
  • Слежение за изменением в задаче.
  • Слежение за статусом счета.

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

ID сущности: в этом поле нужно указать ID сущности.

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

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

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

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

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

Период ожидания: время ожидания ответа от приложения.
Указывается в секундах, минутах, часах, днях, но не менее 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 часа.
Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.


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

Удаление html тегов из тела письма

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

delete_wait_event_lab.gif

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

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

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

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

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

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

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

Завершение по условиям

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

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

Условия для завершения: в данном поле указываются условия для завершения активити.
Заполняются в следующем формате: Название поля сущности CRM##условие##данные в поле.
Пример:
OPPORTUNITY##>##0
Условие означает: В поле "OPPORTUNITY" сумма сделки больше 0.

Тип условия для всех параметров: в данном поле указывается один из вариантов  типа условий "и/или".
И - все поля должны совпасть (должны быть соблюдены).
Или - хотя бы одно из условий должно быть соблюдено.

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

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


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

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

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

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

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


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

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

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

Реквизиты

Поиск реквизитов

Данное активити позволяет найти главный (родительский) реквизит.
Результатом работы является получение 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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента (эти ID можно найти через F12+просмотр элементов). 

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

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

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

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

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

## - заполненное поле . Эти символы указываются для того, чтобы узнать, является ли поле заполненным. Как результат, вы получите реквизиты, у которых эти поля заполнены.
Пример заполнения: ##ИНН. 

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

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

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

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

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

Текст статуса: 

в д

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


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

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 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 часа.

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

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

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

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

requisite_get_data_name_lab.gif


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

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

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

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

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

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

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

requisite_get_data_name_robot

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

Изменение реквизита

Данное активити позволяет изменить главный (родительский) реквизит.
ВАЖНО!
УНП (Беларусь) фактически хранится в поле ИНН (Россия) сейчас столкнулись с проблемой получения данных из реквизита.
     Название:      Описание:  
 ID реквизита:      в данном поле указывается ID изменяемого реквизита.
 Название:      в данном поле указывается название изменяемого реквизита.
 Идентификатор внешней информационной базы:      в данном поле указывается идентификатор внешней информационной базы, например: 1С
 Активен:      из выпадающего списка можно выбрать активен реквизит или нет.
 Сортировка:      в данном поле указывается индекс сортировки.
 Ф.И.О.:      в данном поле указывается фамилия, имя и отчество владельца реквизита.
 Имя:      в данном поле указывается имя владельца реквизита
 Фамилия:      в данном поле указывается фамилия владельца реквизита.
 Отчество:      в данном поле указывается отчество владельца реквизита.
 Сокращенное наименование организации:      в данном поле указывается сокращенное наименование организации, указанное в ее документах.
 Полное наименование организации:      в данном поле указывается полное наименование организации, указанное в ее документах.
 Ген. директор:      в данном поле указывается Ф.И.О ген. директора.
 Гл. бухгалтер:      в данном поле указывается Ф.И.О главного бухгалтера.
 ФИО первого руководителя:      в данном поле указывается Ф.И.О первого руководителя.
 Должность первого руководителя:      в данном поле указывается должность первого руководителя...
 Контактное лицо:      в данном поле указывается контактное лицо.
 E-Mail:      в данном поле указывается e-mail.
 Телефон:      в данном поле указывается телефон.
 Факс:      в данном поле указывается факс.
 Вид документа:      в данном поле указывается вид документа привязанный к реквизиту, например паспорт.
 Серия:      в данном поле указывается серия документа.
 Номер:      в данном поле указывается номер документа.
 RQ_IDENT_DOC_PERS_NUM:      в данном поле указываются данные иностранных документов.
 Дата выдачи:      в данном поле указывается дата выдачи документа.
 Кем выдан:      в данном поле указывается кем был выдан данный документ.
 Код подразделения:      в данном поле указывается код подразделения, которое выдавало документ.
 ИНН:      в данном поле указывается ИНН организации.
 КПП:      в данном поле указывается КПП организации.
 Handelsregisternummer (для страны DE).:      в данном поле указывается но номер национального реестра юр лиц Германии.
 ИФНС:      в данном поле указывается ИФНС организации.
 ОГРН:      в данном поле указывается ОРГН организации.
 ОГРНИП:      в данном поле указывается ОРГНИП организации.
 ОКПО:      в данном поле указывается ОКПО организации.
 ОКТМО:      в данном поле указывается ОКТМО организации.
 ОКВЭД:      в данном поле указывается ОКВЭД организации.
 ЄДРПОУ:      в данном поле указывается ЄДРПОУ организации.
 ДРФО:      в данном поле указывается ДРФО организации.
 УНП:      в данном поле указывается УНП организации (Беларусь)
 КБЕ:      в данном поле указывается информация о получателе денежных средств (бенефициаре Казахстан)
 ИИН:      в данном поле указывается ИИН предпринимателя организации (Казахстан).
 БИН:      в данном поле уникальный номер, формируемый для юридического лица (филиала и представительства Казахстане)
 Серия св. о гос. регистрации:      в данном поле указывается серия свидетельства о гос. регистрации.
 Номер св. о гос. регистрации:      в данном поле указывается номер свидетельства о гос. регистрации.
 Дата св. о гос. регистрации:      в данном поле указывается дата выдачи свидетельства о гос. регистрации.
 Платник ПДВ (для страны UA):      в данном поле указывается регистрационный номер плательщика ПДВ в Украине.
 VAT ID (идентификационный номер (плательщика) НДС):      в данном поле указывается идентификационный номер (плательщика) НДС. Т.е номер, под которым налогоплательщик зарегистрирован в бюро учета НДС. Может практически совпадать с номером ИНН.
 Серия свидетельства по НДС:      в данном поле указывается серия свидетельства по НДС.
 Номер свидетельства по НДС:      в данном поле указывается номер свидетельства по НДС.
 Дата свидетельства по НДС:      в данном поле указывается дата выдачи свидетельства по НДС.
 Страна резидента:      в данном поле указывается страна резидента.
 RQ_BASE_DOC:      в данном поле указываются данные иностранных документов.

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

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

Текст статуса: 

в д

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


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

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

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

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

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

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

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

requisite_delete_lab.gif

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

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

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

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

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

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

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

requisite_delete_robot.gif

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

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

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

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

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

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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента (эти ID можно найти через F12+просмотр элементов). 

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

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

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

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

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

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

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

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

Сделки

Изменение Сделки

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

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

deal_update_lab.gif

Название Описание
ID Сделки (условие): В данном поле необходимо указать ID Сделки, которую мы будем редактировать.
Если поле имеет привязку к элементам инфо блоков (привязка к спискам), то для изменения значения нужно указывать ID элемента.
Название: В данном поле можно указать новое значение названия Сделки.
Тип сделки:

В данном поле можно изменить тип Сделки. Значения берутся из одноимённого справочника CRM.


Направление: В данном поле можно изменить направление Сделки, принцип заполнения данного поля аналогичен принципу поля "Стадия сделки", только штатное активити, необходимое для получения ID направления называется "Смена направления сделки", или можно использовать "Изменение документа". 
Данное поле заполняется так: С:ID направления.
Пример реального заполнения: С:7
При выборе сотрудника, в поле "привязка к пользователю" должен быть только его ID без лишних символов и букв.
Так же стоит учитывать, что НЕЛЬЗЯ изменить одновременно направление и стадию сделки, только поочередно.
Стадия сделки: в данном поле можно изменить стадию Сделки.
Чтобы добавить стадии сделок пользовательских направлений, необходимо в соседнем поле добавить эту стадию латинскими буквами, например "stage_ID"
Это значение можно получить следующим образом: 
1. В сделке нужно добавить штатное активити "Изменение документа" или штатное "Изменение стадии".
2. В этом активити выбрать поле "стадия"
3. Нажать F12 и выбрать инструмент "выбор элемента страницы", и выбрать поле напротив поля "стадия".
4. Появится расшифровка всех Стадий, выбираете название нужной и прописываете данное название в графе активити "Изменение сделки".

deal_update 2

ВАЖНО!
Активити не может изменить направление сделки, т.к механизм REST Api Б24 не позволяет это делать.

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

Название Описание
Вероятность: В данном поле можно изменить вероятность заключения Сделки в %.
Валюта расчетов: В данном поле можно изменить валюту расчётов Сделки. Значения берутся из одноимённого справочника 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. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.
Для полей тип "список", работает только условие "=" и сравнивается с ID элемента (эти ID можно найти в свойствах товара, либо через F12+просмотр элементов). 

search_of_goods 2.png


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

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

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

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

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

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

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

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

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

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

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

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

search_essence_transaction_robot.gif

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

Сотрудники

Выбор сотрудника по должности

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

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

get_worker_by_position_lab.gif


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

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

ВАЖНО!
Необходимо помнить, что система не принимает просто ID пользователя и требуется делать дополнительное действие через изменение переменных, чтобы получить на выходе следующую конструкцию - user_{ID которое получили}. Например, если Вы получили через наше активити ID 13, то для вставки в конкретную сущность необходимо привести его к форме - user_13.
Резервный пользователь: данное поле обязательно для заполнения и заполняется на тот случай, если сотрудник с искомой должностью уволен. Если сотрудник не был уволен, то данные, заполненные в этом поле игнорируются, а если был, то активити выдаст ID резервного пользователя.

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


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


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

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

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

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

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

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

get_worker_by_position_robot.gif

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


Выбор сотрудника по e-mail

Данное активити позволяет выбрать сотрудника по его e-mail адресу. Это особенно важно, когда вы хотите назначать задачи экстранет пользователям, т.к. по другому у вас не получится это сделать в рамках бизнес-процесса. 

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

get_worker_by_email_lab.gif


Email
 - в это поле необходимо вставить E-mail сотрудника, которого вы хотите выбрать.
На текущий момент, нет возможности удобно получать список экстранет-пользователей в бизнес-процессах и приходится выстраивать систему через e-mail.
Чтобы получить e-mail, необходимо либо создавать пользовательское поле типа список и туда заносить всех ваших экстранет пользователей, а потом с помощью бизнес-процесса сопоставлять полученного человека и его e-mail. Можно пойти проще. Сделать сразу список e-mail и в нём выбирать значение. 

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

ВАЖНО!
Необходимо помнить, что система не принимает просто ID пользователя и требуется делать дополнительное действие через изменение переменных, чтобы получить на выходе следующую конструкцию - user_{ID которое получили}. Например, если Вы получили через наше активити ID 13, то для вставки в конкретную сущность необходимо привести его к форме - user_13.
Результатом работы приложения будет получение ID конкретного сотрудника, который Вы уже сможете вставлять в свои бизнес-процессы.

Выбор сотрудника по E-mail


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

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

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

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

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

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


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

get_worker_by_email_robot.gif

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

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

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

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

get_worker_department_lab.gif

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

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

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

ВАЖНО!
Если у Вас сотрудник участвует сразу в нескольких отделах, то наше активити Вам не поможет, т.к. всегда будет возвращать первый попавшейся.

Получение отдела сотрудника в Битрикс24

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

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

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

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

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

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

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

get_worker_department_robot.gif

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


Поиск сотрудников

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

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

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

search_essence_user_lab.gif

ID:
указание ID искомого сотрудника.
Данный пункт рассчитан на вывод данных только 1 сотрудника.
Код подразделения: в данном поле указывается код подразделения.
Пример заполнения: [D1] , где "1", это ID подразделения.

Какие параметры выводить: данное поле позволяет ограничить перечень доступных к выводу параметров. Варианты выбора: Только ID/Все данные/Сокращенный список параметров.
Только ID: активити выдаст только ID пользователя.
Все данные: Все доступные данные о пользователе.
Сокращенный список параметров: 24 поля , ID пользователя, e-mail, фамилия, имя , отчество, пол, должность, день рождения, номер телефона мобильный и рабочий, факс, сайт или ссылка на соц сети, улица, город, индекс, страна, номер подразделения в котором работает.

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

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

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

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

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

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

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

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

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}.
Какие параметры выводить: в данном пункте доступны варианты выбора из выпадающего списка.
1. Только ID:
в результате поиска выводит только ID искомого сотрудника.
2. Все данные:
выводит все доступные данные о сотруднике.
3. Сокращенный список параметров:
выводятся только основные параметры о сотруднике(ID, имя, e-mail).

Если какие-либо данные у сотрудников будут совпадать, то активити будет выводить данные сотрудников, у которых эти данные совпадают.
Т.е если у 2 сотрудников совпал телефон или e-mail, то в результате активити выдаст ID этих пользователей.
Однако изначально активити рассчитано на поиск 1 сотрудника.

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

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

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

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

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

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

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

search_essence_user_lab.gif

Возвращаемые параметры для данного активити:
- ID сотрудника.
- Данные, которые указаны в учетной записи сотрудника(Ф.И.О., почта, телефон и пр.). 

Пригласить сотрудника

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

user_to_invite_name_lab.gif


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

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

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

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

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


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

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

Текст статуса: 

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


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

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

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

user_to_invite_name_robot.gif


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

Изменить данные сотрудника

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

user_update_lab.gif

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

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

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

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

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

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

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

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

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

user_update_robot.gif

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

Списки

Поиск элемента списка

Данное активити позволяет находить элементы списков, указав содержимое данного элемента и место, где стоит искать данный элемент. Поиск может быть осуществлен по любым полям, и результат поиска выводится в массив. 
Результатом работы является получение 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".
Содержимое искомого элемента: в данном пункте указывается название искомого элемента списка.
Пример: Трос

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

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

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

search_of_goods 2.png


!  не равно,  Пример заполнения !123 , это значит, что значение в поле не равно 123 (только для поля тип "строка" и "число").

>  больше, Пример заполнения >123 , это значит, что значение в поле больше 123 (только для поля тип "число").

<  меньше,  Пример заполнения <123 , это значит, что значение в поле меньше 123 (только для поля тип "число").

={=> больше или равно, Пример заполнения =>123 , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<  меньше или равно, Пример заполнения =<123 , это значит, что значение в поле меньше или равно 123 (только для поля тип "число").

Если поле не является строкой, то содержимое ячейки должно заполняться так: 
={=>14.03.2020 15:10}в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}.

Делать отладочные сообщения в журнал БП:варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.

Устанавливать текст статуса:
данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.

Текст статуса:
в данном поле указывается текстовый вариант статуса, который Вы можете изменять.

Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.

Период ожидания. Время ожидания ответа от приложения: Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. 

Это поле нужно для аварийного завершения активити, и если ответ не получен в течении того количества времени, то активити завершается.

Если вы хотите использовать результат работы активити (возвращаемый параметр) в другом активити, в котором параметр - простое число, то несколько чисел разделенных запятыми работать не будут, так как параметр ждет только одно число.
Если параметр простой - строка, то туда не нужно вставлять результат работы в виде массива для итератора, так как данный параметр предназначен для полей с типом заполнения "множественное".
Сценарий работы робота

search_in_elements_of_the_list_robot.gif

Возвращаемые параметры для данного активити:
Сообщение об ошибке
- Соответствует условиям
- ID элемента списка (первый, если больше 1)
- Результат поиска (массив для итератора) 


Удаление элемента списка

Данное активити позволяет удалять элементы списка, указав где расположен удаляемый элемент и указав его ID.

Сценарий работы активити бизнес-процесса

removal_of_an_element_of_the_list_lab.gif

Где искать элемент: 
из выпадающего списка выбирается месторасположение искомого элемента, путем выбора списка, в котором элемент может находится.
ВАЖНО!
Если список создан после установки активити, то его не будет в выпадающем списке, для того, чтобы он появился, нужно переустановить активити, это происходит из-за того, что активити получает перечень списков в момент установки.
Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.

Запускать от имени: 
данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы. 

Устанавливать текст статуса: 
данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма. 

Текст статуса: 
в данном поле указывается текстовый вариант статуса, который Вы можете изменять. 

Ожидать ответа: 
данное поле Вами не управляется. Оно необходимо для того, чтобы