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. Otras declaraciones 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.

Las declaraciones en los snippets constan de una o más líneas de código. Una declaración simple de una línea podría crear una Variable y asignarle un valor, como en este ejemplo:

ASSIGN FirstName = "Beowulf"

Una declaración compleja puede tener muchos grupos de líneas anidadas, como esta:

ASSIGN Names="Odin|Freya|Thor|Loki" ASSIGN SubCounter=1 FOREACH Name IN Names { IF Name = "Odin" | Name = "Freya" { ASSIGN NewNames[SubCounter]= "{Name}" ASSIGN SubCounter=SubCounter + 1 } }

Tipos de declaraciones

Puede utilizar los siguientes tipos de declaraciones en los snippets:

• Declaración: Use las declaraciones para declarar o crear nuevas variables, objetos y funciones.
• Toma de decisiones: Utilice instrucciones de toma de decisiones para que el snippet de código seleccione una tarea a realizar según las condiciones que usted especifique. Las puede utilizar para controlar el flujo lineal de lo que sucede en el script.
• Ciclos: Use las declaraciones en ciclo para hacer que el script realice una tarea o un conjunto de tareas hasta que se cumpla la condición final especificada.
• Otros: Estas declaraciones le permiten finalizar funciones, mostrar resultados en la ventana Snippet editor durante la depuración e incluir archivos DLL proxy de servicios web en sus snippets.

Palabras clave

Las palabras clave son comandos que inician las declaraciones. Son términos reservados predefinidos. El compilador reconoce la palabra clave y luego realiza la tarea asociada a ésta.

Cada tipo de declaración que puede usar en un Snippet tiene una palabra clave asociada. Por ejemplo, para declarar una Variable, puede usar la palabra clave ASSIGN. O, para realizar una declaración de selección, puede usar la palabra clave IF. Tanto la declaración como la palabra clave comparten el mismo nombre, de manera que una declaración IF usa la palabra clave IF.

Las palabras clave disponibles en el lenguaje Snippet se describen junto con la declaración asociada a cada una. También está disponible una lista completa de Palabras clave.

Sintaxis de la declaración

Todas las declaraciones comienzan con una palabra clave y van seguidas de palabras o código que definen qué hace la declaración. Cada declaración tiene su propia sintaxis. La sección de resumen de la sintaxis de esta página describe cómo leer la sintaxis de las declaraciones.

Algunas declaraciones requieren código condicional. Este es el código que establece una condición y define qué sucede si se cumple o no se cumple la condición. El código condicional puede ser una declaración única o declaraciones múltiples. Siempre debe estar encerrado entre llaves ({ }), incluso si es una sola línea. El código condicional a veces se denomina bloque.

Cuando el compilador encuentra una nueva línea o una llave de apertura, reconoce el final de una declaración. Es un tanto flexible la colocación de las llaves. Los siguientes formatos son todos válidos:

IF x=1 {TRACE "one" }

IF x=1 {TRACE "one" } IF x=2 {TRACE "two" }

IF x=1 {TRACE "one"}

IF x=1

{

  TRACE "one"

}

Cuando el código incrustado requiera más de una declaración, siga estas reglas:

• Coloque una declaración por línea.
• Si se requieren declaraciones múltiples, colóquelas en líneas separadas. Esto facilita la lectura del código.
• Las declaraciones incorporadas que requieren su propio código incorporado pueden ocupar varias líneas, siguiendo los formatos válidos para usar llaves.

Resúmenes de la sintaxis

En las páginas de ayuda en línea que abarcan cada tipo de declaración, cada tipo de declaración tiene un resumen de sintaxis. El resumen le muestra el formato que utiliza ese tipo de declaración. Le muestra qué elementos son obligatorios y cuáles son opcionales. También demuestra cómo se deben anidar los elementos de la sintaxis.

La siguiente tabla define cada elemento de los resúmenes de sintaxis. No todas las declaraciones incluyen todos los elementos. Al descifrar un resumen de sintaxis, preste mucha atención al anidamiento de los elementos.

