Impression des graphes dans les modèles d'édition

Il est possible de demander à SIMAX de générer et d’insérer des graphiques dans un fichier. Pour cela, il suffit d’ajouter dans le modèle d’édition une balise avec la syntaxe suivante :

• Pour un modèle sur un formulaire :

<% *GRAPHE, Options= ...,DPI=...,Hauteur = ...,Largeur = ...,Type = ...,Titre = ...,Formulaire

= ...,ColRegroupement = ...,ColCalcul = ...,TypeCalcul = ...+ Formule %>

Options	option d'affichage du graphe (valeurs séparées par des '|')(optionnel)	Les options disponibles sont les suivantes et peuvent se cumuler grâce au caractère '|' : AVECFOND : quand on demande un graphe avec des axes (Type histogramme, histogramme empilé, courbe, courbe lissée), on souhaite que le fond du graphe soit un fondu grisé NOIRETBLANC : dessiner le graphe en noir et blanc (les couleurs sont remplacées par du gris ou par des hachures si plusieurs couleurs) HORIZ : afficher un quadrillage horizontal sur le graphe (Type histogramme, histogramme empilé, courbe, courbe lissée) VERT : afficher un quadrillage vertical sur le graphe (Type histogramme, histogramme empilé, courbe, courbe lissée) VALEUR : afficher les valeurs sur le graphe POURCENTAGE : afficher les pourcentages dans les secteurs (Type secteur) VALEURSECTEUR : afficher les étiquettes des secteurs (Type secteur) SANSLEGENDE : ne pas ajouter de légende VALEURLEGENDE : indiquer les valeurs de chaque série dans la légende à coté de la valeur affichée LEGENDEDROITE : positionner la légende à droite LEGENDEGAUCHE : positionner la légende à gauche
DPI	Résolution (entier) (par défaut 96)
Hauteur	Hauteur réservée pour dessiner le graphe (entier en cm) (obligatoire, conseillé 15)
Largeur	Largeur réservée pour dessiner le graphe (entier en cm) (obligatoire, conseillé 15)
Type	Type de graphe (entier) (par défaut 1),	Les différents types de graphe sont : 1 : Histogramme

		2 : Histogramme empilé 3 : Secteur 4 : Courbe 5 : Courbe lissée
Titre	Titre du graphe affiché juste au-dessus (texte)(optionnel)
Formulaire	Identifiant ou libellé du formulaire des enregistrements représentés dans le graphe, c'est à dire formulaire résultat de la formule (obligatoire)
ColRegroupement	Libellé des colonnes de regroupement séparés par des '|' ( 1 ou 2 colonnes au maximum) (Obligatoire)
ColCalcul	Libellé de la colonne qui doit être utilisée pour faire les calculs représentés sur le graphe (obligatoire)
TypeCalcul	Type de calcul à effectuer (par défaut la somme)	Les types de calcul disponibles sont : SUM ou SOMME (par défaut) MIN pour le minimum MAX pour le maximum COUNT ou COMPTEUR AVERAGE ou MOYENNE

Exemple : Modèle sur le formulaire Facture

Remarque : la formule récupère toutes les lignes de facture qui sont liées à la facture en cours d'impression.

Formule :

Si votre modèle d'édition est destiné à une liste, il n'est pas nécessaire d'utiliser une formule.

Dans ce cas, tous les enregistrements de la liste ou la sélection d'enregistrements seront utilisés pour construire le graphique.

En revanche, si votre modèle d'édition concerne un enregistrement spécifique, la formule doit être une formule SIMAX qui retourne une liste d'enregistrements correspondant au type du formulaire.

De plus, les colonnes de regroupement et la colonne de calcul doivent être des colonnes définies dans le paramètre du formulaire.

Les différents types de graphe sont :

1 : Histogramme

2 : Histogramme empilé

3 : Secteur

4 : Courbe

5 : Courbe lissée

Les options disponibles sont les suivantes et peuvent se cumuler grâce au caractère '|' :

Formule d’alimentation du graphique

