Эта функция прикрепляет файл к пространственному объекту векторного веб-слоя, который поддерживает вложения и где роль пользователя поддерживает как минимум редактирование. Новые объекты должны быть синхронизированы перед добавлением вложений.
Синтаксис
(esri_webfeaturelayer_addAttachment flname ename filepath)
Аргументы
- flname | string | обязательный | Имя существующего векторного веб-слоя на чертеже.
- ename | имя элемента | обязательный | Имя элемента AutoCAD объекта для добавления вложения.
- filepath | string | обязательный | Путь к файлу назначения для прикрепляемого файла
Пример использования 1
Предлагает пользователю выбрать элемент из векторного веб-слоя "Damage_to_Residential_Buildings" и пытается добавить вложенный файл с именем "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml" (progn
(setq ename (car (entsel)))
(esri_webfeaturelayer_addAttachment
"Damage_to_Residential_Buildings"
ename
"C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml"
))
Результат из примера использования 1
Файл "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml" добавляется к выбранному объекту на сервере, и функция возвращает значение:
(T)
Пример использования 2
Предлагает пользователю выбрать элемент из векторного веб-слоя "Shelters" и пытается добавить вложенный файл с именем "C:\\CADwork\\Attachments\\LandSurface.xml". Однако векторный веб-слой не поддерживает вложения.(progn
(setq ename (car (entsel)))
(esri_webfeaturelayer_addAttachment
"shelters"
ename
"C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml"
))
Результат из примера использования 2
Файл LandSurface.xml не добавлен, и функция возвращает:
(nil ("Error" . "Layer does not support attachments"))
Возвращаемые значения
Эта функция возвращает значение.
- Если успешно – возвращает список, содержащий значение true: (T).
- В случае неудачи она возвращает список с первым значением nil, а затем связанный список, содержащий значение ключа "Error" и соответствующее сообщение об ошибке в виде строки: (nil ( "Error" . "<message>")).
Не удалось вернуть значения
Неудачное возвращение значения может произойти по любой из следующих причин:
- (nil ("Error" . "Missing required argument."))
Не указан один из трех обязательных аргументов.
- (nil ("Error" . "Web feature layer not found."))
Заданный векторный слой не является допустимым слоем чертежа.
- (nil ("Error" . "No connected web feature layers found."))
Сетевое подключение к веб-слою объектов было потеряно.
- (nil ("Error" . "Layer does not support attachments"))
Указанный векторный веб-слой не поддерживает вложения.
- (nil ("Error" . "File not found."))
Указанный файл не существует
- (nil ("Error" . "No feature found."))
Указанный элемент не является допустимым объектом указанного векторного веб-слоя.