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

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

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

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

changes.mady.by.user Irina Chumanova

Сохранено

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

Новая версия Текущий

changes.mady.by.user elena.antipova

Сохранено

Ключ

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

Включить страницу
Лэйблы с указанием тарифа
Лэйблы с указанием тарифа

...

Запрос: POST 

/group/smart/{group_id}

...

Оглавление
minLevel2

Права для выполнения запроса 

Владелец

...

аккаунта, Администратор аккаунта, Администратор

...

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

...

группы.

...

Заголовки и параметры запроса

Заголовок

Описание

X-Auth-Account-Url 
Authorization (обязательный)Токен доступа. Вы можете получить токен с помощью запроса
group_id (обязательный)
Базовый URL аккаунта, например, http://my.ispringlearn.ruX-Auth-Email (обязательный)Логин Владельца аккаунта, Администратора или Администратора подразделения.X-Auth-Password (обязательный)

Пароль Владельца аккаунта, Администратора или Администратора подразделения.

ПараметрОписаниеgroup_id (обязательный)ID смарт-группы, которую вы хотите отредактировать.name (обязательный)Название смарт
ID смарт-группы, которую вы хотите отредактировать
ПараметрОписание
name (необязательный)Название смарт-группы
attributeType (обязательный)

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

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

  • 2 - группа,

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

attributeId (необязательный)

Идентификатор поля профиля. Заполняется только для полей профиля

operator (обязательный)

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

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

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

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

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

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

Для групп:

  • ID группы.

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

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

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


Информация

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

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

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

Коды ответов

Код

Текст

Описание

200
Successful operationПараметр успешно изменен.
OKСмарт-группа успешно изменена
400Bad RequestОшибка в запросе
.
401UnauthorizedОшибка авторизации
.
403Permission deniedУ пользователя недостаточно прав для выполнения запроса
.

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

Блок кода
languagexml
POST /group/smart/b1496214-acab-11e9-8db0-120a62f268a9/ HTTPhttps/1.1
Host: api-learn.ispringlearn.ru
X-Auth-Account-Url: http://myaccount.ispringlearn.ru
X-Auth-Email: email@email.com
X-Auth-Password: passwordAuthorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
Content-Type:application/xml
  
<?xml version="1.0" encoding="UTF-8"?>
<request>
	<name>Стажеры<    <name>New Group</name>
	    <rules>
		<and>
			<or>
				<rule>
					<attributeType>1</attributeType>
					<attributeId>3fa85f64-5717-4562-b3fc-2c963f66afa6</attributeId>
					<operator>1</operator>
					<value>string</value>
				</rule>
			</or>
		</and>
	        <and>
            <or>
                <rule>
                    <attributeType>1</attributeType>
                    <attributeId></attributeId>
                    <operator>1</operator>
                    <value>6f774f46-de00-11e9-bb11-0a580af40984</value>
                </rule>
            </or>
            <or>
                 <rule>
                    <attributeType>2</attributeType>
                    <attributeId></attributeId>
                    <operator>1</operator>
                    <value>eb53de1e-dea4-11e9-8de4-0a580af40738</value>
                </rule>
            </or>
            <or>
                <rule>
                     <attributeType>3</attributeType>
                     <attributeId>JOB_TITLE</attributeId>
                     <operator>1</operator>
                     <value>Sales Manager</value>
                </rule>
            </or>
        </and>
    </rules>
</request>

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

Блок кода
languagexml
HTTPhttps/1.1 200 Successful operation
Connection: closeOK


Информация
С помощью данного запроса задаются новые правила для уже существующей группы. Cтарые правила команды полностью перезапишутся.