Zum Inhalt springen

ServiceMax-Connector für Jitterbit Integration 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.

Connector-Übersicht

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) gedacht sind.

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: Abfragen von 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: Abfragen einer großen Anzahl von Datensätzen aus ServiceMax 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 im Papierkorb von ServiceMax gespeichert, bevor sie dauerhaft gelöscht werden.

  • 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. Dauerhaft gelöschte Datensätze werden automatisch für die Löschung berechtigt.

Hinweis

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

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

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

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

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

Jitterbit-Agenten-Version Salesforce SOAP API-Version Salesforce-Version
11.47 oder höher 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-Protokoll 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.