Callui permet d'exécuter une action prédéterminée sur le poste client. La liste des actions est référencée ci-dessous.
Callui retour = "" with action, liste_param
Elément | Description | Restrictions |
retour | retour d'information sous forme d'une chaîne de caractères | |
action | code action : chaîne de caractères sous la forme : | |
liste_param | Liste de id_param séparés par le caractère ','. | Les expressions doivent être alphanumériques et sont limitées à 255. |
id_param | paramètre : chaîne de caractères sous la forme : | Les expressions doivent être alphanumériques et sont limitées à 255. |
# Exemple 1 : copier un fichier du serveur sur le poste client
Callui RETOUR="" With "UIAction="+chr$(1) + "GetFileAlways",
& "UIRemoteFile="+ chr$(1) + "PIC/AUS_PC.jpg",
& "UILocalFile="+ chr$(1) + "Pepere.jpg",
& "UILocalDir="+chr$(1) + "RtsTemp"Infbox "GetFileAlways"+RETOUR
# Exemple 2 : ouvrir ce fichier ( sur le poste client)
Callui RETOUR="" With "UIAction="+chr$(1)+"OpenFile",
& "UILocalDir="+chr$(1) + "RtsTemp",
& "UILocalFile="+ chr$(1) +"Pepere.jpg"Infbox "OpenFile"+RETOUR
# Exemple 3 : ouvrir une session du navigateur internet
Callui RETOUR="" With "UIAction="+chr$(1)+"OpenFile",
& "UILocalDir="+chr$(1) + "HTTP",
& "UILocalFile="+ chr$(1) +"www.meteo.fr"########################################################################
# Exemple 4
# Ouverture d'un lien http sur un répertoire publié du serveur
#########################################################################
Subprog OPEN_HTTP(URL)
Value Char URL
Local Char RETOUR (250)
Callui RETOUR="" With "UIAction="+chr$(1)+"OpenFile",
& "UILocalDir="+ chr$(1) +"HTTP",
& "UILocalFile="+ chr$(1) +URL,
& "UIAdxPubSubFile="+ chr$(1) + "1"
End
Callui permet de piloter le client. Le client reçoit (via le moteur) l'ordre d'exécuter un Callui. Il interprète les paramètres associés, et il prend en charge le transfert ou l'ouverture du fichier.
Callui permet de lancer l'une des actions suivantes :
Une seule action peut être précisée à la fois.
En retour, nous avons un code nous précisant que l'action s'est bien déroulée ou pas.
Ce paramètre permet d'identifier l'action à lancer sur le client.
Les actions disponibles sont les suivantes :
Action | Description |
OpenFile | Ouverture de fichier sur le poste client |
GetFile | Transfert d'un fichier du serveur vers le poste client seulement si le fichier du serveur est plus récent |
GetFileAlways | Transfert d'un fichier du serveur vers le poste client |
PutFile | Transfert d'un fichier du poste client vers le serveur seulement si le fichier du serveur est plus récent |
PutFileAlways | Transfert d'un fichier du poste client vers le serveur |
Il permet de préciser les paramètres d'une action.
la liste des paramètres est la suivante :
Paramètres | Description |
UILocalFile | Nom du fichier sur le poste client |
UILocalDir | Répertoire du fichier sur le poste client. 3 répertoires sont disponibles :
si le répertoire n'est pas précisé, TEMP est pris par défaut |
UIRemoteFile | Nom du fichier sur le poste serveur, précédé du chemin. |
UIAdxPubSubFile | Flag positionné à 1, permet d'identifier les urls correspondants à des sous-fichiers du dossier X3_PUB. |
Liste des paramètres possibles par action :
Action | Paramètres |
OpenFile | UILocalDir |
UILocalFile | |
GetFile | UILocalDir |
UILocalFile | |
UIRemoteFile | |
Ce paramètre permet d'identifier la variable qui contiendra les informations de retour de l'instruction.
En retour, l'instruction nous envoie le nom de l'action, suivi du code statut.
Le code statut prend l'une ou l'autre des valeurs suivantes :
1 : l'action s'est déroulée correctement
0 : une erreur s'est produite au cours de l'action.