Exportar adjuntos (Administración de datos)

Resumen

Exporta adjuntos de archivos de los registros de una tabla o clase de entidad de geodatabase a una carpeta especificada. Los archivos adjuntos también pueden exportarse a subdirectorios en función de un valor de atributo de una columna de atributos especificada. Los adjuntos exportados pueden renombrarse utilizando uno o varios valores de atributo de campo.

Obtenga más información sobre cómo trabajar con las herramientas de geoprocesamiento de adjuntos

Uso

  • Esta herramienta respeta las selecciones. Si no hay registros seleccionados, se exportarán todos los adjuntos.

  • Los archivos adjuntos exportados serán del mismo tipo que cuando se agregaron a la geodatabase. Por ejemplo, si el adjunto es un archivo .pdf, el archivo exportado será un archivo .pdf.

  • Los archivos adjuntos pueden exportarse a subdirectorios para cada registro especificando un valor para el parámetro Campo subdirectorio. Los valores del campo se utilizarán para nombrar los subdirectorios. Por ejemplo, si la tabla de atributos tiene tres filas y los valores del campo seleccionado son ATL, TPA y SLC, se crearán tres subdirectorios con estos nombres. Todos los adjuntos de cada uno de estos valores se descargarán en su respectivo subdirectorio.

  • Para evitar conflictos de nombres en los archivos exportados, la herramienta agregará un número incremental a los nombres de archivo cuando sea apropiado. Si el valor de un campo es nulo, se utiliza la palabra None en el nombre del archivo.

  • Al exportar archivos adjuntos, se sustituirán los siguientes caracteres de los valores de campo en los subdirectorios de salida y en los nombres de archivo:

    Caracteres del valor de campoSustituido por

    Barra diagonal (/)

    Guion (-)

    Doble barra invertida (\\)

    Guion (-)

    Pleca o línea vertical (|)

    Guion (-)

    Asterisco (*)

    Guion bajo (_)

    Menor que (<)

    Guion bajo (_)

    Mayor que (>)

    Guion bajo (_)

    Signo de interrogación (?)

    Guion bajo (_)

    Dos puntos (:)

    Una coma seguida de un espacio (, )

Parámetros

EtiquetaExplicaciónTipo de datos
Dataset de entrada

La clase de entidad o tabla de geodatabase de la que se exportarán los adjuntos.

La entrada se debe guardar en una geodatabase versión 10.0 o más reciente, y la tabla debe tener habilitados los adjuntos.

Table View
Localización de salida

La carpeta donde se exportarán los archivos adjuntos.

Folder
Campo Subdirectorio
(Opcional)

Un campo del valor del parámetro Dataset de entrada que se utilizará para crear los nombres de los subdirectorios.

Field
Formato del nombre
(Opcional)

Especifica el formato que se utilizará para dar nombre a los adjuntos exportados.

  • Utilizar nombres de archivo originalesLos nombres de los archivos de salida utilizarán los nombres originales de los archivos almacenados en la geodatabase.
  • Utilizar solo valores de campoLos nombres de los archivos de salida utilizarán los valores de los campos de los valores de los parámetros Campos de nombre. Varios valores se concatenarán con un guion bajo.
  • Agregar valores de campo como prefijoLos nombres de los archivos de salida utilizarán los nombres de archivo originales con un prefijo de los valores de los campos de los valores de los parámetros Campos de nombre.
  • Agregar valores de campo como sufijoLos nombres de los archivos de salida utilizarán los nombres de archivo originales con un sufijo de los valores de los campos del parámetro Campos de nombre. Varios valores se concatenarán con un guion bajo.
String
Campos de nombre
(Opcional)

Los nombres de los campos del valor del parámetro Dataset de entrada que se utilizarán para renombrar los adjuntos exportados. Si se especifican varios campos, los archivos de salida utilizarán los valores de los campos concatenados con un guión bajo en el orden en que se especifiquen.

