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

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

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

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

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

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

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

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

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

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

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

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>);
		-	указать параметры взаимосвязи объектов карты и записей набора данных, получаемого в результате запроса, связь осуществляется по совпадению значений:
			-	семантической характеристики объекта карты;
			-	указанного ключевого поля набора данных.