Картирование источника данных из окна администратора REST для ArcGIS Spatial Data Server for the Java Platform
После настройки источника данных и развертывания веб-приложения необходимо обеспечить возможность таких приложений, как ArcGIS for Desktop, обмениваться данными с настроенным источником данных. Для этого создайте картирование источника данных, включающее следующую информацию:
Имя сервера (Server name) | Имя сервера |
Имя базы данных (Database name) | Имя базы данных |
Имя пользователя | Имя пользователя базы данных |
Имя источника данных (Data source name) | Имя настроенного источника данных |
Вы можете создать такое картирование источника данных из окна администратора REST сервера пространственных данных до публикации сервиса объекта из ArcGIS for Desktop.
Помимо создания картирования источника данных из окна администратора REST вы можете проверять и удалять картирование источников данных, а также получать список всех картирований источников данных.
URL конечной точки администратора REST в ArcGIS Spatial Data Server используют следующий формат:
http://<сервер>:<порт>/<webapp-контекст>/admin/datasources/<функция admin>
где:
- <сервер> — компьютер, на котором установлен сервер пространственных данных.
- <порт> — номер порта, через который происходит обмен данными с сервером приложений или веб-сервером.
- <webapp-контекст> — корневой каталог контекста имени приложения.
- <функция admin> — выполняемая вами специальная команда.
Например, для создания картирования источника данных с использованием корневого каталога контекста имени приложения по умолчанию (arcgis) на сервере strata с портом 50000 URL будет иметь следующий вид:
http://strata:50000/arcgis/admin/datasources/createDatasourceMapping
Данный формат используется для картирования всех источников данных функций администратора REST, описанных в данной теме. Для откликов можно выбрать формат HTML или JSON.
Создание картирования источника данных
Используйте createDatasourceMapping для создания картирования из подключения базы данных, используемого в ArcGIS for Desktop для имени настроенного источника данных.
Перейдите по адресу http://<сервер>:<порт>/<webapp-контекст>/admin/datasources/createDatasourceMapping. Замените <сервер>, <порт> и <webapp-контекст> данными для вашего сайта.
На этом этапе необходимо ввести следующую информацию:
Параметр | Описание | Необходимо? |
---|---|---|
Имя сервера (Server name) | Строка, представляющая имя сервера, на котором установлена система управления базами данных Это должен быть тот же сервер, который вы указали для настроенного источника данных. | Да |
Имя базы данных (Database name) | Строка, представляющая базу данных Для Oracle укажите имя экземпляра Oracle. Для DB2 укажите имя или псевдоним базы данных. Для PostgreSQL укажите имя базы данных. Это должна быть та же база данных, которая указана вами для настроенного источника данных. | Да |
Имя пользователя | Строка, представляющая имя пользователя, необходимое для подключения к учетной записи базы данных, на которую ссылается данный источник Это должен быть тот же пользователь, которого вы указали для настроенного источника данных. | Да |
Имя источника данных (Datasource name) | Строка, представляющая предварительно настроенный источник данных | Да |
Для откликов можно выбрать формат HTML или JSON.
Формат отклика JSON
Success: {"success" : true} Failure: { "success": false, "error": {"description": "error description" }
Удаление картирования источника данных
Для удаления существующего картирования источника данных используйте команду deleteDatasourceMapping.
Перейдите по адресу http://<сервер>:<порт>/<webapp-контекст>/admin/datasources/deleteDatasourceMapping. Замените <сервер>, <порт> и <webapp-контекст> данными для вашего сайта.
На этом этапе необходимо ввести следующую информацию:
Параметр | Описание | Необходимо? |
---|---|---|
Имя сервера (Server name) | Строка, представляющая имя сервера, на котором установлена система управления базами данных | Да |
Имя базы данных (Database name) | Строка, представляющая базу данных Для Oracle это имя экземпляра Oracle. Для DB2 это имя или псевдоним базы данных. Для PostgreSQL это имя базы данных. | Да |
Имя пользователя | Строка, представляющая имя пользователя, необходимое для подключения к учетной записи базы данных, на которую ссылается данный источник | Да |
Для откликов можно выбрать формат HTML или JSON.
Формат отклика JSON
Success: {"success" : true} Failure: { "success": false, "error": {"description": "error description" }
Проверка картирования источника данных
Для проверки успешного создания источника данных с заданными атрибутами при помощи команды createDatasourceMapping используйте команду validateDatasourceMapping.
Перейдите по адресу http://<сервер>:<порт>/<webapp-контекст>/admin/datasources/validateDatasourceMapping. Замените <сервер>, <порт> и <webapp-контекст> данными для вашего сайта.
Параметр | Описание | Необходимо? |
---|---|---|
Имя сервера (Server name) | Строка, представляющая имя сервера, на котором установлена система управления базами данных | Да |
Имя базы данных (Database name) | Строка, представляющая базу данных Для Oracle это имя экземпляра Oracle. Для DB2 это имя или псевдоним базы данных. Для PostgreSQL это имя базы данных. | Да |
Имя пользователя | Строка, представляющая имя пользователя, необходимое для подключения к учетной записи базы данных, на которую ссылается данный источник | Да |
Для откликов можно выбрать формат HTML или JSON.
Формат отклика JSON
{"datasourceName" : "<datasourceName>"}
Список картирований источников данных
Для возврата списка всех доступных картирований источников данных на указанном сервере и порте для данного корневого каталога контекста имени приложения используйте команду listDatasourceMappings.
Перейдите по адресу http://<сервер>:<порт>/<webapp-контекст>/admin/datasources/listDatasourceMappings. Замените <сервер>, <порт> и <webapp-контекст> данными для вашего сайта.
По умолчанию для отклика используется таблица в формате HTML, содержащая список атрибутов подключения и имена источников данных. Для откликов можно выбрать формат JSON вместо используемого по умолчанию формата HTML.
Формат отклика JSON
{ "serverName1:databaseName1:userName1": "<datasourceName1>", "serverName2:databaseName2:userName2": "<datasourceName2>", . . . }