Komplexe Daten

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 8 Minuten Lesedauer

    • 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.

    Tabelle : 1. Beispiele für die Verwendung komplexer Daten
    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. Weitere Informationen finden Sie unter 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

    Komplexe Daten bieten diese 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.

    Im Editor-Bereich wird die Datenstrukturhierarchie mit Einrückung angezeigt. Die Einrückebene gibt an, ob ein Element ein übergeordnetes, untergeordnetes oder gleichgeordnetes Element in der Hierarchie ist. Übergeordneten Elementen sind untergeordnete Elemente eingerückt, und gleichgeordnete Elemente haben dieselbe Einrückebene.
    Hinweis:
    Über die Schnittstelle Workflow-Studio können Sie Hierarchien mit einer unbegrenzten Anzahl von untergeordneten Ebenen erstellen. Möglicherweise müssen Sie jedoch horizontal scrollen, um sie anzuzeigen.

    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.

    Abbildung : 1. Beispieleingaben für ein Mitarbeiterobjekt
    Beispieleingaben für ein Mitarbeiterobjekt. Das Mitarbeiter-Objekt ist das übergeordnete Element. Es gibt untergeordnete Eingaben für ID-Nummer, Name, Startdatum und Kontakt-E-Mail.

    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.

    Abbildung : 2. Beispieldatenpille für ein Mitarbeiterobjekt
    Beispieldatenpille für das Mitarbeiterobjekt. Das Mitarbeiter-Objekt ist das übergeordnete Element. Es gibt untergeordnete Eingaben für ID-Nummer, Name, Startdatum und Kontakt-E-Mail.

    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.

    Tabelle : 2. Beispieldatenstruktur für das Array „Kontakt-E-Mail“.
    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.

    Tabelle : 3. Beispieldatenstruktur für das Mitarbeiterobjekt
    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.

    Tabelle : 4. Übergeordnete Datentypen
    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- und Objektvariablen unterstützen nur diese untergeordneten Datentypen.
    • Array
    • Wahr/Falsch
    • Auswahl
    • Datum/Uhrzeit
    • Ganzzahl
    • Objekt
    • Zeichenfolge
    Hinweis:
    Die Datentypen in Array- und Objektvariablen sind keine Glide-Elemente. Möglicherweise besteht keine vollständige Kompatibilität zwischen diesen Elementen und den Now Platform-Typen.

    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.

    Abbildung : 3. Beispielaktion, die eine Objektdatenpille akzeptiert
    Beispielaktion in einem Flow. Es gibt Eingaben für Anwender, Vorname, Nachname, Adressen und Adresse 1.

    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.

    Abbildung : 4. Beispielaktion, die für die Verwendung einer Objektdatenpille konfiguriert ist
    Beispielaktion in einem Flow. Es gibt Eingaben für Anwender, Vorname, Nachname, Adressen und Adresse 1. Die Eingabe „Anwender“ enthält die Datenpille [2->Anwenderobjekt].

    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 TabelleKonfigurationselement [] erstellen.
    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.