Différence entre versions

Version actuelle datée du 24 juillet 2019 à 13:43

Autres langues :

English • ‎français

Project/Format:

A Designer project is made up of an overlay (static part of the template) and a data file (variable part or dynamic part of the template). A project has a specific format name and sequence number which make it unique within the production Server.

A project is composed of three files (or five files when it is a double-sided project) :

A .mpw file which contains the simplex of the overlay (another one can contain the duplex side of the overlay).
A .mpi file which contains the data formatting (template) on the simplex side (another file can possibly contain the data formatting for the duplex side of the project).
A .mpp file identifies the project and merges the .mpw and .mpi file(s).
Project associations are files with *.MPA extensions

The name project is used as the template is designed in Designer. Once generated in the production server, we refer to it as a format with a sequence number.

Creating a project:

To create a new project, select New, then Project, in the File Menu.

The designing view then displays the project as a blank page with default configuration (portrait, A4, simplex mode).

First, fill in the project properties:

Name of the format: identifies the format with 10 characters maximum.
Sequence number: identifies the sequence numerically with 5 characters maximum.

These two first parameters are required.

Other parameters can be configured in the Properties window (Tick the box Properties in the Display Menu):

Description: user information with 25 characters maximum.
Comment: additional information.
Shared folder: generation path of the project (also defined in Preferences).
Mode: corresponds to the type of data to format: SPLF (text) or XML.
Code Page: opens a non-Unicode spooled file with an XPS template by specifying the code page of the file in the project properties. This option is only accessible in SPLF mode.
Designing language: defines the languages in which the template is designed, using a drop-down menu.
Orientation: Portrait or Landscape, for the simplex and the duplex.
Page size (standard ISO formats, or customized format) and margins.
Simplex/Duplex project (flip the page on the long or the short edge)
Page break: default setting of the application as it processes data one page at a time and adds a page break once the data of a page has been completely processed. If the break is deactivated, the data of the following page will be placed after that of the page processed.
Position: if the page break is deactivated, this option lets you specify where to place the data of the following page: on the right of the page being currently processed (horizontal position shift) or underneath (vertical shift). This option is only available in XPS.

Format:

Opened in OPALE Server, a Format is a Designer project which was generated and imported on the production server. A format can be composed of several sequences.

Every sequence is conditioned to run on different pages of a data file (spooled file or XML file).

Here is an example to better understand the benefit of having several sequences for one project:

On an invoice with 3 pages:

The first page includes the recipient's address, the sender's address as well as the start of the invoice table (Page type 1)
The last page includes the price to pay (Page type 2)
All the other pages contain the body of the invoice (Page type 3)

Processing the spooled file with the same format is difficult since formatting can differ depending on the page type. Three formats will then be created, one for each page type. These three formats will have the same name because the three together make THE document "invoice" template, however they will have different sequence numbers:

Sequence 00010 runs on page type 1
Sequence 00020 runs on page type 2.
Sequence 00030 runs on page type 3.

When running the invoice format on a data file, a "MERGE" of these sequences is carried out to process the spooled file entirely.

Resources:

List all formats using a particular resource (a font, an overlay or a component).

MAPLNK is the file which links together all resources and formats available on OPALE Server.

On IBM i: DSPPFM FILE(MAPLNK)

@@ Ligne 11 : / Ligne 11 : @@
-Cette notion de projet n’a de valeur que pendant la conception du modèle côté '''Designer'''. Une fois généré sur le serveur de production, on parle de format et de numéro de séquence.
+The name project is used as the template is designed in '''Designer'''. Once generated in the production server, we refer to it as a format with a sequence number.
-'''Créer un projet :'''
+'''Creating a project:'''
-La création d’un nouveau projet se fait par le menu Fichier > Nouveau > Projet.
+To create a new project, select New, then Project, in the File Menu.
-La vue conception affiche alors le projet comme une page blanche avec un paramétrage par défaut (portrait, A4 en mode recto).
+The designing view then displays the project as a blank page with default configuration (portrait, A4, simplex mode).
-Il convient, dans un premier temps, de renseigner les Propriétés du projet :
+First, fill in the project properties:
-* <u>Nom du format </u>: identifiant du format sur 10 caractères maximum.
+* <u>Name of the format</u>: identifies the format with 10 characters maximum.
-* <u>Numéro de séquence </u>: identifiant numérique de la séquence sur 5 caractères maximum.
+* <u>Sequence number</u>: identifies the sequence numerically with 5 characters maximum.
-Ces deux premiers paramètres sont obligatoires.
+These two first parameters are required.
-D'autres propriétés sont paramétrables depuis la fenêtre des Propriétés (à cocher depuis l’onglet « Affichage ») :
+Other parameters can be configured in the Properties window (Tick the box Properties in the Display Menu):
 [[File:Projet.PNG|500px|center|sans_cadre]]
