Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Bloque de flujo en Amazon Connect: tabla de datos
Description (Descripción)
El bloque Tabla de datos de Amazon Connect le permite evaluar, enumerar o escribir datos de tablas de datos dentro de sus flujos de contactos. Este bloque facilita la toma de decisiones dinámica, las experiencias personalizadas de los clientes y la administración de datos al interactuar con los datos estructurados almacenados en las tablas de datos de Amazon Connect.
Casos de uso
Los bloques de tablas de datos son útiles para:
-
Recuperación de la configuración: acceda a las reglas comerciales, los parámetros de enrutamiento o la configuración operativa almacenados en las tablas de datos.
-
Decisiones de enrutamiento dinámico: consulte las tablas de datos para determinar la cola, el agente o la ruta de flujo adecuados en función de los atributos del cliente.
-
Comprobaciones de estado: verifique el estado de la cuenta, su elegibilidad u otras condiciones antes de proceder con acciones específicas.
Canales compatibles
En la siguiente tabla se enumera cómo enruta este bloque a un contacto que está utilizando el canal especificado.
| Canal | ¿Se admite? |
|---|---|
Voz |
Sí |
Chat |
Sí |
Tarea |
Sí |
Correo electrónico |
Sí |
Tipos de flujo
Puede utilizar este bloque en los siguientes tipos de flujo:
-
Todos los flujos
Descripción general de la configuración
Seleccione una acción
Elija el tipo de operación que desee realizar:
-
Leer de la tabla de datos: consulta o recupera datos (acciones de evaluación o lista)
-
Escribir en la tabla de datos: cree nuevos registros o actualice los registros existentes
Defina la tabla de datos
-
Elija Establecer manualmente para seleccionar directamente una tabla de datos
-
Seleccione la tabla de datos de destino en el menú desplegable
-
Importante: una vez que selecciona una tabla de datos específica, la interfaz rellena automáticamente los atributos disponibles de esa tabla en las secciones de configuración correspondientes
Evaluar los valores de la tabla de datos
Utilice la acción Evaluar para consultar tablas de datos y recuperar valores de atributos específicos en función de criterios definidos.
La siguiente imagen muestra la página de propiedades del bloque de tabla de datos configurado para evaluar los valores de la tabla de datos.
Pasos de configuración
-
Seleccione Leer de la tabla de datos como acción.
-
Seleccione Evaluar los valores de la tabla de datos en el menú desplegable de acciones de lectura.
-
Configure las consultas:
-
Puede configurar hasta 5 consultas por bloque de tabla de datos. Se requiere al menos una consulta para cada bloque de evaluación de la tabla de datos.
-
Para cada consulta:
-
Nombre de consulta (obligatorio): proporcione un nombre descriptivo para la consulta. Importante: Los nombres de las consultas deben ser únicos en todo el flujo, no solo dentro de este bloque específico.
-
Atributos principales: al seleccionar manualmente una tabla de datos, la interfaz de usuario rellena automáticamente la lista de atributos principales del esquema de esa tabla. Todos los campos de atributos principales son obligatorios; debe proporcionar valores para cada atributo principal que se muestre. Estos atributos actúan como filtros para identificar las filas específicas de la tabla de datos.
-
Consulta los atributos: al seleccionar manualmente una tabla de datos, el menú desplegable se rellena automáticamente con todos los atributos disponibles de esa tabla. Seleccione uno o más atributos del menú desplegable. Estos son los campos de datos que se devolverán y estarán disponibles para su uso en su flujo. Se puede hacer referencia a los valores recuperados en los bloques siguientes utilizando el nombre de la consulta.
-
-
Detalles clave de Evaluate
-
Límite de consultas: hasta 5 consultas por bloque
-
Requisito mínimo: se debe configurar al menos una consulta
-
Unicidad del nombre de la consulta: debe ser único en todo el flujo de contactos
-
Coincidencia de atributos: los atributos principales utilizan la coincidencia exacta para localizar las filas
-
Campos obligatorios: todos los atributos principales son obligatorios
Acceso a los datos recuperados para Evaluate
Tras ejecutar una acción de evaluación, puede acceder a los valores de los atributos recuperados mediante el siguiente formato de espacio de nombres: $.DataTables.<QueryName>.<AttributeName>
-
Componentes:
-
QueryName— El nombre único que asignó a la consulta en la configuración -
AttributeName— El nombre del atributo que seleccionó para recuperar
-
-
Uso: se puede hacer referencia a estos valores en bloques de flujo posteriores, como:
-
Compruebe los bloques de atributos de contacto (para la ramificación condicional)
-
Configura bloques de atributos de contacto (para guardarlos en otros espacios de nombres)
-
Reproduce bloques de mensajes (para proporcionar mensajes personalizados)
-
Invoca bloques de funciones Lambda (para pasarlos como parámetros de entrada)
-
-
Ejemplo: si configuró una consulta llamada «» que recupera los atributos CustomerLookup «AccountStatus» y «LoyaltyTier»:
-
Estado de la cuenta de acceso:
$.DataTables.CustomerLookup.accountStatus -
Acceda al nivel de fidelización:
$.DataTables.CustomerLookup.loyaltyTier
-
-
Nota: Si la consulta no arroja resultados o no se encuentra el atributo, la referencia estará vacía o será nula.
Listar los valores de la tabla de datos
Utilice la acción Listar para recuperar filas enteras de una tabla de datos que coincidan con los criterios especificados.
La siguiente imagen muestra la página de propiedades del bloque de tabla de datos configurado para enumerar los valores de la tabla de datos.
Pasos de configuración
-
Seleccione Leer de la tabla de datos como acción.
-
Seleccione Listar los valores de la tabla de datos en el menú desplegable de acciones de lectura.
-
Configure los grupos de valores principales:
-
Puede añadir hasta 5 grupos de valores principales para definir diferentes conjuntos de criterios de filtrado.
-
Para cada grupo de valores principal:
-
Nombre del grupo (obligatorio): proporcione un nombre descriptivo para el grupo de valores principal. Este nombre se utilizará para hacer referencia al conjunto de registros recuperado en los bloques de flujo siguientes. Importante: Los nombres de los grupos deben ser únicos en todo el flujo, no solo dentro de este bloque específico.
-
Atributos principales: al seleccionar manualmente una tabla de datos, la interfaz de usuario rellena automáticamente la lista de atributos principales del esquema de esa tabla. Todos los campos de atributos principales son obligatorios; debe proporcionar valores para cada atributo principal que se muestre. Estos atributos actúan como filtros para identificar las filas específicas de la tabla de datos que se devolverán.
-
Nota: A diferencia de la acción Evaluar, que recupera valores de atributos específicos, la acción Listar devuelve registros completos (todos los atributos) que coinciden con los criterios de atributos principales.
-
Detalles clave de List
-
Límite de grupos de valores principales: hasta 5 grupos de valores principales por bloque
-
Unicidad del nombre del grupo: debe ser único en todo el flujo de contactos
-
Coincidencia de atributos: los atributos principales utilizan la coincidencia exacta para localizar las filas
-
Comportamiento de retorno: devuelve registros completos, no solo los atributos seleccionados. Si no se configura ningún grupo de valores principal, se cargará toda la tabla con un límite de 32 KB.
Acceder a los datos recuperados para List
Tras ejecutar una acción de lista, los datos recuperados se almacenan en un formato estructurado. Puede acceder a los datos mediante los siguientes patrones de espacio de nombres:
-
Acceso a los metadatos:
-
ID de tabla de datos:
$.DataTableList.Result.dataTableId -
Versión de bloqueo:
$.DataTableList.Result.lockVersion.dataTable
-
-
Acceso a los datos de la lista: para acceder a datos específicos de la lista:
-
Acceda a una fila específica por índice:
$.DataTableList.Result.primaryKeyGroups.<GroupName>[index] -
Acceda al valor de la clave principal:
$.DataTableList.Result.primaryKeyGroups.<GroupName>[index].primaryKeys[index].attributeValue -
Valor del atributo de acceso:
$.DataTableList.Result.primaryKeyGroups.<GroupName>[index].attributes[index].attributeValue
-
-
Uso: se puede hacer referencia a estos valores en bloques de flujo posteriores, como:
-
Establezca bloques de atributos de contacto (para extraer y almacenar valores específicos)
-
Invoque bloques o módulos de funciones Lambda (para pasar todo el conjunto de resultados para su procesamiento)
-
-
Ejemplo: si configuró un grupo de valores principal denominado "«: OrderHistory
-
Acceda a la primera fila:
$.DataTableList.Result.primaryKeyGroups.OrderHistory[0] -
Acceda al valor de atributo de la primera fila:
$.DataTableList.Result.primaryKeyGroups.OrderHistory[0].attributes[0].attributeValue
-
-
Nota:
-
La lista devuelve registros completos (todos los atributos), no solo los seleccionados
-
Si no se encuentra ningún registro coincidente, la primaryKeyGroups matriz estará vacía
-
Cuando no se configura ningún grupo de claves principal, se carga toda la tabla y se puede acceder a los resultados con un nombre de grupo «predeterminado»:
$.DataTableList.Result.primaryKeyGroups.default[index]
-
Escribir en la tabla de datos
Utilice la acción Escribir para crear nuevos registros o actualizar los registros existentes en una tabla de datos.
La siguiente imagen muestra la página de propiedades del bloque de tabla de datos configurado para escribir en una tabla de datos.
Pasos de configuración
-
Seleccione Escribir en la tabla de datos como acción.
-
Configure los grupos de valores principales:
-
Puede agregar varios grupos de valores principales para definir distintos registros que desee escribir o actualizar. Se requiere al menos un grupo de valores principal para cada bloque de escritura de tabla de datos.
-
La interfaz proporciona dos métodos de entrada mediante pestañas:
-
Pestaña de entrada: configuración estructurada basada en formularios (recomendada para la mayoría de los usuarios)
-
Pestaña JSON sin procesar: entrada JSON directa para usuarios avanzados
-
-
Para cada grupo de valores principal:
-
Nombre del grupo (obligatorio): proporcione un nombre descriptivo para el grupo de valores principal. Este nombre se utilizará para hacer referencia a la operación de escritura en los bloques de flujo siguientes. Importante: Los nombres de los grupos deben ser únicos en todo el flujo, no solo dentro de este bloque específico.
-
Atributos principales: al seleccionar manualmente una tabla de datos, la interfaz de usuario rellena automáticamente la lista de atributos principales del esquema de esa tabla. Todos los campos de atributos principales son obligatorios; debe proporcionar valores para cada atributo principal que se muestre. Estos atributos funcionan como campos clave que determinan qué registro se va a crear o actualizar. Si existe un registro con valores de atributos principales coincidentes, se actualizará; de lo contrario, se creará un registro nuevo.
-
Configure los atributos para escribirlos
-
Nombre de atributo (obligatorio): al seleccionar manualmente una tabla de datos, el menú desplegable se rellena automáticamente con todos los atributos disponibles de esa tabla. Seleccione el atributo que desee escribir o actualizar. Puede añadir varios atributos haciendo clic en Añadir atributo para escribirlos.
-
Configuración del valor de los atributos: para cada atributo, elija una de las siguientes opciones:
-
Definir el valor del atributo (seleccionado de forma predeterminada): especifique el valor que se va a escribir en el atributo. Este campo es obligatorio cuando se selecciona esta opción. Los valores pueden ser texto estático, atributos de contacto o variables del sistema.
-
Usar valor predeterminado: usa el valor predeterminado definido en el esquema de la tabla de datos. No es necesario introducir ningún valor adicional cuando se selecciona esta opción.
-
-
-
Configurar la versión de bloqueo: la configuración de la versión de bloqueo controla cómo se gestionan las operaciones de escritura simultáneas en la tabla de datos:
-
Usar la opción más reciente: siempre se escribe en la versión más reciente del registro. Adecuado para la mayoría de los casos de uso en los que las actualizaciones simultáneas son poco probables o aceptables.
-
Opción Establecer dinámicamente: le permite especificar el número de versión de forma dinámica en tiempo de ejecución mediante Lambda o un módulo.
-
-
-
Límite de atributos para Write
La acción Escribir tiene un límite total de 25 atributos en todos los grupos de valores principales de un solo bloque. Este límite se calcula de la siguiente manera:
-
Si un grupo de valores principal no tiene configurados los «Atributos para escribir», el recuento de valores de atributos principales de ese grupo se cuenta para el límite total
-
Si un grupo de valores principal tiene configurados los «Atributos para escribir», el recuento de atributos para escribir se cuenta para el límite total (los atributos principales no se cuentan en este caso)
Ejemplos:
-
Ejemplo 1: Un grupo de valores principal con 3 atributos principales y ningún atributo que escribir es igual a 3 para el límite
-
Ejemplo 2: Un grupo de valores principal con 3 atributos principales y 5 atributos para escribir = 5 hacia el límite
-
Ejemplo 3: Tres grupos de valores principales, cada uno con 3 atributos principales y 5 atributos para escribir = 15 (5 + 5 + 5) hacia el límite
Importante: La suma de todos los atributos contados en todos los grupos de valores principales no debe superar los 25.
Detalles clave de Write
-
Requisito mínimo: se debe configurar al menos un grupo de valores principal
-
Sin límite en los grupos de valores principales: a diferencia de la acción Listar, no hay un límite fijo en el número de grupos de valores principales
-
Límite de atributos: la suma total de los atributos contados en todos los grupos de valores principales no debe superar los 25
-
Coincidencia de atributos: los atributos principales utilizan la coincidencia exacta para identificar el registro de destino
-
Campos obligatorios: todos los atributos principales y los valores de atributo seleccionados (si se selecciona «Establecer valor de atributo») son obligatorios
-
Comportamiento molesto: si existe un registro con atributos principales coincidentes, se actualizará; de lo contrario, se creará un registro nuevo
Bloque configurado
Cuando se configura, este bloque tiene las ramas Success y Error.
