Exporter et importer des intégrations et des micro-apps

Vous pouvez exporter et importer vos intégrations et vos micro-apps en suivant les procédures suivantes. Chaque importation et exportation ne prend en charge qu’une seule intégration (sans micro-app) et une seule micro-app à la fois.

Pour mettre à jour une intégration complète, y compris les micro-apps associées, sur un nouvel environnement, procédez comme suit :

  1. Exportez la configuration d’intégration source (uniquement nécessaire si des modifications ont été apportées à l’intégration cible).
  2. Exportez les micro-apps source.
  3. Importez la configuration d’intégration source dans l’environnement cible en tant que nouvelle intégration.
  4. Importez les micro-apps source dans la nouvelle intégration.
  5. Ajoutez les informations d’identification manquantes à la nouvelle intégration.
  6. Ajoutez des abonnés aux nouvelles micro-apps.
  7. Supprimez l’intégration d’origine dans l’environnement cible.

Impact connu de la mise à jour de la configuration d’une intégration ou d’une micro-app

Veuillez prendre en compte les problèmes suivants avant de terminer votre workflow d’exportation/importation :

  • Les fiches de flux déjà générées sont supprimées lorsque la micro-app d’origine est supprimée.
  • De nouvelles fiches de flux et notifications push sont générées à partir de la synchronisation complète de la nouvelle intégration.
  • Les actions préférées de l’utilisateur sont perdues car les micro-apps qui viennent d’être importées se comportent comme de nouvelles micro-apps.

Importer une nouvelle version de la micro-app avec une intégration inchangée

  1. Exportez les micro-apps source.
  2. Importez les micro-apps source dans la nouvelle intégration.
  3. Ajoutez des abonnés aux nouvelles micro-apps.
  4. Supprimez la micro-app d’origine dans l’environnement cible.

Exporter une intégration

  1. Exportez une configuration d’intégration à l’aide de l’option de menu contextuel Exporter la configuration d’intégration associée à une intégration dans la liste des micro-apps de la console d’administration de micro-apps.

    Le fichier de configuration d’intégration pour l’intégration sélectionnée est exporté au format de fichier .mapp vers votre machine locale.

    Les fichiers de configuration contiennent les entités suivantes :

    • Configuration (sans mot de passe et clé secrète client)
    • Configuration de la synchronisation
    • Résolveurs d’assistant virtuel
    • Pour une intégration HTTP :
      • Points de terminaison de données (y compris les points de terminaison enfants de chaîne)
      • Relations
      • Actions de service
    • Aucune micro-app n’est exportée.

Importer une intégration

  1. Importez une configuration d’intégration à l’aide de l’option Importer la configuration d’intégration.
  2. Limitations liées à l’importation.
    1. L’intégration est toujours exportée sans clé secrète client. Par conséquent, celle-ci doit être renseignée après l’importation. Si cette action n’est pas effectuée, l’intégration ne fonctionnera pas correctement (pas de mise en cache, pas d’actions possibles).
  3. État de l’intégration après l’importation
    1. État « Mot de passe requis » :
      1. Aucune synchronisation n’est effectuée tant que les informations d’identification ne sont pas saisies manuellement.
      2. La réauthentification OAuth est nécessaire si OAuth est défini comme méthode d’authentification. Une réauthentification est nécessaire pour obtenir des jetons mis à jour à partir du système d’enregistrement.
      3. Pour ajouter les informations d’identification, accédez au menu contextuel Gérer > Intégration > Modifier > Propriétés et renseignez le mot de passe/la clé secrète client manquant(e) ou réauthentifiez OAuth.
    2. Aucune micro-app n’est présente (seule l’intégration est importée).

Exporter une micro-app

  1. Exportez une micro-app à l’aide de l’option de menu contextuel Exporter une micro-app associée à une micro-app dans la liste des micro-apps de la console.
  2. Un fichier .mapp contenant la définition de la micro-app est téléchargé.
  3. Éléments exportés :
    • Un fichier .mapp définissant une micro-app contenant les éléments suivants :
      • Propriétés (nom de la micro-app, description, icône, action, page d’action)
      • Notifications (déclencheur, conditions, contenu de la notification, conditions d’expiration)
      • Pages (nom, propriétés, tous les composants avec leurs propriétés, y compris les actions appelées)
      • Identification de l’intégration de micro-app (une structure de mappage des composants de la micro-app à la couche de cache de données d’intégration ; doit correspondre correctement à la nouvelle intégration).
    • Aucun paramètre d’abonnement n’est exporté.

Importer une micro-app

  1. Prérequis : une intégration a été importée dans l’environnement cible ou l’intégration existe dans l’environnement cible.
  2. Importez une micro-app à l’aide de l’option de menu contextuel Importer une micro-app associée à une intégration dans la liste des micro-apps de la console d’administration de micro-apps.
    1. Faites glisser le fichier dans le panneau ou choisissez le fichier à partir de votre système de fichiers et téléchargez-le.
  3. Limitations liées à l’importation :
    1. Une micro-app doit être importée dans la même intégration.
      1. Il doit s’agir du même type d’intégration (soit une des intégrations de modèles, ServiceNow, Concur, etc. ou une intégration HTTP personnalisée).
        1. Même si la structure de données sous-jacente correspond pour l’intégration source et cible, le processus d’importation de micro-app n’est pas en mesure de faire correspondre la structure de données de la micro-app à un autre type d’intégration.
      2. Structure de base de données correspondante : si certains tableaux mis en cache sont absents dans l’intégration cible (schéma différent), la micro-app importée sera configurée incorrectement.
        1. Pour éviter toute erreur de configuration, assurez-vous que le schéma des intégrations source et cible correspond ; dans le menu contextuel de l’intégration accédez à Modifier > Tableaux > Modifier le schéma.
    2. La micro-app doit être créée dans une seule intégration.
      1. La micro-app ne peut pas appeler une action (sur une pile d’actions de bouton) à partir d’une intégration différente de celle sur laquelle elle est basée.
      2. La micro-app ne peut pas accéder à une page à partir d’une intégration différente, par exemple avec l’action « Aller à la page » dans la pile d’actions de bouton (à partir de la notification et du bouton de page).
      3. La micro-app ne peut pas avoir une page ou une notification créée au-dessus d’un tableau à partir d’une autre intégration (lors de la création d’une page, un tableau de la même intégration doit être utilisé pour que l’importation soit effectuée correctement).

État de l’intégration après l’importation

  • La micro-app n’a pas d’abonnés. Les abonnés doivent être recréés manuellement.
  • Aucune notification générée : les notifications sont générées automatiquement en fonction des préférences de déclenchement de notification (généralement après la prochaine synchronisation).