Поиск элементов Списка по любым полям

Приложение для Битрикс24, которое добавляет роботов и активити для бизнес-процессов Битрикс24 и позволяет находить элементы списка по стандартным и пользовательским полям.

Что внутри

• Поиск элементов списка по стандартным и пользовательским полям

• Поиск сразу по нескольким условиям без ограничений

• Результат в виде количества, массива ID и первого ID

• Использование результатов в последующих роботах, активити, итераторах, шаблонах БП и умных сценариях

• Отдельные роботы и активити для каждого списка

Лендинг приложения:https://searchlist.digitalforsales.ruТекстовая версия видео:https://digitalforsales.com/case/poisk-elementov-spiska-po-lyubym-polyam-prilozhenie-dlya-bitriks24

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

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

Именно для этого и нужно приложение.

Оно особенно полезно, когда требуется:

• выполнить массовые действия по найденным элементам;

• получить статистику по выборке;

• найти дубли;

• определить “оригинальную” запись среди дублей;

• передать массив ID в итератор или следующий шаг бизнес-процесса;

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

Есть список брендов, и одно из полей карточки — ИНН. Бренды заводят несколько месяцев разные сотрудники. В какой-то момент нужно искать дубли.

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

Дальше возникает следующий вопрос: какой бренд оставить, если найдено, например, 4 дубля?
Обычно оставляют тот элемент, который был создан раньше других. Найти его помогает результат ID первого найденного элемента.

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

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

Приложение добавляет новые активити в Дизайнер бизнес-процессов и новых роботов Битрикс24.

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

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

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

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

Функционал приложения позволяет выполнять поиск:

• по стандартным полям;

• по пользовательским полям;

• сразу по нескольким полям;

• без ограничений по количеству условий.

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

Итогом поиска будут несколько значений:

• Общее число найденных элементов;

• Массив ID найденных элементов — его можно использовать в последующих роботах, активити, шаблонах и итераторах;

• ID первого найденного элемента — то есть записи, созданной раньше остальных;

• Информация об ошибках, если они возникнут.

Штатный функционал Битрикс24 позволяет отфильтровать элементы списка и увидеть таблицу.
Но дальше результат обычно приходится обрабатывать вручную или выгружать в Excel/CSV.

Наше приложение решает эту задачу по-другому: оно возвращает готовые данные для автоматизации.

Вы получаете не просто найденные элементы, а:

• число для условий и проверок;

• массив ID для массовой обработки;

• первый ID для определения основной записи среди дублей.

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

Штатный функционал Битрикс24 позволяет сегментировать элементы списка по одному или нескольким фильтрам. Но в итоге мы получаем просто список, который либо нужно обрабатывать вручную, либо выгружать.

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

И в дальнейшем эти данные можно использовать:

• в полях других роботов и активити;

• в шаблонах бизнес-процессов;

• в умных сценариях;

• в итераторах;

• в регулярных проверках и служебных процессах;

• для разовой переработки уже существующей базы элементов списка.

На практике приложение особенно полезно для:

• поиска дублей в списках;

• поиска “оригинальной” записи;

• автоматического контроля справочников;

• обработки найденных элементов по очереди;

• построения условий вида “если найдено больше одного элемента”;

• запуска массовых действий по найденной выборке.

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

• для справочников и реестров;

• для внутренних баз объектов, брендов, материалов, юрлиц;

• для служебных и административных процессов;

• для контроля качества данных;

• для устранения дублей;

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

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

Варианты решения работают на тарифах, где доступен соответствующий функционал Битрикс24.

Робот — на всех платных тарифах.
Активити — на тарифах не ниже Профессионального.

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

Перенесли приложение на более мощный Х5-сервер.

ТОП-10 вопросов и ответов о приложении

Для чего нужен поиск элементов списков по полям?

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

Какие результаты возвращает поиск?

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

Можно ли искать одновременно по нескольким полям?

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

Где доступны роботы и активити для списков?

Роботы работают во всех разделах портала: лидах, сделках, списках, умных сценариях и шаблонах БП. Активити доступны на тарифах уровня «Профессиональный» и выше.

Можно ли использовать приложение для поиска дублей?

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

Что дает ID первого найденного элемента?

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

Можно ли применять поиск в итераторах?

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

Что делать, если списки созданы после установки приложения?

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

Почему важно настраивать таймаут на 10 минут?

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

Подходит ли приложение для регулярной массовой обработки данных?

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

Полезные приложения для администраторов и интеграторов