SNIPPET

Le permite agregar código personalizado a su script.

Dependencias

• El código utilizado en esta acción debe estar escrito en Snippet, un lenguaje de programación interno desarrollado para CXone. La Studio guía de referencia técnica brinda información detallada sobre la programación de snippets.
• No se pueden nombrar los atributos de los objetos de datos dinámicos __type (con dos guiones bajos). Esta palabra está reservada para su uso al analizar JSON de objetos dinámicos.
• Puede hacer llamadas API usando la acción Snippet. El tamaño máximo de respuesta es 32 kB. Esto está en consonancia con el límite del tamaño de respuesta de la acción REST API.  Es estrictamente obligatorio el límite para evitar inestabilidad o interrupción del clúster. De ser posible, use mejor la REST API action. Tiene el mismo límite, pero puede manejar una carga mayor. Si ha de usar la acción SNIPPET , siga estos consejos para reducir el tamaño de los datos devueltos:

  • Filtre los datos en la respuesta de la API. Por ejemplo, si utiliza la API de generación de informes NICE para obtener contactos, puede filtrar los resultados por startDate y endDate el contacto. Esta llamada a la API también permite devolver y limitar el recuento máximo de elementos. Consulte la documentación de la API que acompaña a su integración de scripts para determinar qué filtros puede utilizar.

  • Actualice la solicitud de la API para que devuelva únicamente los datos que necesite. Por ejemplo, si está utilizando la API de generación de informes NICE para obtener contactos, puede utilizar los campos contactIdo agentId para devolver únicamente los datos relevantes. Consulte la documentación de la API que acompaña a su integración de scripts para determinar qué límites de datos puede utilizar.

  • Si no puede realizar ninguna de las opciones anteriores, cree un middleware.

• El tamaño máximo de las matrices en Studio es de 63 millones de elementos. Si se excede este tamaño de matriz, se produce el siguiente en la variable __err en un seguimiento de script: Índice de matriz fuera de límites. El índice de la matriz actual ([índice]) excede el índice máximo permitido (63000000). Cuando se excede el tamaño de la matriz, el script toma la rama SNIPPET de la acción Error. Si la rama Error no está conectada, el script continúa ejecutándose, pero sin la información de la matriz. Puede configurar scripts para que le notifiquen cuando se haya excedido el tamaño máximo de la matriz agregando una acción EMAIL a la rama SNIPPET de la acción Error. Por último, puedes agregar lógica en la rama Error para continuar con el script. Tenga en cuenta que continuará sin la información de la matriz.

Tipos de scripts compatibles

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

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.
Data	Contiene el código personalizado que se agregó en la ventana Snippet editor. Esto puede incluir varios comandos ASSIGN y DYNAMIC, declaraciones de control de flujo distintas y funciones integradas y definidas por el usuario.
MaxStringSize	Define el tamaño máximo de cadena para todos los comandos en la propiedad Data. Las opciones son: Limit2K, Limit4K, Limit8K, Limit16K, Limit32K. Se aplica este límite a las respuestas de integración con las Rest API y SOAP.

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.

Consejos y trucos

• Utilice la función asjson() en una Snippet acción y almacenar el JSON resultante en una variable de cadena. Utilice la variable de cadena en las propiedades de otras Studio acciones cuando necesite pasar los datos JSON. Este enfoque evita la posibilidad de errores de validación al guardar el script.
• Si está ajustando un sistema IVR Menú telefónico automatizado que permite a las personas que llaman interactuar a través de comandos de voz, entradas de teclas o ambos, para obtener información, enrutar una llamada de voz entrante o ambos. habilitado para ASR Permite que los contactos respondan a las indicaciones de voz grabadas hablando, presionando teclas en su teléfono o una combinación de ambos., hay un conjunto de parámetros que puede usar en los snippets.
• El lenguaje del Snippet proporciona comandos de palabras clave que le permiten declarar variables y objetos, crear ciclos y declaraciones iterativas, y más.
• Studio tiene funciones integradas que puede usar en sus scripts.
• Puede crear sus propias funciones personalizadas que use en los snippets.
• Puede probar y depurar el código de los snippets en la ventana Snippet editor .

Snippet Editor Ventana

Se abre la ventana Snippet editor cuando hace doble clic en una acción Snippet.

La ventana Snippet editor en la acción Snippet tiene dos pestañas. Ambas pestañas le permiten crear los mismos tipos de código. Puede alternar entre pestañas y editar su código en cualquier lugar. Las pestañas son:

• La pestaña Vista de Texto. Este es un campo de texto de formato libre donde puede escribir manualmente su código.
• La pestaña Vista de Árbol. Esta es una interfaz gráfica que puede utilizar para crear su código. Esta pestaña tiene una lista desde la que puede seleccionar palabras clave para agregar declaraciones al snippet.

Ejemplo de secuencia de comandos

En este simple ejemplo, el código en Snippet se utiliza para probar si es posible crear un contacto potencial utilizando información de un sistema de terceros.

Descarga este script.