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

Dieser Connector unterstützt die Re-Authentifizierung bei Änderung Organisationsrichtlinie. 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.

Hinweis

Felder mit einem Symbol für Variablen 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 Symbol für Variablen 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 eindeutig 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 bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

  • 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 unverändert. 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-Factor Authentication for 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.

    Vorsicht

    Ein Salesforce-Passwort, das erweiterte ASCII-Zeichen wie £ verwendet, kann beim Abrufen von Daten während der Aktivitätskonfiguration den folgenden Fehler verursachen:

    Ungültiger Benutzername, Passwort, Sicherheitstoken; oder Benutzer gesperrt. [INVALID_LOGIN]

    In diesem Fall kann der Verbindungstest dennoch erfolgreich sein. Wenn Sie diesen Fehler während der Aktivitätskonfiguration erhalten und Sonderzeichen im Passwort verwenden, versuchen Sie, das Passwort zu ändern.

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

  • 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 fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungsconfiguration 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.

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 Sie eine ServiceMax-Verbindung konfiguriert haben, können Sie eine oder mehrere ServiceMax-Aktivitäten konfigurieren, die mit dieser Verbindung verknüpft sind, um sie entweder als Quelle zur Bereitstellung von Daten für einen Vorgang oder als Ziel zur Verwendung von Daten in einem Vorgang zu nutzen, oder Sie können die ServiceMax-Verbindung in einem Skript verwenden.

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: Abfragen von Daten aus ServiceMax und als Quelle gedacht, um Daten in einer Operation bereitzustellen.

  • Einfügen: Fügt neue Daten in ServiceMax ein und ist als Ziel gedacht, um Daten in einer Operation zu konsumieren.

  • Aktualisieren: Aktualisiert vorhandene Daten in ServiceMax und ist als Ziel gedacht, um Daten in einer Operation zu konsumieren.

  • Upsert: Aktualisiert sowohl vorhandene Daten als auch fügt neue Daten in ServiceMax ein und ist als Ziel gedacht, um Daten in einer Operation zu konsumieren.

  • Löschen: Löscht Daten aus ServiceMax und ist als Ziel gedacht, um Daten in einer Operation zu konsumieren.

  • Bulk-Abfrage: Abfragen einer großen Anzahl von Datensätzen aus ServiceMax und als Quelle gedacht, um Daten in einer Operation bereitzustellen.

  • Bulk-Einfügen: Fügt eine große Anzahl neuer Datensätze in ServiceMax ein und ist als Ziel gedacht, um Daten in einer Operation zu konsumieren.

  • Bulk-Aktualisieren: Aktualisiert eine große Anzahl vorhandener Datensätze in ServiceMax und ist als Ziel gedacht, um Daten in einer Operation zu konsumieren.

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

  • Bulk Delete: Löscht eine große Anzahl von Datensätzen aus ServiceMax und ist dafür gedacht, als Ziel verwendet zu werden, 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 dafür gedacht, als Ziel verwendet zu werden, 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.