Характеристики

Функция

http://localhost:2001/apix1/ParamItems

{
    "value": [
        {
            "$id": 1,
            "@xdata.type": "XData.Default.ParamItems",
            "id": 134,
            "title_v1": "Бренд",
            "title_v2": null,
            "title_v3": null,
            "title_v4": null,
            "title_v5": null,
            "remote_id1": null,
            "remote_id2": null,
            "remote_id3": null,
            "remote_id4": null,
            "remote_id5": null,
            "order_idx": 2,
            "is_active": 1,
            "item_type": 7,
            "param_id": 1,
            "create_date": null,
            "last_update": null,
            "unit_title": null,
            "item_connect": null,
            "in_filter": 1,
            "field_name": null,
            "use_level": 1,
            "short_desc_order": null,
            "syn_dict": null,
            "item_formula": null,
            "is_keyfeature": 0,
            "is_expanded": 0,
            "from_formula": null,
            "string_desc": null,
            "replace_str": null,
            "multi_item": null,
            "fix_type": 0,
            "group_id": {
                "$id": 2,
                "@xdata.type": "XData.Default.ParamGroups",
                "id": 40,
                "param_id": 1,
                "title_v1": "Основные",
                "title_v2": null,
                "title_v3": null,
                "title_v4": null,
                "title_v5": null,
                "quad_cat_id": 60,
                "order_idx": 1,
                "is_active": 1,
                "create_date": null,
                "last_update": null,
                "user_str": null,
                "group_code": null
            },
            "pi_product_type": {
                "$id": 3,
                "@xdata.type": "XData.Default.ProductType",
                "pt_id": 32,
                "pt_title": "Свет",
                "pt_parent_id": 1
            },
            "pi_unit_id": null
        },
        {
            "$id": 8,
            "@xdata.type": "XData.Default.ParamItems",
            "id": 137,
            "title_v1": "Мощность",
            "title_v2": null,
            "title_v3": null,
            "title_v4": null,
            "title_v5": null,
            "remote_id1": null,
            "remote_id2": null,
            "remote_id3": null,
            "remote_id4": null,
            "remote_id5": null,
            "order_idx": 5,
            "is_active": 1,
            "item_type": 4,
            "param_id": 1,
            "create_date": null,
            "last_update": null,
            "unit_title": null,
            "item_connect": null,
            "in_filter": 1,
            "field_name": null,
            "use_level": 1,
            "short_desc_order": null,
            "syn_dict": null,
            "item_formula": null,
            "is_keyfeature": 0,
            "is_expanded": 0,
            "from_formula": null,
            "string_desc": null,
            "replace_str": null,
            "multi_item": null,
            "fix_type": 0,
            "group_id": {
                "$ref": 2
            },
            "pi_product_type": {
                "$ref": 3
            },
            "pi_unit_id": {
                "$id": 9,
                "@xdata.type": "XData.Default.ProductUnit",
                "pu_id": 3,
                "pu_title": "Мощность",
                "pu_short_code": "Вт",
                "pu_external_code": "power_vt"
            }
        }
    ]
}

id - ид характеристики

title_v1 - название характеристики

title_v5 - альтернативное (пользовательское) название характеристики

remote_id1 - внешний код характеристики

order_idx - сортировка

is_active - характеристика активна (если = 1)

item_type - тип характеристики

1 - Текст

2 - Бит (0/1)

3 - Целое число

4 - Дробное число

7 - Список с выбором одного значения

8 - Список с выбором нескольких значений

10 - Да/Нет

param_id - ид набора параметров

create_date - дата создания характеристики

last_update - дата последнего изменения

unit_title - название единицы измерения

in_filter - признак, что характеристика должна быть в фильтре (1 или 0)

field_name - код характеристики

use_level - если 1, то характеристика считается основной

is_expanded - признак, что характеристику в фильтре нужно показывать развернутой (1 или 0)

group_id - объект-ссылка на группу характеристик.

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

Второй и следующие вхождения - только ссылка на объект, который встречался в первый раз.

$ref = 2 - это $id от группы, которая встречалась раньше (не путать с id группы, именно id с $ впереди)

Т.е. при первой встрече группы нужно сохранить соответствие $id объекта = id группы, в примере выше $id = 2, а id группы = 40.

Можно не использовать такие ссылки, тогда получить полный объект группы можно так

http://localhost:2001/apix1/ParamItems(137)/group_id , где 137 - id характеристики

pi_product_type - объект или ссылка на объект Типа товара

pi_unit_id - объект или ссылка на объект Единицы измерения

Пример 1. Получить все характеристики группы товаров

В программе характеристики не привязываются к группе товаров, характеристики привязываются к Типу товара. Один и тот же Тип товара может быть выбран у разных групп, при этом у группы может быть только один Тип товара.

Если нужно получить характеристики группы, то для этого сначала нужно узнать Тип товара в этой группе, его ИД. Получить его можно функцией получения информации для группы Группы товаров

Получить по коду группы:

http://localhost:2001/apix1/ProductCategory/?$filter=(GroupCode eq '0123406785')

где 0123406785 - код группы

Получить по ИД группы:

http://localhost:2001/apix1/ProductCategory/?$filter=(Id eq 6785)

где 6785 - ид группы

Ид типа находится в поле ProductType

Далее список характеристик по Типу товара такой функцией:

где 8 - ИД типа товара

Пример 2. Получить все характеристики одного товара

Как получить характеристики одного товара описано здесь Характеристики товара (пример 1)