<XLS>

<< Click to Display Table of Contents >>

Navigation:  EXCEL >

<XLS>

La balise XLS est utilisée pour spécifier différentes actions sur la feuille Excel, ajouter des formules, dessiner un graphique, etc.

L'exportation Excel est disponible à partir de la fenêtre d'exportation ou avec la balise .

 

Plusieurs balises <XLS> peuvent exister dans le rapport.

 

 

1.Syntaxe  <XLS-xxxxxxxxxxx> :

Header et footer:

         <XLS-LEFT-HEADER=left header value>

         <XLS-CENTER-HEADER=center header value>

         <XLS-RIGHT-HEADER=right header value>

 

         <XLS-LEFT-FOOTER=left footer value>

         <XLS-CENTER-FOOTER=center footer value>

         <XLS-RIGHT-FOOTER=right  footer value>

 

Délimiteur décimal:

<XLS-DECIMAL=character>

vpxPrint n'a aucune information sur le format décimal des nombres, ils apparaissent comme des chaînes dans le fichier xpr.

Les utilisateurs européens utilisent généralement une virgule comme séparateur décimal et un point pour les milliers. Pour les autres utilisateurs, le point est le séparateur décimal.

Les nombres peuvent avoir une fraction décimale ou non...

Pour éviter toute erreur dans l'exportation Excel, il est prudent de définir le séparateur décimal que vous utilisez dans le rapport.

Les utilisateurs européens doivent utiliser <XLS-DECIMAL=,> s'ils utilisent le paramètre de progression -E.

 

Format des dates et delimiteur:

<XLS-DELIM=character>

Définit la valeur du délimiteur de date, s'il est différent du paramètre local standard de Windows.

Exemple : "01.03.2015" et <XLS-DELIM=.> spécifient que le jour, le mois et l'année sont séparés par un point.

 

 
<XLS-DATE=date_format>

Indique le format de la date dans le rapport s'il diffère du paramètre standard de Windows.

Exemples : <XLS-DATE=mdy> ou <XLS-DATE=dmy>

 

Nommage des feuilles Excel :

<XLS:SHEET=xxxxxxxxx> donne un nom à la feuille Excel courante.

 

Ouvrir le tableau Excel :

<XLS-OPEN [ ,MODAL=NO ] >           (Mode Modal 10.48e)

 

2.Traitement de l'envoi à Excel:

Le format de convention Excel pour les dates est m/d/y et les valeurs numériques utilisent un point comme séparateur décimal sans séparateur de milliers.

vpxPrint tente de reconnaître le type de cellule avant de l'envoyer à Excel.

 

1.La valeur actuelle est-elle une date valide ?

i.Si oui, elle est convertie en utilisant le délimiteur de date et le paramètre dmy-mdy (ou autre) et envoyée à Excel.
 

2.S'il ne s'agit pas d'une date valide, s'agit-il d'une valeur numérique valide ? vpxPrint :

i.applique le délimiteur décimal, s'il y en a un. S'il n'est pas spécifié, tente de le déterminer.

ii.supprime les séparateurs de milliers,

iii.supprime les signes monétaires (£, $ ou €)

iv.certaines valeurs commencent par +-, les normalise,

v.si le résultat est valide, il est envoyé à Excel.
 

3.S'il ne s'agit ni d'une date ni d'un chiffre, envoi de la valeur originale non modifiée.

 

Pour créer un fichier Excel sans prévisualisation ni impression, il est également possible d'utiiser <XLS-DIRECT>

 

Cette balise indique à vpxPrint d'envoyer les valeurs d'entrée directement sans aucun processus supplémentaire, ce qui peut accélérer le processus de ~20% pour les fichiers de grande taille.

Mais cela signifie que vous devez :

outiliser des dates m/d/y,

outiliser des valeurs décimales au format >>>>>>>>9.99 avec un point décimal et sans séparateur de milliers.

 

3.Instructions Excel :

<XLS:Excel_Action_List> interagit avec Excel sous la forme d'une liste de commandes délimitée par des virgules.

Deux variables de travail X et Y peuvent être utilisées dans les commandes.

 

Avant d'envoyer une commande, vpxPrint il modifie son contenu :

•%A                        est remplacé par l'identification de la première colonne,

•%Z                        "    "      "      "        "     "     "       "    "   "  dernière    "  "

•%1                        est remplacé par le numéro de la première ligne,

•%9                        est remplacé par le numéro de la dernière ligne,

