Ayuda de expresión de arquitecto

Architect proporciona una lista completa y concentrada de elementos para ayudarlo con la construcción de expresiones. Esta lista incluye categorías de matemática, estadística, texto, fecha y hora, lógica, comparación, lista, financiera, audio, idioma y tipografía. Cada elemento incluye una descripción, un código de implementación, valores de retorno y parámetros. También puede ver ejemplos de cadenas específicas y la salida resultante. Dentro de la Ayuda de expresiones, puede copiar y pegar un ejemplo deseado en el cuadro de diálogo Editar expresión y luego modificarlo para que se ajuste a su cálculo de expresión.

Dentro de Ayuda de expresión, puede ver implementaciones, parámetros y ejemplos. También puede copiar y pegar un ejemplo proporcionado en el cuadro de diálogo Editar expresión y luego modificarlo para que se ajuste a su cálculo de expresión.

Acceder a la ayuda de expresión desde el menú de ayuda

En la esquina superior derecha de Architect, haga clic en el botón Ayuda y seleccione Ayuda de expresión.

Acceda a la ayuda de expresión mediante el botón Funciones

  1. Desde el Editar expresión cuadro de diálogo o el Secuencia de audio cuadro de diálogo, haga clic en el F() botón. Se abre el cuadro de diálogo Ayuda de expresión.
  2. Para ubicar un elemento específico, realice una de las siguientes acciones:
  • En el Buscar campo, escriba las primeras letras de la función que desea ver. El arquitecto muestra posibles coincidencias.
  • En el Nombre / Símbolo área, use la barra de desplazamiento para navegar a la función que desea ver y haga clic en la función para ver los valores.
  1. Para salir del Ayuda de expresión cuadro de diálogo, en la esquina superior derecha, haga clic en X.

Acceder a la ayuda para expresiones mediante la función type-ahead

Puede acceder fácilmente a la ayuda de funciones específicas de expresión utilizando la función de escritura anticipada de Architect en el cuadro de diálogo Editar expresión. Cuando escribe las primeras letras del texto, Architect muestra una lista de posibles coincidencias. Cada coincidencia incluye un signo de interrogación que, al hacer clic en él, abre la Ayuda para expresiones correspondiente a esa expresión.

Algunas funciones, como ToAudioNumber o ToAudioBool, solo son válidas para su uso en ciertos idiomas admitidos. Los autores de flujos solo deben incorporar la reproducción de datos en un flujo que utilice funciones de ToAudio si los idiomas admitidos por el flujo incluyen la reproducción de datos en tiempo de ejecución. Para determinar si una función tiene este requisito, consulte la página de esa función en la Ayuda de expresiones.

Si se llama a una función en un idioma no admitido, Architect devuelve un error. Por ejemplo: Un flujo está configurado con soporte de reproducción de datos en tiempo de ejecución para inglés (en-us) y, por lo tanto, se ejecuta en inglés, pero encuentra la siguiente expresión:

ToAudioNumber(503)

En este caso, el tiempo de ejecución sabe secuenciar el indicador del sistema de quinientos y el indicador del sistema de Tres en ese orden, porque este es el orden que esperan los usuarios de habla inglesa. Sin embargo, si Architect no tiene soporte de reproducción de datos en tiempo de ejecución para un idioma y el autor del flujo establece ese idioma como compatible con el flujo, el ejemplo anterior genera un error de análisis.

El error ocurre cuando el flujo se ejecuta en un idioma sin soporte de reproducción de datos en tiempo de ejecución porque si el flujo encuentra ToAudioNumber (503), Architect no puede determinar cómo volver a leer el número en audio apropiado para el idioma no admitido.

Para cada función a la que se aplica esto, la ayuda de Expression Help contiene un Válido para usar en estos idiomas sección.

Cada Ayuda de expresión La página contiene información de implementación. Las implementaciones muestran las formas admitidas en que un autor puede llamar a una función u operador. Por ejemplo, en el Ayuda de expresión, abra el operador de adición y vea las posibles implementaciones como:

5 + 3
"hello"+ "world"

Pero no:

"hello" + true

Las implementaciones muestran tanto los tipos de datos como los parámetros que puede especificar.

Parámetros de implementación

Dentro de cada sección de Implementaciones, el Ayuda de expresión incluye una sección de Parámetros que proporciona información útil para los autores de flujos, como si el parámetro puede ser NOT_SET en tiempo de ejecución, valores mínimos y máximos y otras restricciones. Por ejemplo, cuando un parámetro solo se permite como literal.

Ejemplo: Código de moneda válido 

Al incluir "USD" en la siguiente expresión, el autor se asegura de que el parámetro del código de moneda sea un código ISO 4217 válido, como se especifica en los parámetros de MakeCurrency.

MakeCurrency(5.25, "USD")

Sin embargo, si un autor de flujo usa un literal para el código de moneda, el analizador valida el código en tiempo de diseño. La siguiente llamada da como resultado un error del analizador que le indica al autor del flujo que el parámetro del código de moneda no es un código de moneda admitido:

MakeCurrency(5.25, "USD123")

Cuando Architect valida este valor literal en tiempo de diseño, devuelve un mensaje que informa al autor del flujo que el literal "USD123" proporcionado al parámetro currencyCode no es un código de moneda ISO4217 compatible.

Ejemplo: Fecha y hora válidas

De manera similar, la siguiente expresión, que es una fecha y hora con el año 2500, también se marcará en tiempo de diseño:

MakeDateTime(2500, 1, 1, 0, 0, 0)

Como se especifica en el Ayuda de expresión para MakeDateTime, el valor de 2500 proporcionado al parámetro de año es mayor que el máximo permitido de 2200.