Zum Inhalt springen

ServiceMax-Connector für Jitterbit Studio

Zusammenfassung

Der ServiceMax-Connector ermöglicht den Zugriff auf ServiceMax.

Der ServiceMax-Connector bietet eine Schnittstelle zur Erstellung einer ServiceMax-Verbindung, die als Grundlage für die Generierung von Instanzen von ServiceMax-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit ServiceMax.

Der ServiceMax-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Hinweis

Informationen, die in Salesforce-Connector-Fehlerbehebung und Salesforce-Connector-Anleitungen bereitgestellt werden, können auch für den ServiceMax-Connector gelten, da er aus dem Code-Basis des Salesforce-Connectors erstellt wurde.

Tipp

Integrationsrezepte sind für diesen Connector über den Jitterbit Marketplace verfügbar.

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine ServiceMax-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden sollen.

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

ServiceMax-Aktivitätstypen

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 aus ServiceMax und ist als Quelle gedacht, um Daten in einem Vorgang bereitzustellen.

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

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

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

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

  • Bulk-Abfrage: Fragt eine große Anzahl von Datensätzen aus ServiceMax ab und ist als Quelle gedacht, um Daten in einem Vorgang bereitzustellen.

  • Bulk-Einfügen: 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-Aktualisieren: Aktualisiert eine große Anzahl vorhandener Datensätze in ServiceMax und ist als Ziel gedacht, um Daten in einem Vorgang 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 einem Vorgang zu konsumieren.

  • Bulk-Löschen: 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 vor der endgültigen Löschung im Papierkorb von ServiceMax gespeichert.

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

Hinweis

Dieser Connector ist ein nativer Studio-Connector, auf den Jitterbit möglicherweise verweist, wenn Änderungen an Connectors kommuniziert werden. Der Veröffentlichungszeitplan für native Studio-Connectoren basiert auf dem Rhythmus der Webanwendungen des Harmony-Portals.

Endpunkte, die mit diesem Connector erstellt wurden, sind in der Endpunktnutzungsberichterstattung enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Der ServiceMax-Connector unterstützt die Verwendung von Harmony-Cloud- oder privaten Agenten, die Version 9.4.2 oder höher sind.

Wenn Sie eine ServiceMax-Verbindung mit grundlegender Authentifizierung konfigurieren, ist ein Salesforce-Konto erforderlich, das keine Multi-Faktor-Authentifizierung (MFA) aktiviert hat. 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 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.

Wenn Sie eine ServiceMax-Verbindung mit 2-beiniger OAuth 2.0-Authentifizierung konfigurieren, beachten Sie die Voraussetzungen für 2-beinige OAuth 2.0 für weitere Informationen. Da der ServiceMax-Connector denselben Code-Basis wie der Salesforce-Connector teilt, gelten die gleichen Voraussetzungen.

Hinweis

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.

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-Version
12.4 oder höher (OAuth 2.0) 65.0 Winter '26
12.3 oder höher (Basic oder keine Authentifizierung)
11.47 bis 11.59 (Basic oder keine Authentifizierung)		 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 auf SOAP basierende Salesforce Bulk API wird für Bulk-Aktivitäten verwendet.

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

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

Bitte beziehen Sie sich auf die in den obigen Links bereitgestellte Dokumentation für Informationen zu den Schemafeldern.

Fehlerbehebung

Wenn Sie Probleme mit dem ServiceMax-Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

  1. Stellen Sie sicher, dass die ServiceMax-Verbindung erfolgreich ist, indem Sie die Test-Schaltfläche 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 Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.

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

  4. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle auf weitere Informationen überprüfen.

  5. Für zusätzliche Überlegungen zur Fehlerbehebung siehe Fehlerbehebung bei Vorgängen. Die Fehlerbehebungsinformationen für den Salesforce-Connector können ebenfalls zutreffen.