Zum Inhalt springen

ServiceMax-Verbindung

Einführung

Eine ServiceMax-Verbindung, die mit dem ServiceMax-Connector erstellt wurde, ermöglicht den Zugriff auf ServiceMax. Sobald eine Verbindung konfiguriert ist, können Instanzen von Salesforce-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Hinweis

Die Agent-Version 11.59 (für 11.x-Agenten) oder 12.4 oder höher (für 12.x-Agenten) ist erforderlich, um 2-beinige OAuth 2.0 mit dem ServiceMax-Connector zu verwenden.

Dieser Connector unterstützt die Organisationsrichtlinie Re-Authentifizierung bei Änderung aktivieren. Wenn aktiviert, erfordert eine Änderung des Serverhosts oder Benutzernamens in dieser Verbindung, dass Benutzer das Passwort und das Sicherheitstoken für die Verbindung erneut eingeben.

Erstellen oder Bearbeiten einer ServiceMax-Verbindung

Eine neue ServiceMax-Verbindung wird mit dem ServiceMax-Connector von einem dieser Standorte aus erstellt:

Eine vorhandene ServiceMax-Verbindung kann von diesen Standorten aus bearbeitet werden:

Konfigurieren einer ServiceMax-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die ServiceMax-Verbindung wird im Folgenden beschrieben.

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 ServiceMax-Verbindung zu identifizieren. Der Name muss für jede ServiceMax-Verbindung einzigartig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den ServiceMax-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

  • Authentifizierungstyp: Wählen Sie den Authentifizierungstyp aus, um eine Verbindung zu ServiceMax herzustellen, entweder Basic Auth oder OAuth 2.0 Client Credentials.

    Wählen Sie Basic Auth, um diese Felder anzuzeigen:

    • Server-Host: Geben Sie die URL des Salesforce-Servers ein. Wenn Sie eine Produktionsinstanz verwenden, lassen Sie die Standard-URL als https://login.salesforce.com stehen. 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, bei dem die Multi-Faktor-Authentifizierung (MFA) nicht aktiviert ist, ist erforderlich.

      Um ein Salesforce-Konto ohne MFA zu konfigurieren, stellen Sie sicher, dass das Berechtigungsset, das dem Salesforce-Systemintegrations-Login zugewiesen ist, nicht die Auswahl Multi-Faktor-Authentifizierung für API-Logins enthält. 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.

    • Sicherheitstoken: Geben Sie, falls erforderlich, das mit dem Salesforce-Konto verknüpfte Sicherheitstoken ein. Je nach Ihrer Salesforce-Sicherheitskonfiguration können Sie dieses Feld möglicherweise leeren. Wenden Sie sich an Ihren Salesforce-Administrator. Weitere Informationen finden Sie in der Salesforce-Dokumentation zu Zurücksetzen Ihres Sicherheitstokens.

    Wählen Sie OAuth 2.0-Clientanmeldeinformationen aus, um diese Felder anzuzeigen:

    Weitere Informationen finden Sie in den 2-beinigen OAuth 2.0-Voraussetzungen.

    Hinweis

    Die Agent-Version 11.59 (für 11.x-Agenten) oder 12.4 oder höher (für 12.x-Agenten) ist erforderlich, um 2-beinigen OAuth 2.0 mit dem ServiceMax-Connector zu verwenden.

  • Test: Klicken Sie, um die Verbindung mit den bereitgestellten Anmeldeinformationen zu überprüfen.

  • Ä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

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Designkomponenten-Palette verfügbar. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Nachdem eine ServiceMax-Verbindung konfiguriert wurde, können ein oder mehrere ServiceMax-Aktivitäten, die mit dieser Verbindung verbunden sind, konfiguriert werden, um entweder als Quelle zur Bereitstellung von Daten für eine Operation oder als Ziel zur Nutzung von Daten in einer Operation verwendet zu werden, oder die ServiceMax-Verbindung kann in einem Skript verwendet werden.

Aktivitäten konfigurieren

Es stehen elf Aktivitäten zur Verfügung, fünf Standard- und sechs Bulk-Aktivitäten. Bulk-Aktivitäten sollten nur verwendet werden, wenn keine Transformation erforderlich ist, um Daten vor dem Erreichen des Ziels zu ändern.

  • Abfrage: Abfragt Daten von ServiceMax und ist als Quelle zur Bereitstellung von Daten in einer Operation gedacht.

  • Einfügen: Fügt neue Daten in ServiceMax ein und ist als Ziel zur Nutzung von Daten in einer Operation gedacht.

  • Aktualisieren: Aktualisiert vorhandene Daten in ServiceMax und ist als Ziel zur Nutzung von Daten in einer Operation gedacht.

  • Upsert: Aktualisiert sowohl vorhandene Daten als auch fügt neue Daten in ServiceMax ein und ist als Ziel zur Nutzung von Daten in einer Operation gedacht.

  • Löschen: Löscht Daten aus ServiceMax und ist als Ziel zur Nutzung von Daten in einer Operation gedacht.

  • Bulk-Abfrage: Fragt eine große Anzahl von Datensätzen von ServiceMax ab und ist als Quelle zur Bereitstellung von Daten in einer Operation gedacht.

  • Bulk Insert: Fügt eine große Anzahl neuer Datensätze in ServiceMax ein und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

  • Bulk Update: Aktualisiert eine große Anzahl bestehender Datensätze in ServiceMax und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

  • Bulk Upsert: Aktualisiert sowohl eine große Anzahl bestehender Datensätze als auch fügt eine große Anzahl neuer Datensätze in ServiceMax ein und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren.

  • Bulk Delete: Löscht eine große Anzahl von Datensätzen aus ServiceMax und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren. Gelöschte Datensätze werden im Papierkorb von ServiceMax gespeichert, bevor sie dauerhaft gelöscht werden.

  • Bulk Hard Delete: Löscht dauerhaft eine große Anzahl von Datensätzen aus ServiceMax und ist als Ziel gedacht, um Daten in einem Vorgang zu konsumieren. Hart gelöschte Datensätze werden automatisch für die Löschung berechtigt.

ServiceMax-Verbindungen in Skripten verwenden

ServiceMax-Verbindungen können in einem Skript unter Verwendung von Skriptfunktionen referenziert werden, die ein salesforceOrg als Parameter verwenden. Weitere Informationen finden Sie unter Salesforce-Funktionen verwenden; dieselben Informationen gelten auch für ServiceMax-Verbindungen.