Si le modèle d’édition est utilisé en mode liste, aucune formule n’est nécessaire. Dans ce cas, le graphique sera automatiquement généré à partir de tous les enregistrements de la liste ou de la sélection en cours.

En revanche, si le modèle d’édition est lié à un enregistrement spécifique, il est nécessaire d’utiliser une formule SIMAX. Celle-ci doit renvoyer une liste d’enregistrements correspondant au type du formulaire.

À noter : Les colonnes de regroupement ainsi que la colonne utilisée pour les calculs doivent obligatoirement être des colonnes définies dans les paramètres du formulaire.

Types de graphiques disponibles :

· 1 : Histogramme

· 2 : Histogramme empilé

· 3 : Camembert (secteur)

· 4 : Courbe

· 5 : Courbe lissée

Options graphiques disponibles (cumulables à l’aide du caractère |) :

· AVECFOND : ajoute un fond grisé dégradé au graphique lorsque celui-ci comporte des axes (types : histogramme, histogramme empilé, courbe, courbe lissée).

· NOIRETBLANC : le graphique est généré en noir et blanc ; les couleurs sont remplacées par des nuances de gris ou des hachures en cas de variations multiples.

· HORIZ : affiche un quadrillage horizontal sur le graphique (valable pour les types : histogramme, histogramme empilé, courbe, courbe lissée).

· VERT : affiche un quadrillage vertical, applicable aux mêmes types de graphiques que ci-dessus.

· VALEUR : affiche les valeurs numériques directement sur le graphique.

· POURCENTAGE : dans les graphiques en secteur, affiche les pourcentages associés à chaque portion.

· VALEURSECTEUR : pour les graphiques en secteur, affiche les libellés des différentes parts.

· SANSLEGENDE : supprime la légende du graphique.

· VALEURLEGENDE : dans la légende, affiche la valeur associée à chaque série, en complément du libellé.

· LEGENDEDROITE : place la légende sur la droite du graphique.

· LEGENDEGAUCHE : place la légende sur la gauche du graphique.

Types de calcul disponibles pour les graphiques :

· SUM ou SOMME (valeur par défaut) : addition des valeurs

· MIN : valeur minimale

· MAX : valeur maximale

· COUNT ou COMPTEUR : nombre d’éléments

· AVERAGE ou MOYENNE : moyenne des valeurs

Exemple :

Modèle sur le formulaire Facture, modèle pour liste.

rem : pas besoin de formule

<% [GRAPHE, Options= VALEUR|VALEURSECTEUR|LEGENDEDROITE, DPI=96,

Hauteur = 15,

Largeur = 15,

Type = 3,

Titre = Somme du Total HT des factures par date, Formulaire = facture,

ColRegroupement = Date facture, ColCalcul = Total HT

TypeCalcul = MAX] %>

<% [GRAPHE, Options= VALEUR|SANSLEGENDE|HORIZ, DPI=96,

Hauteur = 15,

Largeur = 15,

Type = 1,

Titre = Somme des lignes de facture (dont le total HT est supérieur à 50) par article, Formulaire = ligne de facture,

ColRegroupement = Article,

ColCalcul = Total HT] Selection( ['Total HT' de 'Ligne de facture' <1BVPGVR9S9>] > 50 et ['Facture' de 'Ligne de facture' <1CPTGVRA1C>]= ['Id. unique' de 'Facture' <186SK0HT25>])%>

Résultat :

Toutes les options spécifiées dans la balise *GRAPHE+ doivent être séparées par des virgules.

Remarque :

La formule utilisée doit être une formule SIMAX retournant une liste d’enregistrements correspondant au formulaire défini dans l’option formulaire=.

Conseil : créez et testez d’abord la formule dans SIMAX. Une fois validée, copiez-la dans le modèle d’édition.

Exemple :

Titre = Somme des lignes de facture (dont le total HT est supérieur à 50) par article, Formulaire = ligne de facture,

ColRegroupement = Article,

ColCalcul = Total HT+ Selection( *'Total HT' de 'Ligne de facture' <1BVPGVR9S9>+ > 50 et

*'Facture' de 'Ligne de facture' <1CPTGVRA1C>+= *'Id. unique' de 'Facture' <186SK0HT25>+)%>

