La función adjuntará un archivo a una entidad de una capa de entidades web que admite adjuntos y donde el rol de usuario admite la edición o más. Las nuevas entidades se deben sincronizar antes de agregar adjuntos.
Sintaxis
(esri_webfeaturelayer_addAttachment flname ename filepath)
Argumentos
- flname | cadena de caracteres | obligatorio | El nombre de un capa de entidades web existente en el dibujo
- ename | nombre de la entidad | obligatorio | El nombre de la entidad de AutoCAD de una entidad para agregar un adjunto
- filepath | cadena de caracteres | obligatorio | Ruta de archivo de destino para el archivo a adjuntar
Ejemplo de uso 1
Pide al usuario que seleccione una entidad de una capa de entidades web llamada "Damage_to_Residential_Buildings" e intenta agregar el archivo adjunto llamado "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"
))
Ejemplo de resultado de uso 1
El archivo "C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml" se agrega a la entidad seleccionada en el servidor y la función devuelve:
(T)
Ejemplo de uso 2
Pide al usuario que seleccione una entidad de una capa de entidades web llamada "Shelters" e intenta agregar el archivo adjunto llamado "C:\\CADwork\\Attachments\\LandSurface.xml". Sin embargo, la capa de entidades web no admite adjuntos.(progn
(setq ename (car (entsel)))
(esri_webfeaturelayer_addAttachment
"shelters"
ename
"C:\\CADwork\\Attachments\\Olympus_Subdivision-2.0.xml"
))
Ejemplo de resultado de uso 2
El archivo LandSurface.xml no se ha agregado y la función devuelve:
(nil ("Error" . "Layer does not support attachments"))
Valores de retorno
Esta función devolverá un valor.
- Si todo va bien, devuelve una lista que contiene el valor true: (T).
- Si se produce un error, devuelve una lista con el primer valor de nil y, a continuación, una lista asociada que contiene el valor clave "Error" y un mensaje de error asociado como cadena de caracteres: (nil ( "Error" . "<message>")).
Valores de retorno fallido
Se puede producir un valor de retorno fallido por cualquiera de los siguientes motivos:
- (nil ("Error" . "Missing required argument."))
No se ha suministrado uno de los tres argumentos requeridos.
- (nil ("Error" . "Web feature layer not found."))
El valor de la capa de entidades web especificada no es una capa de entidades web válida en el dibujo.
- (nil ("Error" . "No connected web feature layers found."))
Se perdió la conexión de red a la capa de entidades web.
- (nil ("Error" . "Layer does not support attachments"))
La capa de entidades web especificada no admite adjuntos.
- (nil ("Error" . "File not found."))
El archivo especificado no existe
- (nil ("Error" . "No feature found."))
La entidad especificada no es una entidad válida de la capa de entidades web especificada.