MappingDoc - Contributions de l’utilisateur [fr]

ONYX:9.0:Utilisation:Paramètres de configuration principaux (mapping.conf)

2025-07-15T09:05:23Z

Kbonte :

<languages/>
<translate>

=mapping.conf=

==Préambule==
Le fichier mapping.conf est le fichier de configuration général du produit Mapping ONYX Server. Il contient l'intégralité des paramètres nécessaires au fonctionnement des différents modules (composition, workflow, spooler, conversion etc...)

Il s'agit d'un fichier XML, encodé en UTF-8 sans BOM.

===ONYX SERVER=== 


Configuration ONYX de base


*'''SYSTEM''' ''':''' Système d'exploitation.
*'''VERSION''' ''':''' Version attribuée au système d'exploitation.
*'''ARCHIVE_RELEASE''' ''':''' Version d'archivage.
*'''COMPANY_NAME''' ''':''' Nom de la société.
*'''LANGUAGE''' ''':''' Langue utilisée (Français ou Anglais).
*'''DATE_FORMAT''' ''':''' Format de la date (e.g. DD/MM/YYYY).
*'''TIME_FORMAT''' ''':''' Format d'affichage des heures (12 or 24).
*'''PATH_BASE_MAPPING''' ''':''' Chemin par défaut (e.g. C:\Mapping\M-Processing_Server).
*'''PATH_BIN''' ''':''' Chemin du binaire (e.g. C:\Mapping\M-Processing_Server\Applications).
*'''CONFIG''' ''':''' Fichier de configuration (e.g. C:\Mapping\M-Processing_Server\Settings\mapping.conf).
*'''GROUP_ADMIN''' ''':''' Groupe Administrateur (e.g. mapadmin (default)).
*'''USER_ADMIN''' ''':''' Nom d'utilisateur Administrateur (e.g. mapadmin (default)).
*'''EDITOR''' ''':''' Chemin du Text Editor. Linux only (e.g. vi (default)).
*'''MAPPING_VERSION''' ''':''' Version ONYX installée (e.g. autogenbuild_v9.0.0b.37402).

===WEB CONFIG=== 
Paramètres du serveur web


*'''CGI_BIN :''' Emplacement où sont stockés les exécutables du serveur Web.
*'''MAPWEB_CMDIN :''' Historique des commandes exécutées.
*'''MAPWEB_LOGIN :''' Historique des adresses atteintes (clics de souris sur les icônes et les boutons).
*'''MY_SERVER :''' Dossier où sont stockés les fichiers utilisés par le serveur Web. Ne pas modifier !
*'''PATH_MENU :''' Dossier où sont stockés les fichiers de menu. Ne pas modifier !
*'''ROOT_MENU :''' Dossier racine où la structure de menu commence.
*'''MAPPING_TRANSLATE :''' Chemin d'accès aux fichiers de traduction.
*'''PATH_VIEW_SETTINGS :''' Chemin d'accès au fichier de configuration utilisé pour configurer le mode d'affichage des différents types de fichiers de spool dans le spouleur.
*'''PCL_SPOOLS_VIEW :''' Format de prévisualisation par défaut pour les fichiers spool PCL: TEXT ou PDF. Si réglé sur TEXT, les fichiers seront affichés dans l'éditeur de texte préféré (text / plain). Si défini sur PDF, les fichiers s'ouvriront dans l'application PDF spécifiée. Voir le contenu de ViewSettings.conf pour les commandes.
*'''NB_LINE_IN_VIEW :''' Nombre maximal de lignes affichées dans le spouleur, 1000 étant la valeur recommandée.
*'''CONTEXT_MENU :''' (YES|NO) Permet d'activer le menu déroulant au niveau du coin en haut à gauche. s’il est réglé sur «off», le menu est masqué. Les valeurs ne sont pas sensibles à la casse.
*'''TOOLSBAR_MENU :''' (YES|NO) Permet d'activer les 4 icônes dans le coin inférieur gauche (Précédent, Actualiser, Menu principal et Déconnexion) et les images du menu.
*'''VIEW_SECURITY_LEVEL :''' Pour gérer les autorisations d'accès aux différents objets des profils ou des groupes d'utilisateurs.
*'''SPOOL_SECURITY :''' Pour gérer les autorisations d'accès aux différents fichiers pour les profils utilisateur ou les groupes.
*'''XPSVIEWER :'''
*'''SPOOL_TITLE_WIDTH :''' Modifie la taille de l'interface du menu "Travaux/Imprimantes".
*'''GUI_DISPLAY_ENVIRONMENT_LABEL :''' Texte affiché sur le bandeau de l'environnement.
*'''GUI_DISPLAY_ENVIRONMENT_COLOR :''' Code couleur du bandeau de l'environnement.

===SPOOLER CONFIG=== 


Paramètres de configuration du spouleur ONYX.


*'''PATH_SPOOLER :''' Dossier où sont stockés les fichiers de configuration du spouleur (e.g. ...\Spooler).
*'''DAEMON_ID :''' Spooler daemon (e.g. map_daemon.ID).
*'''PORT_SOCKET_DAEMON :''' Daemon port (e.g. 2000).
*'''IP_SERVER_DAEMON :''' Daemon IP address (e.g. 127.0.0.1).
*'''NB_SOCKET_DAEMON :''' Nombre de sockets pour le daemon (e.g. 100).
*'''NB_SOCKET_LPD :''' Nombre maximum de sockets pouvant être ouverts sur le service LPD de Mapping Server. La valeur par défaut est 100. En cas de modification de cette valeur, il faut également penser à modifier NB_SOCKET_DAEMON avec une valeur supérieure (nombre maxi de sockets pouvant être ouverts par le map_daemon)
*'''LISTEN_PORT :''' Daemon port d'écoute (e.g. 515).
*'''MAP_SERVER_MAIL :''' Adresse Ip du serveur Mail (e.g. 127.0.0.1).
*'''MAP_DOMAIN_MAIL :''' Domaine du serveur Mail (e.g. domain.local).
*'''TIMEOUT_TO_WAIT_SEC :''' Délai de connexion des applications clientes au démon (e.g. 60).
*'''NB_MAX_PRINTER_EXECUTION :'''
*'''LOAD_SPOOLS_ON_VIEW :'''

===MAP_SCANFOLDER CONFIG=== 
Configuration du SCANFOLDER (point d’entrée)


*'''SCANFOLDER_ID :''' Identifiant (e.g. map_scanfolder.ID).
*'''MAP_SCANFOLDER_TIMER :''' Intervalle de temps entre deux SCANFOLDER– exprimé en secondes (e.g. 6).
*'''CONFIG_PATH_ROBOT :''' Chemin vers le fichier de configuration du robot (e.g. ...\Settings\robot.conf).
*'''CHECK_FTP_FILE_ACCESS :''' Active le timeout en cas de depot de fichier par FTP, pour le depot complet d'un fichier (ne fonctionne que sous Windows)
*'''FTP_TIMEOUT_SEC :''' Si les fichiers sont envoyés via FTP, il s'agit du temps d'attente maximal pour accéder aux fichiers.– exprimé en secondes (e.g. 10).
*'''SCANFOLDER_PATH_DUP_FILES :''' Chemin où les fichiers déjà traités par le moteur de règles seront déplacés.
*'''SCANFOLDER_FILTER :''' Filtre par défaut pour les fichiers à ne pas prendre (e.g. *.tmp).
*'''SCANFOLDER_ACCEPT :''' Filtre par défaut pour les fichiers à ramasser (e.g. *.xml, pour ne prendre que les fichiers avec cette extension).

===MAP_RAWD CONFIG=== 


Paramètres de configuration du daemon du protocole RAW.


*'''MAPRAWD_ID :''' Identifiant du serveur d'écoute.
*'''MAPRAWD_CONFIGFILE :''' Chemin de configuration du serveur d'écoute file (e.g. ...\Settings\maprawd.conf).
*'''MAPRAWD_SERVERSTDIN :''' Chemin d'accès au fichier d'entrée du serveur d'écoute.
*'''MAPRAWD_SERVERSTDOUT :''' Chemin d'accès au fichier d'entrée du serveur d'écoute.
*'''MAPRAWD_SERVERSTDERR :''' Chemin d'accès au fichier d'erreur du serveur d'écoute.

===MAP_STATD CONFIG=== 


*'''MAPSTATD_ID :''' Nom du fichier ID du serveur de statistiques.
*'''MAPSTATD_SERVER_IP :''' Adresse IP du serveur de statistiques.
*'''MAPSTATD_PORT :''' Port du serveur de statistiques.
*'''MAPSTATD_SERVERSTDIN :'''
*'''MAPSTATD_SERVERSTDOUT :'''
*'''MAPSTATD_SERVERSTDERR :'''
*'''MAPSTATD_CONFIGFILE :'''

===MAP_SCHEDULER CONFIG=== 


Configuration des tâches planifiées du serveur.


*'''SCHEDULER_ID :''' Identifiant du serveur.
*'''SCHEDULER_TEMPO :'''
*'''SCHEDULER_SERVERSTDIN :''' Chemin d'accès au fichier d'entrée du serveur de tâches planifiées.
*'''SCHEDULER_SERVERSTDOUT :''' Chemin du fichier de sortie du serveur de tâches planifiées.
*'''SCHEDULER_SERVERSTDERR :''' Chemin d'accès au fichier d'erreur du serveur de tâches planifiées.

