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

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

Ключ

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

...

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

ПараметрТипОписание
credentialstoken (обязательный)credentialsstringТокен доступа. Вы можете получить токен с помощью запросаСмотрите описание объекта Credentials.
groupId (обязательный)stringID смарт-группы, которое нужно отредактировать.
name (необязательный)stringНазвание смарт-группы.
rules (необязательный)arrayСписок правил смарт-группы.
attributeType (обязательный)int

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

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

  • группа

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

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

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

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

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

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

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

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

Для групп:

  • ID группы

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

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

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


Информация

Вы можете добавить несколько групп условий для добавления пользователей в смарт-группу. Они будут работать по принципу «И», то есть должны будут сработать одновременно.

Внутри этих групп создайте любое число правил. Они, напротив, работают по принципу «ИЛИ», то есть достаточно выполнения одного из правил.

Подробнее о смарт-группах и их условиях читайте в статье Смарт-группы.

...

ПараметрТипОписание
successboolTrue, если смарт-группа была успешно отредактирована.

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

ТипОписание
Unknown GroupСмарт-группа не найдена.
Permission deniedУ пользователя недостаточно прав для обновления данных смарт-группы.
Wrong ParametersОдин из указанных параметров задан неверно.

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

Блок кода
languagexml
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
                   xmlns="https://ispringlearn.com/go/services/api/soap">
  <SOAP-ENV:Body>
      <updateSmartGroupRequest>
       <credentials>
             <accountUrl>https://myaccount.ispringlearn.ru</accountUrl>
          <email>email@email.com</email>
          <password>password</password>
          <token>p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE</token>
       </credentials>
	<groupId>06a7dcfe-e05a-11e9-b1e5-0a580af40b37</groupId>
        <name>Отдел продаж</name>
        <rules>
            <and>
                <or>
                  <rule>
                    <attributeType>1<attributeType>
                    <attributeId></attributeId>
                    <operator>2</operator>
                    <value>id_department</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>JOB_TITLE</attributeId>
                    <operator>1</operator>
                    <value>Кассир</value>
                  </rule>
                </or>
              </and>
            </rules>
      </updateSmartGroupRequest>
 </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

...