Navigation:  Publication > Construire un document maître (modèle)

Décomposition et appels

Le document maître contient deux sections :

1.Paramètres : généraux, modèles, conditions  

2.Structure : partie fixe, titres, signets.

 

Les signets de la seconde section indiquent où se placent les diverses bribes d'information.

Chaque signet de la section 2 va chercher dans la section 1 le patron associé :

 

Un Patron pour Minutes n'a pas de signet à lui, car une minute découle du poste WBS parent. Il y a deux variantes pour insérer les minutes :

1.Par section : chaque section de minutes se place dans sa propre table après une en-tête de poste (Patron pour Minutes) ; le signet STARTCHAPTERS, au début des spécifications techniques, invoque de façon implicite les chapitres WBS et va chercher le Patron pour Minutes

2.Tabulaire : postes et minutes se placent dans une seule table (Patron pour WBS avec Minutes).

 

Des signets sont également utilisés pour repérer un texte conditionnel dans la structure.

Dans la lettre type, des variables globales sont insérées comme MERGEFIELD via le menu Word QuickPart avec leur nom dans QDV7 par ex. SYS_TotalSellingPrice ; le total général en mots peut être calculé dans le classeur d'environnement et utilisé via une variable GLV_. Voir Consommation des variables. Ceci est assujetti au paramètre général MergeGlobalVariables.

Les signets ne sont pas conservés dans le document résultant.

RAPPEL  Pas d'espace dans un nom de signet.

 

Compiler le document résultant

Le schéma qui suit montre comment le document résultant est construit à partir d'une structure typique (seconde section du document maître) sur commande de la première section :

Paramètres généraux

Les paramètres suivants définissent comment le document se comporte à l'appel de QDV7 :

▪quelle langue utiliser ?

▪quelles parties du devis et quels documents externes insérer ?

▪quel style adopter pour les titres, quelle mise en page ?

▪les valeurs des variables globales seront-elles utilisées ?

 

Les couleurs de ligne dans le tableau correspondent aux couleurs dans le schéma ci-dessus (les lignes vertes s'appliquent aux documents de couleur jaune intense et bleu).

 

ANNEXES

Les annexes permettent de faire figurer une seule fois des documents appelés plusieurs fois. QDV7 crée des liens dans les deux sens : vers les annexes et des annexes vers les lignes utilisatrices.

Il y a deux façons d'insérer des annexes :

1.avec seulement les paramètres généraux en bleu ; ceci s'applique aux documents et images ; les annexes sont référencées dans la ligne et accessibles par hyperliens OU insérées sur place

2.via des documents dans la ligne (jaune intense) ; voir plus bas.

Façon n° 1 :

Il faut créer une nouvelle section dans le document maître seulement là où une largeur différente est nécessaire ou pour indiquer à quelle section les annexes doivent être ajoutées.

Le numéro de section est le nombre de sections à partir de l'offre, pas le nombre indiqué dans l'en-tête Word.

Par défaut l'hyperlien de retour est juste après le titre ; pour ajouter un autre lien où que ce soit, insérer dans le document externe un signet dont le nom commence par by REFERENCES_TO_MAIN ; le texte du signet sera enlevé à la fusion. L'exemple Multi-languages illustre ceci (pour atteindre le signet dans le document résultant, cliquer sur Insérer>Signet).

Dans les deux façons, pour inhiber l'insertion (par ex. pour une revue du devis), mettre AddAppendixes sur No.

 

 

Ni les noms de variable ni les valeurs ne sont sensibles à la casse.

Cette table suffit pour créer des documents simples. Des patrons permettent d'adapter les documents aux besoins.

Comme les styles sont importés avec les documents, la taille du document résultant peut augmenter rapidement. N'utiliser pas trop de styles différents dans les documents à importer.

 

Patron pour Minutes

La table suivante est le patron servant à insérer des détails des minutes. Il peut être adapté à vos besoins.

Le patron comprend 4 à 6 lignes (les 3 premières ne seront pas insérées dans le document résultant) :

1.En-tête

2.Attribut (voir ci-dessous)

3.Identifiants d'en-tête (pas d'espace, voir dans les minutes Administration>Gestionnaire de champs>Colonnes natives)