•%X                        est remplacée par l'identification de la colonne pointée par X

•%Y                        est remplacée par l'identification de la colonne pointée par Y

 

Commandes :

Commande

Description

Note

CHART

Dessine un graphique sur la feuille Excel courante. La valeur par défaut est un graphique vertical "3D Pie exploded" avec toutes les données de la feuille. La valeur par défaut est la dernière colonne.

 

CHART [=xlChartConstant ]

 

où xlChartConstant est la valeur du type de graphique (voir constantes Excel)

Plusieurs <XLS:CHART> peuvent être utilisés

ARRAY

Convertit la zone sélectionnée en un tableau avec des en-têtes de colonnes.

Version 10.48e

INSERT

Insère une ligne à la position actuelle

Version 10.48e

SELECT

Sélectionne une plage de cellules dans la feuille en cours.

 

Syntaxe :

SELECT=plage_excel_valide

 

La valeur spécifiée doit être une syntaxe de plage Excel valide.

Doit être au format A1.

Exemples:

SELECT=A1:C10

SELECT=%A%1:C%9

 

XVALUES

Définit la plage sélectionnée actuelle comme valeurs X pour le graphique.

Après CHART et SELECT

VALUES

Définit la plage sélectionnée actuelle comme valeurs pour le graphique

Après CHART et SELECT

NAME

Nomme la sélection actuelle

Après SELECT

X

Définit un numéro de colonne (A-Z).

Syntaxe:

X=   number   X = une colonne précise

      X+1           ajoute 1 à X

      FIRST        X = 1ère colonne

      LAST         X = dernière colonne utilisée

-OU-

X++            ajoute 1 à X

-OU-

X- -           soustrait 1 de X

-OU-

X=%A

X=%Z

Exemples:

X=3

X++

 

Y=%9,Y++,Y++,SELECT=%Z%Y

 

Lorsqu'il est envoyé à Excel, %X est converti en lettres de colonne EXCEL.

 

Y

Définit un numéro de ligne.

Syntaxe :

Y=   number    

      Y+1          

      FIRST      

      LAST        Dernière ligne remplie

-OR-

Y++            

-OR-

Y- -          

-OR-

Y=%1

Y=%9

Exemple :

Y=%9,Y++,Y++,SELECT=%Z%Y

 

sélectionne la cellule située deux lignes en dessous de la dernière.

SAVE

Sauvegarde le fichier Excel.

Syntaxe :

SAVE=filename

 

FORMULA

Insère une formule Excel dans la zone sélectionnée.

Syntaxe :

FORMULA=Excel_Formula

Après SELECT

Spécifier un double signe égal pour les formules :

FORMULA==Sum(E2:E%9)

FORMULAR1C1 (*)

Insère une formule en mode R1C1 dans la zone de plage sélectionnée.

Syntaxe :

FORMULAR1C1=Excel_Formula

 

VALUE

Sets the value for the current selected range.

Syntax:

VALUE=xxxxxxxxxxxxxxxxxxxxx

Après SELECT

HOR

Passe à une série horizontale (l'orientation de la carte est par défaut verticale si HOR n'est pas spécifié).

Après CHART

TITLE

Chart title.

Syntax:

TITLE=xxxxxxxxxxxxxxxxxxxxxxxxxxxx

Après CHART

SOURCE

Définit la plage sélectionnée actuelle comme source du graphique.

Après CHART et SELECT

VISIBLE

Définit la fenêtre Excel comme visible.

La fenêtre Excel est affichée immédiatement lorsque cette balise est traitée.

Obligatoire si le mot-clé SAVE est spécifié.

SHEET (*)

Définit le nom de la feuille courante.

Syntaxe :

SHEET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Après CHART

Si le fichier Excel ne contient qu'une seule feuille, il s'agit du nom de la feuille unique.

Dans le cas de feuilles multiples, cette balise peut être utilisée pour définir les noms des feuilles supplémentaires.

 

CENTER (*)

Sets the name of the current sheet.

Syntax:

SHEET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Après SELECT

Exemple:

SELECT=D:D,CENTER

RIGHT (*)

Justifie horizontalement à droite le contenu des cellules sélectionnées.

Syntaxe :

RIGHT

 

LEFT (*)

Justifie horizontalement à gauche la (les) cellule(s)

Syntaxe :

LEFT

 

VCENTER (*)

10.48

Centre verticalement le contenu des cellules sélectionnées.

