ASKUI

Askui 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.  

Syntaxe

   Askuiretour=""with action, liste_param

Paramètres

Exemples

# Exemple 1 : copier un fichier excel
# duposte client vers le dossier TMP du serveur
# pré-positionner le dossier courant de la fenêtre de sélection de fichier
# par le dossier "mes documents" du poste client   
Local char RETOUR(250)
Askui RETOUR="" With "UIAsk="+chr$(1) + "AskPutFile",
& "UIRemotePath="+ chr$(1) + "TMP",
& "UILocalFileExts="+ chr$(1) + "xls",
& "UILocalPath="+chr$(1) + "#myDocuments"

# Exemple 2 : désigner un fichier word
# pré-positionner le dossier courant de la fenêtre de sélection de fichier
# par le dossier "mes documents" du poste client   
Local char RETOUR (250)
Askui RETOUR="" With "UIAsk="+chr$(1) + "AskSelFile",
& "UILocalFileExts="+ chr$(1) + "doc",
& "UILocalPath="+chr$(1) + "#myDocuments"

# Exemple 3 : lire un fichier texte du poste client   
Local Clbfile RETOUR(10)
Setlob RETOUR With ""
Askui RETOUR With "UIAsk="+chr$(1) + "AskReadTextFile",
& "UILocalFileExts="+ chr$(1) + "txt"

# Exemple 4 : lancer une commande shell sur le poste client   
Local Clbfile RETOUR(10)
Setlob RETOUR With ""
Askui RETOUR With "UIAsk="+chr$(1) + "AskExecShell",
& "UILocalShell="+ chr$(1) + "AdxOfficemodule.hta -cmd xlsinsert -input 'TMP/data.csv'"

# Exemple 5 : copier un fichier "200406.etebac" 
# du dossier BANQ du dossier courant du serveur vers le poste client 
# pré-positionner le dossier courant de la fenêtre de sélection de fichier
# par le dossier "mes documents" du poste client   
Local char RETOUR(250)
Askui RETOUR="" With "UIAsk="+chr$(1) + "AskGetFile",
& "UIRemotePathFile="+ chr$(1) + "BANQ,200406,etebac",
& "UIRemoteBinary="+ chr$(1) + "0",
& "UILocalFileName="+ chr$(1) + "200406.etebac",
& "UILocalPath="+chr$(1) + "#myDocuments"

Description et commentaires

Askuipermet de piloter le client. Le client reçoit (via le moteur) l'ordre d'exécuter unAskui. Il interprète les paramètres associés, et il prend en charge le transfert ou l'ouverture du fichier.

Askuipermet de lancer l'une des actions suivantes :

• transférer un fichier du poste client  vers le serveur
• transférer un fichier du serveur vers le poste client
• sélectionnerun fichier sur le poste client
• lire le contenu d'un fichier texte sur le poste client
• lancer une commande shell sur le poste client

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. En cas de transfert ou de sélection de fichier, on aura enretour, le nom et chemin du fichier de destination. En cas de lecture d'unfichier texte, on aura en retour, un clob avec le contenu du fichier texte. En cas delancement d'une commande shell, on aura en retour, un clob contenant la sortie standard du processus (stdout) et la sorite des erreurs ( stderr). 

action :

Ce paramètre permet d'identifier l'action à lancer sur le client.

Les actions disponibles sont les suivantes :

id_param

Les paramètres disponibles par action sont les suivants :

Explication de chaque paramètre : 

Identifiants possibles de dossiers standards (Special Folders) du poste client : 

#AllUsersDesktop : 
The file system directory that contains files and folders that appear on the desktop for all users. 
A typical path is C:\Documents and Settings\All Users\Desktop.

#AllUsersStartMenu : 
The file system directory that contains the programs and folders that appear on the Start menu for all users. 
A typical path is C:\Documents and Settings\All Users\Start Menu.

#AllUsersPrograms : 
The file system directory that contains the directories for the common program groups that appear on the Start menu for all users. 
A typical path is C:\Documents and Settings\All Users\Start Menu\Programs.

#AllUsersStartup : 
The file system directory that contains the programs that appear in the Startup folder for all users. 
A typical path is C:\Documents and Settings\All Users\Start Menu\Programs\Startup.

#Desktop : 
The file system directory used to physically store file OBJects on the desktop (not to be confused with the desktop folder itself). 
A typical path is C:\Documents and Settings\username\Desktop.

#Favorites :
The file system directory that serves as a common repository for the user's favorite items. 
A typical path is C:\Documents and Settings\username\Favorites.

#Fonts : 
A virtual folder containing fonts. 
A typical path is C:\Windows\Fonts.

#MyDocuments : 
The file system directory used to physically store a user's common repository of documents. 
A typical path is C:\Documents and Settings\username\My Documents.

#NetHood : 
A file system directory containing the link OBJects that may exist in the My Network Places virtual folder. It is not the same as CSIDL_NETWORK, which represents the network namespace root. 
A typical path is C:\Documents and Settings\username\NetHood.

#PrintHood : 
The file system directory that contains the link OBJects that can exist in the Printers virtual folder. 
A typical path is C:\Documents and Settings\username\PrintHood.

#Programs : 
The file system directory that contains the user's program groups (which are themselves file system directories). 
A typical path is C:\Documents and Settings\username\Start Menu\Programs.

#Recent : 
The file system directory that contains shortcuts to the user's most recently used documents. 
A typical path is C:\Documents and Settings\username\My Recent Documents.

#SendTo : 
The file system directory that contains Send To menu items. 
A typical path is C:\Documents and Settings\username\SendTo.

#StartMenu :
 The file system directory containing Start menu items. 
A typical path is C:\Documents and Settings\username\Start Menu.

#Startup : 
The file system directory that corresponds to the user's Startup program group. The system starts these programs whenever any user logs onto Windows NT or starts Windows 95. 
A typical path is C:\Documents and Settings\username\Start Menu\Programs\Startup.

#Template : 
The file system directory that serves as a common repository for document templates. 
A typical path is C:\Documents and Settings\username\Templates. 

retour :

Ce paramètre permet d'identifier la variable qui contiendra les informationsde retour de l'instruction.

En retour, l'instruction nous envoie les informations suivantes :

Nouveautés de la version 142

C'est une nouvelle instruction.

Erreurs associées

Mots-clés associés

  GETUI - CALLUI

SOMMAIRE