Проект

Общее

Профиль

ApiMainDataDescriptionIfForm » История » Версия 5

Артем, 08.12.2017 17:26

1 1 Артем
h1. Формат данных ifForm
2
3
ifTable содержит в себе элементы для создания формы выбора или ввода каких-данных посетителем сайта
4
5
---
6
7
h2. Пример вывода
8
9
---
10
11 2 Артем
!https://static.ilcats.ru/images/helpsystem/catalogsApi/apiHelpExampleIfFormFieldsHtml.png!
12 1 Артем
13
---
14
15
h2. Описание возвращаемых данных
16
17
---
18
19 3 Артем
Массив *ifForm* состоит из четырех элементов: 
20 1 Артем
21 4 Артем
p(. 1) *format = ifForm*
22
23
p(. 2) Массив значений *fields*, который содержит элементы формы. Каждый элемент, в свою очередь, массив из 4 элементов:
24
 
25
p((. 2.1) *id* - ID поля формы
26
27
p((. 2.2) *name* - заголовок поля формы
28
29
p((. 2.3) *type* - тип поля формы. На данный момент поддерживается два типа: *selectable* - выборка из нескольких значений и *inputable* - вводимое значение.
30
31
p((. 2.4) *values* - массив возможных значений. Каждый элемент массива - массив из двух или трех элементов: обязательных *value* - значение, *name* - название в локали каталога, и необязательного *isSelected* - маркера выбранного в текущий момент элемента (*true* или *1* - элемент выбран). Если поле типа *inputable*, то массив *values* содержит единственный элемент. 
32 1 Артем
  
33 4 Артем
p(. 3) Массив *parameters* - одномерный массив, содержащий описание правил передачи в API данных из формы. Линейный массив, описывающий параметры формы. Состоит из элементов:
34
35
p((. *fpMethod* - метод передачи параметров формы. На данный момент поддерживается только метод *get*
36
37
p((. *fpFormFieldsDelimeter* - разделитель полей формы[1]
38
39
p((. *fpFormValuesDelimeter* - разделитель названия параметра и его значения[1]
40
41
p((. *fpEncodeMethod* - метод кодирования параметров формы при передаче[2]
42
43
p((. *formDataUrlParamName* - имя параметра, через который передаются данные формы
44
45 5 Артем
fn1. Данные формы при методе GET должны передаваться в одном $_GET параметре. Для примера на изображении ниже значение передаваемого формой параметра (без кодирования из *fpEncodeMethod*), например, будет выглядеть следующим образом:
46 1 Артем
47 5 Артем
bq. &modification=...|...|...|...|...|DT=L
48 1 Артем
49 5 Артем
, где "..." это скрытые на скриншоте значения.
50 1 Артем
51 5 Артем
fn2. После конкатенации (по правилу из предыдущего абзаца) параметров формы в строку вида param1=value1|param2=value2|....|paramN=valueN полученная строка кодируется указанным в *fpEncodeMethod* 
52 1 Артем
53
54 5 Артем
p(. 4) Массив *urlParams*, содержащий список GET параметров вызова следующего метода. При этом значение параметра с индексом из *formDataUrlParamName* заменяется результат из п.3
55
56 1 Артем
57
---
58
59
h2. Пример возвращаемых данных
60
61
---
62
63
64 2 Артем
!https://static.ilcats.ru/images/helpsystem/catalogsApi/apiHelpExampleIfFormFields.png!