MappingDoc - Contributions de l’utilisateur [fr]

OPALE:10.0:Utilisation: créer les fichiers de définition

2019-05-15T12:50:56Z

Izarai :

Avec une base de données, la première étape pour concevoir un rapport est de créer les définitions de fichier. Il s'agit en fait de récupérer la structure des

tables qui permettront de créer les rapports : type, nom et longueur des champs contenus dans le fichier.

Sur OPALE Server, MapReport liste toutes les bibliothèques du système en choisissant l'option '''Création des définitions de fichier'''.

Préciser ensuite dans quelle bibliothèque se trouve le fichier à exporter à l'aide de l'option '''5=Niveau Suivant'''.

Ensuite, apparaît à l'écran la liste des fichiers PF de la bibliothèque choisie. Tapez 1 pour exporter la table ou 5 pour passer au niveau membre.

Au niveau membre, vous pouvez soit exporter le membre, soit lancer la création d'un spool à partir du membre sélectionné (commande MAPOFFICE).

Exporter un fichier physique iSeries vers le PC 

Avant d'exporter un fichier, il faut connaître le nom de l'objet et dans quelle bibliothèque il se trouve.

*Choisir l'option 3 du menu M-Connect
*Taper 5=Niveau suivant devant la bibliothèque contenant le fichier
*Taper 1=Exportation PC devant le fichier à exporter
*Renouveler l'opération pour les autres fichiers servant au rapport

[[File:Creation pf.PNG|600px|sans_cadre|alt=|centré]]

[[File:Struc pf.PNG|600px|sans_cadre|alt=|centré]]

[[File:Structure d un FP(2).PNG|600px|sans_cadre|alt=|centré]]

Le fichier exporté s'affiche dans l'IFS avec <code>le nom de la bibiotheque.lib</code>

[[File:Exporter FP.PNG|663x663px|sans_cadre|alt=|centré]]

[[Fichier:C Utilisation fichierLib.png|centré|sans_cadre|955x955px]]

OPALE:10.0:Utilisation: créer les fichiers de définition

2019-05-15T12:50:34Z

Izarai :

Avec une base de données, la première étape pour concevoir un rapport est de créer les définitions de fichier. Il s'agit en fait de récupérer la structure des

tables qui permettront de créer les rapports : type, nom et longueur des champs contenus dans le fichier.

Sur OPALE Server, MapReport liste toutes les bibliothèques du système en choisissant l'option '''Création des définitions de fichier'''.

Préciser ensuite dans quelle bibliothèque se trouve le fichier à exporter à l'aide de l'option '''5=Niveau Suivant'''.

Ensuite, apparaît à l'écran la liste des fichiers PF de la bibliothèque choisie. Tapez 1 pour exporter la table ou 5 pour passer au niveau membre.

Au niveau membre, vous pouvez soit exporter le membre, soit lancer la création d'un spool à partir du membre sélectionné (commande MAPOFFICE).

Exporter un fichier physique iSeries vers le PC 

Avant d'exporter un fichier, il faut connaître le nom de l'objet et dans quelle bibliothèque il se trouve.

*Choisir l'option 3 du menu M-Connect
*Taper 5=Niveau suivant devant la bibliothèque contenant le fichier
*Taper 1=Exportation PC devant le fichier à exporter
*Renouveler l'opération pour les autres fichiers servant au rapport

[[File:Creation pf.PNG|600px|sans_cadre|alt=|centré]]
[[File:Struc pf.PNG|600px|sans_cadre|alt=|centré]]
[[File:Structure d un FP(2).PNG|600px|sans_cadre|alt=|centré]]

Le fichier exporté s'affiche dans l'IFS avec <code>le nom de la bibiotheque.lib</code>

[[File:Exporter FP.PNG|663x663px|sans_cadre|alt=|centré]]

[[Fichier:C Utilisation fichierLib.png|centré|sans_cadre|955x955px]]

OPALE:10.0:Utilisation:Envoyer un spool ASCII en FTP : MAPSNDFTP

2019-05-15T12:38:28Z

Izarai :

Cette commande permet d'envoyer un spool ASCII en FTP.

[[File:Mapsndftp.PNG|667x667px|centré|sans_cadre]]

OPALE:10.0:Migration:Abaques de migration

2019-05-15T12:32:37Z

Izarai :

Pour calculer les abaques de migration, veuillez utiliser le fichier Excel ci-dessous.

Télécharger le [https://serveur.mappingsuite.com/web/docs/Abaque_Chiffrage_Upgrade.xlsx<nowiki>Fichier Excel de calcul des abaques de migration</nowiki>].

[[File:AbaqueMigrationExcel.png|700px|Aperçu de la feuille Excel]]

OPALE:10.0:Migration:Process de migration

2019-05-15T11:53:59Z

Izarai : /* Étape 1 : Régénération des projets Designer */

==Introduction==

Cet article décrit le processus permettant de mettre à niveau OPALE Server sur un serveur iSeries. Cette procédure s'applique également à une mise à niveau vers M-PS 7.2.

== Déroulement de la mise à jour ==
Cette présente procédure considère que l'environnement de production que nous voulons migrer se trouve dans une bibliothèque nommée MAP400.

Le déroulement de la mise à jour d'OPALE Server se compose des points suivants :

*Installation d'un environnement de développement (avec version de destination OPALE Server)
*Copie du paramétrage de l'environnement de production sur l'environnement de développement
*Création d'une OUTQ monitorée par Mapping + modification des règles éventuelles pour modification des routages d'impressions (Optionnel)
*Déroulement des tests
*Passage en production
*Rollback en cas de problème
*Troubleshooting

Toute modification de maquette (lié à une modification souhaitée ou un delta suite à la mise à jour) sera alors réalisée avec un Designer ayant la même version qu'OPALE Server et en UNICODE.

==Prérequis client==

===Profil utilisateur===
- Avoir accès au profil QSECOFR pour l'installation du produit 

===Eléments à ressembler===

Le client doit avoir une bonne connaissance de leur environnement. Pour cela, il devra être capable de : 

- Définir les documents clés devant être testés par MAPPING ou un de leurs partenaires certifiés 
- Connaitre et retrouver les fichiers spools bruts pour chacun des ses documents 
- Retrouver les projets Designer(.mpi, mpp et mpw) pour chacun de ces documents ainsi que leurs composants éventuels 
- Avoir un fichier PDF et/ou .dmp du fichier à imprimer pour chacun des ses documents 
- Définir les règles stratégiques mises en place sur l'environnement de production 
- Rassembler les différents fichiers spool iSeries (dans une outq: MAPREF/MAPQUALREF) ainsi que leurs Mapping de sortie d'impression (PCL, ZPL, TEC, etc) correspondants générés avec la version actuelle de Mapping sur le serveur de production.

'''Important''' : Les polices utilisées doivent être au format TTF (toutes autres types de polices devront être remplacés par des polices TTF par le client)

Tous les fichiers sources "Windows" devront être classés dans des répertoire de façon méthodique : Un répertoire par document

Remarque : Un chiffrage d'upgrade pourra alors être réalisé par MAPPING.

ATTENTION : Si ce prérequis n'est pas respecté, un audit pourra être réalisé par Mapping ou un partenaire certifié Mapping pour reprendre la main sur l'environnement et en identifier tous les éléments importants.

==Prise en main de l'environnement de client==
=== Mapping ou Partenaire certifié Mapping : Prendre connaissance de l'environnement du client===
#Vérifier si MAPPING est configuré en UNICODE ou non UNICODE : Option 14/1 
#Regarder le type de règles et d'actions utilisées par le client
#Regarder le nom de société renseigné dans les paramètres (Option 14/1) et remettre le même nom dans la future bibliothèque de test 
#Valider que la configuration (Option 14/1) soit la même sur MAPPINGQUA que MAP400 (hormis les chemins IFS)
#Vérifier les paramètres de MAPSND (Menu MapSend option 1)
==Installation ==

===Copie de l'environnement de production===

Avant toute chose, faire une copie de la bibliothèque de production du client. Toute manipulation de données de l'environnement de production se fera à travers cette copie : MAPPINGCPY

CPYLIB FROMLIB(MAP400) TOLIB(MAPPINGCPY)

Le but de ces noms différents étant d'éviter des erreurs de manipulation en confondant MAP400 avec par exemple MAP400CPY. C'est pour cela que le nom MAPPINGCPY a été choisi.
Toute manipulation avec les objets de production devra être faite au travers de MAPPINGCPY et non MAP400.

===Récupérer le dernier Setup disponible===
Récupérer le dernier setup mis à disposition par Mapping.

===Installer le produit dans une nouvelle bibliothèque===

Installer la nouvelle version d'OPALE Server: [[OPALE:10.0:Installation:Installation OPALE Server|Installation OPALE Server]]

'''ATTENTION : NE PAS GARDER MAP400 en bibliothèque d'installation lors de la mise à jour'''
*Nom de la bibliothèque : MAPPINGQUA
*Nom du sous système : MAPSQUAL
*Arborescence IFS: "/home/MAPQUAL/mapping" (mapsend,mapreport,mapout)

==Paramétrage de l'environnement (selon le type de migration choisi)==

Quel que soit le type de migration choisi (listé ci-dessous), les tests doivent être réalisés sur l'environnement nouvellement installé : MAPPINGQUA. 

<big>'''En aucun cas l'environnement de production (ex : MAP400) ne doit être modifié. L'environnement de production devra rester intact durant toute la migration et au-delà.''' </big> 

===Type SIMPLE : Copie simple de maquettes===
Ce type consiste à une simple copie de fichiers ressources AS400 afin de copier les formats Designer ainsi que les règles et relations entre Outqs. Les maquettes ne sont pas regénérées.

====Etape 1 : Copie des formats Designer====
Fichiers à copier de MAPPINGCPY vers MAPPINGQUA :
=====Copie de certains formats=====
Copier les formats de MAPPINGCPY vers MAPPINGQUA (Option 3 puis 3/Copier Formats Designer)

=====Copie de tous les formats d'un seul coup=====
S'il y a beaucoup de formats et que nous voulons tout prendre, nous pouvons copier les fichiers physiques (MAPLNK, MAPLNKL1, MAPOBJ, MAP1, MAP2D, MAP2H, MAP3, MAP3L1, MAP)

=====Procédure pour copier les fichiers concernant les Formats M-Designer=====

Cas particulier du MAPLNK/MAPLNKL1 :

Suppression de l'ancien objet MAPLNKL1 avant la copie du MAPLNK
strpdm
Option 2
Bibliothèque : MAPPINGQUA
Nom : MAPLNKL1
Option 4 pour supprimer MAPLNKL1

Remplacement de l'ancien MAPLNK par le nouveau
strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : MAPLNK
Option 3 devant MAPLNK
Dans la bibliothèque : MAPPINGQUA
Suppression de l'objet existant : O

Copie du nouveau MAPLNKL1 une fois le MAPLNK copié
strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : MAPLNKL1
Option 3 devant MAPLNKL1
Dans la bibliothèque : MAPPINGQUA

Cas particulier du MAP3/MAP3L1 :

Suppression de l'ancien objet MAP3L1 avant la copie du MAP3
strpdm
Option 2
Bibliothèque : MAPPINGQUA
Nom : MAP3L1
Option 4 pour supprimer MAP3L1

Remplacement de l'ancien MAP3 par le nouveau
strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : MAP3
Option 3 devant MAP3
Dans la bibliothèque : MAPPINGQUA
Suppression de l'objet existant : O

Copie du nouveau MAP3L1 une fois le MAP3 copié
strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : MAP3L1
Option 3 devant MAP3L1
Dans la bibliothèque : MAPPINGQUA

Cas générique des autres objets :
Copie du nouveau MAPOBJ
strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : MAPOBJ
Option 3 devant MAPOBJ
Dans la bibliothèque : MAPPINGQUA
Suppression de l'objet existant : O

Répéter l'opération pour les objets suivants : MAP1, MAP2D, MAP2H, MAP

====Etape 2 : Copie du paramétrage des OUTQ====

strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : MAPOUTQ
Option 3 devant MAPOUTQ
Dans la bibliothèque : MAPPINGQUA
Suppression de l'objet existant : O

====Etape 3 : Copie des règles et actions====

Copier les fichiers physiques MAPPINGCPY/SPLMAP, ACTLIG et ACTION ('''pas OUTOUT''') dans la bibliothèque MAPPINGQUA

Copie du nouveau SPLMAP
strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : SPLMAP
Option 3 devant SPLMAP
Dans la bibliothèque : MAPPINGQUA
Suppression de l'objet existant : O

Répéter l'opération pour les objets suivants : SPLMAP, ACTLIG, ACTION

====Etape 4 : Copie des données de l'IFS====

#Copier dans le répertoire "/home/MAPQUAL/mapping/docPC/M-Designer_BACKUP_VersionMPSixxxx/" tous les différents projets M-Designer pour conserver la version d'origine. (remplacer le xxxx par la numéro de version MPS-i)
#Copier dans le répertoire "home/MAPQUAL/mapping/ttf/" le contenu de "home/mapping/ttf/"
#Copier dans le répertoire "/home/MAPQUAL/mapping/lgobitmap/" le contenu de "/home/mapping/lgobitmap"

====Etape 5 : Reconstruction du LSTOBJ.TXT====

Lancer la commande :
CALL MAP_823

====Etape 6 : Création d'une Outq monitorée par Mapping pour la recette (Optionnel)====
Si non réalisé, les commandes de tests devront être lancées en interactif

* OutqName: MAPQUALIN
* DATAQ: DTAQUAL
* LIB: MAPPINGQUA
* Imprimante par défaut: “A définir avec le client”

====Gestion des bugs sur un document====
=====Aucun bug détecté=====
Rien de particulier. Il faudra bien que le client range leurs fichiers sources Designer (mpi, mpp et mpw) de façon à les retrouver façilement.

Conseil : Créer un répertoire par maquette avec le spool d'entrée en PAG ou XML (selon si c'est un fichier texte paginé ou XML)

=====Gestion des bugs détectés=====
Le projet Designer devra être regénéré avec la dernière version Designer adapté à la version du serveur (Opale, 7.2).
Il pourra être regénéré en Unicode ou en Non Unicode (selon configuration du client). 

A ce moment-là, nous avons deux choix possibles :

1. La regénération résoud le bug (avec ou sans modification de la maquette)

Rien d'autre n'est nécessaire. Il faudra juste bien classer les fichiers sources du projet (mpi, mpp et mpw) dans un répertoire afin de savoir rapidement que celui-ci a été ouvert et généré avec la nouvelle version de Designer.

2. La regénération ne résoud pas le bug

Dans ce cas-là, il faudra passer le document en UNICODE :
* Génération en Unicode (code page 1200)
* Exécution de la maquette en UNICODE sur le serveur
Si ceci corrige le problème, il ne faut rien faire de plus. 
Sinon, un ticket devra être ouvert auprès du support MAPPING. 

'''Attention : La correction se fera uniquement en UNICODE.'''

