Cómo trabajar con paquetes

Los paquetes permiten importar y exportar el contenido del repositorio. Por ejemplo, puede utilizar paquetes para instalar nueva funcionalidad, transferir contenido entre instancias y hacer una copia de seguridad del contenido del repositorio.

Se puede acceder a los paquetes o mantenerlos desde las siguientes páginas:

• Administrador de paquetes, que se utiliza para administrar los paquetes en la instancia de AEM local.

• Package Share, un servidor centralizado que contiene tanto paquetes disponibles para el público como paquetes privados para su empresa. Los paquetes públicos pueden contener revisiones, nuevas funciones, documentación, etc.

Puede transferir paquetes entre el Administrador de paquetes, el Uso compartido de paquetes y el sistema de archivos.

¿Qué son los paquetes?

Un paquete es un archivo zip que contiene contenido del repositorio en forma de serialización del sistema de archivos (llamada serialización "vault"). Esto proporciona una representación fácil de usar y editar de archivos y carpetas.

Los paquetes incluyen contenido, tanto contenido de página como contenido relacionado con el proyecto, seleccionado mediante filtros.

Un paquete también contiene información meta de vault, incluidas las definiciones de filtro y la información de configuración de importación. En el paquete se pueden incluir propiedades de contenido adicionales (que no se utilizan para la extracción de paquetes), como una descripción, una imagen visual o un icono; estas propiedades son para el consumidor del paquete de contenido y solo para fines informativos.

Puede realizar las siguientes acciones con o con paquetes:

• Crear nuevos paquetes; definir la configuración y los filtros del paquete según sea necesario
• Vista previa del contenido del paquete (antes de la compilación)
• Generar paquetes
• Ver información del paquete
• Ver el contenido del paquete (después de la compilación)
• Modificación de la definición de paquetes existentes
• Reconstruir paquetes existentes
• Volver a ajustar paquetes
• Descargue paquetes de AEM a su sistema de archivos
• Cargue paquetes desde el sistema de archivos a la instancia AEM local
• Validar el contenido del paquete antes de la instalación
• Realizar una instalación de simulación
• Instale paquetes (AEM no instala paquetes automáticamente después de cargarlos)
• Eliminar paquetes
• Descargue paquetes, como revisiones, de la biblioteca Uso compartido de paquetes
• Cargar paquetes a la sección interna de la empresa de la biblioteca Uso compartido de paquetes

Información del paquete

Una definición de paquete consta de varios tipos de información:

• Configuración de paquetes
• Filtros del paquete
• Capturas de pantalla del paquete
• Iconos de paquete

Configuración de paquetes

Puede editar una variedad de Configuración del paquete para definir aspectos como la descripción del paquete, errores relacionados, dependencias e información del proveedor.

El cuadro de diálogo Configuración del paquete está disponible mediante el botón Editar cuando crea o edita un paquete y proporciona tres pestañas para la configuración. Después de realizar cualquier cambio, haga clic en OK para guardarlos.

Filtros del paquete

Los filtros identifican los nodos del repositorio que se incluyen en el paquete. Una Definición de filtro especifica la siguiente información:

• Ruta raíz del contenido que se va a incluir.
• ​​Reglas que incluyen o excluyen nodos específicos debajo de la ruta raíz.

Los filtros pueden incluir cero o más reglas. Cuando no se definen reglas, el paquete contiene todo el contenido debajo de la ruta raíz.

Puede definir una o más definiciones de filtro para un paquete. Utilice más de un filtro para incluir contenido de varias rutas raíz.

La tabla siguiente describe estas reglas y proporciona ejemplos:

Los filtros de paquete se definen generalmente al crear el paquete primero, pero también se pueden editar posteriormente (después de lo cual se debe reconstruir el paquete).

Capturas de pantalla del paquete

Puede adjuntar capturas de pantalla al paquete para proporcionar una representación visual del aspecto del contenido; por ejemplo, proporcionando capturas de pantalla de la nueva funcionalidad.

Iconos de paquete

También puede adjuntar un icono al paquete para proporcionar una representación visual de referencia rápida de lo que contiene el paquete. Esto se muestra en la lista de paquetes y puede ayudarle a identificar fácilmente el paquete o la clase del paquete.

Como un paquete puede contener un icono, las siguientes convenciones se utilizan para los paquetes oficiales:

Paquete de correcciones oficial:

Paquete oficial AEM Instalación o extensión:

