Zum Inhalt springen

EDI for Cloud v2 Set Status-Aktivität in Jitterbit Studio

Einführung

Eine EDI for Cloud v2 Set Status-Aktivität verwendet ihre EDI for Cloud v2-Verbindung und aktualisiert den Status eines Dokuments in Jitterbit EDI. Sie ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Wichtig

Dieser Connector erfordert ein Abonnement für Jitterbit EDI. Kontaktieren Sie Ihren Customer Success Manager (CSM) für weitere Informationen.

Um die Set Status-Aktivität zu verwenden, müssen Sie zunächst eine Get document- oder Send document-Aktivität verwenden, um die interne Dokument-ID eiCloudId oder docInfo für das Dokument abzurufen. eiCloudId und docInfo stellen dieselbe Kennung dar. Der docInfo-Wert muss im Request-Schema der Set Status-Aktivität angegeben werden.

Erstellen einer EDI for Cloud v2 Set Status-Aktivität

Eine Instanz einer EDI for Cloud v2 Set Status-Aktivität wird aus einer EDI for Cloud v2-Verbindung mit ihrem Set Status-Aktivitätstyp 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 Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene EDI for Cloud v2 Set Status-Aktivität kann an diesen Orten bearbeitet werden:

Konfigurieren einer EDI for Cloud v2 Set Status-Aktivität

Führen Sie diese Schritte aus, um eine EDI for Cloud v2 Set Status-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben

Geben Sie in diesem Schritt einen Namen für die Aktivität ein. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Endpunkt-Menü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, 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 Aktivität zu identifizieren. Der Name muss für jede EDI for Cloud v2 Set Status-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Speichern und beenden: Klicken Sie, 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

Alle Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden erneut während der Datenzuordnung angezeigt.

    Der EDI for Cloud v2-Connector verwendet eine benutzerdefinierte Jitterbit-API.

    Die Request- und Response-Datenschemas bestehen aus diesen Knoten und Feldern:

    • Request:

      Request-Schemaknoten/-feld Beschreibung
      SetDocStatusRequest Request zum Aktualisieren der Dokumenttransaktionsmeldung und des Status.
      docInfo String der internen Dokumentkennung. Diese kann mithilfe einer Dokumentabruf- oder Dokument senden-Aktivität abgerufen werden.
      ref_number String einer externen Integrations-Referenznummer.
      reprocess Boolescher Wert, der bestimmt, ob ein Dokument erneut verarbeitet werden soll. Das Setzen dieses Werts auf true entspricht der Verwendung der Schaltfläche Erneut verarbeiten auf der EDI-Seite Transaktionen.
      message Knoten, der die Meldung darstellt. Meldungen werden mit Dokumenten auf der EDI-Seite Transaktionen angezeigt.
      type String des Meldungstyps, entweder Message oder Error. Diese Meldungstypen setzen den Dokumenttransaktionsstatus auf Success bzw. Error.
      text String des Meldungstexts.
      messages Knoten, der Untermeldungen darstellt.
      type String des Untermeldungstyps, entweder Message oder Error.
      text String des Untermeldungstexts.
      user_defined_status String mit dem Status des Dokuments. Diese Werte werden akzeptiert:
      • Warning
      • Pending
      • In progress
      • Validated
      • Rejected
      • Completed
      • On hold
      • Acknowledged
      Dieser Status wird in der Spalte Status in der EDI-Tabelle Transaktionen angezeigt.
      user_defined_field_1 Strings mit benutzerdefinierten Werten. Die Werte werden in der EDI-Tabelle Transaktionen in den Spalten UDF1, UDF2, UDF3, UDF4 und UDF5 angezeigt.
      user_defined_field_2
      user_defined_field_3
      user_defined_field_4
      user_defined_field_5

  • Antwort:

    | Knoten/Feld des Antwortschemas | Beschreibung                                                                                                                                    |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **`SetDocStatusResponse`** | Antwort vom Aktualisieren der Dokumenttransaktionsnachricht und des Status.                                                                            |
| `status`                   | Zeichenkette der Erfolgs- oder Fehlermeldung der Nachrichtenaktualisierung von EDI.                                                                                                                                    |
| `message`                  | Zeichenkette der Antwortstatusmeldung mit Details zum Erfolg oder Fehler der Nachrichtenaktualisierung. Sie enthält auch einen Hinweis, falls das Dokument erneut verarbeitet wurde. |
| `docInfo`                  | Lange Ganzzahl des internen Dokumentbezeichners.                                                                                              |
| `blobId`                   | Zeichenkette mit der Antwort-Blob-ID. Dieses Feld kann `null` sein.                                                                                    |

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom EDI for Cloud v2-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • 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 EDI for Cloud v2-Aktivität Status festlegen 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 Menü „Aktivitätsaktionen" in Connector-Grundlagen.

EDI for Cloud v2-Aktivitäten Status festlegen können als Ziel mit diesen Vorgangsmustern verwendet werden:

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 Sie bereit sind, stellen Sie den Vorgang bereit und führen ihn aus, und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle prüfen.