Оглавление / Бизнес-процессы

Работа с данными через бизнес-процессы

Работа с данными полей через функционал бизнес-процессов в CRM INTRUM

Работа с данными через функционал бизнес-процессов

Оглавление: 

• Как проверить в каком виде бизнес-процесс получает информацию
• Описание типов полей, которые отнятся ко всем видам карточек
  • Базовое поле Ответственный
  • Выбор Да \ Нет
  • Выбор одного
  • Выбор нескольких
  • Дата
  • Дата+время
  • Целое число
  • Число
  • Текст
  • Цена
  • Файл
  • Координата
  • Поля с типом Прикрепление
• Контакты
  • Базовое поле Тип контакта
  • Базовое поле Телефон
  • Базовое поле Email

Как проверить в каком виде бизнес-процесс получает информацию

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

return print_r($pole,true);

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

Описание типов полей, которые отнятся ко всем видам карточек

Базовое поле Ответственный

Чтение данных

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

1. Главный ответственный.

Тип данных: Целое число (int)
Пример:

2

2. Дополнительный ответственный.

Тип данных: Массив (array)
Пример:

array(
   '0' => '8',
   '1' => '6',
   '2' =>10
);

Так же при получении данных ответственного можно получать основные и дополнительные поля из карточки сотрудника. Формат данных будет полностью соответствовать типам полем. Исключением являются базовые поля, которые описаны в разделе "Сотрудники". 

Запись данных

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

Пример для записи одного сотрудника:

return '2'; 

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

return array(
   '0' => '2',
   '1' => '6',
   '2' => '10'
); 

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

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

Особенность редактирования поля (т. е. поле не является пустым) для изменения главного ответственного. Необходимо получить данные из поля (главного и дополнительных ответственных), далее, используя полученные данные, собрать нужный массив так, чтобы с индексом [0] был главный ответственный. 

Выбор Да \ Нет

Чтение данных

Данные представлены целым числом. Да = 1, Нет = 0.
Тип данных: Целое число(int);
Пример:

1

Запись данных

Для записи в поле вернуть '1' или '0'.
Пример:

return '1';// 1 = Да, 0 = Нет.

Выбор одного

Чтение данных

Данные представлены текстовой строкой в том же виде, в котором их видно внутри карточки.
Тип данных: Строка(string)
Пример:

Текст1

Запись данных

Для записи в поле вернуть нужную строку.
Пример:

return 'квартира вторичка';

Выбор нескольких

Чтение данных

Данные представлены текстовой строкой, где каждое добавленное значение записано через запятую.
Тип данных: Строка(string)
Пример:

Value1,Value2,Value3

Запись данных

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

return 'avito.ru,cian.ru,afi.ru';

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

Дата

Чтение данных

Данные представлены текстовой строкой, где дата записана в формате Y-m-d.
Тип данных: Строка(string)
Пример:

2025-01-01

Запись данных

Вернуть строку с датой в формате Y-m-d.
Пример:

return '2025-01-01';

Дата+время

Чтение данных

Данные представлены текстовой строкой, где дата записана в формате Y-m-d H:i:s.
Тип данных: Строка(string)
Пример:

2025-01-01 12:00:01

Запись данных

Вернуть строку с датой в формате Y-m-d H:i:s.
Пример:

return '2025-01-01 12:00:00';

Целое число

Чтение данных

Данные представлены целым числом..
Тип данных:  Целое число(int).
Пример:

20

Запись данных

Вернуть нужное целое число..
Пример:

return '20';

Число

Чтение данных

Данные представлены числом с дробной составляющей.
Тип данных:  Число с плавающей точкой (float).
Пример:

27.90

Запись данных

Вернуть нужное число с дробной составляющей или целое число.
Пример:

return '105.5';

Текст

Чтение данных

Данные представлены текстовой строкой в том же виде, в котором их видно внутри карточки. Может быть многострочной.
Тип данных:  Строка(string).
Пример:

Simple text string

Запись данных

Вернуть нужную строку с любым текстом.
Пример:

return 'Текстовое значение для поля';

Цена

Чтение данных

Данные представлены числом с дробной составляющей.
Тип данных: Число с плавающей точкой (float).
Пример:

50000.00

Запись данных

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

return '50000.00';

Файл

Чтение данных

Данные представлены линейным массивом, где у первого элемента будет индекс 0. Значения массива содержат прямые ссылки на файлы, которые загружены в поле.
Тип данных: Массив (array)
Пример:

array(
   '0' => 'https://domen.intrumnet.com/files/crm/product/XX/9c/6X921ebc128bc.jpg',
   '1' => 'https://domen.intrumnet.com/files/crm/product/XX/9c/6Yx921ebc118c.jpg',
   '3' => 'https://domen.intrumnet.com/files/crm/product/XX/9c/6xZ921ebc138c.jpg',
)

Запись данных

