Déclarations

Les informations sur cette page d’aide concernent à la fois Studio et Desktop Studio.

Les instructions définissent les actions qu'un script exécute lors de son exécution. Il s'agit notamment de créer des variables, d'attribuer de nouvelles valeurs, d'effectuer des calculs et de faire des choix logiques en fonction d'une condition donnée. Certaines instructions se contentent d'exécuter une tâche, comme attribuer une valeur à une variable. D'autres instructions affectent le flux du script. Les instructions sont exécutées dans un ordre logique, mais cet ordre peut changer à chaque exécution du script.

Les instructions dans les extraits de code se composent d'une ou plusieurs lignes de code. Une simple instruction d'une ligne peut créer une variable et lui attribuer une valeur, comme ceci :

ASSIGN firstName = "Beowulf"

Une instruction complexe peut comporter plusieurs groupes de lignes imbriquées, comme suit :

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 } }

L'ordre logique de l'exécution de l'instruction dans un extrait peut être modifié en cas d'erreur dans l'extrait. Lorsqu'une erreur se produit, l'action Snippet se termine immédiatement. Les instructions restantes dans l'Extrait ne sont pas exécutées. À la place, un message d'erreur est sauvegardé dans une variable _ERR indiquant la nature du problème.

Types d’instructions

Vous pouvez utiliser les types d’instructions suivants dans les snippets :

  • Déclaration : utilisez les instructions de déclaration pour déclarer, ou créer, de nouvelles variables, de nouveaux objets et de nouvelles fonctions.
  • Prise de décision : Utilisez prise de décision instructions pour que le code de l'extrait sélectionne une tâche à exécuter en fonction des conditions que vous précisez. Vous pouvez les utiliser pour contrôler le flux linéaire de ce qui se passe dans le script.
  • Bouclage : Utilisez des déclarations de bouclage pour que l'extrait effectue une tâche ou un ensemble de tâches de façon répétée jusqu'à ce que la condition de fin spécifiée soit remplie.
  • Autre : ces instructions vous permettent de terminer des fonctions, d'afficher les résultats dans la fenêtre Snippet editor pendant le débogage, et d'inclure des DLL proxy de service Web dans vos Extraits.

Mots-clés

Les mots-clés sont des commandes qui commencent les instructions. Il s'agit de termes prédéfinis et réservés. Le compilateur reconnaît le mot-clé et exécute la tâche qui lui est associée.

Chaque type d’instruction que vous pouvez utiliser dans un snippet est associé à un mot-clé. Par exemple, pour déclarer une variable, vous pouvez utiliser le mot-clé ASSIGN. Pour effectuer une sélection, vous pouvez également utiliser le mot-clé IF. L'instruction et le mot-clé portent le même nom, de sorte qu'une instruction IF utilise le mot-clé IF.

Les mots-clés disponibles dans la langue Extrait sont décrits ainsi que l'instruction associée à chacun d'eux. Une liste complète des mots-clés est également disponible.

Syntaxe de l'instruction

Toutes les instructions commencent par un mot-clé et sont suivies de mots ou de code qui définissent ce que fait l'instruction. Chaque instruction a sa propre syntaxe. La section résumé de la syntaxe de cette page explique comment lire les syntaxes des instructions.

Certains énoncés nécessitent un code conditionnel. Il s'agit de code qui fixe une condition et définit ce qui se passe si la condition est ou n'est pas remplie. Le code conditionnel peut être une instruction unique ou plusieurs instructions. Elle doit toujours être placée entre accolades ({ }), même s'il s'agit d'une seule ligne. Le code conditionnel est parfois appelé bloc.

Lorsque le compilateur rencontre une nouvelle ligne ou une accolade ouverte, il reconnaît la fin d'une instruction. Le placement des accolades est relativement flexible. Les formats suivants sont tous valides :

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"
}

Lorsque le code intégré requiert plus d'une instruction, respectez les règles suivantes :

  • Placez une instruction par ligne.
  • Si plusieurs instructions sont nécessaires, placez-les sur des lignes séparées. Cela facilite la lecture du code.
  • Les instructions intégrées qui nécessitent leur propre code intégré peuvent occuper plusieurs lignes, en suivant les formats valides d'utilisation des accolades.

Résumés de syntaxe

Dans les pages d'aide en ligne qui couvrent chaque type d'instruction, chaque type d'instruction est accompagné d'un résumé de la syntaxe. L'onglet résumé vous montre le format que ce type de relevé utilise. Il explique quels sont les éléments requis et ceux qui sont facultatifs. Il montre également comment les éléments de syntaxe doivent être imbriqués.

