Skip To Content

esri_webfeaturelayer _downloadAttachment (AutoLISP)

La función descarga el archivo adjunto especificado de una entidad especificada de una capa de entidades web compatible.

Sintaxis

(esri_webfeaturelayer_downloadAttachment flname ename attachmentName filepath [overwrite])

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 la entidad para descargar el adjunto.
  • attachmentName | cadena de caracteres | obligatorio | Nombre de archivo del adjunto que se va a descargar.
  • filepath | cadena de caracteres | obligatorio | Ruta de archivo de destino para el archivo descargado.
  • overwrite | true / false | opcional | Especifica si un archivo existente se sobrescribirá en la ruta de archivo especificada. True T sobrescribirá el archivo. False nil no sobrescribirá ningún archivo existente con el mismo nombre.

Ejemplo de uso 1

Pide al usuario que seleccione una entidad de una capa de entidades web llamada "Damage_to_Residential_Buildings" e intenta descargar el archivo adjunto llamado "AutoCAD_drawingFiles.zip" en un archivo llamado "C:\\CADWork\\Attachments\\Updated_Drawings.zip".

(setq ename (car (entsel)))
(esri_webfeaturelayer_downloadAttachment 
  "Damage_to_Residential_Buildings" 
  ename 
  "AutoCAD_drawingFiles.zip" 
  "C:\\CADwork\\Attachments\\Updated_Drawings.zip"
)

Ejemplo de resultado de uso 1

El archivo AutoCAD_drawings.zip se descarga en la ruta especificada. C:\\CADWork\\Attachments\\Updated_Drawings.zip y la función devuelven:

(T)

Ejemplo de uso 2

Pide al usuario que seleccione una entidad de una capa de entidades web llamada "shelters" e intenta descargar el archivo adjunto llamado "LandSurface.xml" en un archivo llamado "C:\\CADWork\\Attachments\\LandSurface.xml" (donde la capa no admite adjuntos).

(setq ename (car (entsel)))
(esri_webfeaturelayer_downloadAttachment 
  "shelters" 
  ename
  "LandSurface.xml" 
  "C:\\CADwork\\Attachments\\LandSurface.xml"
)

Ejemplo de resultado de uso 2

El archivo LandSurface.xml no se descarga y la función devuelve:

(nil ("Error" . "Layer does not support attachments"))

Valores de retorno

  • Si todo va bien, devuelve una lista con 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 de clave "Error" y un mensaje de error asociado como cadena de caracteres: (nil ( "Error" . "<message>"))

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 cuatro argumentos requeridos.

  • (nil ("Error" . "No features found."))

    La entidad especificada no era una entidad en la capa de entidades web especificada.

  • (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 attachments found on the selected feature."))

    La entidad seleccionada no tiene adjuntos.

  • (nil ("Error" . "No connected web feature layers found."))

    Se perdió la conexión de red a la capa de entidades web.

  • (nil ("Error" . "'TargetAttachmentName' does not exist on the selected feature."))

    El attachmentName especificado no existe como adjunto en la entidad especificada.

  • (nil ("Error" . "Layer does not support attachments"))

    La capa de entidades web especificada no admite adjuntos.

  • (nil ("Error" . "Enable overwrite to remove existing file"))

    El nombre del archivo ya existe en el directorio especificado. Utilice la opción sobrescribir para permitir que se sobrescriba el archivo existente.

  • (nil ("Error" . "Could not find a part of the path 'C:\\CADwork\\AttachmentsFiles'."))

    Compruebe el argumento dado para el downloadPath especificado.

  • (nil ("Error" . "Access to the path <downloadPath> is denied."))

    Si especifica una ruta como la raíz de C:\,..\\AutoCAD\\.. o el usuario CAD puede no tener permisos de acceso a carpetas.