Функция esri_webfeaturelayer_add добавляет новый векторный веб-слой с дополнительным запросом фильтра. В результате будут нарисованы объекты в области проекта. Если добавляемый веб-слой является безопасным, пользователю будет предложено ввести учетные данные в соответствии с требованиями портала.
Синтаксис
(esri_webfeaturelayer_add url [service_properties])
Аргументы
Следующие аргументы включены:
- url | строка | обязательный | URL допустимого векторного веб-слоя, добавляемого к чертежу.
- service_properties | связанный список | дополнительный | Связанный список свойств векторного веб-слоя в виде пар значений, разделенных точками, как показано в следующей таблице:
| Связанная надпись | Тип значения | Описание значения | Обязательные или дополнительные |
|---|---|---|---|
| "DEFINITIONEXPRESSION" | Строка | Выражение условия WHERE, которое ограничивает объекты слоя по значениям атрибутов. Синтаксис условия WHERE определяется данными источника. | Дополнительный |
| "BRANCH" | Строка | Имя сервис-ориентированной версии, доступной на векторном веб-слое. | Дополнительный |
Пример использования 1
Добавить векторный веб-слой "Основные города США", где значение поля FID больше 3800:(esri_webfeaturelayer_add "https://www.arcgis.com/home/item.html?id=85d0ca4ea1ca4b9abf0c51b9bd34de2e"
(list (cons "DEFINITIONEXPRESSION" "FID > 3800")))
Пример использования результата 1
Добавляет векторный веб-слой "Основные города США" и рисует объекты внутри текущей области проекта, когда значение поля FID больше 3800, а функция возвращает список true:
(T)Пример использования 2
Добавьте векторный веб-слой "Генерализованные границы штатов США" и объекты, если значение поля STATE_NAME начинается с буквы N:(esri_webfeaturelayer_add "https://esri.maps.arcgis.com/home/item.html?id=8c2d6d7df8fa4142b0a1211c8dd66903"
(list (cons "DEFINITIONEXPRESSION" "STATE_NAME LIKE \'N%\'")))
Пример использования результата 2
Добавляет векторный веб-слой "Генерализованные границы штатов США", рисует объекты внутри области проекта, когда значение поля STATE_NAME начинается с буквы N, и возвращает список true:
(T)Пример использования 3
Добавьте все векторные веб-слои PoolPermits без какой-либо фильтрации запросов:(esri_webfeaturelayer_add "http://sampleserver6.arcgisonline.com/arcgis/rest/services/PoolPermits/FeatureServer")
Результат из примера использования 3
Добавляет векторный веб-слой PoolPermits, рисует все объекты внутри области проекта, а функция возвращает список true:
(T)Пример использования 4
Добавьте версию editor01.triangle векторного веб-слоя DamageAssessment, если значение поля FID больше 3800:(esri_webfeaturelayer_add "https://sampleserver7.arcgisonline.com/server/rest/services/DamageAssessment/FeatureServer"
(list
(cons "DEFINITIONEXPRESSION" "FID > 3800")
(cons "BRANCH" "editor01.triangle")
)
)
Пример использования результата 4
Добавляет версию editor01.triangle слоя веб-объектов DamageAssessment, когда значение поля FID больше 3800, и возвращает список значений true:
(T)Возвращаемые значения
Ниже перечислены возможные возвращаемые значения:
- В случае успеха функция возвращает список значений true: (T).
Примечание:
Асинхронное поведение ПО:Если предоставленный URL можно интерпретировать, он будет возвращать (T), даже если сервис не полностью добавлен. Он вернет (T) до того, как объекты завершат рисование. Возвращаемое значение (nil) обычно означает, что сервис не подключился.
- В случае неудачи возвращает список с первым значением nil, а затем связанный список, содержащий значение ключа "Error" и соответствующее сообщение об ошибке в виде строки: (nil ("Error" . "<message>")), или только (nil).
Не удалось возвратить значения
Неудачное возвращение значения может произойти по любой из следующих причин:
- (nil ("Error" . "Invalid URL"))
Указанный URL не корректен.
- (nil ("Error" . "Error"))
Указанный URL не корректен.
- (nil ("Error" . "Missing required argument."))
Не указан один или несколько обязательных аргументов.
См. также
(esri_docfeaturelayer_add) — функция An AutoLISP добавляет новый векторный слой документа.
(esri_weblayer_add) — функция An AutoLISP добавляет новый веб-слой, слой изображений, слой изображений карты или векторный веб-слой.