Paquetes de funciones oficiales:

el administrador de paquetes

El Administrador de paquetes administra los paquetes en la instalación AEM local. Una vez que haya asignado los permisos necesarios puede utilizar el Administrador de paquetes para diversas acciones, como configurar, crear, descargar e instalar los paquetes. Los elementos clave que se deben configurar son:

• Configuración de paquetes
• Filtros del paquete

Permisos necesarios para utilizar el Administrador de paquetes

Para conceder a los usuarios el derecho de crear, modificar, cargar e instalar paquetes, debe darles los permisos adecuados en las siguientes ubicaciones:

• /etc/packages (derechos completos, excluida la eliminación)
• el nodo que contiene el contenido del paquete

Consulte Configuración de permisos para obtener instrucciones sobre cómo cambiar permisos.

Creación de un nuevo paquete

Para crear una nueva definición de paquete:

1. En la pantalla de bienvenida de AEM, haga clic en Paquetes (o en la consola Herramientas haga doble clic en Paquetes).

2. A continuación, seleccione Administrador de paquetes.

3. Haga clic en Crear paquete.

   NOTA

   Si la instancia tiene muchos paquetes, puede haber una estructura de carpetas en su lugar, por lo que puede navegar a la carpeta de destino necesaria antes de crear el nuevo paquete.

4. En el cuadro de diálogo:

   

   Introduzca el:

   • Nombre del grupo

     El nombre del grupo de destino (o carpeta). Los grupos están pensados para ayudarle a organizar sus paquetes.

     Se creará una carpeta para el grupo si aún no existe. Si deja en blanco el nombre del grupo, se creará el paquete en la lista de paquetes principal (Inicio > Paquetes).

   • Nombre del paquete

     El nombre del nuevo paquete. Seleccione un nombre descriptivo para ayudarle (y a otros) a identificar fácilmente el contenido del paquete.

   • Versión

     Campo de texto para indicar una versión. Esto se añadirá al nombre del paquete para formar el nombre del archivo zip.
     Haga clic en OK para crear el paquete.

5. AEM enumera el nuevo paquete en la carpeta de grupo correspondiente.

   

   Haga clic en el icono o el nombre del paquete para abrirlo.

   

   NOTA

   Si es necesario, puede volver a esta página en una etapa posterior.

6. Haga clic en Editar para editar la configuración del paquete.

   Aquí puede añadir información o definir determinadas configuraciones; por ejemplo, estos incluyen una descripción, el icono, errores relacionados y añadir detalles del proveedor.

   Haga clic en OK después de que haya terminado de editar la configuración.

7. Agregue Capturas de pantalla al paquete según sea necesario. Una instancia está disponible cuando se crea el paquete, añada más si es necesario mediante la captura de pantalla del paquete de la barra de tareas.

   Agregue la imagen real haciendo doble clic en el componente de imagen en el área Capturas de pantalla, agregando una imagen y haciendo clic en Aceptar.

8. Defina los Filtros de paquete arrastrando instancias de la Definición del filtro desde la barra de tareas y haciendo doble clic para abrirlas y editarlas:

   

   Especifique:

   • Ruta
     raízEl contenido que se va a empaquetar; puede ser la raíz de un subárbol.

   • ​
     Las reglas son opcionales; para definiciones de paquetes simples, no es necesario especificar reglas de inclusión o exclusión.

     Si es necesario, puede definir Include o Exclude rules para definir exactamente el contenido del paquete.

     Agregue reglas utilizando el símbolo +, o bien elimine reglas utilizando el símbolo -. Las reglas se aplican según su orden, de modo que se coloquen según sea necesario mediante los botones Up y Down.
     A continuación, haga clic en OK para guardar el filtro.

   NOTA

   Puede utilizar tantas definiciones de filtro como necesite, aunque debe asegurarse de que no entren en conflicto. Utilice Preview para confirmar cuál será el contenido del paquete.

9. Para confirmar lo que contendrá el paquete, puede utilizar Preview. Esto realiza una ejecución en seco del proceso de compilación y enumera todo lo que se agregará al paquete cuando realmente se haya creado.

10. Ahora puede compilar su paquete.

    NOTA

    No es obligatorio construir el paquete en este momento, puede hacerse en un momento posterior.

Creación de un paquete

A menudo, un paquete se crea al mismo tiempo que crea la definición del paquete, pero puede regresar más adelante para crear o reconstruir el paquete. Esto puede resultar útil si el contenido del repositorio ha cambiado.

