ONYX - 9.0 - Utilisation - Création Projet de ONYX Designer
Différence entre versions
De MappingDoc
| (3 révisions intermédiaires par 2 utilisateurs non affichées) | |||
| Ligne 1 : | Ligne 1 : | ||
<languages/> | <languages/> | ||
<translate> | <translate> | ||
| − | =Création d'un projet= | + | =Création d'un projet= <!--T:1--> |
| − | ==Notion de Projet== | + | ==Notion de Projet== <!--T:2--> |
| + | <!--T:3--> | ||
Un Projet Designer est l’association d’un fond de page qui correspond à la partie statique du modèle et d’un fichier de données appelé 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. | Un Projet Designer est l’association d’un fond de page qui correspond à la partie statique du modèle et d’un fichier de données appelé 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. | ||
| + | <!--T:4--> | ||
Physiquement, un projet se compose de trois fichiers (ou cinq fichiers lorsqu’il s’agit d’un projet recto / verso) : | Physiquement, un projet se compose de trois fichiers (ou cinq fichiers lorsqu’il s’agit d’un projet recto / verso) : | ||
| + | <!--T:5--> | ||
*Un fichier ''.mpw'' contient le fond de page recto (un autre peut contenir le fond de page 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 sur le recto (un autre éventuellement pour le verso) | *Un fichier ''.mpi'' contient la mise en forme des données 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''. | *Un fichier ''.mpp'' identifie le projet et fait l’association entre le(s) fichier(s) ''.mpw'' et le(s) fichier(s) ''.mpi''. | ||
| + | <!--T:6--> | ||
Cette notion de projet n’a de valeur <span class="underline">que</span> pendant la conception du modèle côté Designer. Une fois généré sur le serveur de production, nous parlerons alors de format et de numéro de séquence. | Cette notion de projet n’a de valeur <span class="underline">que</span> pendant la conception du modèle côté Designer. Une fois généré sur le serveur de production, nous parlerons alors de format et de numéro de séquence. | ||
| − | ==Création d’un projet== | + | ==Création d’un projet== <!--T:7--> |
| + | <!--T:8--> | ||
[[File:onyxdesigner-image22.png]] | [[File:onyxdesigner-image22.png]] | ||
| + | <!--T:9--> | ||
La création d’un nouveau projet se fait par le menu Fichier > Nouveau > Projet. | La création d’un nouveau projet se fait par le menu Fichier > Nouveau > Projet. | ||
| + | <!--T:10--> | ||
La vue de la conception affiche alors le projet comme une page blanche avec un paramétrage par défaut (portrait, A4 en mode recto). | La vue de la conception affiche alors le projet comme une page blanche avec un paramétrage par défaut (portrait, A4 en mode recto). | ||
| + | <!--T:11--> | ||
Dans l’onglet ''Affichage'', il est préconisé de cocher ''Propriétés'' dans l’onglet ''Afficher/Masquer'' afin de voir apparaitre une fenêtre sur le côté droit de l’écran avec toutes les propriétés à définir. | Dans l’onglet ''Affichage'', il est préconisé de cocher ''Propriétés'' dans l’onglet ''Afficher/Masquer'' afin de voir apparaitre une fenêtre sur le côté droit de l’écran avec toutes les propriétés à définir. | ||
| + | <!--T:12--> | ||
[[File:onyxdesigner-image23.png]] | [[File:onyxdesigner-image23.png]] | ||
| + | <!--T:13--> | ||
Dans un premier temps, il est '''obligatoire''' de compléter les deux paramètres suivants : | Dans un premier temps, il est '''obligatoire''' de compléter les deux paramètres suivants : | ||
| + | <!--T:14--> | ||
*'''Nom du format''' = identifiant du format sur dix caractères maximums. | *'''Nom du format''' = identifiant du format sur dix caractères maximums. | ||
*'''Numéro de séquence''' = identifiant numérique de la séquence sur cinq caractères maximums. | *'''Numéro de séquence''' = identifiant numérique de la séquence sur cinq caractères maximums. | ||
| + | <!--T:15--> | ||
Les notions de ''Format'' et ''Séquence'' seront détaillées plus précisément dans le paragraphe suivant. | Les notions de ''Format'' et ''Séquence'' seront détaillées plus précisément dans le paragraphe suivant. | ||
| + | <!--T:16--> | ||
D’autres propriétés sont paramétrables depuis cette fenêtre : | D’autres propriétés sont paramétrables depuis cette fenêtre : | ||
| + | <!--T:17--> | ||
[[File:onyxdesigner-image24.png]] | [[File:onyxdesigner-image24.png]] | ||
| + | <!--T:18--> | ||
*''Description'' = information utilisateur (limitée à 25 caractères maximum). | *''Description'' = information utilisateur (limitée à 25 caractères maximum). | ||
*''Commentaire'' '''=''' information supplémentaire. | *''Commentaire'' '''=''' information supplémentaire. | ||
| Ligne 48 : | Ligne 63 : | ||
*''Dimensions de la page'' (formats standards ISO ou format personnalisé) et des ''marges''. | *''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). | *Choix d’un projet en recto ou en recto/verso (avec retournement suivant les bords longs ou les bords courts). | ||
| − | *''Saut de page'' = | + | *''Saut de page'' = Cette coche, activée par défaut, permet de générer un saut de page entre chaque page traitée. Si cette option est décochée, les pages de la séquence concernée se superposeront au contenu de la page précédente. |
*''Rupture de lot'' = permet de définir une zone de type '''Metadata''' qui sera utilisée pour regrouper les pages du document final en lot (cf. paragraphe [[#rupture-de-lot|''<span class="underline">8.8.a. Gestion de la pagination par rupture de lot</span>'']]). | *''Rupture de lot'' = permet de définir une zone de type '''Metadata''' qui sera utilisée pour regrouper les pages du document final en lot (cf. paragraphe [[#rupture-de-lot|''<span class="underline">8.8.a. Gestion de la pagination par rupture de lot</span>'']]). | ||
*''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 c’est-à-dire à droite de la page en cours (décalage horizontal de position) ou en dessous (décalage vertical). | *''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 c’est-à-dire à droite de la page en cours (décalage horizontal de position) ou en dessous (décalage vertical). | ||
| + | <!--T:19--> | ||
La propriété ''SO/SI'' est utilisée sous Windows et Unix pour reproduire un fonctionnel natif sous iSeries à savoir la gestion de spools EBCDIC contenant à la fois des caractères SBCS et DBCS (spools asiatiques et japonais particulièrement). Cette propriété indique à l’application le mode de détection et de rendu des informations ''Shift Out'' et ''Shift In'' (caractères hexadécimaux 0x0F et 0x0E, non imprimables) encadrant les textes DBCS afin de respecter les espacements entre les caractères quelle que soit leur largeur. | La propriété ''SO/SI'' est utilisée sous Windows et Unix pour reproduire un fonctionnel natif sous iSeries à savoir la gestion de spools EBCDIC contenant à la fois des caractères SBCS et DBCS (spools asiatiques et japonais particulièrement). Cette propriété indique à l’application le mode de détection et de rendu des informations ''Shift Out'' et ''Shift In'' (caractères hexadécimaux 0x0F et 0x0E, non imprimables) encadrant les textes DBCS afin de respecter les espacements entre les caractères quelle que soit leur largeur. | ||
| + | <!--T:20--> | ||
Dans le détail, l’option ''Style'' permet à la fois de limiter les polices utilisables dans un maquette mais aussi de renommer ces polices en utilisant un alias. Elle permet par exemple de simplifier l’utilisation de polices résidentes dans une maquette en renommant des polices TTF installées sur le poste par le nom des polices résidentes du type d’imprimante de destination. | Dans le détail, l’option ''Style'' permet à la fois de limiter les polices utilisables dans un maquette mais aussi de renommer ces polices en utilisant un alias. Elle permet par exemple de simplifier l’utilisation de polices résidentes dans une maquette en renommant des polices TTF installées sur le poste par le nom des polices résidentes du type d’imprimante de destination. | ||
| + | <!--T:21--> | ||
Le fichier XPS généré embarque le nouveau nom des polices définies dans le style, il est donc possible d’utiliser ces noms pour la définition de polices de remplacement dans le profil de conversion. | Le fichier XPS généré embarque le nouveau nom des polices définies dans le style, il est donc possible d’utiliser ces noms pour la définition de polices de remplacement dans le profil de conversion. | ||
| + | <!--T:22--> | ||
Exemple de style utilisé pour l’impression sur imprimante Datamax : | Exemple de style utilisé pour l’impression sur imprimante Datamax : | ||
| + | <!--T:23--> | ||
<code><?xml version="1.0" encoding="windows-1252" ?></code> | <code><?xml version="1.0" encoding="windows-1252" ?></code> | ||
| + | <!--T:24--> | ||
<code><style></code> | <code><style></code> | ||
| + | <!--T:25--> | ||
<code><fonts></code> | <code><fonts></code> | ||
| + | <!--T:26--> | ||
<code><font name="Arial" alias="Datamax 0"/></code> | <code><font name="Arial" alias="Datamax 0"/></code> | ||
| + | <!--T:27--> | ||
<code><font name="Arial" alias="Datamax 1"/></code> | <code><font name="Arial" alias="Datamax 1"/></code> | ||
| + | <!--T:28--> | ||
<code><font name="Arial" alias="Datamax 2"/></code> | <code><font name="Arial" alias="Datamax 2"/></code> | ||
| + | <!--T:29--> | ||
<code><font name="Arial" alias="Datamax 3"/></code> | <code><font name="Arial" alias="Datamax 3"/></code> | ||
| + | <!--T:30--> | ||
<code><font name="Arial" alias="Datamax 4"/></code> | <code><font name="Arial" alias="Datamax 4"/></code> | ||
| + | <!--T:31--> | ||
<code><font name="Arial" alias="Datamax 5"/></code> | <code><font name="Arial" alias="Datamax 5"/></code> | ||
| + | <!--T:32--> | ||
<code><font name="Arial" alias="Datamax 6"/></code> | <code><font name="Arial" alias="Datamax 6"/></code> | ||
| + | <!--T:33--> | ||
<code><font name="Arial" alias="Datamax 7 (OCR-A)"/></code> | <code><font name="Arial" alias="Datamax 7 (OCR-A)"/></code> | ||
| + | <!--T:34--> | ||
<code><font name="Arial" alias="Datamax 8 (OCR-B)"/></code> | <code><font name="Arial" alias="Datamax 8 (OCR-B)"/></code> | ||
| + | <!--T:35--> | ||
<code><font name="Arial" alias="Datamax 9 (Arial)"/></code> | <code><font name="Arial" alias="Datamax 9 (Arial)"/></code> | ||
| + | <!--T:36--> | ||
<code></fonts></code> | <code></fonts></code> | ||
| + | <!--T:37--> | ||
<code></style></code> | <code></style></code> | ||
| + | <!--T:38--> | ||
[[File:onyxdesigner-image25.jpeg|cid:image006.jpg@01D1BB29.1944AF40]] [[File:onyxdesigner-image26.jpeg|cid:image007.jpg@01D1BB29.1944AF40]] | [[File:onyxdesigner-image25.jpeg|cid:image006.jpg@01D1BB29.1944AF40]] [[File:onyxdesigner-image26.jpeg|cid:image007.jpg@01D1BB29.1944AF40]] | ||
| + | <!--T:39--> | ||
Par défaut Designer est fourni avec les styles '''Datamax''', '''Eltron''', '''IGP''', '''Intermec''', '''TEC''', et '''Zebra''' permettant la réutilisation d’anciennes maquettes non-Unicode. | Par défaut Designer est fourni avec les styles '''Datamax''', '''Eltron''', '''IGP''', '''Intermec''', '''TEC''', et '''Zebra''' permettant la réutilisation d’anciennes maquettes non-Unicode. | ||
| + | <!--T:40--> | ||
La sélection de ces styles est automatique lors de l’ouverture d’une ancienne maquette. | La sélection de ces styles est automatique lors de l’ouverture d’une ancienne maquette. | ||
| + | <!--T:41--> | ||
Le projet est maintenant prêt à être développé. | Le projet est maintenant prêt à être développé. | ||
| − | ==Notion de Format / Séquence== | + | ==Notion de Format / Séquence== <!--T:42--> |
| + | <!--T:43--> | ||
Un '''Format''', visible depuis Onyx Server, est le pendant d’un projet Designer mais généré et importé sur le serveur de production. Un même format peut être composé de plusieurs séquences. | Un '''Format''', visible depuis Onyx Server, est le pendant d’un projet Designer mais généré et importé sur le serveur de production. Un même format peut être composé de plusieurs séquences. | ||
| + | <!--T:44--> | ||
Chaque '''Séquence''' est conditionnée pour s’exécuter sur les différentes pages d’un fichier de données (''spool'' ou ''XML''). | Chaque '''Séquence''' est conditionnée pour s’exécuter sur les différentes pages d’un fichier de données (''spool'' ou ''XML''). | ||
| + | <!--T:45--> | ||
Voici un exemple pour mieux comprendre l’intérêt d’avoir plusieurs séquences pour un même projet : | Voici un exemple pour mieux comprendre l’intérêt d’avoir plusieurs séquences pour un même projet : | ||
| + | <!--T:46--> | ||
''Soit une facture de 3 pages :'' | ''Soit une facture de 3 pages :'' | ||
| + | <!--T:47--> | ||
*''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 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)'' | *''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)'' | *''Toutes les autres pages contiennent le corps de la facture (Type de page 3)'' | ||
| + | <!--T:48--> | ||
''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.'' | ''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.'' | ||
| + | <!--T:49--> | ||
''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 :'' | ''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 :'' | ||
| + | <!--T:50--> | ||
*''Séquence 00010 s’exécutant sur le type de page 1'' | *''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 00020 s’exécutant sur le type de page 2.'' | ||
*''Séquence 00030 s’exécutant sur le type de page 3.'' | *''Séquence 00030 s’exécutant sur le type de page 3.'' | ||
| + | <!--T:51--> | ||
''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.'' | ''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.'' | ||
</translate> | </translate> | ||
Version actuelle datée du 11 décembre 2019 à 18:07
Sommaire
Création d'un projet
Notion de Projet
Un Projet Designer est l’association d’un fond de page qui correspond à la partie statique du modèle et d’un fichier de données appelé 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 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.
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, nous parlerons alors de format et de numéro de séquence.
Création d’un projet
La création d’un nouveau projet se fait par le menu Fichier > Nouveau > Projet.
La vue de la conception affiche alors le projet comme une page blanche avec un paramétrage par défaut (portrait, A4 en mode recto).
Dans l’onglet Affichage, il est préconisé de cocher Propriétés dans l’onglet Afficher/Masquer afin de voir apparaitre une fenêtre sur le côté droit de l’écran avec toutes les propriétés à définir.
Dans un premier temps, il est obligatoire de compléter les deux paramètres suivants :
- Nom du format = identifiant du format sur dix caractères maximums.
- Numéro de séquence = identifiant numérique de la séquence sur cinq caractères maximums.
Les notions de Format et Séquence seront détaillées plus précisément dans le paragraphe suivant.
D’autres propriétés sont paramétrables depuis cette fenêtre :
- Description = information utilisateur (limitée à 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.
- Style = choix de la feuille de style (aussi défini dans Préférences). Cette option est détaillée ci-dessous.
- Document et Page = permet d’inclure des données en langage d’imprimante dans le flux de sortie pour les langages suivants : PCL5, APFDS, PDF, ZPL, DPL, TEC, IGP, IPL et EPL. Une zone peut contenir des données pour plusieurs langages différents. Lors de la conversion du XPS vers le langage de sortie, la donnée correspondante au langage de sortie sera utilisée. Les données sont écrites en début et fin du document.
- 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 = Cette coche, activée par défaut, permet de générer un saut de page entre chaque page traitée. Si cette option est décochée, les pages de la séquence concernée se superposeront au contenu de la page précédente.
- Rupture de lot = permet de définir une zone de type Metadata qui sera utilisée pour regrouper les pages du document final en lot (cf. paragraphe 8.8.a. Gestion de la pagination par rupture de lot).
- 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 c’est-à-dire à droite de la page en cours (décalage horizontal de position) ou en dessous (décalage vertical).
La propriété SO/SI est utilisée sous Windows et Unix pour reproduire un fonctionnel natif sous iSeries à savoir la gestion de spools EBCDIC contenant à la fois des caractères SBCS et DBCS (spools asiatiques et japonais particulièrement). Cette propriété indique à l’application le mode de détection et de rendu des informations Shift Out et Shift In (caractères hexadécimaux 0x0F et 0x0E, non imprimables) encadrant les textes DBCS afin de respecter les espacements entre les caractères quelle que soit leur largeur.
Dans le détail, l’option Style permet à la fois de limiter les polices utilisables dans un maquette mais aussi de renommer ces polices en utilisant un alias. Elle permet par exemple de simplifier l’utilisation de polices résidentes dans une maquette en renommant des polices TTF installées sur le poste par le nom des polices résidentes du type d’imprimante de destination.
Le fichier XPS généré embarque le nouveau nom des polices définies dans le style, il est donc possible d’utiliser ces noms pour la définition de polices de remplacement dans le profil de conversion.
Exemple de style utilisé pour l’impression sur imprimante Datamax :
<?xml version="1.0" encoding="windows-1252" ?>
<style>
<fonts>
<font name="Arial" alias="Datamax 0"/>
<font name="Arial" alias="Datamax 1"/>
<font name="Arial" alias="Datamax 2"/>
<font name="Arial" alias="Datamax 3"/>
<font name="Arial" alias="Datamax 4"/>
<font name="Arial" alias="Datamax 5"/>
<font name="Arial" alias="Datamax 6"/>
<font name="Arial" alias="Datamax 7 (OCR-A)"/>
<font name="Arial" alias="Datamax 8 (OCR-B)"/>
<font name="Arial" alias="Datamax 9 (Arial)"/>
</fonts>
</style>
Par défaut Designer est fourni avec les styles Datamax, Eltron, IGP, Intermec, TEC, et Zebra permettant la réutilisation d’anciennes maquettes non-Unicode.
La sélection de ces styles est automatique lors de l’ouverture d’une ancienne maquette.
Le projet est maintenant prêt à être développé.
Notion de Format / Séquence
Un Format, visible depuis Onyx Server, est le pendant d’un 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.
