Runsub

Llama a un subscript, que se ejecuta y luego usa la Return acción para regresar 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 a la propiedad ReturnVariable en la acción Runsub del 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.

Dependencias

• El subíndice debe estar en la misma carpeta que el script principal o en una de sus subcarpetas.

• 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 subscript no estará ya disponible cuando termine el subscript, a menos que la declare como global. Puede hacer esto en una acción SNIPPET agregando global: antes del nombre de la variable. Por ejemplo, ASSIGN global:varName = value. Otra opción para ingresar datos en un subscript es usar GET /contacts/{contactId}/custom-data API.
• Para usar la función savetodb() en una variable en un subscript Runsub, debe ser una variable global.

• Todos los scripts llamados por RunScript, Spawn, Runsub, o scripts similares deben ser válidos y estar 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.

Tipos de secuencias de comandos compatibles

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

Comparación de Acciones Similares

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

• Runscript: Cuando Runscript activa otro script, no regresa al primer script desde el segundo script.
• Runsub: Cuando Runsub activa un subscript, el script puede regresar al primer script, siempre que el subscript tenga una acción Return. La acción Return proporciona un valor de regreso a la acción Runsub cuando el subscript finaliza.
• SPAWN: Inicia un segundo script que se ejecuta en paralelo al primer script. Los scripts generados no pueden devolver datos al primer script a menos que incluya una SIGNAL acción en el script generado.

Propiedades de entrada

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

Propiedad	Descripción
Caption	Introduzca 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. El valor predeterminado es el nombre de acción.
ScriptName	The script you want to spawn. You can click the Choose Script link at the top of the action's properties box to select a script from your business unit.
ReturnVariable	The value that is returned to the main script is stored in this property. To pass multiple values, use an array as the variable.
Parámetros	Permite cambiar el nombre de las variables predeterminadas que contienen los valores de los parámetros que desea enviar al script generado o secundario. Las variables predeterminadas SOn p1 - p9, pero si especifica nombres en esta propiedad, esos nombres reemplazan los nombres DE variable predeterminados en los que se pasan los valores de los parámetros. Si no cambia los nombres, las variables retienen sus nombres predeterminados pX. Para cambiar los nombres, haga clic en el icono de puntos suspensivos en el campo y agregue nombres DE variables para cada parámetro que desee enviar al script generado o secundario. Intro hasta nueve nombres, uno por línea en la ventana del editor. Para cambiar los nombres, agregue nuevos nombres para cada parámetro que desee enviar al script generado o secundario. Intro hasta nueve nombres DE variables, uno por línea. Los Nombres DE variables no tienen que coincidir con el nombre de la variable correspondiente utilizada en el script generado, pero deben ser significativos. Estos valores se pasan como variables de parámetrovariables de parámetro p1 - p9. Los parámetros que se pasan a un script aparecen en el resultado de seguimiento de ese script en la acción Begin.

Condiciones de la rama de resultado

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

Condición	Descripción
Por defecto	Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
OnError	Path taken when the action fails to execute properly. For example, when there is an unexpected problem such as poor connectivity, syntax errors, and so on. The _ERR variable, with a single underscore character, should be populated with a condensed explanation of the problem.

Ejemplo de Script

En el script principal que se muestra a continuación (mostrado en la parte superior), cuando se activa el script, la acción Runsub activa de inmediato el subscript (mostrado en la parte inferior). En el subscript, Voiceparams establece la configuración de Texto a voz, y la acción Horas establece ramas para abierto, cerrado y feriado en tres acciones Return diferentes. Cuando el subscript finaliza, los valores de la propiedad ReturnValues (en la acción Return) se almacenan en el campo ReturnVariable (acción Runsub en el script principal). La acción Caso luego establece las ramas de abierto, cerrado y feriado según corresponda.

Secuencia de comandos principal

¿Le gustaría descargar esta secuencia de comandos?

Sub-secuencia de comandos

Las tres acciones Return proporcionan valores en la propiedad ReturnValue para que la acción Case en el script principal pueda determinar qué rama seguir.

¿Le gustaría descargar esta secuencia de comandos?