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

Активити (робот) "Парсинг содержимого дела" предназначено для использования в роботах и может быть полезно в следующих сценариях:

Извлечение конкретных данных из темы или описания дела;
Парсинг номеров документов, сумм, дат и других данных из текста дела;
Извлечение слов до или после указанного слова;
Извлечение содержимого между двумя словами;
Поиск и извлечение чисел из текста дела;
Автоматическое извлечение данных для заполнения полей сущностей CRM;
Парсинг данных из писем, звонков и других дел;
Обработка структурированных данных в тексте дела;
Извлечение информации для аналитики и отчётности;
Автоматизация обработки данных из внешних источников.

Как работает активити (робот):
- Активити (робот) анализирует тему (SUBJECT) и описание (DESCRIPTION) дела по указанным правилам парсинга;
- Поддерживается несколько типов парсинга: получение слова до указанного слова, после указанного слова, между словами, извлечение чисел;
- Можно указать несколько правил парсинга для темы и описания дела одновременно;
- Результаты парсинга возвращаются в виде отдельных параметров (found_result_1, found_result_2 и т.д., до found_result_10);
- Активити (робот) возвращает параметр math_search_results (Y - данные найдены, N - данные не найдены);
- Активити (робот) работает через REST API Битрикс24 (crm.activity.get);
- Поддерживается обработка до 10 результатов парсинга одновременно.

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

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID дела	В данном поле указывается идентификатор дела, содержимое которого нужно распарсить. Это обязательный параметр. Примеры: - {=Variable:ACTIVITY_ID} - распарсить дело с ID из переменной предыдущего активити (робота); - 123 - распарсить дело с ID 123; - {=A1988_22222_92566_99999:new_id_activity} - использовать ID дела из результата активити (робота) "Создание своего дела в CRM"; - {=A1988_22222_92566_99999:search_result_first_string} - использовать первый ID из результата поиска дел; - {=Document:ID} - распарсить дело, если ID дела совпадает с ID документа; - {=Iterator:Value} - распарсить дело для каждого ID из итератора. Как получить ID дела: - Из результата активити (робота) "Создание своего дела в CRM" (параметр new_id_activity); - Из результата активити (робота) "Поиск дел" (параметр search_results_array или search_result_first_string); - Из переменной, созданной в предыдущих шагах бизнес-процесса; - Из поля документа, если дело связано с документом. Важно: Если дело с указанным ID не существует, активити (робот) завершится с ошибкой. Всегда проверяйте существование дела перед парсингом.
Парсинг темы дела	В данном поле указываются правила парсинга для темы (заголовка) дела. Это необязательный параметр, поддерживается множественный выбор (до 10 правил). Каждое правило имеет формат: "ТИП_ПАРСИНГА##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2". Типы парсинга: - 1##РАЗДЕЛИТЕЛЬ - получить слово до указанного разделителя (предыдущее слово); - 2##РАЗДЕЛИТЕЛЬ - получить слово после указанного разделителя (следующее слово); - 3##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2 - получить содержимое между двумя разделителями; - 4##КЛЮЧЕВОЕ_СЛОВО - найти и извлечь число из слова, содержащего ключевое слово. Примеры: - 1##Сделка - получить слово перед словом "Сделка" (например, из "Новая Сделка 123" получится "Новая"); - 2##№ - получить слово после символа "№" (например, из "Сделка №123" получится "123"); - 3##от##руб - получить содержимое между словами "от" и "руб" (например, из "Сумма от 10000 руб" получится "10000"); - 4##сумма - найти и извлечь число из слова, содержащего "сумма" (например, из "сумма12345" получится "12345"). Когда использовать: - Для извлечения данных из структурированных тем дел; - Для парсинга номеров, сумм и других данных из заголовка дела; - Для извлечения ключевой информации из темы дела.
Парсинг описания дела	В данном поле указываются правила парсинга для описания (содержания) дела. Это необязательный параметр, поддерживается множественный выбор (до 10 правил). Каждое правило имеет формат: "ТИП_ПАРСИНГА##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2". Типы парсинга: - 1##РАЗДЕЛИТЕЛЬ - получить слово до указанного разделителя (предыдущее слово); - 2##РАЗДЕЛИТЕЛЬ - получить слово после указанного разделителя (следующее слово); - 3##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2 - получить содержимое между двумя разделителями; - 4##КЛЮЧЕВОЕ_СЛОВО - найти и извлечь число из слова, содержащего ключевое слово. Примеры: - 1##Сумма - получить слово перед словом "Сумма" (например, из "Общая Сумма 50000" получится "Общая"); - 2##: - получить слово после двоеточия (например, из "Номер: 12345" получится "12345"); - 3##от##до - получить содержимое между словами "от" и "до" (например, из "Период от 01.01.2025 до 31.01.2025" получится "01.01.2025"); - 4##цена - найти и извлечь число из слова, содержащего "цена" (например, из "цена1000" получится "1000"). Когда использовать: - Для извлечения данных из структурированных описаний дел; - Для парсинга данных из писем, звонков и других дел; - Для извлечения информации из текста дела для дальнейшей обработки.
Делать отладочные сообщения в журнал БП	Варианты: да/нет. Позволяет выбрать, нужно ли создавать отладочные сообщения в журнал БП или нет. Это поле нужно использовать только по необходимости из-за большого расхода запросов и уменьшенной скорости срабатывания активити (робота).
Запускать от имени	Данное поле необходимо для того, чтобы установить сотрудника, с правами которого выполнять действие данного активити (робота). Если у сотрудника не будет прав на выполнение действия, то активити (робот) не сработает. Рекомендуем выбирать всегда сотрудника с правами администратора системы.
Устанавливать текст статуса	Данное поле позволяет включать возможность установки статуса бизнес-процесса. Это необходимо для того, чтобы во время работы активити (робота) информировать пользователя в истории о том, что бизнес-процесс остановился на конкретном шаге. Это особенно важно в момент отладки и выяснения причин неполадок в работе механизма.
Текст статуса	В данном поле указывается текстовый вариант статуса, который Вы можете изменять. Используется только при включённом параметре "Устанавливать текст статуса".
Ожидать ответа	Данное поле Вами не управляется. Оно необходимо для того, чтобы определить, нужно ли ожидать реакции от нашего активити (робота) после запуска.
Период ожидания. Время ожидания ответа от приложения	Указывается в секундах, минутах, часах, днях, но не менее 5 минут и желательно не более 1 часа. Это поле нужно для аварийного завершения активити (робота), и если ответ не получен в течении того количества времени, то активити (робот) завершается.

