Créer une application de stockage pour une intégration personnalisée

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Publiez votre application d’intégration personnalisée sur le ServiceNow Store pour la rendre disponible à d’autres utilisateurs.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Vous devez effectuer ces étapes afin que votre intégration personnalisée fonctionne correctement lorsque d’autres utilisateurs la téléchargent à partir du ServiceNow Storefichier .

    Procédure

    1. Créez un script correctif dans votre application d’intégration personnalisée.
      Lorsqu’un nouveau profil d’intégration est créé à l’aide de votre application, les flux secondaires et les alias de connexion que vous avez créés sont automatiquement liés au profil via ce script correctif.
      1. Accédez à la Applications système > Studio.
      2. Sélectionnez votre application d’intégration personnalisée.
      3. Sur la page Bienvenue dans Studio, cliquez sur + Créer.
        La boîte de dialogue Créer un fichier d’application s’ouvre.
      4. Dans la boîte de dialogue, recherchez et sélectionnez Script correctif.
      5. Cliquez sur Créer.
      6. Renseignez les champs suivants du formulaire Script correctif.
        Tableau 1. Formulaire Script correctif
        Champ Valeur
        Nom Nom du script correctif. Par exemple, Script correctif d’intégration personnalisée.
        Non téléchargeable Option permettant de créer des enregistrements de mise à jour du client [sys_update_xml] lorsque le script correctif s’exécute. Ne sélectionnez pas cette option.
        Application Votre application d’intégration personnalisée. Ce champ est renseigné automatiquement.
        Avant Option qui vous permet d’exécuter le script correctif avant l’installation ou la mise à niveau de l’application. Ne sélectionnez pas cette option.
        Description Description du script correctif.
      7. Entrez le script suivant dans le champ de Script.
        Pour les flux secondaires et l’alias de connexion, remplacez les ID d’exemple par les ID réels. Vous pouvez trouver l’ID dans l’URL de chaque élément.
        new global.CustomIntegrationProfileUtils().createCustomIntegration({
	name: 'Name', // choose a name for the integration
	downloadSubscriptionSubflow: '3a23e189a1400010fa9bed1383c83d38', //replace example id
	updateActivitySubflow: '77a66d23e5500010fa9bc9581d0c0f47', //replace example id
	reclamationSubflow: 'e62b672e39400010fa9b4845e477fe02', //replace example id
	connectionAlias: '629ad2bfdb1893005963ff041d961971' //replace example id
});
        Remarque :
        L’activité de mise à jour et les flux secondaires de réclamation ne sont pas requis. Si vous n’incluez pas de flux secondaire pour mettre à jour l’activité, l’intégration n’obtient pas l’activité de l’utilisateur, sauf si votre flux secondaire d’abonnement de téléchargement inclut l’activité de l’utilisateur. Si vous n’incluez pas de flux secondaire de réclamation, l’intégration ne peut pas désactiver SaaS les abonnements des utilisateurs.
      8. Cliquez sur Envoyer.
    2. Créez un enregistrement de privilège entre périmètres.
      Cet enregistrement permet au script correctif que vous avez créé d’accéder à l’include de script CustomIntegrationProfileUtils().
      1. Accédez à la Applications système > Accès à l'application entre périmètres.
      2. Cliquez sur Nouveau.
      3. Renseignez les champs du formulaire.
        Tableau 2. Privilège entre périmètres
        Champ Valeur
        Source Scope (Périmètre source)

        Votre application d’intégration personnalisée. Ce champ est renseigné automatiquement.

        Pour sélectionner une autre application, cliquez sur l’icône Paramètres ( icône Paramètres) sur la bannière de votre ServiceNow instance. Dans la boîte de dialogue Paramètres système, sélectionnez l’onglet Développeur , puis choisissez une application dans la liste déroulante Application .
        Périmètre cible Application à partir de laquelle les ressources sont demandées. Cliquez sur l’icône de recherche ( icône Rechercher) pour localiser et sélectionner l’application globale .
        Nom cible Nom de l’include de script. Définissez ce champ sur CustomIntegrationProfileUtils.
        Target Type (Type cible) Type de demande. Sélectionnez Include de script.
        Application Votre application d’intégration personnalisée. Ce champ est renseigné automatiquement.
        Opération Opération que le script effectue sur le périmètre cible. Sélectionnez Exécuter l’API.
        Statut Autorisation pour cet enregistrement de privilège entre périmètres. Sélectionnez Autorisé.
      4. Cliquez sur Envoyer.

    Que faire ensuite

    Avant de publier votre application d’intégration personnalisée sur , ServiceNow Storeassurez-vous que vos actions et flux secondaires sont activés, publiés et enregistrés dans votre application.