Exportar e importar integraciones y microaplicaciones

Si desea exportar e importar sus integraciones y microaplicaciones, siga estos procedimientos. Cada proceso de importación y exportación admite una sola integración (sin microaplicaciones) y una sola microaplicación simultáneamente.

Para actualizar una integración completa con microaplicaciones en un nuevo entorno, siga estos pasos:

  1. Exporte la configuración de integración de origen (solo es necesario si se han hecho cambios en la integración de destino).
  2. Exporte las microaplicaciones de origen.
  3. Importe la configuración de integración de origen en el entorno de destino como una nueva integración.
  4. Importe las microaplicaciones de origen en la nueva integración.
  5. Agregue las credenciales que falten a la nueva integración.
  6. Agregue suscriptores a las nuevas microaplicaciones.
  7. Elimine la integración original en el entorno de destino.

Impacto conocido al actualizar una configuración de integración o una microaplicación

Tenga en cuenta los siguientes problemas antes de completar el flujo de trabajo de exportación/importación:

  • Las tarjetas de feeds ya generadas se eliminan al eliminar la microaplicación original.
  • Se generan nuevas tarjetas de feeds y notificaciones push a partir de la sincronización completa de la nueva integración.
  • Las acciones favoritas del usuario se pierden debido a que las microaplicaciones recién importadas se comportan como nuevas.

Importe una nueva versión de la microaplicación con una integración sin cambios

  1. Exporte las microaplicaciones de origen.
  2. Importe las microaplicaciones de origen en la nueva integración.
  3. Agregue suscriptores a las nuevas microaplicaciones.
  4. Elimine la microaplicación original en el entorno de destino.

Exportar una integración

  1. Exporte una configuración de integración mediante la opción de menú contextual Exportar configuración de integración de una integración, en la lista de microaplicaciones del administrador de microaplicaciones.

    El archivo de configuración para la integración se exporta en formato .mapp al equipo local.

    Los archivos de configuración contienen las siguientes entidades:

    • Configuración (sin contraseñas ni secretos de cliente)
    • Configuración de sincronización
    • Resoluciones del Asistente virtual
    • Para una integración HTTP:
      • Dispositivos de punto final de datos (incluidos los dispositivos secundarios encadenados)
      • Relaciones
      • Acciones de servicio
    • No se exporta ninguna microaplicación.

Importar una integración

  1. Para importar una configuración de integración, utilice la opción Importar configuración de integración.
  2. Cuáles son las limitaciones para la importación.
    1. La integración aún se exporta sin secretos de cliente. Por lo tanto, deberán rellenarse después de la importación. Antes de hacer eso, la integración no funcionará correctamente (sin almacenamiento en caché, sin acciones posibles).
  3. Cuál es el estado de la integración después de la importación.
    1. Estado “Se necesitan contraseñas”:
      1. No tiene lugar ninguna sincronización hasta que las credenciales se rellenan manualmente.
      2. La reautenticación de OAuth es necesaria si OAuth está establecido como método de autenticación. La reautenticación es necesaria para obtener tokens actualizados del sistema de registro.
      3. Para rellenar las credenciales, vaya a Administrar > menú contextual de Integración > Modificar > Propiedades y rellene las contraseñas y secretos que faltan y vuelva a autenticar OAuth.
    2. No hay microaplicaciones presentes (solo se importa la integración).

Exportar una microaplicación

  1. Para exportar una microaplicación, utilice la opción de menú contextual Exportar microaplicación de una integración, en la lista de microaplicaciones del administrador de Microaplicaciones.
  2. Se descargará un archivo .mapp con la definición de microaplicación.
  3. Qué se exporta:
    • Un archivo .mapp que define una microaplicación y que contiene lo siguiente:
      • propiedades (nombre de la microaplicación, descripción, icono, acción, página de acciones).
      • notificaciones (desencadenador, condiciones, contenido de la notificación, condiciones de caducidad).
      • páginas (nombre, propiedades, todos los componentes con sus propiedades, incluidas las acciones llamadas).
      • La identificación de la integración de microaplicaciones (una estructura de asignación de componentes de microaplicación a la capa de caché de datos de integración – debe asignarse correctamente a la nueva integración).
    • No se exportan parámetros de suscriptores.

Importar una microaplicación

  1. Requisito previo: Se ha importado una integración al entorno de destino o la integración existe ya en el entorno de destino.
  2. Para importar una microaplicación, utilice la opción de menú contextual Importar microaplicación de una integración, en la lista de microaplicaciones del administrador de Microaplicaciones.
    1. Arrastre al blade o elija el archivo en su sistema de archivos y cárguelo.
  3. Limitaciones de importación:
    1. Una microaplicación debe importarse en la misma integración.
      1. Mismo tipo de integración (ya sea una de las integraciones de OotB (ServiceNow, Concur, etc.) o una integración HTTP personalizada).
        1. Incluso si la estructura de datos subyacente es igual en la integración de origen y destino, la importación de microaplicaciones no puede emparejar la estructura de datos de microaplicaciones con un tipo de integración diferente.
      2. Estructura de base de datos coincidente: Si faltan algunas tablas en caché en la integración de destino (el esquema es diferente), la microaplicación se importa como mal configurada.
        1. Para evitar errores de configuración, asegúrese de que el esquema de las integraciones de origen y destino son iguales, navegue por el menú contextual de integración a Modificar > Tablas > Modificar esquema.
    2. La microaplicación debe estar basada en una única integración.
      1. La microaplicación no puede llamar a una acción (en una pila de acciones de botón) desde una integración diferente de aquella en la que está basada.
      2. La microaplicación no puede ir a una página desde una integración diferente de la acción “Ir a la página” en la pila de acciones de botón (tanto desde la notificación como desde el botón de página).
      3. La microaplicación no puede tener una página o notificación basada en una tabla de una integración diferente (al crear una página, se debe usar una tabla de la misma integración para poder importar).

¿Cuál es el estado de la integración después de la importación?

  • La microaplicación no tiene suscriptores. Los suscriptores deben volver a crearse manualmente.
  • No se genera ninguna notificació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).