Manuel des Scripts Automation Engine > Organisation fonctionnelle > Elaboration et traitement des Scripts > :INCLUDE

:INCLUDE

Instruction de Script : Associe un objet Include à un Script.

Syntaxe

:INC[LUDE] objet Include [ChaîneAncienne = ChaîneNouvelle][,NOFOUND=IGNORE][,EXT_REPORT=OFF]

Elément de syntaxe	Description/format
Objet Include	Nom de l'objet Include à associer. Entrez le nom complet de l'objet Include. Les Variables de Script ne sont pas autorisées.
ChaîneAncienne	Chaîne de caractères du Script de l'objet Include qui doit être remplacée par ChaîneNouvelle. Format : Littéral de Script
ChaîneNouvelle	Chaîne de caractères qui remplace ChaîneAncienne dans le Script de l'objet Include. Format : Littéral de Script 50 caractères maximum
NOFOUND=IGNORE	Si l'objet Include indiqué n'est pas trouvé, aucune erreur ne se produit.
EXT_REPORT=OFF	Le contenu de l'objet Include n'est pas consigné dans les rapports détaillés. Au lieu de cela, une ligne de conseil s'affiche.

Remarques

Dans les Scripts AE, de nombreux objets suivent les mêmes étapes de traitement. Pour ne pas avoir à les écrire et à les gérer dans chaque Script, il existe les objets Include. Ceux-ci comportent dans leur Script les éléments de Scripts récurrents et souvent utilisés.

Pour faire communiquer un objet Include avec un autre objet, on utilise l'instruction :INCLUDE. Le Script de l'objet Include est généré en plus lors de l'activation de l'objet.

ChaîneAncienne et ChaîneNouvelle sont optionnels. Ces instructions peuvent être utilisées pour remplacer une chaîne de caractères de l'objet Include par une nouvelle chaîne. Cette attribution n'est valide que pour la génération en cours et ne modifie pas l'objet Include.

Exemples

L'exemple illustre l'association d'un objet Include. Pour ce faire, un nouveau nom "$GSTEST." est attribué au lieu de la chaîne de caractères "$GS." de l'objet Include.

:INC GS.ATTRIBUTIONSFICHIERS "$GS." = "$GSTEST."

Dans l'exemple, un Include Utilisateur est exécuté. S'il n'y en a pas, aucune erreur ne se produit.

:INCLUDE HEADER.WINDOWS.USER.HEAD ,NOFOUND=IGNORE

Dans le troisième exemple, on empêche que le contenu de l'objet Include soit consigné dans les rapports détaillés.

:INC GS.ATTRIBUTIONSFICHIERS ,EXT_REPORT=OFF

Rubriques connexes :

Elément de script	Description
:INC_SCRIPT	Association d'un Script à un autre Script du même objet.

Elément de script - Elaboration et traitement des Scripts

Généralités sur les Scripts
Elément de script - Liste alphabétique
Elément de script- Division fonctionnelle