1. Abra la definición del paquete desde Package Manager (haga clic en el icono o nombre del paquete).

2. Haga clic en Build. Un cuadro de diálogo solicita confirmación de que desea crear el paquete.

   NOTA

   Esto es de especial importancia cuando está reconstruyendo un paquete, ya que el contenido del paquete se sobrescribirá.

3. Haga clic en Aceptar. AEM compilará el paquete, enumerando todo el contenido agregado al paquete tal como lo hace. Cuando se completa AEM muestra una confirmación de que el paquete se creó y (cuando cierra el cuadro de diálogo) actualiza la información de la lista de paquetes.

Ajustar un paquete

Una vez que se ha creado un paquete, se puede volver a ajustar, si es necesario.

Al volver a ajustar se cambia la información del paquete: sin cambiar el contenido del paquete. La información del paquete es la miniatura, la descripción, etc., es decir, todo lo que se puede editar con el cuadro de diálogo Configuración del paquete (para abrir este clic Editar).

Un caso de uso importante para el reajuste es al preparar un paquete para el paquete compartido. Por ejemplo, puede tener un paquete existente y decidir compartirlo con otros. Para ello, desea agregar una miniatura y una descripción. En lugar de recrear todo el paquete con toda su funcionalidad (que puede tardar algún tiempo y corre el riesgo de que el paquete ya no sea idéntico al original), puede volver a envolverlo y simplemente añadir la miniatura y la descripción.

1. Abra la definición del paquete desde Package Manager (haga clic en el icono o nombre del paquete).

2. Haga clic en Editar y actualice la Configuración del paquete según sea necesario. Haga clic en Aceptar para guardar.

3. Haga clic en Rewrap, se solicitará confirmación en un cuadro de diálogo.

Visualización y edición de la información del paquete

Para ver o editar información sobre una definición de paquete:

1. En el Administrador de paquetes, vaya al paquete que desee ver.

2. Haga clic en el icono del paquete que desee ver. Se abrirá la página del paquete que enumera información sobre la definición del paquete:

   

   NOTA

   También puede editar y realizar ciertas acciones en el paquete desde esta página.

   Los botones disponibles dependerán de si el paquete ya se ha creado o no.

3. Si el paquete ya se ha creado, haga clic en Contents, se abrirá una ventana que muestra todo el contenido del paquete:

Visualización del contenido del paquete y prueba de la instalación

Después de crear un paquete, puede ver el contenido:

1. En el Administrador de paquetes, vaya al paquete que desee ver.

2. Haga clic en el icono del paquete que desee ver. Esto abrirá la página del paquete que enumera información sobre la definición del paquete.

3. Para ver el contenido, haga clic en Contents, se abrirá una ventana que muestra todo el contenido del paquete:

   

4. Para realizar una ejecución en seco de la instalación, haga clic en Probar instalación. Después de confirmar la acción, se abrirá una ventana y se enumerarán los resultados como si la instalación se hubiera realizado:

   

Descarga de paquetes en el sistema de archivos

En esta sección se describe cómo descargar un paquete de AEM a su sistema de archivos mediante el Administrador de paquetes.

1. En la pantalla de bienvenida de AEM, haga clic en Paquetes y, a continuación, seleccione Administrador de paquetes.

2. Vaya al paquete que desee descargar.

   

3. Haga clic en el enlace formado por el nombre del archivo zip (subrayado) para el paquete que desee descargar; por ejemplo export-for-offline.zip.

   AEM descarga el paquete en el equipo (mediante un cuadro de diálogo de descarga estándar del explorador).

Carga de paquetes desde el sistema de archivos

La carga de paquetes permite cargar paquetes desde el sistema de archivos en el Administrador de paquetes de AEM.

Para cargar un paquete:

1. Vaya al Administrador de paquetes. A continuación, en la carpeta del grupo en la que desea que se cargue el paquete.

   

2. Haga clic en Cargar paquete.

   

   • Archivo

     Puede escribir el nombre del archivo directamente o utilizar el Browse…El cuadro de diálogo para seleccionar el paquete requerido del sistema de archivos local (después de seleccionar haga clic en OK).

   • Forzar carga

     Si ya existe un paquete con este nombre, puede hacer clic en esto para forzar la carga (y sobrescribir el paquete existente).
     Haga clic en OK para que el nuevo paquete se cargue y aparezca en la lista Administrador de paquetes.

   NOTA

   Para que el contenido esté disponible para AEM, asegúrese de instalar el paquete.

