OPALE - 10.0 - Utilisation
Formats de fichier
Notion Projet/Format :
Un Projet Designer est l’association d’un fond de page (partie statique du modèle) et d’un fichier de données (partie variable ou dynamique). Il est identifié par un nom de format et un numéro de séquence qui le rendent unique sur le serveur de production.
Physiquement, un projet se compose de trois fichiers (ou cinq fichiers lorsqu’il s’agit d’un projet recto / verso) :
- Un fichier .mpw contient le fond de page recto (un autre peut contenir le fond de page verso).
- Un fichier .mpi contient la mise en forme des données (maquette) sur le recto (un autre éventuellement pour le verso).
- Un fichier .mpp identifie le projet et fait l’association entre le(s) fichier(s) .mpw et le(s) fichier(s) .mpi.
- Les associations de projets sont des fichiers de type *.MPA
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.
Créer un projet :
La création d’un nouveau projet se fait par le menu Fichier > Nouveau > Projet.
La vue conception affiche alors le projet comme une page blanche avec un paramétrage par défaut (portrait, A4 en mode recto).
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 ») :
- Description : information utilisateur sur 25 caractères maximum.
- Commentaire : information supplémentaire.
- Destination : chemin de génération du projet (aussi défini dans Préférences).
- Mode : correspond au type de données à mettre en forme : SPLF (texte) ou 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.
- Langage de conception : permet de définir le langage de conception de la maquette par une liste déroulante.
- Orientation : Portrait ou Paysage, pour le recto et éventuellement le verso.
- Dimensions de la page (formats standards ISO, ou format personnalisé) et des marges.
- Choix d’un projet en recto ou en recto/verso (avec retournement suivant les bords longs ou les bords courts)
- 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.
- 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)