File Formats

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 and 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).

Il convient, dans un premier temps, de renseigner les Propriétés du projet :

• Nom du format : identifiant du format sur 10 caractères maximum.
• Numéro de séquence : identifiant numérique de la séquence sur 5 caractères maximum.

Ces deux premiers paramètres sont obligatoires.

D'autres propriétés sont paramétrables depuis la fenêtre des Propriétés (à cocher depuis l’onglet « Affichage ») :

1. Description : information utilisateur sur 25 caractères maximum.
2. Commentaire : information supplémentaire.
3. Destination : chemin de génération du projet (aussi défini dans Préférences).
4. Mode : correspond au type de données à mettre en forme : SPLF (texte) ou XML.
5. 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.
6. Langage de conception : permet de définir le langage de conception de la maquette par une liste déroulante.
7. Orientation : Portrait ou Paysage, pour le recto et éventuellement le verso.
8. Dimensions de la page (formats standards ISO, ou format personnalisé) et des marges.
9. Choix d’un projet en recto ou en recto/verso (avec retournement suivant les bords longs ou les bords courts)
10. 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.
11. 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.

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.

Chaque séquence est conditionnée pour s’exécuter sur les différentes pages d’un fichier de données (spool ou XML).

Voici un exemple pour mieux comprendre l’intérêt d’avoir plusieurs séquences pour un même projet :

Soit une facture de 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)
• La dernière page contient le total de la facture (Type de page 2)
• Toutes les autres pages contiennent le corps de la facture (Type de page 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 :

• Séquence 00010 s’exécutant sur le type de page 1
• Séquence 00020 s’exécutant sur le type de page 2.
• Séquence 00030 s’exécutant sur le type de page 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.

Ressources :

Pour tracer la liste des formats utilisant une ressource en particulier (une police, un fond de page ou un composant).

MAPLNK est le fichier qui relie l’ensemble des ressources et les formats disponibles sur OPALE Server.

Sur IBM i : DSPPFM FILE(MAPLNK)