ServiceMax Delete-Aktivität in Jitterbit Studio

Einführung

Eine ServiceMax Delete-Aktivität löscht mit ihrer ServiceMax-Verbindung Daten in ServiceMax und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

ServiceMax Delete-Aktivität erstellen

Eine Instanz einer ServiceMax Delete-Aktivität wird aus einer ServiceMax-Verbindung mit dem Aktivitätstyp Delete erstellt.

Um eine Aktivitätsinstanz 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 Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

Eine vorhandene ServiceMax Delete-Aktivität kann an diesen Orten bearbeitet werden:

• Die Design-Canvas (siehe Komponentenaktionsmenü in Design-Canvas).

• Die Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Projektbereich-Registerkarte „Komponenten").

ServiceMax Delete-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine ServiceMax Delete-Aktivität zu konfigurieren:

• Schritt 1: Namen eingeben
  Geben Sie einen Namen für die Aktivität an.

• Schritt 2: Datenschemas überprüfen
  Alle vom Endpunkt generierten Request- oder Response-Schemas werden angezeigt.

Schritt 1: Namen eingeben

In diesem Schritt geben Sie einen Namen für die Aktivität an.

• Endpunktmenü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

  • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

• Name: Geben Sie einen Namen ein, um die ServiceMax Delete-Aktivität zu identifizieren. Der Name muss für jede ServiceMax Delete-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

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

• Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

• Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

In diesem Schritt werden alle vom Endpunkt generierten Request- oder Response-Schemas angezeigt:

• Datenschema: Die Request- und Response-Datenschemas werden angezeigt. Innerhalb des Knotens ids auf der Request-Seite der Struktur befindet sich ein Textwert, der durch ein Feld dargestellt wird und dazu bestimmt ist, die ServiceMax-Datensatz-ID(s) bereitzustellen. Später können Sie während des Transformationszuordnungsprozesses die ids auf der Zielseite zuordnen, um die zu löschenden ServiceMax-Datensatz-ID(s) bereitzustellen.

  Die verwendete Version der Salesforce-API hängt von der Jitterbit-Agent-Version ab, die Sie verwenden. Siehe Voraussetzungen und unterstützte API-Versionen für Links zur Dokumentation der Schemafelder.

• Plugin(s) hinzufügen: Plugins sind von Jitterbit oder Benutzern bereitgestellte Anwendungen, die die nativen Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Abschnitt zu erweitern, und aktivieren Sie das Kontrollkästchen neben dem zu verwendenden Plugin. Weitere Anweisungen zur Verwendung von Plugins, einschließlich Details zum Festlegen erforderlicher Variablen, die vom Plugin verwendet werden, finden Sie unter Plugins, die zu einer Aktivität hinzugefügt wurden.

• Zurück: Klicken Sie, 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, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer ServiceMax-Aktivität Löschen können Sie diese in einem Vorgang wie unten beschrieben verwenden. Nach dem Ausführen eines Vorgangs, der eine ServiceMax-Aktivität auf einem privaten Agent enthält, können Sie die Erfolgs- und Fehlerdateien des Vorgangs herunterladen.

Vorgang abschließen

Nach der Konfiguration einer ServiceMax-Aktivität Löschen schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Aktionsmenü für Aktivitäten in Connector-Grundlagen.

ServiceMax-Aktivitäten Löschen können mit diesen Vorgangsmustern verwendet werden:

• Transformationsmuster (als Ziel)
• Zwei-Ziel-Archivierungsmuster (nur als erstes Ziel)
• Zwei-Transformationsmuster (als erstes oder zweites Ziel)

Ein Vorgang kann nur eine ServiceMax-Aktivität enthalten. Die Aktivität, die Daten für eine ServiceMax-Aktivität Löschen bereitstellt, kann mit jedem Endpunkttyp verknüpft werden. Wenn der Vorgang die ServiceMax-Antwort direkt an eine andere Zielaktivität übergibt, wie im Zwei-Ziel-Archivierungsmuster, muss diese Zielaktivität mit dem Connector API, Datenbank, Dateifreigabe, FTP, HTTP, Lokaler Speicher, Temporärer Speicher oder Variable verknüpft sein. Im Zwei-Transformationsmuster durchläuft die ServiceMax-Antwort eine zweite Transformation, bevor sie die zweite Zielaktivität erreicht, sodass diese Zielaktivität mit jedem Endpunkttyp verknüpft werden kann.

Eine ServiceMax-Aktivität kann nur in einem einzelnen Vorgang als Vorgangsschritt verwendet werden. Das heißt, Sie können nicht auf dieselbe Aktivität mehrmals in anderen Vorgängen verweisen. Stattdessen können Sie eine Kopie einer ServiceMax-Aktivität zur Verwendung an anderer Stelle erstellen (siehe Komponentenwiederverwendung).

Andere Muster sind bei ServiceMax Delete-Aktivitäten nicht zulässig. Siehe die Validierungsmuster auf der Seite Operation validity.

Wenn man innerhalb einer Transformation die Option zum Spiegeln eines Schemas verwendet, das von einer nicht-Bulk-ServiceMax-Aktivität bereitgestellt wird, wird das resultierende gespiegelte Schema automatisch mit einem zusätzlichen Root-Knoten namens records erstellt, mit untergeordneten Knoten, die das Schema spiegeln. Wenn Felder innerhalb der untergeordneten Knoten zugeordnet werden, wird der Knoten zu einem Loop-Knoten, um alle Datensätze zu durchlaufen (siehe Loop nodes unter Data structures).

Operationen, die ServiceMax-Aktivitäten verwenden, können auch Operationsaktionen konfigurieren, die bei einem SOAP-Fehler ausgelöst werden – ein Fehler, der aus einem falschen Nachrichtenformat, einer Kopfzeilenverarbeitung oder einer Inkompatibilität resultiert. Operationsaktionen können so konfiguriert werden, dass sie eine Operation ausführen oder eine E-Mail senden, nachdem ein SOAP-Fehler auftritt. Anweisungen zum Auslösen einer Aktion bei SOAP-Fehler finden Sie unter Operation actions.

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

Wenn alles bereit ist, stellen Sie die Operation bereit und führen Sie sie aus und validieren Sie das Verhalten durch Überprüfung der Operationsprotokolle.

Erfolgs- und Fehlerdateien anzeigen

Wenn Sie eine Operation mit einer ServiceMax-Aktivität auf einem privaten Agent ausführen, sind Erfolgs- und Fehlerdateien auf der Runtime-Seite der Management Console zum Download verfügbar. Wählen Sie die relevante Operation in der Runtime-Tabelle aus und klicken Sie auf die Registerkarte Activity Logs im unteren Bereich des Bildschirms, um Download-Links für die Dateien anzuzeigen, falls verfügbar:

• Download Success File: Wenn Sie die Operation auf einem privaten Agent ausführen, klicken Sie auf den Download-Link, um die erfolgreichen Datensätze als CSV-Datei zu speichern.

• Download Failure File: Wenn Sie die Operation auf einem privaten Agent ausführen, klicken Sie auf den Download-Link, um die fehlgeschlagenen Datensätze als CSV-Datei zu speichern.