Via B2B Leseaktivität
Einführung
Eine Via B2B Lese-Aktivität, die ihre Via B2B-Verbindung verwendet, ruft Objektdaten von Via B2B ab und ist dazu gedacht, als Quelle für die Bereitstellung von Daten in einem Vorgang verwendet zu werden.
Hinweis
Bei der Verwendung des Via B2B-Konnektors müssen Sie zunächst das Lese-Objekt der Aktivität Initial Load verwenden, um Objektdaten von einem Via B2B-Partner abzurufen. Nachdem Sie die Partner-Objektdaten abgerufen haben, verwenden Sie die Aktivität Initial Load, um diese Daten in die Via B2B-Instanz zu laden. Nachdem die Daten in die Via B2B-Instanz geladen wurden, können Sie die Lese-, Erstellen- und Aktualisieren-Aktivitäten verwenden, um mit den geladenen Daten zu interagieren.
Erstellen einer Via B2B Leseaktivität
Eine Instanz einer Via B2B Lese-Aktivität wird aus einer Via B2B-Verbindung unter Verwendung des Aktivitätstyps Lese 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. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.
Eine vorhandene Via B2B Lese-Aktivität kann von diesen Orten aus bearbeitet werden:
- Die Entwurfsfläche (siehe Komponentenaktionsmenü in Entwurfsfläche).
- Der Komponenten-Tab im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Tab).
Konfigurieren einer Via B2B Leseaktivität
Befolgen Sie diese Schritte, um eine Via B2B Lese-Aktivität zu konfigurieren:
-
Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Objekt aus
Geben Sie einen Namen für die Aktivität ein und wählen Sie ein Objekt aus. -
Schritt 2: Wählen Sie ein Unterobjekt aus
Wählen Sie ein Unterobjekt aus. -
Schritt 3: Überprüfen Sie die Datenschemas
Alle Anforderungs- oder Antwortschemas, die von dem Endpunkt generiert wurden, werden angezeigt.
Schritt 1: Geben Sie einen Namen ein und wählen Sie ein Objekt aus
In diesem Schritt geben Sie einen Namen für die Aktivität ein und wählen ein Objekt aus. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.
-
Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Via B2B Read-Aktivität einzigartig sein und darf keine Schrägstriche
/oder Doppelpunkte:enthalten. -
Wählen Sie ein Objekt aus: In diesem Abschnitt werden die in dem Via B2B-Endpunkt verfügbaren Objekte angezeigt.
-
Ausgewähltes Objekt: Nachdem ein Objekt ausgewählt wurde, wird es hier aufgelistet.
-
Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Objekte beim Suchen erneut vom Endpunkt zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.
-
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objekte vom Via B2B-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Objekte zu Via B2B hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Objekttabelle verwendet werden.
-
Auswählen eines Objekts: Klicken Sie innerhalb der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Objekt auszuwählen. Es kann nur ein Objekt ausgewählt werden. Die Informationen, die für jedes Objekt verfügbar sind, werden vom Via B2B-Endpunkt abgerufen:
-
Name: Der Name des Objekts.
-
Beschreibung: Die Beschreibung des Objekts.
-
Tipp
Wenn die Tabelle nicht mit verfügbaren Objekten gefüllt wird, könnte die Via B2B-Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.
-
-
Bei Fehlern fortfahren: Wählen Sie aus, um die Ausführung der Aktivität fortzusetzen, wenn ein Fehler für einen Datensatz in einer Batch-Anforderung auftritt. Wenn Fehler auftreten, werden diese im Betriebsprotokoll aufgezeichnet.
-
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: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen an einem Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 2: Wählen Sie ein Unterobjekt
In diesem Schritt wählen Sie ein Unterobjekt aus. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.
-
Unterobjekt auswählen: In diesem Abschnitt werden die im Via B2B-Endpunkt verfügbaren Unterobjekte angezeigt.
-
Ausgewähltes Objekt: Das im vorherigen Schritt ausgewählte Objekt wird hier aufgelistet.
-
Ausgewähltes Unterobjekt: Nachdem ein Unterobjekt ausgewählt wurde, wird es hier aufgelistet.
-
Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Unterobjekte zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Unterobjekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Unterobjekte vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.
-
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Unterobjekte vom Via B2B-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Unterobjekte zu Via B2B hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der in der Konfiguration angezeigten Unterobjekte verwendet werden.
-
Auswählen eines Unterobjekts: Klicken Sie innerhalb der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Unterobjekt auszuwählen. Es kann nur ein Unterobjekt ausgewählt werden. Die für jedes Unterobjekt verfügbaren Informationen werden vom Via B2B-Endpunkt abgerufen:
-
Name: Der Name des Unterobjekts.
-
Beschreibung: Die Beschreibung des Unterobjekts.
-
Tipp
Wenn die Tabelle nicht mit verfügbaren Unterobjekten gefüllt wird, könnte die Via B2B-Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.
-
-
Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
-
Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem 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 fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 3: Überprüfen der Datenschemas
Alle Anforderungs- oder Antwortschemas, die von dem Endpunkt generiert wurden, werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.
-
Datenschemas: Diese Datenschemas werden von benachbarten Transformationen geerbt und während der Transformationszuordnung erneut angezeigt.
Der Via B2B Connector verwendet die Via B2B REST API v5.5. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.
-
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom Via B2B-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, z. B. 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 Via B2B Read-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration der Operation, indem Sie andere Aktivitäten oder Werkzeuge 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 Entwurfsgrafik zugänglich. Für Details siehe Aktionsmenü der Aktivität in Connector-Grundlagen.
Über B2B Lese-Aktivitäten können als Quelle mit diesen Betriebsmustern 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 Ort und verwenden Sie dann diesen temporären Ort in der Skriptfunktion.
Wenn Sie bereit sind, bereitstellen und ausführen Sie den Vorgang und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.