Validación de paquetes

Antes de instalar un paquete, es posible que desee verificar su contenido. Dado que los paquetes pueden modificar los archivos superpuestos en /apps y/o añadir, modificar y eliminar ACL, a menudo resulta útil validar estos cambios antes de instalar.

Opciones de validación

El mecanismo de validación puede comprobar las siguientes características del paquete:

• Importaciones de paquetes OSGi
• Superposiciones
• ACL

Estas opciones se detallan a continuación.

• Validar importaciones de paquetes OSGi

  Qué se ha marcado

  Esta validación inspecciona el paquete para todos los archivos JAR (paquetes OSGi), extrae su manifest.xml (que contiene las dependencias con versiones en las que se basa dicho paquete OSGi) y verifica que la instancia de AEM exporta dichas dependencias con las versiones correctas.

  Cómo se informa

  Las dependencias con versiones que la instancia de AEM no pueda satisfacer se enumeran en el Registro de actividades del Administrador de paquetes.

  Estados de error

  Si las dependencias no están satisfechas, los paquetes OSGi del paquete con esas dependencias no se iniciarán. Esto da como resultado una implementación de aplicación rota, ya que todo lo que dependa del paquete no iniciado OSGi a su vez no funcionará correctamente.

  Resolución de errores

  Para resolver errores debido a paquetes OSGi insatisfechos, es necesario ajustar la versión de dependencia del paquete con importaciones insatisfechas.

• Validar capas

  Qué se ha marcado

  Esta validación determina si el paquete que se está instalando contiene un archivo que ya está superpuesto en la instancia de AEM de destino.

  Por ejemplo, dado un overlay existente en /apps/sling/servlet/errorhandler/404.jsp, un paquete que contiene /libs/sling/servlet/errorhandler/404.jsp, de modo que cambie el archivo existente en /libs/sling/servlet/errorhandler/404.jsp.

  Cómo se informa

  Estas superposiciones se describen en el Registro de actividades del Administrador de paquetes.

  Estados de error

  Un estado de error significa que el paquete está intentando implementar un archivo que ya está superpuesto, por lo que los cambios en el paquete serán anulados (y por lo tanto "ocultos") por la superposición y no tendrán efecto.

  Resolución de errores

  Para resolver este problema, el mantenedor del del archivo de superposición en /apps debe revisar los cambios del archivo superpuesto en /libs, incorporar los cambios según sea necesario en la superposición ( /apps) y volver a implementar el archivo superpuesto.

  NOTA

  Tenga en cuenta que el mecanismo de validación no tiene forma de cuadrarse si el contenido superpuesto se ha incorporado correctamente en el archivo de superposición. Por lo tanto, esta validación seguirá informando sobre los conflictos incluso después de realizar los cambios necesarios.

• Validar ACL

  Qué se ha marcado

  Esta validación comprueba qué permisos se están agregando, cómo se gestionarán (combinar/reemplazar) y si los permisos actuales se verán afectados.

  Cómo se informa

  Los permisos se describen en el Registro de actividades del Administrador de paquetes.

  Estados de error

  No se pueden proporcionar errores explícitos. La validación simplemente indica si se agregarán o afectarán nuevos permisos ACL al instalar el paquete.

  Resolución de errores

  Utilizando la información proporcionada por la validación, los nodos afectados pueden revisarse en CRXDE y las ACL pueden estar ajustándose en el paquete según sea necesario.

  PRECAUCIÓN

  Se recomienda que los paquetes no afecten a las ACL proporcionadas por AEM, ya que esto puede provocar un comportamiento inesperado del producto.

Realización de la validación

La validación de los paquetes puede realizarse de dos maneras diferentes:

• A través de la interfaz de usuario del Administrador de paquetes
• A través de una solicitud de POST HTTP como con cURL

Validación de paquetes mediante el administrador de paquetes

1. Abra el Administrador de paquetes en https://<server>:<port>/crx/packmgr

2. Seleccione el paquete en la lista y, a continuación, seleccione la lista desplegable More en el encabezado y Validate en el menú desplegable.

   NOTA

   Esto debe hacerse después de cargar el paquete de contenido, pero antes de instalar el paquete.

3. En el cuadro de diálogo modal que aparece a continuación, utilice las casillas de verificación para seleccionar los tipos de validación y comenzar la validación haciendo clic en Validar. También puede hacer clic en Cancelar.

