Flow-Block in Amazon Connect: Datentabelle - Amazon Connect
DescriptionAnwendungsfälleUnterstützte KanäleFlow-TypenÜberblick über die KonfigurationWerte in der Datentabelle auswertenWerte in der Datentabelle auflistenIn die Datentabelle schreibenKonfigurierter Block

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Flow-Block in Amazon Connect: Datentabelle

Description

Mit dem Datentabellenblock in Amazon Connect können Sie Daten aus Datentabellen in Ihren Kontaktabläufen auswerten, auflisten oder schreiben. Dieser Block erleichtert dynamische Entscheidungen, personalisierte Kundenerlebnisse und Datenmanagement, indem er mit strukturierten Daten interagiert, die in Ihren Amazon Connect Connect-Datentabellen gespeichert sind.

Anwendungsfälle

Datentabellenblöcke sind nützlich für:

  • Konfigurationsabruf — Greifen Sie auf Geschäftsregeln, Routing-Parameter oder Betriebseinstellungen zu, die in Datentabellen gespeichert sind.

  • Dynamische Routing-Entscheidungen — Fragen Sie Datentabellen ab, um anhand von Kundenattributen die passende Warteschlange, den geeigneten Agenten oder den passenden Flow-Pfad zu ermitteln.

  • Statusprüfungen — Überprüfen Sie den Kontostatus, die Eignung oder andere Bedingungen, bevor Sie mit bestimmten Aktionen fortfahren.

Unterstützte Kanäle

In der folgenden Tabelle sind die Block-Weiterleitungsoptionen für einen Kontakt im vorgegebenen Kanal aufgeführt.

Kanal Unterstützt?

Stimme

Ja

Chat

Ja

Aufgabe

Ja

Email

Ja

Flow-Typen

Sie können diesen Block in den folgenden Flow-Typen verwendet:

  • Alle Flows

Überblick über die Konfiguration

Wählen Sie eine Aktion aus

Wählen Sie die Art der Operation, die Sie ausführen möchten:

  • Aus Datentabelle lesen — Daten abfragen oder abrufen (Aktionen auswerten oder auflisten)

  • In Datentabelle schreiben — Neue Datensätze erstellen oder bestehende Datensätze aktualisieren

Definieren Sie die Datentabelle

  • Wählen Sie Manuell festlegen, um direkt eine Datentabelle auszuwählen

  • Wählen Sie Ihre Zieldatentabelle aus der Dropdownliste

  • Wichtig: Sobald Sie eine bestimmte Datentabelle ausgewählt haben, füllt die Schnittstelle automatisch die verfügbaren Attribute aus dieser Tabelle in den entsprechenden Konfigurationsabschnitten aus

Werte in der Datentabelle auswerten

Verwenden Sie die Aktion Auswerten, um Datentabellen abzufragen und bestimmte Attributwerte auf der Grundlage definierter Kriterien abzurufen.

Die folgende Abbildung zeigt die Eigenschaftenseite des Datentabellenblocks, der für die Auswertung von Datentabellenwerten konfiguriert ist.

Die Eigenschaftenseite des Datentabellenblocks, der für die Aktion Auswerten konfiguriert ist.

