FERMER (Contexte Adélia Web)

Attention :

• • "FERMER NomVue" n'est utilisable que dans une partie serveur,
  • "FERMER CodeMaquette" n'est utilisable que dans une partie cliente d'un programme Adélia Web batch avec état.

Paragraphe d'utilisation

Tous

Syntaxe

FERMER NomVue

FERMER CodeMaquette Format Fichier

FERMER CodeMaquette Format Téléchargt

FERMER CodeMaquette Impression

Description

Cet ordre est utilisé pour gérer la fermeture des fichiers ou des maquettes dans un programme.

Le fichier ne peut plus être utilisé dans ce programme s'il n'est pas rouvert de manière explicite par l'ordre OUVRIR. On ne peut fermer qu'un fichier qui a été ouvert, soit de manière implicite, soit par l'ordre OUVRIR.

Par défaut, la gestion de l'ouverture et de la fermeture des fichiers est faite de manière implicite par Adélia.

Dans le cas où il est nécessaire de gérer soi-même l'ouverture ou la fermeture des fichiers et des maquettes, il faut modifier les options de génération par défaut et indiquer que l'on gère l'ouverture, ou indiquer le paramètre *OPEN lors d'une déclaration par l'ordre VUE.

Ainsi, le programme ne va pas ouvrir/fermer le fichier automatiquement au début et en fin d'exécution, et il sera possible de gérer ces opérations à la demande.

S'il s'agit de l'ouverture/fermeture d'un fichier maquette, un paramètre de ce type doit également être mis à jour dans les options de génération.

Il est aussi possible d'utiliser ces ordres sans modifier les options de génération. Il faut bien sûr, dans ce cas, "FERMER NomVue" avant "OUVRIR NomVue".

Il est possible, si les options de génération ont été modifiées pour demander l'ouverture d'un fichier, d'ouvrir ce fichier grâce aux commandes AS/400 (OPNDBF, etc.).

Par exemple

* Fermeture immédiate du fichier PARAM s'il n'y en a pas besoin après.

* Remarque : Le paramètre "Ouv." est laissé à blanc dans les options de génération

CLE_PARAM = 'TAXE'

LIRE PARAMETRES

W_TAXE = PARAM_TAXE

FERMER PARAMETRES

*

La fermeture explicite d'un fichier maquette permet, aux travers des options proposées, de modifier le comportement standard. Une fermeture implicite permet d'afficher un état au format PDF dans le navigateur web. La fermeture explicite "FERMER CodeMaquette" sans option supplémentaire joue le même rôle.

L'ordre FERMER, lorsqu'il concerne une maquette état,  termine l'exécution du programme sauf dans le cas du *FICHIER ou du *IMPRIMER, ou dans le cas où une erreur est levée pendant le traitement de l'ordre. En cas d'erreur, le mot réservé *CODE_RETOUR peut prendre les valeurs suivantes :

• Valeur comprise entre 1 et 9999 : erreur rencontrée durant la production de l'état.

• Valeur entre 10001 et 19999 : erreur middleware (retrancher 10000 à cette valeur pour retrouver les erreurs middlware "classiques").

• Valeur comprise entre 20001 et 29999 : erreur rencontrée lors de la production de la réponse HTTP faite pour envoyer l'état au navigateur web.

L'utilisation de "*FORMAT(NomFormat)" permet de modifier le format de l'état. Ce dernier peut alors être celui d'un :

• document WORD si NomFormat est égal à la constante 'DOC'

• document EXCEL si NomFormat est égal à la constante 'XLS'

• document Rich Text Format si NomFormat est égal à la constante 'RTF'

• document XML si NomFormat est égal à la constante 'XML'

• document HTML si NomFormat est égal à la constante 'HTML'

• document PDF si NomFormat est égal à la constante 'PDF'.

Remarques :

- L'affichage dans le navigateur Web d'un document peut ne pas être possible si le format de ce dernier n'est pas reconnu. Le navigateur ouvre alors une boîte de dialogue standard de téléchargement permettant de sauvegarder le document sur le poste ou bien de choisir une application parmi celles disponibles sur le poste pour ouvrir le document.

