ServiceMax Upsert-Aktivität

Einführung

Eine ServiceMax Upsert-Aktivität aktualisiert vorhandene Daten und fügt neue Daten in einen ServiceMax Endpoint ein und soll als Ziel zum Verbrauchen von Daten in einem Operation verwendet werden. Nachdem Sie eine ServiceMax-Verbindung konfiguriert haben, können Sie für jede ServiceMax Verbindung beliebig viele ServiceMax-Aktivitäten konfigurieren.

Die Upsert-Aktivität erfordert die Verwendung eines externen ID-Felds, um (1) Datensätze einzufügen, wenn sie noch nicht vorhanden sind, und (2) Datensätze zu aktualisieren, wenn sie bereits vorhanden sind. Informationen zum Erstellen eines externen ID-Felds in ServiceMax finden Sie unter Erstellen eines benutzerdefinierten ServiceMax Felds/einer externen ID für Jitterbit in ServiceMax. Wenn Sie stattdessen nur neue Datensätze einfügen oder vorhandene Datensätze basierend auf der ID des Objekts in ServiceMax aktualisieren möchten, verwenden Sie eine ServiceMax Einfüge- oder Aktualisierungsaktivität.

Wenn während der Verarbeitung von Datensätzen für eine Upsert-Aktivität ein Datensatz fehlschlägt, werden keine weiteren Änderungen verarbeitet und alle zuvor verarbeiteten Änderungen werden zurückgesetzt. Wenn Sie möchten, dass die Verarbeitung fortgesetzt wird, wenn ein Datensatz fehlschlägt, sollten Sie eine ServiceMax Bulk Upsert-Aktivität verwenden.

Erstellen einer ServiceMax Aktivität

Aus einer Verbindung wird mithilfe eines Aktivitätstyps eine Instanz einer Aktivität erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Aktivität kann von diesen Orten aus bearbeitet werden:

• Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).
• Die Tab Komponenten des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Konfigurieren einer ServiceMax Upsert-Aktivität

Befolgen Sie diese Schritte, um eine ServiceMax Upsert-Aktivität zu konfigurieren:

• Schritt 1: Geben Sie einen Namen ein, wählen Sie ein Objekt aus und legen Sie die Einstellungen fest Geben Sie einen Namen für die Aktivität an und wählen Sie ein Objekt aus, das beim Upserting der Daten verwendet werden soll.
• Schritt 2: Wählen Sie die externe ID aus Wählen Sie ein vorhandenes ServiceMax Feld aus, das Harmony als externe ID zum Verknüpfen von Datensätzen verwenden soll.
• Schritt 3: Überprüfen Sie die Datenschemata Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt.

Schritt 1: Namen eingeben, Objekt auswählen und Einstellungen festlegen

In diesem Schritt geben Sie einen Namen für die Aktivität ein und wählen ein Objekt aus, das beim Upsert der Daten verwendet werden soll.

• Name: Geben Sie einen Namen ein, der zur Identifizierung der ServiceMax Upsert-Aktivität verwendet werden soll. Der Name muss für jede ServiceMax Upsert-Aktivität eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

• eWählen Sie die Objektreferenz: Verwenden Sie die Dropdown-Liste, um ein ServiceMax Standard- oder benutzerdefiniertes Objekt zum Upsert von Daten auszuwählen. Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet.

  Notiz

  Wenn die Dropdown-Liste nicht mit verfügbaren Objekten gefüllt ist, wird die ServiceMax Verbindung ist möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

• Aktualisieren: Klicken Sie auf das Aktualisierungssymbol um Objekte und Felder vom ServiceMax Endpoint neu zu laden. Dies kann nützlich sein, wenn Sie kürzlich Objekte oder Felder zu ServiceMax hinzugefügt haben.

• Optionale Einstellungen: Klicken Sie hier, um weitere optionale Einstellungen einzublenden:

  

  • Vorgangsoptionen: Diese Optionen gelten für einen Operation, in dem eine ServiceMax Upsert-Aktivität verwendet wird.

    Tipp

    In den Operation einer Operation können zusätzliche Optionen festgelegt werden.

    • Nullwerte einfügen: Aktivieren Sie das Kontrollkästchen, um das Einfügen oder Aktualisieren von Nullwerten zuzulassen. Wenn diese Option nicht ausgewählt ist und ein zugeordneter Wert einen Nullwert hat oder leer ist (eine leere Zeichenfolge aufweist), wird er nicht verarbeitet.

• Speichern und beenden: Wenn aktiviert, klicken Sie hier, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

• Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Externe ID auswählen

In diesem Schritt wählen Sie ein vorhandenes ServiceMax Feld aus, das Harmony als externe ID zum Verknüpfen von Datensätzen verwenden soll.

• Externe ID: Verwenden Sie das Dropdown-Menü, um das vorhandene ServiceMax Feld auszuwählen, das Harmony als externe ID zum Verknüpfen von Datensätzen verwenden soll. Informationen zum Erstellen eines externen ID-Felds in ServiceMax finden Sie unter Erstellen eines benutzerdefinierten ServiceMax Felds/einer externen ID für Jitterbit in ServiceMax.

  Warnung

  Das als externe ID verwendete Feld sollte für jeden Datensatz einen eindeutigen Wert haben. Wenn Sie mehrere Datensätze mit demselben externen ID-Wert haben, wird eine Fehlerantwort von ServiceMax zurückgegeben und das Upsert schlägt für die Datensätze mit doppelten IDs fehl.

• Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Überprüfen der Datenschemata

In diesem Schritt werden alle vom Endpoint generierten Anforderungs- oder Antwortschemata angezeigt:

• Datenschema: Es werden die Datenschemata für Anfrage und Antwort angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata später während der Transformation erneut angezeigt-Prozess, bei dem Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können.

  Die verwendete Version der Salesforce REST API hängt von der von Ihnen verwendeten Jitterbit-Agent-Version ab. Siehe Voraussetzungen und unterstützte API Versionen für Links zur Dokumentation der Schema.

  Notiz

  Um ein Schema in einer vorhandenen Aktivität zu aktualisieren, müssen Sie jeden Aktivitätskonfigurationsschritt erneut durchlaufen und dabei mindestens eine Änderung vornehmen (z. B. ein Zeichen am Ende des Aktivitätsnamens hinzufügen oder entfernen), um eine Aktualisierung des Schema zu erzwingen.

• Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

• Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

• Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen hierauf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine ServiceMax Upsert-Aktivität konfiguriert haben, können Sie sie wie unten beschrieben innerhalb einer Operation verwenden. Nachdem Sie eine Operation mit einer ServiceMax Aktivität auf einem privaten Agenten ausgeführt haben, können Sie die Erfolgs- und Fehlerdateien des Vorgangs herunterladen.

Schließen Sie den Operation ab

Nachdem Sie eine ServiceMax Upsert-Aktivität konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation eines Vorgangs konfigurieren, darunter die Möglichkeit, Vorgänge zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Sobald eine ServiceMax Upsert-Aktivität erstellt wurde, sind Menüaktionen für diese Aktivität über den Projektbereich entweder auf den Registerkarten Workflows oder Komponenten sowie über die Design-Canvas zugänglich. Siehe Aktionsmenü für weitere Einzelheiten.

ServiceMax Upsert-Aktivitäten können als Ziel mit diesen Operation verwendet werden:

• Transformation
• Zwei-Ziel-Archivmuster (nur als erstes Ziel)
• Zwei-Transformationsmuster (entweder als erstes oder zweites Ziel)

Vorgänge, die eine ServiceMax Aktivität enthalten, können nur eine Salesforce Aktivität haben und können keine anderen Aktivitäten enthalten, mit Ausnahme derjenigen, die mit der API verknüpft sind, Datenbank, Dateifreigabe, FTP, HTTP, Lokaler Speicher, Temporärer Speicher oder Variable-Anschlüsse.

Eine ServiceMax Aktivität kann nur in einer einzigen Operation als Operation Schritt verwendet werden. Das heißt, Sie können nicht mehrere Male in anderen Operationen auf dieselbe Aktivität verweisen. Stattdessen können Sie eine Kopie einer ServiceMax Aktivität erstellen, um sie an anderer Stelle zu verwenden (siehe Komponentenwiederverwendung).

Andere Muster sind bei Verwendung von ServiceMax Upsert-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Operation Validity Seite.

Wenn Sie innerhalb einer Transformation die Option zum Spiegeln eines Schema verwenden, das von einer Nicht-Massenaktivität von ServiceMax bereitgestellt wird, wird das resultierende gespiegelte Schema automatisch mit einem zusätzlichen Stammknoten namens records wobei die untergeordneten Knoten das Schema widerspiegeln. Wenn Felder innerhalb der untergeordneten Knoten zugeordnet werden, wird der Knoten zu einem Schleifenknoten, der das Durchlaufen aller Datensätze ermöglicht (siehe Schleifenknoten unter Datenstrukturen).

Bei Vorgängen, die ServiceMax Aktivitäten verwenden, können auch Operation so konfiguriert werden, dass sie bei einem SOAP Fehler ausgelöst werden - einem Fehler, der durch ein falsches Nachrichtenformat, eine falsche Header-Verarbeitung oder eine Inkompatibilität verursacht wird. Vorgangsaktionen können so konfiguriert werden, dass nach Auftreten eines SOAP -Fehlers eine Operation Durchführen oder eine Email gesendet wird. Anweisungen zum Auslösen einer Aktion bei einem SOAP Fehler finden Sie unter Vorgangsaktionen.

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, führen Sie den Operation aus und validieren Sie das Verhalten, indem Sie die Operation überprüfen.

Anzeigen von Erfolgs- und Fehlerdateien

Wenn Sie einen Operation ausführen, der eine ServiceMax Aktivität auf einem privaten Agenten enthält stehen Erfolgs- und Fehlerdateien auf der Seite Runtime Operations der Management Console zum Download bereit. Wählen Sie den entsprechenden Operation in der Tabelle Runtime-Vorgänge aus und klicken Sie im unteren Bereich des Bildschirms auf die Tab Aktivitätsprotokolle, um Download-Links für die Dateien anzuzeigen, sofern verfügbar:

• Datei erfolgreich heruntergeladen: Wenn Sie den Operation auf einem privaten Agenten ausführen, klicken Sie auf den Link Herunterladen, um die Erfolgsaufzeichnungen als CSV-Datei zu speichern.

• Download-Fehlerdatei: Wenn Sie den Operation auf einem privaten Agenten ausführen, klicken Sie auf den Link Herunterladen, um die Fehleraufzeichnungen als CSV-Datei zu speichern.