-# Description : information utilisateur sur 25 caractères maximum.
+# Description: user information with 25 characters maximum.
-# Commentaire : information supplémentaire.
+# Comment: additional information.
-# Destination : chemin de génération du projet (aussi défini dans Préférences).
+# Shared folder: generation path of the project (also defined in Preferences).
-# Mode : correspond au type de données à mettre en forme : SPLF (texte) ou XML.
+# Mode: corresponds to the type of data to format: SPLF (text) or XML.
-# Page de code : permet d’ouvrir un fichier spool non-Unicode avec une maquette XPS en précisant la page de code du fichier dans les propriétés du projet. L’option n’est accessible qu’en mode SPLF.
+# Code Page: opens a non-Unicode spooled file with an XPS template by specifying the code page of the file in the project properties. This option is only accessible in SPLF mode.
-# Langage de conception : permet de définir le langage de conception de la maquette par une liste déroulante.
+# Designing language: defines the languages in which the template is designed, using a drop-down menu.
-# Orientation : Portrait ou Paysage, pour le recto et éventuellement le verso.
+# Orientation: Portrait or Landscape, for the simplex and the duplex.
-# Dimensions de la page (formats standards ISO, ou format personnalisé) et des marges.
+# Page size (standard ISO formats, or customized format) and margins.
-# Choix d’un projet en recto ou en recto/verso (avec retournement suivant les bords longs ou les bords courts)
+# Simplex/Duplex project (flip the page on the long or the short edge)
-# Saut de page : comportement par défaut de l’application qui traite les données page à page et active une rupture de page une fois les données de la page en cours traitées. Si cette rupture est désactivée, les données de la page suivante seront placées à la suite de la page en cours.
+# Page break: default setting of the application as it processes data one page at a time and adds a page break once the data of a page has been completely processed. If the break is deactivated, the data of the following page will be placed after that of the page processed.
-# Position : dans le cas où la rupture de page est désactivée, cette option permet de préciser la position des données de la page suivante : à droite de la page en cours (décalage horizontal de position) ou en dessous (décalage vertical). Cette option n’est disponible qu’en XPS.
+# Position: if the page break is deactivated, this option lets you specify where to place the data of the following page: on the right of the page being currently processed (horizontal position shift) or underneath (vertical shift). This option is only available in XPS.
-'''Format :'''
+'''Format:'''
-Un Format, vu depuis '''OPALE Server''', est le projet '''Designer''' mais généré et importé sur le serveur de production. Un même format peut être composé de plusieurs séquences.
+Opened in '''OPALE Server''', a Format is a '''Designer''' project which was generated and imported on the production server. A format can be composed of several sequences.
-Chaque séquence est conditionnée pour s’exécuter sur les différentes pages d’un fichier de données (spool ou XML).
+Every sequence is conditioned to run on different pages of a data file (spooled file or XML file).
-Voici un exemple pour mieux comprendre l’intérêt d’avoir plusieurs séquences pour un même projet :
+Here is an example to better understand the benefit of having several sequences for one project:
-Soit une facture de 3 pages :
+On an invoice with 3 pages:
-* La première page contient l’adresse du destinataire, l’adresse de l’expéditeur ainsi que le début du tableau facture (Type de page 1)
+* The first page includes the recipient's address, the sender's address as well as the start of the invoice table (Page type 1)
-* La dernière page contient le total de la facture (Type de page 2)
+* The last page includes the price to pay (Page type 2)
-* Toutes les autres pages contiennent le corps de la facture (Type de page 3)
+* All the other pages contain the body of the invoice (Page type 3)
-Traiter ce spool avec un même format est difficile car les mises en forme sont différentes suivant les types de page. Trois formats vont donc être créés, un pour chaque type de page. Ces trois formats porteront le même nom car ils définissent à eux trois '''LE''' modèle de document "Facture" mais ils auront un numéro de séquence différent :
+Processing the spooled file with the same format is difficult since formatting can differ depending on the page type. Three formats will then be created, one for each page type. These three formats will have the same name because the three together make '''THE''' document "invoice" template, however they will have different sequence numbers:
-* Séquence 00010 s’exécutant sur le type de page 1
+* Sequence 00010 runs on page type 1
-* Séquence 00020 s’exécutant sur le type de page 2.
+* Sequence 00020 runs on page type 2.
-* Séquence 00030 s’exécutant sur le type de page 3.
+* Sequence 00030 runs on page type 3.
-Lors de l’exécution du format Facture sur un fichier de données, un «''' MERGE '''» de ces trois séquences sera effectué afin de traiter le spool intégralement.
+When running the invoice format on a data file, a "'''MERGE'''" of these sequences is carried out to process the spooled file entirely.
-'''Ressources :'''
+'''Resources:'''
-Pour tracer la liste des formats utilisant une ressource en particulier (une police, un fond de page ou un composant).
+List all formats using a particular resource (a font, an overlay or a component).
-MAPLNK est le fichier qui relie l’ensemble des ressources et les formats disponibles sur '''OPALE Server'''.
+MAPLNK is the file which links together all resources and formats available on '''OPALE Server'''.
-Sur IBM i :<code> DSPPFM FILE(MAPLNK)</code>
+On IBM i:<code> DSPPFM FILE(MAPLNK)</code>