Выбрать курс
18
/
254
Добавить событие календаря
Данное активити позволяет добавлять события в календарь, ID которого вы укажите в настройках.
Тип календаря: в данном поле нужно выбрать тип календаря. Это может быть календарь сотрудника (user), календарь группы (group) либо календарь Компании (company).
Идентификатор владельца календаря: в данном поле следует указывать id сотрудника, либо id группы (ID группы указывается именно цифрой и никак иначе). Значение указывается простой цифрой (без квадратных скобок).
Нельзя подставлять пользователя из списка пользователей.
Дата завершения события: в данном поле требуется указать, когда завершится планируемое событие.
Идентификатор календаря: в данном поле требуется указать id календаря пользователя, группы.
Чтобы понять, какое значение сюда требуется прописать, необходимо:
1. Для календаря пользователя (или Компании).
Перейдите в список календарей и нажмите "Настройки"
2. Для календаря группы.
Перейдите в календарь группы и нажмите F12.
Нажмите на инструмент выбора блока и наведите на календарь.
В классе bxec-sect: содержится id календаря.
Значение даты передается без времени: эта опция позволит устанавливать даты события без указания времени.
Наименование события: в данном поле вы указываете тему создаваемого события.
Описание события: в данном поле вы указываете текстовое описание создаваемого события.
Цвет фона события: в данном поле вы указываете цвет создаваемого события в календаре. Применяется код цвета HTML.
Доступность на время события: в данном поле вы определяете отметку занятости, которая будет отображаться в планировщике событий.
Важность события: в данном поле вы можете выбрать категорию важности создаваемого события в календаре.
Частное событие: при указании значения "да" в данном поле, Вы ограничиваете видимость содержания создаваемого события. В календаре будет отображаться что событие есть, но прочесть другим сотрудникам его не получится.
Место проведения: в данном поле вы можете указать место проведения создаваемого события.
Данные заполняются текстом.
НАПОМИНАНИЕ (за сколько): в данном поле вы можете указать, что система должна Вас уведомить за какое-то время. Значение указывается в целых числах.
НАПОМИНАНИЕ (единица измерения): в данном поле вы можете указать, в каких единицах измерения вести отсчет времени до напоминания (дни, часы, минуты)
Список участников события: в данном поле указываются участники создаваемого события. Поле является множественным. Значение указывается через контекстное меню, либо в ручную в формате: Администратор KOSAS [1234].
ВСТРЕЧА: Текст приглашения - в данном поле указывается описание для события типа встреча.
ВСТРЕЧА: признак открытой встречи - в данном поле указывается тип события. Встреча может быть общедоступная или закрытая.
ВСТРЕЧА: флаг оповещения о подтверждении\отказе участников - данная опция позволит (с помощью системного механизма Битрикс24) отправить оповещение о событии.
ВСТРЕЧА: флаг запроса повторного подтверждения участия (при редактировании события) - в данной опции (с помощью системного механизма Битрикс24) указывается необходимость повторно уведомлять участников события если в него будут вноситься изменения.
Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Сценарий работы активити бизнес-процесса
Тип календаря: в данном поле нужно выбрать тип календаря. Это может быть календарь сотрудника (user), календарь группы (group) либо календарь Компании (company).
Идентификатор владельца календаря: в данном поле следует указывать id сотрудника, либо id группы (ID группы указывается именно цифрой и никак иначе). Значение указывается простой цифрой (без квадратных скобок).
Нельзя подставлять пользователя из списка пользователей.
Для календаря Компании, ID владельца не указывается.
Дата начала события: в данном поле требуется указать, когда начнётся планируемое событие.Дата завершения события: в данном поле требуется указать, когда завершится планируемое событие.
Идентификатор календаря: в данном поле требуется указать id календаря пользователя, группы.
Чтобы понять, какое значение сюда требуется прописать, необходимо:
1. Для календаря пользователя (или Компании).
Перейдите в список календарей и нажмите "Настройки"
Далее необходимо нажать F12 в браузере и навести курсор на список календарей выбора по умолчанию для приглашений.
К сожалению, в API Битрикс24 нет метода, который бы выбирал календарь пользователя по умолчанию для приглашений самостоятельно.
Вы можете ускорить появления данного метода, обратясь в поддержку Битрикс24 с указанием данного номера обращения.
Вы можете ускорить появления данного метода, обратясь в поддержку Битрикс24 с указанием данного номера обращения.
2. Для календаря группы.
Перейдите в календарь группы и нажмите F12.
Нажмите на инструмент выбора блока и наведите на календарь.
В классе bxec-sect: содержится id календаря.
Значение даты передается без времени: эта опция позволит устанавливать даты события без указания времени.
Наименование события: в данном поле вы указываете тему создаваемого события.
Описание события: в данном поле вы указываете текстовое описание создаваемого события.
Цвет фона события: в данном поле вы указываете цвет создаваемого события в календаре. Применяется код цвета HTML.
Доступность на время события: в данном поле вы определяете отметку занятости, которая будет отображаться в планировщике событий.
Важность события: в данном поле вы можете выбрать категорию важности создаваемого события в календаре.
Частное событие: при указании значения "да" в данном поле, Вы ограничиваете видимость содержания создаваемого события. В календаре будет отображаться что событие есть, но прочесть другим сотрудникам его не получится.
Место проведения: в данном поле вы можете указать место проведения создаваемого события.
Данные заполняются текстом.
НАПОМИНАНИЕ (за сколько): в данном поле вы можете указать, что система должна Вас уведомить за какое-то время. Значение указывается в целых числах.
НАПОМИНАНИЕ (единица измерения): в данном поле вы можете указать, в каких единицах измерения вести отсчет времени до напоминания (дни, часы, минуты)
Список участников события: в данном поле указываются участники создаваемого события. Поле является множественным. Значение указывается через контекстное меню, либо в ручную в формате: Администратор KOSAS [1234].
Данное поле работает только с переменными тип "привязка к пользователю" и никакими более, так же возможна работа с константами аналогичного типа .
Организатор события: в данном поле указывается организатор создаваемого события. Значение указывается простой цифрой (без квадратных скобок). Это поле важно заполнять, когда это событие календаря типа встреча и в него будут приглашаться другие участники.
Для добавления участников события, в параметре "Создать встречу" должно быть указано "Да".
Создать встречу: данное поле позволяет создавать событие тип встреча, на которую приглашаются участники.ВСТРЕЧА: Текст приглашения - в данном поле указывается описание для события типа встреча.
ВСТРЕЧА: признак открытой встречи - в данном поле указывается тип события. Встреча может быть общедоступная или закрытая.
ВСТРЕЧА: флаг оповещения о подтверждении\отказе участников - данная опция позволит (с помощью системного механизма Битрикс24) отправить оповещение о событии.
ВСТРЕЧА: флаг запроса повторного подтверждения участия (при редактировании события) - в данной опции (с помощью системного механизма Битрикс24) указывается необходимость повторно уведомлять участников события если в него будут вноситься изменения.
Делать отладочные сообщения в журнал БП: варианты да/нет.
Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет.
Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити.
Запускать от имени: данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити. Если у сотрудника не будет прав на выполнение действия, то активити не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса: данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса: в данном поле указывается текстовый вариант статуса, который Вы можете изменять.
Ожидать ответа: данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити после запуска.
Период ожидания. Время ожидания ответа от приложения - Данная опция позволяет ограничить срок ожидания ответа от приложения. Технические особенности платформы Битрикс24 иногда создают ситуацию при которой создаётся очередь из огромного числа запросов. Это может помешать работе нашего активити и бизнес-процесс будет ожидать длительный период времени. Для того чтобы не останавливать дальнейшие действия, вы можете установить своё время ожидания. Если время истекло и результат не получен, то бизнес-процесс будет двигаться далее по заложенной вами логике.
Сценарий работы робота
Возвращаемые параметры для данного активити:
- Возвращает ID события.
- Возвращает ID события.