===MAPREPORT CONFIG=== 
Les paramètres du module du serveur Connect


*'''PATH_MAPREPORT :''' Chemin d'accès aux fichiers d'importation Connect (e.g. ...\Import\mapreport).
*'''MAPREPORT_ID :''' identifiant du programme (e.g. map_report.ID).
*'''MAPREPORT_PORT :'''port d'ecoute du preview (e.g. 6789).
*'''MAPREPORT_SERVERSTDIN :''' Chemin d'accès au fichier d'entrée (e.g. ...\Temp\mapreport.stdin.txt).
*'''MAPREPORT_SERVERSTDOUT :''' Chemin du fichier de sortie (e.g. ...\Temp\mapreport.stdout.txt).
*'''MAPREPORT_SERVERSTDERR :'''Chemin vers le fichier d'erreur (e.g. ...\Temp\mapreport.stderr.txt).
*'''MAPREPORT_SERVERTYPE :''' Type de la base de données (e.g. MySQL).
*'''MAPREPORT_SERVERADDRESS :''' Adresse IP du serveur de base de données.
*'''MAPREPORT_SERVERPORT :''' Numéro de port du serveur de base de données (e.g. 3306).
*'''MAPREPORT_SERVERUSER :''' Nom d'utilisateur de la base de données (e.g. root).
*'''MAPREPORT_SERVERPASSWORD :''' Mot de passe de base de données.
*'''MAPREPORT_SERVERVERSION :'''
*'''MAPREPORT_OVERFLOW :'''

===USERS ACCESS=== 
Paramètres de configuration pour les utilisateurs et les groupes d'utilisateurs.


*'''USERS_CONF :''' Chemin d'accès au fichier de configuration des comptes d'utilisateurs sans connexion à Active Directory (e.g. ...\Settings\USERS.conf).
*'''GROUPS_CONF :''' Chemin d'accès au fichier de configuration des comptes de groupe sans connexion à Active Directory (e.g. ...\Settings\GROUPS.conf).
*'''HTPASSWD_BIN :''' Chemin de l'exécutable qui crée les mots de passe (e.g. ...\apache\bin\htpasswd.exe).
*'''HTPASSWD_FILE :''' Fichier où les mots de passe sont stockés (e.g. ...\MapHTTPServer\htpasswd).
*'''USER_INFO :''' Mot de passe nom de fichier sur le système (e.g. ...\passwd on Windows or /etc/passwd on Unix).
*'''GROUP_INFO :''' Obsolete.
*'''PRINTER_INFO :'''Obsolete.
*'''AUTH_MOD :''' Mode d’authentification.

===LOGS=== 
Paramètres du fichier LOG


*'''PATH_LOG :''' Chemin où sont stockés les fichiers log du spouleur (e.g. ...\Spooler\logs).
*'''PATH_LOG_CONF :''' Fichier "traduction" pour les fichiers log de mapping. Les messages ne sont pas enregistrés dans la log, mais ils sont remplacés par un index traduit à l'aide de ce fichier (e.g. ...\Settings\log.conf).
*'''DAEMON_LOG :''' Fichier log du spouleur (e.g. map_daemon.log)
*'''LPR_LOG :''' Fichier log du LPR (e.g. map_lpr.log).
*'''CONTROL_LOG :''' Fichier log du map_control log file (e.g. map_control.log).
*'''LPD_LOG :''' Fichier log du LPD (e.g. map_lpd.log).
*'''PJL_LOG :''' Fichier log du map_raw (e.g. map_raw_log).
*'''LOG_LEVEL :''' Log des niveaux de verbosité 1 à 4, 4 étant le niveau le plus élevé. Quel que soit le niveau, les logs contiennent toujours les informations de début et de fin d'exécution. 
**LOG_LEVEL=1 : Uniquement les messages d'erreurs. 
**LOG_LEVEL=2 : Idem LOG_LEVEL=1 + les messages de type "Warning". 
**LOG_LEVEL=3 : Idem LOG_LEVEL=2 + les messages d'informations liés à l'exécution de chaque traitement. 
**LOG_LEVEL=4 : Idem LOG_LEVEL=3 + très haut niveau de détail. C'est le mode "debug" à activer que si nécessaire. Le niveau 4 peut provoquer des lenteurs non négligeables dans les traitements de workflows. Ce temps de traitements étant proportionnel à la taille du fichier de log. Un nettoyage régulier des logs des files d'attentes est impératif dans ce cas (via la commande map_cron -cleanlog).
*'''STATS_TRACES :''' Pour activer l'utilisation de statistiques. Haut ou bas. Pas sensible à la casse.
*'''MAPPING_USAGE_REPORT :''' Pour activer / désactiver les statistiques sur la quantité de ressources processeur utilisée par Onyx, Connect et le spouleur.
*'''LOG_TXT :''' (YES|NO) Permet d'activer la mise à disposition des fichiers de logs sous forme de fichiers textes.
*'''LOG_TXT_ENCODING :''' (UTF-8 | UTF-16) permet de spécifier le code page des logs "texte" si le paramètre "LOG_TXT" est activé.
*'''LOG_PREFIX :''' Préfixe ajouté dans les Logs du workflow. Il peut être constitué de chaines de caractères fixes, et de variables sous la forme [%XXXXXX%]
*'''VIEW_ALL_LOG :''' (YES|NO)

===MAPCPYSPLF=== 
Configuration de la commande mapping MAPCPYSPLF


*'''MAPCPYSPLF_MAPMOD :''' Mode de traitement : "C" pour créer un fichier document.
*'''MAPCPYSPLF_PAGM :''' Taille des pages par défaut (ex : A4).
*'''MAPCPYSPLF_LANG :''' Print language, PCL by default. Values are not case sensitive.
*'''MAPCPYSPLF_STATE :''' Obsolète.
*'''MAPCPYSPLF_KEEP :''' Obsolète.
*'''MAPCPYSPLF_SNDFDP :''' Obsolète.
*'''MAPCPYSPLF_SNDPOL :''' Obsolète.
*'''MAPCPYSPLF_SNDLGO :''' Obsolète.
*'''MAPCPYSPLF_LENGTHIN :''' Obsolète.
*'''MAPCPYSPLF_LENGTHOUT :''' Obsolète.
*'''MAPCPYSPLF_STARTPAGE :''' Start page.
*'''MAPCPYSPLF_STOPPAGE :''' End page.
*'''MAPCPYSPLF_LENGTHREC :''' Nombre maximum de caractères par page pour les fichiers textes paginés.
*'''MAPCPYSPLF_SPOOLNAME :''' Obsolète.
*'''MAPCPYSPLF_OVERFLOW :''' Nombre maximum de lignes par page pour les fichiers textes paginés.
*'''MAPCPYSPLF_ONEFILE :''' Obsolete.
*'''MAPCPYSPLF_DECIMAL :''' Séparateur de décimales.
*'''MAPCPYSPLF_THOUSAND :''' Séparateur de milliers.
*'''MAPCPYSPLF_CODEPAGE :''' Force la création de polices de caractères complète contenant tous les caractères pour un code page donné, même ceux qui ne sont pas utilisés dans le document.

===DEFAULT SPOOL FILES VALUES=== 
Attributs des travaux du spooler par défaut s'ils ne sont pas spécifiés dans la commande d'envoi (map_lp ou map_lpr).


*'''DEFAUT_SPOOL_SAVE :''' (YES|NO) Permet de conserver le travail après traitement.
*'''DEFAUT_SPOOL_PTY :''' Priorité du fichier spool, 0 étant la plus haute. Valeurs prises en charge 0 à 999999999.
*'''DEFAUT_SPOOL_NBCOPY :''' Nombre de copies par défaut des documents à imprimer.
*'''DEFAUT_SPOOL_RETENTION :''' Nombre de jours pendant lesquels les travaux doivent être conservés.
*'''DEFAUT_SPOOL_COMPRESS :''' Obsolète.
*'''DEFAUT_SPOOL_STARTPAGE :''' Première page à traiter (par défaut : 1).
*'''DEFAUT_SPOOL_STOPPAGE :''' Dernière page à traiter.
*'''DEFAUT_SPOOL_SECURITY :''' Niveau de sécurité. 0 par défaut, équivalent à 777
*'''DEFAUT_SPOOL_CODECOMPTA :''' Obsolète.
*'''DEFAUT_SPOOL_FIDELITY :''' Obsolète.
*'''DEFAUT_SPOOL_PAPERSTATUS :''' Type de papier chargé dans l'imprimante. Permet d'interrompre l'impression en cas de changement de cette valeur entre 2 travaux consécutifs en déclenchant une opération manuelle.
*'''DEFAUT_SPOOL_HOST :''' Nom du serveur.
*'''DEFAUT_SPOOL_USER :''' Nom de l'utilisateur par défaut.

===MAPERPORT EXPERT=== 
Paramètres Expert CONNECT


