Метакод (JV3_ORG_MetaCode) - объект для метакодакод, который привязывается к словарю, содержит справочнику. Содержит кастомные пользовательские данные, характеризуется следующими полями:
id_MetaCode (пример: "123") - первичный ключ метакода (обязательное поле, число).
Если мы создаем новый метакод, то значение не передаем, если редактируем существующий - передаем идентификатор;Name (пример: "Тестовый код") - название кода, понятное пользователю (обязательное поле, строка);
NameLatin (пример: "Test Code") - название кода на английском, понятное пользователю (обязательное поле, строка);
Tag (пример: "my-tag") - служебный тэг, описывает поведение кода (необязательное поле, строка);
CodeValue (пример: "value") - служебное значение кода, может быть подвергнуто валидации с помощью поля ValidationRegex в справочнике кодов (обязательное поле, строка);
id_MetaDictionary (пример: "123") - ссылка на справочник кодов (обязательное поле, число).
Под агентом: в интерфейсе редактирование контактов В интерфейсе редактирование кодов доступно в разделе "Справочники кодов", куда можно попасть в который агент попадает через раздел "Travel management" в редакторе договоров.
Под клиентом: следует зайти в меню "Настройки > Справочники кодов".
...
, а клиент - из меню настроек при условии, что настройка его роли предоставляет ему доступ к редактированию Справочников кодов.
...
Переходим к любому типу справочника:
...
Открываем справочник из списка:
...
По По умолчанию попадаем на вкладку "Детали", потом выбираем вкладку "Коды справочника"
...
Соответствие полей интерфейса полям модели:
...
Для проведения любой операции необходимо пройти авторизациюСоответственно, действие, аналогичное редактированию кодов справочника из API, можно произвести на интерфейсе в разделе “Справочники кодов”.
Перед использованием метода необходимо пройти аутентификацию и получить валидный токен. Подробнее об этом: Авторизация (получение токена)
Info |
---|
Для получения контекста |
...
метакода используется |
...
сервис MetaCodeManagement.asmx WSDL можно скачать с демо-сайта: https:// |
...
stage1.corteos.ru/XmlGate/V3/StaticData/MetaCode/MetaCodeManagement.asmx?wsdl Для работы в продуктовой среде необходимо |
...
заменить “stage1.corteos.ru” на свой домен (на котором работают пользователи вашей компании). |
В API реализованы следующие методы для работы с
...
метакодами:
GetV2 -
...
получение кода по первичному ключу (JV3_ORG_MetaCode.id_MetaCode);
SaveV2 -
...
создание нового кода или редактирование существующего;
ListV2 -
...
получение списка кодов для словаря (справочника);
DeleteV2 -
...
удаление кода по первичному ключу.
Разберем эти методы более подробно.
Примеры запросов и ответов:
редактирование существующего кода - запрос / ответ совпадает с ответом "создание нового кода"
получить код по первичному ключу(id_MetaCode) - запрос / ответ
удалить метакод с переданным первичным ключом - запрос / ответ
...
Подробное описание методов с примерами:
Получение кода по первичному ключу (GetV2)
Для проведения выгрузки данных, необходимо передать первичный ключ кода (id_MetaCode).
Создание нового кода или редактирование существующего (SaveV2)
Для сохранения изменений в уже созданном коде необходимо передать первичный ключ кода.
В том случае, если мы создаем новый код, первичный ключ не передаем.
Если нам надо удалить код, то в атрибуте deleted передаем значение true.
Запрос на создание / Запрос на обновление / Ответ
Получение списка кодов для словаря (справочника) (ListV2)
Получить список кодов можно по идентификатору справочника (id_MetaDictionary), которому эти коды принадлежат. Данный параметр является обязательным.
Удаление кода по первичному ключу (DeleteV2)
Для удаления кода по первичному ключу используется метод DeleteV2.