Syntaxe :

VCENTER

Après SELECT

 

VTOP (*)

10.48

Justifie verticalement le contenu des cellules sélectionnées.

Syntaxe :

VTOP

Après SELECT

STYLE (*)

Syntaxe :

STYLE=Currency

 

 

FORMAT (*)

Spécifie le format des cellules sélectionnées.

 

Syntaxe :

FORMAT=ffffffffffffffffffffffffffffffffffffffffff

 

 

Exemples :

#\,##0.00 $;[Red]#\,##0.00 $

#\,##0.00

0.00%

# ??/??

0.00E+00

Note:

Les virgules doivent être échappées avec un caractère \.

FONT (*)

Police des cellules sélectionnées.

 

SIZE (*)

Taille de la police

Syntaxe :

SIZE=nn

 

BGCOLOR (*)

Définit la couleur d'arrière-plan des cellules.

Syntaxe :

BGCOLOR=xxxxxxxxxxx

 

où xxxxxxxxxx est une couleur vpxPrint ou une valeur RGB.

Comme la virgule est un délimiteur dans la balise XLS, il faut "échapper" les virgules avec une barre oblique inverse pour spécifier les valeurs RVB. N'importe quel caractère peut être accepté comme délimiteur :

 

BGCOLOR=182\,15\113

BGCOLOR=182-15-113

FGCOLOR (*)

Couleur police

 

ITALIC (*)

Caractères en italique

 

BOLD (*)

Caractères gras.

 

LANDSCAPE (*)

PORTRAIT

Mode d'impression portrait ou paysage.

 

GRID

Les lignes de la grille sont imprimées

 

FIT

Fixe les valeurs FITT et FITW à 1. Ajuste le zoom pour que la feuille de calcul tienne sur une seule page.

 

FITT

Syntaxe :

FITT

FITT=n

Définit le nombre de pages en hauteur pour mise à l'échelle lors de l'impression. (FitToPagesTall)

Excel FitToPagesTall

 

Default value = 1

FITW

Syntaxe :

FITW

FITW=n

Définit le nombre de pages de largeur de la feuille de calcul lors de l'impression. (FitToPagesWide)

Excel FitToPageswides

 

Default value = 1

 

 

FITW=1,FITT=999999 ajuste le rapport en largeur.

HEADERL

HEADERC

HEADERR

L: Sets the alignment of text on the left header of a workbook.

C: Center aligns the header information.

R: Sets the right part of the header

Exemple :

&"Arial Black,Italic"&14My Title

 

FOOTERL

FOOTERC

FOOTERR

L: Sets the alignment of text on the left footer of a workbook.

C: Center aligns the footer information

R: Sets the right part of the footer

 

 

TOPMARGIN

BOTTOMMARGIN

LEFTMARGIN

RIGHTMARGIN

Syntaxe :

<XLS:TopMargin=10.......>

Indique les marges d'exportation et d'impression de la feuille Excel.

La valeur est indiquée dans l'unité définie par <UNITS>

 

Exemples :

<XLS:CHART>

<XLS:SELECT=%A%1:C%9,CHART,HOR>

 

Comment ça marche ?

Le principe de base est d'écrire des lignes comme :

            Field1            Field1            Field2

            ----------------- ---------------- -------------------------

            Xxxxxxxxx         yyyyyyyy          zzzzzzzzzzzzzzzzz

            Zzzzzzzzzzz       aaaaaaaaaaa       uuuuuuuuuuuuuuuuuuuuuuu

 

vpxPrint crée un fichier Excel de base.

 

La ligne avec -------------- ------------ détermine la position et la taille des colonnes.

 

about_24_h  N'utilisez pas le positionnement <C> dans cette ligne, utilisez des espaces comme délimiteurs.

 

Au-dessus et au-dessous de cette ligne, il suffit d'ajuster les titres des colonnes (en haut) et le contenu des lignes (en bas) à la position exacte. Sur ces lignes, on peut utiliser <C> et toute autre balise : police, justification, etc.

 

L'exemple le plus simple :

 

<PREVIEW>

<C10>Name<C30>Company<C50>Value

bbbbbbbbb----------bbbbbbbbb------------------bb--------------              // bbb = spaces

<C10>Paul<C30><CENTER=C49>4GL<C50>15000

<C10>Pierre<C30><CENTER=C49>IBM<C50>10000

<C10>George<C30><CENTER=C49>Microsoft<C50>12000

