Création d'URL pour accéder aux clients Web
Dans le client Web, les écrans sont accessibles à l'aide d'URL. Ces URL peuvent être construites avec une URL de base et des paramètres d'URL facultatifs. Dans certains cas, vous pouvez contourner l'URL normale et construire une URL qui n'exige pas que l'utilisateur se connecte en contournant la page Connexion.
URL de base
Les URL utilisées pour accéder aux écrans doivent respecter un format spécifique. Le format de base est le suivant :
http(s)://webserver/wswebclient/default.aspx
où webserver est le nom du serveur Web sur lequel réside le logiciel client Web.
Paramètres d'URL
A l'URL de base, vous pouvez ajouter n'importe lequel d'un certain nombre de paramètres d'URL qui contrôlent ce qu'il advient lors de l'ouverture du client Web. Pour ajouter ces paramètres à l'URL de base :
- Ajoutez un point d'interrogation immédiatement après l'URL de base.
- Indiquez un ou plusieurs paramètres sans espaces.
- Séparez les paramètres multiples par des symboles esperluette (&).
Les paramètres n'ont pas besoin d'apparaître dans un ordre particulier pour pouvoir être utilisés par le système.
Cette table répertorie et décrit les paramètres d'URL suivants :
| Paramètre d'URL (syntaxe) | Libellé |
|---|---|
| user=userName | Paramètre de connexion.
La valeur de userName est l'ID utilisateur de connexion. Lorsqu'il est indiqué, le champ ID utilisateur sur la page Connexion est automatiquement renseigné avec cet ID utilisateur. |
| config=configName | Paramètre de connexion.
La valeur de configName est le nom de la configuration à laquelle l'utilisateur souhaite se connecter. Lorsqu'elle est indiquée, cette configuration est automatiquement sélectionnée et s'affiche dans le champ Configuration de la page Connexion. |
| configgroup=configGroupName | Paramètre de connexion.
La valeur de configGroupName est le nom du groupe de configuration auquel appartient la configuration nommée. Utilisez cette option lorsque vous souhaitez afficher uniquement les membres du groupe de configuration indiqué dans la liste déroulante Configuration de la page Connexion. |
|
form=formName
form=formName(launchParams) |
Paramètre de démarrage de sessions.
La valeur de formName est le nom de l'écran à ouvrir. Ce paramètre peut être utilisé avec ou sans paramètres de lancement d'écran (launchParams). Par exemple, le paramètre écran=Evénements en tant que paramètre d'URL ouvre l'écran Evénements avec ses paramètres par défaut. form=Events(FILTER(EventName='IdoOnInvoke')SETVARVALUES(InitialCommand=Refresh)) en tant que paramètre d'URL avec des paramètres de lancement d'écran supplémentaires, filtre la collection Evénements pour l'événement IdoOnInvoke framework, puis actualise l'écran (en supprimant le paramètre InitialCommand par défaut de l'écran) lorsqu'il s'ouvre pour afficher uniquement cet événement. Remarque: Il est possible de faire un filtrage de valeurs lors du lancement d'un écran avec ces paramètres de lancement.
|
| page=formonly
ou page=light |
Paramètre de démarrage de sessions.
Lorsque l'option "formonly" est utilisée avec ce paramètre, l'écran s'ouvre sans aucun des menus ou barres d'outils habituels de WinStudio et sans accès à l'Explorateur. Cette option est principalement destinée à être utilisée avec des écrans conçus pour être utilisés sur des appareils mobiles, où l'espace est précieux. Pour plus d'informations, reportez-vous à la rubrique A propos de la barre d'outils en mode Form-only. Lorsque l'option "léger" est utilisée avec ce paramètre, l'écran s'ouvre dans un client navigateur Web léger spécial. Ceci est, une fois encore, une fonctionnalité conçue principalement pour les écrans et les applications des appareils mobiles. |
| notitle=1 | Ce paramètre est utilisé conjointement avec le paramètre page=formonly. Lorsqu'il est indiqué, il dit au navigateur de ne pas afficher la barre de titre de l'écran. |
| deviceid=number | Ce paramètre est utilisé principalement lors de l'affichage de l'écran test. Le number indique la définition du type d'équipement, telle que définie dans l'écran Modif. types équipmt, à utiliser pour afficher l'écran. |
| menu=hidden | Paramètre de démarrage de sessions.
Ce paramètre sert à masquer le menu principal. |
Contourner la page de connexion
Dans certains cas, vous souhaiterez peut-être que vos utilisateurs puissent accéder à un écran particulier de votre application sans avoir à se connecter. Vous pouvez le faire avec une URL formatée comme suit :
http://webserver/WSWebClient/session/open/configname/
où :
- web server est le nom du serveur Web sur lequel réside le logiciel client Web.
- configname est le nom de la configuration que l'utilisateur est autorisé à utiliser.
- username est l'ID utilisateur Mongoose de l'utilisateur.
Vous pouvez également ajouter des paramètres d'URL à ce format d'URL.