4. A continuación, se ejecutan las validaciones seleccionadas. Los resultados se muestran en el registro de actividades del Administrador de paquetes.

Validación de paquetes mediante solicitud de POST HTTP

La solicitud del POST adopta el siguiente formulario.

https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls

A continuación se muestra un ejemplo de cómo utilizar cURL para ejecutar una validación de paquete.

1. Si utiliza cURL, ejecute una instrucción similar a la siguiente:

   curl -v -X POST --user admin:admin -F file=@/Users/SomeGuy/Desktop/core.wcm.components.all-1.1.0.zip 'http://localhost:4502/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls'
   

2. La validación solicitada se ejecuta y la respuesta se devuelve como un objeto JSON.

Instalación de paquetes

Después de cargar un paquete, debe instalar el contenido. Para que el contenido del paquete esté instalado y funcione, debe ser de ambos:

• cargado en AEM (ya sea cargado desde su sistema de archivos o descargado del paquete compartido)

• instalen

1. En el Administrador de paquetes, vaya al paquete que desee instalar.

   Se muestra un botón Install al lado de los paquetes que aún no se han instalado.

   NOTA

   Como alternativa, puede abrir el paquete haciendo clic en su icono para acceder al botón Install de ahí.

2. Haga clic en Instalar para iniciar la instalación. Un cuadro de diálogo solicitará confirmación y enumerará todos los cambios que se realicen. Cuando termine, haga clic en Cerrar en el cuadro de diálogo.

   La palabra Installed aparece junto al paquete después de haberlo instalado.

Carga e instalación basadas en el sistema de archivos

Hay una forma alternativa de cargar e instalar paquetes en su instancia. En su sistema de archivos, tiene una carpeta crx-quicksart junto con su archivo jar y license.properties. Debe crear una carpeta denominada install en crx-quickstart. Entonces tendrá algo así: <aem_home>/crx-quickstart/install

En esta carpeta de instalación, puede añadir directamente sus paquetes. Se cargarán automáticamente y se instalarán en su instancia. Cuando haya terminado, podrá ver los paquetes en el Administrador de paquetes.

Si la instancia se está ejecutando, la adición de un paquete a la carpeta install iniciará directamente la carga y la instalación en la instancia. Si la instancia no se está ejecutando, los paquetes que ponga en la carpeta install se instalarán al inicio en orden alfabético.

Desinstalación de paquetes

AEM permite desinstalar paquetes. Esta acción revierte el contenido del repositorio que se ve afectado a la instantánea realizada inmediatamente antes de la instalación del paquete.

1. En el Administrador de paquetes, vaya al paquete que desea desinstalar.
2. Haga clic en el icono del paquete que desea desinstalar.
3. Haga clic en Desinstalar para eliminar el contenido de este paquete del repositorio. Un cuadro de diálogo solicitará confirmación y enumerará todos los cambios que se realicen. Cuando termine, haga clic en Cerrar en el cuadro de diálogo.

Eliminación de paquetes

Para eliminar un paquete de la lista del Administrador de paquetes:

1. En la consola Tools, expanda la carpeta Packages para mostrar el paquete en el panel derecho.

2. Haga clic en el paquete que desee eliminar para que quede resaltado y:

   • Haga clic en Delete en el menú de la barra de herramientas.
   • Haga clic con el botón derecho y seleccione Delete.

   

3. AEM solicita confirmación de que desea eliminar el paquete. Haga clic en OK para confirmar la eliminación.

Duplicación de paquetes

Repita el contenido de un paquete para instalarlo en la instancia de publicación:

1. En el Administrador de paquetes, vaya al paquete que desee duplicar.

2. Haga clic en el icono o en el nombre del paquete que desee duplicar para expandirlo.

3. En el menú desplegable Más de la barra de herramientas, seleccione Replicar.

Uso compartido de paquetes

Package Share era un servidor centralizado al que se podía acceder públicamente para compartir paquetes de contenido.

Se ha reemplazado por Distribución de software.

Distribución de software

La distribución de software es la nueva interfaz de usuario diseñada para simplificar la búsqueda y descarga de paquetes AEM.

Para obtener más información, consulte la Documentación de distribución de software.

Recursos de Business.Adobe.com

Automated Onboarding Auto Form Fill Targeted Content Asset Collections Embedded Charts Version History