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

Материал из WiKi - UserSide
Строка 97: Строка 97:
   object_id - id объекта
   object_id - id объекта
   value - значение
   value - значение
  cat_id - категория (только для абонентов. См.выше справочник)
  Дополнительно возвращаемые данные:
  Дополнительно возвращаемые данные:
   id - id записи в таблице доп.данных ''(в случае успеха)''
   id - id записи в таблице доп.данных ''(в случае успеха)''

Версия от 12:06, 5 марта 2018

Раздел 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]
Дополнительно возвращаемые данные:
 array(
   [data] = array(
     [id] => id поля
     [name] => наименование поля
     [type] => тип поля
     [available_value] => перечень возможных значений для поля со списком
   )
 )

add_field

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

edit_field

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

delete_field

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

change_value

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