Elemento	Detalles
COMMAND	Este es el nombre de la palabra clave que se utilizará con la declaración. Reemplace COMMAND por la palabra clave de la declaración que está creando. Las palabras clave no distinguen mayúsculas y minúsculas. Por ejemplo: FOREACH es igual que foreach para el compilador. Sin embargo, la acción Snippet convierte automáticamente todas las palabras clave a mayúsculas la próxima vez que abra el snippet. En la ayuda en línea, las palabras clave siempre están en letras mayúsculas.
<required>	Los corchetes angulares indican un elemento obligatorio. El texto dentro de los corchetes indica el tipo de elemento, como una expresión, una variable o un valor literal. Por ejemplo, en un resumen de sintaxis de la declaración FOREACH, hay dos elementos obligatorios: FOREACH <var> in <array> { ... [ BREAK]} Nunca deben usarse literalmente en su script los corchetes angulares y el texto dentro de ellos. Reemplace esa parte por el elemento de código que describe. Por ejemplo, reemplace <expression>con una expresión como i = 0.
[optional]	Los corchetes cuadrados indican un elemento opcional. El texto dentro de los corchetes indica el tipo de elemento que puede usar. Por ejemplo, en el resumen de sintaxis de IF, la cláusula opcional ELSE está encerrada entre corchetes cuadrados: [ELSE { ... }. Si usa un elemento opcional, debe aparecer en la ubicación que se indica en el resumen de sintaxis en relación con los demás elementos. Nunca deben usarse literalmente los corchetes en su script.
{ ... }	Curly braces indicate a code block can be used. Las llaves son diferentes de los corchetes angulares y los corchetes cuadrados utilizados en el resumen de sintaxis. Los corchetes angulares y los corchetes cuadrados no deben incluirse en su código, pero las llaves deben incluirse literalmente en su código. Sin embargo, debe reemplazar los puntos suspensivos ( ... ) dentro de las llaves del resumen de sintaxis por declaraciones de Snippet.
Barra vertical ( | )	El carácter de barra vertical indica dónde tiene la opción de elegir qué incluir en la declaración. Por ejemplo, en el resumen de sintaxis de la declaración ASSIGN, el carácter de barra vertical indica que tiene la opción de encerrar el valor entre comillas dobles: ASSIGN <variable> = "<value>" | <value> La explicación de la sintaxis explica la elección.
Puntos suspensivos (...)	Los puntos suspensivos indican una de dos cosas: Dónde va el código en un bloque, si se encuentra entre llaves. Un patrón continuo, si se encuentra entre corchetes cuadrados con una palabra clave. Un ejemplo del uso de puntos suspensivos para indicar un patrón continuo se encuentra en el resumen de sintaxis de SELECT: SELECT <{ CASE <expression> [{ ... }] [CASE <expression> <{ ... }>] [CASE ...] [DEFAULT <{ ... }>] }> El[CASE ...] indica que puede continuar agregando tantas cláusulas CASE como necesite siguiendo el patrón establecido.

Por ejemplo, el resumen de sintaxis de las declaraciones IF utilizadas en esta página es:

IF <expression> <{ ... }>

Este resumen muestra que:

• La palabra clave es IF.
• El siguiente elemento es una expresión necesaria.
• El último elemento es un bloque de código necesario que debe estar encerrado entre llaves.

El resumen de sintaxis para las instrucciones SWITCH es más complejo:

SWITCH <var> <{CASE <literal> [{ ... }] [CASE <literal> [{ ... }]] [CASE ...] [DEFAULT [{ ... }]] }>

Este resumen muestra que:

• La palabra clave es SWITCH.
• El siguiente elemento es la necesidad del nombre de una variable.
• El bloque de código es obligatorio y debe contener una cláusula CASE con un valor literal.
• La cláusula obligatoria CASE puede contener un bloque de código opcional.
• El bloque de código de la instrucción SWITCH puede incluir cláusulas CASE opcionales adicionales siguiendo el patrón establecido en el resumen.
• El bloque de código de la instrucción SWITCH puede contener una cláusula opcional DEFAULT con un bloque de código opcional.