Добавляет новый векторный веб-слой с дополнительным запросом фильтра. В результате будут нарисованы объекты в области проекта. Если добавляемый веб-слой является безопасным, пользователю будет предложено ввести учетные данные в соответствии с требованиями портала.
Синтаксис
(esri_webfeaturelayer_add url [service_properties])
Аргументы
- url | строка | обязательный | URL допустимого векторного веб-слоя, добавляемого к чертежу.
- service_properties | связанный список | дополнительный | Связанный список свойств векторного веб-слоя в виде пар значений, разделенных точками, как показано в следующей таблице:
| Связанная надпись | Тип значения | Описание значения | Обязательные или дополнительные |
|---|---|---|---|
| "DEFINITIONEXPRESSION" | Строка | Выражение where-clause, использующееся для ограничения объектов слоя по значениям атрибутов. Синтаксис where-clause определяется данными источника. | Дополнительный |
| "BRANCHNAME" | Строка | Имя сервис-ориентированной версии, доступной на векторном веб-слое. | Дополнительный |
Пример использования 1
Попытайтесь добавить векторный веб-слой "Выборка крупных городов США", где значение FIDполя больше, чем 3800:(esri_webfeaturelayer_add "https://www.arcgis.com/home/item.html?id=85d0ca4ea1ca4b9abf0c51b9bd34de2e"
(list (cons "DEFINITIONEXPRESSION" "FID > 3800")))
Пример использования результата 1
Добавляет векторный веб-слой USA Major Cities и рисует объекты внутри текущей области проекта, когда значение поля FID больше, чем 3800, а функция возвращает список true:
(T)Пример использования 2
Попытайтесь добавить векторный веб-слой USA States Generalized Boundaries и объекты, когда значение поля STATE_NAME начинается с буквы N:(esri_webfeaturelayer_add "https://esri.maps.arcgis.com/home/item.html?id=8c2d6d7df8fa4142b0a1211c8dd66903"
(list (cons "DEFINITIONEXPRESSION" "STATE_NAME LIKE \'N%\'")))
Пример использования результата 2
Добавляет векторный веб-слой USA States Generalized Boundaries, рисует объекты внутри области проекта, когда значение поля 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 "BRANCHNAME" "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) | Добавляет новый векторный слой документа.
(esri_weblayer_add) | Добавляет новый веб-слой: слой изображений, слой изображений карты или векторный веб-слой.