INVITE (unité unique)

Catégorie
Génération d'écran
Autres informations
L'opération INVITE permet d'envoyer une demande d'entrée sur un écran et de revenir au programme sans attendre que l'utilisateur entre les données. Avant d'exécuter des applications WebFacing faisant appel au mot clé INVITE, vérifiez que vous avez installé les modifications provisoires du logiciel i5/OS associées à INVITE pour WebFacing. Vous n'avez pas forcément besoin du mot clé INVITE si vos applications n'utilisent pas d'E-S asynchrones. Dans ce cas, vous pouvez retirer le mot clé INVITE.

L'outil WebFacing prend en charge l'opération INVITE d'une manière différente des unités 5250. La principale différence est que le temporisateur de l'opération READ est géré par le navigateur. Cette différence est due au fait qu'une application peut écraser les enregistrements d'écran affichés sur un écran 5250, mais qu'elle ne peut pas écraser la page affichée dans un navigateur sans que le contrôle ne soit rendu à l'application. L'implémentation du temporisateur dans le navigateur permet à ce dernier de rendre le contrôle à l'application après expiration du temporisateur.

Par défaut, l'outil WebFacing utilise la valeur du paramètre WAITRCD pour le temporisateur du navigateur. Cependant, vous pouvez remplacer cette valeur dans les propriétés du projet WebFacing. Les paragraphes suivants décrivent le fonctionnement du temporisateur tel qu'il est implémenté par l'outil WebFacing. Le tableau ci-dessous présente en détails le comportement de l'opération INVITE.

Si le paramètre WAITRCD est défini sur *IMMED, le navigateur expirera immédiatement. Vous pouvez remplacer la valeur de WAITRCD dans les propriétés d'exécution de votre projet WebFacing pour modifier le délai pendant lequel le navigateur attend qu'une opération de lecture soit effectuée sur les unités invitées. Dans la page de propriétés Exécution de votre application WebFacing, sélectionnez Projet, cochez la case Modifier le délai d'attente d'enregistrement maximum (WAITRCD) des fichiers DDS et indiquez le délai maximum en secondes ou *NOMAX.

A l'expiration de l'opération INVITE, une alerte est générée dans le navigateur si vous avez activé la boîte de dialogue d'expiration pour le mot clé INVITE. Dans la page de propriétés Exécution de votre application WebFacing, sélectionnez Projet et cochez la case Afficher la boîte de dialogue d'expiration du délai pour INVITE. Lorsque l'alerte est générée dans le navigateur, vous avez le choix entre réinitialiser le temporisateur pour l'opération INVITE ou laisser la transaction expirer. A l'expiration de la transaction, les données entrées par l'utilisateur seront perdues. Si vous ne cochez pas la case Afficher la boîte de dialogue d'expiration du délai pour INVITE dans la page des propriétés du projet, aucune alerte ne s'affichera à l'expiration du délai d'attente.

Remarque : Si vous spécifiez une valeur supérieure au délai d'expiration de la session indiqué sur le serveur WAS, la session du navigateur expirera avant l'opération INVITE. Vous devez spécifier une valeur inférieure au délai d'expiration de la session défini sur le serveur WAS.

Vous pouvez changer le contenu de la boîte de dialogue d'avertissement en modifiant le fichier timeout.jsp figurant dans le répertoire \WebContent\webfacing\jsp\common\html de votre projet WebFacing. Vous pouvez également modifier la durée d'affichage de l'avertissement. Par exemple, si vous souhaitez que l'avertissement disparaisse immédiatement sans intervention de l'utilisateur, vous pouvez définir le deuxième paramètre de la méthode window.setTimeout sur 0.

Vous pouvez modifier les paramètres de la boîte de dialogue en mettant à jour le fichier webface.js correspondant à votre édition (par exemple, webfac512.js pour la version 5.1.2) qui figure dans le répertoire \WebContent\webfacing\ClientScript de votre projet WebFacing. Dans ce fichier, vous pouvez modifier des attributs tels que la taille et la position de la boîte de dialogue d'avertissement. Vous pouvez modifier ces attributs en mettant à jour les paramètres de la méthode window.showModalDialog.

