Runsub

This help page is for Desktop Studio. This information is also available for CXone Studio.

The Runsub action icon, a curled piece of paper with two arrows pointing to the right next to it at the top and bottom.

Llama a un subíndice, que se ejecuta y luego usa el Return action para volver y continuar ejecutando el script principal. Cuando se ejecuta el subscript, almacena un valor en la propiedad ReturnValue de la acción Return y luego pasa ese valor de nuevo a la propiedad ReturnVariable en la acción Runsub en el script principal.

Esta acción puede ser especialmente útil si tiene uno o más scripts más grandes que prefiere dividir en scripts más pequeños.

Dependencies

  • La secuencia principal y el subíndice debe estar en la misma carpeta.

  • El tipo de secuencia de comandos principal y el tipo de subíndice deben ser iguales. Por ejemplo, si la secuencia de comandos principal es una secuencia de comandos de teléfono, el subíndice también debe ser una secuencia de comandos de teléfono.
  • Si coloca una acción Runsub en el script principal, su subscript DEBE tener una acción Return.
  • Runsub puede transferir diversas variables desde el script principal hacia el subscript, pero el subscript puede devolver un solo valor (en la propiedad ReturnVariable) al script principal.
  • Cualquier variable definida en el subíndice ya no estará disponible cuando el subíndice termine.
  • Todos los scripts solicitados por RunScript , Spawn, Runsub o scripts similares deben ser válidos y activos. Durante el proceso de de guardar, Studio valida todos los scripts solicitados por acciones. Si alguno no es válido o está inactivo, Studio muestra un error y no es posible guardarlo.

Supported Script Types

The icon for a Generic script type - a rectangle with < and > symbols inside it.

The icon for the Email script type - a large @ symbol in a diamond.

The icon for the Chat script type - a chat bubble with an ellipsis inside (...), in a diamond shape.

The icon for the Phone script type - an old-style phone handset with curved lines indicating sound coming out of it.

The icon for the Voicemail script type - a symbol that looks like a cassette tape - two circles sitting on a horizontal line.

The icon for the Work Item script type-a piece of paper with one corner folded down and a bullet list on it.

The icon for the SMS script type - a smart phone with a chat bubble coming out of it.

The icon for the Digital script type - a computer monitor with a smartphone next to it.

Genérico

Correo electrónico Conversación Teléfono Correo de voz Elemento de trabajo SMS Digital

Comparison of Similar Actions

Las siguientes acciones tienen funciones similares, pero con algunas diferencias clave:

  • Runscript: Cuando Runscript ejecuta un subscript,, no hay forma de volver al primer script desde el subscript.
  • Runsub: Cuando Runsub activa un subscript, el script puede volver al primero, en tanto que el subscript tenga una acción Return. La acción Return devuelve un valor a la acción Runsub cuando finaliza el subscript.

Input Properties

Estas propiedades definen los datos que utiliza la acción al ejecutarse.

Propiedad

Descripción

Leyenda

Ingrese una frase corta que identifique de forma única esta acción en el script. La leyenda aparece en el lienzo del script debajo del ícono de acción. The default is the action name.

ScriptName

El script que quiere generar. Puede hacer clic en el enlace Choose Script en la parte superior del cuadro de propiedades de la acción para seleccionar un script almacenado para su inquilino de la .

ReturnVariable

El valor que se devuelve al script principal se almacena en esta propiedad. Para pasar varios valores, use una matriz como variable.
Parameters

Haga clic en el icono de puntos suspensivos en el campo y agregue una variable para cada parámetrodesea enviar al script generado. Introduzca una variable por línea en la ventana del editor. Utilice nombres de variables significativos. Los nombres de las variables no tienen que coincidir con el nombre de la variable correspondiente utilizada en el script generado.

Los parámetros que se transmiten a un script aparecen en la salida de seguimiento de ese script en la acción Begin.

Condiciones de la rama de resultados

Las condiciones de las ramas de resultados le permiten crear ramas en su script para manejar diferentes resultados cuando se ejecute una acción.

Condición

Descripción

Default

Recorrido a menos que el script cumple una condición que requiere uno de los otros poderes. También se considera si no están definidas las demás ramas de la acción.

OnError

Ruta tomada cuando la acción no se ejecuta correctamente. Por ejemplo, cuando haya un problema inesperado como una mala conectividad, errores de sintaxis, etc. La variable _ERR, con un único carácter de subrayado, debe llenarse con una explicación condensada del problema.

Script Example

Este ejemplo no es un script completo. Se requiere trabajo adicional en el script para usar esta acción.

In the main script below (shown top), when the script is triggered, the Runsub action immediately triggers the subscript (shown bottom). In the subscript, Voiceparams sets the Text-to-Speech settings, and the Hours action sets branches for open, closed, and holiday to three different Return actions. When the subscript is finished, the values in the ReturnValues property (in the Return action) are stored in the ReturnVariable field (Runsub action in the main script). The Case action then sets the open, closed, and holiday branches as appropriate.

Main Script

An example script, showing Studio actions with arrows connecting them. Each action has a label beneath it to indicate what the action does in the script.

Would you like to download this script?

Subscript

An example script, showing Studio actions with arrows connecting them. Each action has a label beneath it to indicate what the action does in the script.

The three Return actions provide values in the ReturnValue property so the Case action in the main script can determine which branch to follow.

Would you like to download this script?