Exportar e importar integraciones y microaplicaciones

El servicio de microaplicaciones le permite exportar e importar fácilmente integraciones y microaplicaciones.

Con la función de exportación puede:

• Exportar una integración solamente, con todas las microaplicaciones o con una serie de microaplicaciones seleccionadas.
• Exportar microaplicaciones individualmente desde una integración existente.

Con la función de importación puede:

• Importar una integración, con todas las microaplicaciones.
• Importar microaplicaciones individualmente desde un archivo de exportación existente, además de las nuevas versiones de las microaplicaciones actuales.

Ventajas

La importación y exportación de integraciones y microaplicaciones se pueden utilizar en los siguientes supuestos:

• Copia de seguridad y restauración de integraciones y microaplicaciones existentes.
• Reducción del tiempo necesario para desarrollar microaplicaciones adicionales con integraciones.
• Prueba de nuevas configuraciones sin que afecte a las integraciones de producción.
• Solución de problemas, permitiéndole desarrollar formas seguras de probar las soluciones propuestas.
• Colaboración con otros desarrolladores de microaplicaciones de su organización o con la comunidad más amplia de desarrolladores de la plataforma de microaplicaciones Citrix.

Función de exportación

La función de exportación empaqueta los distintos parámetros y configuraciones en un archivo con extensión MAPP. Este archivo se puede importar a la consola de administración de microaplicaciones. Hay dos tipos de archivos MAPP. Uno para integraciones y otro para microaplicaciones.

Nota

El archivo de exportación no incluye datos confidenciales, como ID de usuario, contraseñas, ID de cliente de OAUTH y secretos de cliente.

Los archivos de configuración MAPP de integración de plantillas contienen lo siguiente:

• Programación y configuraciones de sincronización
• Tablas
  • Opciones de Modificar esquema
  • Atributos seleccionados
  • Filtros y consultas de filtrado
• Relaciones
• Acciones
• Configuración
  • Nombre de la integración
  • Parámetros del conector
    • URL de servicio
  • Autenticación de servicio
    • Nombre de usuario
    • Contraseña
  • Método de autenticación de usuario
  • Otros parámetros
  • Configuración local
  • Registros

Nota

Las microaplicaciones se exportan, pero sin ningún suscriptor configurado previamente. Los suscriptores deben configurarse nuevamente una vez importada la microaplicación. Para obtener más información, consulte Asignar suscriptores.

Los archivos de configuración MAPP de Integración HTTP contienen lo siguiente:

• Carga de datos
  • Dispositivos de punto final de datos (incluidos los dispositivos secundarios encadenados)
• Tablas
• Relaciones
• Acciones de servicio
• Configuración
  • Nombre de la integración
  • Parámetros del conector
    • URL base
  • Icono
  • Instancia local
  • Autenticación de servicio
    • Método de autenticación
  • Autenticación de acciones de servicio
    • Usar autenticación de usuario independiente en Acciones
    • Método de autenticación
  • Registros

Los archivos de configuración MAPP de microaplicaciones contienen lo siguiente:

• Propiedades
  • Nombre
  • Descripción
  • Icono
  • Acción
  • (Página de acciones)
• Notificaciones
  • Nombre
    • Desencadenante
  • Conmutadores
  • Contenido
    • Botones de acción
  • Página de destino
  • Parámetros
    • Condiciones
  • Condiciones de caducidad
• Páginas
  • Todas las propiedades y acciones de la página
  • Formato de todas las páginas
  • Todos los componentes y configuraciones de página
  • Todas las acciones llamadas
• Localización
  • Todas las configuraciones de localización
• Metadatos
  • Identificación de la integración utilizada para generar la microaplicación.
  • A la nueva integración deberá asignarse correctamente una estructura de asignación de componentes de microaplicación para la capa de caché de datos de integración.
  • No se exportan parámetros de suscriptores.

Exportar una configuración

Para exportar un archivo de configuración, siga estos pasos:

1. Abra la consola de administración de microaplicaciones y localice la integración que quiere exportar.
2. Haga clic en el menú de puntos suspensivos de la integración y seleccione Exportar integración.
3. Introduzca los valores opcionales para los campos Proveedor y Descripción.
4. Seleccione o anule la selección de las microaplicaciones que quiere incluir en el archivo de exportación.
5. Seleccione Exportar.
6. Guarde el archivo MAPP resultante en una ubicación segura. El archivo de configuración MAPP se exporta en formato .MAPP a la máquina local.

Exportar una microaplicación

Para exportar un archivo de microaplicación, siga estos pasos:

1. Abra la consola de administración de microaplicaciones y localice la integración desde la que quiere exportar la microaplicación.
2. Haga clic en el menú de puntos suspensivos de la microaplicación que quiere exportar y seleccione Exportar.
3. Guarde el archivo MAPP resultante en una ubicación segura. El archivo de configuración MAPP se exporta en formato .MAPP a la máquina local.

