FERMER (Contexte Adélia Cloud Batch)

			VADELIA (Cloud)
			(B) (C)

Attention : "FERMER CodeMaquette" n'est utilisable que dans une partie cliente d'un programme Adélia Cloud batch avec état.

Paragraphe d'utilisation

Tous

Syntaxe

FERMER CodeMaquette

FERMER CodeMaquette *PRV

FERMER CodeMaquette Fichier

FERMER CodeMaquette Téléchargt

Fichier	→	*FICHIER(NomFichier) \| Rien

NomFichier	→	'ConstanteAlpha' \| IdVarAlpha

Téléchargt	→	TELECHARGER \| TELECHARGER(NomDoc) \| Rien

NomDoc	→	'ConstanteAlpha' \| IdVarAlpha

Description

Cet ordre est utilisé pour gérer la fermeture des maquettes dans un programme. Dans le cas où il est nécessaire de gérer soi-même l'ouverture ou la fermeture des maquettes, il faut modifier les options de génération par défaut et indiquer que l'on gère l'ouverture.

La fermeture explicite d'un fichier maquette permet, aux travers des options proposées, de modifier le comportement standard. Une fermeture implicite permet soit d'imprimer un état sur le serveur d'impression (serveur associé au serveur logique *WEB_REPORT) soit d'afficher, dans le navigateur, un document au format PDF pour un état Crystal Reports et un document au format plain/text pour un état Adélia. Le comportement par défaut est fixé par le fichier de configuration [wicfgvcr.ini pour les états Crystal Reports ; wicfgva.ini pour les états Adélia] (paramètres d'exécution) soit à l'aide de la fonction de la VaToolBx VaToolBxCloudSetPrinterDefPrintMode pour les états Crystal Reports et VaToolBxCloudSetAdeliaPrinterDefPrintMode pour les états Adélia.

Plus généralement les options d'impression sont soient celles issues du fichier de configuration [wicfgvcr.ini pour les états Crystal Reports ; wicfgva.ini pour les états Adélia] (paramètres d'exécution), soient celles issues du paramétrage dynamique effectué par le biais des fonctions de la VaToolBx [VaToolBxSetPrinter (états Crystal Reports) ; VaToolBxSetAdeliaPrinter (états Adélia)] et [VaToolBxSetPrinterEx (états Crystal Reports) ; VaToolBxSetAdeliaPrinterEx (états Adélia)].La fermeture explicite "FERMER CodeMaquette" sans option supplémentaire joue le même rôle.

L'utilisation de *PRV permet d'afficher un état au format PDF (états Crystal Reports) et au format plain/text (états Adélia) dans le navigateur web (mode inline).

L'utilisation de "*FICHIER(NomFichier)" permet de stocker l'état au format PDF sur le serveur Web (vue VFS). Dans ce cas de figure l'état n'est pas envoyé au navigateur Web pour y être affiché. *FICHIER n'est valide que pour des états de nature Crystal Reports.

NomFichier peut être un simple nom de fichier ou bien un nom précédé d'un chemin relatif ou absolu. Dans les cas du simple nom de fichier ou du chemin relatif, le répertoire de base de stockage est le répertoire $(HOME) du VFS. Dans le cas du chemin absolu, le répertoire de stockage sur le serveur Web correspond à l'axe précisé monté dans le VFS.

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 PDF (états Crystal Reports), le document texte (états Adélia), 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.

L'ordre FERMER termine l'exécution du programme sauf dans le cas du *FICHIER, 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 middleware "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.