4.En-tête finale (option)

5.Patron des données

6.Patron de la ligne Total (option).

 

Plusieurs attributs peuvent être fixés.

RemoveBorders peut prendre diverses valeurs dictant les bordures de la table à CACHER (quelle que soit la façon dont elles sont définies dans le patron) :

▪All : toutes les bordures

▪InsideVertical : bordures verticales à l'intérieur

▪InsideHorizontal : bordures horizontales à l'intérieur

▪InsideBoth : bordures verticales et horizontales à l'intérieur

▪No : aucune.

 

UnBoldHeadOfGroups :

Quand IncludeMinutes est mis à Groups, il est intéressant de montrer une ligne ordinaire au lieu d'une ligne en gras, de façon à ce que le client ne décèle pas un groupe.

▪Yes : enlève la graisse le cas échéant

▪Autres valeurs : gardent le format défini

 

RepeatHeaderRow :

▪Yes : quand une table ne rentre pas la page, la ligne d'en-tête se répète sur les pages suivantes

▪Autres valeurs : pas de répétition.

 

DocumentsStayInTables :

▪Yes : les documents fusionnés avec le document maître sont affichés dans les cellules de la table

▪No : la table est éclatée et les documents entrelacés prennent toute la largeur de la page (recommandé s'ils contiennent des sauts de page)

Si Yes, MergeColumns=n-m, par ex. 2-6 demande de fusionner les 2nd, 3ème, 4ème, 5ème et 6ème colonnes pour insérer un document dans la table (si absent, l'insertion a lieu dans toutes les colonnes ; si n=m, elle a lieu dans une seule colonne).

 

PlaceImagesInColumn=<numéro de colonne cible>

Quand il est présent, il place l'image spécifiée dans la colonne Chemin annexe (précédé de {KeepInPlace}) dans la colonne cible sous sa valeur (le titre n'apparaît pas) ; cette colonne ne doit pas appartenir à la plage de colonnes fusionnées.

 

Exemple :

 

ce qui produit :

 

Ne pas fusionner de cellules dans les lignes 3 à 6.

Les formats de cellule sont conservés.

NOTA La Minute d'environnement n'est pas pris en compte.

 

Patron pour WBS

La table suivante est le patron servant à insérer le WBS. Il est possible d'insérer divers WBS dans le même document en créant plusieurs patrons.

Le patron comprend de 4 à 6 lignes (les 3 premières ne seront pas insérées dans le document résultant) :

1.En-tête

2.Attribut (voir ci-dessous)

3.Identifiants d'en-tête (pas d'espace, fournis par l'Unique Identifier via menu contextuel>Propriétés : Identifiant unique)

4.En-tête finale (option)

5.Patron des données

6.Patron de la ligne Total (option).

 

La table peut être adaptée aux besoins.

Les attributs sont :

▪BookmarkName : nom (sans espace) du lieu où le WBS sera inséré ; il peut être utilisé plusieurs fois

▪IndentationLevel : niveau d'indentation à insérer (comme le paramètre général InsertWBSChapters)

▪InheritFormats : Yes pour insérer les formats comme ils sont dans le WBS, No pour les insérer comme dans patron des données (ligne 5)

▪InheritFormatsButAlignment: Yes, pour insérer les formats comme ils sont dans le WBS, sauf les alignements (en particulier verticaux), qui doivent être ceux du modèle. Ceci ne s'applique pas si l'attribut précédent est à Yes  

▪Area : Core/Option (voir ci-dessous)

▪RemoveBorders : voir au-dessus

▪RemoveTitleRows : si vaut No, le titre général du WBS ne sera pas inséré

▪HeightOfSeparators (0 à 100 points, 8 par défaut) : hauteur des lignes vides

▪ForceAllBlankRowsToHeight (1 à 100 points, pour ignorer l'attribut, le mettre à 0) : hauteur de toutes les lignes vides, qu'elles soient dans le WBS ou dans la vue des minutes

▪IncludeDocuments : WBS pour insérer des documents dans la ligne attachés aux nœuds WBS , NONE sinon

▪RepeatHeaderRow : voir au-dessus

▪MergeColumns=n-m, par ex. 2-6 demande de fusionner les 2nd, 3ème, 4ème, 5ème et 6ème colonnes pour insérer un document dans la table (si absent, l'insertion a lieu dans toutes les colonnes ; si n=m, elle a lieu dans une seule colonne)

▪IgnoreMissingBookmark : si vaut No, un message d'erreur apparaît quand une table de la Partie 1 fait référence à un signet supprimé comme expliqué en Les variables dans la publication ; si vaut Yes, la publication continue, simplement le WBS n'est pas inséré.

 

Exemple :

 

ce qui produit, quand des documents sont entrelacés :

 

Nota

- En cas de doublure dans le devis, les colonnes Poste et U prennent le contenu des colonnes de la langue spécifiée dans les Paramètres généraux

- Si les quantités globales valent 1, ne rien mettre dans les cellules Total chapitre - Prix unitaire

- Dans la dernière ligne, la Description est imposée par QDV7 ; pour afficher un texte fixe, en particulier pour une traduction, saisir le texte personnalisé entre crochets

 

ZONE OPTIONS

Pour insérer la zone Options, ajouter une table similaire à la suivante :

 

NOTA

- Si elle figure, la ligne Total, est dans ce cas ignorée

- Si le devis ne contient aucune option, le signet correspondant est caché (mais pas enlevé). Ainsi, un document créé à partir d'un WBS sans option peut toujours recevoir des options ultérieurement

 

EXEMPLE AVEC UN WBS A 1 NIVEAU :

Comme il n'y a qu'un niveau, il est intéressant d'utiliser le format de la ligne patron des données :

 

Patron pour WBS avec Minutes

Deux paramètres sont implicitement fixés : IndentationLevel à 8, InheritFormats à Yes.

Pour insérer des documents dans les lignes directement dans la trame d'un tel WBS, mettre IncludeDocuments à WBS, MINUTES, WBSANDMINUTES or NONE.

 

Le patron comprend de 6 à 8 lignes (les 4 premières ne seront pas insérées dans le document résultant) :

1.En-tête

2.Attribut (voir ci-dessus) ; attribut supplémentaire : CollapseGroups= Yes (les minutes ne montre que l'en-tête des groupes) ou No ; en cas d'absence, le paramètre général IncludeMinutes s'applique

3.Identifiants des colonnes WBS (pas d'espace, donnés par le menu contextuel>Propriétés : Identifiant unique)

4.Identifiants des colonnes de Minutes (pas d'espace, à aller chercher dans les minutes Administration>Gestionnaire de champs>Colonnes natives, Matériel ou Main d'œuvre)

5.En-tête finale (option)

6.Patron des Minutes

7.Patron des totaux pour le poste (contenu et format) : le texte sera affiché tel quel et peut inclure des références à des colonnes du WBS dans le patron (fournir l'identifiant d'une colonne entre crochets, par ex. [WBS_Item]) ; quand une cellule contient {MoveToTotal}, la valeur au niveau WBS est déplacée dans la ligne Total

8.Patron du pied Total (option)

 

 

ce qui produit :

NOTA

- Les contenu et format de la ligne Total chapitre sont hérités du WBS

- En cas de doublure dans le devis, les colonnes Poste et U prennent le contenu des colonnes de la langue spécifiée dans les Paramètres généraux

- PlaceImagesInColumn=<numéro de colonne cible>

Quand il est présent, il place l'image spécifiée dans la colonne Chemin annexe dans la minute (précédé de {KeepInPlace}) dans la colonne cible sous sa valeur (le titre n'apparaît pas) ; cette colonne ne doit pas appartenir à la plage de colonnes fusionnées.

 

Syntaxe pour avoir le prix en mots :

▪Num2Words(référence de cellule) renvoie la valeur dans la langue courante du document ; unités et centièmes sont séparés par "virgule" en français, "point" en anglais, "komma" en hollandais ...

▪Num2Words(référence de cellule,code langue) renvoie la valeur dans la langue mentionnée (le code est en dur, mais SYS_Lang_UI est aussi autorisé, mais pas SYS_Lang_Report)

▪Num2Words(référence de cellule,code langue,Unité de monnaie au singulier,Unité de monnaie au pluriel,Centième de monnaie au singulier,Centième de monnaie au pluriel) ajoute les unités et les centièmes de monnaie en mots (unités et centièmes sont séparés par "et" en français, "and" en anglais, etc et un point est automatiquement ajouté à la fin)

▪Num2Words(référence de cellule,code langue,Unité de monnaie au singulier,Unité de monnaie au pluriel,Centième de monnaie au singulier,Centième de monnaie au pluriel,Genre des unités de monnaie,Genre des centièmes) ajoute le genre quand le nombre d'unités se termine par 1 (sauf 11), par ex. un franc, mais une livre sterling (valeurs autorisées : M pour Masculin, F pour Féminin, N pour Neutre).

 

Pour les options, la table peut être comme suit :

 

ce qui produit :

 

Pour classer le WBS et les minutes selon un champ à valeurs discrètes (par ex. Famille), ajouter son identifiant exact dans SortByKey.

Options :

▪Pour insérer des totaux pour chaque valeur de la clé, ajouter ShowSortingTotals=Yes et dans la colonne de total {Total_Sorting_Key} après le nom du champ

▪Ajouter le texte introductif (par ex. \Total Famille :) ; la couleur du total est toujours le noir

▪Pour cacher des lignes de commentaires ou des en-tête de groupe ou ouvrage, ajouter IgnoreEmptyRows=Yes ; QDV7 cache les lignes qui n'ont aucune valeur dans les colonnes identifiées par {Total_Sorting_Key}

▪Pour fusionner des lignes identiques (c'est-à-dire dont tous les contenus de cellule sont identiques sauf les colonnes Quantité et celles remplies de sommes), ajouter MergeDoubloons=Yes ; elles sont fusionnées en une seule ligne où la quantité et les valeurs des colonnes avec des sommes (LineSellingTotalPrice dans l'exemple) sont les totaux des composantes

▪Pour classer plus avant, selon des clés secondaire (Description) et tertiaire (Unité), ajouter SortFields=Description+Unit ASC (DES pour un ordre décroissant)  

 

ce qui donne :

 

Pour présenter à part les documents joints aux minutes ou appelés par les minutes, ajouter après la WBS table, une table telle que la suivante. La troisième ligne est vide car aucune donnée utilisée n'est réservée au WBS.  Si on garde peu de colonnes, l'en-tête n'est pas obligatoire et les bordures inutiles.

Les documents apparaissent séparés par une ligne unique (la cinquième dans le patron). Dans cet exemple, l'Item WBS et la Description servent de référence à la table principale :

 

ce qui donne :

Comme décrit ci-avant, {KeepInPlace} est placé devant le chemin de l'annexe. Voir l'exemple Multi-languages_Sample_with_Documents.

 

Annexes à la façon n°2

Il est possible d'annexer automatiquement des documents stockés en dehors de QDV7 au document résultant. Les appels à annexe sont faits dans les documents dans les lignes via une table.

Une telle table doit contenir trois colonnes avec :

▪le mot APPENDIX

▪le nom du chapitre à insérer dans l'annexe avec le format défini par AppendixHeadings (paramètre général)

▪le chemin complet au document à insérer (utiliser \).

Plusieurs lignes sont permises pour appeler plusieurs documents traitant du même item.

Exemple :

Le document dans la ligne peut commencer par une référence croisée suivie de la table. Les deux zones sont délimitées par les signets LANGUAGE_EN et LANGUAGE_FR.

 

 

NOTA

- QDV7 insère automatiquement un saut de page avant chaque document fusionné dans l'annexe

- Même s'il y a plusieurs références dans le devis au même fichier d'annexe, il n'est cependant inséré qu'une fois.