CoE Manager Plus – Integrieren in ServiceNow

Sie können CoE Manager Plus in ServiceNow integrieren, um Daten zwischen ServiceNow-Datensätzen wie etwa Tickets und Möglichkeiten in CoE Manager Plus zu synchronisieren.

Prozedur

  1. Registrieren Sie in der ServiceNow-Instanz eine neue Anwendung und erzeugen Sie eine Client-ID und einen geheimen Clientschlüssel.
    1. Melden Sie sich bei ServiceNow als Administrator an.
    2. Navigieren Sie zu Alle > System OAuth > Anwendungsregistrierung.
    3. Klicken Sie auf Neu.
      Eine Liste der Optionen wird angezeigt.
    4. Wählen Sie die Option OAuth-API-Endpunkt für externe Clients erstellen aus.
    5. Klicken Sie im Bildschirm Anwendungsregistrierungen auf Neu.
    6. Geben Sie einen Namen für die Anwendung ein. Beispielsweise „CoEMgr“.
    7. Belassen Sie die Standardwerte für die übrigen Felder und klicken Sie auf Senden.
    8. Öffnen Sie die Anwendung und kopieren Sie die Client-ID und den Geheimen Clientschlüssel in die Zwischenablage.
  2. Rufen Sie in der ServiceNow-Instanz Tabelle und Rolle ab.
    1. Melden Sie sich bei ServiceNow als Administrator an.
    2. Navigieren Sie zu Alle > Systemdefinition > Tabellen.
    3. Suchen Sie nach Ihrer Tabelle, indem Sie den Namen in das Bezeichnungsfeld eingeben.
    4. Kicken Sie, um die Tabelle zu öffnen.
    5. Kopieren Sie den Namen der Tabelle aus dem Feld Name in die Zwischenablage.
    6. Scrollen Sie nach unten zur Registerkarte Zugriffssteuerungen und öffnen Sie den Datensatz, indem Sie auf den Namen in der letzten Zeile klicken.
    7. Scrollen Sie nach unten zur Registerkarte Erfordert Rolle und kopieren Sie die Rolle.
  3. Erstellen Sie in der ServiceNow-Instanz einen Nutzer und weisen Sie ihm die Rolle zu.
    1. Melden Sie sich bei ServiceNow als Administrator an.
    2. Navigieren Sie zu Alle > Organisation > Nutzer.
    3. Klicken Sie auf Neu, um einen neuen Nutzer anzulegen.
    4. Geben Sie Nutzer-ID, Vorname und Nachname ein.
    5. Aktivieren Sie die Kontrollkästchen Aktiv und Interner Integrationsnutzer.
    6. Klicken Sie auf Absenden.
      Damit kehren Sie zur vorherigen Seite zurück.
    7. Suchen Sie den soeben erstellten Nutzer und klicken Sie auf den Nutzer, um ihn zu bearbeiten.
    8. Scrollen Sie nach unten zur Registerkarte Rollen und klicken Sie auf Bearbeiten.
    9. Verwenden Sie den Filter und fügen Sie den Namen Ihrer Anwendung hinzu, um die entsprechende Rolle zu finden.
    10. Wählen Sie beide Rollen aus und klicken Sie auf Speichern.
      Sie werden auf die Seite „Nutzer bearbeiten“ weitergeleitet.
    11. Klicken Sie auf Passwort festlegen > Erstellen und kopieren Sie das erstellte Passwort in die Zwischenablage.
    12. Klicken Sie auf Passwort speichern.
    13. Klicken Sie auf der Seite Nutzer bearbeiten auf Aktualisieren.
  4. Fügen Sie in der CoE Manager Plus-Instanz die ServiceNow-Integration hinzu.
    1. Melden Sie sich als Administrator an.
    2. Navigieren Sie zu der Registerkarte Admin – Technik.
    3. Klicken Sie auf Schaltfläche Automatisierungsintegration hinzufügen.
    4. Geben Sie einen geeigneten Namen ein.
    5. Wählen Sie ServiceNow aus dem Anbieter-Dropdown-Menü aus.
    6. Geben Sie die URL der ServiceNow-Instanz ein und klicken Sie auf Erstellen.
    7. Öffnen Sie die erstellte ServiceNow-Integration und klicken Sie auf Bearbeiten.
    8. Geben Sie die in die Zwischenablage kopierten Konfigurationseinstellungen ein: Anbieter-URL, Client-ID, geheimer Clientschlüssel und ServiceNow-Nutzername, Passwort und Tabellenname.
    9. Geben Sie die Feldzuordnungsattribute für ServiceNow -> CoE Manager und CoE Manager -> ServiceNow im JSON-Format ein. Legen Sie zuerst den API-Namen des Shibumi-Attributs fest, gefolgt vom ServiceNow-Feldnamen. Siehe Beispiel unten.
      ServiceNow -> CoE Manager-Feldzuordnung CoE Manager -> ServiceNow-Feldzuordnung 
      {
"description":"idea_description",
"name":"idea_name"
}
      		 
      {
"Total_Savings_c":"expected_savings",
"Stage_c":"opportunity_status"
}

      Die beiden Feldzuordnungsattribute ermöglichen die Weitergabe der Daten von CoE Manager nach ServiceNow und umgekehrt. Sie können die zuzuordnenden Attribute auf der Seite Möglichkeit > Details > Attribute in CoE Manager Plus überprüfen. Um die Attribute in ServiceNow zu überprüfen, navigieren Sie auf ähnliche Weise zu Alle > Explorer > Rest API Explorer. Verwenden Sie die API-Methode „Get“, um die Attribute im Antworttext zu sehen.

    10. Klicken Sie auf Speichern.
    11. ServiceNow wird jetzt Ihrem Menü Möglichkeit hinzugefügt.
  5. Erstellen Sie eine Geschäftsregel in ServiceNow.
    1. Melden Sie sich bei ServiceNow als Administrator an.
    2. Navigieren Sie zu Alle > Systemdefinition > Geschäftsregel > Neu.
    3. Geben Sie den Namen der Geschäftsregel ein.
    4. Wählen Sie die Tabelle aus der Dropdown-Liste aus.
    5. Aktivieren Sie die Kontrollkästchen Aktiv und Erweitert.
    6. Gehen Sie zur Registerkarte Wann ausführen und wählen Sie die Option asynchron in der Dropdown-Liste Wann aus.
    7. Aktivieren Sie das Kontrollkästchen Einfügen.
    8. Gehen Sie zur Registerkarte Erweitert und fügen Sie das unten angegebene Skript ein: 
      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);

      Wenn eine neue ServiceNow-Idee erstellt wird, wird dieses Skript ausgeführt und eine Möglichkeit in CoE Manager Plus erstellt.

      Aktualisieren Sie die folgenden Felder im Skript mit den Angaben aus der Tabelle Admin – Erweitert.
      Variablen in JS Wert gefunden in CoE Manager Variable in CoE Manager
      k Registerkarte „Admin – Erweitert“ API-GUID
      entId Registerkarte „Admin – Erweitert“ Unternehmens-ID
      App Registerkarte „Admin – Erweitert“ App
      parentId Workstream-ID, Info-Abschnitt unter Workstream. ID
  6. Verknüpfen Sie die ServiceNow-Idee mit der Möglichkeit in CoE Manager Plus.
    1. Kopieren Sie in Ihrer ServiceNow-Instanz die Nummer, die der Idee entspricht, in die Zwischenablage.
    2. Navigieren Sie in der CoE Manager Plus-Instanz zur Registerkarte ServiceNow in Ihrer Möglichkeit.
    3. Klicken Sie auf CoEM-Möglichkeit aktualisieren oder ServiceNow-Datensatz aktualisieren.
    4. Klicken Sie auf das Symbol „Aktualisieren“.
      Die Daten aus dem ServiceNow-Datensatz werden jetzt in der Möglichkeit in CoE Manager Plus aktualisiert. Sie können den gesamten Prüfungsverlauf auf der Seite Möglichkeit > Verlauf einsehen.
      Anmerkung: Die Basisfunktionalität wird als Teil von CoE Manager Plus bereitgestellt. Sie können weitere Anpassungen vornehmen, um noch andere Funktionen hinzuzufügen.