Schritte zur Konfiguration

  1. Wählen Sie Als Aktion die Option Aus Datentabelle lesen aus.

  2. Wählen Sie in der Dropdownliste für die Leseaktion die Option Werte der Datentabelle auswerten aus.

  3. Abfragen konfigurieren:

    • Sie können bis zu 5 Abfragen pro Datentabellenblock einrichten. Für jeden Block „Datentabelle auswerten“ ist mindestens eine Abfrage erforderlich.

    • Für jede Abfrage:

      • Abfragename (erforderlich) — Geben Sie einen beschreibenden Namen für die Abfrage ein. Wichtig: Abfragenamen müssen im gesamten Ablauf eindeutig sein, nicht nur innerhalb dieses bestimmten Blocks.

      • Primäre Attribute — Wenn Sie eine Datentabelle manuell auswählen, füllt die Benutzeroberfläche automatisch die Liste der primären Attribute aus dem Schema dieser Tabelle. Alle primären Attributfelder sind erforderlich. Sie müssen Werte für jedes angezeigte primäre Attribut angeben. Diese Attribute dienen als Filter, um die spezifischen Zeilen in Ihrer Datentabelle zu identifizieren.

      • Attribute abfragen — Wenn Sie eine Datentabelle manuell auswählen, wird das Drop-down-Menü automatisch mit allen verfügbaren Attributen aus dieser Tabelle gefüllt. Wählen Sie ein oder mehrere Attribute aus der Dropdownliste aus. Dies sind die Datenfelder, die zurückgegeben und zur Verwendung in Ihrem Flow zur Verfügung gestellt werden. Auf abgerufene Werte kann in nachfolgenden Blöcken mithilfe des Abfragenamens verwiesen werden.

Wichtige Details für Evaluate

  • Abfragelimit — Bis zu 5 Abfragen pro Block

  • Mindestanforderung — Mindestens eine Abfrage muss konfiguriert sein

  • Eindeutigkeit des Abfragenamens — Muss im gesamten Kontaktablauf eindeutig sein

  • Attributabgleich — Primäre Attribute verwenden exakte Übereinstimmung, um Zeilen zu finden

  • Pflichtfelder — Alle primären Attribute sind Pflichtfelder

Zugreifen auf abgerufene Daten für Evaluate

Nachdem Sie eine Evaluate-Aktion ausgeführt haben, können Sie mithilfe des folgenden Namespace-Formats auf die abgerufenen Attributwerte zugreifen:$.DataTables.QueryName.AttributeName. Verwenden Sie Klammern und einfache Anführungszeichen, um auf Attributnamen mit Sonderzeichen zu verweisen. Beispiel, $.DataTables.CustomQuery['my attribute name with spaces']. Wenn Sie die dynamische Dropdownauswahl für Datentabellen-Namespace verwenden, kann der Stamm-Namespace,$.DataTables., weggelassen werden.

  • Komponenten:

    • QueryName— Der eindeutige Name, den Sie der Abfrage in der Konfiguration zugewiesen haben

    • AttributeName— Der Name des Attributs, das Sie zum Abrufen ausgewählt haben

  • Verwendung — Auf diese Werte kann in nachfolgenden Flow-Blöcken verwiesen werden, z. B.:

    • Überprüfen Sie die Blöcke mit Kontaktattributen (für bedingte Verzweigungen)

    • Lege Blöcke mit Kontaktattributen fest (um sie in anderen Namespaces zu speichern)

    • Abspielen von Aufforderungsblöcken (um personalisierte Nachrichten bereitzustellen)

    • Lambda-Funktionsblöcke aufrufen (zur Übergabe als Eingabeparameter)

  • Beispiel — Wenn Sie eine Abfrage mit dem Namen "CustomerLookup" konfiguriert haben, die die Attribute „AccountStatus“ und „LoyaltyTier“ abruft:

    • Auf den Kontostatus zugreifen: $.DataTables.CustomerLookup.accountStatus

    • Auf die Treuestufe zugreifen: $.DataTables.CustomerLookup.loyaltyTier

  • Hinweis:

    • Wenn die Abfrage keine Ergebnisse zurückgibt oder das Attribut nicht gefunden wird, ist die Referenz leer oder leer.

    • Datentabellenwerte vom Typ list werden nicht unterstützt.

    • Nachfolgende Datentabellenblöcke löschen vorherige Abfragen aus dem Datentabellen-Namespace.

    • Abfrageergebnisse im Datentabellen-Namespace sind nur in dem Flow verfügbar, der den Datenflussblock enthält.

Werte in der Datentabelle auflisten