Le tableau suivant définit chaque élément des résumés de syntaxe. Tous les énoncés n'incluent pas chaque élément. Lorsque vous déchiffrez un résumé de syntaxe, prêtez attention à l'imbrication des éléments.

Élément

Détails

 COMMAND

Le nom du mot-clé à utiliser avec l’instruction. Remplacez COMMAND par le mot-clé de l'instruction que vous créez.

Les mots-clés ne sont pas sensibles à la casse. Par exemple : FOREACH est identique à foreach pour le compilateur. Cependant, l'action Extrait convertit automatiquement tous les mots-clés en majuscules la prochaine fois que vous ouvrez l'extrait.

Dans l'aide en ligne, les mots-clés sont toujours présentés en lettres majuscules.

<required>

Les chevrons indiquent un élément obligatoire. L'intitulé entre crochets indique le type d'élément, par exemple une expression, une variable ou une valeur littérale.

Par exemple, dans un résumé de syntaxe d'instruction FOREACH, il y a deux éléments obligatoires :

FOREACH <var> in <array> { ... [ BREAK]}

Les chevrons et le texte qu'ils contiennent ne doivent jamais être utilisés littéralement dans votre script. Remplacer cette partie par l'élément de code qu'elle décrit. Par exemple, remplacez <expression> par une expression telle que i = 0.

[optional]

Les crochets indiquent un élément facultatif. Le texte entre crochets indique le type d'élément que vous pouvez utiliser. Par exemple, dans le résumé de la syntaxe IF, la clause ELSE en option est placée entre crochets : [ELSE { ... }.

Si vous utilisez un élément facultatif, il doit apparaître à l'endroit indiqué dans le résumé de la syntaxe par rapport aux autres éléments.

Les crochets ne doivent jamais être utilisés littéralement dans votre script.

{ ... } Curly braces indicate a code block can be used.

Les accolades sont différentes des chevrons et des crochets utilisés dans le résumé de la syntaxe. Les chevrons et les crochets ne sont pas censés être inclus dans votre code, mais les accolades doivent être incluses littéralement dans votre code. Cependant, vous devez remplacer les points de suspension ( ... ) à l'intérieur des accolades dans le résumé de la syntaxe par des instructions Snippet.

Trait vertical ( | )

Le caractère barre verticale indique l'endroit où vous disposez d'un choix concernant ce qu'il faut inclure dans l'instruction. Par exemple, dans le résumé de syntaxe de l'instruction ASSIGN, le caractère barre verticale indique que vous avez le choix d'inclure ou non la valeur entre guillemets :

ASSIGN <variable> = "<value>" | <value>

L'explication de la syntaxe explique le choix.

Points de suspension (...)

Les points de suspension ont deux significations possibles :

  • L'emplacement du code dans un bloc, s'il se trouve entre accolades.
  • Un motif continu, s'il est trouvé entre crochets avec un mot-clé.

Un exemple d'utilisation des points de suspension pour indiquer un motif continu se trouve dans le résumé de la syntaxe SELECT :

SELECT <{ CASE <expression> [{ ... }] [CASE <expression> <{ ... }>] [CASE ...] [DEFAULT <{ ... }>] }>

Le[CASE ...] indique que vous pouvez continuer à ajouter autant de clauses CASE que nécessaire en suivant le modèle établi.

Par exemple, le résumé de la syntaxe des instructions IF utilisées sur cette Page est le suivant :

IF <expression> <{ ... }>

Ce résumé montre que :

  • Le mot-clé est IF.
  • L'élément suivant est une expression obligatoire.
  • Le dernier élément est un bloc de code obligatoire qui doit être placé entre accolades.

Le résumé de la syntaxe pour les instructions SWITCH est plus complexe :

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

Ce résumé indique que :

  • Le mot-clé est SWITCH.
  • L'élément suivant est un nom DE variable obligatoire.
  • Le bloc de code est requis et doit contenir une clause CASE avec une valeur littérale.
  • La clause CASE requise peut contenir un bloc de code en option.
  • Le bloc de code de l'instruction SWITCH peut inclure des clauses CASE supplémentaires en option, en suivant le modèle établi dans le résumé.
  • Le bloc de code de l'instruction SWITCH peut contenir une clause DEFAULT en option, avec un bloc de code en option.