Примеры использования активити (робота)

Описание примера	Решение
Извлечение номера сделки из темы дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№ (получить слово после "№"), Парсинг описания дела - не указывается. Если тема дела "Сделка №12345", активити (робот) извлечёт "12345" в параметр found_result_1.
Извлечение суммы из описания дела	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - не указывается, Парсинг описания дела - 3##Сумма:##руб (получить содержимое между "Сумма:" и "руб"). Если описание "Общая Сумма: 50000 руб", активити (робот) извлечёт "50000" в параметр found_result_1.
Извлечение нескольких данных из темы	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№, 2##от (два правила: получить слово после "№" и после "от"), Парсинг описания дела - не указывается. Если тема "Сделка №123 от 01.01.2025", активити (робот) извлечёт "123" в found_result_1 и "01.01.2025" в found_result_2.
Извлечение числа из слова с ключевым словом	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 4##сумма (найти число в слове, содержащем "сумма"), Парсинг описания дела - не указывается. Если тема содержит "сумма12345" или "сумма_12345", активити (робот) извлечёт "12345" в параметр found_result_1.
Извлечение данных между разделителями	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - не указывается, Парсинг описания дела - 3##от##до (получить содержимое между "от" и "до"). Если описание "Период от 01.01.2025 до 31.01.2025", активити (робот) извлечёт "01.01.2025" в параметр found_result_1.
Извлечение слова до указанного разделителя	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 1##Сделка (получить слово перед "Сделка"), Парсинг описания дела - не указывается. Если тема "Новая Сделка 123", активити (робот) извлечёт "Новая" в параметр found_result_1.
Комплексный парсинг темы и описания	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№ (получить номер после "№"), Парсинг описания дела - 3##Сумма:##руб, 2##Дата: (получить сумму и дату из описания). Активити (робот) извлечёт номер в found_result_1, сумму в found_result_1 (из описания), дату в found_result_2 (из описания).
Парсинг через итератор	Параметры: ID дела - {=Iterator:Value}, Парсинг темы дела - 2##№, Парсинг описания дела - 3##Сумма:##руб. Для каждого дела из итератора активити (робот) извлечёт номер и сумму.
Извлечение данных для заполнения полей	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - 2##№ (номер сделки), Парсинг описания дела - 3##Сумма:##руб (сумма сделки). Используйте найденные значения для заполнения полей сущности CRM через активити (робот) "Изменение дела" или другие активити.
Парсинг структурированных данных	Параметры: ID дела - {=Variable:ACTIVITY_ID}, Парсинг темы дела - не указывается, Парсинг описания дела - 2##Номер:, 2##Телефон:, 2##Email: (извлечь номер, телефон и email из структурированного описания). Активити (робот) извлечёт все указанные данные в отдельные параметры.

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

