Коды подстановки сущностей

Урок 52 из 248
Автор: Марина Павлова
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
3 из 5
Просмотров: 10003
Дата изменения: 16.11.2023
Недоступно в лицензиях:
Текущую редакцию Вашего 1С-Битрикс можно просмотреть на странице Обновление платформы (Marketplace > Обновление платформы).
Все лицензии БУС

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

  Пользователь

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

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

="user_5"
где число 5 – идентификатор пользователя.

Если идентификатор является переменным и подставляется через форму Вставка значения (например, он записан в переменную или в какое-то поле документа), то в записи потребуется использовать оператор конкатенации &. Например:

="user_" & {=Variable:Variable1}
где {=Variable:Variable1} – переменная шаблона БП.

  Группы пользователей

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

КодОписаниеПример полной записи
Основная система (главный модуль) Группы и пользователи в административном разделе по пути Настройки > Пользователи. Подробнее в уроках Работа с учетными записями пользователей и Группы пользователей учебного курса «Администратор сервиса Битрикс24 (коробочная версия)».
G Группа пользователей group_G7
U Пользователь group_U7
Интранет (intranet) Подразделения структуры компании. Подробнее в уроке Структура компании учебного курса «Администратор сервиса Битрикс24 (коробочная версия)».
IU Пользователь отдела (подразделения) group_IU7
D Все сотрудника отдела group_D7
DR Все сотрудники отдела с подотделами group_DR7
Dextranet Все публичные сотрудники Публичный сотрудник - это обязательно сотрудник компании, обладающий свойством публичности на сайте экстранета, т.е данный сотрудник всегда доступен для общения и включения в любую рабочую группу экстранета.

Подробнее в уроке Публичный сотрудник курса Администратор сервиса Битрикс24 (коробочная версия).
group_Dextranet
UA Все пользователи компании group_UA
Социальная сеть (socnet) Группы и проекты, которые открываются из основного меню портала. Подробнее на helpdesk.bitrix24.ru.
SU Пользователь социальной сети group_SU7
SG1_A Владелец группы group_SG7_A
SG1_E Модераторы группы group_SG7_E
SG1_K Все члены группы group_SG7_K
Важно понимать: Если в поле, где должен быть указан пользователь, добавляется код группы, то система берет первого пользователя Первым пользователем будет тот, что создан ранее остальных, т.е. с меньшим идентификатором. этой группы (подходящего по условиям).

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

="group_D3"

Если идентификатор является переменным и подставляется через форму Вставка значения (например, он записан в переменную или в какое-то поле документа), то в записи потребуется использовать оператор конкатенации &. Например:

="group_SG" & {=A52792_89450_17178_72721:GroupId} & "_K"
где {=A52792_89450_17178_72721:GroupId} – идентификатор группы, созданной ранее действием Создать группу Действие позволяет создать группу.

Подробнее...
.

  Сущности CRM

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

  • Контакты: ="C_"&{{ID}}
  • Сделки: ="D_"&{{ID}}
  • Лиды: ="L_"&{{ID}}
  • Компании: ="CO_"&{{ID}}
  • Счета (новые): ="SI_"&{{ID}}

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

Как привязать элемент смарт-процесса

 Пример привязки Контакта и Компании, связанных со сделкой, с помощью префиксов

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

Подробнее...
из бизнес-процесса сделки, привязывать Контакт и Компанию, связанные с этой сделкой.

Для привязки Контакта нам понадобится использовать "C_"&, а для Компании - "CO_"&. В качестве идентификаторов этих элементов выберем в форме Вставка значения, секции Поля документа: Контакт: ID и Компания: ID.

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

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



Нам жаль это слышать… Но мы постараемся быть лучше!

Мы благодарны Вам за помощь в улучшении документации.

Спасибо, мы рады что смогли помочь Вам. Ниже Вы можете оставить свой отзыв или пожелание :)
Мы стараемся сделать документацию понятнее и доступнее,
и Ваше мнение важно для нас
Курсы разработаны в компании «1С-Битрикс»