Función de importación

Al importar configuraciones de integración y microaplicaciones, tenga en cuenta lo siguiente antes de iniciar el flujo de trabajo de exportación/importación:

• Cuál será el estado de la integración después de la importación.
• Dependiendo del tipo de integración exportada y de los parámetros configurados, deberá actualizarse la configuración de integración.
• Después de la importación, el estado de integración puede mostrar la advertencia Configuración de autenticación necesaria. Deberá volver a configurar las credenciales de autenticación para que la importación se realice correctamente.
• No hay sincronizaciones, almacenamiento en caché u otras acciones posibles hasta que se actualicen las credenciales del servicio.

OAuth

Al exportar e importar integraciones y microaplicaciones que utilizan OAuth, tenga en cuenta lo siguiente antes de iniciar el flujo de trabajo de exportación/importación:

• Para las integraciones con OAuth configuradas para cuentas de servicio o acciones de servicio, la integración se exporta sin secretos de cliente.
• Al hacerlo, se producen problemas con esquemas de autenticación que utilizan OAuth y que pueden incluir el esquema Autenticación de servicio y el esquema Autenticación de acciones de servicio.
• No se admiten sincronizaciones ni otras acciones hasta que se actualicen las credenciales del servicio.
• La reautenticación es necesaria para obtener tokens actualizados del sistema de registro (SoR).

Para rellenar las credenciales de OAUTH, siga estos pasos:

1. En la consola de administración de microaplicaciones, busque la integración recién importada.
2. Haga clic en el menú de puntos suspensivos para la integración y elija Modificar.
3. Haga clic en Propiedades a la izquierda
4. Rellene las contraseñas que faltan, los secretos y vuelva a autenticar OAuth.

Importar limitaciones de microaplicaciones

Las microaplicaciones se crean dentro de las integraciones. La integración primaria de una microaplicación se denomina integración de origen. Al importar una microaplicación, puede importarla en la misma integración de origen o en otra integración o integración de destino. Existen limitaciones importantes que deben tenerse en cuenta al importar microaplicaciones en integraciones de destino.

Impactos conocidos de la importación de microaplicaciones:

• Cualquier notificación existente (conocidas también como tarjetas de feeds) se elimina al eliminarse la microaplicación original.
• Se generan nuevas tarjetas de feeds y notificaciones push a partir de la siguiente sincronización (completa o incremental) de la nueva integración.
• Las microaplicaciones solo se pueden importar en una integración de destino que sea del mismo tipo (integración de plantilla o HTTP) que la integración de origen.

Nota

Incluso si la estructura de datos (o esquema) subyacente es igual en las integraciones de origen y destino, la función de importación de microaplicaciones no puede emparejar la estructura de datos de microaplicaciones con un tipo de integración diferente.

La integración de destino tiene una estructura de base de datos que coincide con la de la integración de origen:

• Si faltan algunas tablas en caché en la integración de destino (el esquema es diferente), la microaplicación se importa como mal configurada.
• Para evitar este error de configuración, asegúrese de que los esquemas de las integraciones de origen y destino son iguales.
• Navegue por los esquemas de integración para comprobar que las tablas que requiere la microaplicación están incluidas en el esquema.

Esquema de plantilla de microaplicaciones

Para ver el esquema de una integración de plantilla, siga estos pasos:

1. Inicie sesión en la consola de administración de microaplicaciones y busque la integración que quiere ver.
2. Haga clic en el menú de puntos suspensivos y elija Modificar.
3. Elija Tablas en el menú de la izquierda y haga clic en el botón para modificar el esquema.
4. Revise las tablas y compare los esquemas de origen y destino. Esto garantiza que las tablas y entidades idénticas se sincronicen con la caché de datos de microaplicaciones.

Estado de la microaplicación después de la importación

Cuando se importan microaplicaciones, se dan las siguientes condiciones:

• La microaplicación no tiene suscriptores. Los suscriptores deben volver a crearse manualmente.
• No se crearán notificaciones con respecto a esta microaplicación hasta que todos los suscriptores estén configurados y tenga lugar la siguiente sincronización.
• Las notificaciones se generarán automáticamente en función de las preferencias para desencadenar notificaciones (normalmente después de la siguiente sincronización).

Pasos de configuración de importación

Para importar una configuración, siga estos pasos:

1. Abra la consola de administración de microaplicaciones y haga clic en Agregar integración en la parte superior.
2. Seleccione el tipo de integración que quiere agregar.
3. Seleccione el botón Continuar situado junto a la opción “Importar una integración configurada previamente”.
4. Arrastre el archivo MAPP de integración o elija Examinar para seleccionar el archivo en una ubicación específica.
5. Si se seleccionó un archivo incorrecto, puede quitarlo haciendo clic en el enlace correspondiente. De lo contrario, haga clic en Importar.
6. La integración se muestra junto con todas las demás integraciones en la consola de administración.

