Zum Inhalt springen

ServiceMax-Connector in Jitterbit Studio

Zusammenfassung

Der ServiceMax-Connector stellt Zugriff auf ServiceMax her.

Der ServiceMax-Connector bietet eine Schnittstelle zum Erstellen einer ServiceMax-Verbindung, die Grundlage für die Generierung von ServiceMax-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration über die Verbindung mit ServiceMax.

Man greift auf den ServiceMax-Connector über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Designkomponentenpalette zu (siehe Design component palette).

Hinweis

Die Informationen in Salesforce connector troubleshooting und Salesforce connector how-tos können auch auf den ServiceMax-Connector zutreffen, da dieser auf der Codebasis des Salesforce-Connectors aufgebaut ist.

Tipp

Integration recipes sind für diesen Connector über Jitterbit Marketplace verfügbar.

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer ServiceMax-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einer Operation) oder Ziele (zum Verarbeiten von Daten in einer Operation) dienen sollen.

Zusammen werden eine bestimmte ServiceMax-Verbindung und ihre Aktivitäten als ServiceMax-Endpunkt bezeichnet:

ServiceMax-Aktivitätstypen

Es sind elf Aktivitäten verfügbar, fünf Standard- und sechs Massenaktivitäten. Massenaktivitäten sollten nur verwendet werden, wenn man keine Transformation benötigt, um Daten vor dem Erreichen des Ziels zu ändern.

  • Query: Fragt Daten aus ServiceMax ab und ist als Quelle zum Bereitstellen von Daten in einer Operation vorgesehen.

  • Insert: Fügt neue Daten in ServiceMax ein und ist als Ziel zum Verarbeiten von Daten in einer Operation vorgesehen.

  • Update: Aktualisiert vorhandene Daten in ServiceMax und ist als Ziel zum Verarbeiten von Daten in einer Operation vorgesehen.

  • Upsert: Aktualisiert vorhandene Daten und fügt neue Daten in ServiceMax ein und ist als Ziel zum Verarbeiten von Daten in einer Operation vorgesehen.

  • Delete: Löscht Daten aus ServiceMax und ist als Ziel zum Verarbeiten von Daten in einer Operation vorgesehen.

  • Bulk Query: Fragt eine große Anzahl von Datensätzen aus ServiceMax ab und ist als Quelle zum Bereitstellen von Daten in einer Operation vorgesehen.

  • Bulk Insert: Fügt eine große Anzahl neuer Datensätze in ServiceMax ein und ist als Ziel zum Verarbeiten von Daten in einer Operation vorgesehen.

  • Bulk Update: Aktualisiert eine große Anzahl vorhandener Datensätze in ServiceMax und ist als Ziel zum Verarbeiten von Daten in einer Operation vorgesehen.

  • Bulk Upsert: Aktualisiert eine große Anzahl vorhandener Datensätze und fügt eine große Anzahl neuer Datensätze in ServiceMax ein und ist als Ziel zum Verarbeiten von Daten in einer Operation vorgesehen.

  • Bulk Delete: Löscht eine große Anzahl von Datensätzen aus ServiceMax und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen. 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 aus ServiceMax endgültig und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen. Endgültig gelöschte Datensätze werden automatisch zum Löschen freigegeben.

Dieser Connector ist ein nativer Connector: Seine Updates werden zusammen mit der Studio-Anwendung oder dem Agent veröffentlicht, nicht separat. Siehe Studio-Connector-Updates.

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Der ServiceMax-Connector unterstützt die Verwendung von Harmony Cloud- oder Private Agents ab Version 9.4.2.

Wenn eine ServiceMax-Verbindung mit Standardauthentifizierung konfiguriert wird, ist ein Salesforce-Konto erforderlich, für das die Multi-Faktor-Authentifizierung (MFA) nicht aktiviert ist. Um ein Salesforce-Konto ohne MFA zu konfigurieren, stellen Sie sicher, dass das Permission Set, das dem Salesforce-Systemintegrations-Login zugewiesen ist, nicht die Option Multi-Factor Authentication for API Logins ausgewählt hat. Systemintegrations-Login-Typen sind von der MFA-Anforderung von Salesforce ausgenommen, wie in Is MFA required for my integration users? in der Salesforce-Dokumentation Salesforce Multi-Factor Authentication FAQ beschrieben.

Wenn eine ServiceMax-Verbindung mit 2-legged OAuth 2.0-Authentifizierung konfiguriert wird, finden Sie weitere Informationen unter 2-legged OAuth 2.0-Voraussetzungen. Da der ServiceMax-Connector die gleiche Codebasis wie der Salesforce-Connector nutzt, gelten die gleichen Voraussetzungen.

Hinweis

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

Da ServiceMax die Salesforce-Plattform nutzt, verwendet der ServiceMax-Connector die Salesforce-API.

Die API-Version, die der Connector für Nicht-Bulk-Aktivitäten verwendet, hängt von der Jitterbit-Agent-Version ab:

Jitterbit-Agent-Version Salesforce SOAP API-Version Salesforce-Release
12.4 oder höher (OAuth 2.0) 65.0 Winter '26
12.3 oder höher (Standardauth oder keine Auth)
11.47 bis 11.59 (Standardauth oder keine Auth)		 64.0 Sommer '25
11.41 bis 11.46 63.0 Frühling '25
11.35 bis 11.40 62.0 Winter '25
11.30 bis 11.34 61.0 Sommer '24
11.23 bis 11.29
10.85 bis 10.87		 60.0 Frühling '24
11.18 bis 11.22
10.80 bis 10.84		 59.0 Winter '24
11.11 bis 11.17
10.73 bis 10.79		 58.0 Sommer '23
11.7 bis 11.10
10.69 bis 10.72		 57.0 Frühling '23
11.0 bis 11.6
10.55 bis 10.68		 54.0 Frühling '22
10.44 bis 10.54 52.0 Sommer '21
10.42 bis 10.43 51.0 Herbst '21
10.28 bis 10.41 50.0 Winter '21
10.23 bis 10.27 49.0 Sommer '20
10.17 bis 10.22 48.0 Frühling '20
10.11 bis 10.16 47.0 Winter '20
10.3 bis 10.10 45.0 Frühling '19
9.8 bis 10.2 44.0 Winter '19
9.4.2 bis 9.7 41.0 Winter '18

Die SOAP-basierte Salesforce Bulk API wird für Massenaktivitäten verwendet.

Die Salesforce Bulk API verwendet einen X-SFDC-Session-Header, der mit einer Session-ID gefüllt wird, die über einen Salesforce SOAP API login()-Aufruf für gültige Anfragen abgerufen wird.

Agent-Upgrades, die Salesforce SOAP API-Versionen überspringen, beinhalten implizit Unterstützung für zwischenliegende API-Versionen.

Weitere Informationen zu den Schemafeldern finden Sie in der Dokumentation unter den obigen Links.

Fehlerbehebung

Falls Probleme mit dem ServiceMax-Connector auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Stellen Sie sicher, dass die ServiceMax-Verbindung erfolgreich ist, indem Sie die Schaltfläche Test im Konfigurationsbildschirm verwenden. Wenn die Verbindung nicht erfolgreich ist, kann der zurückgegebene Fehler einen Hinweis auf das Problem geben.

  2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

  3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle für weitere Informationen überprüfen.

  5. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen. Die Informationen zur Fehlerbehebung des Salesforce-Connectors können ebenfalls relevant sein.