Функция esri_webfeaturelayer_createBranch создает сервис-ориентированную версию векторного веб-слоя для указанного векторного веб-слоя.
Синтаксис
(esri_webfeaturelayer_createBranch flname branchName branchInfo)
Аргументы
- flname | строка | обязательно | имя существующего векторного веб-слоя на чертеже.
- branchName | строка | обязательный | Имя, которое будет использоваться для новой сервис-ориентированной версии.
- branchInfo | связанный список | обязательный | Информация о сервис-ориентированной версии, которая будет применена к векторному веб-слою flname в виде связанного списка пар разделенных точками значений, как указано ниже:
| Связанная надпись | Тип значения | Описание значения | Обязательные или дополнительные |
|---|---|---|---|
| "DESCRIPTION" | string | Текст описания, предоставленный создателем сервис-ориентированной версии, длиной не более 64 символов. | Дополнительный |
| "ACCESS" | string | Уровень доступа сервис-ориентированной версии Опциями являются "Public", "Private" и "Protected". | Обязательный |
Пример использования
Попытка создать новую сервис-ориентированную версию с именем SouthwestProposal для векторного веб-слоя Damage_to_Commercial_Buildings.(esri_webfeaturelayer_createBranch "Damage_to_Commercial_Buildings" "SouthwestProposal"
(list
(cons "DESCRIPTION" "proposed changes")
(cons "ACCESS" "Public")
)
)
Результат из примера использования
Создает новую сервис-ориентированную версию с именем SouthwestProposal для векторного веб-слоя Damage_to_Commercial_Buildings и возвращает имя версии:
("SouthwestProposal")Возвращаемые значения
Ниже перечислены возможные возвращаемые значения:
- В случае успешного выполнения функция возвращает список, содержащий название сервис-ориентированной версии в виде строки.
- В случае ошибки возвращается список с первым значением nil, а затем возвращается связанный список, содержащий значение ключа "Error" и соответствующее сообщение об ошибке в виде строки: (nil ( "Error" . "<message>")).
Не удалось возвратить значения
Неудачное возвращение значения может произойти по любой из следующих причин:
- (nil ("Error" . "Missing required argument."))
Не указан обязательный аргумент.
- (nil ("Error" . "Service error encountered."))
Возникла ошибка при подключении к веб‑сервису.
- (nil ("Error" . "Layer does not support branch versions.")
Указанный слой не поддерживает сервис‑ориентированные версии.
- (nil ("Error" . "Unable to retrieve properties from the branch version.")
Использованы некорректные значения или произошла иная ошибка подключения.
- (nil ("Error" . "No connected web feature layers found.")
Сетевое подключение к веб-слою объектов было потеряно.
- (nil ("Error" . " Failed.")
Указанное имя версии может уже существовать.