Por ejemplo, si se especifican dos nombres de campo, y el parámetro Formato de nombre se establece en Utilizar solo valores de campo, los valores de campo para el primer registro son Main y Street, y el adjunto es un archivo .jpg, el archivo exportado se llamará Main_Street.jpg.

Este parámetro se habilita cuando el parámetro Formato de nombre está configurado como Utilizar solo valores de campo, Agregar valores de campo como prefijo o Agregar valores de campo como sufijo.

Field

Salida derivada

EtiquetaExplicaciónTipo de datos
Directorios de salida

Las carpetas actualizadas.

Folder

arcpy.management.ExportAttachments(in_dataset, out_location, {subdirectory_field}, {name_format}, {name_fields})
NombreExplicaciónTipo de datos
in_dataset

La clase de entidad o tabla de geodatabase de la que se exportarán los adjuntos.

La entrada se debe guardar en una geodatabase versión 10.0 o más reciente, y la tabla debe tener habilitados los adjuntos.

Table View
out_location

La carpeta donde se exportarán los archivos adjuntos.

Folder
subdirectory_field
(Opcional)

Un campo del valor del parámetro in_dataset que se utilizará para crear los nombres de los subdirectorios.

Field
name_format
(Opcional)

Especifica el formato que se utilizará para dar nombre a los adjuntos exportados.

  • ORIGINALLos nombres de los archivos de salida utilizarán los nombres originales de los archivos almacenados en la geodatabase.
  • REPLACELos nombres de los archivos de salida utilizarán los valores de los campos de los valores de los parámetros name_fields.
  • PREFIXLos nombres de los archivos de salida utilizarán los nombres de archivo originales con un prefijo de los valores de los campos de los valores de los parámetros name_fields.
  • SUFFIXLos nombres de los archivos de salida utilizarán los nombres de archivo originales con un sufijo de los valores de los campos de los valores de los parámetros name_fields.
String
name_fields
[name_fields,...]
(Opcional)

Los campos del valor del parámetro in_dataset que se utilizarán para renombrar los adjuntos exportados. Si se especifican varios campos, los archivos de salida utilizarán los valores de los campos concatenados con un guión bajo en el orden en que se especifiquen.

Por ejemplo, si se especifican dos nombres de campo, y el parámetro name_format se establece en REPLACE, los valores de campo para el primer registro son Main y Street, y el adjunto es un archivo .jpg, el archivo exportado se llamará Main_Street.jpg.

Este parámetro está habilitado cuando el parámetro name_format tiene el valor REPLACE, PREFIX o SUFFIX.

Field

Salida derivada

NombreExplicaciónTipo de datos
out_dirs

Las carpetas actualizadas.

Folder

Muestra de código

Ejemplo 1 de ExportAttachments (ventana de Python)

El siguiente fragmento de código demuestra cómo utilizar la función ExportAttachments en la ventana de Python.

import arcpy
arcpy.management.ExportAttachments(r"C:\Data\National.gdb\Airports",
                                   r"C:\OutputFolder", 'CODE', 'REPLACE', ['NAME', 'CODE'])
Ejemplo 2 de ExportAttachments (secuencia de comandos independiente)

Utilice la función ExportAttachments para exportar adjuntos de una entidad concreta después de realizar una selección en la fuente de datos.

import arcpy

# Import system variables
import arcpy

# Set the workspace
arcpy.env.workspace = r"C:\National.gdb"

# Set local variables
in_dataset = "Airports"
out_location = r"C:\Output_Images"
subdir_field = 'Code'
output_names = 'REPLACE'
name_fields = ['NAME', 'CODE']

# Select the Salt Lake City Airport and download all attachments to a subdirectory named SLC.
layerSelection = arcpy.management.SelectLayerByAttribute(in_dataset, 'NEW_SELECTION',
                                                         "Name = 'Salt Lake City'")

# Export the attachments with the layer selection set and renamed using field values.
arcpy.management.ExportAttachments(layerSelection, out_location, subdir_field,
                                   output_names, name_fields)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados