Call Decision Table action

Rule-based decisions: Feature coming soon

Use the Call Decision Table action within a task to select and execute a rule-based decision table configured previously by an administrator in Genesys Cloud. When you call a decision table, you bring the associated input and output JSON schemas into the flow. Architect handles these JSON schemas as custom JSON data types that are available only with the Call Decision Table action. However, after you add a Call Decision Table action to your flow, you can also use the custom JSON data type with an Update Data action

Decision tables allow administrators to define input and output criteria, and if the input values meet the set criteria, the decision table produces an output. Flow authors can call a decision table, define the input values, and then use the output JSON object that the decision table produces for further processing in the flow. For more information about decision tables, see About Decision Tables.  

  1. Desde la página de inicio de Architect, haga clic o coloque el cursor sobre el Flujos menú y seleccione el tipo de flujo deseado.
  2. Cree un nuevo flujo o seleccione uno existente. Se abre la página de configuración del flujo.
  3. Seleccione la tarea y haga clic en Haga clic para abrir. Se abre el editor de tareas.
  4. From the task editor Toolbox, expand the Data category and drag a Call Decision Table action to the desired location in the task editor.
  5. In the Name box type a meaningful name for the action. This name becomes the name of the Call Decision Table action in the task workflow.
  6. From the Decision Table list, choose the desired decision table.
  7. Depending on the rules schema of the selected decision table, define Input, Output, and Failure Outputs that the action executes at runtime.
    Note: The input properties that appear come from the input schema created for the decision table.
  8. Continue building the task per your flow design, including the Call Decision Table’s Success and Failure paths.

Nombre Descripción
Campo de nombre Type a distinctive name for the Call Decision Table action. The label you enter here becomes the action’s name displayed in the task sequence.
Decision Table

Click the arrow at the end of this list and select the appropriate decision table. To narrow the selection, type the first few letters of the appropriate decision table.

You can select any published decision table regardless of the division to which the decision table belongs. However, if your decision table has a queue data type, you can use the queue only in the applicable divisions.

Entrada

Define the input values the action carries out at runtime. Depending on how an administrator configures the decision table in Genesys Cloud, these options vary and may be optional.

Select Standard or JSON to toggle between the standard and JSON editing modes.

  • Standard: Allows you to define the input values in the provided input fields. The fields that appear come from the input schema created for the decision table. 
  • JSON: Allows you to define the input values directly using JSON properties. In this mode, you can access Architect’s custom JSON editor and its tools to define the input values. The editor displays the schema type, whether it is input or output, and the decision table. For more information about using the custom JSON editor, see Architect custom JSON editor.

Both the standard and JSON editing modes allow literals and expressions as the input values. If you have not set a property and its value in JSON mode, the corresponding field in standard mode indicates that no value is specified. 

Notas:

  • Architect retains the existing values when you switch between editing modes. If there are any validation errors at the time of switching the mode, Architect alerts you and provides an option to revert to the previous valid values or cancel switching the mode. 
  • If the custom JSON data has any complex value structure such as collections, you cannot switch back to standard editing mode.
  • Switching from literal to expression mode for the entire input object resets the input data. The option to access the custom JSON editor also disappears in expression mode.
Producción

Select an existing variable or enter a new variable to assign the output JSON object returned by the decision table. 

Note: Architect assigns the variable with the entire JSON object returned by the decision table, allowing you to access the JSON values using dot notation. For example, if you named the variable as Task.output, you can access the values contained in the output JSON object using an Update Data action with a variable expression, Task.output.<JSON property name>.

Null value handling

The following table shows how Null values that Architect sends as inputs are validated for decision table rules:

Input value in Architect Editing mode Mapped value in Decision Tables
No value Estándar

Nulo

Blank literal value

Note: This applies only to a string data type.

  • Estándar
  • JSON
Cadena vacía

Not_Set

  • Estándar
  • JSON
Nulo

Nulo

  • Estándar
  • JSON
Nulo

The Call Decision Table action supports the following data types for input and output variables:
  • Standard data types
    • Boolean: A Boolean expression can have only one of two values: true or false. 
    • Date: A Date value is a string in the format prescribed by the XML standard for date data, similar to ISO 8601.
    • Date & Time: A DateTime value is a string in the format prescribed by the XML standard for date data, similar to ISO 8601. 
    • Enum: An Enum is a predefined list of selectable options.
      Note: Architect natively handles the Enum values as strings. When you define an Enum input value for the Call Decision Table action, you must use the Item Key that is configured under Enum options in the rules schema used by the decision table. Do not use the Item Label. Similarly, if a rule matches the input values, Architect returns the Item Key in the output variable, if the result is of type Enum.
    • Integer: An integer is a whole number such as 987 or 5.
    • Number: A number includes any numeric values, including decimals.
    • String: This is a standard text string or a custom series of alphabetical, numerical, and symbolic characters.
  • Platform data types
    • Queue: Queues are the “waiting line” of interactions. In Architect, a queue expression routes a work item to an eligible queue. Queues are established and configured by the Genesys Cloud administrator.

Nombre Descripción
Salidas de falla

These outputs allow the flow author to map the results of any resulting errorType and errorMessage variables when the Call Decision Table action takes the failure path. The failure outputs help you anticipate potential issues and manage them effectively, improving your flow’s resiliency.

  • errorType: Una cadena no vacía que contiene el tipo o la categoría del error.
  • mensaje de error: Un mensaje de error no localizado. La cadena puede estar vacía o NOT_SET.

Nota: Pase el ratón por encima del icono de información junto a errorType para mostrar la lista de valores de errorType permitidos.

Select the variables that you want to assign to the failure data values returned by the Call Decision Table action.

Puede utilizar los siguientes valores de errorType:

  • ActionInvocationLimitExceeded: If a flow has successfully run the Call Decision Table action five times, any subsequent invocations of the action take the failure path.
  • ExecutionOutOfCapacityError: The service was busy and it was temporarily unable to execute the decision table. This error may occur more frequently than other error types. In this case, it is recommended that you configure sufficient number of retries.
  • GeneralExecutionError: A general error occurred during execution. 
  • InvalidRequest: The request was not formed properly for execution. For example, an HTTP 400 error occurred.

Nota:Haga clic en la flecha junto a Salidas de falla y expanda o contraiga la lista de variables.

Path Descripción
Éxito

Una ruta de éxito completa indica que el sistema no encuentra errores durante el proceso. No es una medida de si el sistema recibe datos que son el resultado o la funcionalidad esperados.

Falla

This path indicates that there was an error attempting to complete the action or a problem processing the results from the Call Decision Table action. Drag the appropriate action below the Failure path.