ServiceMax-Verbindung
Einführung
Eine ServiceMax-Verbindung, die mit dem ServiceMax-Connector erstellt wird, stellt den Zugriff auf ServiceMax her. Nach der Konfiguration einer Verbindung können Sie Instanzen von Salesforce-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind und entweder als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder als Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden.
Hinweis
Agent-Version 11.59 (für 11.x-Agenten) oder 12.4 oder später (für 12.x-Agenten) ist erforderlich, um 2-legged OAuth 2.0 mit dem ServiceMax-Connector zu verwenden.
Dieser Connector unterstützt die Organisationsrichtlinie Re-Authentifizierung bei Änderung aktivieren. Wenn diese aktiviert ist, erfordert eine Änderung des Server-Hosts oder des Benutzernamens in dieser Verbindung, dass Benutzer das Passwort und das Sicherheits-Token für die Verbindung erneut eingeben.
ServiceMax-Verbindung erstellen oder bearbeiten
Eine neue ServiceMax-Verbindung wird mit dem ServiceMax-Connector von einem dieser Orte aus erstellt:
- Die Registerkarte Projekt-Endpunkte und Connectors der Design-Komponentenpalette (siehe Design-Komponentenpalette).
- Die Seite Globale Endpunkte (siehe Globalen Endpunkt erstellen in Globale Endpunkte).
Eine vorhandene ServiceMax-Verbindung kann von diesen Orten aus bearbeitet werden:
- Die Registerkarte Projekt-Endpunkte und Connectors der Design-Komponentenpalette (siehe Design-Komponentenpalette).
- Die Registerkarte Komponenten des Projektbereichs (siehe Menü „Komponentenaktionen" in Registerkarte „Komponenten" des Projektbereichs).
- Die Seite Globale Endpunkte (siehe Globalen Endpunkt bearbeiten in Globale Endpunkte).
ServiceMax-Verbindung konfigurieren
Nachfolgend wird jedes Element der Benutzeroberfläche des ServiceMax-Verbindungskonfigurationsbildschirms beschrieben.
Tipp
Felder mit einem -Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das -Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.
-
Verbindungsname: Geben Sie einen Namen ein, um die ServiceMax-Verbindung zu identifizieren. Der Name muss für jede ServiceMax-Verbindung eindeutig sein und darf keine Schrägstriche (
/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch zur Identifizierung des ServiceMax-Endpunkts verwendet, der sich auf eine bestimmte Verbindung und ihre Aktivitäten bezieht. -
Authentifizierungstyp: Wählen Sie den Authentifizierungstyp für die Verbindung mit ServiceMax aus, entweder Basis-Authentifizierung oder OAuth 2.0-Client-Anmeldedaten.
Wählen Sie Basis-Authentifizierung, um diese Felder anzuzeigen:
-
Server-Host: Geben Sie die URL des Salesforce-Servers ein. Wenn Sie eine Produktionsinstanz verwenden, behalten Sie die Standard-URL https://login.salesforce.com bei. Wenn Sie eine Sandbox-Instanz verwenden, aktivieren Sie das Kontrollkästchen Sandbox unten.
-
Sandbox: Wenn Sie eine Salesforce-Sandbox-Instanz verwenden, aktivieren Sie dieses Kontrollkästchen, um das Feld Server-Host oben auf https://test.salesforce.com umzuschalten.
-
Benutzername: Geben Sie den Benutzernamen für das Salesforce-Konto ein. Ein Salesforce-Konto ohne aktivierte Multi-Faktor-Authentifizierung (MFA) ist erforderlich.
Um ein Salesforce-Konto ohne MFA zu konfigurieren, stellen Sie sicher, dass das dem Salesforce-Systemintegrations-Login zugewiesene Berechtigungsset nicht die Option Multi-Faktor-Authentifizierung für API-Logins ausgewählt hat. Systemintegrations-Login-Typen sind von der MFA-Anforderung von Salesforce ausgenommen, wie von Salesforce in Ist MFA für meine Integrationsbenutzer erforderlich? in ihrer Dokumentation Salesforce Multi-Factor Authentication FAQ beschrieben.
-
-
Passwort: Geben Sie das Passwort für das Salesforce-Konto ein.
-
Sicherheits-Token: Falls erforderlich, geben Sie das Sicherheits-Token ein, das dem Salesforce-Konto zugeordnet ist. Je nach Ihrer Salesforce-Sicherheitskonfiguration können Sie dieses Feld möglicherweise löschen. Wenden Sie sich an Ihren Salesforce-Administrator. Weitere Informationen finden Sie in der Salesforce-Dokumentation unter Reset Your Security Token.
Wählen Sie OAuth 2.0 Client Credentials aus, um diese Felder anzuzeigen:
-
Instance URL: Geben Sie die Salesforce-Instance-URL ein.
-
Client ID: Geben Sie die Client-ID aus Ihrer konfigurierten Salesforce-App ein.
-
Client Secret: Geben Sie das Client Secret aus Ihrer konfigurierten Salesforce-App ein.
Weitere Informationen finden Sie unter 2-legged OAuth 2.0 – Voraussetzungen.
Hinweis
Für die Verwendung von 2-legged OAuth 2.0 mit dem ServiceMax-Connector ist Agent-Version 11.59 (für 11.x-Agents) oder 12.4 oder später (für 12.x-Agents) erforderlich.
-
Test: Klicken Sie, um die Verbindung mit den angegebenen Anmeldedaten zu überprüfen.
-
Speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.
-
Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder vorhandenen Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
-
Löschen: Nachdem Sie eine vorhandene Verbindungskonfiguration 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 Meldung fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.
Nächste Schritte
Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Designkomponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.
Nach der Konfiguration einer ServiceMax-Verbindung können Sie eine oder mehrere ServiceMax-Aktivitäten konfigurieren, die dieser Verbindung zugeordnet sind. Diese können entweder als Quelle zum Bereitstellen von Daten für einen Vorgang oder als Ziel zum Verarbeiten von Daten in einem Vorgang verwendet werden, oder Sie können die ServiceMax-Verbindung in einem Skript verwenden.
Aktivitäten konfigurieren
Es sind elf Aktivitäten verfügbar: fünf Standard- und sechs Bulk-Aktivitäten. Bulk-Aktivitäten sollten nur verwendet werden, wenn Sie keine Transformation benötigen, um Daten vor dem Erreichen des Ziels zu ändern.
-
Query: Fragt Daten aus ServiceMax ab und ist für die Verwendung als Quelle zum Bereitstellen von Daten in einem Vorgang vorgesehen.
-
Insert: Fügt neue Daten in ServiceMax ein und ist für die Verwendung als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Update: Aktualisiert vorhandene Daten in ServiceMax und ist für die Verwendung als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Upsert: Aktualisiert vorhandene Daten und fügt neue Daten in ServiceMax ein und ist für die Verwendung als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Delete: Löscht Daten aus ServiceMax und ist für die Verwendung als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Bulk Query: Fragt eine große Anzahl von Datensätzen aus ServiceMax ab und soll als Quelle verwendet werden, um Daten in einem Vorgang bereitzustellen.
-
Bulk Insert: Fügt eine große Anzahl neuer Datensätze in ServiceMax ein und soll als Ziel verwendet werden, um Daten in einem Vorgang zu verarbeiten.
-
Bulk Update: Aktualisiert eine große Anzahl vorhandener Datensätze in ServiceMax und soll als Ziel verwendet werden, um Daten in einem Vorgang zu verarbeiten.
-
Bulk Upsert: Aktualisiert eine große Anzahl vorhandener Datensätze und fügt gleichzeitig eine große Anzahl neuer Datensätze in ServiceMax ein. Diese Aktivität soll als Ziel verwendet werden, um Daten in einem Vorgang zu verarbeiten.
-
Bulk Delete: Löscht eine große Anzahl von Datensätzen aus ServiceMax und soll als Ziel verwendet werden, um Daten in einem Vorgang zu verarbeiten. Gelöschte Datensätze werden im ServiceMax-Papierkorb gespeichert, bevor sie endgültig gelöscht werden.
-
Bulk Hard Delete: Löscht eine große Anzahl von Datensätzen endgültig aus ServiceMax und soll als Ziel verwendet werden, um Daten in einem Vorgang zu verarbeiten. Endgültig gelöschte Datensätze werden automatisch zum Löschen freigegeben.
ServiceMax-Verbindungen in Skripten verwenden
ServiceMax-Verbindungen können in einem Skript mithilfe von Skriptfunktionen referenziert werden, die einen salesforceOrg als Parameter verwenden. Weitere Informationen finden Sie unter Salesforce-Funktionen verwenden. Die gleichen Informationen gelten auch für ServiceMax-Verbindungen.