Verwenden Sie die Aktion Liste, um ganze Zeilen aus einer Datentabelle abzurufen, die bestimmten Kriterien entsprechen.

Die folgende Abbildung zeigt die Eigenschaftenseite des Datentabellenblocks, der so konfiguriert ist, dass Datentabellenwerte aufgelistet werden.

Die Eigenschaftenseite des Datentabellenblocks, der für die Listenaktion konfiguriert ist.

Schritte zur Konfiguration

  1. Wählen Sie Als Aktion die Option Aus Datentabelle lesen aus.

  2. Wählen Sie in der Dropdownliste für die Leseaktion die Option Werte der Datentabelle auflisten aus.

  3. Primäre Wertegruppen konfigurieren:

    • Sie können bis zu 5 primäre Wertgruppen hinzufügen, um verschiedene Sätze von Filterkriterien zu definieren.

    • Für jede primäre Wertgruppe:

      • Gruppenname (erforderlich) — Geben Sie einen beschreibenden Namen für die primäre Wertgruppe ein. Dieser Name wird verwendet, um in nachfolgenden Flow-Blöcken auf den abgerufenen Datensatz zu verweisen. Wichtig: Gruppennamen müssen im gesamten Flow eindeutig sein, nicht nur innerhalb dieses bestimmten Blocks.

      • Primäre Attribute — Wenn Sie eine Datentabelle manuell auswählen, füllt die Benutzeroberfläche automatisch die Liste der primären Attribute aus dem Schema dieser Tabelle. Alle primären Attributfelder sind erforderlich. Sie müssen Werte für jedes angezeigte primäre Attribut angeben. Diese Attribute dienen als Filter, um die spezifischen Zeilen in Ihrer Datentabelle zu identifizieren, die zurückgegeben werden.

    Hinweis: Im Gegensatz zur Aktion Auswerten, bei der bestimmte Attributwerte abgerufen werden, gibt die Aktion „Liste“ ganze Datensätze (alle Attribute) zurück, die den primären Attributkriterien entsprechen.

Wichtige Details für List

  • Obergrenze für primäre Wertegruppen — Bis zu 5 primäre Wertegruppen pro Block

  • Eindeutigkeit des Gruppennamens — Muss im gesamten Kontaktablauf eindeutig sein

  • Attributabgleich — Primäre Attribute verwenden exakte Übereinstimmung, um Zeilen zu finden

  • Rückgabeverhalten — Gibt vollständige Datensätze zurück, nicht nur ausgewählte Attribute. Wenn keine primäre Wertgruppe konfiguriert ist, wird die gesamte Tabelle mit einem Limit von 32 KB geladen.

Zugreifen auf abgerufene Daten für List