Siguientes pasos:

• Agregue las credenciales que falten a la nueva integración.
• Agregue suscriptores a las nuevas microaplicaciones.
• Eliminar la integración original en el entorno de destino.

Importar una microaplicación en una integración existente

Nota

Las microaplicaciones contienen referencias a la estructura de datos de la integración que se utilizó para crearlas. Por lo tanto, las microaplicaciones solo deben importarse dentro de una integración de destino compatible.

Para importar una nueva microaplicación en una integración de destino existente:

1. Abra la consola de administración de microaplicaciones y busque la integración de destino.
2. Seleccione el menú de puntos suspensivos para la integración de destino y elija Importar microaplicación.
3. Arrastre el archivo MAPP de integración o elija Examinar para seleccionar el archivo en una ubicación específica.
4. Si se seleccionó un archivo incorrecto, puede quitarlo haciendo clic en el enlace correspondiente. De lo contrario, haga clic en Importar.
5. La microaplicación se muestra junto con todas las demás microaplicaciones para la integración.

Siguientes pasos:

• Agregue suscriptores a las nuevas microaplicaciones.

Importar una nueva versión de microaplicación

Puede actualizar una microaplicación a una versión más reciente desde el menú de opciones de la microaplicación (puntos suspensivos).

1. En la pantalla Integración de microaplicaciones, seleccione Importar nueva versión para la microaplicación deseada.

2. Arrastre la nueva microaplicación y seleccione Importar.

   (Opcional) Seleccione Eliminar tarjetas de feeds existentes si quiere eliminar completamente la versión anterior de su microaplicación del sistema. Si no selecciona esta opción, la antigua microaplicación permanecerá en el sistema, marcada con el indicador de fin de vida (EOL). La versión más reciente se establece como la microaplicación activa. Se recomienda no eliminar las microaplicaciones antiguas para que las tarjetas de feeds creadas funcionen correctamente.

3. Haga clic en Importar.

La nueva microaplicación se importa.

Siguientes pasos:

• Agregue suscriptores a las nuevas microaplicaciones.
• Fin de vida (EOL): Puede configurar manualmente una microaplicación para el fin de la vida. El conmutador EOL se encuentra al hacer clic para modificar la microaplicación y elegir Propiedades.

Actualizar versión de una integración

Para actualizar la versión de una integración, siga estos pasos:

1. Abra la consola de administración de microaplicaciones y haga clic en Actualizar integración en la parte superior.
2. Seleccione el tipo de integración que quiere agregar.
3. Arrastre el archivo MAPP de integración o elija Examinar para seleccionar el archivo en una ubicación específica.
4. Si se seleccionó un archivo incorrecto, puede quitarlo haciendo clic en el enlace correspondiente. De lo contrario, haga clic en Actualizar.
5. La integración se muestra junto con todas las demás integraciones en la consola de administración.

Consideraciones sobre la integración de actualizaciones

• Solo se admiten integraciones HTTP.
• Las estructuras de datos aceptadas incluyen nuevas tablas, nuevas columnas en tablas existentes y nuevas relaciones. No se permiten modificaciones para:
  • Tablas (eliminación de una tabla o cambio de nombres de tablas, claves principales).
  • Columnas (eliminación de una columna o cambio de nombres de columna, tipos de datos, claves principales, restricción única, anulable).
  • Relaciones (no es posible eliminar ni cambiar nada).
• Si ya no se necesitan partes de la estructura anterior, puede mantener las estructuras de datos vacías o utilizar scripts para definir valores.
• No se permite la eliminación de acciones de servicio de destino. La validación se aplica a un identificador único universal (UUID) de acción de servicio y a su definición, incluidos parámetros, etc.
  • Si se requieren cambios en las acciones de servicio, debe configurar esas acciones de servicio como nuevas y actualizar cada microaplicación para que llame a la acción de servicio actualizada.

Cuando la actualización de la integración se realiza correctamente, se sustituye por completo lo siguiente:

• Todas las definiciones de dispositivos de punto final de datos y webhooks.
• Acciones de servicio (equivalente a mantener las acciones antiguas al agregar las recién configuradas).
• Todos los scripts preparados como parte de scripts de integración HTTP.

Tras la actualización:

• Se requiere una sincronización completa para almacenar en caché las tablas y columnas recién incluidas. Hasta que se haya sincronizado correctamente, es posible que la aplicación no funcione correctamente (debido a la falta de datos).
• Solo se importan y están disponibles para la actualización de la integración las relaciones, los dispositivos de punto final de datos, los scripts, las acciones de servicio y las entidades de integración (sin propiedades, autorización, etc.).