Zum Inhalt springen

EDI for Cloud v2 List Transactions-Aktivität in Jitterbit Studio

Einführung

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

Erstellen einer EDI for Cloud v2 List Transactions-Aktivität

Eine Instanz einer EDI for Cloud v2 List Transactions-Aktivität wird aus einer EDI for 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 for Cloud v2 List Transactions-Aktivität kann an diesen Orten bearbeitet werden:

Konfigurieren einer EDI for Cloud v2 List Transactions-Aktivität

Befolgen Sie diese Schritte, um eine EDI for 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 Endpunkt-Namen 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 Endpunkt-Namen 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 Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich 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 geerbt 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 Seitenzahl für die Paginierung angibt
      pageSize Ganzzahl, die die Anzahl der Ergebnisse pro Seite angibt
      partnerName Array von Handelsparternamen zur Filterung ({"partnerName1", "partnerName2}")
      #text Zeichenfolgenwert des Partnernamens
      documentType Array von Dokumenttypen zur Filterung ({"850", "810"})
      #text Zeichenfolgenwert des Dokumenttyps
      documentID Array von Dokument-IDs zur Filterung ({"1000007", "1000008"})
      #text Zeichenfolgenwert der Dokument-ID
      status Array von Statuswerten zur Filterung ({"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 einbezogen werden sollen
      #text Komma-getrennte 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 Dokument abrufen-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 etwaige 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 Namens des zusätzlichen Feldes
      fieldValue Zeichenfolge des Wertes des zusätzlichen Feldes
      statusCode Ganzzahl, die den Statuscode darstellt
      status Zeichenfolge des allgemeinen Antwortstatus
      message Zeichenfolge, die eine etwaige 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 zum Beispiel 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen 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 über das Projektfenster und die Entwurfsfläche zugänglich. Für Details siehe 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 führen Sie Sie die Operation aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.