BMC Helix ITSM-Verbindung in Jitterbit Studio
Einführung
Eine BMC Helix ITSM-Verbindung, die mit dem BMC Helix ITSM-Connector erstellt wurde, ermöglicht den Zugriff auf BMC Helix ITSM. Sobald eine Verbindung konfiguriert ist, können Instanzen von BMC Helix ITSM-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder als Ziele (zum Konsumieren von Daten in einem Vorgang) verwendet zu werden.
Erstellen oder Bearbeiten einer BMC Helix ITSM-Verbindung
Eine neue BMC Helix ITSM-Verbindung wird mit dem BMC Helix ITSM-Connector aus einem dieser Standorte erstellt:
- Die Registerkarte Projektendpunkte und -connectoren der Designkomponentenpalette (siehe Designkomponentenpalette).
- Die Seite Globale Endpunkte (siehe Einen globalen Endpunkt erstellen in Globale Endpunkte).
Eine vorhandene BMC Helix ITSM-Verbindung kann von diesen Standorten bearbeitet werden:
- Die Registerkarte Projektendpunkte und -connectoren der Designkomponentenpalette (siehe Designkomponentenpalette).
- Die Registerkarte Komponenten im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Registerkarte).
- Die Seite Globale Endpunkte (siehe Einen globalen Endpunkt bearbeiten in Globale Endpunkte).
Konfigurieren einer BMC Helix ITSM-Verbindung
Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die BMC Helix ITSM-Verbindung wird im Folgenden beschrieben.
Die in der Konfiguration der BMC Helix ITSM-Verbindung verwendete Schnittstelle hängt von der ausgewählten Option Authentifizierungsmechanismus ab, entweder Credential-based Auth oder OAuth:
-
Credential-basierte Authentifizierung: Bei dieser Option wird die Verbindung mit einem Benutzernamen und Passwort oder einer 2-beinigen OAuth 2.0-Authentifizierung authentifiziert.
-
OAuth: Bei dieser Option wird die Verbindung über BMC Helix ITSM in einem separaten Browser-Tab authentifiziert (3-beinige OAuth). Nach der Authentifizierung erteilen Sie die Zustimmung, dass Harmony auf die BMC Helix ITSM-App zugreifen kann. Diese Option erfordert die Verwendung einer privaten Agentenversion 10.83 / 11.21 oder höher.
Hinweis
Credential-basierte Authentifizierung muss für einen globalen Endpunkt verwendet werden.
Credential-basierte Authentifizierung
Wenn Credential-basierte Authentifizierung als Authentifizierungsmechanismus ausgewählt wird, wird die unten beschriebene Schnittstelle angezeigt.
Tipp
Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.
-
Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede BMC Helix ITSM-Verbindung eindeutig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. Dieser Name wird auch verwendet, um den BMC Helix ITSM-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht. -
Authentifizierungsmechanismus: Wählen Sie Credential-basierte Authentifizierung, um sich mit einem Benutzernamen und Passwort oder einer 2-beinigen OAuth 2.0-Authentifizierung (siehe unten) zu authentifizieren.
-
Host-URL: Geben Sie die Host-URL von BMC Helix ITSM ein.
-
Proxy pro Endpunkt verwenden: Bei Verwendung eines privaten Agenten kann diese Einstellung ausgewählt werden, um private Agenten-Proxy-Einstellungen zu verwenden.
-
oAuth-Authentifizierung: Dieses Kontrollkästchen steuert, ob die grundlegende Authentifizierung oder die 2-beinige OAuth 2.0-Authentifizierung verwendet werden soll.
Wenn das Kontrollkästchen oAuth-Authentifizierung nicht ausgewählt ist (Standard), sind diese Felder aktiviert und werden für die Basis-Authentifizierung verwendet:
-
Benutzername: Geben Sie den BMC Helix ITSM-Benutzernamen ein.
-
Passwort: Geben Sie das BMC Helix ITSM-Passwort ein.
Wenn das Kontrollkästchen oAuth-Authentifizierung ausgewählt ist, sind diese Felder aktiviert und werden für die OAuth 2.0-Authentifizierung verwendet:
-
RSSO-Host: Geben Sie Ihre BMC Helix Single Sign-On-URL ein (bereitgestellt vom BMC SaaS Operations-Team).
-
Client-ID: Geben Sie die Client-ID für die BMC Helix Single Sign-On-URL ein (bereitgestellt vom BMC SaaS Operations-Team).
-
Client-Geheimnis: Geben Sie das Client-Geheimnis für die BMC Helix Single Sign-On-URL ein (bereitgestellt vom BMC SaaS Operations-Team).
-
Aktualisierungstoken: Geben Sie das Aktualisierungstoken ein, das während der Token-Generierung erhalten wurde, wie in den BMC Helix ITSM-Voraussetzungen beschrieben.
-
Bearer-Token: Geben Sie das Bearer-Token ein, das während der Token-Generierung erhalten wurde, wie in den BMC Helix ITSM-Voraussetzungen beschrieben.
-
Erstellungszeit des Bearer (Millisekunden): Geben Sie die Erstellungszeit des Bearer ein, die während der Token-Generierung erhalten wurde, wie in den BMC Helix ITSM-Voraussetzungen beschrieben.
-
Läuft ab in (Sekunden): Geben Sie den
expires_in-Wert ein, der während der Token-Generierung erhalten wurde, wie in den BMC Helix ITSM-Voraussetzungen beschrieben.Wichtig
Kontaktieren Sie das BMC SaaS Operations-Team, um die Ablaufzeit des Bearer-Tokens zu verlängern.
-
-
Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie "Automatische Connector-Aktualisierung deaktivieren".
-
Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.
-
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.
-
Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.
OAuth
Wenn OAuth als Authentifizierungsmechanismus ausgewählt ist, wird die unten beschriebene Schnittstelle angezeigt. Für wichtige Hinweise zum Verhalten von Zugriffstoken und Aktualisierungstoken siehe Wichtige Hinweise.
Hinweis
Felder mit einem Variablen-Icon unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Variablen-Icon klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.
-
Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede BMC Helix ITSM-Verbindung einzigartig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. Dieser Name wird auch verwendet, um den BMC Helix ITSM-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht. -
Authentifizierungsmechanismus: Wählen Sie OAuth, um sich durch die Bereitstellung von Zustimmung über BMC Helix ITSM in einem separaten Browser-Tab zu authentifizieren (3-beinige OAuth). Diese Option erfordert die Verwendung einer privaten Agentenversion 10.83 / 11.21 oder höher.
-
Host-URL: Geben Sie die Host-URL von BMC Helix ITSM ein.
-
Proxy pro Endpunkt verwenden: Bei Verwendung eines privaten Agents kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agents zu verwenden.
-
OAuth-Anwendung: Verwenden Sie das Menü, um eine in der Management-Konsole konfigurierte private Anwendung des BMC Helix ITSM-Connectors auszuwählen, die auf der Seite App-Registrierungen zu finden ist.
Wenn keine private Anwendung für diesen Connector registriert wurde, bleibt das Menü leer und die Fehlermeldung
Keine App-Registrierungen für BMC Helix ITSM gefundenwird angezeigt. Weitere Informationen zur Konfiguration einer privaten BMC Helix ITSM-Anwendung finden Sie unter 3-beinige OAuth konfigurieren in Voraussetzungen. -
Mit ITSM anmelden: Klicken Sie, um sich über BMC Helix ITSM in einem separaten Browser-Tab zu authentifizieren und Jitterbit die Zustimmung zu erteilen, auf die BMC Helix ITSM-App zuzugreifen.
-
Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie Automatische Connector-Aktualisierung deaktivieren.
-
Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.
-
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
-
Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.
Nächste Schritte
Nachdem eine Verbindung zu BMC Helix ITSM hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfskanvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.
Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.
Diese Aktivitätstypen sind verfügbar:
-
Arbeitsauftrag: Erstellt, fragt oder aktualisiert Arbeitsauftragsdaten in BMC Helix ITSM und kann als Quelle oder Ziel in einem Vorgang verwendet werden.
-
Abfrage: Fragt Formulare in BMC Helix ITSM ab und ist dafür gedacht, als Quelle in einem Vorgang verwendet zu werden.
-
Zusammenführen: Führt Formulardaten in BMC Helix ITSM zusammen und ist dafür gedacht, als Ziel in einem Vorgang verwendet zu werden.
-
Erstellen: Erstellt ein BMC-Formular (einschließlich Anhänge) in BMC Helix ITSM und ist dafür gedacht, als Ziel in einem Vorgang verwendet zu werden.
-
Aktualisieren: Aktualisiert Formulare in BMC Helix ITSM und ist dafür gedacht, als Ziel in einem Vorgang verwendet zu werden.
-
Vorfallmanagement: Erstellt, fragt oder aktualisiert Vorfalldaten in BMC Helix ITSM und kann als Quelle oder Ziel in einem Vorgang verwendet werden.
-
Löschen: Löscht Formulare aus BMC Helix ITSM und ist dafür gedacht, als Ziel in einem Vorgang verwendet zu werden.
-
Änderungsmanagement: Erstellt, fragt oder aktualisiert Änderungsdatensätze in BMC Helix ITSM und kann als Quelle oder Ziel in einem Vorgang verwendet werden.
-
Bekannter Fehler: Erstellt, fragt ab oder aktualisiert bekannte Fehlermeldungsdaten in BMC Helix ITSM und kann als Quelle oder Ziel in einem Vorgang verwendet werden.
-
Problemmanagement: Erstellt, fragt ab oder aktualisiert Problemdaten in BMC Helix ITSM und kann als Ziel in einem Vorgang verwendet werden.