Runsub

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

Cuando se ejecuta el subíndice, 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 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.

Dependencias

  • 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 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 Un ícono de un cuadrado con una flecha que apunta desde el centro hacia la esquina superior derecha. API.
  • Para usar la función savetodb() en una variable en un subscript Runsub, debe ser una variable global.
  • 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.

Tipos de scripts compatibles

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

Comparación de acciones similares

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

  • Runscript: Cuando Runscript activa otro script, no retorna el primer script desde el segundo.
  • 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.
  • SPAWN: Inicia un segundo script que se ejecuta en paralelo con el primero. Los scripts creados no pueden transferir datos al primer script a menos que incluya una SIGNAL action en el script creado.

Propiedades de entrada

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

Las propiedad

Descripción

Caption

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 desde su unidad de negocio.

ReturnVariable

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

Le permite cambiar el nombre de las variables predeterminadas que contienen valores para 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 las variables predeterminadas en las que se pasan los valores de los parámetros. Si no cambia los nombres, las variables retienen sus nombres predeterminados pX.

To change the names, click the ellipsis icon in the field and add variable names for each parameter you want to send to the spawned or child script. Enter up to nine names, one per line in the editor window. Para cambiar los nombres, agregue nuevos nombres para cada parámetro que desee enviar al script generado o secundario. Ingrese hasta nueve nombres de variables, uno por línea. Los nombres de las variables no tienen que coincidir con el nombre de la variable correspondiente utilizada en el script generado, pero deben ser significativos. Estos valores se transfieren como parameter variablesvariables de los parámetros p1 - p9.

Los parámetros que se pasan 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.

Ejemplo de secuencia de comandos

Este es un ejemplo para demostrar cómo se puede utilizar esta acción en los scripts. No pretende ser un script completo. Quizá se requieran scripts adicionales.

En el siguiente script principal (que aparece arriba), cuando el script se activa, la acción Runsub activa el subscript (que aparece abajo) de inmediato. En el subscript, Voiceparams establece la configuración de Texto a voz, mientras que la acción Hours establece las ramas para abierto, cerrado y festivo en tres acciones Return diferentes. Cuando finaliza el subscript, los valores en la propiedad ReturnValues (en la acción Return) se almacenan en el campo ReturnVariable (Runsub acción en el script principal). La Case acción se establece el abierto, cerrado y oficinas de vacaciones según corresponda.

Secuencia de comandos principal

Un script de ejemplo, que muestra las acciones de Studio con flechas que las conectan. Cada acción tiene una etiqueta debajo para indicar qué hace la acción en el script.

¿Desea descargar este script?

Subíndice

Un script de ejemplo, que muestra las acciones de Studio con flechas que las conectan. Cada acción tiene una etiqueta debajo para indicar qué hace la acción en el script.

Las tres acciones Return aportan valores en la propiedad ReturnValue por lo que la acción Case en el script principal puede determinar qué rama seguir.

¿Desea descargar este script?