Microaplicaciones

Exportar e importar integraciones y microaplicaciones

El servicio de microaplicaciones le permite exportar e importar fácilmente integraciones, microaplicaciones y resoluciones del Asistente de Citrix.

Con la función de exportación puede:

  • Exportar una integración solamente, con todas las microaplicaciones o con una serie de microaplicaciones seleccionadas y las resoluciones del Asistente de Citrix incluidas.
  • Exportar microaplicaciones individualmente desde una integración existente.

Con la función de importación puede:

  • Importar una integración, con todas las microaplicaciones y resoluciones del Asistente de Citrix.
  • 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
  • Resoluciones del Asistente de Citrix
  • Configuración
    • Nombre de la integración
    • Parámetros del conector
      • URL de servicio
    • Autenticación de servicio
      • Nombre de usuario
      • Password
    • Método de autenticación de usuario
    • Otros parámetros
    • Configuración local
    • Captura de 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
  • Resoluciones del Asistente de Citrix
  • 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
    • Captura de registros

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

  • Propiedades
    • Name
    • Descripción
    • Icono
    • Action
    • (Página de acciones)
  • Notificaciones
    • Name
      • 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 desea 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 o las resoluciones del Asistente de Citrix que desea 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 al equipo 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 desea exportar la microaplicación.
  2. Haga clic en el menú de puntos suspensivos de la microaplicación que desea 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 al equipo 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 es el estado de la integración después de la importación? Parámetros de configuración
  • Dependiendo del tipo de integración exportada y de los parámetros configurados, deberá actualizarse la configuración de integración.
  • El estado de integración muestra la advertencia Configuración de autenticación necesaria.
  • 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 desea 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 editar 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 desea 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 desde 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:

  • Agregar las credenciales que faltan a la nueva integración.
  • Agregar 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 desde 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:

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 desea 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:

  • Agregar 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 editar la microaplicación y elegir Propiedades.

Exportar e importar integraciones y microaplicaciones