Referencia técnica Guide

La información de esta página de ayuda se aplica tanto a Studio como a Desktop Studio.

Esta sección proporciona información de referencia técnica detallada sobre la programación de scripts en Studio. La información generalmente se aplica a la programación de scripts con acciones y en snippets con código personalizados. En algunos casos, la información se aplica solo a uno de los métodos de programación de scripts o al otro.

La información de esta página resume los conceptos fundamentales de scripting que necesita conocer cuando trabaja con scripts en Studio. Hay más información detallada disponible en las demás páginas de esta sección.

Estructura de Script y Snippet

Los scripts de Studio pueden estar contenidos en un solo archivo o estar compuestos de un script principal y uno o más subscripts en archivos separados. Cada script debe:

  • Comience con una acción Begin. Los subscripts también deben comenzar con una acción Begin.
  • Finalice con una acción de finalización , como End. Los subscripts finalizan con Return, una acción que devuelve el flujo del script al script principal.
  • Tener un tipo DE soporte DE medios definido.

Dentro del script, la estructura sigue el flujo requerido por los comportamientos que necesita que el script proporcione. Puede organizar y disponer el flujo de acciones en su script de la manera que mejor le funcione. Por ejemplo, podría hacer que el flujo vaya de derecha a izquierda o de izquierda a derecha. De manera similar, puede ir de arriba hacia abajo.

Algunas cosas a tener en cuenta sobre la estructura de los scripts:

  • Use condiciones de rama para crear ramas en su script. Esto le permite cubrir los numerosos resultados, variaciones o situaciones posibles que podrían ocurrir en cualquier punto durante el script. Puede usar ramas para el manejo de errores, para las opciones en un menú de IVRClosed Interactive Voice Response. Automated phone menu contacts use via voice or key inputs to obtain information, route an inbound voice call, or both., o para las rutas verdadero/falso basadas en una acción IF.
  • Algunas acciones tienen disponibles varias condiciones de bifurcación. No es necesario conectarlas todas siempre. Sin embargo, es importante que siempre conecte la rama Default. Esta es la bifurcación que adopta el script si no se aplica ninguna de las demás condiciones. Puede evitar que se queden atascados los contactos en ese lugar del script si sucede algo inesperado.
  • Las acciones de evento no están conectadas a las acciones que desencadenan el evento. Comienzan una nueva sección en el mismo archivo de script. Se pueden ubicar las nuevas secciones en cualquier parte del archivo del script. Si tiene varias acciones de evento en su script, es recomendable mantenerlas organizadas de manera que resulte fácil ubicarlas más adelante.

Los snippets no tienen ningún requisito de estructura, además de los límites del orden lógico de las declaraciones. Pueden contener una sola instrucción ASSIGN, o lógica de scripting Compleja compuesta por una serie de instrucciones y bloques anidados. Si necesita crear funciones personalizadas, debe utilizar snippets.

Puede usar los Snippets para algo más que contener código personalizado. Puede usarlos para consolidar las asignaciones de variables en menos ubicaciones. En lugar de usar una acción ASSIGN cada vez que necesite agregar una Variable, puede colocar múltiples declaration statements en una sola acción de Snippet.

Hay algunas cosas que puede hacer para que sus scripts sea más fáciles de leer.Esto puede ayudar a otros escritores de scripts que podrían necesitar trabajar con el script más adelante. Ahora es posible:

  • Cambie la propiedad Agregar leyenda de cada acción. El contenido de esta propiedad aparece en el espacio de trabajo del lienzo del script. Puede agregar una palabra o frase corta que le ayude a saber qué hace cada acción. Por ejemplo, puede que desee indicar la habilidad que utiliza la acción, el archivo de música que reproduce o lo que hace el código de Snippet.
  • Use las acciones Annotation y Note para proporcionar documentación adicional en su script. En las acciones Snippet, puede agregar comentarios.
  • Siga las otras prácticas recomendadas para Scripting en Studio.

