CoE Manager Plus - Intégration à ServiceNow

Vous pouvez intégrer CoE Manager Plus à ServiceNow pour synchroniser les données entre les enregistrements ServiceNow tels que les tickets et les opportunités CoE Manager Plus.

Procédure

  1. Dans l'instance ServiceNow, enregistrez une nouvelle application et générez l'ID client et le secret du client.
    1. Connectez-vous à la ServiceNow en tant qu'administrateur.
    2. Accédez à Tout > OAuth système > Registre d'application.
    3. Cliquez sur Nouveau.
      Une liste d'options s'affiche.
    4. Sélectionnez Création d'un point de terminaison API OAuth pour les clients externes.
    5. Dans l'écran Registres d'application, cliquez sur Nouveau.
    6. Donnez un nom à votre application. Par exemple, CoEMgr.
    7. Laissez les valeurs par défaut dans les autres champs et cliquez sur Soumettre.
    8. Ouvrez l'application et copiez l'ID Client et le Secret du Client dans le Presse-papiers.
  2. Dans l'instance ServiceNow, obtenez le tableau et le rôle.
    1. Connectez-vous à la ServiceNow en tant qu'administrateur.
    2. Accédez à Tout > Définition du système > Tableaux.
    3. Recherchez votre tableau en indiquant son nom dans le champ Étiquette.
    4. Cliquez pour ouvrir le tableau.
    5. Copiez le Nom du tableau dans le Presse-papiers.
    6. Faites défiler l'écran vers le bas jusqu'à l'onglet Contrôles d'accès, puis ouvrez l'enregistrement en cliquant sur le Nom dans la dernière ligne.
    7. Faites défiler l'écran vers le bas jusqu'à l'onglet Rôle requis et copiez le Rôle.
  3. Dans l'instance ServiceNow, créez un utilisateur et attribuez-lui un rôle.
    1. Connectez-vous à la ServiceNow en tant qu'administrateur.
    2. Accédez à Tout > Organisation > Utilisateurs.
    3. Cliquez sur Nouveau pour créer un nouvel utilisateur.
    4. Entrez l'ID d'utilisateur, le Prénom et le Nom.
    5. Cochez les cases Actif et Utilisateur d'intégration interne.
    6. Cliquez sur Soumettre.
      Vous revenez à la page précédente.
    7. Recherchez l'utilisateur que vous venez de créer et cliquez dessus pour le modifier.
    8. Faites défiler l'écran vers le bas jusqu'à l'onglet Rôles et cliquez sur Modifier.
    9. Utilisez le filtre et ajoutez le nom de votre application pour trouver le rôle approprié.
    10. Sélectionnez les deux rôles et cliquez sur Enregistrer.
      Vous êtes redirigé vers la page de modification de l'utilisateur.
    11. Cliquez sur Définir le mot de passe > Générer et copiez le mot de passe généré dans le Presse-papiers.
    12. Cliquez sur Enregistrer le mot de passe.
    13. Dans la page Modifier l'utilisateur, cliquez sur Mettre à jour.
  4. Dans l'instance CoE Manager Plus, ajoutez une intégration ServiceNow.
    1. Connectez-vous en tant qu'administrateur.
    2. Accédez à l'onglet Admin-Tech.
    3. Cliquez sur Ajouter une intégration d'automatisation.
    4. Entrez un nom approprié.
    5. Sélectionnez ServiceNow dans la liste déroulante Fournisseur.
    6. Entrez l'URL de l'instance ServiceNow et cliquez sur Créer.
    7. Ouvrez l'intégration ServiceNow créée et cliquez sur Modifier.
    8. Entrez les paramètres de configuration copiés dans le Presse-papiers : l'URL du fournisseur, l'ID client, le secret du client ainsi que le nom d'utilisateur, le mot de passe et le nom de tableau ServiceNow.
    9. Entrez les attributs de mappage de champ ServiceNow -> CoE Manager et CoE Manager -> ServiceNow au format JSON. Définissez d'abord le nom de l'API de l'attribut Shibumi, puis le nom du champ ServiceNow. Consultez l'exemple ci-dessous.
      Mappage de champ ServiceNow -> CoE Manager Mappage de champ CoE Manager -> ServiceNow 
      {
"description":"idea_description",
"name":"idea_name"
}
      		 
      {
"Total_Savings_c":"expected_savings",
"Stage_c":"opportunity_status"
}

      Les deux attributs de mappage de champ permettent de transmettre les données de CoE Manager à ServiceNow, et vice versa. Vous pouvez vérifier les attributs à mapper dans la page Opportunité > Détails > Attributs de CoE Manager Plus. De même, pour vérifier les attributs dans ServiceNow, accédez à Tout > Explorateur > Explorateur d'API REST. Utilisez la méthode Obtenir l'API pour afficher les attributs dans le corps de la réponse.

    10. Cliquez sur Enregistrer.
    11. L'onglet ServiceNow est désormais ajouté à votre menu Opportunité.
  5. Créez une règle métier dans ServiceNow.
    1. Connectez-vous à la ServiceNow en tant qu'administrateur.
    2. Accédez à Tout > Définition du système > Règle métier > Nouvelle.
    3. Entrez le nom de la règle métier.
    4. Sélectionnez le tableau dans la liste déroulante.
    5. Cochez les cases Actif et Avancé.
    6. Accédez à l'onglet Quand exécuter et sélectionnez async dans le menu déroulant Quand.
    7. Cochez la case Insérer.
    8. Accédez à l'onglet Avancé et collez le script ci-dessous : 
      function executeRule(current, previous /*null when async*/ ) {
 try {
 var r = new sn_ws.RESTMessageV2();
 r.setEndpoint("https://util.shibumi.com/utilities/integration/service_now/create_shibumi_item_aai");
 r.setHttpMethod("post");
 
 	var k = "18856af6-fda9-41be-93cc-66548179b213"; 
 	var entId = "f79ce11f-bc4c-46e6-8d4a-4652ed132a24";
 		var parentTemplateAPIName ="Workstream__t";
 		var parentId ="1";
 		var templateAPIName = "Opportunity__t";
 		var serviceNowId = current.getValue("number"); 
 		var app = "App_29__app";
 		var snow_unique_id_attribute = "ServiceNow_ID__c";
 
 		var workstream = "Finance"; //current.getValue("business_unit");
 		var name = current.getValue("idea_name");
 		var instanceName = gs.getProperty("instance_name");

 
var body = "k="+k+"&entId="+entId+"&parentTemplateAPIName="+parentTemplateAPIName+"&parentId="+parentId+"&templateAPIName="+templateAPIName+"&serviceNowId="+serviceNowId+"&app="+app+"&snow_unique_id_attribute="+snow_unique_id_attribute+"&serviceNowUrl="+instanceName;

r.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
 //var body = JSON.stringify(obj);
 	gs.info("Webhook body: " + body);
 r.setRequestBody(body);

 		var response = r.execute();
 var httpStatus = response.getStatusCode();
 } catch (ex) {
 var message = ex.message;
       	 gs.error("Error message: " + message);
 }
	
 gs.info("Webhook target HTTP status response: " + httpStatus);

})(current, previous);

      Lorsqu'une nouvelle idée ServiceNow est créée, ce script s'exécute et crée une opportunité dans CoE Manager Plus.

      Mettez à jour les champs suivants dans le script avec les détails fournis dans le tableau Administrateur-Avancé.
      Variables dans JS Valeur trouvée dans CoE Manager Variable dans CoE Manager
      k Onglet Administrateur-Avancé GUID de l'API
      entId Onglet Administrateur-Avancé ID Enterprise
      Application Onglet Administrateur-Avancé App
      parentId ID du flux de travail, section Infos sous Flux de travail. Identifiant
  6. Liez l'idée ServiceNow à l'opportunité dans CoE Manager Plus.
    1. Dans votre instance ServiceNow, copiez le Numéro correspondant à l'idée dans le Presse-papiers.
    2. Dans l'instance CoE Manager Plus, accédez à l'onglet ServiceNow de votre opportunité.
    3. Cliquez sur Mettre à jour l'opportunité CoEM ou sur Mettre à jour l'enregistrement ServiceNow.
    4. Cliquez sur l'icône d'actualisation.
      Les données de l'enregistrement ServiceNow sont maintenant mises à jour dans l'opportunité de CoE Manager Plus. Vous pouvez consulter l'historique complet de l'audit dans la page Opportunité > Historique.
      Remarque : La fonctionnalité de base est fournie dans le cadre de CoE Manager Plus. Vous pouvez la personnaliser davantage pour y ajouter d'autres fonctionnalités.