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

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 Store.

    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 l’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 de 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 automatiquement renseigné.
        Avant Option vous permettant d’exécuter le script correctif avant d’installer ou de mettre à niveau 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 exemples d’ID 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 :
        Les flux secondaires d’activité de mise à jour et 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é utilisateur, sauf si votre flux secondaire d’abonnement au téléchargement inclut l’activité 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 au script include 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 automatiquement renseigné.

        Pour sélectionner une autre application, cliquez sur l’icône Paramètres ( icône Paramètres) dans la bannière de votre ServiceNow instance. Dans la boîte de dialogue Paramètres du 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 du script include. Définissez ce champ sur CustomIntegrationProfileUtils.
        Target Type (Type cible) Type de demande. Sélectionnez Script Include.
        Application Votre application d’intégration personnalisée. Ce champ est automatiquement renseigné.
        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 actifs, publiés et enregistrés dans votre application.