Importación masiva de recursos mediante Assets Essentials bulk-import-essentials
La importación masiva en la vista de AEM Assets Essentials permite a los administradores importar un gran número de recursos desde una fuente de datos a AEM Assets. Los administradores ya no tienen que cargar archivos o carpetas individuales en Experience Manager Assets.
Puede importar recursos desde las siguientes fuentes de datos:
- AWS
- Google Cloud
- Dropbox
- OneDrive
- Azure
Requisitos previos prerequisites
- Cuenta de almacenamiento de Azure
- Contenedor de blob de Azure
- Clave de acceso de Azure o token SAS basado en el modo de autenticación
- Región de AWS
- Contenedor de AWS
- Clave de acceso de AWS
- Secreto de acceso de AWS
- Contenedor de GCP
- Correo electrónico de la cuenta de servicio de GCP
- Clave privada de la cuenta de servicio de GCP
- ID de cliente de Dropbox
- Secreto de cliente de Dropbox
- ID de inquilino de OneDrive
- ID de cliente de OneDrive
- Secreto de cliente de OneDrive
Además de estos requisitos previos basados en la fuente de datos, debe tener en cuenta el nombre de la carpeta de origen disponible en la fuente de datos que contiene todos los recursos que deben importarse en AEM Assets.
Configuración de la aplicación para desarrolladores de Dropbox dropbox-developer-application
Antes de importar recursos desde la cuenta de Dropbox a AEM Assets, cree y configure la aplicación para desarrolladores de Dropbox.
Ejecute los siguientes pasos:
-
Inicie sesión en su cuenta de Dropbox y haga clic en Crear aplicaciones.
Si está utilizando una cuenta Enterprise de Dropbox, debe tener acceso a la función de administrador de contenido. -
En la sección Elegir una API, seleccione el único botón de opción disponible.
-
En la sección Elija el tipo de acceso que desea, seleccione una de las siguientes opciones:
-
Seleccione Carpeta de aplicación, si ha de acceder a una única carpeta creada dentro de su aplicación en su cuenta de Dropbox.
-
Seleccione Dropbox completo, si ha de acceder a todos los archivos y carpetas de su cuenta de Dropbox.
-
-
Especifique un nombre para la aplicación y haga clic en Crear aplicación.
-
En la pestaña Configuración de la aplicación, añada https://experience.adobe.com a la sección URI de redireccionamiento.
-
Copie los valores de los campos Clave de aplicación y Secreto de aplicación. Los valores son necesarios al configurar la herramienta de importación masiva en AEM Assets.
-
En la pestaña Permisos, agregue los siguientes permisos dentro de la sección Ámbitos individuales.
-
account_info.read
-
files.metadata.read
-
files.content.read
-
files.content.write
-
-
Haga clic en Enviar para guardar los cambios.
Configuración de la aplicación para desarrolladores de OneDrive onedrive-developer-application
Antes de importar recursos desde la cuenta de OneDrive a AEM Assets, cree y configure la aplicación para desarrolladores de OneDrive.
Creación de una aplicación
-
Inicie sesión en su Cuenta de OneDrive y haga clic en Nuevo registro.
-
Especifique un nombre para la aplicación, seleccione Solo cuentas en este directorio organizativo (solo Adobe: inquilino único) de Tipos de cuenta compatibles.
-
Ejecute los pasos siguientes para añadir URI de redireccionamiento:
-
En el menú desplegable Seleccione una plataforma, seleccione Web.
-
Añada https://experience.adobe.com a la sección URI de redireccionamiento.
-
-
Haga clic en Registrar. La aplicación se ha creado correctamente.
-
Copie los valores de los campos ID (de cliente) de aplicación e ID (de inquilino) de directorio. Los valores son necesarios al configurar la herramienta de importación masiva en AEM Assets.
-
Haga clic en Añadir un certificado o secreto correspondiente a la opción Credenciales del cliente.
-
Haga clic en Nuevo secreto de cliente, proporcione la descripción del secreto del cliente, su vencimiento y haga clic en Añadir.
-
Después de crear el secreto del cliente, copie el campo Valor (No copie el campo ID de secreto). Es necesario al configurar la importación masiva en AEM Assets.
Añadir permisos de API
Ejecute los siguientes pasos para agregar permisos de API para la aplicación:
- Haga clic en Permisos de API en el panel izquierdo y haga clic en Agregar un permiso.
- Haga clic en Gráfico de Microsoft > Permisos delegados. La sección Seleccionar permiso muestra los permisos disponibles.
- Seleccione el permiso
offline_access
deOpenId permissions
y el permisoFiles.ReadWrite.All
deFiles
. - Haga clic en Agregar permisos para guardar los permisos.
Crear configuración de importación masiva create-bulk-import-configuration
Siga estos pasos para crear una configuración de importación masiva en Experience Manager Assets:
-
Haga clic en Importación masiva en el panel izquierdo y haga clic en Crear importación.
-
Seleccione la fuente de datos. Las opciones disponibles incluyen Azure, AWS, Google Cloud, Dropbox y OneDrive.
-
Especifique un nombre para la configuración de importación masiva en el campo Nombre.
-
Especifique las credenciales específicas de la fuente de datos, tal como se menciona en Requisitos previos.
-
Proporcione el nombre de la carpeta raíz que contiene los recursos de la fuente de datos en el campo Carpeta de origen.
note note NOTE Si utiliza Dropbox como fuente de datos, especifique la ruta de la carpeta de origen en función de las siguientes reglas: - Si selecciona Dropbox completo al crear la aplicación Dropbox, y la carpeta que contiene los recursos existe en
https://www.dropbox.com/home/bulkimport-assets
, especifiquebulkimport-assets
en el campo Carpeta de origen. - Si selecciona Carpeta de aplicación al crear la aplicación Dropbox, y la carpeta que contiene los recursos existe en
https://www.dropbox.com/home/Apps/BulkImportAppFolderScope/bulkimport-assets
, especifiquebulkimport-assets
en el campo Carpeta de origen, dondeBulkImportAppFolderScope
hace referencia al nombre de la aplicación.Apps
se añade automáticamente después dehome
en este caso.
- Si selecciona Dropbox completo al crear la aplicación Dropbox, y la carpeta que contiene los recursos existe en
-
(Opcional) Seleccione la opción Eliminar archivo de origen tras importar para eliminar los archivos originales del almacén de datos de origen después de importar los archivos en Experience Manager Assets.
-
Seleccione el Modo de importación. Seleccione Omitir, Reemplazar o Crear versión. El modo de omisión es el predeterminado y, en este modo, el ingestor omite la importación de un recurso si ya existe.
-
(Opcional) Especifique el archivo de metadatos que desea importar, proporcionado en formato CSV, en el campo Archivo de metadatos. El archivo fuente de metadatos debe estar en la carpeta de origen. Haga clic en Siguiente para navegar a Ubicación y filtros.
-
Especifique una ruta para definir una ubicación en DAM en la que se importarán los recursos mediante Carpeta de destino de recursos. Por ejemplo,
/content/dam/imported_assets
. -
(Opcional) En la sección Elegir filtros, proporcione el tamaño mínimo de archivo de los recursos en MB para incluirlos en el proceso de ingesta en el campo Filtrar por tamaño mínimo.
-
(Opcional) Proporcione el tamaño máximo de archivo de los recursos en MB para incluirlos en el proceso de ingesta en Filtrar por tamaño máximo.
-
(Opcional) Seleccione los tipos MIME que desea incluir en el proceso de ingesta mediante el campo Incluir tipo MIME. Puede seleccionar varios tipos MIME en este campo. Si no define un valor, todos los tipos MIME se incluyen en el proceso de ingesta.
-
(Opcional) Seleccione los tipos MIME que desea excluir en el proceso de ingesta mediante el campo Excluir tipo MIME. Puede seleccionar varios tipos MIME en este campo. Si no define un valor, todos los tipos MIME se incluyen en el proceso de ingesta.
-
Haga clic en Siguiente. Seleccione una de las siguientes opciones según su preferencia:
- Guardar importación para guardar la configuración por ahora y poder ejecutarla más adelante.
- Guardar y ejecutar importación para guardar la configuración y ejecutar la importación masiva.
- Guardar y programar importación para guardar la configuración y programar la importación masiva para más adelante. Puede elegir la frecuencia de la importación masiva y establecer la fecha y hora de la importación. La importación masiva se ejecutará en la fecha y hora establecidas en la frecuencia elegida.
-
Haga clic en Guardar para ejecutar la opción seleccionada.
Uso de nombres de archivo durante la importación masiva filename-handling-bulkimport-assets-view
Al importar recursos o carpetas de forma masiva, Experience Manager Assets importa toda la estructura existente en el origen de importación. Experience Manager sigue las reglas integradas en cuanto a los caracteres especiales en los nombres de recursos y carpetas, por lo que estos nombres de archivo necesitan limpiarse. Tanto para el nombre de la carpeta como para el nombre del recurso, el título definido por el usuario permanece sin cambios y se almacena en jcr:title
.
Durante la importación masiva, Experience Manager busque las carpetas existentes para evitar volver a importar los recursos y las carpetas, y compruebe también las reglas de limpieza aplicadas en la carpeta principal en la que se realiza la importación. Si las reglas de limpieza se aplican en la carpeta principal, se aplicarán las mismas reglas al origen de importación. Para la nueva importación, se aplican las siguientes reglas de limpieza para administrar los nombres de archivo de los recursos y las carpetas.
Para obtener más información sobre los nombres no permitidos, el uso de nombres de recursos y el uso de nombres de carpetas durante la importación masiva, consulte Uso de nombres de archivo durante la importación masiva.
Ver configuraciones de importación masiva existentes view-import-configuration
Para ver las importaciones masivas existentes, seleccione la opción Importaciones masivas en el panel izquierdo. Aparece la página de importaciones masivas con la lista de Importaciones ejecutadas.
También puede ver las Importaciones guardadas e Importaciones programadas desde la opción desplegable.
Editar configuración de importación masiva edit-import-configuration
Para editar los detalles de configuración, haga clic en el correspondiente al nombre de la configuración y haga clic en Editar. No se puede editar el título de la configuración y la fuente de datos de importación mientras se realiza la operación de edición. Puede editar la configuración mediante las pestañas Importaciones ejecutadas, programadas o guardadas.
Programar importaciones únicas o recurrentes schedule-imports
Para programar una importación masiva única o recurrente, ejecute los siguientes pasos:
-
Haga clic en el correspondiente al nombre de configuración disponible en la pestaña Importaciones ejecutadas o Importaciones guardadas y haga clic en Programación. También puede reprogramar una importación programada existente navegando hasta Importaciones programadas y haciendo clic en Programación.
-
Establezca una ingesta única o programe una programación horaria, diaria o semanal. Haga clic en Enviar.
Realizar una comprobación de estado de importación import-health-check
Para validar la conexión con la fuente de datos, haga clic en el correspondiente al nombre de la configuración y, a continuación, haga clic en Comprobación. Si la conexión se realiza correctamente, Experience Manager Assets muestra el siguiente mensaje:
Realice un ensayo antes de ejecutar una importación dry-run-bulk-import
Haga clic en el correspondiente al nombre de la configuración y haga clic en Ensayo para invocar una ejecución de prueba para el trabajo de importación masiva. Experience Manager Assets muestra los siguientes detalles sobre el trabajo de importación masiva:
Ejecución de una importación masiva run-bulk-import
Si ha guardado la importación al crear la configuración, puede ir la pestaña Importaciones guardadas, hacer clic en el correspondiente a la configuración y hacer clic en Ejecutar.
Del mismo modo, si necesita efectuar una importación ya ejecutada, vaya a la pestaña Importaciones ejecutadas, haga clic en el correspondiente al nombre de configuración y haga clic en Ejecutar.
Detener o programar una importación en curso schedule-stop-ongoing-report
Puede programar o detener una importación masiva en curso mediante el cuadro de diálogo de estado de importación masiva que aparece en la página de inicio Importación masiva durante una importación.
También puede ver los recursos que se han importado en la carpeta de destino haciendo clic en Ver recursos.
Eliminar una configuración de importación masiva delete-bulk-import-configuration
Haga clic en el correspondiente al nombre de configuración existente en las pestañas Importaciones ejecutadas, Importaciones programadas o Importaciones guardadas y haga clic en Eliminar para borrar la configuración de importación masiva.
Ir a los recursos después de realizar una importación masiva view-assets-after-bulk-import
Para ver la ubicación de destino de los recursos donde se importan después de ejecutar el trabajo de importación masiva, haga clic en el correspondiente al nombre de la configuración y, a continuación, haga clic en Ver recursos.