| Включить страницу | ||||
|---|---|---|---|---|
|
Метод: addSmartGroup
Вы можете создать новую смарт-группу с помощью метода addSmartGroup.
...
Параметры запроса
| Параметр | Тип | Описание |
|---|
| token (обязательный) |
| string | Токен доступа. Вы можете получить токен с помощью запроса | |
| name (обязательный) | string | Название новой смарт-группы |
| rules (необязательный) | array | Список правил смарт-группы |
| attributeType (обязательный) | int | Может принимать значения: |
| attributeId (необязательный) | string | Идентификатор поля профиля. |
| Заполняется только для полей профиля ( |
| attributeType — 3) |
| operator (обязательный) | int | Для подразделений:
Для групп и полей профиля:
|
| value (обязательный) | string | Для подразделений:
Для групп:
Для поля профиля:
|
Внимание: для поля Страна нужно использовать ID страны, а не название. ID страны можно получить при помощи метода Получение списка полей профиля пользователя |
| Информация |
|---|
Вы можете добавить несколько групп условий для добавления пользователей в смарт-группу. Они будут работать по принципу «И», то есть должны будут сработать одновременно. Внутри этих групп создайте любое число правил. Они, напротив, работают по принципу «ИЛИ», то есть достаточно выполнения одного из правил. Подробнее о смарт-группах и их условиях читайте в статье Смарт-группы. |
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками, которые позволяют добавлять смарт-группы.
Возвращаемые значения
После того, как запрос был успешно обработан, система отправляет объект со следующими свойствами:
Параметр | Тип | Описание |
|---|---|---|
groupId | string | ID добавленной смарт-группы. |
Возможные ошибки
| Тип | Описание |
|---|---|
| Permission denied | У пользователя недостаточно прав для добавления смарт-групп. |
| Wrong parameters | Не удалось обработать запрос, т.к. он не включает все нужные параметры или они заданы неверно. |
Пример запроса
| Блок кода | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="utf-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="httphttps://schemas.xmlsoap.org/soap/envelope/" xmlns="httphttps://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <AddSmartGroupRequest> <credentials> <accountUrl>http://myaccount.ispringlearn.ru</accountUrl> <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token> <email>email@email.com</email> <password>password</password> </credentials> <name> NEW GROUP</name> <rules> <and> <or> <rule> <attributeType>1<attributeType> <attributeId> </attributeId> <operator>2</operator> <value>id_departnent</value> </rule> </or> <or> <rule> <attributeType>2</attributeType> <attributeId></attributeId> <operator>1</operator> <value>id_group</value> </rule> </or> <or> <rule> <attributeType>3</attributeType> <attributeId>JON_TITLE</attributeId> <operator>1</operator> <value>кассир</value> </rule> </or> </and> </rules> </AddSmartGroupRequest> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
...
| Блок кода | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="httphttps://schemas.xmlsoap.org/soap/envelope/" xmlns="httphttps://ispringlearn.com/go/services/api/soap"> <SOAP-ENV:Body> <AddSmartGroupResult> <groupId>string</groupId> </AddSmartGroupResult> </SOAP-ENV:Body> </SOAP-ENV:Envelope> |
...