API additional data: различия между версиями

Материал из WiKi - UserSide
Строка 66: Строка 66:


==== edit_field ====
==== edit_field ====
''Доработано в: 3.13.14 (добавлен параметры possible_value)''
''Доработано в: 3.13.14 (добавлен параметр possible_value)''
  Описание: Редактирование доп.поля  
  Описание: Редактирование доп.поля  
  Обязательные параметры:
  Обязательные параметры:

Версия от 15:07, 8 июня 2019

Раздел API ERP "UserSide"

Назначение: Действие с дополнительными полями/данными

Дополнительные параметры:
action - подкатегория запроса (возможное значение: см.ниже)

Дополнительные поля имеют категории (cat_id)

1 - Сотрудники
2 - ВОЛС
4 - Абоненты (все)
5 - Абоненты (юр.лица)
6 - Радиооборудование
7 - Дома
8 - Коммутаторы
9 - Медиаконвертеры
10 - Системные устройства
11 - Операторы
12 - Тарифы (только для ручных биллингов)
13 - Дополнительные услуги (только для ручных биллингов)
14 - Объекты размещения
15 - Кроссы/ODF
16 - VLAN
17 - Задания
18 - Автотранспорт
19 - Рекламные кампании
20 - Произвольные устройства
21 - Поставщики
22 - Потенциальные абоненты
23 - Делители/Уплотнители
24 - Собственники
25 - ТМЦ
26 - Кабельные каналы

Дополнительные поля имеют тип поля (type)

1 - Текст
2 - Число
3 - Флаг
4 - Выбор из списка
5 - Текстовое поле
6 - Выбор из списка (в т.ч. свой вариант)
7 - Дата
8 - Выбор из списка (несколько значений)

Подкатегории

get_list

Описание: Получение списка полей
Обязательные параметры:
 section - Категория дополнительных полей [house|node|task|switch|inventory]

add_field

Описание: Добавление доп.поля 
Обязательные параметры:
 cat_id - категория (см.выше справочник)
 name - наименование
Необязательные параметры
 type - тип поля (см.выше справочник)
 size - размер поля
 max_size - максимальный размер поля
 is_active - флаг - поле включено
 position - позиция поля среди остальных
 is_require - флаг - обязательное к заполнению

edit_field

Доработано в: 3.13.14 (добавлен параметр possible_value)

Описание: Редактирование доп.поля 
Обязательные параметры:
 cat_id - категория (см.выше справочник)
 id - id поля
Необязательные параметры
 См. из метода add_field
 possible_value - возможные значения для типа поля "Выбор из списка" (разделитель - вертикальная черта "|")

delete_field

Описание: Удаление доп.поля (удаляется только если нет записей с этим доп.полем)
Обязательные параметры:
 cat_id - категория (см.выше справочник)
 id - id поля

get_value

Добавлено с: 3.12.80

Описание: Получение значений полей
Обязательные параметры:
 field_id - id поля
Необязательные параметры:
 object_id - id объекта (по которому значение поля)
 value - значение поля

change_value

Описание: Изменение значения доп.поля 
В случае отсутствия такого доп.поля у объекта - оно будет создано.
Обязательные параметры:
 field_id - id дополнительного поля
 object_id - id объекта
 value - значение
 cat_id - категория (только для абонентов. См.выше справочник)