===Type avancé: Régénération systématique des maquettes (dans le langage d'origine)===
Ce type consiste à une régénération systématique de toutes les maquettes (En UNICODE : Code page 1200 sur Designer). Uniquement la copie des fichiers ressources pour les règles et relations entre Outqs sera réalisée.

====Étape 1 : Régénération des projets Designer====
#Installer le dernier setup de Designer correspondant à la version de votre nouvelle installation du serveur
#Ouvrir chaque maquette et la générer manuellement en code page 1200 sur le nouveau serveur 

'''Remarque''' : Il est possible d'automatiser la génération des maquettes grâce à un script.

Pour cela, il faut :
#Identifier pour chaque projet, leur type de fichier en entrée (XML et SPOOL) et leur langage de génération (PCL,ZPL,etc) et les ranger dans des dossiers séparés par langage de génération ET type de fichier en entrée
#Exécuter le script suivant qui permettra de lancer automatiquement la génération :
<code>for %%X in ("C:\MAPPING\M-Processing Server\Import\docpc\*.mpp") do ("C:\MAPPING\M-Designer\M-Designer.exe" "-Generate" "-ProjectFile:%%X" "-Hide")</code>

À savoir : Les chemins devront être changés en fonction du contexte.

Le type de fichier en entrée est paramétré grâce au paramètre XXXXXXXXXXXXXX (à terminer).

Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY (à terminer).

====Etape 2 : Copie du paramétrage des OUTQ====
Fichiers à copier de MAPPINGCPY vers MAPPINGQUA :
strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : MAPOUTQ
Option 3 devant MAPOUTQ
Dans la bibliothèque : MAPPINGQUA
Suppression de l'objet existant : O

====Etape 3 : Copie des règles et action====

Copier les fichiers physiques MAPPINGCPY/SPLMAP, ACTLIG et ACTION ('''pas OUTOUT''') dans la bibliothèque MAPPINGQUA

Copie du nouveau SPLMAP
strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : SPLMAP
Option 3 devant SPLMAP
Dans la bibliothèque : MAPPINGQUA
Suppression de l'objet existant : O

Répéter l'opération pour les objets suivants : SPLMAP, ACTLIG , ACTION

====Étape 4 : Copie des données de l'IFS====

#Copier dans le répertoire "/home/MAPQUAL/mapping/docPC/M-Designer_BACKUP_VersionMPSixxxx/" tous les différents projets M-Designer pour conserver la version d'origine. (remplacer le xxxx par la numéro de version MPS-i)
#Copier dans le répertoire "/home/MAPQUAL/mapping/lgobitmap/" le contenu de "/home/mapping/lgobitmap"

====Étape 5 : Création d'une Outq monitorée par Mapping pour la recette (Optionnel)====
Si cette étape n'est pas réalisée, les commandes de test devront être lancées en interactif

* OutqName: MAPQUALIN
* DATAQ: DTAQUAL
* LIB: MAPPINGQUA
* Imprimante par défaut: “à définir avec le client”

====Gestion des bugs sur un document====
=====Aucun bug détecté=====
Le client pourra continuer d'utiliser le document tel quel.

=====Gestion des bugs détectés=====
Selon le problème :
#alignements de zones : Modifier la maquette pour que l'alignement de zone soit OK en preview. Valider que le document final (imprimé, PDF, etc) soit cohérent par rapport à la preview
#Code barre :
##Problèmes d'alignements : Vérifier la preview sur la maquette et corriger la maquette si besoin
##Problème de labélisation : Cocher ou décocher le label du code barre (propriétés de la zone Code barre)
##A compléter

A ce moment là, nous avons deux choix possibles :
#Les corrections de la maquette corrige bien les problèmes (Preview et sortie cohérents) : Rien d'autre n'est à faire.
Rien d'autre n'est nécessaire. Il faudra juste bien classer les fichiers sources du projet (mpi,mpp et mpw) dans un répertoire afin de savoir rapidement que celui-ci a été ouvert et généré avec la nouvelle version de Designer.

#Les modifications de la maquette ne sont pas concluantes.
Un ticket devra être ouvert au support MAPPING. .
Il faudra juste bien classer les fichiers sources du projet (mpi,mpp et mpw) dans un répertoire afin de savoir rapidement que celui-ci a été ouvert et généré avec la nouvelle version de Designer.

Attention : La correction se fera uniquement en UNICODE.

===Type AVANCÉ XPS: Passage en XPS de toutes les maquettes===
Ce type consiste au passage systématique de toutes les maquettes en XPS (En UNICODE : Code page 1200 sur Designer + Génération XPS). Uniquement la copie des fichiers ressources pour les règles et relations entre Outqs sera réalisée.

====Etape 1 : Régénération des projets Designer====
#Installer le dernier setup de Designer (correspondant à la version de votre nouvelle installation du serveur)
#Ouvrez chaque maquette et générer manuellement en code page 1200 en XPS sur le nouveau serveur 

Remarque: Il est possible de scripter leurs générations. Pour cela, il faut:
#identifier pour chaque projet, leur type de fichier en entrée (XML et SPOOL) et leur langage de génération (PCL,ZPL,etc) et les ranger dans des dossiers séparés par langage de génération ET type de fichier en entrée
#Exécuter le script suivant qui permettra de lancer automatiquement la génération
<code>for %%X in ("C:\MAPPING\M-Processing Server\Import\docpc\*.mpp") do ("C:\MAPPING\M-Designer\M-Designer.exe" "-Generate" "-ProjectFile:%%X" "-Hide")</code>

A savoir : Les chemins devront être changés en fonction de votre contexte
Le type de fichier en entrée est paramétré grace au paramètre XXXXXXXXXXXXXX (A terminer)
Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY (A terminer)

====Etape 2 : Copie du paramétrage des OUTQ====
Fichiers à copier de MAPPINGCPY vers MAPPINGQUA :
strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : MAPOUTQ
Option 3 devant MAPOUTQ
Dans la bibliothèque : MAPPINGQUA
Suppression de l'objet existant : O

====Etape 3 : Copie des règles et action====

Copier les fichiers physiques MAPPINGCPY/SPLMAP, ACTLIG et ACTION ('''pas OUTOUT''') dans la bibliothèque MAPPINGQUA

Copie du nouveau SPLMAP
strpdm
Option 2
Bibliothèque : MAPPINGCPY
Nom : SPLMAP
Option 3 devant SPLMAP
Dans la bibliothèque : MAPPINGQUA
Suppression de l'objet existant : O

Répéter l'opération pour les objets suivants : SPLMAP, ACTLIG , ACTION

====Etape 4 : Copie des données de l'IFS====

#Copier dans le répertoire "/home/MAPQUAL/mapping/docPC/M-Designer_BACKUP_VersionMPSixxxx/" tous les différents projets M-Designer pour conserver la version d'origine. (remplacer le xxxx par la numéro de version MPS-i)
#Copier dans le répertoire "/home/MAPQUAL/mapping/lgobitmap/" le contenu de "/home/mapping/lgobitmap"

====Etape 5 : Création d'une Outq monitorée par Mapping pour la recette (Optionnel)====
Si non réalisé, les commandes de tests devront être lancées en interactif

* OutqName: MAPQUALIN
* DATAQ: DTAQUAL
* LIB: MAPPINGQUA
* Imprimante par défaut: “A définir avec le client”

====Gestion des bugs sur un document====

=====Aucun bug détecté=====
Le client pourra continuer d'utiliser leur document tel quel.

=====Gestion des bugs détectés=====
Selon le problème :
#alignements de zones : Modifier la maquette pour que l'alignement de zone soit OK en preview. Valider que le document final (imprimé, PDF, etc) soit cohérent par rapport à la preview
#Code barre :
##Problèmes d'alignements : Vérifier la preview sur la maquette et corriger la maquette si besoin
##Problème de labélisation : Cocher ou décocher le label du code barre (propriétés de la zone Code barre)
##A compléter

A ce moment là, nous avons deux choix possibles :
#Les corrections de la maquette corrige bien les problèmes (Preview et sortie cohérents) : Rien d'autre n'est à faire.
Il faudra juste bien classer les fichiers sources du projet (mpi,mpp et mpw) dans un répertoire afin de savoir rapidement que celui-ci a été ouvert et généré avec la nouvelle version de Designer.

#Les modifications de la maquette ne sont pas concluantes.
Un ticket devra être ouvert au support MAPPING. .
Il faudra juste bien classer les fichiers sources du projet (mpi,mpp et mpw) dans un répertoire afin de savoir rapidement que celui-ci a été ouvert et généré avec la nouvelle version de Designer.

Attention : La correction se fera uniquement en UNICODE.

===Gestion des cas particulier===
Les 3 types définis ci-dessus sont de façon générale toujours vrai. Cependant il peut exister quelques cas particuliers :

====Passage partiel en XPS====
Pour plusieurs raison, un client peut passer en XPS uniquement sur quelques documents. Voici quelques besoins pouvant nécessité cela :
#Simplifier la gestion des maquettes pour un document donné car celui-ci a trop de maquette (La maquette en XPS pouvant gérer tous les langages)
#Besoin de post traitement plus important pour un document :
##Fusion du document avec d'autres documents Mapping ou autres
##Conversion d'un flux vers un autre (PDF vers XPS et ensuite concaténation avec un autre document par exemple)
##Autres

====Utilisation de flux thermique (Zebra, TEC)====
Il est fortement conseillé par Mapping de passer les maquettes thermiques en XPS. Les raisons principales sont :
#Aperçu Designer et impression finale bien plus fiable en XPS qu'en natif
#XPS to TEC ou ZPL plus fiable et intuitif en XPS

==Phase de tests==
===Cas des tests exécutés de façon interactive===
Le principe est d'exécuter chaque commande manuellement pour chacun des spooled files et chacune des maquettes à tester.

===Cas des tests exécutés de façon automatiques===
Le principe est de déposer les spooled files d'entrée dans l'outq test d'entrée. Le robot récupèrera alors les spooled files et éxécutera les bonnes commandes paramétrées dans le robot Mapping.
Dans ce cas, il faut bien s'assurer que l'Outq d'entrée soit bien paramétrée et que l'imprimante par défaut soit bien renseigné dans les règles.

*Aller sur les règles utilisées pour tester et choisir l'imprimante de test (Option 14, 3 et 8)
*Copier les fichiers spool d'entrée du client un par un dans l'output queue Mapping monitorée et vérifier les résultats par rapport aux fichiers de référence.

== Validation==

La mise à niveau finale de l'environnement de production sera réalisée lorsque le client aura validé à l'écrit tous les documents.

==Passage en production==
Une fois la validation client réalisée, il est temps de passer en production. Le principe est de faire une autre installation et d'utiliser cette nouvelle bibliothèque comme bibliothèque de production. De ce fait, nous ne touchons pas à l'ancienne bibliothèque de production, ce qui pourrait être très utile en cas de besoin de retour arrière si un problème survient sur le nouvel environnement de production.

*Copier la bibliothèque de production MAP400 en MAPPRODCPY
*Lancer le setup de la nouvelle version en spécifiant MAP400_XX pour bibliothèque d'installation et MAPSRBT_XX (avec XX le numéro de version : 71,72 ou OP Exemple : MAP400_OP et MAPSRBT_OP)

ATTENTION : Ne pas laisser MAP400 par défaut

*Entrer les clefs d'activation du logiciel
*Copier les objets (règles, action et relations outqs) suivants de MAPPRODCPY vers MAP400_XX : OUTOUT, SPLMAP, ACTLIG et ACTION (voir procédure de copie d'objets ci-dessus)

ATTENTION : NE PAS FAIRE L ERREUR ENTRE MAP400 et MAP400_XX

*Copier les objets (Formats Designer) suivants de MAPPINGQUA vers MAP400_XX : MAPLNK, MAPLNKL1, MAPOBJ, MAP1, MAP2D, MAP2H, MAP3, MAP3L1, MAP (voir procédure de copie d'objets ci-dessus)

ATTENTION : NE PAS FAIRE L ERREUR ENTRE MAP400 et MAP400_XX

*Arrêter le sous-système de production MAPSROBOT
*Renommer l'ancienne bibliothèque MAP400 en MAP400OLD
*Démarrer le sous-système MAPSRBT_XX
*Lancer des traitements en mode production

==Retour arrière en cas de problème==

*Arrêter le sous-système MAPSRBT_XX
*Renommer la bibliothèque MAP400_XX en MAP400_KO
*Renommer la bibliothèque MAP400OLD en MAP400
*Redémarrer le sous-système MAPSROBOT (ancien sous-système)

Mapping tourne alors avec son ancienne version.

==Troubleshooting==
Problème 1 : Vous constatez un écart sur un document entre celui produit à l'aide de l'ancienne version (avant upgrade) et la nouvelle (après upgrade)

Solution : Consulter la marche à suivre ci-dessus selon le type d'upgrade choisi

-------------------------------------------------------------------------------------------------------------

Problème 2 : Les mails ne partent pas et le job MAPSMTP ne démarre pas

Solution : Vérifier le contenu de la dataq MAP400_XX :
DSPDTAQ DTAQ(MAP400_XX/MAPSMTP)

Si celle-ci contient des STOP, à ce moment-là, faire un
CLRDTAQ DTAQ(MAP400_XX/MAPSMTP)

Renvoyer les e-mails.

Problème 3 : Vérification que tout se soit bien passé lors de l'installation
Exécuter cette commande pour voir les messages d’installation :
DSPJOBLOG OUTPUT(*PRINT)

Autres points à vérifier :
* Lire le DSPJOBLOG à la fin du processus
* En cas de déconnexion, la commande SIGNOFF *LIST permet de récupérer les erreurs ou alertes d’installation

Pour vérifier les erreurs de restauration (objet verrouillé, mauvais propriétaire, etc.), exécuter la commande suivante dans STRSQL :
SELECT * FROM qtemp/RSTMAP400 WHERE RSOSTA = '0'

OPALE:10.0:Utilisation:Renvoi d'information : MAPRTVNFO

2019-05-15T11:43:03Z

Izarai :

Cette commande, appliquée sur un spool, crée deux '''DTAARA''' dans '''QTEMP''' :

* '''DATE''' contenant la date de création du spool
* '''TIME''' contenant l'heure de création du spool

La DTAARA '''DATE''' contient alors la date sous la forme 1AAMMJJ ou 0AAMMJJ où 1 correspond au 21ème siècle et 0 au 20ème, AA à l'année sur 2 chiffres, MM au mois

et JJ au jour (1010705 pour le 5 juillet 2001).

La DTAARA '''TIME''' contient alors l'heure sous la forme HHMMSS où HH correspond aux l'heure sur 2 chiffres, MM aux minutes et SS aux secondes (102046 pour

10h20m46s).

Couplée dans une même action à la commande MAPCPYSPLF, elle sert à récupérer en tant que critère d'archivage la date et l'heure de création du spool.

Voir à ce sujet : Comment faire pour [[OPALE:10.0:Utilisation: Récupérer en critère d'archivage la date du spool d'origine|récupérer en critère d'archivage la date du spool d'origine]]

OPALE:10.0:Utilisation:Charger les objets d'une imprimante : MAPRSTPRT

2019-05-15T09:56:27Z

Izarai :

Cette commande permet d'envoyer des objets d'un mapping dans une imprimante.

[[File:Sndmapprt1.PNG|600px|centré|sans_cadre]]

OPALE:10.0:Utilisation:Affichage du contenu d'une DTAQ : DSPDTAQ

2019-05-15T09:55:28Z

Izarai :

La commande DSPDTAQ permet d'afficher les messages contenus dans une DTAQ et en attente de traitement.

Pour le robot, chaque message correspond à un spool à traiter, le message contient les attributs de ce spool.

Les paramètres à renseigner sont les suivants :
Data queue
Librairie : bibliothèque de la Data Queue
Output format : *CHAR pour afficher les messages en mode caractère *HEX pour afficher les messages en mode hexadécimal

[[File:file1.PNG|594x594px|centré|sans_cadre]]

OPALE:10.0:Utilisation:Mise à jour des fichiers Mapping d'une autre bibliothèque : MAPUPDPF

2019-05-15T09:55:04Z

Izarai :

Cette commande est à utiliser si vous travaillez avec une ou plusieurs bibliothèques de fichiers différentes de MAP400.

En effet, le format des fichiers physiques de Mapping peut changer et vos bibliothèques de fichiers spécifiques ne sont pas mises à jour lors d'un changement de

version Mapping.

Cette commande se base sur les fichiers physiques de MAP400 pour modifier ceux d'autres bibliothèques.

[[File:MAPUPPDF.PNG|627x627px|centré|sans_cadre]]

OPALE:10.0:Utilisation: Gérer les relations entre Outq d'origine et Outq de destination

2019-05-15T09:53:02Z

Izarai :

Cette option permet de définir les Outqs gérées par le robot, et la destination par défaut des impressions (action pour lesquelles le paramètre Outq vaut *DFT).

Il faut déclarer ici la ou les Outq(s) dans lesquelles tombent des spools que le robot doit traiter. Pour chacune de celles-ci, définir l'Outq où sont dirigés les

spools après traitement.

Il est possible de définir une seule Outq de destination pour plusieurs Outqs d'origine. L'inverse est impossible.

Il faut rattacher à chaque Outq d'origine une Dtaq qui sera écoutée par le robot. L'intérêt de créer plusieurs DTAQ est nul, il est donc conseillé de rattacher toutes les Outq d'origine à une même DTAQ.

Remarque :

L'Outq de destination doit être différente de l'Outq d'origine.

OPALE:10.0:Utilisation:Ajout d'une Outq dans le gestionnaire de spool : MAPADDOUTQ

2019-05-15T09:24:56Z

Izarai :

Cette commande permet d'ajouter une Outq d'entrée dans le gestionnaire de spool sans passer par les options de menu. Elle est pratique dans le cas de nombreuses Outq à ajouter.

Voir [[OPALE:10.0:Utilisation: Gérer les relations entre Outq d'origine et Outq de destination|Gérer les relations entre Outq d'origine et Outq de destination]]

* Outq In : Outq d'entrée
* Library name : Bibliothèque de l'Outq d'entrée
* Outq Out b : Outq de sortie
* Library name : Bibliothèque de l'Outq de sortie
* Dataq Name : Nom de la DTAQ associée
* Library of Dtaq : Bibliothèque de la DTAQ associée

OPALE:10.0:Utilisation:Créer une nouvelle JOBD pour le robot : MAPCRTJOBD

2019-05-15T09:24:14Z

Izarai :

OPALE:10.0:Utilisation: Ajouter ou supprimer une bibliothèque: MAPRBTJOBD

2019-05-15T09:23:35Z

Izarai :

Cette commande permet d'ajouter ou de supprimer une bibliothèque de la liste des bibliothèques de toutes les JOBDs pour le sous-système '''MAPSROBOT'''.

Elle sert par exemple pour ajouter ou enlever une bibliothèque de test pour le robot.

[[File:Maprbtjobd.PNG|683x683px|centré|alt=|sans_cadre]]

OPALE:10.0:Utilisation: Ajouter ou supprimer une bibliothèque: MAPRBTJOBD

2019-05-15T09:23:12Z

Izarai :

M-PS Digitech Connector 7.2 fr

2019-05-15T09:14:09Z

Izarai : /* MISE EN ŒUVRE DANS LES WORKFLOWS */

==Prérequis et concept==

Ce guide décrit les procédures de paramétrage et d’utilisation du connecteur Digitech.

Le fonctionnement de ce connecteur est assuré avec M-Designer et M-Processing Server sur Windows ou Unix, en version 7.2 et suivantes.

Le principe du connecteur Digitech est de produire des flux PDF et XML en fonction des informations demandées par l’utilisateur, à destination de l’outil de GED édité par Digitech. Les informations exportées sont basées sur les métadonnées positionnées dans le modèle M-Designer et sur le contexte d’exécution du Workflow.

*Le PDF généré est à la norme PDF/A et il peut être signé et horodaté (certificat serveur)
*Le flux XML au format Digitech s’appuie sur un fichier modèle (ou patron) renseigné lors de la construction du Workflow.

Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED Digitech : l’apport des fichiers XML modèles et la définition du Workflow.

Ce guide s’adresse à un public maîtrisant la conception de modèles de documents avec M-Designer, et la mise en place de Workflow dans ONYX Server.

==Préparation de l'export : le fichier modèle==

L’export de document vers la solution de GED Digitech s’effectue au format XML, à partir d’un fichier d’exemple défini par l’utilisateur. Ce fichier contient :
*La classe d’objets, c’est-à-dire le modèle de données (1)
*Les métadonnées : ce sont les index positionnés dans la maquette M-Designer (2)
*Le lien vers le fichier à exporter au format PDF (3)

Figure 1 Un patron d'export, et les valeurs à renseigner.

Plusieurs fichiers XML patrons peuvent être nécessaires pour des appels dynamiques en fonction des types de documents à archiver. Ils devront être stockés localement dans un dossier du serveur hébergeant la solution ONYX Server. Le chemin de ce dossier est à renseigner dans le Menu d’Administration/Gestion de la configuration, sous une entrée PATH_CLASS_DIGITECH :

==Environnement de l 'exécution de l'export==

Dans un fichier XML patron, deux types de champs de remplacement sont distingués. Les premiers sont les champs de métadonnées, qui reprennent les valeurs des index positionnés dans M-Designer. Les autres données sont renseignées par le contexte d’exécution : paramètres du Workflow ou table de résolution.

Figure 2 Exemple de table de résolution pour la définition de champs lors d’un export Digitech

==Mise en œuvre dans les WORKFLOWS==

===Le fichier de sortie===

L’appel au connecteur Digitech est placé dans la section ‘XPS to Web Format’ :

La boîte reprend pour l’essentiel les onglets de l’export vers PDF. Pour l’exécution d’un export, seul le nom du PDF de sortie est spécifié par l’utilisateur. Le fichier XML aura au final le même nom que le fichier PDF (à l’extension près).

Dans cet exemple, la zone d’index NOMPDF est utilisée pour nommer dynamiquement le fichier PDF (et le XML rattaché). Pour chaque valeur distincte de l’index, un nouveau couple PDF/XML sera créé.

===Valeur des champs non METADONNEES===

L’onglet index de la boîte « To Digitech » sert à désigner le fichier XML patron à utiliser, et les valeurs de remplacement pour les champs suivants :
*<nowiki>[[DGT_TYPE_EDI]] </nowiki>le type d’édition (4)
*<nowiki>[[DGT_LIBELLE]] </nowiki>le libellé du document PDF dans l’outil de GED Digitech (6)

Par ailleurs, il servira à choisir le fichier patron XML approprié (5) parmi l’ensemble de ceux déposés dans le dossier [PATH_CLASS_DIGITECH].

Figure 3 Renseigner les champs d'export, appel à la table de résolution et paramètres du Workflow
Si le type d’édition n’est pas renseigné, la chaîne vide sera placée dans le fichier XML.
Si le libellé du document n’est pas renseigné, le nom du fichier physique sera placé dans le fichier XML.

Certaines valeurs dans le modèle d’export sont quant à elles remplacées par des valeurs prédéfinies. Ainsi <nowiki>[[DGT_PDF_PATH]</nowiki>] aura toujours pour valeur « . », et <nowiki>[[DGT_PDF_NAME]]</nowiki> aura automatiquement pour valeur le nom du fichier PDF.

Figure 4 Un fichier XML produit par l'export vers l'outil GED Digitech

M-PS Digitech Connector 7.2 fr

2019-05-15T09:13:26Z

Izarai : /* Valeur des champs non METADONNEES */

==Prérequis et concept==

Ce guide décrit les procédures de paramétrage et d’utilisation du connecteur Digitech.

Le fonctionnement de ce connecteur est assuré avec M-Designer et M-Processing Server sur Windows ou Unix, en version 7.2 et suivantes.

Le principe du connecteur Digitech est de produire des flux PDF et XML en fonction des informations demandées par l’utilisateur, à destination de l’outil de GED édité par Digitech. Les informations exportées sont basées sur les métadonnées positionnées dans le modèle M-Designer et sur le contexte d’exécution du Workflow.

*Le PDF généré est à la norme PDF/A et il peut être signé et horodaté (certificat serveur)
*Le flux XML au format Digitech s’appuie sur un fichier modèle (ou patron) renseigné lors de la construction du Workflow.

Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED Digitech : l’apport des fichiers XML modèles et la définition du Workflow.

Ce guide s’adresse à un public maîtrisant la conception de modèles de documents avec M-Designer, et la mise en place de Workflow dans ONYX Server.

==Préparation de l'export : le fichier modèle==

L’export de document vers la solution de GED Digitech s’effectue au format XML, à partir d’un fichier d’exemple défini par l’utilisateur. Ce fichier contient :
*La classe d’objets, c’est-à-dire le modèle de données (1)
*Les métadonnées : ce sont les index positionnés dans la maquette M-Designer (2)
*Le lien vers le fichier à exporter au format PDF (3)

Figure 1 Un patron d'export, et les valeurs à renseigner.

Plusieurs fichiers XML patrons peuvent être nécessaires pour des appels dynamiques en fonction des types de documents à archiver. Ils devront être stockés localement dans un dossier du serveur hébergeant la solution ONYX Server. Le chemin de ce dossier est à renseigner dans le Menu d’Administration/Gestion de la configuration, sous une entrée PATH_CLASS_DIGITECH :

==Environnement de l 'exécution de l'export==

Dans un fichier XML patron, deux types de champs de remplacement sont distingués. Les premiers sont les champs de métadonnées, qui reprennent les valeurs des index positionnés dans M-Designer. Les autres données sont renseignées par le contexte d’exécution : paramètres du Workflow ou table de résolution.

Figure 2 Exemple de table de résolution pour la définition de champs lors d’un export Digitech

==MISE EN ŒUVRE DANS LES WORKFLOWS==

===Le fichier de sortie===

L’appel au connecteur Digitech est placé dans la section ‘XPS to Web Format’ :

La boîte reprend pour l’essentiel les onglets de l’export vers PDF. Pour l’exécution d’un export, seul le nom du PDF de sortie est spécifié par l’utilisateur. Le fichier XML aura au final le même nom que le fichier PDF (à l’extension près).

Dans cet exemple, la zone d’index NOMPDF est utilisée pour nommer dynamiquement le fichier PDF (et le XML rattaché). Pour chaque valeur distincte de l’index, un nouveau couple PDF/XML sera créé.

===Valeur des champs non METADONNEES===

L’onglet index de la boîte « To Digitech » sert à désigner le fichier XML patron à utiliser, et les valeurs de remplacement pour les champs suivants :
*<nowiki>[[DGT_TYPE_EDI]] </nowiki>le type d’édition (4)
*<nowiki>[[DGT_LIBELLE]] </nowiki>le libellé du document PDF dans l’outil de GED Digitech (6)

Par ailleurs, il servira à choisir le fichier patron XML approprié (5) parmi l’ensemble de ceux déposés dans le dossier [PATH_CLASS_DIGITECH].

Figure 3 Renseigner les champs d'export, appel à la table de résolution et paramètres du Workflow
Si le type d’édition n’est pas renseigné, la chaîne vide sera placée dans le fichier XML.
Si le libellé du document n’est pas renseigné, le nom du fichier physique sera placé dans le fichier XML.

Certaines valeurs dans le modèle d’export sont quant à elles remplacées par des valeurs prédéfinies. Ainsi <nowiki>[[DGT_PDF_PATH]</nowiki>] aura toujours pour valeur « . », et <nowiki>[[DGT_PDF_NAME]]</nowiki> aura automatiquement pour valeur le nom du fichier PDF.

Figure 4 Un fichier XML produit par l'export vers l'outil GED Digitech

M-PS Digitech Connector 7.2 fr

2019-05-15T09:12:54Z

Izarai : /* Valeur des champs non METADONNEES */

==Prérequis et concept==

Ce guide décrit les procédures de paramétrage et d’utilisation du connecteur Digitech.

Le fonctionnement de ce connecteur est assuré avec M-Designer et M-Processing Server sur Windows ou Unix, en version 7.2 et suivantes.

Le principe du connecteur Digitech est de produire des flux PDF et XML en fonction des informations demandées par l’utilisateur, à destination de l’outil de GED édité par Digitech. Les informations exportées sont basées sur les métadonnées positionnées dans le modèle M-Designer et sur le contexte d’exécution du Workflow.

*Le PDF généré est à la norme PDF/A et il peut être signé et horodaté (certificat serveur)
*Le flux XML au format Digitech s’appuie sur un fichier modèle (ou patron) renseigné lors de la construction du Workflow.

Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED Digitech : l’apport des fichiers XML modèles et la définition du Workflow.

Ce guide s’adresse à un public maîtrisant la conception de modèles de documents avec M-Designer, et la mise en place de Workflow dans ONYX Server.

==Préparation de l'export : le fichier modèle==

L’export de document vers la solution de GED Digitech s’effectue au format XML, à partir d’un fichier d’exemple défini par l’utilisateur. Ce fichier contient :
*La classe d’objets, c’est-à-dire le modèle de données (1)
*Les métadonnées : ce sont les index positionnés dans la maquette M-Designer (2)
*Le lien vers le fichier à exporter au format PDF (3)

Figure 1 Un patron d'export, et les valeurs à renseigner.

Plusieurs fichiers XML patrons peuvent être nécessaires pour des appels dynamiques en fonction des types de documents à archiver. Ils devront être stockés localement dans un dossier du serveur hébergeant la solution ONYX Server. Le chemin de ce dossier est à renseigner dans le Menu d’Administration/Gestion de la configuration, sous une entrée PATH_CLASS_DIGITECH :

==Environnement de l 'exécution de l'export==

Dans un fichier XML patron, deux types de champs de remplacement sont distingués. Les premiers sont les champs de métadonnées, qui reprennent les valeurs des index positionnés dans M-Designer. Les autres données sont renseignées par le contexte d’exécution : paramètres du Workflow ou table de résolution.

Figure 2 Exemple de table de résolution pour la définition de champs lors d’un export Digitech

==MISE EN ŒUVRE DANS LES WORKFLOWS==

===Le fichier de sortie===

L’appel au connecteur Digitech est placé dans la section ‘XPS to Web Format’ :

La boîte reprend pour l’essentiel les onglets de l’export vers PDF. Pour l’exécution d’un export, seul le nom du PDF de sortie est spécifié par l’utilisateur. Le fichier XML aura au final le même nom que le fichier PDF (à l’extension près).

Dans cet exemple, la zone d’index NOMPDF est utilisée pour nommer dynamiquement le fichier PDF (et le XML rattaché). Pour chaque valeur distincte de l’index, un nouveau couple PDF/XML sera créé.

===Valeur des champs non METADONNEES===

L’onglet index de la boîte « To Digitech » sert à désigner le fichier XML patron à utiliser, et les valeurs de remplacement pour les champs suivants :
*<nowiki>[[DGT_TYPE_EDI]] </nowiki>le type d’édition (4)
*<nowiki>[[DGT_LIBELLE]] </nowiki>le libellé du document PDF dans l’outil de GED Digitech (6)

Par ailleurs, il servira à choisir le fichier patron XML approprié (5) parmi l’ensemble de ceux déposés dans le dossier [PATH_CLASS_DIGITECH].

Figure 3 Renseigner les champs d'export, appel à la table de résolution et paramètres du Workflow
Si le type d’édition n’est pas renseigné, la chaîne vide sera placée dans le fichier XML.
Si le libellé du document n’est pas renseigné, le nom du fichier physique sera placé dans le fichier XML.

Certaines valeurs dans le modèle d’export sont quant à elles remplacées par des valeurs prédéfinies. Ainsi [[DGT_PDF_PATH]] aura toujours pour valeur « . », et [[DGT_PDF_NAME]] aura automatiquement pour valeur le nom du fichier PDF.

Figure 4 Un fichier XML produit par l'export vers l'outil GED Digitech

M-PS Digitech Connector 7.2 fr

2019-05-15T09:11:47Z

Izarai :

==Prérequis et concept==

Ce guide décrit les procédures de paramétrage et d’utilisation du connecteur Digitech.

Le fonctionnement de ce connecteur est assuré avec M-Designer et M-Processing Server sur Windows ou Unix, en version 7.2 et suivantes.

Le principe du connecteur Digitech est de produire des flux PDF et XML en fonction des informations demandées par l’utilisateur, à destination de l’outil de GED édité par Digitech. Les informations exportées sont basées sur les métadonnées positionnées dans le modèle M-Designer et sur le contexte d’exécution du Workflow.

*Le PDF généré est à la norme PDF/A et il peut être signé et horodaté (certificat serveur)
*Le flux XML au format Digitech s’appuie sur un fichier modèle (ou patron) renseigné lors de la construction du Workflow.

Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED Digitech : l’apport des fichiers XML modèles et la définition du Workflow.

Ce guide s’adresse à un public maîtrisant la conception de modèles de documents avec M-Designer, et la mise en place de Workflow dans ONYX Server.

==Préparation de l'export : le fichier modèle==

L’export de document vers la solution de GED Digitech s’effectue au format XML, à partir d’un fichier d’exemple défini par l’utilisateur. Ce fichier contient :
*La classe d’objets, c’est-à-dire le modèle de données (1)
*Les métadonnées : ce sont les index positionnés dans la maquette M-Designer (2)
*Le lien vers le fichier à exporter au format PDF (3)

Figure 1 Un patron d'export, et les valeurs à renseigner.

Plusieurs fichiers XML patrons peuvent être nécessaires pour des appels dynamiques en fonction des types de documents à archiver. Ils devront être stockés localement dans un dossier du serveur hébergeant la solution ONYX Server. Le chemin de ce dossier est à renseigner dans le Menu d’Administration/Gestion de la configuration, sous une entrée PATH_CLASS_DIGITECH :

==Environnement de l 'exécution de l'export==

Dans un fichier XML patron, deux types de champs de remplacement sont distingués. Les premiers sont les champs de métadonnées, qui reprennent les valeurs des index positionnés dans M-Designer. Les autres données sont renseignées par le contexte d’exécution : paramètres du Workflow ou table de résolution.

Figure 2 Exemple de table de résolution pour la définition de champs lors d’un export Digitech

==MISE EN ŒUVRE DANS LES WORKFLOWS==

===Le fichier de sortie===

L’appel au connecteur Digitech est placé dans la section ‘XPS to Web Format’ :

La boîte reprend pour l’essentiel les onglets de l’export vers PDF. Pour l’exécution d’un export, seul le nom du PDF de sortie est spécifié par l’utilisateur. Le fichier XML aura au final le même nom que le fichier PDF (à l’extension près).

Dans cet exemple, la zone d’index NOMPDF est utilisée pour nommer dynamiquement le fichier PDF (et le XML rattaché). Pour chaque valeur distincte de l’index, un nouveau couple PDF/XML sera créé.

===Valeur des champs non METADONNEES===

L’onglet index de la boîte « To Digitech » sert à désigner le fichier XML patron à utiliser, et les valeurs de remplacement pour les champs suivants :
*[[DGT_TYPE_EDI]] le type d’édition (4)
*[[DGT_LIBELLE]] le libellé du document PDF dans l’outil de GED Digitech (6)

Par ailleurs, il servira à choisir le fichier patron XML approprié (5) parmi l’ensemble de ceux déposés dans le dossier [PATH_CLASS_DIGITECH].

Figure 3 Renseigner les champs d'export, appel à la table de résolution et paramètres du Workflow
Si le type d’édition n’est pas renseigné, la chaîne vide sera placée dans le fichier XML.
Si le libellé du document n’est pas renseigné, le nom du fichier physique sera placé dans le fichier XML.

Certaines valeurs dans le modèle d’export sont quant à elles remplacées par des valeurs prédéfinies. Ainsi [[DGT_PDF_PATH]] aura toujours pour valeur « . », et [[DGT_PDF_NAME]] aura automatiquement pour valeur le nom du fichier PDF.

Figure 4 Un fichier XML produit par l'export vers l'outil GED Digitech

M-PS Digitech Connector 7.2 fr

2019-05-15T09:10:38Z

Izarai :

==Prérequis et concept==

Ce guide décrit les procédures de paramétrage et d’utilisation du connecteur Digitech.

Le fonctionnement de ce connecteur est assuré avec M-Designer et M-Processing Server sur Windows ou Unix, en version 7.2 et suivantes.

Le principe du connecteur Digitech est de produire des flux PDF et XML en fonction des informations demandées par l’utilisateur, à destination de l’outil de GED édité par Digitech. Les informations exportées sont basées sur les métadonnées positionnées dans le modèle M-Designer et sur le contexte d’exécution du Workflow.

*Le PDF généré est à la norme PDF/A et il peut être signé et horodaté (certificat serveur)
*Le flux XML au format Digitech s’appuie sur un fichier modèle (ou patron) renseigné lors de la construction du Workflow.

Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED Digitech : l’apport des fichiers XML modèles et la définition du Workflow.

Ce guide s’adresse à un public maîtrisant la conception de modèles de documents avec M-Designer, et la mise en place de Workflow dans M-Processing Server.

==Préparation de l'export : le fichier modèle==

L’export de document vers la solution de GED Digitech s’effectue au format XML, à partir d’un fichier d’exemple défini par l’utilisateur. Ce fichier contient :
*La classe d’objets, c’est-à-dire le modèle de données (1)
*Les métadonnées : ce sont les index positionnés dans la maquette M-Designer (2)
*Le lien vers le fichier à exporter au format PDF (3)

Figure 1 Un patron d'export, et les valeurs à renseigner.

Plusieurs fichiers XML patrons peuvent être nécessaires pour des appels dynamiques en fonction des types de documents à archiver. Ils devront être stockés localement dans un dossier du serveur hébergeant la solution M-Processing Server. Le chemin de ce dossier est à renseigner dans le Menu d’Administration/Gestion de la configuration, sous une entrée PATH_CLASS_DIGITECH :

==Environnement de l 'exécution de l'export==

Dans un fichier XML patron, deux types de champs de remplacement sont distingués. Les premiers sont les champs de métadonnées, qui reprennent les valeurs des index positionnés dans M-Designer. Les autres données sont renseignées par le contexte d’exécution : paramètres du Workflow ou table de résolution.

Figure 2 Exemple de table de résolution pour la définition de champs lors d’un export Digitech

==MISE EN ŒUVRE DANS LES WORKFLOWS==

===Le fichier de sortie===

L’appel au connecteur Digitech est placé dans la section ‘XPS to Web Format’ :

La boîte reprend pour l’essentiel les onglets de l’export vers PDF. Pour l’exécution d’un export, seul le nom du PDF de sortie est spécifié par l’utilisateur. Le fichier XML aura au final le même nom que le fichier PDF (à l’extension près).

Dans cet exemple, la zone d’index NOMPDF est utilisée pour nommer dynamiquement le fichier PDF (et le XML rattaché). Pour chaque valeur distincte de l’index, un nouveau couple PDF/XML sera créé.

===Valeur des champs non METADONNEES===

L’onglet index de la boîte « To Digitech » sert à désigner le fichier XML patron à utiliser, et les valeurs de remplacement pour les champs suivants :
*[[DGT_TYPE_EDI]] le type d’édition (4)
*[[DGT_LIBELLE]] le libellé du document PDF dans l’outil de GED Digitech (6)

Par ailleurs, il servira à choisir le fichier patron XML approprié (5) parmi l’ensemble de ceux déposés dans le dossier [PATH_CLASS_DIGITECH].

Figure 3 Renseigner les champs d'export, appel à la table de résolution et paramètres du Workflow
Si le type d’édition n’est pas renseigné, la chaîne vide sera placée dans le fichier XML.
Si le libellé du document n’est pas renseigné, le nom du fichier physique sera placé dans le fichier XML.

Certaines valeurs dans le modèle d’export sont quant à elles remplacées par des valeurs prédéfinies. Ainsi [[DGT_PDF_PATH]] aura toujours pour valeur « . », et [[DGT_PDF_NAME]] aura automatiquement pour valeur le nom du fichier PDF.

Figure 4 Un fichier XML produit par l'export vers l'outil GED Digitech

OPALE:10.0:Utilisation:La commande MAP XPS

2019-05-15T09:05:57Z

Izarai : /* Ajout de critères d’indexation au document */

==Introduction==

La commande MAP_XPS est l'une des commandes principales d'OPALE Server. Elle permet d'effectuer un nombre important de traitements listés ci-dessous.

Dans un traitement typique, le fichier à maquetter est d'abord produit au format XPS via la commande MAPCPYSPLF, puis la commande MAP_XPS prend le relais pour effectuer les traitements souhaités sur le fichier XPS.

[[File:Xps-intro.PNG|200px|center|sans_cadre]]

Pour utiliser la commande MAP_XPS, il faut passer par un <code> CALL PGM(MAP_XPS) PARM ('-infile:/home/map2019/file.PDF' '-outfile:/home/map2019/file.xps' '-toXPS' '-fromPDF') </code>

La commande MAPXPS (sans underscore) existe également. Elle possède moins de fonctionnalités et permet de réaliser principalement des conversions. Par contre, il faut d'abord charger la bibliothèque en question.

==Conversions de fichiers==
=== Conversion de documents en entrée ===

Le principe est de convertir des documents existants au format XPS, en vue de leur prise en charge et de leurs traitements futurs dans Mapping.

Les langages d’entrée supportés sont : AFP, ESCP, IGP, Image (BMP, JPG, PCX, PNG et TIFF), PCL, PDF, PS, SCS, TXT, Xerox, XPS, ZEBRA (ou ZPL), TEC

Exemples :
map_xps -infile:/home/map2019/email.pcl -fromPCL -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/email.pdf -fromPDF -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/email.afp -fromAFP -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/email.igp -fromIGP -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/email.zpl -fromZPL -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/email.ps -fromPS -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/image.jpg -fromImage -outfile:/home/map2019/image.xps -toXPS -profile:fromJPEG

Ce principe de conversion peut en outre être affiné en utilisant un profil défini dans le fichier de configuration.

[[File:Mapxps entree.PNG|600px|center|sans_cadre]]

=== Conversion des fichiers XPS vers un format de sortie ===

Le principe est de convertir des fichiers XPS (générés ou non par Mapping) en vue de leur diffusion finale (impression, envoi par mail, archivage…) et en fonction de leur canal de diffusion.

Les langages de sortie supportés sont : AFP, BMP, DOCX, DPL, EPL, ESC, ESCP, HTML, IGP, JPG, Monarch, PCL, PDF, PNG, ProPrinter, PS, RTF, TEC, TIF, TXT, XMLDRAW, XPS, ZEBRA / ZPL.

Exemples :
map_xps -infile:/home/map2019/email.xps -toPCL -outfile:/home/map2019/email.pcl
map_xps -infile:/home/map2019/email.xps -toPDF -outfile:/home/map2019/email.pdf

[[File:MAP_XPS.PNG|600px|center|sans_cadre]]

Ce principe de conversion peut en outre être affiné en utilisant un profil défini dans le fichier de configuration.

Exemple :
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –convert –config:MYPDF

[[File:Mapxps-profil.PNG|600px|center|sans_cadre]]

Avec les paramètres :
<code>-config:XXXX</code> ou <code>-profile:XXXX</code> => sélection du profil à utiliser pour la conversion
<code>-convert</code> => force la conversion en utilisant le profil sélectionné

Et un profil MYPDF défini dans le fichier de configuration :
<MYPDF>
<label>for Adobe Reader</label>
<language>PDF</language>
<embeddedfont>OFF</embeddedfont>
<color>ON</color>
</MYPDF>

Pour appeler un profil de conversion en ligne de commande, le langage doit être à <code>*AUTO</code> sur iSeries, et ne doit pas être "forcé" sur Unix ou Windows (pas d’utilisation simultanée des arguments <code>-profile:XXX</code> et <code>-toPCL</code> par exemple).

Remarque :

Sur iSeries, le fichier XPSConfig.conf se trouve dans le dossier home/mapping.

=== Paramètres spécifiques pour la sortie AFPDS ===

En complément de la conversion XPS vers AFPDS, il est possible de forcer la résolution des polices et des images :
-fontRes:300 : résolution des polices
-imageRes:300 : résolution des images

Valeurs supportées : 240, 300 ou 600 dpi.

=== Utilisation des paramètres de profils ===

Tous les paramètres mentionnés et expliqués dans les conversions (entrée ou sortie) sont également utilisables en ligne de commande. Pour cela, la syntaxe suivante devra être ajoutée à la commande map_xps de conversion :
-param:nom_du_paramètre=valeur

Exemple :
map_xps -infile:/home/map2019/label.xps -outfile:/home/map2019/label.zpl -toZPL -param:resolution=203 -param:barcode=off

===Gestion des critères d’indexation===
==== Lister les index disponibles et leurs valeurs ====

Pour lister tous les critères d’indexation présents dans le document

Exemple :
map_xps -infile:/home/map2019/email.xps -dumpIndex

[[File:Mapxps-index.PNG|600px|center|sans_cadre]]

Pour lister toutes les valeurs d’un index présent dans le document Indexation d’un document

Exemple :
map_xps -infile:/home/map2019/email.xps –dumpIndex:CUSTOMER

====Ajout d’une valeur d’index sur toutes les pages d’un document====

Dans certains cas, il se peut qu’un critère d’indexation soit bien présent sur toutes les pages, mais sans valeur pour certaines pages, ou bien que le critère d’indexation ne soit pas présent sur toutes les pages. La commande suivante permet alors de réindexer le document en copiant, pour les pages sans valeur d’index, la valeur de l’index se trouvant sur la page précédente.

Exemple :
map_xps -infile:/home/map2019/email.xps –copyEmptyIndex:INVOICE

Fichier avant passage de la commande :
Page Index Valeur
1 INVOICE 1
2

3 INVOICE 2
4 INVOICE 3
5

Fichier après passage de la commande :
Page Index Valeur
1 INVOICE 1
2 INVOICE 1
3 INVOICE 2
4 INVOICE 3
5 INVOICE 3

==Ajout de critères d’indexation au document==

Le principe est d’indexer un document en ajoutant un ou plusieurs critères.

Les valeurs de chaque critère peuvent être précisées en clair sur la ligne de commande : toutes les pages du document auront alors la même valeur d’index.

Exemple :
map_xps -infile:/home/map2019/email.xps -addCriteria:NUMORDER=123456

[[File:Mapxps-criteria.PNG|600px|center|sans_cadre]]

Plus généralement, les valeurs d’un index seront issues d’une extraction préalable d’informations contenues dans le document lui-même, et stockées dans un fichier texte temporaire (consulter ci-après). La syntaxe précédente doit utiliser le mot clé « FILE: » pour spécifier que les valeurs de l’index ajouté doivent être reprises du fichier créé précédemment.

Exemple :
map_xps -infile:/home/map2019/email.xps -addCriteria:NUMORDER=FILE:/home/map2019/email.txt [ –outfile:/home/map201/email_indexed.xps]

==Extraction de valeurs de critères du document==

Le principe est de rechercher des informations contenues dans le document et de les extraire dans un fichier temporaire, pour ensuite les ajouter comme valeurs d’un critère d’indexation du même document. Le fichier temporaire créé est au format texte, en Unicode, avec la syntaxe suivante : "valeur[TAB]page[CRLF]"

La collecte des informations dans le document peut se faire par mot clé ou par position.

Les informations retournées peuvent être nettoyées des espaces superflus avant et/ou après le texte, avec les paramètres suivants :
-ltrim : suppression des espaces avant le texte
-rtrim : suppression des espaces après le texte
-trim : suppression des espaces avant et après le texte

Exemple 1 : recherche par mot clé
map_xps -infile:/home/map2019/email.xps -extract:/home/map2019/email.txt
"-filter:Invoice for order" -length:10 –shift:2 -rtrim

Extraction de 10 caractères, situés 2 caractères après le mot clé "Invoice for order", en supprimant les espaces superflus après le texte retourné

Exemple 2 : recherche par position
map_xps -infile:/home/map2019/email.xps -extract:/home/map2019/email.txt "-box:100,150,180,30,mm"

Les paramètres de la « box » précisent ses dimensions. La syntaxe est : xx.xx,xx.xx,xx.xx,xx.xx[,cm|in|mm]

4 nombres décimaux, spécifiant dans l’ordre : top (haut), bottom (bas), left (gauche), right (droite)

Le séparateur de décimale est le ‘.’

Le séparateur de valeurs est ‘,’ ou ‘;’

Le dernier paramètre est l’unité de ces coordonnées : en point (pour une résolution de 96dpi) par défaut, en millimètre (mm), en centimètre (cm) ou en pouce (in).

==Exporter les index et leurs valeurs==

Le principe est la création d’un fichier d’index à partir d’un document, en vue de son archivage dans un logiciel tiers. Le fichier d’index peut être au format TXT, XML, ou IND (compatible Content Manager).

Le paramètre « -duplicateindex » permet d’exporter également les index dont la valeur est la même sur plusieurs pages.

Exemples :
map_xps -infile:/home/map2019/mail.xps -indexfile:/home/map2019/file.txt –toXPS [-duplicateindex]
map_xps -infile:/home/map2019/email.xps -indexfile:/home/map2019/file.xml -toXPS [-duplicateindex]
map_xps -infile:/home/map2019/email.xps -indexfile:/home/map2019/file.ind -toXPS [-duplicateindex]

[[File:Mapxps-exportxml.PNG|600px|center|sans_cadre]]

==Utilisation des critères d’indexation==
=== Trier un document ===

Le principe est de trier un document suivant les valeurs d’un ou plusieurs critères d’indexation. Un seul fichier sera créé en sortie. Le tri s’effectue par ordre croissant sur des valeurs numériques par défaut. L’utilisation de l’option ALPHA permet de réaliser un tri sur des valeurs alphanumériques, l’option REVERSE permet un tri par ordre décroissant.

Exemples :
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –sort:CUSTNBR -toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –sort:ALPHA:MAPSEND -toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –sort:CUSTNBR,INV_NBR -toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -sort:CUSTNBR,REVERSE:INV_NBR -toPDF

[[File:Mapxps-trie.PNG|600px|center|sans_cadre]]

=== Éclater un document ===
Le principe est d’éclater un document suivant les valeurs d’un ou plusieurs critères d’indexation. Autant de fichiers peuvent être créés en sortie qu’il y a de valeurs différentes du ou des critères utilisés.

Exemple :
<nowiki>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email_[[MAPSEND]].pdf –toPDF</nowiki>

[[File:Mapxps-eclater.PNG|600px|center|sans_cadre]]

Le mode BUNDLEONINDEX permet de créer des lots en fonction du nombre de pages pour chaque valeur de critère (par exemple : 1 fichier avec les documents de 1 à 4 pages, 1 fichier pour les documents de 5 à 9 pages, un fichier pour les documents de plus de 10 pages). Il est possible de créer autant de lots que souhaité.

Exemple :
<nowiki>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email_[[BUNDDLEONINDEX,MAPSEND,1,5,10]].pdf –toPDF</nowiki>

En mode BUNDLEONINDEX, l’éclatement peut également se faire suivant un nombre de feuilles (en fonction des informations de recto/verso ou non), la syntaxe devient :

<nowiki>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email_[[BUNDDLEONINDEX=LEAF,MAPSEND,1,5,10]].pdf –toPDF</nowiki>

=== Filtres sur des valeurs de critères ===
Le principe est "d’isoler" certaines pages d’un document en fonction des valeurs d’un ou plusieurs critères d’indexation. Cela peut servir notamment pour créer un document en sortie ne concernant que certains clients.

Exemples :
<code>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -toPDF –filter:CUSTOMER=426</code>
<code>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -toPDF "-filter:(CUSTOMER=4026) OR (CUSTOMER=1458) AND (PRICE=15)"</code>

Cela peut également s’avérer très utile pour n’effectuer des actions que sur certaines pages, dépendant de valeurs de critères (notamment la gestion des PrintTickets).

==Concaténer des fichiers XPS==
Le principe est d’ajouter plusieurs documents les uns à la suite des autres. Le document de sortie est la concaténation de tous les fichiers précisés sur la ligne de commande, dans l’ordre où ils ont été précisés.

On peut ensuite imaginer un tri suivant des critères d’indexation préalablement définis sur chaque
fichier pour faire du regroupement de fichiers de plusieurs sources différentes (facture + CGV + lettre d’information…)

Exemples :

Concaténation de plusieurs fichiers XPS en une seule fois :
map_xps -outfile:/home/map2019/final.xps -add:/home/map2019/test1.xps -add:/home/map2019/test2.xps –add:/home/map2019/test3.xps

Concaténation en plusieurs fois, dans le cas où l’on ne connait pas d’avance le nombre de fichiers XPS en entrée :
map_xps -tempfile:/home/map2019/final.xps -add:/home/map2019/test1.xps
map_xps -tempfile:/home/map2019/final.xps -add:/home/map2019/test2.xps
map_xps -tempfile:/home/map2019/final.xps -add:/home/map2019/test3.xps

==Gestion des PrintTickets==

Le principe est de gérer les différents paramètres d’un travail d’impression pour un document, soit au niveau travail complet, soit à la page.

La syntaxe générale est :
map_xps -infile:/home/map2019/email.xps -set:NOM=VALEUR

L’option « -filter:XXX » permet de n’affecter un attribut d’impression que sur certaines pages, en fonction de valeurs d’indexation du document.

Les différents attributs "PrintTicket" reconnus sont :

DUPLEX : gestion du recto/verso
* yes/no : recto/verso en suivant les bords longs, ou recto seul
* long/short/F : recto/verso en suivant les bords longs ou courts, ou recto seul

FRONTSIDE (on/off): force l’impression sur le recto (en sortie PCL uniquement, en combinaison avec les options -filter:XXX et -pages:*)

INPUTBIN / OUTPUTBIN (valeur numérique) : gestion des bacs d’entrée/sortie
* ORIENTATION (valeur numérique)
* 0: Portrait
* 1: Landscape (paysage)
* 2: ReversePortrait (portrait retourné/inversé) 3: ReverseLandscape (paysage retourné/inversé)

COPY (valeur numérique) : nombre de copies

STAPLE (valeur numérique) : agrafage
* 1 = SaddleStitch (agrafage au milieu de la feuille)
* 2 = StapleBottomLeft (agrafage en bas à gauche)
* 3 = StapleBottomRight (agrafage en bas à droite)
* 4 = StapleDualBottom (agrafage en bas)
* 5 = StapleDualLeft (agrafage à gauche)
* 6 = StapleDualRight (agrafage à droite)
* 7 = StapleDualTop (agrafage en haut)
* 8 = StapleTopLeft (agrafage en haut à gauche)
* 9 = StapleTopRight (agrafage en bas à droite)
* 10 = None (stopper l’agrafage)

MEDIATYPE (valeur alphabétique) : type de papier Exemples : Archive, Etiquette, Bristol, AutoSelect…

NUP (valeur numérique : 1, 2 ou 4) : regroupement de 1, 2 ou 4 pages du document initial sur 1 page en sortie

LEFTOFFSET : marge de gauche en points

TOPOFFSET : marge supérieure en points

JOBCUT : yes/no. Commande de rupture de job (pour utiliser le cutter sur les imprimantes possédant le dispositif)

TOGGLE : yes/no. Commande de décalage du papier.

Remarque :

Tous ces différents paramètres devront ensuite être gérés dans des profils de conversion du fichier XPSConfig.conf, en fonction de la destination finale des documents.Il est également possible d’utiliser ces paramètres lors d’une conversion directe sans passer par le -set : -duplex:LONG au lieu de -set:DUPLEX=LONG.

Exemples :
*Pour paramétrer le recto/verso sur un fichier XPS existant :
map_xps -infile:/home/map2019/myfile.xps -set:DUPLEX=yes
*Pour paramétrer le recto uniquement sur un fichier XPS existant :
map_xps -infile:/home/map2019/myfile.xps -set:DUPLEX=no
*Pour gérer les PrintTickets au niveau page :
map_xps -infile:/home/map2019/email.xps -set:INPUTBIN=2 -pages:2,3
*Pour paramétrer le recto sur la première page et recto/verso sur les suivantes :
map_xps -infile:/home/map2019/myfile.xps -set:DUPLEX=yes
map_xps -infile:/home/map2019/myfile.xps -set:DUPLEX=no -pages:1

==Envoyer un email==
Principe : en sortie des traitements effectués par la commande map_xps, envoi direct du fichier résultant par email.

Paramètres obligatoires :
-toEmail | -toMail
-server:XXX => serveur SMTP
-from:XXX => expéditeur
-to:XXX => destinataire(s)
-infile:XXX => fichier XPS à joindre à l’email envoyé

Paramètres optionnels (le caractère optionnel ou non de certains arguments listés ci-après peut dépendre du serveur SMTP adressé) :
-domain:mydomain.net => domaine du serveur SMTP
-port:25 => port du serveur SMTP
-login:username => identifiant de connexion au serveur SMTP
-passwd:******* => mot de passé de connexion au serveur SMTP
-cc:XXX => destinataire(s) en copie
-bcc:XXX => destinataire(s) en copie cachée
"-subject:This is my subject" => sujet du message
"-body:This is my body" => corps du message au format texte
-bodyhtml:XXX => corps du message au format HTML
-bodyhtml:FILE:/home/izaopale/bodyhtml.html
-footer:XXX => Pied de page du mail au format texte
-footerhtml:XXX => Pied de page du mail au format HTML
-footerhtml:FILE=/home/izaopale/footer.html
-attachment:XXX => ajout de pièce(s) jointe(s) supplémentaire(s), séparées par une virgule
-outfile:XXX => dans le cas de l’envoi d’email, cet argument sert à nommer la pièce jointe principale (argument infile) envoyée

Exemple 1 :
<code>map_xps -infile:/home/map2019/fichier.xps -toMail -from:XXX -to:XXX -login:XXX -passwd:XXX -server:XXX "-subject:Test envoi email" "-body:Ceci est un test" -outfile:nomPJ.xps</code>

Exemple 2 : avec ajout de 2 pièces jointes
<code>map_xps -infile:/home/map2019/fichier.xps -toMail -from:XXX -to:XXX -login:XXX -passwd:XXX -server:XXX "-subject:Test envoi email" "-body:Ceci est un test" -outfile:nomPJ.xps -attachment:/home/izaopale/PJ1.pdf,/home/izaopale/PJ2.pdf</code>

Exemple 3 : avec conversion en PDF de la pièce jointe
<code>map_xps -infile:/home/map2019/fichier.xps -toMail -from:XXX -to:XXX -login:XXX -passwd:XXX -server:XXX "-subject:Test envoi email" "-body:Ceci est un test" -toPDF -outfile:nomPJ.pdf</code>

==Maquettage avec sortie imprimée – Redirection dans une OUTQ==

Maquettage du document et conversion implicite / explicite en sortie

Les langages de sortie supportés lors d’un MAPCPYSPLF sont les suivants : o Paramètre TYPLAN :

*PCL
*AFPDS
*ZEBRA
*DATAMAX
*AUTO
*IGP
*TEC
*IPL
*F_D
*PDF
*EPL
*XPS

La valeur spéciale *AUTO reprend la valeur du paramètre saisi dans l’option 1 du Menu Mapping.

Dans ce cas, si *AUTO est spécifié dans le paramètre TYPLAN de la commande, le logiciel utilisera les maquettes développées en langage PCL.

o Paramètre XPSCONVERT :

Valeur Remarque
*AUTO Valeur du 14/14 - Paramètre PROFILE
Valeur de
profil Celui spécifié dans le XPSConfig.conf

La valeur spéciale *AUTO permet de récupérer le nom de profil de l’imprimante qui est paramétré dans l’option Définition des paramètres imprimantes de Menu d’exploitation.

Exemple de définition:

Ici, pour toutes les imprimantes, le profil *PCL est spécifié. Ce qui permet par exemple, de ne pas avoir à spécifier le nom de toutes les Outq / Devices du système si les imprimantes physiques sont des Laser.

Ce nom de profil doit être paramétré dans le fichier XPSConfig.conf (situé dans l’IFS, sous la racine du répertoire MAPPING).

Un fichier de configuration par défaut est installé avec les valeurs suivantes :

<xpsconfig>
## This file contains the conversion profile for Mapping.
## You can create your own profile based on the Mapping documentation. BE CAREFUL WITH THE FILE STRUCTURE.
## PROFILE NAME STARTING WITH * ARE RESERVED FOR MAPPING. SO DO NOT CREATE OR MODIFY A PROFILE STARTING WITH *.
<*XPS>
<label>DO NOT MODIFY - standard XPS</label>
<language>XPS</language>
</*XPS>
<*PCL>
<label>DO NOT MODIFY - standard PCL5/e</label>
<language>PCL</language>
<color>off</color>
</*PCL>

Dans cet exemple, le profil *PCL utilise le langage PCL (paramètre <language> du profil.

Exemple de commandes pour sortie imprimée

Exemple de commande :
MAPCPYSPLF SPLF(SPOOL) SPLNUM(7) JOB(QPADEV003K) JOBNUM(062592) USER(XXX)
MAPNAM(INVOICEXPS) MAPSEQ(00010) OUTQ(PCLPRT) TYPLAN(*XPS) XPSCONVERT(*AUTO)

Explications:

TYPLAN :
Pour positionner le langage de la maquette.
Mais ce paramètre accepte aussi la valeur *AUTO : Auquel cas, le programme récupère la valeur positionnée dans le menu Mapping/Option 1.

XPSCONVERT :
Conversion implicite réalisée en sortie. Ici, avec *AUTO le profil utilisé est celui qui est paramétré dans l’option 6 dans le menu Exploitation.

Autre exemple de commande :

MAPCPYSPLF SPLF(SPOOL) SPLNUM(7) JOB(QPADEV003K) JOBNUM(062592) USER(XXX)
MAPNAM(INVOICEXPS) MAPSEQ(00010) OUTQ(PCLPRT) TYPLAN(*XPS) XPSCONVERT(*PCL)

Explications :

XPSCONVERT : Conversion explicite réalisée en sortie. Ici, avec *PCL, c’est le profil *PCL du fichier XPSConfig.conf qui sera utilisé.

''' Maquettage avec sortie fichier dans l’IFS''' /'''Maquettage du document avec conversion et stockage dans l’IFS'''

Les mêmes commandes peuvent être utilisées afin de placer le résultat du maquettage et de la conversion dans un dossier de l’IFS. Il suffit pour cela de renseigner le paramètre XPSOUTFILE.
En effet, la valeur par défaut de XPSOUTFILE est à *PRINT, pour ne pas générer de sortie fichier.

Exemple :

MAPCPYSPLF SPLF(SPOOL) SPLNUM(7) JOB(QPADEV003K) JOBNUM(062592) USER(XXX)
MAPNAM(INVOICEXPS) MAPSEQ(00010) OUTQ(PCLPRT) TYPLAN(*XPS) XPSCONVERT(*PCL) XPSOUTFILE(‘/home/map2019/invoice.pcl’)

==Rediriger la log dans un fichier==

Principe : récupérer toutes les logs des commandes map_xps dans un fichier texte.

Exemple :
map_xps -infile:/home/map2019/email.xps –logfile:/tmp/mylog.log

[[File:Mapxps-log.PNG|600px|center|sans_cadre]]

==Lister les ressources==
Principe : affichage de toutes les ressources (polices et images) embarquées dans un fichier XPS.

Exemple :
map_xps -infile:/home/map2019/email.xps –listResource

[[File:Mapxps-listerR.PNG|600px|center|sans_cadre]]

==Extraction de pages==

Principe : définir des intervalles et/ou des sélections de pages à traiter. Les intervalles de pages sont à préciser sur la ligne de commande, les sélections peuvent être dans un fichier texte, où la syntaxe est : numéro de page+CRLF. L’utilisation du caractère ‘*’ est possible pour les intervalles de pages, pour choisir la fin du document.

Exemples :
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:1,3,4,7,10 –toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:3-10 –toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:1,5,10-* –toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:FILE:/home/map2019/test.txt –toPDF

==Extraction des données en XML (pour M-Designer)==

Principe : créer un fichier XML compatible pour M-Designer, dans lequel toutes les données textes du fichier XPS sont extraites. Chaque zone de texte dans le fichier XPS devient un champ XML, nommé de manière unique par ses positions en X et Y. Les positions X et Y sont définies en 72 dpi.

Ce mode est aussi utilisé pour créer un fichier XML servant de base à l’ajout de [[OPALE:10.0:Utilisation:Gestion des codes OMR|codes OMR]].

Exemple :
map_xps -infile:/home/map2019/billing.xps –toXMLDRAW -outfile:/home/map2019/billing.draw.xml

[[File:Mapxps-d-xml.PNG|500px|center|sans_cadre]]

==Format et taille des pages d’un document :==

Pour modifier la taille des pages du document, ou la taille des données à l’intérieur d’une page, il existe 3 arguments de la ligne de commande, ayant chacun leur fonctionnel :
<code>-paper:XXX : permet de changer la taille du papier (de la page), sans toucher au contenu.</code>
<code>-scale:XXX : permet de changer la taille du contenu, sans toucher au papier.</code>
<code>-changeformat:XXX : permet de changer le format du document, en modifiant la taille du papier tout en adaptant en contenu (avec conservation des proportions).</code>

Syntaxes

Pour une mise à l’échelle du contenu d’une page, l’argument « -scale:XXX » prend des valeurs de pourcentage, de 0 à l'infini (attention aux pertes de données avec des valeurs supérieures à 100, puisque la taille du papier n’est pas modifiée).

Pour modifier la taille de la page en sortie, avec modification ou non du contenu, les arguments « - changeformat:XXX » et « -paper:XXX » permettent de définir la taille du format, soit à la norme ISO, soit en personnalisé.

Valeurs possibles ISO : AUTO, EXECUTIVE, LETTER, LEGAL, LEDGER, A4, A3, A2, A1, A0, MONARCH, COM10, DL, CS, B5
Syntaxe pour taille personnalisée : -changeformat:xx.xx,xx.xx[,cm|in|mm]
2 valeurs décimales correspondant respectivement à largeur et hauteur Le séparateur de décimale est le ‘.’
Le séparateur de valeurs est ‘,’ ou ‘;’

L’unité est optionnelle : cm (par défaut), mm ou in (pour inch) Exemples :

map_xps -infile:/home/map2019/billing.xps –scale:50 -outfile:/home/izaopale/out.xps
map_xps -infile:/home/map2019/billing.xps –changeformat:A4 -outfile:/home/izaopale/out.xps
map_xps -infile:/home/map2019/billing.xps –changeformat:21,29.7,cm -outfile:/home/izaopale/out.xps

==Rotation de documents==

Principe : effectuer une rotation sur un fichier XPS

L’angle de rotation (en degré) est précisé sur la ligne de commande, le sens de rotation par défaut étant le sens trigonométrique (anti horaire). Sur le principe, tous les angles sont supportés, mais seuls les angles droits respectent la cohérence des dimensions de la page d’origine.

D’où les valeurs supportées suivantes : -90 (rotation de 90° dans le sens horaire), 90, 180, 270.
Notes : les valeurs -180 et -270 ne sont pas supportées (page blanche en sortie), il convient d’utiliser respectivement 180 et 90.

[[File:Mapxps-rotate.png|600px|center|sans_cadre]]

Exemple :
map_xps -infile:/home/map2019/fichier.xps -outfile:/home/map2019/fichier_90.xps –rotation:90 -toXPS

==Fusion d’un fond de page sur un document existant==

Principe : sur un document XPS existant, il est possible de venir rajouter un autre document en tant que fond de page, ou calque. Par exemple : ajouter un logo sur une facture existante n’en comportant pas.

De plus, l’argument optionnel « -mergemode:XXX » permet de contrôler plus finement la manière dont est rajouté ce calque.

Exemple :
<code> map_xps -infile:/home/map2019/billing.xps -merge:/home/map2019/logo.xps -mergemode:REPEATALL -outfile:/home/map2019/final.xps </code>

[[Fichier:Mapxps-fusion.png|centré|734x734px|sans_cadre]]

L’argument « -merge:XXX » précise le nom du fichier à ajouter en tant que calque sur le document d’entrée. L’argument « -mergemode:XXX » précise la méthode d’ajout:

REPEATALL : toutes les pages sont fusionnées, en répétant le calque jusqu’à la fin du fichier d’entrée. C’est le fonctionnement par défaut si rien n’est précisé.

Exemple :
* En entrée : fichier d’entrée de 5 pages (identifiées par 1,2,3,4,5) et un calque de 2 pages (identifiées a,b)
* En sortie : un fichier de 5 pages identifiées 1a,2b,3a,4b,5a

REPEATFULL : toutes les pages sont fusionnées, en répétant le calque tant qu’il peut être inséré entièrement.

Exemple :
* Avec les mêmes entrées que précédemment, on aura en sortie un fichier de 5 pages identifiées 1a,2b,3a,4b,5 (la dernière page n’étant donc pas modifiée).

ONCE : le calque n’est inséré qu’une seule fois, sur la ou les premières pages du fichier d’entrée.

Exemple :
* Avec les mêmes entrées que précédemment, on aura en sortie un fichier de 5 pages identifiées 1a,2b,3,4,5.

Variable d’environnement exportée

MAP_XPSFILE : contient le nom du fichier en cours d’extraction.

==Gestion des input box==

Le nom de la zone input text doit être « SUBMIT ».
-param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost?

map_xps -infile:/tmp/form_vide.xps -outfile:/tmp/test.pdf -toPDF
-param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost?

map_xps -infile:/tmp/form_vide.xps -outfile:/tmp/test.html -toHTML
-param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost?

Avec envoi d’e-mail :

<code>map_xps -infile:/tmp/form_vide.xps -outfile:/tmp/test.html -toHTML</code>
<code>-param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost? -toMail -from:exp@mydomain.net -to:dest@mydomain.net</code>
<code>-subject:form -server:192.168.1.2 -domain:mydomain.net</code>

OPALE:10.0:Utilisation:La commande MAP XPS

2019-05-15T09:04:53Z

Izarai : /* Ajout de critères d’indexation au document */

==Introduction==

La commande MAP_XPS est l'une des commandes principales d'OPALE Server. Elle permet d'effectuer un nombre important de traitements listés ci-dessous.

Dans un traitement typique, le fichier à maquetter est d'abord produit au format XPS via la commande MAPCPYSPLF, puis la commande MAP_XPS prend le relais pour effectuer les traitements souhaités sur le fichier XPS.

[[File:Xps-intro.PNG|200px|center|sans_cadre]]

Pour utiliser la commande MAP_XPS, il faut passer par un <code> CALL PGM(MAP_XPS) PARM ('-infile:/home/map2019/file.PDF' '-outfile:/home/map2019/file.xps' '-toXPS' '-fromPDF') </code>

La commande MAPXPS (sans underscore) existe également. Elle possède moins de fonctionnalités et permet de réaliser principalement des conversions. Par contre, il faut d'abord charger la bibliothèque en question.

==Conversions de fichiers==
=== Conversion de documents en entrée ===

Le principe est de convertir des documents existants au format XPS, en vue de leur prise en charge et de leurs traitements futurs dans Mapping.

Les langages d’entrée supportés sont : AFP, ESCP, IGP, Image (BMP, JPG, PCX, PNG et TIFF), PCL, PDF, PS, SCS, TXT, Xerox, XPS, ZEBRA (ou ZPL), TEC

Exemples :
map_xps -infile:/home/map2019/email.pcl -fromPCL -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/email.pdf -fromPDF -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/email.afp -fromAFP -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/email.igp -fromIGP -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/email.zpl -fromZPL -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/email.ps -fromPS -outfile:/home/map2019/email.xps -toXPS
map_xps -infile:/home/map2019/image.jpg -fromImage -outfile:/home/map2019/image.xps -toXPS -profile:fromJPEG

Ce principe de conversion peut en outre être affiné en utilisant un profil défini dans le fichier de configuration.

[[File:Mapxps entree.PNG|600px|center|sans_cadre]]

=== Conversion des fichiers XPS vers un format de sortie ===

Le principe est de convertir des fichiers XPS (générés ou non par Mapping) en vue de leur diffusion finale (impression, envoi par mail, archivage…) et en fonction de leur canal de diffusion.

Les langages de sortie supportés sont : AFP, BMP, DOCX, DPL, EPL, ESC, ESCP, HTML, IGP, JPG, Monarch, PCL, PDF, PNG, ProPrinter, PS, RTF, TEC, TIF, TXT, XMLDRAW, XPS, ZEBRA / ZPL.

Exemples :
map_xps -infile:/home/map2019/email.xps -toPCL -outfile:/home/map2019/email.pcl
map_xps -infile:/home/map2019/email.xps -toPDF -outfile:/home/map2019/email.pdf

[[File:MAP_XPS.PNG|600px|center|sans_cadre]]

Ce principe de conversion peut en outre être affiné en utilisant un profil défini dans le fichier de configuration.

Exemple :
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –convert –config:MYPDF

[[File:Mapxps-profil.PNG|600px|center|sans_cadre]]

Avec les paramètres :
<code>-config:XXXX</code> ou <code>-profile:XXXX</code> => sélection du profil à utiliser pour la conversion
<code>-convert</code> => force la conversion en utilisant le profil sélectionné

Et un profil MYPDF défini dans le fichier de configuration :
<MYPDF>
<label>for Adobe Reader</label>
<language>PDF</language>
<embeddedfont>OFF</embeddedfont>
<color>ON</color>
</MYPDF>

Pour appeler un profil de conversion en ligne de commande, le langage doit être à <code>*AUTO</code> sur iSeries, et ne doit pas être "forcé" sur Unix ou Windows (pas d’utilisation simultanée des arguments <code>-profile:XXX</code> et <code>-toPCL</code> par exemple).

Remarque :

Sur iSeries, le fichier XPSConfig.conf se trouve dans le dossier home/mapping.

=== Paramètres spécifiques pour la sortie AFPDS ===

En complément de la conversion XPS vers AFPDS, il est possible de forcer la résolution des polices et des images :
-fontRes:300 : résolution des polices
-imageRes:300 : résolution des images

Valeurs supportées : 240, 300 ou 600 dpi.

=== Utilisation des paramètres de profils ===

Tous les paramètres mentionnés et expliqués dans les conversions (entrée ou sortie) sont également utilisables en ligne de commande. Pour cela, la syntaxe suivante devra être ajoutée à la commande map_xps de conversion :
-param:nom_du_paramètre=valeur

Exemple :
map_xps -infile:/home/map2019/label.xps -outfile:/home/map2019/label.zpl -toZPL -param:resolution=203 -param:barcode=off

===Gestion des critères d’indexation===
==== Lister les index disponibles et leurs valeurs ====

Pour lister tous les critères d’indexation présents dans le document

Exemple :
map_xps -infile:/home/map2019/email.xps -dumpIndex

[[File:Mapxps-index.PNG|600px|center|sans_cadre]]

Pour lister toutes les valeurs d’un index présent dans le document Indexation d’un document

Exemple :
map_xps -infile:/home/map2019/email.xps –dumpIndex:CUSTOMER

====Ajout d’une valeur d’index sur toutes les pages d’un document====

Dans certains cas, il se peut qu’un critère d’indexation soit bien présent sur toutes les pages, mais sans valeur pour certaines pages, ou bien que le critère d’indexation ne soit pas présent sur toutes les pages. La commande suivante permet alors de réindexer le document en copiant, pour les pages sans valeur d’index, la valeur de l’index se trouvant sur la page précédente.

Exemple :
map_xps -infile:/home/map2019/email.xps –copyEmptyIndex:INVOICE

Fichier avant passage de la commande :
Page Index Valeur
1 INVOICE 1
2

3 INVOICE 2
4 INVOICE 3
5

Fichier après passage de la commande :
Page Index Valeur
1 INVOICE 1
2 INVOICE 1
3 INVOICE 2
4 INVOICE 3
5 INVOICE 3

==Ajout de critères d’indexation au document==

Le principe est d’indexer un document en ajoutant un ou plusieurs critères.

Les valeurs de chaque critère peuvent être précisées en clair sur la ligne de commande : toutes les pages du document auront alors la même valeur d’index.

Exemple :
map_xps -infile:/home/map2019/email.xps -addCriteria:NUMORDER=123456

[[File:Mapxps-criteria.PNG|600px|center|sans_cadre]]

Plus généralement, les valeurs d’un index seront issues d’une extraction préalable d’informations contenues dans le document lui-même, et stockées dans un fichier texte temporaire (consulter ci-après). La syntaxe précédente doit utiliser le mot clé « FILE: » pour spécifier que les valeurs de l’index ajouté doivent être reprises du fichier créé précédemment.

Exemple :
map_xps -infile:/home/map2019/email.xps -addCriteria:NUMORDER=FILE:/home/map2019/email.txt
[ –outfile:/home/map201/email_indexed.xps]

==Extraction de valeurs de critères du document==

Le principe est de rechercher des informations contenues dans le document et de les extraire dans un fichier temporaire, pour ensuite les ajouter comme valeurs d’un critère d’indexation du même document. Le fichier temporaire créé est au format texte, en Unicode, avec la syntaxe suivante : "valeur[TAB]page[CRLF]"

La collecte des informations dans le document peut se faire par mot clé ou par position.

Les informations retournées peuvent être nettoyées des espaces superflus avant et/ou après le texte, avec les paramètres suivants :
-ltrim : suppression des espaces avant le texte
-rtrim : suppression des espaces après le texte
-trim : suppression des espaces avant et après le texte

Exemple 1 : recherche par mot clé
map_xps -infile:/home/map2019/email.xps -extract:/home/map2019/email.txt
"-filter:Invoice for order" -length:10 –shift:2 -rtrim

Extraction de 10 caractères, situés 2 caractères après le mot clé "Invoice for order", en supprimant les espaces superflus après le texte retourné

Exemple 2 : recherche par position
map_xps -infile:/home/map2019/email.xps -extract:/home/map2019/email.txt "-box:100,150,180,30,mm"

Les paramètres de la « box » précisent ses dimensions. La syntaxe est : xx.xx,xx.xx,xx.xx,xx.xx[,cm|in|mm]

4 nombres décimaux, spécifiant dans l’ordre : top (haut), bottom (bas), left (gauche), right (droite)

Le séparateur de décimale est le ‘.’

Le séparateur de valeurs est ‘,’ ou ‘;’

Le dernier paramètre est l’unité de ces coordonnées : en point (pour une résolution de 96dpi) par défaut, en millimètre (mm), en centimètre (cm) ou en pouce (in).

==Exporter les index et leurs valeurs==

Le principe est la création d’un fichier d’index à partir d’un document, en vue de son archivage dans un logiciel tiers. Le fichier d’index peut être au format TXT, XML, ou IND (compatible Content Manager).

Le paramètre « -duplicateindex » permet d’exporter également les index dont la valeur est la même sur plusieurs pages.

Exemples :
map_xps -infile:/home/map2019/mail.xps -indexfile:/home/map2019/file.txt –toXPS [-duplicateindex]
map_xps -infile:/home/map2019/email.xps -indexfile:/home/map2019/file.xml -toXPS [-duplicateindex]
map_xps -infile:/home/map2019/email.xps -indexfile:/home/map2019/file.ind -toXPS [-duplicateindex]

[[File:Mapxps-exportxml.PNG|600px|center|sans_cadre]]

==Utilisation des critères d’indexation==
=== Trier un document ===

Le principe est de trier un document suivant les valeurs d’un ou plusieurs critères d’indexation. Un seul fichier sera créé en sortie. Le tri s’effectue par ordre croissant sur des valeurs numériques par défaut. L’utilisation de l’option ALPHA permet de réaliser un tri sur des valeurs alphanumériques, l’option REVERSE permet un tri par ordre décroissant.

Exemples :
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –sort:CUSTNBR -toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –sort:ALPHA:MAPSEND -toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf –sort:CUSTNBR,INV_NBR -toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -sort:CUSTNBR,REVERSE:INV_NBR -toPDF

[[File:Mapxps-trie.PNG|600px|center|sans_cadre]]

=== Éclater un document ===
Le principe est d’éclater un document suivant les valeurs d’un ou plusieurs critères d’indexation. Autant de fichiers peuvent être créés en sortie qu’il y a de valeurs différentes du ou des critères utilisés.

Exemple :
<nowiki>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email_[[MAPSEND]].pdf –toPDF</nowiki>

[[File:Mapxps-eclater.PNG|600px|center|sans_cadre]]

Le mode BUNDLEONINDEX permet de créer des lots en fonction du nombre de pages pour chaque valeur de critère (par exemple : 1 fichier avec les documents de 1 à 4 pages, 1 fichier pour les documents de 5 à 9 pages, un fichier pour les documents de plus de 10 pages). Il est possible de créer autant de lots que souhaité.

Exemple :
<nowiki>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email_[[BUNDDLEONINDEX,MAPSEND,1,5,10]].pdf –toPDF</nowiki>

En mode BUNDLEONINDEX, l’éclatement peut également se faire suivant un nombre de feuilles (en fonction des informations de recto/verso ou non), la syntaxe devient :

<nowiki>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email_[[BUNDDLEONINDEX=LEAF,MAPSEND,1,5,10]].pdf –toPDF</nowiki>

=== Filtres sur des valeurs de critères ===
Le principe est "d’isoler" certaines pages d’un document en fonction des valeurs d’un ou plusieurs critères d’indexation. Cela peut servir notamment pour créer un document en sortie ne concernant que certains clients.

Exemples :
<code>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -toPDF –filter:CUSTOMER=426</code>
<code>map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -toPDF "-filter:(CUSTOMER=4026) OR (CUSTOMER=1458) AND (PRICE=15)"</code>

Cela peut également s’avérer très utile pour n’effectuer des actions que sur certaines pages, dépendant de valeurs de critères (notamment la gestion des PrintTickets).

==Concaténer des fichiers XPS==
Le principe est d’ajouter plusieurs documents les uns à la suite des autres. Le document de sortie est la concaténation de tous les fichiers précisés sur la ligne de commande, dans l’ordre où ils ont été précisés.

On peut ensuite imaginer un tri suivant des critères d’indexation préalablement définis sur chaque
fichier pour faire du regroupement de fichiers de plusieurs sources différentes (facture + CGV + lettre d’information…)

Exemples :

Concaténation de plusieurs fichiers XPS en une seule fois :
map_xps -outfile:/home/map2019/final.xps -add:/home/map2019/test1.xps -add:/home/map2019/test2.xps –add:/home/map2019/test3.xps

Concaténation en plusieurs fois, dans le cas où l’on ne connait pas d’avance le nombre de fichiers XPS en entrée :
map_xps -tempfile:/home/map2019/final.xps -add:/home/map2019/test1.xps
map_xps -tempfile:/home/map2019/final.xps -add:/home/map2019/test2.xps
map_xps -tempfile:/home/map2019/final.xps -add:/home/map2019/test3.xps

==Gestion des PrintTickets==

Le principe est de gérer les différents paramètres d’un travail d’impression pour un document, soit au niveau travail complet, soit à la page.

La syntaxe générale est :
map_xps -infile:/home/map2019/email.xps -set:NOM=VALEUR

L’option « -filter:XXX » permet de n’affecter un attribut d’impression que sur certaines pages, en fonction de valeurs d’indexation du document.

Les différents attributs "PrintTicket" reconnus sont :

DUPLEX : gestion du recto/verso
* yes/no : recto/verso en suivant les bords longs, ou recto seul
* long/short/F : recto/verso en suivant les bords longs ou courts, ou recto seul

FRONTSIDE (on/off): force l’impression sur le recto (en sortie PCL uniquement, en combinaison avec les options -filter:XXX et -pages:*)

INPUTBIN / OUTPUTBIN (valeur numérique) : gestion des bacs d’entrée/sortie
* ORIENTATION (valeur numérique)
* 0: Portrait
* 1: Landscape (paysage)
* 2: ReversePortrait (portrait retourné/inversé) 3: ReverseLandscape (paysage retourné/inversé)

COPY (valeur numérique) : nombre de copies

STAPLE (valeur numérique) : agrafage
* 1 = SaddleStitch (agrafage au milieu de la feuille)
* 2 = StapleBottomLeft (agrafage en bas à gauche)
* 3 = StapleBottomRight (agrafage en bas à droite)
* 4 = StapleDualBottom (agrafage en bas)
* 5 = StapleDualLeft (agrafage à gauche)
* 6 = StapleDualRight (agrafage à droite)
* 7 = StapleDualTop (agrafage en haut)
* 8 = StapleTopLeft (agrafage en haut à gauche)
* 9 = StapleTopRight (agrafage en bas à droite)
* 10 = None (stopper l’agrafage)

MEDIATYPE (valeur alphabétique) : type de papier Exemples : Archive, Etiquette, Bristol, AutoSelect…

NUP (valeur numérique : 1, 2 ou 4) : regroupement de 1, 2 ou 4 pages du document initial sur 1 page en sortie

LEFTOFFSET : marge de gauche en points

TOPOFFSET : marge supérieure en points

JOBCUT : yes/no. Commande de rupture de job (pour utiliser le cutter sur les imprimantes possédant le dispositif)

TOGGLE : yes/no. Commande de décalage du papier.

Remarque :

Tous ces différents paramètres devront ensuite être gérés dans des profils de conversion du fichier XPSConfig.conf, en fonction de la destination finale des documents.Il est également possible d’utiliser ces paramètres lors d’une conversion directe sans passer par le -set : -duplex:LONG au lieu de -set:DUPLEX=LONG.

Exemples :
*Pour paramétrer le recto/verso sur un fichier XPS existant :
map_xps -infile:/home/map2019/myfile.xps -set:DUPLEX=yes
*Pour paramétrer le recto uniquement sur un fichier XPS existant :
map_xps -infile:/home/map2019/myfile.xps -set:DUPLEX=no
*Pour gérer les PrintTickets au niveau page :
map_xps -infile:/home/map2019/email.xps -set:INPUTBIN=2 -pages:2,3
*Pour paramétrer le recto sur la première page et recto/verso sur les suivantes :
map_xps -infile:/home/map2019/myfile.xps -set:DUPLEX=yes
map_xps -infile:/home/map2019/myfile.xps -set:DUPLEX=no -pages:1

==Envoyer un email==
Principe : en sortie des traitements effectués par la commande map_xps, envoi direct du fichier résultant par email.

Paramètres obligatoires :
-toEmail | -toMail
-server:XXX => serveur SMTP
-from:XXX => expéditeur
-to:XXX => destinataire(s)
-infile:XXX => fichier XPS à joindre à l’email envoyé

Paramètres optionnels (le caractère optionnel ou non de certains arguments listés ci-après peut dépendre du serveur SMTP adressé) :
-domain:mydomain.net => domaine du serveur SMTP
-port:25 => port du serveur SMTP
-login:username => identifiant de connexion au serveur SMTP
-passwd:******* => mot de passé de connexion au serveur SMTP
-cc:XXX => destinataire(s) en copie
-bcc:XXX => destinataire(s) en copie cachée
"-subject:This is my subject" => sujet du message
"-body:This is my body" => corps du message au format texte
-bodyhtml:XXX => corps du message au format HTML
-bodyhtml:FILE:/home/izaopale/bodyhtml.html
-footer:XXX => Pied de page du mail au format texte
-footerhtml:XXX => Pied de page du mail au format HTML
-footerhtml:FILE=/home/izaopale/footer.html
-attachment:XXX => ajout de pièce(s) jointe(s) supplémentaire(s), séparées par une virgule
-outfile:XXX => dans le cas de l’envoi d’email, cet argument sert à nommer la pièce jointe principale (argument infile) envoyée

Exemple 1 :
<code>map_xps -infile:/home/map2019/fichier.xps -toMail -from:XXX -to:XXX -login:XXX -passwd:XXX -server:XXX "-subject:Test envoi email" "-body:Ceci est un test" -outfile:nomPJ.xps</code>

Exemple 2 : avec ajout de 2 pièces jointes
<code>map_xps -infile:/home/map2019/fichier.xps -toMail -from:XXX -to:XXX -login:XXX -passwd:XXX -server:XXX "-subject:Test envoi email" "-body:Ceci est un test" -outfile:nomPJ.xps -attachment:/home/izaopale/PJ1.pdf,/home/izaopale/PJ2.pdf</code>

Exemple 3 : avec conversion en PDF de la pièce jointe
<code>map_xps -infile:/home/map2019/fichier.xps -toMail -from:XXX -to:XXX -login:XXX -passwd:XXX -server:XXX "-subject:Test envoi email" "-body:Ceci est un test" -toPDF -outfile:nomPJ.pdf</code>

==Maquettage avec sortie imprimée – Redirection dans une OUTQ==

Maquettage du document et conversion implicite / explicite en sortie

Les langages de sortie supportés lors d’un MAPCPYSPLF sont les suivants : o Paramètre TYPLAN :

*PCL
*AFPDS
*ZEBRA
*DATAMAX
*AUTO
*IGP
*TEC
*IPL
*F_D
*PDF
*EPL
*XPS

La valeur spéciale *AUTO reprend la valeur du paramètre saisi dans l’option 1 du Menu Mapping.

Dans ce cas, si *AUTO est spécifié dans le paramètre TYPLAN de la commande, le logiciel utilisera les maquettes développées en langage PCL.

o Paramètre XPSCONVERT :

Valeur Remarque
*AUTO Valeur du 14/14 - Paramètre PROFILE
Valeur de
profil Celui spécifié dans le XPSConfig.conf

La valeur spéciale *AUTO permet de récupérer le nom de profil de l’imprimante qui est paramétré dans l’option Définition des paramètres imprimantes de Menu d’exploitation.

Exemple de définition:

Ici, pour toutes les imprimantes, le profil *PCL est spécifié. Ce qui permet par exemple, de ne pas avoir à spécifier le nom de toutes les Outq / Devices du système si les imprimantes physiques sont des Laser.

Ce nom de profil doit être paramétré dans le fichier XPSConfig.conf (situé dans l’IFS, sous la racine du répertoire MAPPING).

Un fichier de configuration par défaut est installé avec les valeurs suivantes :

<xpsconfig>
## This file contains the conversion profile for Mapping.
## You can create your own profile based on the Mapping documentation. BE CAREFUL WITH THE FILE STRUCTURE.
## PROFILE NAME STARTING WITH * ARE RESERVED FOR MAPPING. SO DO NOT CREATE OR MODIFY A PROFILE STARTING WITH *.
<*XPS>
<label>DO NOT MODIFY - standard XPS</label>
<language>XPS</language>
</*XPS>
<*PCL>
<label>DO NOT MODIFY - standard PCL5/e</label>
<language>PCL</language>
<color>off</color>
</*PCL>

Dans cet exemple, le profil *PCL utilise le langage PCL (paramètre <language> du profil.

Exemple de commandes pour sortie imprimée

Exemple de commande :
MAPCPYSPLF SPLF(SPOOL) SPLNUM(7) JOB(QPADEV003K) JOBNUM(062592) USER(XXX)
MAPNAM(INVOICEXPS) MAPSEQ(00010) OUTQ(PCLPRT) TYPLAN(*XPS) XPSCONVERT(*AUTO)

Explications:

TYPLAN :
Pour positionner le langage de la maquette.
Mais ce paramètre accepte aussi la valeur *AUTO : Auquel cas, le programme récupère la valeur positionnée dans le menu Mapping/Option 1.

XPSCONVERT :
Conversion implicite réalisée en sortie. Ici, avec *AUTO le profil utilisé est celui qui est paramétré dans l’option 6 dans le menu Exploitation.

Autre exemple de commande :

MAPCPYSPLF SPLF(SPOOL) SPLNUM(7) JOB(QPADEV003K) JOBNUM(062592) USER(XXX)
MAPNAM(INVOICEXPS) MAPSEQ(00010) OUTQ(PCLPRT) TYPLAN(*XPS) XPSCONVERT(*PCL)

Explications :

XPSCONVERT : Conversion explicite réalisée en sortie. Ici, avec *PCL, c’est le profil *PCL du fichier XPSConfig.conf qui sera utilisé.

''' Maquettage avec sortie fichier dans l’IFS''' /'''Maquettage du document avec conversion et stockage dans l’IFS'''

Les mêmes commandes peuvent être utilisées afin de placer le résultat du maquettage et de la conversion dans un dossier de l’IFS. Il suffit pour cela de renseigner le paramètre XPSOUTFILE.
En effet, la valeur par défaut de XPSOUTFILE est à *PRINT, pour ne pas générer de sortie fichier.

Exemple :

MAPCPYSPLF SPLF(SPOOL) SPLNUM(7) JOB(QPADEV003K) JOBNUM(062592) USER(XXX)
MAPNAM(INVOICEXPS) MAPSEQ(00010) OUTQ(PCLPRT) TYPLAN(*XPS) XPSCONVERT(*PCL) XPSOUTFILE(‘/home/map2019/invoice.pcl’)

==Rediriger la log dans un fichier==

Principe : récupérer toutes les logs des commandes map_xps dans un fichier texte.

Exemple :
map_xps -infile:/home/map2019/email.xps –logfile:/tmp/mylog.log

[[File:Mapxps-log.PNG|600px|center|sans_cadre]]

==Lister les ressources==
Principe : affichage de toutes les ressources (polices et images) embarquées dans un fichier XPS.

Exemple :
map_xps -infile:/home/map2019/email.xps –listResource

[[File:Mapxps-listerR.PNG|600px|center|sans_cadre]]

==Extraction de pages==

Principe : définir des intervalles et/ou des sélections de pages à traiter. Les intervalles de pages sont à préciser sur la ligne de commande, les sélections peuvent être dans un fichier texte, où la syntaxe est : numéro de page+CRLF. L’utilisation du caractère ‘*’ est possible pour les intervalles de pages, pour choisir la fin du document.

Exemples :
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:1,3,4,7,10 –toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:3-10 –toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:1,5,10-* –toPDF
map_xps -infile:/home/map2019/email.xps -outfile:/home/map2019/email.pdf -pages:FILE:/home/map2019/test.txt –toPDF

==Extraction des données en XML (pour M-Designer)==

Principe : créer un fichier XML compatible pour M-Designer, dans lequel toutes les données textes du fichier XPS sont extraites. Chaque zone de texte dans le fichier XPS devient un champ XML, nommé de manière unique par ses positions en X et Y. Les positions X et Y sont définies en 72 dpi.

Ce mode est aussi utilisé pour créer un fichier XML servant de base à l’ajout de [[OPALE:10.0:Utilisation:Gestion des codes OMR|codes OMR]].

Exemple :
map_xps -infile:/home/map2019/billing.xps –toXMLDRAW -outfile:/home/map2019/billing.draw.xml

[[File:Mapxps-d-xml.PNG|500px|center|sans_cadre]]

==Format et taille des pages d’un document :==

Pour modifier la taille des pages du document, ou la taille des données à l’intérieur d’une page, il existe 3 arguments de la ligne de commande, ayant chacun leur fonctionnel :
<code>-paper:XXX : permet de changer la taille du papier (de la page), sans toucher au contenu.</code>
<code>-scale:XXX : permet de changer la taille du contenu, sans toucher au papier.</code>
<code>-changeformat:XXX : permet de changer le format du document, en modifiant la taille du papier tout en adaptant en contenu (avec conservation des proportions).</code>

Syntaxes

Pour une mise à l’échelle du contenu d’une page, l’argument « -scale:XXX » prend des valeurs de pourcentage, de 0 à l'infini (attention aux pertes de données avec des valeurs supérieures à 100, puisque la taille du papier n’est pas modifiée).

Pour modifier la taille de la page en sortie, avec modification ou non du contenu, les arguments « - changeformat:XXX » et « -paper:XXX » permettent de définir la taille du format, soit à la norme ISO, soit en personnalisé.

Valeurs possibles ISO : AUTO, EXECUTIVE, LETTER, LEGAL, LEDGER, A4, A3, A2, A1, A0, MONARCH, COM10, DL, CS, B5
Syntaxe pour taille personnalisée : -changeformat:xx.xx,xx.xx[,cm|in|mm]
2 valeurs décimales correspondant respectivement à largeur et hauteur Le séparateur de décimale est le ‘.’
Le séparateur de valeurs est ‘,’ ou ‘;’

L’unité est optionnelle : cm (par défaut), mm ou in (pour inch) Exemples :

map_xps -infile:/home/map2019/billing.xps –scale:50 -outfile:/home/izaopale/out.xps
map_xps -infile:/home/map2019/billing.xps –changeformat:A4 -outfile:/home/izaopale/out.xps
map_xps -infile:/home/map2019/billing.xps –changeformat:21,29.7,cm -outfile:/home/izaopale/out.xps

==Rotation de documents==

Principe : effectuer une rotation sur un fichier XPS

L’angle de rotation (en degré) est précisé sur la ligne de commande, le sens de rotation par défaut étant le sens trigonométrique (anti horaire). Sur le principe, tous les angles sont supportés, mais seuls les angles droits respectent la cohérence des dimensions de la page d’origine.

D’où les valeurs supportées suivantes : -90 (rotation de 90° dans le sens horaire), 90, 180, 270.
Notes : les valeurs -180 et -270 ne sont pas supportées (page blanche en sortie), il convient d’utiliser respectivement 180 et 90.

[[File:Mapxps-rotate.png|600px|center|sans_cadre]]

Exemple :
map_xps -infile:/home/map2019/fichier.xps -outfile:/home/map2019/fichier_90.xps –rotation:90 -toXPS

==Fusion d’un fond de page sur un document existant==

Principe : sur un document XPS existant, il est possible de venir rajouter un autre document en tant que fond de page, ou calque. Par exemple : ajouter un logo sur une facture existante n’en comportant pas.

De plus, l’argument optionnel « -mergemode:XXX » permet de contrôler plus finement la manière dont est rajouté ce calque.

Exemple :
<code> map_xps -infile:/home/map2019/billing.xps -merge:/home/map2019/logo.xps -mergemode:REPEATALL -outfile:/home/map2019/final.xps </code>

[[Fichier:Mapxps-fusion.png|centré|734x734px|sans_cadre]]

L’argument « -merge:XXX » précise le nom du fichier à ajouter en tant que calque sur le document d’entrée. L’argument « -mergemode:XXX » précise la méthode d’ajout:

REPEATALL : toutes les pages sont fusionnées, en répétant le calque jusqu’à la fin du fichier d’entrée. C’est le fonctionnement par défaut si rien n’est précisé.

Exemple :
* En entrée : fichier d’entrée de 5 pages (identifiées par 1,2,3,4,5) et un calque de 2 pages (identifiées a,b)
* En sortie : un fichier de 5 pages identifiées 1a,2b,3a,4b,5a

REPEATFULL : toutes les pages sont fusionnées, en répétant le calque tant qu’il peut être inséré entièrement.

Exemple :
* Avec les mêmes entrées que précédemment, on aura en sortie un fichier de 5 pages identifiées 1a,2b,3a,4b,5 (la dernière page n’étant donc pas modifiée).

ONCE : le calque n’est inséré qu’une seule fois, sur la ou les premières pages du fichier d’entrée.

Exemple :
* Avec les mêmes entrées que précédemment, on aura en sortie un fichier de 5 pages identifiées 1a,2b,3,4,5.

Variable d’environnement exportée

MAP_XPSFILE : contient le nom du fichier en cours d’extraction.

==Gestion des input box==

Le nom de la zone input text doit être « SUBMIT ».
-param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost?

map_xps -infile:/tmp/form_vide.xps -outfile:/tmp/test.pdf -toPDF
-param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost?

map_xps -infile:/tmp/form_vide.xps -outfile:/tmp/test.html -toHTML
-param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost?

Avec envoi d’e-mail :

<code>map_xps -infile:/tmp/form_vide.xps -outfile:/tmp/test.html -toHTML</code>
<code>-param:url=http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapRunPost? -toMail -from:exp@mydomain.net -to:dest@mydomain.net</code>
<code>-subject:form -server:192.168.1.2 -domain:mydomain.net</code>

OPALE:10.0:Utilisation:Exporter les fichiers : MAPREPORT

2019-05-15T08:32:17Z

Izarai :

Cette commande permet de créer les définitions de fichier.
* Saisir la commande MAPREPORT, préciser ensuite dans quelle bibliothèque se trouve le fichier à exporter à l'aide de l'option 5=Niveau Suivant.
* Ensuite, apparaît à l'écran la liste des fichiers PF de la bibliothèque choisie. Entrer 1 pour exporter la table ou 5 pour passer au niveau membre.
* Au niveau membre, deux choix sont possibles soit exporter le membre, soit lancer la création d'un spool à partir du membre sélectionné [[OPALE:10.0:Utilisation:Commande MAPOFFICE|Commande MAPOFFICE]].

[[File:Mapreport1.PNG|600px|centré|sans_cadre]]

[[File:Mapreport2.PNG|600px|centré|sans_cadre]]

OPALE:10.0:Utilisation:Afficher la file d'attente des mails : MAPDSPMAIL

2019-05-15T08:29:54Z

Izarai :

Cette commande permet d'afficher la file d'attente des mails (MAPSEND400).

OPALE:10.0:Utilisation:Éclater un spool EBCDIC : MAPECLAT

2019-05-15T08:25:56Z

Izarai :

Séparer le spool d'origine en plusieurs pour les envoyer dans plusieurs Outqs.

'''Mode Interactif ''': depuis l'option Gérer les fichiers spools.
En tapant '''E''' devant le spool, renseigner les paramètres suivants :
* Nombre de fichiers à constituer
* Nom de l'Outq 1 et Bibiliothèque de l'Outq 1
* Nom de l'Outq 2 et Bibiliothèque de l'Outq 2
* ...
* Nom de l'Outq n et Bibiliothèque de l'Outq n (n est le nombre total de fichiers)

'''Commande MAPECLAT'''
* Spoolfile name '''SPLF'''
* Spoolfile number '''SPLNUM'''
* Job Name '''JOB'''
* Job Number '''JOBNUM'''
* User '''USER'''
* Number of spoolfile '''NBRSPL'''
* Outq name 1 '''OUTQ1'''
* Bibliothèque de l'Outq 1
* Number of pages 1 '''NB1'''
* Outq name 2 '''OUTQ1'''
* Bibliothèque de l'Outq 2
* Number of pages 2 '''NB1'''
* ...
* Outq name n '''OUTQ1'''
* Bibliothèque de l'Outq n
* Number of pages n '''NBn'''

OPALE:10.0:Utilisation:Envoyer un objet dans la mémoire flash : SNDFLASH

2019-05-15T08:23:39Z

Izarai :

'''Mode Interactif''' : depuis l'option Traitement sur objets Police, Fond de page, Logo

En tapant 3 devant l'objet,renseigner les paramètres suivants :

* Nom de l'Outq
* Bibiliothèque de l'Outq
* Type PRINTER
[[File:Sndflash.PNG|618x618px|centré|sans_cadre]]

'''Commande SNDFLASH'''
Il faut renseigner les paramètres suivants
* Outq name
* Outq Lib
* Name of the object
* Type of the object
* Store device
[[File:Commande sndflash.PNG|598x598px|centré|sans_cadre]]

OPALE:10.0:Utilisation:Créer un fichier PDF : MAPSPLPDF

2019-05-15T08:22:10Z

Izarai :

'''Remapper un spool et en créer un fichier PDF dans l'IFS.'''

Après avoir créé la maquette dans Designer au format PDF, utiliser la commande MAPSPLPDF.

* Name of the spool file
* Number of the spool file
* Name of the JOB
* Number of the JOB
* User of the JOB
* MAPPING format name
* Séquense
* Original file to delete
* Starting page
* End page
* Name of the file
* Path of the file

[[File:Mapsplpdf1.PNG|521x521px|centré|sans_cadre]]

OPALE:10.0:Utilisation:Remapper un fichier physique : MAPCPYDB

2019-05-15T08:21:40Z

Izarai :

Cette commande permet de remapper un fichier de type base de données.

Le format Mapping à appliquer doit être réalisé à l'aide de la description du fichier physique. Pour afficher celle-ci, utilisez la commande '''DSPFFD'''.

Commande: MAPCPYDB

* DB FILENAME
* DB LIBNAME
* DB SIZE
* Nom du format MAPPING
* Mode de traitement
* Outq de sortie
* Bibliothèque de l'Outq
* Suppression du spool d'origine (EBCDIC)
* Fichier remappé prêt en sortie (ASCII)
* Type d'imprimé
* Conserver le spool remappé
* Envoi du fond de page
* Envoi des polices
* Sauvegarde des spools fond de page et polices
* Page de début
* Page de fin
* Page Length : Nombre d'enregistrements par page

OPALE:10.0:Utilisation:Envoyer des objets d'un mapping dans une imprimante : SNDMAPPRT

2019-05-15T08:20:02Z

Izarai :

Cette commande permet d'envoyer des objets d'un mapping dans une imprimante.

[[File:Sndmapprt1.PNG|600px|centré|sans_cadre]]

OPALE:10.0:Utilisation:Envoyer un spool via service web : MAPRMTPROC

2019-05-15T08:11:35Z

Izarai :

Cette commande permet d'envoyer un spool de Opale Server vers Onyx Server via service web.

Pour plus d'informations, voir la page [[OPALE:10.0:Utilisation:MAPRMTPROC|Utilisation de la commande MAPRMTPROC]]

OPALE:10.0:Utilisation:Envoyer un spool via service web : MAPRMTPROC

2019-05-14T15:19:59Z

Izarai :

Cette commande permet d'envoyer un spool de Opale Server vers Onyx Server via service web.

OPALE:10.0:KB:Créer un fichier dump à partir d'un spool remappé

2019-05-14T15:17:54Z

Izarai : /* Exemple d'utilisation */

Un fichier '''dump''' peut être créé à partir d'un fichier spool mappé. Le fichier obtenu peut ensuite être envoyé sur une machine distante ou directement vers une imprimante.

Pour générer ce fichier, il faut :
* un fichier de spool remappé et disponible dans une Outq
* les droits d'accès en lecture / écriture aux dossiers de mappage dans l'IFS

===Exemple d'utilisation===
# Préalablement
#* Exécuter la commande <code>mapcpysplf</code> pour générer un document à partir d'un spool
#* Saisir le champ '''OutqName'''
#* Ce document se trouve alors dans une « outq »
# Création du fichier DUMP
#* Lancer la commande <code>mapsplf</code> ou aller dans le menu Mapping « Gérer les fichiers spool »
#* Cet écran permet de choisir le spool
#* La touche <kbd>P</kbd> (transfert vers PC) affiche un menu
#* Le champ « Fichier de sortie » doit recevoir un fichier portant l'extension .dmp (au lieu de .pag).
# Récupération du fichier obtenu
#* Le fichier se trouve sur l'IFS

[[File:Fichier dump.PNG|846x846px|centré|sans_cadre]]

OPALE:10.0:Utilisation:Transférer un spool AS/400 vers le PC : MAPSPLF(option P)

2019-05-14T15:16:03Z

Izarai :

* Dans le Menu Mapping, choisissez l'option Gérer les fichiers spools
* Tapez la lettre '''P''' devant le spool puis validez par ENTREE => Une boite de dialogue apparaît alors pour la création du fichier.
* Modifiez si nécessaire le nom du fichier. '''Gardez l'extension .PAG !!'''
* Modifiez si nécessaire les pages à envoyer. '''Évitez d'envoyer des fichiers trop volumineux'''

Si le contenu n'est pas un datastream (PAG), voir [[OPALE:10.0:KB:Créer_un_fichier_dump_à_partir_d'un_spool_remappé|Créer un fichier dump à partir d'un spool remappé]].

OPALE:10.0:Utilisation:Qualification d'un spool : MAPQUALSPL

2019-05-14T15:14:00Z

Izarai :

Cette commande permet de qualifier un spool après un tri en ajoutant une série de code dans le spool même. Elle s'utilise donc exclusivement après l'une des

commandes '''MAPSORTSPL''' ou '''MAPSORTPAG''' utilisé avec le paramètre '''CREATE''' égal à '''*NO''' (pas de création de spool juste après le tri)..

Elle permet également de faire un tri sur volume (éclater un spool en fonction du nombre de pages pour chaque rupture). Par exemple, pour un spool de facturation

contenant plusieurs factures, éclater le spool en créant en sortie un spool avec toutes les factures d'1 page, 1 autre avec toutes les factures de 2 pages.

Elle permet d'insérer '''le numéro de page dans la rupture''' (les numéros de page d'une facture à l'intérieur d'un spool en contenant plusieurs en ayant fait le

tri sur le numéro de facture), '''le nombre total de pages de la rupture''' (le nombre de page de la facture), le type de page (1 pour la première page de la

facture, 2 pour les pages 2 à l'avant dernière et 3 pour la dernière page), et enfin les '''codes KERN''' permettant de faire de la mise sous-pli automatique.

Dans la maquette, il suffira de mettre une ligne verticale conditionné sur la valeur du code KERN (la ligne est imprimée si la valeur du code vaut 1)..

Structure du code :

Positions 1 à 6 - Incrémentation du numéro de page à l'intérieur de la rupture.

Positions 7 à 12 - Nombre de page total de la rupture.

Exemple : 1/ 3 2/ 3 3/ 3

Position 13 - Code de rupture
- 1 : Page "entete" (première)
- 2 : Page "suite" (milieu)
- 3 : Page "total" (dernière)

Positions 14 à 18 - Code de mise sous pli type Kern (Contient 0 ou 1 suivant la norme)
- PK Contrôle de parité (1 si la somme des 4 suivants est paire, 0 sinon)
- BS4, BS3, BS1 : Décrément d'une valeur binaire de 7 (111) à 1 (001)
- DGR Code de fermeture enveloppe (1 = fermeture)

Positions 19 à 24 - Incrémentation du numéro de rupture (1er client, 2ème client....)

Positions 25 à 30 - Nombre de ruptures

Exemple sur une facture de 4 pages :

page 1 : 1 4111111

page 2 : 2 4211100

page 3 : 3 4211010

page 4 : 4 4301000

'''ATTENTION : Les paramètres NAME et SIZE doivent être rigoureusement les mêmes que dans la commande MAPSORTSPL'''

Les paramètres LINE et COL permettent d'insérer les codes à l'endroit désiré dans le spool (Choisir un emplacement vierge sinon les données du spool seront écrasées).

Les paramètres à renseigner sont les suivants :

* Name of DataBase for sort
* Line Number : numéro de la ligne où insérer les codes
* Column Number : numéro de la colonne où insérer les codes
* Create spool file
* Spoolfile Name to Create
* Outq
* Outq Library
* Spool Holder
* Control sort splfname
* Length of the input spoolfile
* Height of the input spoolfile
* Overflow of the input spoolfile
* Modulo
* Use Duplex

Autres paramètres

* Name of the spool file
* Number of the spool file
* Name of the JOB
* Number of the JOB
* Name of 10 characters Max

OPALE:10.0:Utilisation:Merger deux spools : MAPMOVDATA

2019-05-14T15:12:19Z

Izarai :

Cette commande permet de copier les données d'un spool sur les pages d'un autre spool. Elle peut être utilisée à partir de deux spools issus de queries : un spool avec l'entête d'une facture, et un spool avec le détail des articles. MAPMOVDATA s'utilise après MAPSORTSPL. Il faut ajouter les deux spools dans une même base de données, et MAPMOVDATA va modifier cette base et mettre les données du premier spool ajouté à la fin de chaque page du deuxième spool pour lesquelles la valeur du critère de tri est identique.

Exemple :

- le premier spool est un fichier d'articles de plusieurs factures

- le second spool est un fichier d'entête de plusieurs factures

- on trie les deux spools avec '''MAPSORTSPL''' par numéro de facture

- '''MAPMOVDATA''' va mettre les articles de chaque facture à la fin des pages d'entête correspondantes

- On déclenche l'impression des spools : commande '''MAPSORTSPL''' avec le paramètre '''MBROPT''' à '''*NONE'''

* Line Number : numéro de la ligne à partir de laquelle on copie
* Name of DataBase for sort : nom de la base de données (la même que pour les MAPSORTSPL)
* Spool file number to copy : numéro du spool à copier à la fin de l'autre (correspond au numéro d'ajout de la commande MAPSORTSPL)
* Spool file number to update : numéro du spool à modifier
* Length of the input spoolfile : longueur du PRTF
* Delete copy spool file : suppression des pages du spool copié

OPALE:10.0:Utilisation:Dupliquer un spool : MAPDUPSPLF

2019-05-14T15:11:34Z

Izarai :

'''Mode Interactif''' : depuis le menu Mapping, la première option Gérer les fichiers spools.
En tapant D devant le spool, les paramètres d'entrée (attributs du spool d'origine) sont renseignés, il reste à renseigner les paramètres suivants:

* Spooled file name
* Spooled file number
* Job name
* Job number
* User

Remarque :

C'est possible également de faire copier/coller de ces paramètres afin de l'utiliser dans d'autres commandes comme MAPSPLPDF, MAPCPYSPLF...)

[[File:Dupliquerspool.PNG|500px|centré|sans_cadre]] [[File:Mapsplpdf1.PNG|500px|centré|sans_cadre]]

OPALE:10.0:Utilisation:Dupliquer un spool : MAPDUPSPLF

2019-05-14T15:11:13Z

Izarai :

OPALE:10.0:KB:Problème de format

2019-05-14T15:09:32Z

Izarai :

Problème : Si vous constatez que des éléments d'une maquette apparaissent sur une autre maquette, il se peut qu'il y ait un conflit de ressources (polices, fonds de page, images, logos, composants). Dans ce cas, veuillez effectuer les étapes suivantes.

Solution :
# Sauvegarder votre bibliothèque de fichier et le fichier lstobj.txt
# Supprimer le format défectueux
# Lancer la commande CALL MAP_823 pour nettoyer les éléments associés au format défectueux
# MAPRGZ pour réorganiser les formats
# Régénérer et importer les formats

OPALE:10.0:KB:Problème de format

2019-05-14T15:09:15Z

Izarai :

OPALE:10.0:Utilisation: Création des définitions de fichier

2019-05-14T15:07:56Z

Izarai :

Pour une base de données, la première étape pour concevoir un rapport est de créer les définitions de fichier. Il s'agit en fait de récupérer la

structure des tables qui permettront de créer les rapports : type, nom et longueur des champs contenus dans le fichier.

Depuis le menu Mapping d'Opale ,choisir l'option Création des définitions de fichier, pour avoir toutes les bibliothèques du système.

Sinon, en saisissant [[OPALE:10.0:Utilisation:Exporter les fichiers : MAPREPORT|la commande MAPREPORT]].

OPALE:10.0:Utilisation: Démarrage du serveur M-Connect

2019-05-14T15:04:15Z

Izarai :

Sur OPALE,il y a deux possibilités pour accéder au menu CONNECT:

* Saisir GO MAPREPORT sur une ligne de commande ,appuyer sur la touche F4 puis précisez la bibliothèque.Sinon, saisir la commande Go Menu(votre
bibliothèque/MAPREPORT)
* Après avoir renseigné MAPPING, le menu principal Mapping s'affiche, choisir le module CONNECT.

Démarrer le moteur de développement CONNECT avec la [[OPALE:10.0:Utilisation:Démarrer M-Connect : STRMAPRPT|commande STRMAPRPT]]

Remarque:

Le serveur de développement M-Connect, permet d'utiliser l'aperçu avant impression dans l'interface PC.

OPALE:10.0:Utilisation: Contrôle du fonctionnement du mail

2019-05-14T15:02:59Z

Izarai :

Cette option permet de lister les travaux actifs dans le sous-système MAPSROBOT. Par défaut, le nom du travail de MAPSEND400 est MAPSMTP.

[[File:SNDMAIL.PNG|600px|centré|sans_cadre]]

Pour la gestion d'un travail '''MAPSMTP''', choisir l’option 5 Gérer.

[[File:Gestionsndmail.PNG|600px|centré|sans_cadre]]

OPALE:10.0:Utilisation:Subject

2019-05-14T15:02:19Z

Izarai :

Sujet du mail.

Valeurs possibles :
* valeur alphanumérique : adresse mail complète de l'expéditeur
* *MAPSUBJCT : récupère la valeur de la zone MAPSUBJCT de la maquette (le sujet du mail est dans le spool)

OPALE:10.0:Utilisation: Imprimer la configuration du robot

2019-05-14T15:00:55Z

Izarai :

Cette option permet d'imprimer sur une imprimante de type PCL5 la configuration du robot :
* Définition de pools mémoire
* Liste des files d'attentes de travaux
* Liste des descriptions de travaux
* Liste des classes (priorités des travaux)
* Liste des relations spools Mapping (dans le menu d'exploitation)
* Liste des actions et lignes de commande (dans le menu d'exploitation)
* Liste des Mapping
* Définition des paramètres imprimantes

Il faut choisir une OUTQ sur laquelle est connectée une imprimante PCL.
Nom de l'OUTQ et la bibliothèque.

[[File:Impconfigrbt.PNG|733x733px|centré|sans_cadre]]

OPALE:10.0:Utilisation:Nettoyer l'historique: MAPCLRLOG

2019-05-14T15:00:30Z

Izarai :

Le fichier contenant la log, '''MAPRBTLOG''', n'est pas nettoyé automatiquement. Si cela n'est pas fait, sa taille risque de devenir très importante à terme.

La commande '''MAPCLRLOG''' permet d'enlever les messages datant de plus de x jours.

[[File:LOGRBT.PNG|600px|centré|sans_cadre]]

OPALE:10.0:Utilisation: Afficher l'état des files d attente

2019-05-14T15:00:01Z

Izarai :

Cette option affiche la liste des JOBQs du sous-sytème '''MAPSROBOT''' (en fait, toutes les JOBQs commençant par '''MAPQ''').

Dans le cas où des travaux sont en attente de traitement dans l'une de ces JOBQs, l'option 5 permet d'afficher la liste de ces travaux.

Les travaux en attente seront traités par le robot dès qu'il sera redémarré, ou dès que les travaux en cours seront terminés. En effet, dans chaque JOBQ, définir le

nombre maximum de travaux actifs simultanément (par défaut 1 dans '''MAPQSPEED''', 5 dans '''MAPQMIDDLE''', 10 dans '''MAPQSLOW'''). Si ce nombre est atteint, les

jobs supplémentaires sont alors en attente.

[[File:Jobq.PNG|783x783px|left|alt=|sans_cadre]]

OPALE:10.0:Utilisation: Afficher l'état des files d attente

2019-05-14T14:59:38Z

Izarai :

OPALE:10.0:Utilisation: Afficher l'état du robot

2019-05-14T14:58:56Z

Izarai :

Cette option affiche la liste des travaux actifs dans le sous-sytème '''MAPSROBOT'''.

Les travaux effectués par le robot portent le nom de l'action qui les a lancés (MAPPING, MOVE...).

[[File:Rbtetat.PNG|716x716px|left|alt=|sans_cadre]]

OPALE:10.0:Utilisation: Afficher l'état du robot

2019-05-14T14:58:12Z

Izarai :

OPALE:10.0:Utilisation: Arrêter le robot

2019-05-14T14:57:41Z

Izarai :

Pour exécuter cette option, saisir sur une ligne de commande '''ENDRBT'''.

Cette commande arrête le robot pour toutes les Outqs.

Remarque :

La commande ne se termine qu'à l'arrêt complet du robot. C'est à dire lorsque le dernier job en cours de traitement est terminé.

OPALE:10.0:Utilisation: Démarrer le robot

2019-05-14T14:57:07Z

Izarai :

Pour exécuter cette option, saisir sur une ligne de commande '''STRRBT'''.

Cette commande démarre le robot pour toutes les Outq déclarées dans l'option '''Gérer les relations Outq'''.

Le sous-sytème '''MAPSROBOT''' est démarré, et un job qui écoute la '''DTAQ''' du robot, et qui porte le nom de celle-ci.

Si aucun spool ne tombe dans les Outqs d'origine, le robot est inactif, il n'emploie aucune ressource AS/400.

Les valeurs disponibles pour le seul paramètre à renseigner Historique dans command (LOG) sont :
* *YES : le détail des actions exécutées est indiquée dans un fichier physique nommé command.
* *NO : pas d'historique créé

Remarque :

Pour démarrer le robot automatiquement au démarrage de l'AS/400, il suffit de l'ajouter dans le programme de démarrage QSTRUP.

Dans ce cas, utiliser la commande système '''STRSBS SBSD(QGPL/MAPSROBOT)'''.