Manuel des Scripts Automation Engine > Introduction > Principes de base > Littéral de script

Littéral de script

Un littéral de script consiste en une chaîne de caractères quelconque, placée entre apostrophes (') ou guillemets (").

Exemple :

"Automation Engine"

Un littéral de script peut également contenir des variables de script remplacées par la valeur correspondante lorsque la ligne de script contenant le littéral est traitée.

Exemple :

:SET &TIME# = SYS_TIME("HH:MM:SS")
:
PRINT "Time &TIME#"

Affichage :

Time 10:30:05

Nom Automation Engine

Le nom AE constitue une forme particulière de littéral de script. Il n'a pas besoin d'être entouré d'apostrophes ni de guillemets. Les noms AE sont :

Exemple :

:SET &STATUS# = SYS_HOST_ALIVE(WIN01)

Vous devez utiliser des guillemets si le nom AE commence par un chiffre.

 

L'utilisation de la chaîne de caractères <![[ ]]> dans un littéral de script provoque une erreur de syntaxe et rend impossible l'enregistrement de l'objet. Plusieurs solutions existent pour éviter cette erreur :

  1. Inserer un commentaire qui contient ces caractères.
    Exemple :
    !<![[ ]]>
    :PRINT '<![[ ]]>'

  2. Cela ne produit une erreur que lorsque les caractères apparaissent les uns à la suite des autres. Vous pouvez donc former la chaîne de caractères à partir de deux littéraux de script.
    Exemple : utiliser des variables de script
    :SET&VAR# = "]]"
    :PRINT'<![[ &VAR#>'




    Example: Use the script element STR_CAT
    :SET&VAR# = STR_CAT("<![[ ]]",">")
    :PRINT&VAR#

La combinaison réservée ##<numéro> constitue une autre particularité. Si cette chaîne de caractères est utilisée dans un littéral de script, le texte est ajouté au message dont le numéro a été indiqué par <numéro>. Veuillez en tenir compte lors de l'utilisation d'un littéral de script.

Exemple :

:PRINT "##1800"

ou

:PRINT ##1800

affiche le résultat suivant dans le rapport :

2011-06-15 13:01:51 - U0020408 ENDED_NOT_OK - aborted.|