Zum Inhalt springen

EDI für Cloud v2 List Transactions-Aktivität

Einführung

Eine EDI für Cloud v2 List Transactions-Aktivität, die ihre EDI für Cloud v2-Verbindung verwendet, ruft Transaktionen von Jitterbit EDI basierend auf den angegebenen Filterkriterien ab. Diese Aktivität ist als Quelle in Operationen vorgesehen.

Erstellen einer EDI für Cloud v2 List Transactions-Aktivität

Eine Instanz einer EDI für Cloud v2 List Transactions-Aktivität wird aus einer EDI für Cloud v2-Verbindung unter Verwendung des Aktivitätstyps List Transactions erstellt.

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

Eine vorhandene EDI für Cloud v2 List Transactions-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer EDI für Cloud v2 List Transactions-Aktivität

Befolgen Sie diese Schritte, um eine EDI für Cloud v2 List Transactions-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein

In diesem Schritt geben Sie einen Namen für die Aktivität an. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte des gleichen Verbindungstyps konfiguriert haben, wird ein Menü oben auf dem Bildschirm angezeigt, das den aktuellen Endpunktnamen anzeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration 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 für Cloud v2 List Transactions-Aktivität eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Speichern & Beenden: Wenn aktiviert, 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 fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen Sie die Datenschemas

Alle Anforderungs- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Datenschema: Diese Datenschemas werden von benachbarten Transformationen übernommen und während der Transformationszuordnung erneut angezeigt.

    Der EDI für Cloud v2-Connector verwendet eine benutzerdefinierte Jitterbit-API.

    Die Anforderungs- und Antwortdatenschemas bestehen aus diesen Knoten und Feldern:

    • Anforderung:

      Anforderungsschema-Knoten/-feld Beschreibung
      Anforderung Anforderung zum Abrufen einer Liste von Transaktionen
      page Ganzzahl, die die Seitennummer für die Paginierung angibt
      pageSize Ganzzahl, die die Anzahl der Ergebnisse pro Seite angibt
      partnerName Array von Namen der Handelspartner, nach denen gefiltert werden soll ({"partnerName1", "partnerName2}")
      #text Zeichenfolgenwert des Partnernamens
      documentType Array von Dokumenttypen, nach denen gefiltert werden soll ({"850", "810"})
      #text Zeichenfolgenwert des Dokumenttyps
      documentID Array von Dokument-IDs, nach denen gefiltert werden soll ({"1000007", "1000008"})
      #text Zeichenfolgenwert der Dokument-ID
      status Array von Statuswerten, nach denen gefiltert werden soll ({"In Bearbeitung", "Ausstehend"})
      #text Zeichenfolgenwert des Status
      toMe Boolean, der angibt, ob eingehende Transaktionen einbezogen werden sollen
      fromMe Boolean, der angibt, ob ausgehende Transaktionen einbezogen werden sollen
      transactionDateFrom Zeichenfolge, die das Startdatum für den Filter des Transaktionsdatumsbereichs angibt ("2025-08-11", "2025-08-11 00:00:00"). Zeiten auf der EDI Transaktionsseite sind in Ihrer lokalen Zeit; das System arbeitet in GMT. Wenn die abgerufenen Ergebnisse nicht die erwarteten Datensätze enthalten, müssen Sie möglicherweise einen Zeitstempel verwenden oder die Abrufkriterien auf den nächsten Tag vorverlegen.
      transactionDateTo Zeichenfolge, die das Enddatum für den Filter des Transaktionsdatumsbereichs angibt ("2025-08-20", "2025-08-20 00:00:00"). Zeiten auf der EDI Transaktionsseite sind in Ihrer lokalen Zeit; das System arbeitet in GMT. Wenn die abgerufenen Ergebnisse nicht die erwarteten Datensätze enthalten, müssen Sie möglicherweise einen Zeitstempel verwenden oder die Abrufkriterien auf den nächsten Tag vorverlegen.
      user_defined_field_1 Zeichenfolgen mit benutzerdefinierten Werten. Die Werte werden in der EDI Transaktionen Tabelle 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
      additionalFields Array, das zusätzliche Transaktionsattribute angibt, die in den additionalFields der Antwort enthalten sein sollen
      #text Komma-separierte Zeichenfolge der zusätzlichen Transaktionsattribute, die zurückgegeben werden sollen ({"Feldname 1", "Feldname 2"})

      Alle möglichen zusätzlichen Felder:

      {"Dokumentenname", "Dokumentenreferenz", "Zusätzliche Dokumentreferenz", "Dokumentdatum", "Absendername", "Empfängername", "Absender-ID", "Empfänger-ID", "Isa-Kontrollnummer", "Gs-Kontrollnummer", "St-Kontrollnummer", "Integrationsreferenz", "Heruntergeladen", "Exportiert", "Artikelanzahl", "Versand angefordert", "Versendet", "Rechnungsstellung", "Bestätigung abgelehnt", "Bestätigt von", "Erfolg", "Erstellungsdatum", "Letztes Änderungsdatum"}

    • Antwort:

      Antwortschema Knoten/Feld Beschreibung
      Antwort Antwort, die die Liste der Transaktionen enthält
      documents Array von Transaktionsdokumenten, die den Filterkriterien entsprechen
      item Einzelnes Transaktionsdokument
      docInfo Der eiCloudID-Wert, der in einer Get Document-Aktivität zurückgegeben wird
      partnerName Zeichenfolge des Namens des Handelspartners
      documentID Zeichenfolge des Dokumentenidentifikators
      docType Zeichenfolge eines EDI Dokumenttyps
      transactionDate Zeichenfolge des Transaktionsdatums
      amount Dezimalwert des Transaktionsbetrags
      status Zeichenfolge des Transaktionsstatus
      direction Zeichenfolge, die die Transaktionsrichtung angibt (eingehend/ausgehend)
      message Zeichenfolge, die eine Transaktionsnachricht enthält
      user_defined_field_1 Zeichenfolgen mit benutzerdefinierten Werten. Die Werte werden in der EDI Transaktionen Tabelle 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
      additionalFields Array zusätzlicher Attribute, die mit der Transaktion verbunden sind
      fieldName Zeichenfolge des zusätzlichen Feldnamens
      fieldValue Zeichenfolge des zusätzlichen Feldwerts
      statusCode Ganzzahl, die den Statuscode darstellt
      status Zeichenfolge des allgemeinen Antwortstatus
      message Zeichenfolge, die eine Antwortnachricht enthält

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemata vom EDI für Cloud v2-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, wie beispielsweise in einer benachbarten 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: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Nächste Schritte

Nachdem Sie eine EDI für Cloud v2 Transaktionen auflisten-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration der Operation, indem Sie andere Aktivitäten, Transformationen oder Skripte als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen konfigurieren, die die Möglichkeit umfassen, Operationen zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfskanvas zugänglich. Weitere Details finden Sie im Aktivitätsaktionsmenü in Connector-Grundlagen.

EDI für Cloud v2 Transaktionen auflisten-Aktivitäten können als Quelle mit diesen Betriebsmustern verwendet werden:

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, deployen und ausführen Sie die Operation und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.