- A partir d'Adélia Studio version 13.0 PTF05 : les données sont conservées en cache pendant 30 minutes (par défaut). Cela permet de reprendre un téléchargement interrompu ou de lancer plusieurs requêtes de téléchargement.

Ce temps d'attente est paramétrable comme suit : dans le fichier ehcacheAdelWeb.xml (répertoire WEB-INF\classes) de votre application Web, modifiez les paramètres timeToIdleSeconds et timeToLiveSeconds. Nous vous déconseillons fortement de modifier les autres paramètres.

L'utilisation de "*FICHIER(NomFichier)" permet de stocker l'état sur le serveur Web. Dans ce cas de figure l'état n'est pas envoyé au navigateur Web pour y être affiché.

NomFichier peut être un simple nom de fichier ou bien un nom précédé d'un chemin absolu ou relatif. Dans les cas du simple nom de fichier ou du chemin relatif, le répertoire de base de stockage est le répertoire de l'application web courante.

L'utilisation de *TELECHARGER ou de *TELECHARGER(NomDoc) indique au navigateur web d'ouvrir la boîte de dialogue standard de téléchargement. Celle-ci propose de sauvegarder le document sur le poste ou bien de choisir une application parmi les applications disponibles sur le poste pour ouvrir le document. Le nom du document est "NomDoc" ou 'Document' par défaut. Le nom de document est toujours suffixé par l'extension spécifique à son format.

Remarque : Le format 'HTML' est toujours affiché dans le navigateur Web.

L'utilisation de "*IMPRIMER" est réservée à un contexte intranet. L'objectif est d'imprimer physiquement l'état.

L'utilisation de "*IMPRIMER" sans option équivaut à "*IMPRIMER(1)".

NumImpLog définit un numéro d'imprimante logique. L'association avec une imprimante physique est stockée dans un fichier de configuration. Les paramètres d'impression non fixés à l'aide de OptImpression sont lus dans ce même fichier de configuration.

NomRscImp est le nom d'une ressource imprimante.

L'utilisation de *ORIENTATION permet de choisir entre une orientation en mode portrait (1) et une orientation en mode paysage (2).

L'utilisation de *ALIM_PAPIER permet de choisir le bac d'alimentation de papier.

Voir fonction de la VaToolBx VaToolBxSetAdeliaPrinterEx pour la liste des valeurs.

L'utilisation de *FMT_PAPIER permet de choisir la taille du papier.

Voir fonction de la VaToolBx VaToolBxSetAdeliaPrinterEx pour la liste des valeurs.

L'utilisation de *NB_COPIES permet de choisir le nombre de copies à imprimer (AttrCopies). Le paramètre supplémentaire "Assemblage" permet éventuellement de regrouper les copies.

L'utilisation de *RECTO_VERSO permet de choisir une impression de type recto (1), recto-verso suivant le bord long (2) ou recto-verso suivant le bord court (3).

L'utilisation de *DE_PAGE permet de définir la première page à imprimer.

L'utilisation de *A_PAGE permet de définir la dernière page à imprimer.

Remarque : un seul état peut être envoyé vers le navigateur Web. Cet état est soit l'état courant dans le cas d'une fermeture implicite, soit l'état référencé par le premier ordre FERMER traité sans option *FICHIER.

Par exemple

• Envoi de l'état vers le navigateur Web au format Word

FERMER EtatCR1 *FORMAT('DOC')

• Stockage sur le serveur Web de l'état au format Excel

FERMER EtatCR1 *FORMAT('XLS') *FICHIER ('RepXLS\Rapport.xls')

• Téléchargement de l'état au format PDF

FERMER EtatCR1 *TELECHARGER

• Impression de l'état via l'imprimante logique n° 1 en forçant l'orientation en mode paysage

FERMER EtatCR1 *IMPRIMER *ORIENTATION(2)

• Impression de 3 exemplaires groupés de l'état sur l'imprimante '\\SRVIMPR\IBMETG'

FERMER EtatCR1 *IMPRIMER('\\SRVIMPR\IBMETG') *NB_COPIES(3, *VRAI)

• Impression recto-verso de l'état via l'imprimante logique n°3

FERMER EtatCR1 *IMPRIMER(3) *RECTO_VERSO(2)

Voir aussi la liste des ordres L4G par thème

↑ Haut de page