Возвращаемые параметры данного активити (робота):
- Найденный результат 1 (found_result_1) - строка с результатом первого правила парсинга. Содержит извлечённое значение из темы или описания дела согласно первому правилу.
- Найденный результат 2 (found_result_2) - строка с результатом второго правила парсинга. Содержит извлечённое значение из темы или описания дела согласно второму правилу.
- Найденный результат 3-10 (found_result_3 - found_result_10) - строки с результатами последующих правил парсинга (до 10 результатов). Каждый параметр содержит извлечённое значение согласно соответствующему правилу парсинга.
- Соответствует условиям (math_search_results) - строка, указывающая результат парсинга. Возможные значения: Y (данные найдены и извлечены) или N (данные не найдены или парсинг не дал результатов). Используется в условиях для проверки успешности парсинга.

Особенности возвращаемых параметров:
- Результаты парсинга темы дела возвращаются в параметрах found_result_1, found_result_2 и т.д. в порядке указания правил;
- Результаты парсинга описания дела также возвращаются в параметрах found_result_1, found_result_2 и т.д., но с учётом индексации (если есть правила для темы, они занимают первые индексы);
- Если правило парсинга не дало результата, соответствующий параметр будет содержать "0";
- Максимальное количество результатов парсинга - 10 (found_result_1 до found_result_10).

Примеры использования возвращаемых параметров:
- Использовать found_result_1 для заполнения поля номера сделки;
- Использовать found_result_2 для заполнения поля суммы сделки;
- Использовать несколько найденных результатов для создания новой сущности CRM;
- Проверить math_search_results для определения успешности парсинга;
- Использовать найденные данные в условиях для условной логики бизнес-процесса;
- Передать найденные данные в другие активити (роботы) для дальнейшей обработки.

Важно о возвращаемых параметрах: Если парсинг не дал результатов или правило парсинга не сработало, соответствующий параметр будет содержать "0". Всегда проверяйте значение параметра math_search_results перед использованием найденных данных в дальнейших шагах бизнес-процесса.

Важно! Ограничения и рекомендации:

Обязательные параметры:
Для успешного парсинга обязательно должен быть указан параметр "ID дела". Также необходимо указать хотя бы одно правило парсинга в параметрах "Парсинг темы дела" или "Парсинг описания дела".

Формат правил парсинга:
Правила парсинга должны быть указаны в формате: "ТИП_ПАРСИНГА##РАЗДЕЛИТЕЛЬ1##РАЗДЕЛИТЕЛЬ2", где:
- ТИП_ПАРСИНГА - число от 1 до 4 (тип операции парсинга);
- РАЗДЕЛИТЕЛЬ1 - первый разделитель (слово или символ для поиска);
- РАЗДЕЛИТЕЛЬ2 - второй разделитель (используется только для типа 3).
Разделители разделяются двойным символом ##.

Типы парсинга:
- Тип 1 (получить слово до разделителя) - извлекает предыдущее слово перед указанным разделителем;
- Тип 2 (получить слово после разделителя) - извлекает следующее слово после указанного разделителя;
- Тип 3 (получить содержимое между разделителями) - извлекает текст между двумя указанными разделителями;
- Тип 4 (извлечь число из слова с ключевым словом) - находит слово, содержащее ключевое слово, и извлекает из него число.

Ограничение количества результатов:
Активити (робот) поддерживает извлечение до 10 результатов парсинга одновременно (found_result_1 до found_result_10). Если указано больше 10 правил парсинга, будут обработаны только первые 10.

Обработка результатов:
Если правило парсинга не дало результата (например, разделитель не найден в тексте), соответствующий параметр будет содержать "0". Это позволяет определить, какие правила сработали, а какие нет.

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

Права доступа:
Убедитесь, что пользователь, указанный в поле "Запускать от имени", имеет права на просмотр дел в CRM. Рекомендуется использовать пользователя с правами администратора системы.

Обработка ошибок:
Если дело с указанным ID не существует, активити (робот) завершится с ошибкой. Всегда проверяйте существование дела перед парсингом. Если парсинг не дал результатов, параметр math_search_results будет равен N.

Ваша корзина пуста

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