*'''SHELL_MAPREPORT :''' Chemin du script de menu Connect.
*'''MENUS_MAPREPORT :''' Dossier où les projets sont importés.
*'''PATH_DES :''' Dossier où les projets sont importés.
*'''PATH_DBF :''' Dossier où les projets sont importés.
*'''PATH_DBL :''' Dossier où les projets sont importés.
*'''PATH_DBC :''' Dossier où les projets sont importés.
*'''PATH_DBW :''' Dossier où les projets sont importés.
*'''MAPREPORT_DEFAULT_FILTRE_TABLE :''' Valeur par défaut du filtre de nom de table dans Connect--> Extract (e.g. %).
*'''MAPREPORT_DEFAULT_FILTRE_OWNER :''' Valeur par défaut du filtre propriétaire de la table dans Connect--> Extract (e.g. %%).

===EXPERT PATH=== 


*'''PATH_IMPORT :''' Chemin où les templates de document sont générés par Designer (e.g. ...\Import).
*'''PATH_PGM :''' Chemin où les templates de document sont importés.
*'''PATH_HELP :''' Chemin où sont stockés les fichiers de traduction binaires.
*'''PATH_PCL :''' Chemin où les templates de document PCL sont importés.
*'''PATH_AFPDS :''' Chemin où les templates de document AFP sont importés.
*'''PATH_ZEBRA :''' Chemin où les templates de document ZEBRA sont importés.
*'''PATH_DPL :''' Chemin où les templates de document DPL sont importés.
*'''PATH_IGP :''' Chemin où les templates de document IGP sont importés.
*'''PATH_TEC :''' Chemin où les templates de document TEC sont importés.
*'''PATH_IPL :''' Chemin où les templates de document IPL sont importés.
*'''PATH_F_D :''' Chemin où les templates de document F_D sont importés.
*'''PATH_PDF :''' Chemin où les templates de document PDF sont importés.
*'''PATH_XPS :''' Chemin où les templates de document XPS sont importés.
*'''PATH_EPL :''' Chemin où les templates de document EPL sont importés.
*'''PATH_FONT_TTF :''' Dossier où sont stockés les fichiers de police (*.ttf) utilisés dans les templates de document.
*'''PATH_FONT_XPS :''' Dossier où sont stockés les fichiers de police (*.odttf) utilisés dans les templates de document XPS (map_xps).
*'''LIB_PATH :''' Chemin d'accès aux fichiers binaires du spouleur.
*'''PATH_ARCHIVE :''' Chemin où sont stockés les fichiers d’archive Unix (mapcpysplf –mapmod: U).
*'''PATH_TEMP :''' Chemin du dossier temporaire.
*'''PATH_STATBIN :''' Obsolete.
*'''PATH_MAP_DAEMON :''' Nom du binaire map_daemon.
*'''PATH_MAP_EXEC :''' Nom du binaire map_exec.
*'''PATH_MAP_LPD :''' Nom du binaire map_lpd.
*'''PATH_MAP_LPR :''' Nom du binaire map_lpr.
*'''PATH_MAP_AXIOHM :''' Nom du binaire du pilote Axiohm.
*'''PATH_MAP_SAMSUNG :''' Nom du binaire Samsung.
*'''PATH_MAP_POS :''' Nom du driver POS (imprimante de type EPSON uniquement).
*'''PATH_MAP_RAW :''' Nom du binaire map_raw.
*'''PATH_MAP_MAIL :''' Nom du binaire map_mail.
*'''PATH_MAP_WIN32PRT :''' Nom du programme MAP_WIN32PRT (impression sur imprimante Windows locale).
*'''PATH_MAP_USBPRT :''' Nom du programme MAP_USBPRT (impression USB).
*'''PATH_MAP_COMPRT :''' Nom du programme MAP_COMPRT (impression série / parallèle).
*'''PATH_MAP_RAWD :''' Nom du binaire map_rawd.
*'''PATH_MAP_STATD :'''
*'''PATH_MAP_SPLF :''' Nom du binaire map_splf.
*'''PATH_MAP_LPSTAT :''' Nom du binaire map_lpstat.
*'''PATH_CONF_IMP :''' Chemin et nom du fichier de numéro d'information renvoyé par l'imprimante.
*'''PATH_QUEUES :''' Dossier où les files d'attente et les périphériques du spouleur sont stockés.
*'''PATH_FIFOS :''' Dossier où sont stockés les fichiers FIFO du spouleur.
*'''PATH_ETC_QUEUES :''' Dossier où sont stockés les fichiers de configuration des files d'attente et des périphériques.
*'''PATH_INFO :''' Dossier où sont stockés les fichiers d'informations des files d'attente et des périphériques.
*'''PATH_STDIN :''' Chemin + nom du fichier qui reçoit le stdin.
*'''PATH_STDOUT :''' Chemin + nom du fichier qui reçoit le stdout.
*'''PATH_STDERR :''' Chemin + nom du fichier qui reçoit le stderr.
*'''RULES_PATH :''' Chemin où sont stockées les règles opérationnelles du spouleur.
*'''STATS_PATH :''' Chemin où les projets utilisés sont stockés (e.g. ...\Spooler\stats).
*'''PATH_COUNTER_SPLF :''' Nom du fichier contenant le compteur d'id de fichier de spool.
*'''PATH_QUEUE_DEF :''' Nom du fichier de configuration des files d'attente et des périphériques.
*'''ARCHIVE_IMPORT_PATH :''' Chemin à partir duquel les sauvegardes sont importées (Deployments management).
*'''ARCHIVE_EXPORT_PATH :''' Chemin où les sauvegardes sont exportées (Deployments management).
*'''DEPLOYMENT_CUSTOM_LOGFILE :''' Chemin + nom du log de sauvegarde.
*'''MAPPING_PATCH :''' Pour gérer les correctifs dans un environnement multiplateforme.
*'''PATH_KEYFILE :'''
*'''PATH_GHOSTSCRIPT :'''
*'''XPS_BATCHPRINTING_SIZE''' : Taille en nombre de pages maximum d'un lot d'impression.

===EXPERT OPTIONS=== 
Paramètres experts supplémentaires


*'''AIXTO19U_TABLE :''' Table de conversion de caractères.
*'''19UTOAIX_TABLE :''' Table de conversion de caractères.
*'''EBCDICTOASCII_TABLE :''' Table de conversion de caractères.
*'''ASCIITOEBCDIC_TABLE :''' Table de conversion de caractères.
*'''MAPCPYSPLF_TMPCNT :''' Compteur du fichier pour les fichiers Remap temporaires.
*'''MAPCPYSPLF_MAPCNT :''' Remap compteur de fichier.
*'''LIST_OBJ :''' Chemin d'accès apour lister le fichier lstobj.txt.
*'''PRINT_INFO :''' Chemin + nom du fichier de configuration du printer bin.
*'''EURO :''' Chemin + nom du fichier de configuration des taux de conversion de devise.
*'''MESSAGES :''' Chemin + nom du fichier de message binaire.
*'''PASSWORD :''' Fichier de mot de passe pour se connecter à Map Out.
*'''MAPKEY :''' Chemin + nom du fichier de licence du logiciel.
*'''UCINFO :''' Fichier texte contenant des informations sur le processeur et le système.
*'''MAPWEB_FUNCTIONS :''' Not used.
*'''RULES_CONDITIONS :''' Chemin + nom de fichier contenant les valeurs par défaut des conditions de paramètres du moteur de règles.
*'''RULES_PARAMETERS :''' Chemin + nom du fichier contenant les valeurs par défaut des paramètres du moteur de règles.
*'''RULES_COMMANDS :''' Chemin + nom du fichier contenant les valeurs par défaut des commandes du moteur de règles.
*'''RULES_809 :''' Nom par défaut du fichier de règles.
*'''RULES_TABLES :''' Chemin + nom du fichier contenant la liste des tables de résolution.
*'''HOST_LPD :''' Fichiers "hôtes" pour le LPD.
*'''RESLIB :''' Chemin où sont stockées les ressources AFP (pour InfoPrint Manager).
*'''STATS_SHELL :''' Nom du binaire qui exécute les statistiques, c'est-à-dire map_stats.bat.
*'''IMPORT_BACKUP :''' (YES|NO) Permet de sauvegarder les fichiers lorsqu'un format est importé.
*'''IMPORT_FONT :''' (YES|NO) Permet d'écraser ou non les polices déjà existantes lors de chaque importation.
*'''PATH_EXPORT_SETTINGS :''' Chemin + nom du fichier de configuration de déploiement.
*'''PATH_COUNTER_EXPORT :''' Nombre de déploiement. Chemin + nom de fichier.
*'''DAEMON_NO_HOLD_ON_ERROR :''' (YES|NO) Permet de ne pas arrêter les files d'attente de type d'imprimante en cas d'erreur. Attention à la négation, la valeur "YES" permettant du coup de ne pas arrêter les impressions.
*'''DAEMON_DONT_HOLD_ENTRY_ON_ERROR :''' (YES|NO) Permet de ne pas arrêter les files d'attente de traitement en cas d'erreur. Attention à la négation, la valeur "YES" permettant du coup de ne pas arrêter les traitements.
*'''XPSCONFIG :'''
*'''XPS_BATCHPRINTING_SIZE :''' Permet de découper un flux impression en plusieurs fichiers. Ceci permet de pallier les limites de certaines imprimantes (mémoire, nombre d'objets simultanés dans un même flux d'édition...). Actif uniquement lorsque la file d'attente d'impression traite des fichiers XPS devant être convertis à la volée dans le langage d'impression de l'imprimante.

