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 einzelne Elemente hinzuzufügen, zu entfernen oder zu konfigurieren.
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 die Schnittstelle Workflow-Studio verwenden, um die Organisation strukturierter Daten anzuzeigen und zu verstehen sowie Datenstrukturen zu erstellen. Sie können beispielsweise eine Kontaktdatenstruktur erstellen, die aus Informationen besteht, die Sie in einem Benutzerdatensatz suchen, z. B. Vorname, Nachname und E-Mail-Adresse.
Sie können komplexe Daten aus diesen Workflow-Studio -Schnittstellen erstellen.
| Workflow-StudioSchnittstelle | Beispielverwendung |
|---|---|
| Aktionseingaben und -ausgaben | Erstellen Sie eine Aktion, die ein Objekt aus Datensatzdaten generiert. Füllen Sie das Objekt mit Datensatzdaten aus, nach denen die Aktion sucht. Siehe Erstellen Sie eine anwenderdefinierte Aktion, um ein Objekt aus einem Datensatz zu generieren |
| Eingabe- und Ausgabevariablen für Skriptschritte | 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 mithilfe des XML-Parser-Schritts in ein komplexes Datenobjekt. |
| Feld REST API-Auslösertext | Analysieren Sie eine eingehende REST-API-Anforderung in ein komplexes Datenobjekt, und verwenden Sie die Werte in einem Flow. Weitere Informationen finden Sie unter REST-API-Auslöser. |
Vorteile
- Analysieren und formatieren Sie Daten, 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 zur Unterstützung einer anwenderdefinierten Integration.
- Zeigen Sie die Organisation von Datenstrukturen an. Beispielsweise kann eine Problemdatenstruktur aus einem Benutzerobjekt bestehen, um zu beschreiben, an wen Sie sich bezüglich des Problems wenden können, und einem Verlaufsobjekt, um die zur Lösung des Problems durchgeführten Arbeiten zu beschreiben. Sie können eine Benachrichtigungsaktion mit dem Pfad zu der im Benutzerobjekt aufgeführten E-Mail-Adresse konfigurieren und einen Subflow zum Eskalieren von Problemen mit dem Pfad zum Status oder zur Anzahl der Neuzuweisungen aus dem Verlaufsobjekt aufrufen.
- Erlauben Sie den Zugriff auf die Datenstruktur über API-Aufrufe. Rufen Sie beispielsweise eine Aktion oder einen Subflow aus einem Skript auf und verwenden Sie die vordefinierte Datenstruktur als Eingabewerte.
- Speichern und wiederverwenden Sie Datenstrukturen als Vorlagen. Speichern Sie beispielsweise das Anwenderobjekt als Vorlagendatenstruktur zur Wiederverwendung in anderen Aktionen und Flows.
Datenstruktur
Eine Datenstruktur ist eine Sammlung verwandter Datenelemente, die in einer Hierarchie organisiert sind. Jedes Element in einer Datenstruktur hat einen eigenen Datentyp und eine 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 wie bei Datensatzvariablen als Baumstruktur aus reduzier- und erweiterbaren Datenpillen angezeigt. Übergeordnete Elemente haben ein Pfeilsymbol zum Reduzieren oder Erweitern der Hierarchie.
Hier sehen Sie beispielsweise die Datenstruktur für Mitarbeiter, wie sie im Datenbereich zu sehen ist.
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 der Art, wie Sie einen Dot-Walking durchführen oder zu bestimmten Elementen innerhalb der Struktur navigieren können. Wenn Sie ein Datenelement auswählen, zeigt Workflow-Studio den Pfad dazu wie bei jeder anderen Datenelementauswahl als Datenpille an. Wenn Sie beispielsweise das Datenelement Startdatum auswählen, lautet der Pfad [Eingabe->Mitarbeiter->Startdatum].
Sie können einen Elementdatenpfad auf die gleiche Weise wie einen XPath- oder JPath-Pfad verwenden. Manchmal können Sie sogar den Datenpillenpfad in eine dieser Pfadnotationen konvertieren.
Komplexe Datentypen
Sie erstellen Datenstrukturen mit einer oder mehreren Array- oder Objektvariablen. Nur diese variablen Datentypen unterstützen untergeordnete Variablen.
Eine Array-Variable enthält Werte für einen Elementtyp. Die übergeordnete Variable hat immer den Datentyp „Array“, 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_Untergeordnetes Element0 | Zeichenfolge |
Eine Objektvariable enthält eine beliebige Anzahl und Anordnung von untergeordneten Variablen, die jeweils über eigene Datentypen und Werte verfügen. Durch das Verschachteln von Objektvariablen können Sie komplexe Datenstrukturen erstellen, die einem Tabellenschema ähneln, 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 variablen Datentypen 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 ganzzahlige Werte. 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, für das die Option „Untergeordnetes Element hinzufügen“ angezeigt wird. |
| 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 die Option Untergeordnetes Element hinzufügen an. |
- 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 an einem Ort definierte Datenstruktur an einem anderen Ort wiederverwenden. Einzelheiten 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 diese Datenstruktur später wiederverwenden, um eine Anforderung zu formatieren. Eine Vorlage speichert die Liste der untergeordneten Variablen und ihre Struktur innerhalb eines Objekts. Jede Objektvariable verfügt über eine erweiterte Option zum Speichern als Vorlage.
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 selbst und auch nicht auf andere Aktionen aus, die die Vorlage verwenden.
Array-Datenpillen
Objekte, die Array-Daten enthalten, erfordern möglicherweise die Flow-Logik „Für jeden“ zur Verarbeitung. Zum Beispiel würde ein Benutzerobjekt, das ein Array von E-Mail-Adressen enthält, eine For-Each- Flow-Logikschleife erfordern, um eine Benachrichtigung an jede E-Mail-Adresse zu senden.
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 Benutzerobjekt 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 zuvor im Flow ein Objekt 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, legt Workflow-Studio alle untergeordneten Elemente des Objekts schreibgeschützt, und die Aktion verwendet die vom Objekt bereitgestellten Werte. Sie können beispielsweise einen Flow erstellen, bei dem eine Aktion ein Benutzerobjekt generiert und eine andere Aktion eine Benachrichtigung an den im Objekt angegebenen Benutzer 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 das Benutzerobjekt beispielsweise manuell mit Datensatzwerten aus einer früheren Aktion konfigurieren.
Skript-Unterstützung
Erstellen und referenzieren Sie komplexe Daten aus einem Skript. Verwenden Sie ein Skript, wenn Ihre Quelldaten aus einem Datenstrom, einer REST-Schrittantwort oder dem Schritt „Datensätze suchen“ stammen. Unter Skriptunterstützung für komplexe Daten finden Sie weitere Informationen zur Skripterstellung mit komplexen Daten.
Unterstützung für Update Sets
Update Sets enthalten komplexe Objekte als Teil des Flows, Subflows oder der Aktion, in denen sie definiert sind. Bei jeder Änderung des übergeordneten Flows, Subflows oder der Aktion werden die zugehörigen komplexen Daten automatisch erfasst.
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 komplexer ist es, eine Datenvariable anzuzeigen und in der Hierarchie auszuwählen. Sie können zwar Datenstrukturen mit einer beliebigen Anzahl von untergeordneten Ebenen erstellen, aber es wird schwierig, in Datenstrukturen mit mehr als sieben untergeordneten Ebenen zu navigieren und sie zu verstehen. Vermeiden Sie für eine optimale Anwender-Experience das Erstellen von Datenstrukturen mit so vielen untergeordneten Ebenen, dass Sie horizontal scrollen müssen, um sie anzuzeigen und zu füllen.
- Erstellen Sie ein separates Objekt für jeden Typ von Datensatzdaten
- Die meisten Workflow-Studio -Daten sind Datensatzdaten, unabhängig davon, ob sie aus einer Instanz oder einem externen System stammen. Diese Entwurfsmethode stellt sicher, dass Sie wissen, was das Objekt enthält und woher die Daten stammen.
- Erstellen Sie die Datenstrukturen des Datensatzes 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 entsprechende Objektdatenstrukturen. Angenommen, ein Objekt soll Daten aus den Tabellen „Incident“ und „Konfigurationselement“ enthalten. Sie können ein Zeichenfolgenelement für das Feld Kurzbeschreibung in der Tabelle Incident und ein Array von Zeichenfolgenelement für das Feld Klasse in der Tabelle Konfigurationselementerstellen.
- Erstellen Sie Objekte, um verschiedene Arten von Datensätzen zu kombinieren
- Wenn Sie Informationen aus mehreren Arten von Datensätzen benötigen, erstellen Sie ein Objekt, das alle benötigten Informationen enthält. Anschließend können Sie das Objekt zum Formatieren oder Analysieren von Daten in Workflow-Studioverwenden.