Remarque :

Les colonnes de regroupement ainsi que la colonne utilisée pour les calculs doivent impérativement appartenir au formulaire spécifié dans l’option formulaire=.

Exemple : : Si le graphique est basé sur le formulaire Commande, mais que vous utilisez une colonne de regroupement comme Date facture (qui ne fait pas partie de ce formulaire), alors le graphique ne pourra pas être généré.

Gestion des erreurs :

• Si les informations fournies dans la balise *GRAPHE+ sont incomplètes ou incorrectes (par exemple, en cas d’absence de colonne de calcul), la balise sera remplacée par un message d’erreur précisant la nature du problème.

• Si SIMAX ne parvient pas à générer le graphique à partir des données fournies (par exemple, en raison de dimensions insuffisantes), la balise sera également remplacée par un message expliquant la cause de l’échec.

Pour un modèle d’édition en mode liste :

Lorsque votre modèle est conçu pour une liste de formulaires, il n’est pas nécessaire d’indiquer une formule. Dans ce cas, le graphique sera généré à partir de l’ensemble des enregistrements de la liste ou de la sélection effectuée.

Vous devrez insérer une syntaxe du type :

<% *GRAPHE, Options= ...,DPI=...,Hauteur = ...,Largeur = ...,Type = ...,Titre = ...,Formulaire

= ...,ColRegroupement = ...,ColCalcul = ...,TypeCalcul = ...+ %>

Exemple :

Modèle sur le formulaire Facture, modèle pour liste

Remarque : pas besoin de formule

Modèle :

Résultat :

Impression au format PDF (via OpenOffice.org)

Pré requis : Pour réaliser des impressions au format PDF vous devez avoir OpenOffice.org installé sur votre machine locale.

Lancer une commande dans l'invite de commande

Vous devez lancer la commande : « set userprofile=c:\ » puis la commande

« <OOoInstall>program/soffice.exe" -invisible-

accept=socket,host=0,port=<NumeroPort>,tcpNoDelay=1;urp,Negotiate=0,ForceSynchronous=0» Vous devez remplacer deux balises avec vos propres critères : <OOoInstall> = répertoire d'installation d'OpenOffice sur votre machine (exemple : C:\Program Files\OpenOffice.org 3\)

<NumeroPort> = numéro de port que vous souhaitez utiliser. SIMAX devra écouter sur le même port qu'OpenOffice.

Exemple :

Remarque : Suite à cette procédure, il se peut qu’OpenOffice se relance comme lors d’une première utilisation (fenêtre de bienvenue, configuration initiale, etc.). Dans ce cas, cliquez simplement sur « Suivant » jusqu’à atteindre l’étape « Terminer ».

Configurer OpenOffice.org (optionnel)

Configuration d’OpenOffice au démarrage

Pour qu’OpenOffice se lance automatiquement avec la configuration souhaitée, suivez les instructions disponibles à l’adresse suivante : http://wiki.services.openoffice.org/wiki/Documentation/DevGuide/ProUNO/Starting_OpenOffice.org_in_Listening_Mode

Cela vous permettra d’éviter d’avoir à le démarrer manuellement via l’invite de commande à chaque utilisation.

Modifier le fichier de configuration

Dans la section *CLIENT+ du fichier de configuration, vous avez la possibilité d’ajouter deux paramètres :

· PDFFORMATSERVER_PORT : permet de définir un port personnalisé pour le serveur (exemple : 8040).

· PDFFORMATSERVER_DIRECTORY : permet de spécifier un répertoire de destination pour tous les fichiers PDF générés.

Préparer un modèle d'édition pour une impression PDF

Dans SIMAX, créez un modèle d’édition en y associant un document modèle (de préférence au format .odt), puis sélectionnez comme format de sortie : « PDF via OpenOffice serveur ».

Pour tester, il ne reste qu'à lancer une impression avec ce modèle. Au moment du clic sur le bouton

« Imprimer » SIMAX dialogue avec OpenOffice (de façon invisible pour l'utilisateur) et génère un document en PDF dans le dossier précisé dans le fichier info.SIMAX.