Le tableau suivant présente les différences de traitement de l'opération INVITE entre l'application 5250 et l'outil WebFacing :
  5250 WebFacing
Délai WAITRCD Le délai WAITRCD commence à expirer lorsque l'opération de lecture sur les unités invitées est réalisée par l'application. Le délai WAITRCD commence à expirer lorsque l'opération d'écriture avec invite est réalisée par l'application.
WAITRCD défini sur *IMMED L'utilisateur peut entrer des données sans interruption jusqu'à ce qu'il appuie sur une touche AID ou que l'opération INVITE en attente soit annulée. S'il n'appuie pas sur une touche AID avant que l'application n'effectue une opération de lecture sur les unités invitées, une exception d'expiration est renvoyée à l'application, mais l'unité continuera à accepter l'entrée de données. Le navigateur expirera immédiatement et l'utilisateur ne pourra pas entrer de données.
WAITRCD défini sur une valeur trop faible L'utilisateur peut entrer des données sans interruption jusqu'à ce qu'il appuie sur une touche AID ou que l'opération INVITE en attente soit annulée. S'il n'appuie pas sur une touche AID avant que l'application n'effectue une opération de lecture sur les unités invitées et que le délai en secondes spécifié pour WAITRCD est écoulé, une exception d'expiration est renvoyée à l'application, mais l'unité continuera à accepter l'entrée de données. Le navigateur expirera une fois le délai en secondes spécifié pour WAITRCD écoulé et l'utilisateur ne pourra pas entrer de données.
L'application réalise une opération de lecture(attente) (elle attend que l'utilisateur appuie sur une touche AID pour rendre le contrôle à l'application) au lieu d'une opération de lecture sur les unités invitées après une opération d'écriture avec invite L'utilisateur peut entrer des données sans interruption jusqu'à ce qu'il appuie sur une touche AID ou que l'opération INVITE en attente soit annulée. L'unité continuera à accepter l'entrée de données. Si WAITRCD n'est pas défini sur *NOMAX, le navigateur risque d'expirer et les données entrées seront alors perdues. La lecture(attente) entraînera le réaffichage du format d'enregistrement invité et activera l'entrée de données, sans les données précédemment entrées.
L'application réalise une opération de lecture sur les unités invitées en réponse à une opération de lecture sur les unités invitées expirée L'utilisateur peut entrer des données sans interruption jusqu'à ce qu'il appuie sur une touche AID ou que l'opération INVITE en attente soit annulée. L'unité continuera à accepter l'entrée de données. Le navigateur expirera et les données entrées seront alors perdues. Chaque nouvelle opération de lecture sur les unités invitées entraînera le réaffichage du format d'enregistrement invité et activera l'entrée de données, sans les données précédemment entrées.
Annulation d'une opération INVITE lorsque WAITRCD est défini sur *NOMAX ou sur une valeur trop élevée La demande INVITE en attente est annulée presque immédiatement pour une demande explicite (ENDRCV par exemple) ou implicite (écriture d'un autre format d'enregistrement), si la demande est traitée avant que l'utilisateur n'appuie sur une touche AID. L'écran continuera à accepter l'entrée de données. La demande INVITE en attente est annulée à l'expiration du navigateur ou lorsque l'utilisateur appuie sur une touche AID. Les demandes implicites ne sont réalisées qu'à l'expiration du navigateur. Si l'utilisateur n'appuie pas sur une touche AID, une demande d'annulation ne peut être réalisée avant la fin du délai en secondes défini pour WAITRCD. Si WAITRCD est défini sur *NOMAX et que l'utilisateur n'appuie sur aucune touche AID, la demande ne sera jamais réalisée.
Suspension d'une opération INVITE lorsque WAITRCD est défini sur *NOMAX ou sur une valeur trop élevée La demande INVITE en attente est presque immédiatement suspendue. La demande de suspension ne peut être réalisée avant la fin du délai en secondes défini pour WAITRCD. Si WAITRCD est défini sur *NOMAX et que l'utilisateur n'appuie sur aucune touche AID, la demande ne sera jamais réalisée.