Документация по iSpring Learn

Дерево страниц

Сравнение версий

Старая версия 9

changes.mady.by.user admin

Сохранено

по сравнению с

Новая версия 10

changes.mady.by.user admin

Сохранено

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Вы можете создать новую смарт-группу с помощью метода addSmartGroup.

Права пользователя для выполнения запроса: Владелец аккаунта, Администратор аккаунта, Администратор подразделения или роль с индивидуальными настройками, которые позволяют добавлять смарт-группы.

Параметры запроса

ПараметрТипОписание
credentials (обязательный)credentialsСмотрите описание объекта Credentials.
name (обязательный)stringНазвание новой группы.
attributeType (обязательный)int

Может принимать значения:

  • 1 - подразделение

  • 2 - группа

  • 3 - поля профиля

attributeId (необязательный)stringИдентификатор поля профиля. Заполняется только для полей профиля (attributeType — 3).
operator (обязательный)int

Для подразделений:

  • 1 - одно подразделение без его дочерних подразделений
  • 2 - подразделение и все его дочерние подразделения

Для групп и полей профиля:

  • всегда 1
value (обязательный)string

Для подразделений:

  • ID подразделения

Для групп:

  • ID группы

Для поля профиля:

  • значение поля профиля (например, для поля Фамилия значение — Соколов)

Внимание: для поля Страна нужно использовать ID страны, а не название. ID страны можно получить при помощи метода Получение списка полей профиля пользователя.

Возвращаемые значения

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

Параметр

Тип

Описание

groupId

string

ID добавленной группы.

Возможные ошибки

ТипОписание
Permission deniedУ пользователя недостаточно прав для добавления смарт-групп.
Wrong parametersНе удалось обработать запрос, т.к. он не включает все нужные параметры или они заданы неверно.

 Пример запроса

Блок кода
languagexml
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="http://ispringlearn.com/go/services/api/soap">
  <SOAP-ENV:Body>
      <AddSmartGroupRequest>
       <credentials>
          <accountUrl>http://myaccount.ispringlearn.ru</accountUrl>
          <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>

Пример ответа

Блок кода
languagexml
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="http://ispringlearn.com/go/services/api/soap">
  <SOAP-ENV:Body>
    <AddSmartGroupResult>
      <groupId>string</groupId>
    </AddSmartGroupResult>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>