===OTHER=== 


*'''KILL_ON_REFRESH :''' (YES|NO) Permet de supprimer les fichiers binaires exécutés en arrière-plan lors de l'actualisation du Web.
*'''REFRESH_VIEW_DELAY :''' Pour actualiser la vue des fichiers spoule automatiquement toutes les n secondes.
*'''ARCHIVEROOT :''' Dossier où sont stockés les fichiers .MAP - à utiliser avec MapOut.
*'''USER_ICON :''' (YES|NO) Permet d'activer ou non l'icône d'utilisateur dans la barre de menu.
*'''UNICODE :''' (YES|NO) Permet d'activer le mode Unicode (UCS2).
*'''MAP_006FILE_BASE :''' Dans l'interface de gestion des fichiers, il s'agit de l'emplacement à partir duquel Mapping commencera à parcourir les fichiers. Par défaut, il est vide, ce qui signifie que les fichiers seront parcourus à partir de la racine du lecteur «C:» sous Windows et «/» sous Unix.
*'''CASHTRANSACTION_ID :''' Pour une utilisation avec MPCM, la solution de couponing pour les détaillants développée par Mapping. Obsolete.
*'''CASHREDIRECTOR_ID :''' Pour une utilisation avec MPCM, la solution de couponing pour les détaillants développée par Mapping. Obsolete.
*'''TXT_SPACE_RATIO''': Utilisé en conversion vers Texte ou XML. Modifie la taille d'un espace. Valeur à virgule. 1 blanc devient x blancs. Par défaut = 1,25

===MAIL ALERT=== 
Les paramètres décrits dans cette section permettent de configurer les alertes automatiques par courrier électronique. Par exemple, pour envoyer automatiquement un courrier électronique lorsque les clés logicielles du produit sont sur le point d'expirer.


*'''MAP_MAIL_ALERT_ENABLED :''' (YES|NO) Activer / désactiver les alertes par courrier électronique.
*'''MAP_MAIL_ALERT_SERVER :''' Serveur de messagerie SMTP (e.g. 192.168.1.1).
*'''MAP_MAIL_ALERT_DOMAIN :''' Controleur du domaine du serveur.
*'''MAP_MAIL_ALERT_LOGIN :''' Nom d'utilisateur de connexion au serveur.
*'''MAP_MAIL_ALERT_PASSWD :''' Mot de passe de connexion au serveur.
*'''MAP_MAIL_ALERT_FROM :''' Adresse e-mail de l'expéditeur.
*'''MAP_MAIL_ALERT_TO :''' Adresse e-mail du destinataire.

===LDAP=== 
Les paramètres décrits dans cette section permettent de configurer la connexion à un annuaire LDAP


*'''LDAP_ACCESS :''' (YES|NO) Activer / désactiver l'accès LDAP. Ce mode est obsolète, au profit d'une configuration LDAP effectuée au niveau du serveur web Apache.
*'''LDAP_HOST :''' Adresse IP du serveur LDAP.
*'''LDAP_HOST_BACKUP :''' l'adresse IP du serveur Backup LDAP.
*'''LDAP_DN :''' CN=Firstname LASTNAME,CN=Users,DC=domain,DC=local.
*'''LDAP_PWD :''' Password.
*'''LDAP_BASE_USERS :''' CN=Users,DC=domain,DC=local.
*'''LDAP_BASE_GROUPS :''' OU=Distribution Groups,OU=MyBusiness,DC=domain,DC=local.
*'''LDAP_UID :''' Login.
*'''LDAP_USERSFILTER :''' User class filter.
*'''LDAP_GROUPSFILTER :''' Groups class filter.
*'''LDAP_USERSLIST :''' Members list (e.g. member).
*'''LDAP_GROUPSLIST :''' Groups list (e.g. memberOf).

===WORKFLOW=== 


* Configuration du mode de workflow par défaut :
** '''USE_NEW_RULES''' : (YES|NO) Permet d'activer ou nom le mode Workflows graphiques pour le moteur de règles.
* Configuration du WebService SOAP (mapsoapserver.exe) :
** '''SOAP_DEBUG''' : (YES|NO) Permet d'activer le mode debug du WebService
** '''SOAP_PATH_TEMP''' : Chemin de travail du workflow, des fichiers temporaires y seront créés
** '''SOAP_PATH_LOG''' : Chemin de stockage des logs, des fichiers .log y seront créés
** '''SOAP_LOCATION''' : URL du service de workflow, formaté en URL, par défaut http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe
** '''SOAP_LOCAL_URL''' : Obsolète
** '''SOAP_DOCUMENT_URL''' : Obsolète
* Valeurs par défaut du serveur d'envoi de mails :
** '''MAIL_SERVER''' : Hostname (ou Adresse IP) de votre serveur SMTP
** '''MAIL_DOMAIN''' : Domaine associé à votre serveur SMTP
** '''MAIL_PORT''' : Port de connexion (par défaut 587 en TLS)
** '''MAIL_LOGIN''' : Login d'identification au serveur SMTP
** '''MAIL_PASSWORD''' : Mot de passe associé à ce login
** '''MAIL_FROM''' : Adresse émettrice qui sera renseignée dans le champ "From"
* Valeurs par défaut du contenu des boites d’interactivité Web et SOAP :
** '''DEFAULT_FILE_TYPE''' : Chemin du fichier html qui servira de modèle pour l'envoi SOAP (''Boite afficher réponse dans'')
** '''DEFAULT_MAIL_BODY''' : Chemin du fichier qui servira de modèle pour l'envoi d'un mail
** '''DEFAULT_ RESPONSE_BODY''' : Contenu type du body d'un mail
* Autres :
** '''PATH_CONFIG_CUSTOM_ACCESS''' : Chemin vers un dossier contenant des conf xml. Elles configurent des droits grace aux ACL.


