Просмотр данных «1С: Предприятие» и других НТТР-сервисов

Печать Предыдущая страница Стартовая страница Следующая страница

Для пользовательской карты могут быть настроены внешние источники атрибутивных данных. Обращение к этим источникам осуществляется по протоколу НТТР. Возвращаемый набор данных в формате ХМL представляет собой таблицу, где узлы внутри главного узла документа являются записями этой таблицы , а дочерние узлы первого уровня внутри них- полями таблицы.

В качестве источников атрибутивных данных могут быть:

­-  любые НТТР-сервисы, возвращающие в ответ на GЕТ-запрос набор данных формате ХМL (как выше указано);

­-  веб-сервис «1С: Предприятие», возвращающий в ответ на GЕТ-запрос набор данных в формате ХМL, в том числе в соответствии с протоколом ОData.

Связь записей набора данных от внешнего источника с объектами карты осуществляется по соответствию значения ключевого поля и предопределенной семантики объекта, что указывается в настройках.

Для пользовательской карты могут быть настроены несколько внешних источников, для каждого из которых может быть настроен один или более запросов атрибутивных данных.

Указанные настройки сохраняются в файле с расширением *.SES, располагающемся рядом с файлом паспорта карты и имеющем такое же имя.

Вызов диалога настройки источников внешних семантик осуществляется нажатием кнопки «Настройки» в диалоге «Информация из таблицы базы данных», а также из контекстного меню, вызываемого по нажатию правой кнопки мыши на элементе дерева, соответствующего настраиваемой пользовательской карте в окне «Легенда карты» (F11).

 

mapdba_dialog

Диалог настройки источников внешних семантик

 

 

Порядок настройки запросов внешних семантик

 

1.

Вызвать диалог настройки внешних семантик.

2.

Добавить новое соединение к источнику данных (кнопка «+» левой верхней части

диалога), либо выбрать существующий источник данных для редактирования.

3.

В параметрах соединения указать:

 

-

имя соединения (источника данных);

 

-

комментарий (не обязательный параметр);

 

-

выбрать тип соединения (в настоящее время доступен только один вариант – НТТР-сервис);

 

-

для НТТР-сервиса необходимо указать:

 

 

-

строку подключения (URL) к сервису - тут указывается корневой адрес веб-приложения сервиса, отвечающего на запросы, сами запросы настраиваются далее

 

 

-

тип авторизации (в настоящее время доступны варианты: без авторизации и basic-авторизация по логину и паролю);

 

 

-

в случае basic -авторизации указать логин и пароль (пароль может быть пустым).

4.

Добавить к настроенному соединению параметры запроса данных (кнопка «+» вверху правой панели диалога) либо выбрать для редактирования существующий запрос.

5.

-

Для запроса данных от НТТР-сервиса требуется указать следующие параметры:

 

 

-

­алиас запроса уникальное имя запроса, используемое программе для идентификации;

 

 

-

­наименование запроса текст, который будет использоваться в качестве заголовка для полученных данных;

 

 

-

строку обращения к запросу (URL) - может быть указана как полная строка URL для запроса, так и часть строки, отвечающая непосредственно за конкретный запрос, дописываемая к корневому адресу веб-приложения сервиса, заданного для соединения с НТТР-сервисом;

 

 

-

в случае, если указывается URL запроса, который необходимо добавить к корневому адресу НТТР-сервиса, следует установить «галочку» в опции «Дописывать к основному URL»;

 

 

-

для НТТР-сервисов «1С: Предприятие», публикующих данные своих ресурсов по протоколу OData, запрос имеет предопределенный формат: «основной_URL/odata/standard.odata/имя_ресурса»;

 

 

-

тип НТТР-запроса в настоящее время поддерживается только один – GЕТ-запрос;

 

 

-

формат ответа следует выбирать, исходя из того, как ответ формирует сервер:

 

 

 

-

«XML - для большинства НТТР-сервисов (результат в виде xml, где в корневом узле содержаться записи набора данных, а их дочерние узлы

первого уровня – поля записей);

 

 

 

-

«XML (OData 1C)» - для НТТР-сервисов «1С: Предприятие» (результат также в виде хш1, где в корневом узле содержаться описания сущностей - в узлах <entry>, а поля их семантик находятся не в дочерних узлах первого уровня, а внутри подузла  <content><m:properties>...</m:properties></content>);

 

 

-

указать параметры взаимосвязи объектов карты и записей набора данных,

получаемого в результате запроса, связь осуществляется по совпадению значений:

 

 

 

-

семантической характеристики объекта карты;

 

 

 

-

указанного ключевого поля набора данных.