Поиск группы

Данное активити позволяет искать группу или проект с настройками, указанными в активити.

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

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

Поиск групп по названию, описанию или ключевым словам;
Поиск групп владельца по ID пользователя;
Фильтрация групп по дате создания или обновления;
Поиск открытых или закрытых групп;
Поиск проектов (тип группы);
Получение списка ID групп для массовых операций;
Проверка существования группы с заданными параметрами;
Поиск групп по количеству участников;
Фильтрация по правам (кто может приглашать, кто может писать);
Интеграция с процессами - поиск группы для добавления участников.

Как работает активити (робот):
- Активити (робот) ищет рабочие группы по заданным критериям через API sonet_group.get;
- Поддерживаются операторы сравнения в значениях: =, !=, >=, <=, >, <, % (содержит), !% (не содержит);
- Результаты упорядочиваются по названию (NAME ASC);
- Параметр limit_result ограничивает количество возвращаемых ID;
- Все параметры необязательны, но без хотя бы одного поиск завершится с ошибкой.

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

Название поля	Описание и примеры использования
ID	Поиск по точному ID или с оператором. Примеры: 42, >=50, %123
Название группы (NAME)	Название группы. Примеры: %Проект (содержит), =Группа 1 (точно)
Описание группы (DESCRIPTION)	Описание. Пример: %сделка
Код пользователя-владельца группы (OWNER_ID)	Владелец группы. Тип: user. Примеры: {=User:ID}, {=Document:ASSIGNED_BY_ID}
Видима ли группа в списках (VISIBLE)	Выпадающий список, значения: да/нет. Пример: да
Открыта ли группа для свободного вступления (OPENED)	Выпадающий список, значения: да/нет. Пример: нет
Является ли группа архивной (CLOSED)	Выпадающий список, значения: да/нет. Пример: нет
Является ли группа активной (ACTIVE)	Выпадающий список, значения: да/нет. Пример: да
Ключевые слова (KEYWORDS)	Множественное значение. Пример: проект, 2024
Количество членов группы (NUMBER_OF_MEMBERS)	Количество участников. Примеры: >=5, =10
Дата создания, Дата изменения, Дата последней активности в группе (DATE_CREATE, DATE_UPDATE, DATE_ACTIVITY)	Даты создания, обновления, активности. Тип datetime. Пример: >=1699000000
Кто имеет право на прием в группу новых членов, Кто имеет право на написание сообщений членам группы (INITIATE_PERMS, SPAM_PERMS)	Права приглашения и записи. A, E или K. Пример: E
Ограничить количество результатов до (limit_result)	Максимум ID в результате. Пример: 10
Запускать от имени	Сотрудник с правами на поиск групп.

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

Описание примера	Решение
Найти группы текущего пользователя	OWNER_ID - {=User:ID}
Найти группы по названию	NAME - %Проект (содержит "Проект")
Найти открытые группы	OPENED - Y, limit_result - 5
Найти группу по ID	ID - {=Variable:GROUP_ID}
Найти группы ответственного за сделку	OWNER_ID - {=Document:ASSIGNED_BY_ID}
Найти группы, созданные за последний месяц	DATE_CREATE - >= (укажите timestamp, например через переменную)
Найти группы с ключевым словом	KEYWORDS - сделка или KEYWORDS - {=Document:ID}
Получить первую найденную группу	OWNER_ID - {=User:ID}, limit_result - 1. Используйте search_result_first_string.
Найти активные неархивные группы	ACTIVE - Y, CLOSED - N
Массовая обработка найденных групп	Передайте search_results_array в итератор. Обрабатывайте каждую группу в цикле.

Данные символы ставятся перед содержимым ячейки:

={%ваше значение} - содержит (можно искать буквы и цифры в выбранной вами строке).
Пример заполнения: ={%груша}, вернет все ID сущностей, в которых, в выбранном вами поле, содержится слово "груша".

={!%ваше значение} - не содержит.
Пример заполнения: ={!%123} , это значит, что значение в выбранном поле не содержит 123 (можно искать буквы и цифры в выбранной вами строке).

={ваше значение} - равно.
Пример заполнения: ={123} , это значит, что значение в выбранном поле равно 123. (только для поля тип "строка" и "число").
Если в поле используется текст, то этот текст должен совпадать символ в символ, иначе вы ничего не найдете.

={!ваше значение} - не равно.
Пример заполнения: ={!123} , это значит, что значение в выбранном поле не равно 123 (только для поля тип "строка" и "число").

={>ваше значение} - больше.
Пример заполнения: ={>123} , это значит, что значение в выбранном поле больше 123 (только для поля тип "число").

={<ваше значение} - меньше.
Пример заполнения: ={<123} , это значит, что значение в выбранном поле меньше 123 (только для поля тип "число").

={=>} больше или равно.
Пример заполнения ={=>123} , это значит, что значение в поле больше или равно 123 (только для поля тип "число").

={=<} меньше или равно.
Пример заполнения ={=<123} , это значит, что значение в поле меньше или равно 123 (только для поля тип "число")..

Если поле не является строкой, то содержимое ячейки должно заполняться так: ={=>14.03.2020 15:10}, в фигурных скобках указывается необходимый символ.
В случае с переменной, содержимое ячейки должно заполняться так: ={=>{=A1988_22222_92566_99999:search_results}}.
Для полей тип "дата" и "дата/время", при необходимости поиска диапазона "от и до" содержимое ячейки должно заполняться так:={{01.03.2015 14:55:22}}##{{07.05.2015 14:55:22}}

Возвращаемые параметры данного активити (робота):
- Соответствует условиям (math_search_results) - Y при наличии результатов, N если группы не найдены.
- Количество найденных (count_search) - число найденных групп.
- Результат поиска массив (search_results_array) - массив ID групп. Для итератора.
- Результат поиска строка (search_results_string) - ID через запятую.
- Первый результат (search_result_first_string) - ID первой группы.
- Последний результат (search_result_last_string) - ID последней группы.
- Сообщение об ошибке (s_error_logs) - описание или количество найденных.

При отсутствии результатов, параметр "Соответствие условиям" = N.
Проверяйте перед использованием массивов.

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

Хотя бы один параметр:
Необходимо указать минимум один критерий поиска.
Иначе активити (робот) завершится с ошибкой "Не указаны параметры поиска".

Операторы в значениях:
Используйте префиксы: = (равно), != (не равно), >=, <=, >, <, % (содержит), !% (не содержит).
Для OWNER_ID формат определяется автоматически.

Ограничить количество результатов ДО:
Ограничивает количество ID в результате.
Полезно для получения только первых N групп.

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

Поиск группы