EDI for Cloud v2 List Transactions-Aktivität in Jitterbit Studio
Einführung
Eine EDI for Cloud v2 List Transactions-Aktivität ruft mithilfe ihrer EDI for Cloud v2-Verbindung Transaktionen aus Jitterbit EDI basierend auf 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 mit ihrem Aktivitätstyp List Transactions 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ätsinstanz in Komponentenwiederverwendung.
Eine vorhandene EDI for Cloud v2 List Transactions-Aktivität kann von diesen Orten aus bearbeitet werden:
- Die Design-Canvas (siehe Komponentenaktionsmenü in Design-Canvas).
- Die Registerkarte Komponenten des Projektbereichs (siehe Komponentenaktionsmenü in Projektbereich-Registerkarte Komponenten).
Konfigurieren einer EDI for Cloud v2 List Transactions-Aktivität
Führen Sie diese Schritte aus, um eine EDI for Cloud v2 List Transactions-Aktivität zu konfigurieren:
-
Schritt 1: Namen eingeben
Geben Sie einen Namen für die Aktivität an. -
Schritt 2: Datenschemas überprüfen
Alle Anfrage- oder Antwortschemas werden angezeigt.
Schritt 1: Namen eingeben
Geben Sie in diesem Schritt einen Namen für die Aktivität an. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.
-
Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. 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 List Transactions-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 Änderungen verwerfen möchten.
Schritt 2: Datenschemas überprüfen
Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.
-
Datenschema: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden während der Transformationszuordnung erneut angezeigt.
Der EDI for Cloud v2-Connector verwendet eine benutzerdefinierte Jitterbit-API.
Die Anfrage- und Antwortdatenschemas bestehen aus diesen Knoten und Feldern:
-
Anfrage:
Anfrageschema-Knoten/Feld Beschreibung Request Anfrage zum Abrufen einer Liste von Transaktionen pageGanzzahl, die die Seitennummer für die Paginierung angibt pageSizeGanzzahl, die die Anzahl der Ergebnisse pro Seite angibt partnerNameArray von Handelpartnernamen zum Filtern ( {"partnerName1", "partnerName2"})#textZeichenfolgenwert des Partnernamens documentTypeArray von Dokumenttypen zum Filtern ( {"850", "810"})#textZeichenfolgenwert des Dokumenttyps documentIDArray von Dokument-IDs zum Filtern ( {"1000007", "1000008"})#textZeichenfolgenwert der Dokument-ID statusArray von Statuswerten zum Filtern ( {"In progress", "Pending"})#textZeichenfolgenwert des Status toMeBoolescher Wert, der angibt, ob eingehende Transaktionen einbezogen werden sollen fromMeBoolescher Wert, der angibt, ob ausgehende Transaktionen einbezogen werden sollen transactionDateFromZeichenfolge, die das Startdatum für den Transaktionsdatumsbereich-Filter angibt ( "2025-08-11","2025-08-11 00:00:00"). Die Zeiten auf der EDI-Transaktionsseite werden in Ihrer Ortszeit angezeigt; 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 Abruefkriterien auf den nächsten Tag verschieben.transactionDateToZeichenfolge, die das Enddatum für den Transaktionsdatumsbereich-Filter angibt ( "2025-08-20","2025-08-20 00:00:00"). Die Zeiten auf der EDI-Transaktionsseite werden in Ihrer Ortszeit angezeigt; 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 Abruefkriterien auf den nächsten Tag verschieben.user_defined_field_1Zeichenfolgen mit benutzerdefinierten Werten. Die Werte werden in der EDI-Tabelle Transaktionen in den Spalten UDF1, UDF2, UDF3, UDF4 und UDF5 angezeigt. user_defined_field_2user_defined_field_3user_defined_field_4user_defined_field_5additionalFieldsArray, das zusätzliche Transaktionsattribute angibt, die in die additionalFieldsder Antwort einbezogen werden sollen#textKommagetrennte Zeichenfolge der zusätzlichen Transaktionsattribute, die zurückgegeben werden sollen ( {"Field Name 1", "Field Name 2"})
Alle möglichen zusätzlichen Felder:
{"Document Name", "Document Reference", "Additional Doc Reference", "Document Date", "Sender Name", "Receiver Name", "Sender Id", "Receiver Id", "Isa Control Number", "Gs Control Number", "St Control Number", "Integration Reference", "Downloaded", "Exported", "Item Count", "Shipment Requested", "Shipped", "Invoiced", "Acknowledgement Rejected", "Acknowledged By", "Success", "Created Date", "Last Modified Date"}
-
-
Antwort:
| Antwortschema-Knoten/Feld | Beschreibung | | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Response** | Antwort mit der Liste der Transaktionen | | | | | **`documents`** | Array von Transaktionsdokumenten, die den Filterkriterien entsprechen | | **`item`** | Einzelnes Transaktionsdokument | | `docInfo` | Der `eiCloudID`-Wert, der in einer [Get Document-Aktivität](/de/integration-studio/design/connectors/edi-for-cloud-v2/get-document-activity/) zurückgegeben wird | | `partnerName` | Zeichenkette mit dem Namen des Handelspartners | | `documentID` | Zeichenkette mit der Dokumentkennung | | `docType` | Zeichenkette eines EDI-[Dokumenttyps](/de/edi/ref/document-types/) | | `transactionDate` | Zeichenkette des Transaktionsdatums | | `amount` | Dezimalwert des Transaktionsbetrags | | `status` | Zeichenkette des Transaktionsstatus | | `direction` | Zeichenkette, die die Transaktionsrichtung angibt (eingehend/ausgehend) | | `message` | Zeichenkette mit einer beliebigen Transaktionsmitteilung | | `user_defined_field_1` | Zeichenketten mit benutzerdefinierten Werten. Die Werte werden in der EDI-Tabelle [Transaktionen](/de/edi/transactions/) 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 von zusätzlichen Attributen, die mit der Transaktion verknüpft sind | | `fieldName` | Zeichenkette mit dem Namen des zusätzlichen Felds | | `fieldValue` | Zeichenkette mit dem Wert des zusätzlichen Felds | | | | | `statusCode` | Ganzzahl, die den Statuscode darstellt | | `status` | Zeichenkette des Gesamtantwortstatus | | `message` | Zeichenkette mit einer beliebigen Antwortnachricht | -
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf 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 Transaktionen auflisten schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten, Transformationen oder Skripte 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 Aktivitätsaktionsmenü in Connector-Grundlagen.
EDI for Cloud v2-Aktivitäten Transaktionen auflisten können als Quelle mit diesen Vorgangsmustern verwendet werden:
- Transformationsmuster
- Zwei-Ziel-Archivmuster (nur als erste Quelle)
- Zwei-Ziel-HTTP-Archivmuster (nur als erste Quelle)
- Zwei-Transformationsmuster (als erste oder zweite Quelle)
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 Sie ihn aus, und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.