Getui
Getui permet d'interroger une propriété du poste client et de la récupérer.
Syntaxe
getui retour = "" with id_param
Paramètres
Elément | Description | Restrictions |
retour | retour d'information sous forme d'une chaîne de caractères |
|
id_param | chaîne de caractères | Les expressions doivent être alphanumériques et sont limitées à 255. |
Exemples
# Exemple 1 : récupération et affichage du nom réseau de la machine cliente
Getui RETOUR = "" with "ComputerName"
K = instr(1,RETOUR,"=")
Infbox "ComputerName= " + right$(RETOUR,K+2)
Description
Getui permet de récupérer une propriété du poste Client. Une seule propriété peut être précisée à la fois.
2 paramètres sont à renseigner : id_param et retour
id_param :
Le paramètre permet d'identifier la propriété à interroger.
Les paramètres disponibles sont les suivants :
Paramètre | Description | Exemple |
ComputerName | Nom réseau de la machine cliente |
|
UserName | Nom de l'utilisateur connecté |
|
X3Version | Version du client X3 | 0,1,3,0 |
X3FileVersion | No de build de l'exécutable X3.exe sous forme de chaîne de caractères | 2,2002,4,15 |
CnxHostName | Nom du serveur de connexion |
|
AppHostName | Nom du serveur d'application |
|
ClientRptDevRDir | Répertoire de développement des états Crystal Report sur le client |
|
X3UserDir | Répertoire où sont stockées les fichiers de données propres à un utilisateur. |
|
X3UserTempDir | Répertoire temporaire associé à un utilisateur. |
|
IDate | Format date | 1 |
SShortDate | Chaîne format date court | dd/mm/yy |
SDate | Caractère séparateur de date ( 4 car. maximum ) | / |
Sdecimal | Caractère séparateur de décimal ( 4 car. maximum ) | , |
Sthousand | Caractère séparateur de millier ( 4 car. maximum ) | . ou rien |
détail du paramètre IDate :
Valeur | Signification |
0 | Mois - Jour - Année |
1 | Jour - Mois - Année |
2 | Année - Mois - Jour |
valeur renvoyée par SShortDate pour la définition du jour :
Valeur | Signification |
d | no du jour dans le mois, non précédé d'un zéro pour les jours 1 à 9. |
dd | no du jour dans le mois, précédé d'un zéro pour les jours 1 à 9. |
ddd | jour de la semaine ; abréviation sur 3 caractères |
dddd | jour de la semaine ; nom entier |
valeur renvoyée par SShortDate pour la définition du mois :
Valeur | Signification |
M | no du mois, non précédé d'un zéro pour les jours 1 à 9. |
MM | no du mois, précédé d'un zéro pour les jours 1 à 9. |
MMM | abréviation du mois sur 3 caractères |
MMMM | nom entier du mois |
valeur renvoyée par SShortDate pour la définition de l'année :
Valeur | Signification |
y | dernier chiffre de l'année |
yy | les 2 derniers chiffres de l'année |
yyyy | l'année complète sur 4 caractères |
valeur renvoyée par SShortDate pour la définition de l'année de référence déterminant le siècle :
Valeur | Signification |
gg | une année de référence est spécifiée pour déterminée le siècle |
retour :
Ce paramètre contient le nom de la variable qui contiendra , en retour de l'instruction, la valeur de la propriété demandée.
Cette valeur est exprimée sous la forme "id_param=" "valeur"