Nach der Ausführung einer Listenaktion werden die abgerufenen Daten in einem strukturierten Format gespeichert. Sie können mit den folgenden Namespace-Mustern auf die Daten zugreifen:

  • Zugriff auf Metadaten:

    • ID der Datentabelle: $.DataTableList.ResultData.dataTableId

    • Version sperren: $.DataTableList.ResultData.lockVersion.dataTable

  • Zugriff auf Listendaten — Um auf bestimmte Daten aus der Liste zuzugreifen:

    • Greifen Sie über den Index auf eine bestimmte Zeile zu: $.DataTableList.ResultData.primaryKeyGroups.GroupName[index]

    • Auf den Wert des Primärschlüssels zugreifen: $.DataTableList.ResultData.primaryKeyGroups.GroupName[index].primaryKeys[index].attributeValue

    • Wert des Zugriffsattributs: $.DataTableList.ResultData.primaryKeyGroups.GroupName[index].attributes[index].attributeValue

  • Verwendung — Auf diese Werte kann in nachfolgenden Flow-Blöcken verwiesen werden, z. B.:

    • Legen Sie Blöcke mit Kontaktattributen fest (um bestimmte Werte zu extrahieren und zu speichern)

    • Rufen Sie Lambda-Funktionsblöcke oder ein Modul auf (um die gesamte Ergebnismenge zur Verarbeitung zu übergeben)

  • Beispiel — Wenn Sie eine primäre Wertegruppe mit dem Namen "„OrderHistorykonfiguriert haben:

    • Greifen Sie auf die erste Zeile zu: $.DataTableList.ResultData.primaryKeyGroups.OrderHistory[0]

    • Greifen Sie auf den ersten Attributwert der ersten Zeile zu: $.DataTableList.ResultData.primaryKeyGroups.OrderHistory[0].attributes[0].attributeValue

  • Hinweis:

    • Die Liste gibt vollständige Datensätze (alle Attribute) zurück, nicht nur ausgewählte

    • Wenn keine passenden Datensätze gefunden werden, ist das primaryKeyGroups Array leer

    • Wenn keine Primärschlüsselgruppe konfiguriert ist, wird die gesamte Tabelle geladen und die Ergebnisse sind unter einem „Standard“ -Gruppennamen zugänglich: $.DataTableList.ResultData.primaryKeyGroups.default[index]

    • Wenn Sie auf Array-Elemente in Flow-Blöcken zugreifen, verwenden Sie Backticks, um die JSONPath Referenz zu umbrechen: `$.DataTableList.ResultData.primaryKeyGroups.<GroupName>[index]`

In die Datentabelle schreiben

Verwenden Sie die Aktion Schreiben, um neue Datensätze zu erstellen oder bestehende Datensätze in einer Datentabelle zu aktualisieren.

Die folgende Abbildung zeigt die Eigenschaftenseite des Datentabellenblocks, der für das Schreiben in eine Datentabelle konfiguriert ist.

Die Eigenschaftenseite des Datentabellenblocks, der für die Schreibaktion konfiguriert ist.

Schritte zur Konfiguration

  1. Wählen Sie Als Aktion In Datentabelle schreiben aus.

  2. Primäre Wertegruppen konfigurieren:

    • Sie können mehrere primäre Wertgruppen hinzufügen, um verschiedene Datensätze zu definieren, die geschrieben oder aktualisiert werden sollen. Für jeden Block vom Typ Write Data Table ist mindestens eine primäre Wertgruppe erforderlich.

    • Die Schnittstelle bietet zwei Eingabemethoden über Tabs:

      • Registerkarte „Eingabe“ — Strukturierte, formularbasierte Konfiguration (für die meisten Benutzer empfohlen)

      • Registerkarte „Raw JSON“ — Direkte JSON-Eingabe für fortgeschrittene Benutzer

    • Für jede primäre Wertgruppe:

      • Gruppenname (erforderlich) — Geben Sie einen beschreibenden Namen für die primäre Wertgruppe ein. Dieser Name wird verwendet, um in nachfolgenden Flow-Blöcken auf den Schreibvorgang zu verweisen. Wichtig: Gruppennamen müssen im gesamten Flow eindeutig sein, nicht nur innerhalb dieses bestimmten Blocks.

      • Primäre Attribute — Wenn Sie eine Datentabelle manuell auswählen, füllt die Benutzeroberfläche automatisch die Liste der primären Attribute aus dem Schema dieser Tabelle. Alle primären Attributfelder sind erforderlich. Sie müssen Werte für jedes angezeigte primäre Attribut angeben. Diese Attribute dienen als Schlüsselfelder, die bestimmen, welcher Datensatz erstellt oder aktualisiert wird. Wenn ein Datensatz mit übereinstimmenden primären Attributwerten vorhanden ist, wird er aktualisiert. Andernfalls wird ein neuer Datensatz erstellt.

      • Konfigurieren Sie die zu schreibenden Attribute

        • Attributname (erforderlich) — Wenn Sie eine Datentabelle manuell auswählen, wird die Dropdownliste automatisch mit allen verfügbaren Attributen aus dieser Tabelle gefüllt. Wählen Sie das Attribut aus, das Sie schreiben oder aktualisieren möchten. Sie können mehrere Attribute hinzufügen, indem Sie auf Zu schreibendes Attribut hinzufügen klicken.

        • Konfiguration von Attributwerten — Wählen Sie für jedes Attribut eine der folgenden Optionen aus:

          • Attributwert festlegen (standardmäßig ausgewählt) — Geben Sie den Wert an, der in das Attribut geschrieben werden soll. Dieses Feld ist erforderlich, wenn diese Option ausgewählt ist. Werte können statischer Text, Kontaktattribute oder Systemvariablen sein.

          • Standardwert verwenden — Verwendet den im Datentabellenschema definierten Standardwert. Wenn diese Option ausgewählt ist, ist keine zusätzliche Werteingabe erforderlich.

      • Version sperren konfigurieren — Die Einstellung Version sperren steuert, wie gleichzeitige Schreibvorgänge in Datentabellen behandelt werden:

        • Option „Letzte Version verwenden“ — Schreibt immer in die neueste Version des Datensatzes. Geeignet für die meisten Anwendungsfälle, in denen gleichzeitige Aktualisierungen unwahrscheinlich oder akzeptabel sind.

        • Option dynamisch festlegen — Ermöglicht die dynamische Angabe der Versionsnummer zur Laufzeit über Lambda oder ein Modul.

