Vous pouvez placer les commandes WFS suivantes dans le fichier site.wfs ou dans le profil de nœud d'un serveur spécifié.

<EXIT>

<INCLUDE> filename

<CONDITIONAL_INCLUDE> filename

<SET> variable (option)

<CALL> function(parm1,...)

<IF> variable operator value 
<ELSE>
<ENDIF>

<IFDEF> variable 
<ELSE>
<ENDIF>

<IFNDEF> variable 
<ELSE>
<ENDIF>

<SENDVAR> name={constant|&value}
<ENDSENDVAR>

Lorsque vous codez des commandes WFS, vous pouvez utiliser la syntaxe suivante.

<! >
#

<! This is a comment.> 
# This is also a comment.

\\=

long_string = this is a \\=
very long string that \\=
needs multiple lines 

\n

value = 
{constant|&variable}

long_string = this is a 
long_string = &long_string very long string 
long_string = &long_string that requires 
multiple lines

Lorsqu'une barre oblique (\) est utilisée comme caractère d'échappement, vous pouvez :

• Comprend un délimiteur de chaîne, comme par exemple un guillemet simple ('), comme faisant partie de la valeur comprise dans une chaîne. Si vous précédez le caractère avec une barre oblique (\), le caractère est interprété comme une donnée, mais pas comme un délimiteur de fin de chaîne.
• Ajoutez une barre oblique (\) comme faisant partie de la valeur comprise dans la chaîne. Vous pouvez précédez la barre oblique (\) avec une seconde barre oblique (\\).

Lorsqu'une barre oblique (\) est utilisée comme caractère d'échappement, elle n'est pas comprise dans les calculs en fonction de la longueur de la chaîne. Une chaîne de cinq caractères et un caractère d'échappement tient dans une variable de cinq caractères.

Les variables de client WebFOCUS permettent de contrôler l'affichage de plusieurs rapports sur la même page HTML avec plusieurs cadres, sans nécessiter la syntaxe de codage HTLM FRAME. Elles vous permettent également de lier plusieurs rapports avec une Table de matières (TDM). Vous pouvez utiliser ces variables pour afficher des formats de rapports différents, par exemple des formats HTML et PDF, sur une même page de lancement. Pour modifier la sortie résultante des requêtes provenant du serveur de génération de rapports WebFOCUS, spécifiez la syntaxe suivante sur le serveur de génération de rapports WebFOCUS:

-TYPE WEBFOCUS CGIVAR variable = value

où :

variable

Est le nom de la variable du client WebFOCUS.

value

Spécifie la valeur de la variable du client WebFOCUS.

Pour plus d'informations sur les noms de variable du client WebFOCUS et les valeurs possibles, consultez le manuel Développement des application de rapports.

Vous pouvez intégrer des fichiers externes dans un traitement WFS standard. La commande <INCLUDE> suivante permet d'appeler un autre fichier WFS à partir des fichiers WFS standards. Le fichier personnalisé doit exister pour que le traitement puisse se poursuivre.

<INCLUDE> filename

où :

filename

Est le nom du fichier à ajouter pour le traitement WFS.

Remarque : la commande <CONDITIONAL_INCLUDE> filename fonctionne de la même manière que <INCLUDE> filename sauf que le fichier ne doit pas forcément exister.

La commande <SET> suivante active la validation et le contrôle des variables du client WebFOCUS passées d'un cookie ou d'un formulaire:

<SET> variable (option)

où :

variable

Est le nom de la variable du client WebFOCUS.

option

Peut être l'une des valeurs suivantes :

pass (transmettre)

Spécifie que la variable sera considérée comme une variable amper du Gestionnaire de dialogues sur le serveur de génération de rapports WebFOCUS. C'est la valeur par défaut.

dontpass (ne pas transmettre)

Spécifie que la variable ne sera pas passée au serveur dde rapports WebFOCUS.

protect (protéger)

Spécifie que la variable ne peut pas être définie depuis le navigateur.

Remarque : il ne faut pas appliquer l'option « protect » aux variables IBIF_focexec et IBIF_ex. Cela empêcherait WebFOCUS d'exécuter la procédure.

nombre

Spécifie que la variable doit uniquement être numérique.

alpha

Spécifie que la variable ne peut contenir que des caractères alphanumériques (0-9, a-z) et des points (.).

string (chaîne)

Spécifie que tous les caractères sont valides.

length=n

Définit la longueur maximale en caractères d'une variable. Par défaut, la longueur est illimitée.

Pour activer le plugin du servlet WebFOCUS, vous devez définir la variable WFEXT au nom de classe ibi.webfoc.WFEXTDefault dans le fichier cgivars.vars.

1. Connectez-vous à WebFOCUS en tant qu'administrateur et sélectionnez Console d'administration dans le menu Administration.
2. Sélectionnez Configuration, puis Paramètres du client, puis Plug-in.
3. Si le nom de classe ibi.webfoc.WFEXTDefault ne s'affiche pas comme valeur de la variable WFEXT, saisissez-le et cliquez sur Enregistrer.

Remarque : seul un plugin peut être actif à la fois. Si vous souhaitez ajouter une fonctionnalité supplémentaire, vous devez développer la classe pour y incorporer la nouvelle fonctionnalité, assurant ainsi que vous ne perdez pas l'accès aux méthodes fournies par cette classe.

La commande <CALL> suivante invoque un plug-in WebFOCUS.

<CALL> routine(parm1,parm2) 
<IF> RETCODE NE "returncodevalue"
# insert your code here
<ENDIF>

où :

<CALL>

est la commande qui appelle le plugin WebFOCUS.

routine

Définit le nom de la fonction à appeler (par exemple, security ou CopyHTTPCookieToWFVar).

(parm1,parm2)

sont les paramètres d'entrée du plugin WebFOCUS. Chaque plugin WebFOCUS peut contenir un maximum de dix paramètres d'entrée. Le segment de sortie est transmis, mais ne contribue pas au nombre maximal de paramètres d'entrées.

RETCODE

indique l'état de l'appel de méthode.

returncodevalue

Est la valeur avec laquelle la valeur renvoyée par le plugin doit être comparée (par exemple, 0).

L'instruction <IF> suivante vérifie conditionnellement les variables du client WebFOCUS.

<IF> variable operator value 
<ELSE>
<ENDIF>

où :

variable

Est toute variable du client WebFOCUS.

opérateur

Peut être défini à EQ, NE, CONTAINS, OR, ou AND.

value

Cette valeur peut être appliquée à n'importe quelle variable du client WebFOCUS.

Vous pouvez utiliser l'instruction <IF> suivante afin d'assurer l'appel de la page de connexion WebFOCUS.

Si vous ajoutez « upper » à une variable WFS, la valeur est vérifiée comme si elle contenait uniquement des lettres majuscules. Ceci vous permet de vérifier la valeur saisie par l'utilisateur sans se soucier de la casse.

L'instruction suivante <IF> assure que toute valeur saisie est considérée comme caractère en majuscule.

<IF> ABC.upper EQ "Y" OR ABC.upper EQ "YES"
DEF = &GHI
<ENDIF>

L'instruction <IF> suivante assure que toutes les valeurs de serveur saisies ne sont pas sensibles à la case.

<IF> IBIC_server.upper EQ "EDASERV"
# INSERT YOUR CODE HERE....
<ENDIF>

L'instruction <IF> suivante vérifie si la constante .ibi.com est comprise dans la variable HTTP_HOST du client WebFOCUS.

<IF> HTTP_HOST contains ".ibi.com"
# INSERT YOUR CODE HERE....
<ENDIF>

L'instruction <IFDEF> suivante vérifie l'existance d'une variable du client WebFOCUS.

<IFDEF> variable 
<ELSE>
<ENDIF>

où :

variable

Est toute variable du client WebFOCUS.

Dans l'exemple ci-après, si la variable _ON_NT existe, PATH_SEP est défini comme un point-virgule (;). Si la variable _ON_NT n'existe pas, PATH_SEP est défini comme un point-virgule (;).

<IFDEF> _ON_NT
PATH_SEP=; 
<ELSE> PATH_SEP=: 
<ENDIF>

L'instruction <IFNDEF> suivante vérifie la non existance d'une variable du client WebFOCUS.

<IFNDEF> variable 
<ELSE>
<ENDIF>

où :

variable

Est toute variable du client WebFOCUS.

La commande <SET> permet d'envoyer les variables au serveur de génération de rapports WebFOCUS pour une utilisation avec les procédures du serveur. Certaines variables personnalisées sont automatiquement envoyées au serveur de génération de rapports WebFOCUS. Cette syntaxe est utilisée pour les variables qui ne sont pas envoyées automatiquement au serveur de génération de rapports WebFOCUS.

<SET> name = {constant|&variable} (pass)

où :

name

Est une variable Dialogue Manager à utiliser par le serveur de génération de rapports WebFOCUS.

constant

Est une valeur littérale. Si vous incluez des guillemets ("), ils sont passés comme partie intégrante de la variable. Cette valeur peut être appliquée à n'importe quelle variable du client WebFOCUS.

&variable

Est un paramètre substituable pour une valeur. Cette valeur peut être appliquée à n'importe quelle variable du client WebFOCUS.