<C10>Phil<C30><CENTER=C49>Epson<C50>3000

</USE>

 

</USE> ferme le tableau de l'affichage actuel.

 

On peut ajouter des balises XLS spécifiques :

<XLS:CHART,Title=vpxPrint Excel example...>

<XLS-LEFT-HEADER=LEFT HEADER>

<XLS-CENTER-HEADER=CENTER HEADER>

<XLS-RIGHT-HEADER=RIGHT HEADER><XLS-LEFT-FOOTER=LEFT FOOTER><XLS-RIGHT-FOOTER=RIGHT FOOTER><XLS-CENTER-FOOTER=CENTER FOOTER>

Résultat :

                   

Un clic sur le bouton d'exportation dans la fenêtre de prévisualisation ouvre la fenêtre d'exportation avec le bouton "Excel" (si une structure Excel valide est trouvée dans le fichier) :

             

           

Avec une simple balise <XLS:CHART,Title=vpxPrint EXCEL example...>

 

           

 

Avec la balise <XLS>, vous pouvez entièrement personnaliser le graphique : couleur des lignes ou des colonnes, police, justification ou alignement.

 

Example:

<XLS:CHART,SHEET=Customer list,Title=vpxPrint EXCEL example...>

dessiner un graphique, donner un nom de feuille et un titre au document excel

<XLS:SELECT=E2:E%9,FONT=Arial Narrow,size=11,bold,

BGcolor=blue,FGcolor=white,style=Currency,

SELECT=c:c,RIGHT,SELECT=D:D,center>

sélectionner la colonne E de la ligne 2 à la dernière ligne remplie (%9)

définir la couleur d'arrière-plan en bleu, la couleur de la police en blanc, le style de devise

sélectionner la colonne C, appliquer 'right align', sélectionner la colonne D et centrer

<XLS:SELECT=B%1:%Z1,bgcolor=ltgray>

select from B first line (B%1) to last col row 1 (%Z1)

<XLS:Y=%9,

Y++,Y++,

SELECT=%Z%Y,

FORMULA==SUM(%Z2:%Z%9),

LANDSCAPE,grid,fit,headerL=John Doe>

assigner Y = dernière ligne (%9)

ajouter 2 à Y

sélectionner dernière colonne dernière ligne + 2 (%Z%Y)

mettre une formule dans cette cellule : sum(last col 2nd row %Z) to the last cell (%Z%9)

définir les valeurs pour l'impression, Landscape...

<XLS-LEFT-HEADER=header LEFT>

values for printing

<XLS-CENTER-HEADER=&"Arial Black,Italique"&14header LEFT>

values for printing

<XLS-right-footer=Page &P of &N>

values for printing

 

XLS

 

 

Excel preview:

 

Excel_Apercu

 

Different sheets:

When a display frame is closed by a </USE>, vpxPrint creates automatically a new Excel sheet.

 

The new sheet has the name of the current sheet with a suffix -2 -3 added to the base name.

The tag <XLS:SHEET=xxxxxxxxxxxxx> allows to change this default name.

 

 

about_24_h        Note that this value specifies the name of the current opened frame.

The sheet name must be specified after the frame is started and before closing the frame.

Exception: if the Excel file contains only one sheet, the XLS:SHEET applies to the unique sheet.

 

Example:

{ xprint.i }

 

OUTPUT TO c:\temp\demo.xpr  PAGED PAGE-SIZE 60.

PUT CONTROL '<preview>'.

 

FOR EACH customer NO-LOCK BY cust-num:

     DISP cust-num LABEL '#num' NAME label 'cust name' city LABEL 'Cust city' WITH STREAM-IO WIDTH 512.

     END.

PUT "<XLS:SHEET=By num></USE>".

 

FOR EACH customer NO-LOCK BY NAME:

     DISP cust-num LABEL '#num' NAME label 'cust name' city LABEL 'Cust city' WITH STREAM-IO WIDTH 512.

     END.

PUT "<XLS:SHEET=By Name></USE>".

 

FOR EACH customer NO-LOCK BY city BY NAME:

     DISP cust-num LABEL '#num' NAME label 'cust name' city LABEL 'Cust city' WITH STREAM-IO WIDTH 512.

     END.

PUT "<XLS:SHEET=By City></USE>".

 

OUTPUT CLOSE.

RUN printfile('c:/temp/demo.xpr').

 

Excel_sheets