Sintaxis

Como todos los lenguajes de programación, Snippet tiene reglas de sintaxis que deben seguirse. Cada página de ayuda de la sección de referencia tiene una sección sobre la sintaxis que cubre las reglas de ese elemento del lenguaje. Puede obtener información sobre las reglas de sintaxis para:

Las reglas de sintaxis se describen con resúmenes de sintaxis. Los resúmenes utilizan ciertas convenciones para distinguir entre elementos opcionales y obligatorios. Obtenga más información sobre estas convenciones en la página de ayuda Statements.

Tipos de datos

Los tipos de datos describen cómo se representan los datos y los tipos de operaciones que se pueden realizar con ellos. Muchos lenguajes de programación admiten muchos tipos de datos que distinguen entre diferentes tipos de representaciones numéricas y alfanuméricas. Studio no hace estas distinciones. En Studio, los valores SOn de uno de los siguientes tipos:

  • Cadena: El valor de la variable contiene caracteres alfanuméricos y especiales, como puntos, comas y guiones bajos. Los valores en cadenas deben estar entre comillas dobles.
  • Numérico: El valor de la variable es un número. Los valores Numéricos no necesitan comillas dobles.
  • Fecha/hora: El valor de la variable es una fecha, hora o ambas. When a date/time value is used with funciones de fecha/hora en Studio, el valor debe estar entre comillas y debe estar precedido por un signo de número fuera de las comillas: var = #"11-23-2022".
  • Booleano: El valor de la variable es true o 1, o false o 0. No encierre los valores booleanos entre comillas.

No es necesario declarar tipos de datos al crear variables, como se hace en algunos lenguajes de programación. En Studio, las variables se tipifican implícitamente. Esto significa que el tipo se determina automáticamente cuando se compila el script.

Los tipos de datos SOn una parte integral de la creación de scripts. Puede obtener más información sobre los tipos de datos en los scripts de Studio en las páginas de ayuda sobre estructuras de datos, expresiones, y variables. Si trabaja con funciones, necesita saber sobre los tipos de datos que está utilizando en el script. También necesita saber qué espera la función que está utilizando y cómo puede diferir la salida según el tipo con el que la utilice.

Estructuras de datos: variables, arreglos y Objetos

Las estructuras de datos le permiten almacenar datos para utilizarlos en su secuencia de comandos. Cuando sea necesario, puede recuperar los datos de la estructura de datos o reemplazarlos con otros datos. En otros lenguajes de programación, puede haber muchos tipos de estructuras de datos y éstas pueden ser muy complejas. En Studio, sólo hay tres tipos de estructuras de datos:

Puede crear cualquiera de estas estructuras de datos declarándolas con una declaración.

Expresiones

Una expresión es cualquier cosa en su script que compara un valor o da como resultado un valor. Los siguientes SOn ejemplos de expresiones:

  • x = 3(5+10)

  • y = 123 North Street
  • x != 5

Existen diferentes tipos de expresiones, incluidas cadena, numérico y BooleanClosed A data type that has two possible values: true and false.. Las expresiones tienen muchos usos en los scripts Studio. Se utilizan para:

Operadores

Los operadores SOn símbolos matemáticos que indican la operación matemática o algebraica que debe realizarse con los números. Studio admite todos los operadores matemáticos estándar y algunos operadores algebraicos operadores. También admite operadores booleanosClosed A data type that has two possible values: true and false., que se utilizan en expresiones booleanas.Estas SOn expresiones que se evalúan como verdaderas o falsas. Puede utilizar booleanos en algunas declaraciones para crear un mecanismo de toma de decisiones en su script.

Declaraciones

Las declaraciones definen las acciones que realiza un script al ejecutarse. Esto incluye crear variables, asignar nuevos valores, realizar cálculos y tomar decisiones lógicas con base en una condición determinada. Algunas declaraciones únicamente realizan una tarea, como asignar un valor a una variable. otros enunciados afectan el flujo del script. Las declaraciones se ejecutan en un orden lógico, pero puede cambiarse ese orden cada vez que se ejecute el script.