Attributlimit für Write

Die Aktion Schreiben hat eine Gesamtattributbeschränkung von 25 für alle primären Wertegruppen in einem einzigen Block. Dieser Grenzwert wird wie folgt berechnet:

  • Wenn für eine primäre Wertgruppe keine „Zu schreibenden Attribute“ konfiguriert sind, wird die Anzahl der primären Attributwerte in dieser Gruppe auf den Gesamtgrenzwert angerechnet

  • Wenn für eine primäre Wertgruppe „Zu schreibende Attribute“ konfiguriert ist, wird die Anzahl der zu schreibenden Attribute auf das Gesamtlimit angerechnet (primäre Attribute werden in diesem Fall nicht mitgezählt)

Beispiele:

  • Beispiel 1: Eine primäre Wertgruppe mit 3 primären Attributen und ohne zu schreibende Attribute = 3 auf den Grenzwert

  • Beispiel 2: Eine primäre Wertgruppe mit 3 primären Attributen und 5 Attributen, die geschrieben werden sollen, entspricht dem Grenzwert von 5

  • Beispiel 3: Drei primäre Wertegruppen mit jeweils 3 primären Attributen und 5 zu schreibenden Attributen = 15 (5 + 5 + 5) bis zum Grenzwert

Wichtig: Die Summe aller gezählten Attribute in allen primären Wertgruppen darf 25 nicht überschreiten.

Wichtige Details für Write

  • Mindestanforderung — Es muss mindestens eine primäre Wertgruppe konfiguriert werden

  • Keine Obergrenze für primäre Wertgruppen — Im Gegensatz zur Aktion „Liste“ gibt es kein festes Limit für die Anzahl der primären Wertgruppen

  • Attributlimit — Die Gesamtsumme der gezählten Attribute in allen primären Wertegruppen darf 25 nicht überschreiten

  • Attributabgleich — Primäre Attribute verwenden die exakte Übereinstimmung, um den Zieldatensatz zu identifizieren

  • Pflichtfelder — Alle primären Attribute und ausgewählten Attributwerte (wenn „Attributwert festlegen“ ausgewählt ist) sind Pflichtfelder

  • Upsert-Verhalten — Wenn ein Datensatz mit übereinstimmenden primären Attributen vorhanden ist, wird er aktualisiert. Andernfalls wird ein neuer Datensatz erstellt

Konfigurierter Block

Wenn dieser Block konfiguriert ist, enthält er Verzweigungen für Erfolg und Fehler.