* Contrôle du formatage :
** '''RESOLVE_PERPAGE''' : Valeur entière, nombre de pages
* Formats de dates
** '''MAP_CURRENT_DATE''' : Format attendu pour les dates (sans l'heure) (ex: <code>%d/%m/%Y</code>)
** '''MAP_CURRENT_TIME''' : Format attendu pour les heures (ex: <code>%H:%M:%S</code>)
** '''MAP_CURRENT_TIMESTAMP''' : Format attendu pour les dates complètes (ex: <code>%d/%m/%Y %H:%M:%S</code>)
* Suivi en base de donnée PostgresSQL (Tracking) : Obsolète
** '''TRACKING_SERVERADDRESS''' : Adresse du serveur SQL
** '''TRACKING_SERVERPORT''' : Port du serveur SQL
** '''TRACKING_SERVERUSER''' : Utilisateur enregistré dans la base SQL
** '''TRACKING_SERVERPASSWORD''' : Mot de passe correspondant
** '''TRACKING_SERVERBASENAME''' : Nom de la base où accéder
** '''TRACKING_LIB_PATH''' : Chemin vers la lib de manipulation de la base (attend une .dll)
** '''TRACKING_SERVERSCHEMA''' : Schema des tables
</translate>

Installation de Designer de différentes versions sur le même poste

2021-01-20T14:20:59Z

Kbonte :

<languages/>
<translate>
=Introduction= 
Dans le cadre d'une mise à jour de Mapping il est parfois nécessaire lors d'une bascule progressive de faire cohabiter deux versions de Designer sur un ordinateur. Par défaut lors de l'exécution d'un setup de M-Designer celui-ci va vérifier la présence d'un Designer existant et le patcher si cela est le cas.

=Solution= 
==Explication==
Lors de l'exécution du Setup M-Designer fourni par notre support Mapping celui-ci va venir lire le registre Windows pour trouver la trace d'une installation précédente. Il va notamment trouver le chemin du binaire principale (M-Designer.exe ou MapDraw.exe en fonction de la version). Afin de contourner cela il existe une solution afin de conserver l'ancien Designer à côté du nouveau sur le même ordinateur.
==Procédure==
Dans votre dossier d'installation de Designer, suivez les étapes suivantes :
#'''Renommez le binaire M-Designer.exe ou MapDraw.exe''' en ajoutant un suffixe (_OLD par exemple) mais en gardant l'extension ".exe"
#Executez le Setup fourni par le support Mapping Suite et lorsque celui-ci vous le propose faite '''repair''', cela va patcher les dépendances du designer et installer le nouveau binaire M-Designer.exe. Le précédent binaire sera conservé car son nom n'est plus celui connu dans le registre.
#Rendez-vous dans votre dossier d'installation du Designer afin de vérifier la présence des deux Binaire dans ce même dossier.
#'''IMPORTANT''' Il n'existera plus de raccourci dans le menu démarrer pour cette ancienne verison de M-Designer celui-ci ayant remplacé par le nouveau à l'installation, cependant vous pouvez aisément créer un raccourci en faisant clic droit puis "créer un raccourci".
'''Recommandation''' Nous recommandons également l'installation de M-Designer dans un dossier MAPPING à la racine de votre disque '''(Exemple: C:\MAPPING\M-Designer\)'''
</translate>

Installation de Designer de différentes versions sur le même poste

2020-12-30T15:31:48Z

Kbonte : Page créée avec « <languages/> <translate> =Introduction=  Dans le cadre d'une mise à jour de Mapping il est parfois nécessaire lors d'une bascule progressive de faire cohabiter... »

<languages/>
<translate>
=Introduction= 
Dans le cadre d'une mise à jour de Mapping il est parfois nécessaire lors d'une bascule progressive de faire cohabiter deux versions de Designer sur un ordinateur. Par défaut lors de l'exécution d'un setup de M-Designer celui-ci va vérifier la présence d'un Designer existant et le patcher si cela est le cas.

=Solution= 
==Explication==
Lors de l'exécution du Setup M-Designer fourni par notre support Mapping celui-ci va venir lire le registre Windows pour trouver la trace d'une installation précédente. Il va notamment trouver le chemin du binaire principale (M-Designer.exe ou MapDraw.exe en fonction de la version). Afin de contourner cela il existe une solution afin de conserver l'ancien Designer à côté du nouveau sur le même ordinateur.
==Procédure==
Dans votre dossier d'installation de Designer '''[C:\Program Files (x86)\MapDraw (ou M-Designer) par défaut]''', suivez les étapes suivantes :
#'''Renommez le binaire M-Designer.exe ou MapDraw.exe''' en ajoutant un suffixe (_OLD par exemple) mais en gardant l'extension ".exe"
#Executez le Setup fourni par le support Mapping Suite et lorsque celui-ci vous le propose faite '''repair''', cela va patcher les dépendances du designer et installer le nouveau binaire M-Designer.exe. Le précédent binaire sera conservé car son nom n'est plus celui connu dans le registre.
#Rendez-vous dans votre dossier d'installation du Designer afin de vérifier la présence des deux Binaire dans ce même dossier.
#'''IMPORTANT''' Il n'existera plus de raccourci dans le menu démarrer pour cette ancienne verison de M-Designer celui-ci ayant remplacé par le nouveau à l'installation, cependant vous pouvez aisément créer un raccourci en faisant clic droit puis "créer un raccourci".
</translate>

ONYX:9.0:ONYX Designer

2020-12-30T15:03:58Z

Kbonte : /* Trucs et astuces */

===Installation===

*[[ONYX:9.0:Installation:Guide d'installation ONYX Designer|Guide d'installation ONYX Designer]]

===Utilisation===

*[[ONYX:9.0:Utilisation:Utilisation de ONYX Designer|Utilisation de ONYX Designer]]
*[[ONYX:9.0:Utilisation:Fonctionnement des groupes|Fonctionnement des groupes]]
*[[ONYX:9.0:Utilisation:Designer_-_Utiliser_des_étiquettes_RFID_avec_des_imprimantes_Zebra|Utiliser des étiquettes RFID]]
*[[ONYX:9.0:Utilisation:Fonctionnement des graphiques|Fonctionnement des graphiques]]

=====A partir de la version 10.1=====

*[[ONYX:Utilisation:Personnalisation de l'interface Designer|Personnalisation de l'interface Designer (Beta Version)]]

===Bonnes pratiques===

*[[ONYX:9.0:Utilisation:Les bonnes pratiques ONYX Designer|Bonnes pratiques ONYX Designer]]

===Problèmes connus===

*[[ONYX:9.0:KB:Designer cesse de fonctionner sous Windows 10|Designer cesse de fonctionner sous Windows 10]]
*[[ONYX:9.0:KB:Designer_Erreur_de_polices_manquantes|Problème de polices introuvables (bien qu’installées) sur Designer avec Win10]]

===Trucs et astuces===

*[[ONYX:9.0:Utilisation:Création d'un code barre avec plusieurs informations du spool|Création d'un code barre avec plusieurs informations du spool]]
*[[Installation de Designer de différentes versions sur le même poste]]

ONYX:9.0:ONYX Designer

2020-12-30T13:26:23Z

Kbonte : /* Trucs et astuces */

===Installation===

*[[ONYX:9.0:Installation:Guide d'installation ONYX Designer|Guide d'installation ONYX Designer]]

===Utilisation===

*[[ONYX:9.0:Utilisation:Utilisation de ONYX Designer|Utilisation de ONYX Designer]]
*[[ONYX:9.0:Utilisation:Fonctionnement des groupes|Fonctionnement des groupes]]
*[[ONYX:9.0:Utilisation:Designer_-_Utiliser_des_étiquettes_RFID_avec_des_imprimantes_Zebra|Utiliser des étiquettes RFID]]
*[[ONYX:9.0:Utilisation:Fonctionnement des graphiques|Fonctionnement des graphiques]]

=====A partir de la version 10.1=====

*[[ONYX:Utilisation:Personnalisation de l'interface Designer|Personnalisation de l'interface Designer (Beta Version)]]

===Bonnes pratiques===

*[[ONYX:9.0:Utilisation:Les bonnes pratiques ONYX Designer|Bonnes pratiques ONYX Designer]]

===Problèmes connus===

*[[ONYX:9.0:KB:Designer cesse de fonctionner sous Windows 10|Designer cesse de fonctionner sous Windows 10]]
*[[ONYX:9.0:KB:Designer_Erreur_de_polices_manquantes|Problème de polices introuvables (bien qu’installées) sur Designer avec Win10]]

===Trucs et astuces===

*[[ONYX:9.0:Utilisation:Création d'un code barre avec plusieurs informations du spool|Création d'un code barre avec plusieurs informations du spool]]
*Installation de Designer de différentes versions sur le même poste

OPALE:10.0:Migration:Process de migration

2020-04-07T13:34:09Z

Kbonte :

<languages />
<translate>
==Introduction== 


Cet article décrit le processus permettant de mettre à niveau OPALE Server sur un serveur IBM i. 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 à rassembler=== 


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 IBM i(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épertoires 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 IBM i afin de copier les formats Designer et Connect ainsi que les règles et relations entre Outqs. Les maquettes ne sont pas regénérées.

====Etape 1 : Copie des formats Designer et Connect==== 
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 et M-Connect===== 


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

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

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

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

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


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, MAPLOAD

====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.


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

====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
Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY

====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'
</translate>

OPALE:10.0:Migration:Process de migration

2020-04-07T13:28:33Z

Kbonte :

<languages />
<translate>
==Introduction== 


Cet article décrit le processus permettant de mettre à niveau OPALE Server sur un serveur IBM i. 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 à rassembler=== 


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 IBM i(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épertoires 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 IBM i afin de copier les formats Designer et Connect ainsi que les règles et relations entre Outqs. Les maquettes ne sont pas regénérées.

====Etape 1 : Copie des formats Designer et Connect==== 
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 et M-Connect===== 


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

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

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

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

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

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


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, MAPLOAD

====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.


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

====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
Le langage de génération est paramétré grâce au paramètre YYYYYYYYYYYY

====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'
</translate>

ONYX:9.0:Utilisation:Paramètres de configuration principaux (mapping.conf)

2019-09-30T14:21:19Z

Kbonte : Mise en avant des noms de paramètres.

===ONYX SERVER===

Configuration ONYX de base

*'''SYSTEM''' ''':''' Système d'exploitation.
*'''VERSION''' ''':''' Version attribuée au système d'exploitation.
*'''ARCHIVE_RELEASE''' ''':''' Version d'archivage.
*'''COMPANY_NAME''' ''':''' Nom de la société.
*'''LANGUAGE''' ''':''' Langue utilisée (Français ou Anglais).
*'''DATE_FORMAT''' ''':''' Format de la date (e.g. DD/MM/YYYY).
*'''TIME_FORMAT''' ''':''' Format d'affichage des heures (12 or 24).
*'''PATH_BASE_MAPPING''' ''':''' Chemin par défaut (e.g. C:\Mapping\M-Processing_Server).
*'''PATH_BIN''' ''':''' Chemin du binaire (e.g. C:\Mapping\M-Processing_Server\Applications).
*'''CONFIG''' ''':''' Fichier de configuration (e.g. C:\Mapping\M-Processing_Server\Settings\mapping.conf).
*'''GROUP_ADMIN''' ''':''' Groupe Administrateur (e.g. mapadmin (default)).
*'''USER_ADMIN''' ''':''' Nom d'utilisateur Administrateur (e.g. mapadmin (default)).
*'''EDITOR''' ''':''' Chemin du Text Editor. Linux only (e.g. vi (default)).
*'''MAPPING_VERSION''' ''':''' Version ONYX installée (e.g. autogenbuild_v9.0.0b.37402).

[[Fichier:OX S MPS.png|centré|sans_cadre|715x715px]]

===WEB CONFIG===
Paramètres du serveur web

*'''CGI_BIN :''' Emplacement où sont stockés les exécutables du serveur Web.
*'''MAPWEB_CMDIN :''' Historique des commandes exécutées.
*'''MAPWEB_LOGIN :''' Historique des adresses atteintes (clics de souris sur les icônes et les boutons).
*'''MY_SERVER :''' Dossier où sont stockés les fichiers utilisés par le serveur Web. Ne pas modifier !
*'''PATH_MENU :''' Dossier où sont stockés les fichiers de menu. Ne pas modifier !
*'''ROOT_MENU :''' Dossier racine où la structure de menu commence.
*'''MAPPING_TRANSLATE :''' Chemin d'accès aux fichiers de traduction.
*'''PATH_VIEW_SETTINGS :''' Chemin d'accès au fichier de configuration utilisé pour configurer le mode d'affichage des différents types de fichiers de spool dans le spouleur.
*'''PCL_SPOOLS_VIEW :''' Format de prévisualisation par défaut pour les fichiers spool PCL: TEXT ou PDF. Si réglé sur TEXT, les fichiers seront affichés dans l'éditeur de texte préféré (text / plain). Si défini sur PDF, les fichiers s'ouvriront dans l'application PDF spécifiée. Voir le contenu de ViewSettings.conf pour les commandes.
*'''NB_LINE_IN_VIEW :''' Nombre maximal de lignes affichées dans le spouleur, 1000 étant la valeur recommandée.
*'''CONTEXT_MENU :''' Pour activer (« on ») ou désactiver (« off ») le menu déroulant au niveau du coin en haut à gauche. s’il est réglé sur «off», le menu est masqué. Les valeurs ne sont pas sensibles à la casse.
*'''TOOLSBAR_MENU :''' Pour activer (« on ») ou désactiver (« off ») les 4 icônes dans le coin inférieur gauche (Précédent, Actualiser, Menu principal et Déconnexion) et les images du menu.
*'''VIEW_SECURITY_LEVEL :''' Pour gérer les autorisations d'accès aux différents objets des profils ou des groupes d'utilisateurs.
*'''SPOOL_SECURITY :''' Pour gérer les autorisations d'accès aux différents fichiers pour les profils utilisateur ou les groupes.
*'''XPSVIEWER :'''
*'''SPOOL_TITLE_WIDTH :'''
*'''GUI_DISPLAY_ENVIRONMENT_LABEL :''' Texte affiché sur le bandeau de l'environnement.
*'''GUI_DISPLAY_ENVIRONMENT_COLOR :''' Code couleur du bandeau de l'environnement.

[[Fichier:OX S webconfig.png|centré|sans_cadre|739x739px]]

===SPOOLER CONFIG===

Paramètres de configuration du spouleur ONYX.

*'''PATH_SPOOLER :''' Dossier où sont stockés les fichiers de configuration du spouleur (e.g. ...\Spooler).
*'''DAEMON_ID :''' Spooler daemon (e.g. map_daemon.ID).
*'''PORT_SOCKET_DAEMON :''' Daemon port (e.g. 2000).
*'''IP_SERVER_DAEMON :''' Daemon IP address (e.g. 127.0.0.1).
*'''NB_SOCKET_DAEMON :''' Nombre de sockets pour le daemon (e.g. 100).
*'''LISTEN_PORT :''' Daemon port d'écoute (e.g. 515).
*'''MAP_SERVER_MAIL :''' Adresse Ip du serveur Mail (e.g. 127.0.0.1).
*'''MAP_DOMAIN_MAIL :''' Domaine du serveur Mail (e.g. domain.local).
*'''TIMEOUT_TO_WAIT_SEC :''' Délai de connexion des applications clientes au démon (e.g. 60).
*'''NB_MAX_PRINTER_EXECUTION :'''
*'''LOAD_SPOOLS_ON_VIEW :'''

[[Fichier:OX S SpoolerConf.png|centré|sans_cadre|754x754px]]

===MAP_SCANFOLDER CONFIG===
Configuration du SCANFOLDER (point d’entrée)

*'''SCANFOLDER_ID :''' Identifiant (e.g. map_scanfolder.ID).
*'''MAP_SCANFOLDER_TIMER :''' Intervalle de temps entre deux SCANFOLDER– exprimé en secondes (e.g. 6).
*'''CONFIG_PATH_ROBOT :''' Chemin vers le fichier de configuration du robot (e.g. ...\Settings\robot.conf).
*'''CHECK_FTP_FILE_ACCESS :''' Active le timeout en cas de depot de fichier par FTP, pour le depot complet d'un fichier (ne fonctionne que sous Windows)
*'''FTP_TIMEOUT_SEC :''' Si les fichiers sont envoyés via FTP, il s'agit du temps d'attente maximal pour accéder aux fichiers.– exprimé en secondes (e.g. 10).
*'''SCANFOLDER_PATH_DUP_FILES :''' Chemin où les fichiers déjà traités par le moteur de règles seront déplacés.
*'''SCANFOLDER_FILTER :''' Filtre par défaut pour les fichiers à ne pas prendre (e.g. *.tmp).
*'''SCANFOLDER_ACCEPT :''' Filtre par défaut pour les fichiers à ramasser (e.g. *.xml, pour ne prendre que les fichiers avec cette extension).

[[Fichier:OX S SCANFOLDER.png|centré|sans_cadre|854x854px]]

===MAP_RAWD CONFIG===

Paramètres de configuration du daemon du protocole RAW.

*'''MAPRAWD_ID :''' Identifiant du serveur d'écoute.
*'''MAPRAWD_CONFIGFILE :''' Chemin de configuration du serveur d'écoute file (e.g. ...\Settings\maprawd.conf).
*'''MAPRAWD_SERVERSTDIN :''' Chemin d'accès au fichier d'entrée du serveur d'écoute.
*'''MAPRAWD_SERVERSTDOUT :''' Chemin d'accès au fichier d'entrée du serveur d'écoute.
*'''MAPRAWD_SERVERSTDERR :''' Chemin d'accès au fichier d'erreur du serveur d'écoute.

[[Fichier:OX S RAWD.png|centré|sans_cadre|778x778px]]

===MAP_STATD CONFIG===

*'''MAPSTATD_ID :'''
*'''MAPSTATD_SERVER_IP :'''
*'''MAPSTATD_PORT :'''
*'''MAPSTATD_SERVERSTDIN :'''
*'''MAPSTATD_SERVERSTDOUT :'''
*'''MAPSTATD_SERVERSTDERR :'''
*'''MAPSTATD_CONFIGFILE :'''

[[Fichier:OX S STATD CONFIG.png|centré|sans_cadre|732x732px]]

===MAP_SCHEDULER CONFIG===

Configuration des tâches planifiées du serveur.

*'''SCHEDULER_ID :''' Identifiant du serveur.
*'''SCHEDULER_TEMPO :'''
*'''SCHEDULER_SERVERSTDIN :''' Chemin d'accès au fichier d'entrée du serveur de tâches planifiées.
*'''SCHEDULER_SERVERSTDOUT :''' Chemin du fichier de sortie du serveur de tâches planifiées.
*'''SCHEDULER_SERVERSTDERR :''' Chemin d'accès au fichier d'erreur du serveur de tâches planifiées.

[[Fichier:OX S MAPSCHED.png|centré|sans_cadre|856x856px]]

===MAPREPORT CONFIG===
Les paramètres du module du serveur Connect

*[PATH_MAPREPORT] Chemin d'accès aux fichiers d'importation Connect (e.g. ...\Import\mapreport).
*[MAPREPORT_ID] identifiant du programme (e.g. map_report.ID).
*[MAPREPORT_PORT]port d'ecoute du preview (e.g. 6789).
*[MAPREPORT_SERVERSTDIN] Chemin d'accès au fichier d'entrée (e.g. ...\Temp\mapreport.stdin.txt).
*[MAPREPORT_SERVERSTDOUT] Chemin du fichier de sortie (e.g. ...\Temp\mapreport.stdout.txt).
*[MAPREPORT_SERVERSTDERR]Chemin vers le fichier d'erreur (e.g. ...\Temp\mapreport.stderr.txt).
*[MAPREPORT_SERVERTYPE] Type de la base de données (e.g. MySQL).
*[MAPREPORT_SERVERADDRESS] Adresse IP du serveur de base de données.
*[MAPREPORT_SERVERPORT] Numéro de port du serveur de base de données (e.g. 3306).
*[MAPREPORT_SERVERUSER] Nom d'utilisateur de la base de données (e.g. root).
*[MAPREPORT_SERVERPASSWORD] Mot de passe de base de données.
*[MAPREPORT_SERVERVERSION]
*[MAPREPORT_OVERFLOW]

[[Fichier:OX S ConnectConfig.png|centré|sans_cadre|642x642px]]

===USERS ACCESS===
Paramètres de configuration pour les utilisateurs et les groupes d'utilisateurs.

*[USERS_CONF] Chemin d'accès au fichier de configuration des comptes d'utilisateurs sans connexion à Active Directory (e.g. ...\Settings\USERS.conf).
*[GROUPS_CONF] Chemin d'accès au fichier de configuration des comptes de groupe sans connexion à Active Directory (e.g. ...\Settings\GROUPS.conf).
*[HTPASSWD_BIN] Chemin de l'exécutable qui crée les mots de passe (e.g. ...\apache\bin\htpasswd.exe).
*[HTPASSWD_FILE] Fichier où les mots de passe sont stockés (e.g. ...\MapHTTPServer\htpasswd).
*[USER_INFO] Mot de passe nom de fichier sur le système (e.g. ...\passwd on Windows or /etc/passwd on Unix).
*[GROUP_INFO]
*[PRINTER_INFO]
*[AUTH_MOD]

[[Fichier:OX S USR.png|centré|sans_cadre|861x861px]]

===LOGS===
Paramètres du fichier LOG

*[PATH_LOG] Chemin où sont stockés les fichiers log du spouleur (e.g. ...\Spooler\logs).
*[PATH_LOG_CONF] Fichier "traduction" pour les fichiers log de mapping. Les messages ne sont pas enregistrés dans la log, mais ils sont remplacés par un index traduit à l'aide de ce fichier (e.g. ...\Settings\log.conf).
*[DAEMON_LOG] Fichier log du spouleur (e.g. map_daemon.log)
*[LPR_LOG] Fichier log du LPR (e.g. map_lpr.log).
*[CONTROL_LOG] Fichier log du map_control log file (e.g. map_control.log).
*[LPD_LOG] Fichier log du LPD (e.g. map_lpd.log).
*[PJL_LOG] Fichier log du map_raw (e.g. map_raw_log).
*[LOG_LEVEL] Log des niveaux de verbosité 1 à 4, 4 étant le niveau le plus élevé.
*[STATS_TRACES] Pour activer l'utilisation de statistiques. Haut ou bas. Pas sensible à la casse.
*[MAPPING_USAGE_REPORT] Pour activer / désactiver les statistiques sur la quantité de ressources processeur utilisée par Onyx, Connect et le spouleur.

[[Fichier:OX S LOG.png|centré|sans_cadre|863x863px]]

===MAPCPYSPLF===
Configuration de la commande mapping MAPCPYSPLF

*[MAPCPYSPLF_MAPMOD] Processing mode: C to print; D to print and archive in M-Storage format; O to archive in M-Storage format only; U: Unix Archive, the spool files are copied to the folder; K: Print and Unix Archive, the spool files are printed then copied to [PATH_ARCHIVE].
*[MAPCPYSPLF_PAGM] Page size (e.g. A4).
*[MAPCPYSPLF_LANG] Print language, PCL by default. Values are not case sensitive.
*[MAPCPYSPLF_STATE] Spool file status. Ready to print (RDY) or held (HLD). Values not case sensitive.
*[MAPCPYSPLF_KEEP] Keep spool file in the Saved state (YES or NO).
*[MAPCPYSPLF_SNDFDP] Send overlay (YES or NO).
*[MAPCPYSPLF_SNDPOL] Send fonts (YES or NO).
*[MAPCPYSPLF_SNDLGO] Send images (YES or NO).
*[MAPCPYSPLF_LENGTHIN] Obsolete.
*[MAPCPYSPLF_LENGTHOUT] Obsolete.
*[MAPCPYSPLF_STARTPAGE] Start page.
*[MAPCPYSPLF_STOPPAGE] End page.
*[MAPCPYSPLF_LENGTHREC] Spool file width (length of a record).
*[MAPCPYSPLF_SPOOLNAME] Spool file title.
*[MAPCPYSPLF_OVERFLOW] Number of lines per page.
*[MAPCPYSPLF_ONEFILE] Obsolete.
*[MAPCPYSPLF_DECIMAL] Decimal separator.
*[MAPCPYSPLF_THOUSAND] Thousands separator.
*[MAPCPYSPLF_CODEPAGE] Code page.

[[Fichier:OX S MAPCPYSPLF.png|centré|sans_cadre|607x607px]]

===DEFAULT SPOOL FILES VALUES===
Attributs de fichier spool par défaut récupérés s'ils ne sont pas spécifiés dans la commande.

*[DEFAUT_SPOOL_SAVE] Enregistrer le fichier spool. YES or NO. Valeurs non sensibles à la casse.
*[DEFAUT_SPOOL_PTY] Priorité du fichier spool, 1 étant la plus basse. Valeurs prises en charge 1 à 20.
*[DEFAUT_SPOOL_NBCOPY] Nombre de copies.
*[DEFAUT_SPOOL_RETENTION] Nombre de jours pendant lesquels les fichiers de spool seront conservés.
*[DEFAUT_SPOOL_COMPRESS] Champs "Date de compression". Attribut hérité du monde AS/400 parfois utilisé par les applications clientes amont et aval.
*[DEFAUT_SPOOL_STARTPAGE] Début de page.
*[DEFAUT_SPOOL_STOPPAGE] Fin de page.
*[DEFAUT_SPOOL_SECURITY] Niveau de sécurité. 0 par défaut, équivalent à 777
*[DEFAUT_SPOOL_CODECOMPTA] Code de numérotation de fichier spool utilisé en comptabilité (non utilisé en interne)
*[DEFAUT_SPOOL_FIDELITY] "Fidelity" attribut (non utilisé en interne). Attribut hérité du monde AS / 400 parfois utilisé par les applications clientes amont et aval (e.g. DEFAULT_FIDELITY).
*[DEFAUT_SPOOL_PAPERSTATUS] Type de papier chargé dans l'imprimante (e.g. DEFAULT_PAPER).
*[DEFAUT_SPOOL_HOST] Host name (e.g. DEFAULT_HOST).
*[DEFAUT_SPOOL_USER] Default username (e.g. DEFAULT_USER).

[[Fichier:OX S ValuesSpool.png|centré|sans_cadre|680x680px]]

===MAPERPORT EXPERT===
Paramètres Expert CONNECT

*[SHELL_MAPREPORT] Chemin du script de menu Connect.
*[MENUS_MAPREPORT] Dossier où les projets sont importés.
*[PATH_DES] Dossier où les projets sont importés.
*[PATH_DBF] Dossier où les projets sont importés.
*[PATH_DBL] Dossier où les projets sont importés.
*[PATH_DBC] Dossier où les projets sont importés.
*[PATH_DBW] Dossier où les projets sont importés.
*[MAPREPORT_DEFAULT_FILTRE_TABLE] Valeur par défaut du filtre de nom de table dans Connect--> Extract (e.g. %).
*[MAPREPORT_DEFAULT_FILTRE_OWNER] Valeur par défaut du filtre propriétaire de la table dans Connect--> Extract (e.g. %%).

[[Fichier:OX S EXPERTCONNECT.png|centré|sans_cadre|806x806px]]

===EXPERT PATH===

*[PATH_IMPORT] Chemin où les templates de document sont générés par Designer (e.g. ...\Import).
*[PATH_PGM] Chemin où les templates de document sont importés.
*[PATH_HELP] Chemin où sont stockés les fichiers de traduction binaires.
*[PATH_PCL] Chemin où les templates de document PCL sont importés.
*[PATH_AFPDS] Chemin où les templates de document AFP sont importés.
*[PATH_ZEBRA] Chemin où les templates de document ZEBRA sont importés.
*[PATH_DPL] Chemin où les templates de document DPL sont importés.
*[PATH_IGP] Chemin où les templates de document IGP sont importés.
*[PATH_TEC] Chemin où les templates de document TEC sont importés.
*[PATH_IPL] Chemin où les templates de document IPL sont importés.
*[PATH_F_D] Chemin où les templates de document F_D sont importés.
*[PATH_PDF] Chemin où les templates de document PDF sont importés.
*[PATH_XPS] Chemin où les templates de document XPS sont importés.
*[PATH_EPL] Chemin où les templates de document EPL sont importés.
*[PATH_FONT_TTF] Dossier où sont stockés les fichiers de police (*.ttf) utilisés dans les templates de document.
*[PATH_FONT_XPS]
*[LIB_PATH] Chemin d'accès aux fichiers binaires du spouleur.
*[PATH_ARCHIVE] Chemin où sont stockés les fichiers d’archive Unix (mapcpysplf –mapmod: U).
*[PATH_TEMP] Chemin du dossier temporaire.
*[PATH_STATBIN]
*[PATH_MAP_DAEMON] Nom du binaire map_daemon.
*[PATH_MAP_EXEC] Nom du binaire map_exec.
*[PATH_MAP_LPD] Nom du binaire map_lpd.
*[PATH_MAP_LPR] Nom du binaire map_lpr.
*[PATH_MAP_AXIOHM] Nom du binaire du pilote Axiohm.
*[PATH_MAP_SAMSUNG] Nom du binaire Samsung.
*[PATH_MAP_POS]
*[PATH_MAP_RAW] Nom du binaire map_raw.
*[PATH_MAP_MAIL] Nom du binaire map_mail.
*[PATH_MAP_WIN32PRT]
*[PATH_MAP_USBPRT]
*[PATH_MAP_COMPRT]
*[PATH_MAP_RAWD] Nom du binaire map_rawd.
*[PATH_MAP_STATD]
*[PATH_MAP_SPLF] Nom du binaire map_splf.
*[PATH_MAP_LPSTAT] Nom du binaire map_lpstat.
*[PATH_CONF_IMP] Chemin et nom du fichier de numéro d'information renvoyé par l'imprimante.
*[PATH_QUEUES] Dossier où les files d'attente et les périphériques du spouleur sont stockés.
*[PATH_FIFOS] Dossier où sont stockés les fichiers FIFO du spouleur.
*[PATH_ETC_QUEUES] Dossier où sont stockés les fichiers de configuration des files d'attente et des périphériques.
*[PATH_INFO] Dossier où sont stockés les fichiers d'informations des files d'attente et des périphériques.
*[PATH_STDIN] Chemin + nom du fichier qui reçoit le stdin.
*[PATH_STDOUT] Chemin + nom du fichier qui reçoit le stdout.
*[PATH_STDERR] Chemin + nom du fichier qui reçoit le stderr.
*[RULES_PATH] Chemin où sont stockées les règles opérationnelles du spouleur.
*[STATS_PATH] Chemin où les projets utilisés sont stockés (e.g. ...\Spooler\stats).
*[PATH_COUNTER_SPLF] Nom du fichier contenant le compteur d'id de fichier de spool.
*[PATH_QUEUE_DEF] Nom du fichier de configuration des files d'attente et des périphériques.
*[ARCHIVE_IMPORT_PATH] Chemin à partir duquel les sauvegardes sont importées (Deployments management).
*[ARCHIVE_EXPORT_PATH] Chemin où les sauvegardes sont exportées (Deployments management).
*[DEPLOYMENT_CUSTOM_LOGFILE] Chemin + nom du log de sauvegarde.
*[MAPPING_PATCH] Pour gérer les correctifs dans un environnement multiplateforme.
*[PATH_KEYFILE]
*[PATH_GHOSTSCRIPT]

[[Fichier:OX S ExpertPath.png|centré|sans_cadre|673x673px]]
[[Fichier:OX S ExpertPath1.png|centré|sans_cadre|642x642px]]
[[Fichier:OX S Path2.png|centré|sans_cadre|681x681px]]

===EXPERT OPTIONS===
Paramètres experts supplémentaires

*[AIXTO19U_TABLE] Table de conversion de caractères.
*[19UTOAIX_TABLE] Table de conversion de caractères.
*[EBCDICTOASCII_TABLE] Table de conversion de caractères.
*[ASCIITOEBCDIC_TABLE] Table de conversion de caractères.
*[MAPCPYSPLF_TMPCNT] Compteur du fichier pour les fichiers Remap temporaires.
*[MAPCPYSPLF_MAPCNT] Remap compteur de fichier.
*[LIST_OBJ] Chemin d'accès apour lister le fichier lstobj.txt.
*[PRINT_INFO] Chemin + nom du fichier de configuration du printer bin.
*[EURO] Chemin + nom du fichier de configuration des taux de conversion de devise.
*[MESSAGES] Chemin + nom du fichier de message binaire.
*[PASSWORD] Fichier de mot de passe pour se connecter à Map Out.
*[MAPKEY] Chemin + nom du fichier de licence du logiciel.
*[UCINFO] Fichier texte contenant des informations sur le processeur et le système.
*[MAPWEB_FUNCTIONS] Not used.
*[RULES_CONDITIONS] Chemin + nom de fichier contenant les valeurs par défaut des conditions de paramètres du moteur de règles.
*[RULES_PARAMETERS] Chemin + nom du fichier contenant les valeurs par défaut des paramètres du moteur de règles.
*[RULES_COMMANDS] Chemin + nom du fichier contenant les valeurs par défaut des commandes du moteur de règles.
*[RULES_809] Nom par défaut du fichier de règles.
*[RULES_TABLES] Chemin + nom du fichier contenant la liste des tables de résolution.
*[HOST_LPD] Fichiers "hôtes" pour le LPD.
*[RESLIB] Chemin où sont stockées les ressources AFP (pour InfoPrint Manager).
*[STATS_SHELL] Nom du binaire qui exécute les statistiques, c'est-à-dire map_stats.bat.
*[IMPORT_BACKUP] Si la valeur est "yes", cela sauvegardera les fichiers lorsqu'un format est importé.
*[IMPORT_FONT] Pour écraser les polices lors de l'importation d'un format. YES or NO.
*[PATH_EXPORT_SETTINGS] Chemin + nom du fichier de configuration de déploiement.
*[PATH_COUNTER_EXPORT] Nombre de déploiement. Chemin + nom de fichier.
*[DAEMON_NO_HOLD_ON_ERROR] Les files d'attente de type d'imprimante ne tombent pas en erreur (YES or NO).
*[DAEMON_DONT_HOLD_ENTRY_ON_ERROR] Les files d'attente de type point d'entrée ne tombent pas en erreur (YES or NO).
*[XPSCONFIG]

[[Fichier:OX S EXPERT OP.png|centré|sans_cadre|766x766px]]
[[Fichier:OX S EXPERT OP1.png|centré|sans_cadre|839x839px]]

===OTHER===

*[KILL_ON_REFRESH] Tsupprimer les fichiers binaires exécutés en arrière-plan lors de l'actualisation du Web (YES or NO).
*[REFRESH_VIEW_DELAY] Pour actualiser la vue des fichiers spoule automatiquement toutes les n secondes.
*[ARCHIVEROOT] Dossier où sont stockés les fichiers .MAP - à utiliser avec MapOut.
*[USER_ICON] Activer/désactiver les icônes utilisateur dans la barre de navigation principale (YES or NO).
*[UNICODE] Activer/désactiver les programmes Unicode (YES or NO).
*[MAP_006FILE_BASE] Dans l'interface de gestion des fichiers, il s'agit de l'emplacement à partir duquel Mapping commencera à parcourir les fichiers. Par défaut, il est vide, ce qui signifie que les fichiers seront parcourus à partir de la racine du lecteur «C:» sous Windows et «/» sous Unix.
*[CASHTRANSACTION_ID] Pour une utilisation avec MPCM, la solution de couponing pour les détaillants développée par Mapping. Obsolete.
*[CASHREDIRECTOR_ID] Pour une utilisation avec MPCM, la solution de couponing pour les détaillants développée par Mapping. Obsolete.

[[Fichier:OX S OTHERS.png|centré|sans_cadre|833x833px]]

===MAIL ALERT===
Les paramètres décrits dans cette section permettent de configurer les alertes automatiques par courrier électronique. Par exemple, pour envoyer automatiquement un courrier électronique lorsque les clés logicielles du produit sont sur le point d'expirer.

*[MAP_MAIL_ALERT_ENABLED] Activer / désactiver les alertes par courrier électronique (YES or NO).
*[MAP_MAIL_ALERT_SERVER] Serveur de messagerie SMTP (e.g. 192.168.1.1).
*[MAP_MAIL_ALERT_DOMAIN] Controleur du domaine du serveur.
*[MAP_MAIL_ALERT_LOGIN] Nom d'utilisateur de connexion au serveur.
*[MAP_MAIL_ALERT_PASSWD] Mot de passe de connexion au serveur.
*[MAP_MAIL_ALERT_FROM] Adresse e-mail de l'expéditeur.
*[MAP_MAIL_ALERT_TO] Adresse e-mail du destinataire.

===LDAP===
Les paramètres décrits dans cette section permettent de configurer la connexion à un annuaire LDAP

*[LDAP_ACCESS] Activer / désactiver l'accès LDAP (ON or OFF).
*[LDAP_HOST] Adresse IP du serveur LDAP.
*[LDAP_HOST_BACKUP] l'adresse IP du serveur Backup LDAP.
*[LDAP_DN] CN=Firstname LASTNAME,CN=Users,DC=domain,DC=local.
*[LDAP_PWD] Password.
*[LDAP_BASE_USERS] CN=Users,DC=domain,DC=local.
*[LDAP_BASE_GROUPS] OU=Distribution Groups,OU=MyBusiness,DC=domain,DC=local.
*[LDAP_UID] Login.
*[LDAP_USERSFILTER] User class filter.
*[LDAP_GROUPSFILTER] Groups class filter.
*[LDAP_USERSLIST] Members list (e.g. member).
*[LDAP_GROUPSLIST] Groups list (e.g. memberOf).

[[Fichier:OX S WRKLW1.png|centré|sans_cadre|824x824px]]
[[Fichier:OX S LDAP.png|centré|sans_cadre|685x685px]]

===WORKFLOW===

*[SOAP_DEBUG]
*[SOAP_PATH_TEMP]
*[SOAP_PATH_LOG]
*[SOAP_LOCAL_URL]
*[SOAP_LOCATION]
*[SOAP_DOCUMENT_URL]
*[USE_NEW_RULES]
*[MAIL_SERVER]
*[MAIL_DOMAIN]
*[MAIL_PORT]
*[MAIL_LOGIN]
*[MAIL_PASSWORD]
*[MAIL_FROM]
*[TRACKING_SERVERADDRESS]
*[TRACKING_SERVERPORT]
*[TRACKING_SERVERUSER]
*[TRACKING_SERVERPASSWORD]
*[TRACKING_SERVERBASENAME]
*[TRACKING_LIB_PATH]
*[TRACKING_SERVERSCHEMA]
*[DEFAULT_ADMINISTRATOR_RESPONSE]
*[DEFAULT_ADMINISTRATOR_RESPONSE_HEADER]
*[DEFAULT_FILE_TYPE]
*[DEFAULT_MAIL_BODY]
*[DEFAULT_ RESPONSE_BODY]
*[PATH_CONFIG_CUSTOM_ACCESS]
*[PATH_DJDE]
*[RESOLVE_PERPAGE]
*[MAP_CURRENT_DATE]
*[MAP_CURRENT_TIME]
*[MAP_CURRENT_TIMESTAMP]

[[Fichier:OX S WRKLW.png|centré|sans_cadre|586x586px]]

[[Fichier:OX S WRKLW1.png|centré|sans_cadre|556x556px]]