Komplexe Daten
Verwenden Sie eine grafische Oberfläche, um mit Sammlungen komplexer strukturierter Daten zu arbeiten. Helfen Sie Designanwendern, die Organisation strukturierter Daten zu verstehen, und fügen Sie ihre einzelnen Elemente hinzu, entfernen oder konfigurieren Sie sie.
Mit komplexen Daten können Sie strukturierte Daten in einem maschinenlesbaren Format wie JavaScript Object Notation (JSON) oder Extensible Markup Language (XML) codieren und speichern. Sie können verwenden Workflow-Studio Schnittstelle zum Anzeigen und Verstehen der Organisation strukturierter Daten sowie zum Erstellen von Datenstrukturen. Sie können beispielsweise eine Kontaktdatenstruktur erstellen, die aus Informationen besteht, die Sie aus einem Anwenderdatensatz suchen, z. B. Vorname, Nachname und E-Mail-Adresse.
Daraus können Sie komplexe Daten erstellen Workflow-Studio Schnittstellen.
| Workflow-Studio Schnittstelle | Beispielverwendung |
|---|---|
| Aktionseingaben und -Ausgaben | Erstellen Sie eine Aktion, die ein Objekt aus Datensatzdaten generiert. Füllen Sie das Objekt mithilfe von Datensatzdaten aus, nach denen die Aktion sucht. Siehe Erstellen Sie eine anwenderdefinierte Aktion, um ein Objekt aus einem Datensatz zu generieren |
| Eingabe- und Ausgabevariablen des Skriptschritts | Schreiben Sie ein Skript, um ein Array von Objekten aus einer Liste von Datensätzen zu erstellen. Weitere Informationen finden Sie unter Erstellen Sie eine anwenderdefinierte Aktion, um ein Array von Objekten aus einer Liste von Datensätzen zu generieren. Schreiben Sie ein Skript, um ein JSON-Dokument in eine Ausgabe vom Typ „Objekt“ zu analysieren. |
| Subflow-Eingaben und -Ausgaben | Erstellen Sie einen Subflow, der ein Objekt als Eingabe akzeptiert und zum Aufrufen eines externen Service verwendet. |
| XML-Parser-Schritt Zielfeldkonfigurationen | Analysieren Sie eine XML-Nutzlast mit dem XML-Parser-Schritt in ein komplexes Datenobjekt. |
| REST API-Auslösertextfeld | Analysieren Sie eine eingehende REST-API-Anforderung in einem komplexen Datenobjekt, und verwenden Sie die Werte in einem Flow. Siehe REST API-Auslöser . |
Vorteile
- Daten analysieren und formatieren, ohne Code schreiben zu müssen. Erstellen Sie beispielsweise Datenvariablen, um eine Antwortnachricht zu analysieren oder eine Anforderungsnachricht zu formatieren.
- Erstellen Sie beliebige Datenstrukturen. Erstellen Sie beispielsweise eine Problemdatenstruktur, die Informationen aus vorhandenen Interaktions- und Incident-Datensätzen kombiniert, oder erstellen Sie eine Datenstruktur, um eine anwenderdefinierte Integration zu unterstützen.
- Zeigen Sie die Organisation der Datenstrukturen an. Beispielsweise kann eine Problemdatenstruktur aus einem Anwenderobjekt bestehen, um zu beschreiben, wer bezüglich des Problems kontaktiert werden soll, und einem Verlaufsobjekt, um die zu seiner Lösung geleistete Arbeit zu beschreiben. Sie können eine Benachrichtigungsaktion mit dem Pfad zur E-Mail-Adresse konfigurieren, die im Anwenderobjekt aufgeführt ist, und einen Subflow „Problem eskalieren“ mit dem Pfad zum Status aufrufen oder die Anzahl aus dem Verlaufsobjekt neu zuweisen.
- Erlauben Sie den Zugriff auf die Datenstruktur aus API-Aufrufen. Rufen Sie beispielsweise eine Aktion oder einen Subflow aus einem Skript auf, und verwenden Sie die vordefinierte Datenstruktur als Eingabewerte.
- Speichern und verwenden Sie Datenstrukturen als Vorlagen. Speichern Sie beispielsweise das Anwenderobjekt als Vorlagendatenstruktur zur Wiederverwendung in anderen Aktionen und Flows.
Datenstruktur
Eine Datenstruktur ist eine Sammlung zugehöriger Datenelemente, die in einer Hierarchie organisiert sind. Jedes Element in einer Datenstruktur hat seinen eigenen Datentyp und seine eigene eindeutige Position in der Hierarchie.
Diese Datenstruktur besteht beispielsweise aus einem übergeordneten Mitarbeiterelement mit vier untergeordneten Elementen für ID-Nummer, Name, Startdatum und Kontakt-E-Mail. Das Element „Kontakt-E-Mail“ ist auch ein übergeordnetes Element mit einem untergeordneten Element.
Im Datenbereich wird die Datenstrukturhierarchie als Struktur von reduzierbaren und erweiterbaren Datenpillen angezeigt, genau wie bei Datensatzvariablen. Übergeordnete Elemente haben ein Pfeilsymbol zum Reduzieren oder erweitern der Hierarchie.
Beispiel: Hier ist die Mitarbeiterdatenstruktur, wie aus dem Datenbereich gesehen.
Sie können den Datenbereich oder die Datenauswahl verwenden, um bestimmte Werte aus einer Datenstruktur auszuwählen. Datenstrukturen ähneln Datenpillen für Datensätze in, da Sie Dot-Walking durchführen oder zu bestimmten Elementen innerhalb der Struktur navigieren können. Wenn Sie ein Datenelement auswählen, Workflow-Studio Zeigt den Pfad dazu wie jede andere Datenelementauswahl als Datenpille an. Wenn Sie beispielsweise das Datenelement Startdatum auswählen, lautet der Pfad [Eingabe->Mitarbeiter->Startdatum] .
Sie können einen Elementdatenpfad genauso verwenden wie einen XPath oder JPath. Manchmal konvertieren Sie sogar den Datenpillenpfad in eine dieser Pfadnotationen.
Komplexe Datentypen
Sie erstellen Datenstrukturen mit einer oder mehreren Array Oder Objekt Variablen. Nur diese Variablendatentypen unterstützen untergeordnete Variablen.
Eine Array-Variable enthält Werte für einen Elementtyp. Die übergeordnete Variable hat immer einen Array-Datentyp, und es gibt immer nur eine untergeordnete Variable, die eine Instanz des vom Array unterstützten Datentyps ist. Erstellen Sie Array-Variablen, wenn eine Eingabe oder Ausgabe mehrere Werte desselben Datentyps akzeptiert.
Sie können beispielsweise ein Kontakt-E-Mail-Array erstellen, um alle E-Mail-Adressen aufzulisten, die einer bestimmten Person zugeordnet sind.
| Komponentenbezeichnung | Datentyp | Musterdaten |
|---|---|---|
| Kontakt-E-Mail | Array.Zeichenfolge | beth.anglin@example.com und beth@anglin.com |
| Kontakt E-Mail_child0 | Zeichenfolge |
Eine Objektvariable enthält eine beliebige Anzahl und Anordnung von untergeordneten Variablen, die jeweils einen eigenen Datentyp und eigene Werte haben. Durch das Verschachteln von Objektvariablen können Sie komplexe Datenstrukturen ähnlich einem Tabellenschema erstellen, bei dem eine Tabelle zugehörige Datensätze in einer anderen Tabelle enthält. Erstellen Sie Objektvariablen, wenn eine Eingabe oder Ausgabe eine oder mehrere zugehörige Eigenschaften akzeptiert.
Sie können beispielsweise ein Mitarbeiterobjekt erstellen, um Informationen über die Personen zu definieren, die in einem Unternehmen arbeiten.
| Komponentenbezeichnung | Datentyp | Musterdaten |
|---|---|---|
| Mitarbeiter | Objekt | |
| ID-Nummer | Ganzzahl | 20190304000101 |
| Name | Zeichenfolge | Beth Anglin |
| Startdatum | Datum/Uhrzeit | 4. März 2019 |
| Kontakt-E-Mail | Array.Zeichenfolge | beth.anglin@example.com und beth@anglin.com |
Nur diese Variablendatentypen können übergeordnete Elemente sein.
| Datentyp | Beschreibung |
|---|---|
| Array.Array | Ein Container für Arrays. Fügt ein schreibgeschütztes untergeordnetes Element vom Typ „Array“ hinzu. |
| Array.Wahr/Falsch | Ein Container für „wahr/falsch“-Werte. Fügt ein schreibgeschütztes untergeordnetes Element vom Typ „wahr“/„falsch“ hinzu. |
| Array.Auswahl | Ein Container für Auswahlwerte. Fügt ein schreibgeschütztes untergeordnetes Element vom Typ „Auswahl“ hinzu. |
| Array.Datum/Uhrzeit | Ein Container für Datums-/Uhrzeitwerte. Fügt ein schreibgeschütztes untergeordnetes Element vom Typ Datum/Uhrzeit hinzu. |
| Array.Integer | Ein Container für Ganzzahlwerte. Fügt ein schreibgeschütztes untergeordnetes Element vom Typ Ganzzahl hinzu. |
| Array.Object | Ein Container für Objekte. Fügt ein schreibgeschütztes untergeordnetes Element vom Typ „Objekt“ hinzu, in dem angezeigt wird Untergeordnetes Element Hinzufügen Option. |
| Array.Zeichenfolge | Ein Container für Zeichenfolgenwerte. Fügt ein schreibgeschütztes untergeordnetes Element vom Typ „Zeichenfolge“ hinzu. |
| Objekt | Ein Container für andere Datenelemente. Zeigt an Untergeordnetes Element Hinzufügen Option. |
- Array
- Wahr/Falsch
- Auswahl
- Datum/Uhrzeit
- Ganzzahl
- Objekt
- Zeichenfolge
Erweiterte Optionen
Objektvariablen verfügen über erweiterte Optionen zum Speichern und Laden von Datenstrukturen. Mit diesen Optionen können Sie eine Datenstruktur wiederverwenden, die an einem Ort an einem anderen definiert ist. Weitere Informationen zu erweiterten Optionen finden Sie unter Datentypen der Aktionsvariablen .
Datenstrukturvorlagen
Mit Datenstrukturvorlagen können Sie Objektvariablen in mehreren Aktionen oder Subflows wiederverwenden. Sie können beispielsweise eine Datenstruktur erstellen, um eine Antwort zu analysieren und später dieselbe Datenstruktur wiederverwenden, um eine Anforderung zu formatieren. Eine Vorlage speichert die Liste der untergeordneten Variablen und ihre Struktur in einem Objekt. Jede Objektvariable verfügt über die Option Erweitert, um sie als Vorlage zu speichern.
Wenn Sie eine Vorlage anwenden, erstellen Sie eine Kopie der ursprünglichen Struktur. Alle Änderungen, die Sie nach dem Anwenden einer Vorlage vornehmen, wirken sich nicht auf die Vorlage aus und wirken sich auch nicht auf andere Aktionen aus, die die Vorlage verwenden.
Array-Datenpillen
Objekte, die Array-Daten enthalten, erfordern möglicherweise Für Jeden Flow-Logik zu verarbeiten. Zum Beispiel erfordert ein Anwenderobjekt, das ein Array von E-Mail-Adressen enthält, eine Für Jeden Flow-Logikschleife zum Senden einer Benachrichtigung an jede E-Mail-Adresse.
Objektdatenpillen
Sie können Aktionen entwerfen, die Objektdatenpillen als Eingabewerte akzeptieren. Sie können beispielsweise eine Benachrichtigungsaktion erstellen, die ein Anwenderobjekt als Eingabe akzeptiert. Wenn das Anwenderobjekt aus Werten für Vorname, Nachname und Adressen besteht, hat die Benachrichtigungsaktion Zugriff auf alle diese Werte. Um eine Aktionseingabe mit einer Objektdatenpille zu konfigurieren, müssen Sie ein Objekt früher im Flow erstellen.
Sie können eine Objektdatenpille oder eines ihrer untergeordneten Elemente verwenden, um eine Eingabe zu konfigurieren. Wenn Sie einen Eingabewert mit einer Objektdatenpille konfigurieren, Workflow-Studio Macht alle untergeordneten Elemente des Objekts schreibgeschützt, und die Aktion verwendet die vom Objekt bereitgestellten Werte. Sie können beispielsweise einen Flow erstellen, in dem eine Aktion ein Anwenderobjekt generiert und eine andere Aktion eine Benachrichtigung an den im Objekt angegebenen Anwender sendet.
Wenn Sie die untergeordneten Elemente eines Objekts konfigurieren, müssen Sie Datenpillen für jedes untergeordnete Element des Objekts manuell bereitstellen. Sie können beispielsweise das Anwenderobjekt manuell mit Datensatzwerten aus einer früheren Aktion konfigurieren.
Skriptunterstützung
Erstellen und referenzieren Sie komplexe Daten aus einem Skript. Verwenden Sie ein Skript, wenn Ihre Quelldaten aus einem Datenstrom, einer REST-Schritt-Antwort oder einem Schritt „Datensätze suchen“ stammen.Siehe Skriptunterstützung für komplexe Daten Weitere Informationen zum Skripting mit komplexen Daten.
Update-Satz-Unterstützung
Update-Sätze enthalten komplexe Objekte als Teil des Flows, Subflows oder der Aktion, in der sie definiert sind. Jede Änderung am übergeordneten Flow, Subflow oder Aktion erfasst automatisch die zugehörigen komplexen Daten.
Allgemeine Leitlinien
Befolgen Sie diese allgemeinen Richtlinien, um wiederverwendbare und wartbare Datenstrukturen zu erstellen.
- Minimieren Sie die Anzahl der untergeordneten Ebenen in der Hierarchie
- Je mehr untergeordnete Ebenen eine Datenstruktur hat, desto schwieriger ist es, eine Datenvariable in der Hierarchie anzuzeigen und auszuwählen. Sie können zwar Datenstrukturen mit einer beliebigen Anzahl untergeordneter Ebenen erstellen, es wird jedoch schwierig, Datenstrukturen mit mehr als sieben untergeordneten Ebenen zu navigieren und zu verstehen. Vermeiden Sie für eine optimale Anwender-Experience Datenstrukturen mit so vielen untergeordneten Ebenen, dass Sie horizontal scrollen müssen, um sie anzuzeigen und auszufüllen.
- Erstellen Sie ein separates Objekt für jeden Typ von Datensatzdaten
- Am Meisten Workflow-Studio Daten sind Datensatzdaten, unabhängig davon, ob sie aus einer Instanz oder einem externen System stammen. Diese Designmethode stellt sicher, dass Sie wissen, was das Objekt enthält und woher die Daten stammen.
- Erstellen Sie Datensatzdatenstrukturen neu
- Überprüfen Sie beim Erstellen von Objekten, die Datensatzdaten empfangen oder übertragen, die Datenbank-Wörterbucheinträge für diese Datensätze, und erstellen Sie übereinstimmende Objektdatenstrukturen. Angenommen, ein Objekt soll Daten aus den Tabellen „Incident“ und „Konfigurationselement“ enthalten. Sie können ein Zeichenfolgenelement für erstellen Kurzbeschreibung Feld in Incident Tabelle und ein Array von Zeichenfolgenelementen für das Feld Klasse in Konfigurationselement Tabelle .
- Erstellen Sie Objekte, um verschiedene Arten von Datensätzen zu kombinieren
- Wenn Sie Informationen aus mehreren Datensatztypen benötigen, erstellen Sie ein Objekt, das alle benötigten Informationen enthält. Sie können das Objekt dann verwenden, um Daten in zu formatieren oder zu analysieren Workflow-Studio.