Al programar scripts con acciones, generalmente no es necesario pensar en términos de declaraciones. Dentro de los fragmentos de código, puede usar los siguientes tipos de declaraciones:

  • Declaración: Use las declaraciones para declarar o crear nuevas variables, objetos y funciones.
  • Toma de decisiones: Use declaraciones de toma de decisiones para que el código del Snippet seleccione una tarea que se realizará según las condiciones que especifique. Puede usarlas para controlar el flujo lineal de lo que sucede en el script.
  • Bucles: Use declaraciones de bucle para que el fragmento (Snippet) realice una tarea o un conjunto de tareas de manera repetida hasta que se cumpla la condición de finalización especificada.
  • Otro: Estas instrucciones le permiten terminar funciones, mostrar resultados en la ventana Snippet editor durante la depuración, e incluir DLL de proxy de servicios web en sus snippets.

Algunas de las declaraciones tienen Studio acciones que hacen lo mismo. Por ejemplo, las acciones ASSIGN e IF hacen lo mismo que las instrucciones ASSIGN e IF que puede utilizar en los fragmentos. En muchas de las declaraciones, la única opción para usarlas es en los snippets.

Palabras reservadas

Studio tiene algunas palabras reservadas que no están disponibles para usarse como los nombres de las variables y otras entidades en los scripts. Las palabras reservadas incluyen los nombres de:

Si utiliza una palabra reservada como el nombre de una entidad en su script, se produce un error. Debe cambiar el nombre de la entidad para resolver el error.

Comentarios

Los comentarios le permiten documentar algo en su script o snippet. Puede utilizarlos para dejar una nota para usted mismo o para un futuro desarrollador de script, o para explicar el propósito de algo en el script.

En Studio Scripts, puede agregar comentarios con la acción Note o la acción Anotación. Ambas acciones le permiten agregar un comentario al lienzo del script. La acción Anotación coloca el comentario de forma visible en el lienzo. Para leer el comentario en una acción Nota, debe hacer doble clic en la acción.

En los snippets, puede agregar comentarios colocando DOs barras diagonales ( // ). Se pueden colocar los comentarios en sus propias líneas o al final de una declaración.

También puede utilizar comentarios en los snippets para ocultar líneas de código que no desea que formen parte del script al ejecutarse. Esto resulta útil a la hora de solucionar problemas.

Funciones

Las Funciones SOn una forma de crear código que se desea reutilizar. Puede crear sus propias funciones y luego llamarlas en cualquier otra parte de su script cuando desee usar el código que contiene la función. Studio también cuenta con algunas funciones integradas que puede usar sin tener que declararlas en su script.

Manejo de cadenas de caracteres

En los fragmentos, puede hacer muchas cosas con cadenas utilizando funciones integradas:

  • Concatenarlas
  • Dividirlas en subcadenas
  • Hacerles una búsqueda
  • Reemplazar parte del contenido
  • Compararlas
  • Cambiarlas de mayúsculas a minúsculas y viceversa.

En algunos casos, quizá necesite especificar el formato de cadenas que involucran fechas, horas o números. Puede utilizar los especificadores de formato designados para definir el formato que desea que utilice el script.También puede utilizar algunas de las funciones integradas para convertir cadenas a diferentes formatos.

Hay ciertos caracteres que no se pueden incluir en las cadenas sin usar una secuencia de escape. Dado que las cadenas deben estar entre comillas simples o dobles, si incluye una comilla simple o doble literal en una cadena, el script la interpreta como el principio o el final de una cadena. La secuencia de escape le dice al script que el carácter está pensado como un literal y no como el símbolo predeterminado. otros caracteres que requieren secuencias de escape SOn las tabulaciones, los retrocesos y las llaves abiertas.