Файлы в поля с типом файл добавляются только через API.
Сначала файл необходимо загрузить на сервер методом - https://www.intrumnet.com/api/#utils-upload
Далее прописать загруженный файл в поле методом редактирования - https://www.intrumnet.com/api/#stock-update

Координата

Чтение данных

Данные представлены массивом с ключами [x] и [y].
Тип данных: Массив (array).
Пример:

array(
   'x' => '45.064896',
   'y' => '39.04098'
}

Запись данных

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

return array(
   'x' => '45.064896',
   'y' => '39.04098'
);

Поля с типом Прикрепление

Чтение данных

Данный тип поля позволяет прикрепить в одно поле любой из перечисленных видов карточек: Контакты, Объекты, Заявки, Задачи, воронки из раздела Дополнительно (Сделки), Сотрудники.
Тип данных: Массив (array).
Пример:

array(
    array(
             'value_attach_count' => 1,
             'value_attach_id' => 191092,
             'value_attach_type' => 'customer', /// Контакт
             'comment' => 'text'
    ),
    array(
             'value_attach_count' => 1,
             'value_attach_id' => 638215,
             'value_attach_type' => 'stock', /// Объект
             'comment' => ''
    ),
    array(
             'value_attach_count' => 1,
             'value_attach_id' => 1470,
             'value_attach_type' => 'request', /// Заявка
             'comment' => ''
    ),
     array(
             'value_attach_count' => 1,
             'value_attach_id'=> 230,
             'value_attach_type' => 'sale', /// Дополнительно (Сделка)
             'comment' => ''
     ),
    array(
             'value_attach_count' => 1,
             'value_attach_id' => 16502,
             'value_attach_type' => 'task', /// Задача
             'comment' => ''
         ),
    array(
             'value_attach_count' => 1,
             'value_attach_id' => 2, // ID сотрудика
             'value_attach_type' => 'employee', /// Сотрудник
             'comment' => ''
         ),
    )

Поля с типом Прекрепления конкретных видов карточек значительно не отличаются. При получении у них отличается только значение в value_attach_type. Возможные значения см. в примере в выше. 

Запись данных

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

return array(
   array(
      'value_attach_count' => '1',
      'value_attach_id' => 1470,
      'value_attach_type' => 'request',
      'comment' => 'text'
   ),
   array(
      'value_attach_count' => '1',
      'value_attach_id' => 1471,
      'value_attach_type' => 'request'
   ),
);

Поля с типом для Прекрепления конкретных видов карточек значительно не отличаются. Разница только в том, что значение в value_attach_type должно соответствовать полю.

Контакты

Базовое поле Тип контакта

Чтение данных

Поле возвращает целое число, которое указывает на ID типа контата. Посмотреть список возможных типов контактов можно в Настройках (Настройки - CRM - Контакты - вкладка Настройка типов). Первый столбец в таблице с типами указывает на ID номер типа, который возвращает данное поле.

● Как добавить новый тип контакта

Запись данных

Запись данных работает аналогично полю "Целое число" (см. Запись данных в поле с типом Целое число).. Необходимо вернуть ID нужного типа контакта.

Базовое поле Телефон

Телефонные номера хранятся в базе  формате 79992223311.

Чтение данных

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

• Первый

Возвращает текстовую строку.
Пример:

79002221100

• Первый с комментарием

Возвращает текстовую строку с перым номером и комментарием.
Пример:

79002221100 - текст комментария 

• Все

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

79002221100, 79999999999, 72222222222

• Все с комментариями

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

79002221100 - Комментарий1, 79999999999 - Комментарий2, 72222222222 - Комментарий3

• PHP Array

Возвращает массив (array), который содержит все телефоны и комменатрии из поля.
Пример:

array(
   array(
      'phone' => '79002221100',
      'comment' => 'Комментарий1'
   ),
   array(
      'phone' => '79999999999',
      'comment' => 'Комментарий2'
   ),
   array(
      'phone' => '72222222222',
      'comment' => 'Комментарий3'
   )
)

Запись данных

Для заприси в поле можно ввернуть:

1. Текстовую строку с одним номером в формате 79002221100.
2. Массив аналогичный тому, который можно получить из поля (см. PHP Array)

Базовое поле Email

Поле для чтения и записи информации работает полностью аналогично полю "Базовое поле Телефон". 

У поля отличается только результат в формате PHP Array.
Пример:

array(
   array(
      'mail' => 'test1@test.ru',
      'comment' => 'Комментарий1'
   ),
   array(
      'mail' => 'tes2t@test.ru',
      'comment' => 'Комментарий2'
   ),
   array(
      'mail' => 'test3@test.ru',
      'comment' => 'Комментарий3'
   )
)

Для записи аналогично полю "Базовое поле Телефон" можно пернуть строку с одним почтовым адресом, либо массив в формате PHP Array.

---

Обязательно ознакомьтесь дополнительно:

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

Библиотека бизнес-процессов

Вернуться к оглавлению