MappingDoc - Contributions de l’utilisateur [fr]

ONYX:9.0:Utilisation:Fonctionnalités avancées de ONYX Designer

2026-05-21T15:38:17Z

Nturpin :

<languages/>
<translate>
=Fonctionnalités avancées= 

==Code à barre== 

===Création d’un code à barre=== 


Pour créer un code à barre dans Designer, il suffit de créer une zone de type '''Code Barre''' et de sélectionner le sous-type de code à barre voulu.

====Les types de codes à barre==== 


*'''EAN 8''' Ce code à barre sert à tracer des unités logistiques, à identifier des unités de stockage. La version huit caractères sert au colis de petite taille. Les données doivent contenir '''sept chiffres'''. Le huitième caractère est un caractère de contrôle qui est calculé par l'ordinateur.


*'''EAN 13''' Ce code à barre sert à tracer des unités logistiques, à identifier des unités de stockage. Dans un EAN 13 les deux premiers caractères sont les identifiants du pays d'origine, les 10 autres sont les données et le dernier est le caractère de contrôle qui est calculé par l'ordinateur. Les données doivent donc contenir '''12 chiffres'''.


<ul>
<li>'''Code 39'''Ce code à barre sert à coder des données alphanumériques. Il est utilisé dans presque toutes les industries mais pas dans le commerce de détail. Les données peuvent être de longueur variable et peuvent contenir des lettres et des chiffres.L'information peut être de '''longueur quelconque''' et contenir des chiffres, des majuscules et les signes « espace », « plus », « moins », « divise », « point », « pourcentage » et « dollar ».</li></ul>


*'''Code 128''' Ils permettent de coder des données alphanumériques générales et des données ASCII. Ces codes à barre sont utilisés dans de nombreuses industries pour la gestion de stocks. Les données sont de longueur variable. Le code 128 C doit contenir un nombre pair de caractères (sinon un zéro est ajouté en début de code barre) et ne peut contenir que des chiffres. Code 128 B accepte la totalité des caractères ASCII, alors que le code 128 A n'en accepte qu'une certaine partie. L’information à coder peut être de '''longueur quelconque''' et propose un choix d'encodage :
**'''''Optimisé''''' : chiffres, majuscules, minuscules, signes ASCII affichables ou non d’ordre inférieur à 128, et tous signes et caractères de fonction prévus par le Code 128 dans les jeux A, B et C, avec optimisation systématique de longueur
**'''''N/optimisé''''' : chiffres, majuscules, minuscules, signes ASCII affichables et caractères de fonction prévus par le Code 128 dans le jeu B, sans optimisation de longueur
**'''''Numérique''''' : chiffres et caractère de fonction prévu par le Code 128 dans le jeu C, avec optimisation systématique de longueur.
*'''Code 2/5 entrelacé''' Ce codage de nombres privilégie la densité, en réponse à un cahier des charges spécifiques. La sécurité obtenue par cette symbologie est faible, sauf à employer des moyens optionnels de sécurisation (caractère de contrôle, messages de longueur fixe et contrôlée à la lecture).
**Bien que le nombre de '''longueur est quelconque''', le principe d'entrelacement impose :
**Un nombre pair de chiffres lorsque le caractère optionnel de contrôle n'est pas mis en œuvre.
**Un nombre impair de chiffres lorsque le caractère optionnel de contrôle est mis en œuvre.
*'''Code 2/5 industriel''' Cette symbologie ancienne a été très utilisée dans l'industrie, principalement automobile. La sécurité de cette symbologie est faible, sauf mise en œuvre de message de longueur fixe et contrôlée à la lecture. Les données doivent contenir de '''1 à 32 chiffres'''
**Codage d'information numérique privilégiant la facilité de mise en œuvre.
**Évolution ou modification d'applications préexistantes.


*'''EAN128 Alpha n/optimisé''' Il s'agit du code GS1-128 Utilisé pour l’identification des unités d’expédition (la palette, éventuellement le carton).
**Codage d'information alphanumérique,
**Longueur variable,
**Auto-contrôlé Continu Bidirectionnel.


*'''EAN128 numérique''' Il s'agit du code GS1-128 Utilisé pour l’identification des unités de d’expédition (la palette, éventuellement le carton).
**Codage d'information numérique,
**Longueur variable,
**Auto-contrôlé Continu Bidirectionnel.


*'''PDF 417''' Utilisé dans tous secteurs d'activité. Le code PDF417 est le seul code à barres bidimensionnel pouvant être lu à l'aide d'un lecteur linéaire (1D) car, en tant que symbologie linéaire empilée, il partage les caractéristiques des codes à barres linéaires et bidimensionnels.
**Bidimensionnel,
**Longueur 2000 Alphanumérique,
**Huit niveaux de sécurité.


*'''Data Matrix''' Ce code permet d’encoder jusqu’à 2335 caractères. Divers types d’encodage sont disponibles (ASCII, C40, Text et Base 256), le mode par défaut est le mode automatique qui permet d’optimiser l’encodage en permutant d’un mode à l’autre suivant les données. Il existe également un système de détection/correction d’erreur pour réparer toute dégradation.
*'''Postnet''' Le code à barres '''Postnet''' est utilisé par le service postal des États-Unis. Il est remplacé par l'USPS ou Intelligent Mail barcode.
*'''Planet''' Le code à barres '''Planet''' est utilisé par le service postal des États-Unis. Il est remplacé par l'USPS ou Intelligent Mail barcode.
*'''QR Code''' Il a la particularité de pouvoir encoder un très grand nombre de caractères (7336 en mode numérique). Ce type de code barre est très répandu au Japon. Il existe quatre types d’encodage (alphanumérique, numérique, octets, Kanji) permettant de compresser plus ou moins les données selon leur type. Par défaut, un mode automatique est utilisé afin de choisir l'encodage qui donnera le meilleur taux de compression (basculement de mode en cours de traitement). Des codes de détection/correction d’erreur sont ajoutés aux données, ce qui permet de résister à des dommages sans perte de données. Il existe quatre niveaux de détection/correction d’erreur.''' '''


*'''MaxiCode''' Le code à barres '''MaxiCode''', développé par UPS – United Parcel Service, est défini par la norme ISO 16023-2000. Contrairement aux autres, il a une taille fixe, ce qui limite le nombre de caractères à encoder. En effet, le nombre de caractères maximum est de 93 caractères alphanumériques ou de 138 caractères numériques. Il existe deux types d’encodage. Le premier encode uniquement une chaîne de caractères contenant des données suivant un encodage classique et une détection / correction d’erreur standard. Le second type encode, en plus de la chaîne de données, trois autres champs (le pays codé sur 3 chiffres suivant la norme ISO 3166, le code postal codé sur 6 caractères et enfin un type de service sur 3 chiffres). Ces trois champs sont encodés en utilisant un mode de correction d’erreur étendu contrairement à la chaîne de données dont le mode de correction est classique.
*'''Japan Postal''' Le code à barres '''Japan Postal''' est utilisé par le service postal du Japon.
*'''Codabar (NW7)''' Au Japon, le '''Codabar Monarch''' est aussi appelé '''NW-7'''. La composition relativement simple du Codabar Monarch fait qu'il est fréquemment utilisé pour coder des numéros de série pour les applications de banques de transfusion sanguine, services de livraisons à domicile, bibliothèques, etc.
*'''USPS''' '''USPS''' = '''U'''nited '''S'''tates '''P'''ostal '''S'''ervice. Le nom officiel est plutôt '''Intelligent Mail Barcode'''. Il s'agit du nouveau code à barres postal américain qui doit remplacer le Planet et le Postnet. L’Intelligent Mail Barcode est un code à barres à quatre états composé de 65 barres.
*'''UPC-A''' Le code à barres '''UPC-A''' est un équivalent américain du code à barres EAN13, dont le premier chiffre serait 0. Il sert principalement à identifier les produits en magasin. Le code à barres UPC-A permet l’encodage de 11 chiffres, un Number System, cinq chiffres pour le Manufacturing Code et cinq chiffres pour le Product Code. Un 12eme chiffre est calculé à partir des onze premiers pour servir de contrôle.
*'''UPC-E''' Le code à barres '''UPC-E''' est une version courte du code à barres UPC-A, les dix chiffres du code à barres UPC-A (Manufacturing et Product Code) sont réduits à six chiffres en supprimant des zéros superflus. Avec le Number System et le chiffre de contrôle un code à barres UPC-E se compose donc de huit chiffres. MapDraw permet l’encodage de code à barres UPC-A (11 chiffres) en UPC-E, mais aussi de code réduit de 6, 7 ou 8 chiffres.


*'''MSI''' Le code à barres '''MSI''' est utilisé principalement pour le contrôle des stocks, le marquage des conteneurs de stockage et des étagères dans des environnements d'entrepôt. Un code à barres MSI utilise une ou deux clé de contrôle, calculée par modulo 10 ou modulo 11 et permet d’encoder des valeurs numériques de taille indéfinie. Designer permet l’encodage soit avec une clé de contrôle modulo 10, une clé de contrôle modulo 11, deux clés modulo 10, ou encore une modulo 11 suivie d’une clé modulo 10.

====La taille du code à barre==== 


La taille du code à barre peut être définie de deux manières :


*La première consiste à choisir l'option ''Adapter à la zone'' dans la ''vue des propriétés'', le code à barre s'adaptera alors du mieux possible à la taille de la zone, selon sa norme.
*Si l'option Adapter à la zone est décochée, la taille du code à barre peut être réglée par la taille de la police de la zone. Cette taille influe sur la largeur et la hauteur du code. La hauteur peut être réduite en réduisant le pourcentage du paramètre Hauteur de la zone.

===Cumul de données=== 


Il est possible de cumuler, dans un code à barre, des données qui se trouvent à différents endroits dans le spool. Pour cela, il faut créer autant de zones mémoires qu’il y a de données à récupérer dans le spool puis il faut cumuler toutes ces zones dans le label de la zone code à barre.


*Dans la partie ''Map R'' :


[[File:onyxdesigner-image70.png|cid:image002.png@01D170A6.CBD745A0]]


*Dans la partie ''Propriétés'' :


[[File:onyxdesigner-image71.png|cid:image003.png@01D170A6.CBD745A0]]


*Dans cet exemple, les zones mémoires ont pour valeurs:
**MEM_FACT : 0012601
**MEM_DTFACT : 14/10/99


*Résultat :


[[File:onyxdesigner-image72.png|cid:image004.png@01D170A7.20EEB820]]


Il est aussi possible d’ajouter du texte qui ne se trouve pas dans le spool grâce à l’utilisation des zones '''Mémoire''' (détaillées dans le paragraphe [[#type-de-zones|''6.4.a.3 Type de zones'']]) : '''[[MEM1|<nowiki>[[MEM1]]</nowiki>]]TEXT[[[[MEM2|<nowiki>MEM2]]</nowiki>]]'''.


Si vous utilisez des zones de remplacement dans une zone '''Code à Barre''', il faut que la '''longueur de la zone''' '''code à barre''' soit égale à 0.

===Cas particulier : EAN128=== 


L’encodage de l’'''EAN128''' est identique à l’encodage du Code128, c’est pour cela que nous utilisons les mêmes polices. La différence est que l’EAN128 est structuré afin de normaliser les informations qu’il contient. Pour cela, entre chaque information est inséré un '''AI''' ('''A'''pplication '''I'''dentifier) qui permet d’identifier la donnée encodée.


Structure de l’EAN128 : START FNC1 AI DATA (FNC1) AI DATA .... (FNC1) AI DATA CRC END


'''FNC1''' : Caractère séparateur de l’EAN128.


'''AI''' : Application Identifier, permet de coder plusieurs informations normalisées dans un même code (date+heure+...).


Le premier '''FNC1''' est ajouté automatiquement par Designer. Il est obligatoire, en effet il permet de différencier un code barre EAN128 d’un code barre CODE128.


Par contre, les FNC1 suivants sont optionnels. En effet, ils sont obligatoires uniquement lorsque la donnée précédente n’est pas de longueur fixe, dans ce cas, ils permettent de séparer chaque donnée.


Si vous souhaitez insérer le caractère FNC1, il vous faut mettre dans votre spool la suite de caractères {FNC1}. Ces caractères seront remplacé automatiquement en caractère FCN1 par MAPPING.


Ex: SPOOL ----> MAPPING


AI DATA ----> START FNC1 AI DATA CRC END


AI DATA {FNC1} AI DATA ----> START FNC1 AI DATA FNC1 AI DATA CRC END


Si vous ne pouvez pas modifier votre spool pour ajouter les caractères « '''{FNC1} »''' ou si vous souhaitez cumuler plusieurs données qui se trouvent à différents endroits du spool (voir paragraphe précédent : [[#cumul-de-données|''8.1.b. Cumul de données'']]), vous pouvez utiliser les zones mémoires.

===Cas particulier : code 128=== 


Il y a trois modes d’encodage des codes à barre 128 :


*mode A (alphanumérique),
*mode B (alphanumérique). Le code 128 Alphanumérique encode en mode B,
*mode C (numérique). Le code 128 Numérique encode en mode C.


Le code 128 Alphanumérique Optimisé bascule du mode B au mode C en automatique afin d’optimiser la taille du code à barre.


Par contre, il est possible que vous ayez à respecter un formatage particulier de votre code à barre, c'est-à-dire respecter un certain nombre de caractères en mode A, B ou C.


Par exemple, le code à barre qui correspond à l’identifiant de suivi des courriers de « La Poste » contient 13 caractères. Les trois premiers doivent être encodés en mode B et les dix derniers en mode C.


Pour réaliser ce code à barre avec Designer, vous devez créer une zone de type « '''Code 128 N/Optimisé''' » puis saisir un masque de formatage dans les options '''Avancées''' de cette zone.


Exemple :


''Soit la donnée suivante'' : 1J45034500751


''Vous souhaitez encoder :''


''- les trois premiers caractères (1J4) en mode B''


''- les dix derniers caractères (5034500751) en mode C''


''Votre masque de formatage doit donc être BBBCCCCC.''


''Vous pouvez remarquer que bien qu’il y ait dix chiffres à encoder en mode C, on ne précise que cinq ‘C’ dans le masque de formatage. Cela est dû au fait qu’un caractère en mode C encode deux chiffres.''

===Cas particulier : Code Barre 2D=== 


Aujourd’hui, MAPPING gère quatre types de codes à barre 2D : '''PDF417''', '''DATA MATRIX''', '''QR CODE''' et '''MAXICODE'''.


Si l'option « '''Adapter à la zone''' » n'est pas cochée, c’est le paramètre « '''Largeur de code barre''' » qui va modifier la taille du code à barre. Dans ce cas il faut savoir que la taille des codes à barre peut varier en hauteur et largeur suivant le contenu à encoder.


L’avantage des codes à barre 2D est de pouvoir encoder un nombre important d’informations. Si les données que vous devez encoder se trouvent à différents endroits du spool, reportez-vous au paragraphe [[#cumul-de-données|''8.1.b. Cumul de données'']] afin de pouvoir les cumuler dans un code à barre unique.

====QR code==== 


Le code à barre '''QR CODE''' a été développé suivant la norme internationale ISO/IEC 18004. Il a la particularité de pouvoir encoder un très grand nombre de caractères (7336 en mode numérique).


Ce type de code barre est très rependu au Japon. Il est utilisé dans l’industrie mais également par le grand public depuis que les téléphones portables sont capables de le décoder.


Il existe quatre types d’encodage (alphanumérique, numérique, octets, Kanji) permettant de compresser plus ou moins les données selon leur type. Par défaut, le mode automatique est utilisé afin de choisir l’encodage qui donnera le meilleur taux de compression (basculement de mode en cours de traitement). Par exemple, supposons que le début de la chaine contient des données de type alphanumérique. Dès que le programme détecte une chaine d’au moins 13 caractères numériques, il change de mode d’encodage.


Des codes de détection/correction d’erreur sont ajoutés aux données. Ces codes permettent de résister à des dommages sans perte de donnée. Il existe quatre niveaux de détection/correction d’erreur. Nous utilisons par défaut le niveau trois dont les codes utilisent approximativement 25% du code à barre final.


[[File:onyxdesigner-image75.png]]


Options avancées disponibles :


*Largeur du code barre : Valeur comprise entre 1 et 15 définissants la taille du code barre.
*Error Level : (7%, 15%, 25% et 30%).
*FCN1 :
**ECI protocol not implemented.
**ECI protocol not implemented, FNC1 implied in first position.
**ECI protocol not implemented, FNC1 implied in second position Dans ce dernier cas, un caractère de séparation (application identifier) doit être précisé.
*'''A'''pplication '''I'''dentifier : Caractère de séparation, utilisé uniquement avec le FCN1 implicite en deuxième position.
*Type d’encodage :
**'''AUTO''' : Encodage automatique des données avec changement de mode en fonction des données.
**'''ALPHA''' : Encodage Alphanumérique.
**'''NUMERIC''' : Encodage Numérique.
**'''BYTE''' : Encodage en octet.

====DATAMATRIX==== 


Le code à barres '''Datamatrix''' est défini par la norme internationale ISO/IEC 16022 (ECC200). Ce code permet d’encoder jusqu’à 2335 caractères.


Divers types d’encodage sont disponibles (ASCII, C40, Text et Base 256) et le mode par défaut est le mode automatique qui permet d’optimiser l’encodage en permutant d’un mode à l’autre suivant les données.


Il existe également un système de détection/correction d’erreur pour réparer toute dégradation.


[[File:onyxdesigner-image76.png]]


Options avancées :


*Largeur du code barre : Valeur comprise entre 1 et 15 définissant la taille du code barre.
*Type d’encodage :
**'''AUTO''' : Encodage automatique des données avec changement de mode en fonction des données.
**'''ASCII''' : L’encodage ASCII est un plan tacite pour encoder les données ASCII.
**'''C40''' : L’encodage C40 transforme 3 caractères alphanumériques en deux codewords.
**'''TEXT''' : L’encodage Text est utilisé pour encoder les caractères minuscules.

====PDF 417==== 


Le PDF 417 est défini par la norme internationale ISO/IEC 15438. Ce type de code à barre permet d’encoder jusqu'à 2700 caractères numériques.


Il existe trois types d’encodage de données (alphanumérique, numérique et octets). Le mode automatique permet de choisir le meilleur taux de compression et de changer de mode en cours d’encodage.


Il existe également un mode de détection/correction d’erreur sur huit niveaux. En mode automatique, le niveau sera choisi en fonction du nombre de caractères à encoder.


[[File:onyxdesigner-image77.png]]


Options avancées :


*Largeur du code barre : Valeur comprise entre 1 et 15, définissant la taille du code barre.
*Error Level :
**AUTO : choix automatique.
**0 - 8
*Mode compact : Activation du mode compact ou non.
*Ratio : Permet de déterminer le ratio hauteur/largeur du code barre.
*Colonnes fixes : permet de définir le nombre de colonnes.
*Lignes fixes : permet de définir le nombre de lignes.


La sélection d’un ratio empêche de définir le nombre de lignes et de colonnes.

====UPS MAXICODE==== 


Ce type de code à barre, développé par UPS – United Parcel Service, est décrit dans la norme ISO 16023-2000. Contrairement aux autres, il a une taille fixe ce qui limite le nombre de caractères à encoder. En effet, le nombre de caractères maximum est de 93 caractères alphanumériques ou de 138 caractères numériques.


Il existe deux types d’encodage :


*Le premier encode uniquement une chaine de caractères contenant des données suivant un encodage classique et une détection / correction d’erreur standard.
*Le second type encode, en plus de la chaine de données, trois autres champs stockés dans trois espaces mémoire de Designer. Ces champs sont : le type de service sur 3 chiffres (map_servic), le pays codé sur 3 chiffres suivant la norme ISO 3166 (appelé map_countr), le code postal codé sur 6 caractères (map_zipcod). Ces trois champs sont encodés en utilisant un mode de correction d’erreur étendu contrairement à la chaine de données dont le mode de correction est classique.


[[File:onyxdesigner-image78.png]]


Options avancées disponibles :


*Largeur du code barre : Valeur comprise entre 1 et 15, définissant la taille du code barre.

==Automatisation== 


L’automatisation de Designer permet de créer des fichiers images correspondant à la preview d’un projet ainsi que de générer un projet ou une association de projets. Le tout en ligne de commande, en mode caché ou non.


Le principe est de construire la commande grâce à un .BAT ou à une remote commande par exemple.


*'''-InFile''' : fichier .PAG ou .XML à maquetter.
*'''-OutFile''' : Fichier image de sortie.
*'''-ProjectFile''' : Projet à ouvrir (.MPP).
*'''-ProjectAsso''' : Association de projet à générer (.MPA).
*'''-MPIFile''' : Fichier .MPI à ouvrir (onglet MAP).
*'''-MPWFile''' : Fichier .MPW à ouvrir (onglet DRAW).
*'''-Hide''' : Pour lancer Designer en mode caché.
*'''-Color''' : Utilisation de couleur ou non pour la création de l’image.
*'''-Rotation''' : angle de rotation de l’image (défaut : 0).
*'''-Resolution''' : Résolution de l’image (défaut : 300).
*'''-Specimen''' : Ajout d’un texte au-dessus de l’image (texte à préciser en argument).
*'''-Mode''' : Choix du mode SPOOL ou XML (défaut SPOOL).
*'''-Generate''' : Pour lancer la génération du projet indiqué en argument.
*'''-FtpUse''' : 0 = n’utilise pas FTP ; 1 = utilise FTP.
*'''-FtpFolder''' : répertoire FTP.
*'''-FtpLogin''' : Login FTP.
*'''-FtpPassword''' : Mot de passe FTP.
*'''-FtpIPAddress''' : Adresse IP du serveur.
*'''-ShareFolder''' : Répertoire de partage.
*'''-ServerName''' : Nom du serveur (descriptif).
*'''-Rename''' : change le FORMAT et SEQUENCE du projet en utilisant son nom. Ex : Facture00010.mpp.


Exemple 1 : Projet généré en PCL, en couleur et 300 dpi


<code>C:\Mapping\M-Designer\M-Designer.exe "-Hide" "-ProjectFile:C:\Mapping\M-Processing_Server \Import\docpc\test.mpp" "-Generate"</code>


Lors de l’utilisation du paramètre « '''-Generate''' » (indiquant une génération de projet), le paramètre « '''-ProjectFile :''' » ou « '''-ProjectAsso :''' » doit être présent pour indiquer le projet à générer.


Si les deux paramètres « '''-ProjectFile :''' » et « '''-ProjectAsso :''' » sont présents, le projet sera prioritaire pour la génération et l’association de projets sera ignorée.


Exemple 2 : création d’une image BMP couleur, avec rotation de 90°, en 203 dpi et avec l’inscription SPECIMEN par-dessus


<code>C:\Mapping\M-Designer\M-Designer.exe "-InFile:c:\test.xml" "- OutFile:c:\image.bmp" "-ProjectFile:C:\ Mapping\M-Processing_Server \Import\docpc\test.mpp" "-Hide" "-Rotation:90" "- Resolution:203" “-Color” "-Mode:XML" "-Specimen:SPECIMEN"</code>


Pour la création d’une image, les paramètres « '''-InFile''' » et « '''-ProjectFile''' » sont obligatoires.


Si « '''-OutFile''' » est absent, le fichier de sortie prend le nom du fichier d’entrée avec l’extension .BMP.


Le mode par défaut est SPOOL et si le fichier d’entrée est de type XML, vous devez préciser le mode.


'''Attention''' : Les guillemets autour de chaque paramètre sont '''obligatoires'''.




Vous pouvez également vous référer à la document de M-Designer.exe en ligne de commande : [[M-Designer Utilisation en ligne de commande|Utilisation de Designer.exe en ligne de commande]]

==Remplacement de caractère== 


L'objectif est d'expliquer comment remplacer une chaîne de caractères du fichier d'entrée par une autre.


Le principe de fonctionnement est l'utilisation d'un fichier texte comme table de correspondance entre la valeur à remplacer et la nouvelle valeur.


Pour utiliser cette table de correspondance, il faut :


*Définir la zone en mode Type = '''Texte''' / Sous-type = '''Substitution'''.


[[File:onyxdesigner-image79.png]]


*Terminer et générer la maquette
*Ouvrir le fichier ''ReplaceValue.txt'' dans un éditeur de texte (type Notepad mais pas Word). La syntaxe du fichier est la suivante :


Valeur à remplacer ''Tabulation'' Nouvelle valeur


[[File:onyxdesigner-image80.png]]


Ici, le caractère "''']'''" sera remplacé par le caractère "'''>'''" et le "'''Nom'''" sera remplacé par "'''Name'''" (si la valeur à remplacer se trouve dans une zone de Type Texte \ Substitution).

{{warning}} '''Attention:''' il est impératifs que le fichier replacevalue.txt ai le même encodage que le projet Onyx Designer. Par exemple, replaceValue.txt doit être unicode si le projet est unicode.


*Sauvegarder le fichier ''ReplaceValue.txt'' dans le sous-répertoire '''lgobitmap''' de Mapping (par défaut /apps/mapping/import/lgobitmap sur Unix)

==Dessiner un tableau== 

===Dessiner un tableau statique=== 


Pour obtenir un tableau parfaitement dessiné et aligné, sans utiliser l'outil ''Tableau Statique'' de la ''vue Fond de page'', les étapes à suivre sont :


*tracer d’abord le rectangle du contour du tableau,
*tracer des lignes verticales pour définir les colonnes,
*tracer éventuellement des traits horizontaux pour définir les lignes si besoin (entêtes de colonnes par exemple),
*sélectionner enfin l’ensemble des éléments du tableau puis appuyer sur la touche « '''a''' » minuscule du clavier :


[[File:onyxdesigner-image83.png]]


[[File:onyxdesigner-image84.png]]


'''Remarque :'''


Cette aide à la conception est opérationnelle en ''vue Fond de page'' et ''vue Dynamique'' du projet. En vue Dynamique, il est possible de tracer un tableau à l'intérieur d'un ''Groupe'' et de placer, par exemple, une condition d'exécution sur une ligne horizontale pour tracer dynamiquement un trait pour chaque nouvelle ligne de données.

===Dessiner un tableau dynamique=== 


Comme annoncé dans les options disponibles pour un groupe (cf. paragraphe [[#créer-un-groupe-fixe|''6.4.b.2. Créer un groupe fixe'']]), le mode Tableau permet aux zones du groupe de se comporter comme les cellules d’un tableau. Les zones d’une même ligne se retrouvent donc automatiquement collées.


'''Remarque :'''


Redimensionner ou déplacer une zone impacte la taille et le positionnement des zones adjacentes.


Les lignes du groupe (ou conditions) sont visuellement représentées dans la fenêtre de conception. Les zones sont, quant à elles, réparties verticalement en fonction de leur ligne.


[[File:onyxdesigner-image85.png]]

==Construction d’un graphique== 


Depuis la partie Map :


*Créer un graphique depuis l’onglet Graphique :


[[File:onyxdesigner-image86.png]]


*Et lui donner un nom (ici « '''''GRAPH1''''' ») :


[[File:onyxdesigner-image87.png]]


A partir de là, le '''graphique complexe''' peut se construire de deux façons différentes présentées ci-dessous.

===Par sélection des zones une à une=== 


*Sélectionner, dans le spool, les zones qui seront utilisées dans le graphique,
*Dans les '''Propriétés,''' pour chaque zone définie :
**Les nommer toutes avec le même nom que le graphique (ici ça sera donc « '''''GRAPH1''''' »)
**Renseigner le '''Type''' = « '''''Graphique'' '''» :


[[File:onyxdesigner-image88.png]]


*Selon l’utilité de la zone dans le graphique, sélectionner le '''Sous-type''' correspondant dans la liste proposée :


[[File:onyxdesigner-image89.png]]


*Aller dans les '''Propriétés''' du graphique et cliquer sur '''Edition''' :


[[File:onyxdesigner-image90.png]]


*Paramétrer votre graphique en choisissant dans les onglets :
**'''Type''' :
***'''Nom du Graphique''' : qui sera repris dans le nom des zones,
***'''Nombre de zones''' qui va composer le graphique,
***'''Type de graphique''' : ''Camembert'', ''Histogramme'' ou ''Ligne'' :


[[File:onyxdesigner-image91.png]]


'''NB''' : pour le type de graphique = '''''Histogramme''''', il est possible de définir l’espacement entre les barres à droite et à gauche (en %). Cette option peut permettre, par exemple, de superposer deux graphiques en jouant sur l’espacement des barres de chaque graphique.


[[File:onyxdesigner-image92.png]]


*'''Attributs''' : permet de choisir le remplissage, le contour, l’épaisseur du contour, le motif, …


[[File:onyxdesigner-image93.png]]


''' '''


*'''Positionnement''' : permet de placer les ''titres'' (X, Y, du graphique) et la ''légende'', de redimensionner le graphique selon les préférences de l’utilisateur.


'''NB''' : La zone d’impression du graphique est celle délimitée par le grand rectangle donc tout ce qui ne sera pas dedans ne sera pas visible à l’impression (ex : la zone « '''''Legend''''' » est à l’extérieur du rectangle dans la première image ci-dessous alors qu’elle est dedans dans la deuxième).


[[File:onyxdesigner-image94.png]]


[[File:onyxdesigner-image95.png]]


*La '''Légende''' se construit en sélectionnant les zones dans le spool qui serviront de légende pour les attributs choisis. Comme pour toute autre donnée, il faut nommer la zone comme le nom du graphique et renseigner les propriétés de la zone avec '''Type''' = « '''''Graphique''''' » et '''Sous-type''' = « '''''Données de la légende''''' ».


'''NB''' : Attention à respecter l’ordre des attributs en sélectionnant les zones qui serviront à la légende car elles suivront le même ordre que celui des attributs.

===En créant un groupe=== 


Le principe est le même que celui décrit ci-avant sauf que les données sont regroupées dans un groupe. Cette option est possible si les données du graphique se suivent dans le spool.


*Créer un groupe qui définira les données à prendre en compte pour la construction du graphique et y déposer les zones sélectionnées qui contiennent les données, les titres, légende, ...
*Nommer la/les zone(s) du même nom que le graphique et renseigner ses propriétés avec '''Type''' = « '''''Graphique''''' » et le '''Sous-type''' selon le rôle de la zone (titre, données, légende…).


La suite de la construction du graphique est la même que celle décrite précédemment.

==Opérations arithmétiques dans un groupe== 


Pour simplifier la gestion de calcul dans un groupe et notamment la gestion de « '''total''' » et « '''sous-total''' », un outil a été intégré à Designer. Il permet d’effectuer des traitements sur un fichier XML d’entrée à l’aide de scripts. Ces scripts sont exécutés avant l’application de la maquette.


[[File:onyxdesigner-image96.png]]


[[File:onyxdesigner-image97.png]]


L’ajout de calcul dans un groupe, par l’intermédiaire de cet outil, se fait par la fonction de script « '''addline''' ». La fonction '''addline''' permet d’ajouter une ligne à un groupe, en lui précisant une séquence de couples « '''nom du champ'''/'''valeur''' » à ajouter.


De plus, les paramètres de type « '''chaine de caractère''' » devront être entourés de '''doubles guillemets''' et les noms de champ dans les formules par des '''simples guillemets'''.


Syntaxe :


addline(nom du groupe, nom de la ligne, ligne de type saut de page, nom du 1er champ, valeur du 1er champ, pré-calcul du 1er champ, nom du 2ème champ, valeur du 2ème champ, pré-calcul du 2ème champ, etc…) ;


La fonction '''addline''' commence par les arguments suivants :


*'''Nom du groupe''' : Contient le nom du groupe sur lequel la ligne doit s’ajouter.
*'''Nom de la ligne''' : Nom de la ligne à ajouter.


Puis, elle se compose d’une séquence illimitée de couples '''champ''' / valeur :


*'''Nom du champ''' : Nom du champ que possèdera la ligne.
*'''Valeur du champ''' : La valeur du champ possédé par la ligne.
*'''Pré-calcul''': Valeur booléenne. (0 ou 1, yes ou no). Si le champ possède un calcul alors cela permet de définir quand le calcul doit s’effectuer :
**'''Yes''' : Le calcul est résolu lors de l’exécution du script, prenant en compte toutes les valeurs du xml.
**'''No''' : Le calcul est résolu lors de l’utilisation de la valeur dans une maquette et ne prend donc en compte que les valeurs présentes dans la page en cours.


Par exemple, le script suivant ajoute cette ligne au groupe nommé "groupe" :


<code>addline("groupe","ligne",yes,"champ1","valeur1",no,"champ2","valeur2",no);</code>


<code><group name="groupe"> … '''<line name="ligne" pagebreak=”1”> '''<field name="champ1">valeur1</field> <field name="champ2">valeur2</field> </line>''' '''</group></code>


La '''valeur du champ''' peut contenir un calcul dont la syntaxe est la suivante :


'''[[SUM('''''opération''''')]]''' pour calculer une somme sur l’ensemble des lignes du groupes.


'''[[AVG('''''opération''''')]]''' pour calculer une moyenne sur l’ensemble des lignes du groupes.


''Ici, « opération »'' est un calcul mathématique utilisant les noms des champs présents dans les lignes du groupe. Les noms de champs doivent être entourés par des '''simples guillemets'''.


Prenons l’exemple de ce groupe :


<code><group name="invoice"> <line name="item"> <field name="name">item 1</field> <field name="price">10</field> <field name="quantity">2</field> </line> <line name="item"> <field name="name">item 2</field> <field name="price">5</field> <field name="quantity">3</field> </line> <line name="item"> <field name="name">item 3</field> <field name="price">12</field> <field name="quantity">4</field> </line> <line name="item"> <field name="name">item 4</field> <field name="price">5.5</field> <field name="quantity">3</field> </line> </group></code>


Pour ajouter une ligne de total à ce groupe, il faudra utiliser ce script :


<code>addline("invoice", "LigneTotal",no</code>


<code>"total", "total = [[SUM('price'*'quantity')]]", yes</code>


<code>"moyenne", "moyenne = [[AVG('price'*'quantity')]]", yes</code>


<code>);</code>


Ce script aura pour effet d’ajouter une ligne de '''total''' à la fin du groupe :


<code><group name="invoice"> … <line name="item"> <field name="name">item 4</field> <field name="price">5.5</field> <field name="quantity">3</field> </line> '''<line name="LigneTotal">''' '''<field name="total">total = 99.5</field>''' '''<field name="moyenne">moyenne = 24.875</field>''' '''</line>''' </group></code>


L’utilisation de '''l’option Pré-calcul''' à '''« no »''' permet de ne pas exécuter les calculs lors de l’ajout de la ligne au groupe mais lors de son exécution par la maquette. L’intérêt de cette option est de pouvoir effectuer des calculs uniquement avec les données écrites sur la page en cours, permettant donc l’écriture de sous-totaux.


Pour ajouter une ligne de '''sous-total''' au groupe précédant, il faudra utiliser ce script :


<code>addline("invoice","LineSubtotal",yes, "subtotal","sous-total = [[SUM('price'*'quantity')]]",no);</code>


Ce script aura pour effet d’ajouter une ligne de total à la fin du groupe :


<code><group name="invoice"> … <line name="item"> <field name="name">item 4</field> <field name="price">5.5</field> <field name="quantity">3</field> </line> '''<line name="LineSubtotal" pagebreak=”1”>''' '''<field name="subtotal">sous-total = [[SUM('price'*'quantity')]]</field>''' '''</line>''' </group></code>

==Gestion de la pagination== 


La gestion de l’écriture d’information de pagination tels que le nombre de page total, le nombre de lot et le nombre de page dans le lot est possible dans Designer grâce aux deux options suivantes.

===Rupture de lot=== 


L’option '''Rupture de lot''' se trouve dans les '''Propriétés''' de la maquette (présentée dans le paragraphe [[#création-dun-projet-1|''4.2. Création d’un projet'']]). Elle permet de faire référence à une zone de type '''Métadonnée''' qui sera utilisée pour regrouper les pages du document final en lot.

{{warning}} Dans la liste des objets, cette zone '''Métadonnée''' doit être placée en tête afin d'être exécutée avant toute autre zone. Une exception s’applique tout de même si des zones mémoires sont nécessaires à sa construction dynamique.


Lors du traitement de la page :


*Si la zone '''Métadonnée''' récupère une nouvelle valeur alors un nouveau lot sera créé. La page en cours appartiendra à ce nouveau lot.
*Si la zone '''Métadonnée''' récupère une valeur déjà récupérée précédemment, la page en cours sera déplacée vers le lot correspondant à cette valeur.
*Si aucune valeur n’est récupérée par la zone '''Métadonnée''', la page reste dans le même lot que la page précédente.


C’est le système de multi-document du XPS qui est utilisé pour représenter les lots, le fichier de sortie est donc trié par lot (d’abord les pages du premier lot puis les pages du second, etc…).

===Variables de remplacement=== 


Pour permettre l’écriture des informations de pagination, il existe des variables de type « ''post-traitement'' », c’est-à-dire qu’elles ne seront remplacées par leur véritable valeur qu’au moment de l’impression.

'''ATTENTION :''' l'ordre d'exécution des zones est TRES important pour ne pas qu'il y ait de décalages. En l'occurence, la zone de type '''Métadonnée''' doit être exécutée AVANT d'utiliser les fonctionnalités suivantes si celles-ci sont utilisées au sein de zones "bleues".
Pour rappel, l'ordre d'exécution des zones est modifiable via l'onglet "Liste des objets"


La syntaxe d’utilisation est la suivante :


'''<nowiki>[[</nowiki>PST:'''''nom de la variable''''';'''''valeur par défaut'''''<nowiki>]]</nowiki>'''


La « '''''valeur par défaut''''' » est obligatoire et permet d’avoir un texte présent dans la page. Ce texte temporaire sera, par la suite, remplacé par sa vraie valeur. Il est important car c’est grâce à ce texte que les calculs de positionnement se feront. Ce texte doit donc posséder un nombre de caractère au moins égal à la valeur maximale attendue par la variable utilisée.


Par exemple :


'''<nowiki>[[PST:MAP_TOTAL_PAGE;000]]</nowiki>'''


Affichera '''"000"''' dans la page, mais au moment de l’impression cette valeur sera remplacée par :


*'''" 5"''' s’il y 5 pages au total.
*'''" 10"''' s’il y 10 pages au total.
*'''"150"''' s’il y 150 pages au total.


'''<nowiki>[[PST:MAP_TOTAL_DOC]]</nowiki>''' = nombre total de lot.


'''<nowiki>[[PST:MAP_TOTAL_PAGE_IN_DOC]]</nowiki>''' = nombre de page dans le lot en cours.


D’autre syntaxes existent aussi, accessibles quant à elles pendant le traitement de la page :


'''<nowiki>[[VAR:MAP_CURRENT_PAGE]]</nowiki>''' = numéro de la page en cours.


'''<nowiki>[[VAR:MAP_CURRENT_DOC]]</nowiki>''' = numéro du lot en cours (la zone '''Métadonnée''' gérant la rupture de lot doit être définie avant l’utilisation de cette variable).


'''<nowiki>[[VAR:MAP_CURRENT_PAGE_IN_DOC]]</nowiki>''' = numéro de la page en cours dans le lot en cours.


Et de manière générale :


'''<nowiki>[[VAR:variable d’env]]</nowiki>''' = récupère le contenu de la variable d’environnement.

==Gestion des veuves et orphelines== 


Une gestion complexe des veuves et orphelines est possible grâce à deux fonctionnalités : '''Groupe entier''' et '''Répéter''' un groupe XML.

===Groupe entier=== 


Lorsqu’on utilise une génération de saut de page de type '''Limite''', une nouvelle option apparait dans les '''Propriétés''' du groupe : '''Groupe entier'''. Cette option permet d’indiquer que le groupe ne peut pas être coupé et qu’il doit donc s’imprimer intégralement sur une seule page. Si la limite déclenche un saut de page, aucune ligne du groupe ne sera imprimée, le groupe sera entièrement traité sur la page suivante.


[[File:onyxdesigner-image99.png]]

===Répétition de groupe XML=== 


La répétition de groupe XML part du principe que le groupe apparait plusieurs fois dans le fichier XML d’entrée. Cette fonctionnalité s’active avec le paramètre « R'''épéter''' » dans les propriétés du groupe.


[[File:onyxdesigner-image100.png]]


Exemple :


Dans l’exemple ci-dessous, le groupe “'''''invoice'''''” apparait trois fois dans le XML. Par défaut, le groupe de la maquette ne pourra récupérer que les informations de la première apparition du groupe dans le XML. Mais si l’option « '''Répéter''' » est cochée, l’exécution du groupe se poursuivra sur toutes les apparitions.


<code><group name="'''invoice'''"> <line name="item"> <field name="name">item 1</field> <field name="price">10</field> <field name="quantity">2</field> </line> <line name="description"> <field name="description">Description item 1</field> </line> </group> <group name="'''invoice'''"> <line name="item"> <field name="name">item 2</field> <field name="price">5</field> <field name="quantity">3</field> </line> <line name="description"> <field name="description">Description item 2</field> </line> </group> <group name="'''invoice'''"> <line name="item"> <field name="name">item 3</field> <field name="price">12</field> <field name="quantity">4</field> </line> <line name="description"> <field name="description">Description item 3</field> </line> </group></code>


L’utilisation conjointe d’une limite générant des sauts de page avec l’option “'''Groupe entier'''” et la répétition active permet de gérer un système complexe de veuves et orphelines.


Dans notre exemple, les lignes « '''''item''''' » et les lignes « '''''description''''' » ne pourront pas être séparées par un saut de page.

</translate>

Récupérer le nombre de points restant

2025-08-28T14:06:51Z

Nturpin :

La commande MAPADDPTS, en plus d'ajouter un clé de recharge de page, permet de consulter le nombre de point acquis et le nombre de points restants.

Pour récupérer uniquement le nombre de points restants, vous pouvez lancer la commande CALL MAP_919 GETPOINT.
[[Fichier:CALL MAP 919 GETPOINT.png|cadre|centré]]

Le programme s’arrêtera sans erreur ni message mais une variable d’environnement nommée MAPPINGPTS sera créée au niveau *JOB.

Pour l'afficher, lancez la commande WRKENVVAR LEVEL(*JOB).
[[Fichier:WRKENVVAR.png|cadre|centré]]

Fichier:CALL MAP 919 GETPOINT.png

2025-08-28T14:05:19Z

Nturpin :

CALL MAP_919 GETPOINT

Récupérer le nombre de points restant

2025-08-28T14:03:37Z

Nturpin : CALL MAP_919 GETPOINT

La commande MAPADDPTS, en plus d'ajouter un clé de recharge de page, permet de consulter le nombre de point acquis et le nombre de points restants.
Pour récupérer uniquement le nombre de points restants, vous pouvez lancer la commande CALL MAP_919 GETPOINT.
Le programme s’arrêtera sans erreur ni message mais une variable d’environnement nommée MAPPINGPTS sera créée au niveau *JOB.
Pour l'afficher, lancez la commande WRKENVVAR LEVEL(*JOB).
[[Fichier:WRKENVVAR.png|cadre|centré]]

Fichier:WRKENVVAR.png

2025-08-28T14:03:18Z

Nturpin : Nturpin a téléversé une nouvelle version de Fichier:WRKENVVAR.png

WRKENVVAR

Fichier:WRKENVVAR.png

2025-08-28T13:59:37Z

Nturpin :

WRKENVVAR

ONYX:9.0:Utilisation:Conversion de documents

2024-12-24T09:48:20Z

Nturpin : /* Reprise de documents en entrée */

==Méthodes de conversion==

Le principe de base des conversions consiste à utiliser le format pivot Mapping XPS.

Il existe deux méthodes pour utiliser les conversions :

*Conversion sans appel de profil : Dans ce cas, la commande map_xps effectue la conversion directement avec les paramètres saisis.

*Conversion avec appel de profil : Dans ce cas, un profil de conversion générique ou spécifique est appelé permettant de gérer des paramètres propres à un modèle d'imprimante par exemple. Un profil de conversion peut aussi être utilisé pour simplifier l'automatisation des traitements car dans ce cas il suffit d'appeler un profil dans la commande map_xps sans devoir saisir tous les paramètres à chaque fois.

Avant d'aller plus loin, il est recommandé de lire la section dédiée à l'utilisation des profils de conversion ici :
[[ONYX:9.0:Utilisation:Convertisseurs_de_sortie#Le_fichier_de_configuration_:_XPSCONFIG.CONF|Profils de conversion]]

==Conversion en sortie==

Le principe est de convertir des fichiers XPS, générés ou non par ONYX Server, en vue de leur diffusion finale (impression, envoi par mail, archivage…) et en fonction de leur canal de diffusion. Les commutateurs pour réaliser ces conversions sont de la forme :<code> -toXXX</code>.

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

Exemples :

map_xps -infile:/tmp/invoice.xps -toPCL -outfile:/tmp/invoice.pcl

map_xps -infile:/tmp/invoice.xps -toPDF -outfile:/tmp/invoice.pdf

Ces conversions peuvent en outre être affinées en utilisant un profil défini dans le fichier de configuration.

Exemple :

map_xps -infile:/tmp/invoice.xps -outfile:/tmp/invoice.pdf -convert -profile:MYPDF

Avec les paramètres :

-config:XXXX ou -profile:XXXX ⇒ sélection du profil à utiliser pour la conversion

-convert ⇒ force la conversion en utilisant le profil sélectionné

Et un profil MYPDF défini dans le fichier de configuration XPSConfig.conf :
<MYPDF>
<label>for Adobe Reader</label>
<language>PDF</language>
<embeddedfont>off</embeddedfont>
<color>on</color>
</MYPDF>

==Surcharge des conversions==

Tous les paramètres mentionnés et expliqués dans les deux parties sur les conversions (entrée et sortie) peuvent être utilisés en ligne de commandes pour venir surcharger les valeurs par défaut de la conversion. Pour cela, la syntaxe suivante devra être ajoutée à la commande <code>map_xps</code> de conversion :<code>-param:nom_du_paramètre=valeur</code>

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

Erreur Ressources

2023-08-07T13:43:47Z

Nturpin :

'''IFS :''' 

Make a copy of your lstobj.txt

'''AS400 :''' 

1/ CRTLIB LIB(MAPFILE) TYPE(*TEST) 

2/ Copy a format from your current MAP400 library (menu 3 - Work with Mapping formats) to the new one 

3/ ADDLIBLE LIB(MAPFILE) 

4/ Update your MAPPINGENV :

[[Fichier:Mappingenvenu.png]]

5/ CLRPFM MAP, MAPOBJ, MAPLNK, MAP1, MAP2D, MAP2H, MAP3 

:--> Now your lib is clean 

6/ CALL MAP_823 

:--> lstobj.txt is empty

'''MapDraw :''' 

1/ Settings > Import lstobj.txt 

2/ Generate

[[Category:Error]]

Erreur Ressources

2023-08-07T13:43:15Z

Nturpin :

'''IFS :''' 

Make a copy of your lstobj.txt

'''AS400 :''' 

1/ CRTLIB LIB(MAPFILE) TYPE(*TEST) 

2/ Copy a format from your current MAP400 library (menu 3 - Work with Mapping formats) to the new one 

3/ ADDLIBLE LIB(MAPFILE) 

4/ Update your MAPPINGENV :
[[Fichier:Mappingenvenu.png|néant|vignette]]

5/ CLRPFM MAP, MAPOBJ, MAPLNK, MAP1, MAP2D, MAP2H, MAP3 

:--> Now your lib is clean 

6/ CALL MAP_823 

:--> lstobj.txt is empty

'''MapDraw :''' 

1/ Settings > Import lstobj.txt 

2/ Generate

[[Category:Error]]

Fichier:Mappingenvenu.png

2023-08-07T13:41:48Z

Nturpin :

mappingenvenu

Le menu de Gestion des formats est vide

2023-04-24T08:26:32Z

Nturpin :

Depuis la version 10.7.x d'OPALE, une nouvelle zone contenant la dernière date de modification a été ajouté au fichier MAP1.

Si vous faites une nouvelle installation puis recopiez les fichiers physiques depuis une version antérieure, la liste des formats sera vide.

Il faut récupérer le fichier MAP1 de la nouvelle installation puis recopier le votre avec la commande CPYF en précisant FMTOPT(*MAP *DROP) et MBROPT(*REPLACE).

Le menu de Gestion des formats est vide

2022-09-26T14:54:30Z

Nturpin :

Depuis la version 10.7.x d'OPALE, une nouvelle zone contenant la dernière date de modification a été ajouté au fichier MAP1.

Si vous faites une nouvelle installation puis recopiez les fichiers physiques depuis une version antérieure, la liste des formats sera vide.

Il faut récupérer le fichier MAP1 de la nouvelle installation puis recopier le votre avec la commande CPY en précisant FMTOPT(*MAP *DROP) et MBROPT(*REPLACE).

OPALE:10.0:OPALE Server:OPALE Server

2022-09-26T14:54:06Z

Nturpin : Ajout https://docs.mappingsuite.com/wiki/Le_menu_de_Gestion_des_formats_est_vide

===About===

*[[OPALE:10.0:About:A propos de OPALE Server|A propos de OPALE Server]]

===Installation===

*[[OPALE:10.0:Installation:Installation OPALE Server|Installation OPALE Server]]

===Migration===

*[[OPALE:10.0:Migration:Process de migration|Process de migration]]
*[[OPALE:10.0:Migration:Passage natif vers XPS|Check list passage natif vers XPS]]
*[[OPALE:10.0:Migration:Abaques de migration|Abaques de migration]]

===Exploitation===

*[[OPALE:10.0:Exploitation:Guide d'exploitation OPALE Server|Guide d'exploitation OPALE Server]]

===Utilisation===
====Commandes====

*[[OPALE:10.0:Utilisation:Commandes Opale/AS400|Commandes OPALE Server]]

====Cas d'utilisation générale====
=====V10.0=====

*[[OPALE:10.0:Utilisation:La commande MAP_XPS|La commande MAP_XPS]]
*[[OPALE:10.0:Utilisation:Cas d'usages de la commande MAP_XPS|Cas d'usages de la commande MAP_XPS]]
*[[OPALE:10.0:Utilisation:Dématérialisation numérique|Dématérialisation numérique]]
*[[OPALE:10.0:Utilisation:Agrafer un PCL en mode XPS|Agrafer un PCL en mode XPS]]
*[[OPALE:10.0:Utilisation:Agrafer en PCL direct|Agrafer en PCL natif]]
*[[OPALE:10.0:Utilisation:Les codes OMR avec la commande MAP_XPS|Insertion de codes OMR avec la commande MAP_XPS]]
*[[OPALE:10.0:Utilisation:Gestion des codes OMR|Insertion de codes OMR en natif]]
*[[OPALE:10.0:Utilisation:Repagination d'un fichier spool IBM-i|Repagination d'un fichier spool IBM i]]
*[[OPALE:10.0:Utilisation:Sécuriser un PDF avec un mot de passe dont sa valeur est présente dans le fichier spool d'entrée|Sécuriser un PDF avec un mot de passe dont sa valeur est présente dans le fichier spool d'entrée]]
*[[OPALE:10.0:Utilisation:Conversion PDF vers PDFA|Convertir un fichier PDF en PDFA via la commande MAPPDFA]]
*[[OPALE:Utilisation:Ordre de priorités des règles sur le moteur de règles MAPPING IBM-i|Moteur de règles IBM-i : Priorité sur l'ordre d'exécution des règles]]

=====V10.1=====

*[[OPALE:10.1:Récupérer une valeur d'un spool et l'utiliser dans une commande|Récupérer une valeur d'un spool et l'utiliser dans une commande]]
*[[OPALE:10.1:Utilisation:Gestion_des_envois_de_ressources_vers_les_imprimantes|Gestion de l'envoi des ressources vers l'imprimante]]
*[[OPALE:Utilisation:Enrichissement d'un spool avant son envoi vers Linux via MAPENRSPLF|Enrichissement d'un spool avant son envoi vers Linux via MAPENRSPLF]]
*[[OPALE:10.1:Routage_impressions_selon_les_utilisateurs|Routage impressions selon les utilisateurs]]

====Système====

*[[OPALE:10.0:Utilisation:Commandes usuelles AS400|Commandes usuelles AS/400]]
*[[OPALE:10.0:Utilisation:Envoi spools vers ONYX|Envoi de spools IBM i vers ONYX Linux/Windows]]

====Unicode====

*[[OPALE:10.0:Utilisation:Changement environnement Unicode/Non unicode|Passage en Unicode/Non Unicode pour un traitement spécifique]]

===Maintenance===
====V10.0====

*[[OPALE:10.0:KB:Dupliquer un format Mapping : MAPDUPFMT|Dupliquer un format Mapping : MAPDUPFMT]]
*[[OPALE:10.0:KB:Informations sur la dernière mise à jour MAP400 : DATESOFT|Informations sur la dernière mise à jour MAP400 : DATESOFT]]
*[[OPALE:10.0:KB:Réorganisation des fichiers physiques de Mapping : MAPRGZ|Réorganisation des fichiers physiques de Mapping : MAPRGZ]]
*[[OPALE:10.0:KB:Saisie de la clef logicielle : MAPKEY|Saisie de la clef logicielle : MAPKEY]]
*[[OPALE:10.0:KB:Sauvegarder l'IFS : SAV|Sauvegarder l'IFS : SAV]]
*[[OPALE:10.0:KB:Créer un fichier dump à partir d'un spool remappé|Créer un fichier dump à partir d'un spool remappé]]
*[[OPALE:10.0:Précaution à prendre en cas d'utilisations multiples de Designer et integrité d'un environnement|Précaution à prendre en cas d'utilisations multiples de Designer et integrité d'un environnement]]

====V10.1====

*[[OPALE:10.1:Programme de Duplication d'environnements MAPDUPENV|Programme de duplication d'environnement MAPDUPENV]]
*[[OPALE:10.1:Controle intégrité des ressources IBM-i|Controle de l'intégrité des ressources IBM i]]

===Robot Mapping===

*[[OPALE:10.0:Utilisation: Fonctionnement Robot|Schéma de fonctionnement du Robot]]
*[[OPALE:10.0:Utilisation: Automatisation|Automatisation]]
*[[OPALE:10.0:Utilisation:Gestion des bibliothèques des JOBDs pour le sous système MAPSROBOT|Gestion des bibliothèques des JOBDs pour MAPSROBOT]]
*[[OPALE:10.0:Utilisation : Associer un spool à une action|Associer un Spool à une Action]]
*[[OPALE:10.0:Utilisation: Liste des variables du robot Mapping|Liste des variables du Robot]]

===Menus principaux===

*[[OPALE:10.0:Utilisation:Mapping |Mapping]]
*[[OPALE:10.0:Utilisation:Exploitation|Exploitation]]
*[[OPALE:10.0:Utilisation:MapRobot|MapRobot]]
*[[OPALE:10.0:Utilisation:e-Mail|e-Mail]]
*[[OPALE:10.0:Utilisation:M-Connect|M-Connect]]
*[[OPALE:10.0:Utilisation:Commandes|Commandes]]

===Paramétrage===
====V10.1.0====

*[[OPALE:10.1:Utilisation:Gestion des envois de ressources vers les imprimantes|Gestion des envois de ressources vers les imprimantes]]
*[[OPALE:parametrage:Gestion des droits d'accès sur les objets MAPPING|Gestion des droits d'accès sur les objets MAPPING]]

===Problèmes connus===

*[[OPALE:10.0:KB:Erreur FTP|Erreur FTP]]
*[[OPALE:10.0:KB:Problème de format|Problème de format]]
*[[OPALE:10.0:KB:Problème de police corrompue|Problème de police corrompue]]
*[[OPALE:10.0:KB:Problème LSTOBJ.TXT manquant|Problème LSTOBJ.TXT manquant]]
*[[OPALE:10.0:KB:Problème Format ZEBRA|Problème de format ZEBRA]]
*[[OPALE:10.0:KB:Erreur MAPCPYSPLF en utilisant un spool d'entrée au format XML|Erreur MAPCPYSPLF en utilisant un spool d'entrée au format XML]]
*[[OPALE:10.0:KB:Erreur MAPSNDMAIL|Problème d'envoi d'emails via la commande MAPSNDMAIL]]
*[[OPALE:10.0:KB:L'envoi de mail automatique via le robot, n'envoi pas tous les mails|L'envoi de mail automatique via le robot, n'envoi pas tous les mails]]
*[[OPALE:10.0:KB:DATAQ ne démarre pas|DATAQ ne démarre pas]]
*[[OPALE:10.0:KB:Certains Spools non pris en compte par le Robot Mapping|Certains fichiers spools (de façon aléatoire) non pris en compte par le Robot Mapping]]
*[[OPALE:10.0:KB:Job soumis par le robot en erreur|Erreur en MSGATT lors d'un traitement d'un fichier spool par le robot MAPPING]]
*[[OPALE:10.0:KB:Lenteur lors de la génération Designer|Lenteur lors de la génération Designer]]
*[[OPALE:10.0:KB:La police utilisée sur mon impression n'est pas bonne|La police utilisée sur mon impression n'est pas bonne]]
*[[ONYX:9.0:KB:Problème de compatibilité avec la visualisation des PDFs sur FIREFOX|Problème de compatibilité avec la visualisation des PDFs sur FIREFOX]]
*[[OPALE:10.0:KB:Impossible_de_creer_un_fichier_PAG_commencant_par_un_chiffre.|Impossible de creer un fichier PAG commencant par un chiffre]]
*[[OPALE:10.0:KB:Limitation utilisation Fichier ou Message XPS|Limitation utilisation Fichier ou Message XPS]]
*[[Le menu de Gestion des formats est vide]]

===Notes de version===

*[[OPALE:10.0:ReleaseNotes:Notes de version|Notes de version OPALE Server]]

Le menu de Gestion des formats est vide

2022-09-26T14:53:23Z

Nturpin : Page créée avec « Depuis la version 10.7.x d'OPALE, une nouvelle zone contenant la dernière date de modification a été ajouté au fichier MAP1. Si vous faites une nouvelle installation... »

Depuis la version 10.7.x d'OPALE, une nouvelle zone contenant la dernière date de modification a été ajouté au fichier MAP1.
Si vous faites une nouvelle installation puis recopiez les fichiers physiques depuis une version antérieure, la liste des formats sera vide.
Il faut récupérer le fichier MAP1 de la nouvelle installation puis recopier le votre avec la commande CPY en précisant FMTOPT(*MAP *DROP) et MBROPT(*REPLACE).

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

2022-06-29T07:28:49Z

Nturpin :

<languages />
<translate>

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


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

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


[[Fichier:Dump.png|846x846px|sans_cadre|centré]]
</translate>

Fichier:Dump.png

2022-06-29T07:28:03Z

Nturpin :

Dump

ONYX:9.0:Utilisation:Translate

2022-06-14T07:53:15Z

Nturpin :

Pour la traduction des textes, il est possible d'utiliser la fonction Translate avec Designer.

Il faut d’abord créer une zone Outils de type « set lang » :

[[Fichier:Image setlang.png|sans_cadre]]

Que l’on peut conditionner à une valeur sur le spool ou donner en dur (dans label av. '''ou''' label ap.).

Exemple :

[[Fichier:Image_condition_setlang.png|sans_cadre]]

De ce fait, on peut créer plusieurs « Set lang » conditionnés pour gérer plusieurs langues, par exemple.

Il est évident, qu’il faut que la valeur de « Set lang » soit lue avant les zones à traduire. Il faut dons la placer avant.

[[Fichier:Image_position_setlang.png|sans_cadre]]

Il faut ensuite configure les zones de texte à traduire :

[[Fichier:Image_translate.png|sans_cadre]]

ou, on peut l’utiliser pour des variables avec [[TR :''nom_variable''<nowiki>]]</nowiki>

La valeur de la zone « set lang » doit être présent dans le nom du fichier de traduction.

Exemple pour la valeur Set Lang = EN, le fichier recherché est Translate_EN.txt.

pour la valeur Set Lang = FR, la fichier recherché est Translate_FR.txt

Par défaut, si Set Lang n’a pas de valeur, il recherche le fichier Translate_.txt

Exemple de contenu de fichier :

[[Fichier:Image fichier translate.png|sans_cadre]]

Il est nécessaire d’avoir un retour chariot à la dernière ligne du fichier de traduction pour que le dernier caractère soit pris en compte.

<nowiki>Enfin, il est possible de définir le setlang dans les paramètres de la commande mapcpysplf : [ -setlang: ] </nowiki>

sachant que le setlang de la maquette est prioritaire sur celui de la ligne de commande.

OPALE:10.0:KB:Limitation utilisation Fichier ou Message XPS

2022-04-20T08:35:54Z

Nturpin : Page créée avec « En cas d’utilisation de plus d’une zone Fichier ou Message XPS, selon la structure des fichiers XPS utilisés, il se peut qu’il y ait un problème lors de la composi... »

En cas d’utilisation de plus d’une zone Fichier ou Message XPS, selon la structure des fichiers XPS utilisés, il se peut qu’il y ait un problème lors de la composition du document via la commande MAPCPYSPLF. Si tel est le cas, il faudra les remplacer par des zones de type Outils / Image (conversion des XPS en image au préalable).

OPALE:10.0:OPALE Server:OPALE Server

2022-04-20T08:31:55Z

Nturpin : /* Problèmes connus */

===About===

*[[OPALE:10.0:About:A propos de OPALE Server|A propos de OPALE Server]]

===Installation===

*[[OPALE:10.0:Installation:Installation OPALE Server|Installation OPALE Server]]

===Migration===

*[[OPALE:10.0:Migration:Process de migration|Process de migration]]
*[[OPALE:10.0:Migration:Passage natif vers XPS|Check list passage natif vers XPS]]
*[[OPALE:10.0:Migration:Abaques de migration|Abaques de migration]]

===Exploitation===

*[[OPALE:10.0:Exploitation:Guide d'exploitation OPALE Server|Guide d'exploitation OPALE Server]]

===Utilisation===
====Commandes====

*[[OPALE:10.0:Utilisation:Commandes Opale/AS400|Commandes OPALE Server]]

====Cas d'utilisation générale====
=====V10.0=====

*[[OPALE:10.0:Utilisation:La commande MAP_XPS|La commande MAP_XPS]]
*[[OPALE:10.0:Utilisation:Cas d'usages de la commande MAP_XPS|Cas d'usages de la commande MAP_XPS]]
*[[OPALE:10.0:Utilisation:Dématérialisation numérique|Dématérialisation numérique]]
*[[OPALE:10.0:Utilisation:Agrafer un PCL en mode XPS|Agrafer un PCL en mode XPS]]
*[[OPALE:10.0:Utilisation:Agrafer en PCL direct|Agrafer en PCL natif]]
*[[OPALE:10.0:Utilisation:Les codes OMR avec la commande MAP_XPS|Insertion de codes OMR avec la commande MAP_XPS]]
*[[OPALE:10.0:Utilisation:Gestion des codes OMR|Insertion de codes OMR en natif]]
*[[OPALE:10.0:Utilisation:Repagination d'un fichier spool IBM-i|Repagination d'un fichier spool IBM i]]
*[[OPALE:10.0:Utilisation:Sécuriser un PDF avec un mot de passe dont sa valeur est présente dans le fichier spool d'entrée|Sécuriser un PDF avec un mot de passe dont sa valeur est présente dans le fichier spool d'entrée]]
*[[OPALE:10.0:Utilisation:Conversion PDF vers PDFA|Convertir un fichier PDF en PDFA via la commande MAPPDFA]]
*[[OPALE:Utilisation:Ordre de priorités des règles sur le moteur de règles MAPPING IBM-i|Moteur de règles IBM-i : Priorité sur l'ordre d'exécution des règles]]

=====V10.1=====

*[[OPALE:10.1:Récupérer une valeur d'un spool et l'utiliser dans une commande|Récupérer une valeur d'un spool et l'utiliser dans une commande]]
*[[OPALE:10.1:Utilisation:Gestion_des_envois_de_ressources_vers_les_imprimantes|Gestion de l'envoi des ressources vers l'imprimante]]
*[[OPALE:Utilisation:Enrichissement d'un spool avant son envoi vers Linux via MAPENRSPLF|Enrichissement d'un spool avant son envoi vers Linux via MAPENRSPLF]]

====Système====

*[[OPALE:10.0:Utilisation:Commandes usuelles AS400|Commandes usuelles AS/400]]
*[[OPALE:10.0:Utilisation:Envoi spools vers ONYX|Envoi de spools IBM i vers ONYX Linux/Windows]]

====Unicode====

*[[OPALE:10.0:Utilisation:Changement environnement Unicode/Non unicode|Passage en Unicode/Non Unicode pour un traitement spécifique]]

===Maintenance===
====V10.0====

*[[OPALE:10.0:KB:Dupliquer un format Mapping : MAPDUPFMT|Dupliquer un format Mapping : MAPDUPFMT]]
*[[OPALE:10.0:KB:Informations sur la dernière mise à jour MAP400 : DATESOFT|Informations sur la dernière mise à jour MAP400 : DATESOFT]]
*[[OPALE:10.0:KB:Réorganisation des fichiers physiques de Mapping : MAPRGZ|Réorganisation des fichiers physiques de Mapping : MAPRGZ]]
*[[OPALE:10.0:KB:Saisie de la clef logicielle : MAPKEY|Saisie de la clef logicielle : MAPKEY]]
*[[OPALE:10.0:KB:Sauvegarder l'IFS : SAV|Sauvegarder l'IFS : SAV]]
*[[OPALE:10.0:KB:Créer un fichier dump à partir d'un spool remappé|Créer un fichier dump à partir d'un spool remappé]]
*[[OPALE:10.0:Précaution à prendre en cas d'utilisations multiples de Designer et integrité d'un environnement|Précaution à prendre en cas d'utilisations multiples de Designer et integrité d'un environnement]]

====V10.1====

*[[OPALE:10.1:Programme de Duplication d'environnements MAPDUPENV|Programme de duplication d'environnement MAPDUPENV]]
*[[OPALE:10.1:Controle intégrité des ressources IBM-i|Controle de l'intégrité des ressources IBM i]]

===Robot Mapping===

*[[OPALE:10.0:Utilisation: Fonctionnement Robot|Schéma de fonctionnement du Robot]]
*[[OPALE:10.0:Utilisation: Automatisation|Automatisation]]
*[[OPALE:10.0:Utilisation:Gestion des bibliothèques des JOBDs pour le sous système MAPSROBOT|Gestion des bibliothèques des JOBDs pour MAPSROBOT]]
*[[OPALE:10.0:Utilisation : Associer un spool à une action|Associer un Spool à une Action]]
*[[OPALE:10.0:Utilisation: Liste des variables du robot Mapping|Liste des variables du Robot]]

===Menus principaux===

*[[OPALE:10.0:Utilisation:Mapping |Mapping]]
*[[OPALE:10.0:Utilisation:Exploitation|Exploitation]]
*[[OPALE:10.0:Utilisation:MapRobot|MapRobot]]
*[[OPALE:10.0:Utilisation:e-Mail|e-Mail]]
*[[OPALE:10.0:Utilisation:M-Connect|M-Connect]]
*[[OPALE:10.0:Utilisation:Commandes|Commandes]]

===Paramétrage===
====V10.1.0====

*[[OPALE:10.1:Utilisation:Gestion des envois de ressources vers les imprimantes|Gestion des envois de ressources vers les imprimantes]]
*[[OPALE:parametrage:Gestion des droits d'accès sur les objets MAPPING|Gestion des droits d'accès sur les objets MAPPING]]

===Problèmes connus===

*[[OPALE:10.0:KB:Erreur FTP|Erreur FTP]]
*[[OPALE:10.0:KB:Problème de format|Problème de format]]
*[[OPALE:10.0:KB:Problème de police corrompue|Problème de police corrompue]]
*[[OPALE:10.0:KB:Problème LSTOBJ.TXT manquant|Problème LSTOBJ.TXT manquant]]
*[[OPALE:10.0:KB:Problème Format ZEBRA|Problème de format ZEBRA]]
*[[OPALE:10.0:KB:Erreur MAPCPYSPLF en utilisant un spool d'entrée au format XML|Erreur MAPCPYSPLF en utilisant un spool d'entrée au format XML]]
*[[OPALE:10.0:KB:Erreur MAPSNDMAIL|Problème d'envoi d'emails via la commande MAPSNDMAIL]]
*[[OPALE:10.0:KB:L'envoi de mail automatique via le robot, n'envoi pas tous les mails|L'envoi de mail automatique via le robot, n'envoi pas tous les mails]]
*[[OPALE:10.0:KB:DATAQ ne démarre pas|DATAQ ne démarre pas]]
*[[OPALE:10.0:KB:Certains Spools non pris en compte par le Robot Mapping|Certains fichiers spools (de façon aléatoire) non pris en compte par le Robot Mapping]]
*[[OPALE:10.0:KB:Job soumis par le robot en erreur|Erreur en MSGATT lors d'un traitement d'un fichier spool par le robot MAPPING]]
*[[OPALE:10.0:KB:Lenteur lors de la génération Designer|Lenteur lors de la génération Designer]]
*[[OPALE:10.0:KB:La police utilisée sur mon impression n'est pas bonne|La police utilisée sur mon impression n'est pas bonne]]
*[[ONYX:9.0:KB:Problème de compatibilité avec la visualisation des PDFs sur FIREFOX|Problème de compatibilité avec la visualisation des PDFs sur FIREFOX]]
*[[OPALE:10.0:KB:Impossible_de_creer_un_fichier_PAG_commencant_par_un_chiffre.|Impossible de creer un fichier PAG commencant par un chiffre]]
*[[OPALE:10.0:KB:Limitation utilisation Fichier ou Message XPS|Limitation utilisation Fichier ou Message XPS]]

===Notes de version===

*[[OPALE:10.0:ReleaseNotes:Notes de version|Notes de version OPALE Server]]

Erreur 24

2021-11-02T14:52:38Z

Nturpin :

error 24:
Attention à l'utilisation de plusieurs onglets pour vos recherches,
les générations peuvent être faussées si vous ne générez pas à partir de la dernière recherche.
veuillez rafraichir ('F5') votre page de recherche pour savoir où vous en êtes fermer cette fenêtre

Mapweb - err 24 ?

L'erreur est que le spool est introuvable, qu'il n'est plus dans MapOut.
Le mieux pour tester est le classique copier coller de la ligne de commande mapout en commande DOS, Et de vérifier que le pdf est bien généré.

Ils ont très bien pu à un moment, supprimer ce spool des répertoires de Mapout à la main, pour X raisons.
Ça reste une mauvaise manip' de leur part, ils doivent passer par Mapout pour faire ce genre de suppression.
Pour Maweb, il est impossible de savoir si tel ou tel spool n'est plus dans Mapout avant d'en avoir fait la demande de génération.

Pour faire un nettoyage complet, il leur faudra, dans MapWeb, vider les répertoires concernés (vider et non supprimer afin de conserver les droits) Et de faire un reconstruire base / index par Mapout.

activer erreurs PHP:

dans le php.ini,
display_errors = On
error_reporting = E_ALL

=SOLUTION=

==Depuis Mapweb :==
Voir dans la gestion des répertoires, pour le(s) répertoire(s) correspondant au libellé « bon de livraison Gescom » supprimer ce(s) répertoire.

==Depuis Mapout :==
Ouvrir le(s) répertoire(s) puis vérifier dans les préférences la case à cocher « archiver dans la base de donnée ».
Vérifier également le bon fonctionnement de MySQL avec Mapout :
Dans les préférences, lancer un test de cnx MySQL.
Vérifier l’existence du fichier « mapout_database_mysql_failed » (dans le répertoire d’installation de Mapout, dans Program DATA si OS 64bits), ce fichier ne doit pas exister, si oui il contient des requêtes qui ne passent pas et qui empêchent tout nouvel enregistrement MySQL.
Lancer l’opération « reconstruire la base » (répondre oui et oui) ensuite lancer l’opération « reconstruire index ».

Le répertoire sera reconstruit dans Mapweb et vous pourrez accéder à la consultation des spools archivés

Enfin, pour que le problème de spool manquant ne se reproduise plus, vérifier dans votre règle Mapout, vous devez préciser que le spool doit être archivé aussi dans Mapweb, en cochant « archivage Mapweb».

[[Category:Error]]

OPALE:Utilisation:Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC

2021-09-17T15:15:24Z

Nturpin : Nturpin a déplacé la page Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC vers OPALE:Utilisation:Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC

'''Question :'''

Comment accéder aux partages de fichiers depuis IBMi en utilisant le système de fichiers QNTC.

'''Réponse :'''

Le système de fichiers QNTC de l'OS IBMi permet à l'IBMi d'agir comme un client dans un réseau SMB/CIFS et d'accéder aux serveurs de fichiers Windows, Samba et IBMi.

Le système de fichiers QNTC réside à la racine du système de fichiers de l'IBMi.

WRKLNK OBJ('/QNTC/*') affiche les serveurs réseau externes qui hébergent des partages de fichiers.

Cette liste est alimentée de deux manières.

La première consiste à parcourir dynamiquement le nom de domaine du réseau spécifié dans les propriétés de NetServer du système d'exploitation IBMi.

La seconde consiste à effectuer manuellement un MKDIR DIR('/QNTC/MyRemoteFileServer') où MyRemoteFileServer est remplacé par le nom d'hôte ou l'adresse IP du serveur externe.

Tous les répertoires sous le système de fichiers QNTC ne survivent que jusqu'au prochain IPL et doivent être recréés après un IPL.

Les répertoires qui ont été créés dynamiquement via l'exploration du domaine du réseau devraient se remplir à nouveau, mais les répertoires créés via MKDIR devront être créés à nouveau via MKDIR.

Pour se connecter à un serveur de fichiers externe, le client IBMi QNTC doit envoyer des informations d'identification valides.

Par défaut, l'IBMi envoie l'USRPRF et le PWD des utilisateurs actuellement connectés.

Cependant, un utilisateur interactif peut se connecter en utilisant un USRPRF IBMi alternatif via SBMJOB.

Par exemple :

SBMJOB CMD(DSPLNK OBJ('/QNTC/MyRemoteFileServer/*')) USER(AlternateIBMiUSRPRF)

AlternateIBMiUSRPRF doit exister à la fois sur le client IBMi et sur MyRemoteFileServer et les mots de passe doivent correspondre entre ces systèmes.

Il convient de noter que si la valeur système QPWDLVL* (Niveau de mot de passe) du système d'exploitation IBM i est définie sur 0 ou 1, cela signifie que les mots de passe du système d'exploitation IBMi ne peuvent comporter que 10 caractères, que tous les caractères alphabétiques ne sont pas sensibles à la casse, qu'ils peuvent inclure des chiffres et les quatre caractères spéciaux #, $, _ ou @.

Lorsque ces mots de passe sont transmis au serveur de fichiers externe, tous les caractères alphabétiques sont transmis en minuscules.

Les valeurs 2 et 3 de QPWDLVL transmettent le mot de passe stocké sensible à la casse.

<nowiki>*</nowiki> Connaitre le niveau de mot de passe de l'IBMi :

DSPSYSVAL SYSVAL(QPWDLVL)

'''Source :'''

https://www.ibm.com/support/pages/how-access-file-shares-ibm-i-using-qntc

'''Utilisation du QNTC avec Opale :'''

Une fois le système de fichiers QNTC configuré avec un serveur de partage de fichiers externe, il suffit d'indiquer le chemin depuis QNTC dans une commande Mapping.

Par exemple, avec le paramètre XPSOUTFILE de la commande MAPCPYSPLF :

MAPCPYSPLF SPLF(&SPLF) SPLNUM(&SPLNUM) JOB(&JOB) JOBNUM(&JOBNUM) USER(&USER) MAPNAM(&MAPNAM) MAPSEQ(&MAPSEQ) MAPMOD(&MAPMOD) OUTQ(&LIBDES/&OUTDES) DEL(&MAPSUP) FORMTYPE(*SPL) MAPSAV(&MAPSAV) SNDFDP(&SNDFDP) SNDPOL(&SNDPOL) PAGSTR(*SPL) PAGEND(*SPL) NBCOPY(*SPL) TYPLAN(*XPS) XPSCONVERT(*PDF) '''XPSOUTFILE('/QNTC/MyRemoteFileServer/MySharedFolder/MyFile.pdf')'''

MAPCPYSPLF utilise le &USER de l'IBMi comme propriétaire du fichier créé, celui-ci doit donc exister comme utilisateur sur le serveur de partage de fichiers.

Si le &USER n'existe pas sur l'IBMi, MAPCPYSPLF le remplacera par l'utilisateur MAPPING.

Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC

2021-09-17T15:15:24Z

#REDIRECTION [[OPALE:Utilisation:Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC]]

OPALE:Utilisation:Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC

2021-09-17T15:09:52Z

Nturpin :

OPALE:Utilisation:Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC

2021-09-17T15:02:44Z

Nturpin :

OPALE:Utilisation:Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC

2021-09-17T14:11:20Z

Nturpin :

OPALE:Utilisation:Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC

2021-09-17T14:10:29Z

Nturpin :

== Question : ==
Comment accéder aux partages de fichiers depuis IBMi en utilisant le système de fichiers QNTC.

== Réponse : ==
Le système de fichiers QNTC de l'OS IBMi permet à l'IBMi d'agir comme un client dans un réseau SMB/CIFS et d'accéder aux serveurs de fichiers Windows, Samba et IBMi.

Le système de fichiers QNTC réside à la racine du système de fichiers de l'IBMi.

WRKLNK OBJ('/QNTC/*') affiche les serveurs réseau externes qui hébergent des partages de fichiers.

Cette liste est alimentée de deux manières.

La première consiste à parcourir dynamiquement le nom de domaine du réseau spécifié dans les propriétés de NetServer du système d'exploitation IBMi.

La seconde consiste à effectuer manuellement un MKDIR DIR('/QNTC/MyRemoteFileServer') où MyRemoteFileServer est remplacé par le nom d'hôte ou l'adresse IP du serveur externe.

Tous les répertoires sous le système de fichiers QNTC ne survivent que jusqu'au prochain IPL et doivent être recréés après un IPL.

Les répertoires qui ont été créés dynamiquement via l'exploration du domaine du réseau devraient se remplir à nouveau, mais les répertoires créés via MKDIR devront être créés à nouveau via MKDIR.

Pour se connecter à un serveur de fichiers externe, le client IBMi QNTC doit envoyer des informations d'identification valides.

Par défaut, l'IBMi envoie l'USRPRF et le PWD des utilisateurs actuellement connectés.

Cependant, un utilisateur interactif peut se connecter en utilisant un USRPRF IBMi alternatif via SBMJOB.

Par exemple :

SBMJOB CMD(DSPLNK OBJ('/QNTC/MyRemoteFileServer/*')) USER(AlternateIBMiUSRPRF)

AlternateIBMiUSRPRF doit exister à la fois sur le client IBMi et sur MyRemoteFileServer et les mots de passe doivent correspondre entre ces systèmes.

Il convient de noter que si la valeur système QPWDLVL* (Niveau de mot de passe) du système d'exploitation IBM i est définie sur 0 ou 1, cela signifie que les mots de passe du système d'exploitation IBMi ne peuvent comporter que 10 caractères, que tous les caractères alphabétiques ne sont pas sensibles à la casse, qu'ils peuvent inclure des chiffres et les quatre caractères spéciaux #, $, _ ou @.

Lorsque ces mots de passe sont transmis au serveur de fichiers externe, tous les caractères alphabétiques sont transmis en minuscules.

Les valeurs 2 et 3 de QPWDLVL transmettent le mot de passe stocké sensible à la casse.

<nowiki>*</nowiki> Connaitre le niveau de mot de passe de l'IBMi :

DSPSYSVAL SYSVAL(QPWDLVL)

Source :

https://www.ibm.com/support/pages/how-access-file-shares-ibm-i-using-qntc

OPALE:Utilisation:Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC

2021-09-17T14:06:21Z

Nturpin :

Question :

Comment accéder aux partages de fichiers depuis IBMi en utilisant le système de fichiers QNTC.

Réponse :

Le système de fichiers QNTC de l'OS IBMi permet à l'IBMi d'agir comme un client dans un réseau SMB/CIFS et d'accéder aux serveurs de fichiers Windows, Samba et IBMi.

Le système de fichiers QNTC réside à la racine du système de fichiers de l'IBMi.

WRKLNK OBJ('/QNTC/*') affiche les serveurs réseau externes qui hébergent des partages de fichiers.

Cette liste est alimentée de deux manières.

La première consiste à parcourir dynamiquement le nom de domaine du réseau spécifié dans les propriétés de NetServer du système d'exploitation IBMi.

La seconde consiste à effectuer manuellement un MKDIR DIR('/QNTC/MyRemoteFileServer') où MyRemoteFileServer est remplacé par le nom d'hôte ou l'adresse IP du serveur externe.

Tous les répertoires sous le système de fichiers QNTC ne survivent que jusqu'au prochain IPL et doivent être recréés après un IPL.

Les répertoires qui ont été créés dynamiquement via l'exploration du domaine du réseau devraient se remplir à nouveau, mais les répertoires créés via MKDIR devront être créés à nouveau via MKDIR.

Pour se connecter à un serveur de fichiers externe, le client IBMi QNTC doit envoyer des informations d'identification valides.

Par défaut, l'IBMi envoie l'USRPRF et le PWD des utilisateurs actuellement connectés.

Cependant, un utilisateur interactif peut se connecter en utilisant un USRPRF IBMi alternatif via SBMJOB.

Par exemple :

SBMJOB CMD(DSPLNK OBJ('/QNTC/MyRemoteFileServer/*')) USER(AlternateIBMiUSRPRF)

AlternateIBMiUSRPRF doit exister à la fois sur le client IBMi et sur MyRemoteFileServer et les mots de passe doivent correspondre entre ces systèmes.

Il convient de noter que si la valeur système QPWDLVL (Niveau de mot de passe) du système d'exploitation IBM i est définie sur 0 ou 1, cela signifie que les mots de passe du système d'exploitation IBMi ne peuvent comporter que 10 caractères, que tous les caractères alphabétiques ne sont pas sensibles à la casse, qu'ils peuvent inclure des chiffres et les quatre caractères spéciaux #, $, _ ou @.

Lorsque ces mots de passe sont transmis au serveur de fichiers externe, tous les caractères alphabétiques sont transmis en minuscules.

Les valeurs 2 et 3 de QPWDLVL transmettent le mot de passe stocké sensible à la casse.

Source :

https://www.ibm.com/support/pages/how-access-file-shares-ibm-i-using-qntc

OPALE:Utilisation:Comment accéder aux partages de fichiers depuis IBMi en utilisant QNTC

2021-09-16T15:58:41Z

Nturpin : Page créée avec « A traduire et compléter : Question How to access file shares from IBM i using the QNTC file system. Answer The IBM i OS QNTC file system allows the IBM i to act as a... »

A traduire et compléter :

Question

How to access file shares from IBM i using the QNTC file system.

Answer

The IBM i OS QNTC file system allows the IBM i to act as a client in an smb/cifs network and access Windows, Samba and IBM i file servers.

The QNTC file system resides under the Root (/) IBM i file system. WRKLNK '/QNTC/*' will display the external network servers that are hosting network file shares. This list is populated in two ways. The first is dynamically via a browse of the network domain name specified in the IBM i OS NetServer properties. The second is by manually doing an MKDIR '/QNTC/server' where server is replaced by the external server hostname or IP address. All directories under the QNTC file system survive only until the next IPL and must be re-created following the IPL. Directories that were dynamically created via the browse of the network domain should populate again, but directories created via MKDIR will have to be created via MKDIR again.

To connect to external file servers, the IBM i QNTC client must send valid credentials. By default, the IBM i sends the current logged-on users' USRPRF and PWD.
However, an interactive user can connect using an alternate IBM i USRPRF via SBMJOB.
For example:

SBMJOB CMD(DSPLNK OBJ('/qntc/MyRemoteFileServer/*')) USER(AlternateIBMiUSRPRF)

The AlternateIBMiUSRPRFmust exist on both the client IBM i and MyRemoteFileServer and the passwords must match between those systems.

A significant note to be aware of is that if the IBM i OS QPWDLVL (Password Level) system value is set to 0 or 1 meaning that IBM i OS Passwords can only be 10 characters long, all alphabetic characters are not case-sensitive, may include numbers and the four special characters of #, $, _, or @. When these passwords are passed to the external file server, all alphabetic characters are passed in lowercase.

QPWDLVL values 2 and 3 will pass the case-sensitive stored password.

Comment utiliser une adresse mail stockée dans une table MySQL

2021-06-02T10:49:06Z

Nturpin : Page créée avec « Dans Designer, le projet doit avoir les 3 zones suivantes pour gérer la distribution du mail : 1. NAME : Zone Mémoire / Mémoire Texte contenant le nom saisi à partir... »

Dans Designer, le projet doit avoir les 3 zones suivantes pour gérer la distribution du mail :

1. NAME : Zone Mémoire / Mémoire Texte contenant le nom saisi à partir du flux de données.

2. EMAIL : Zone Mémoire / Mémoire SQL. Ajoutez la commande SQL suivante dans le champ "Label Ap" :
{SQL SELECT EMAIL FROM TEST.USER WHERE NAME="[[NAME]]"}
Cette zone interroge la base de données et récupère la valeur du champ EMAIL en fonction du NAME. La zone NAME est utilisée pour filtrer la ligne qui nous intéresse.

3. MAPSND : Zone Métadonnée / MapSend.
Envoi un e-mail à la ou aux adresses stipulées dans Designer en utilisant la zone MAPSND. Ici, vous ne récupérez pas la valeur directement du flux de données mais vous souhaitez utiliser la valeur renvoyée par la zone EMAIL. Ainsi, dans la zone MAPSND, vous devez utiliser la valeur EMAIL [[EMAIL]] dans le champ "Lapel Ap".

Ensuite, générez le projet et importez-le comme vous le feriez normalement. À partir de maintenant, chaque fois que le fichier spool est traité avec ce projet, une requête sera effectuée dans la base de données pour déterminer l'adresse mail à utiliser.

Cela fonctionnerait exactement de la même manière sur iSeries, la seule différence étant que sur iSeries nous traitons des fichiers physiques et non des tables de base de données. La base de données sur l'iSeries serait la bibliothèque et la table serait le fichier physique.

ONYX:Utilisation:Création d'un RemoteOutQ pointant vers ONYX

2020-07-17T13:25:33Z

Nturpin : ajouts des paramètres obligatoire pour fonctionner

==== Création d'une RemoteOUTQ sur iSeries pour envoi des spools vers M-PS Windows/Linux ====
CRTOUTQ OUTQ(QGPL/TOWINDOWS) RMTSYS(*INTNETADR) RMTPRTQ(FROMISERIES) AUTOSTRWTR(1) DESTTYPE(*OTHER) TRANSFORM(*NO) INTNETADR(XXX.XXX.XXX.XXX) DESTOPT('XAIX') DSPDTA(*YES) AUTCHK(*DTAAUT) AUT(*ALL)

OUTQ(QGPL/TOWINDOWS) > nom de l'OUTQ à créer, dans cet exemple l'OUTQ TOWINDOWS dans la bibliothèque QGPL

RMTPRTQ(FROMISERIES) > nom de la file d'attente créée dans M-PS sur Windows/Linux

AUTOSTRWTR(1) > nombre de Writer démarré automatiquement, un éditeur doit être démarré pour envoyer les spools à distance

TRANSFORM(*NO) et DESTOPT('XAIX') > paramètres obligatoires

INTNETADR(192.168.216.24) > adresse IP du serveur M-PS Windows/Linux

Commande CHGOUTQ pour modifier une OUTQ existante

ONYX:Utilisation:Utilisation du Mapcompo

2020-07-09T14:05:00Z

Nturpin : Page créée avec « === '''Introduction''' === M-Designer / Mapcompo intègre de nouvelles options de multiligne pour les zones de texte et de tableau pour les groupes fixes et variables. Il... »

=== '''Introduction''' ===
M-Designer / Mapcompo intègre de nouvelles options de multiligne pour les zones de texte et de tableau pour les groupes fixes et variables.

Il permet également de générer dans l’aperçu le fichier tel qu’il sera lors de l’édition.

=== '''Prérequis''' ===
M-Designer version 1.0.0.alpha.1

Format de fichier 10.0.0

=== '''Limites''' ===
L’aperçu MapCompo s’active automatiquement si l’une des nouvelles options est activée dans le projet.

Le multiligne n’est disponible que pour le type de zones texte/normal.

Le tableau ne vérifie que le type de condition Ligne XML.

Il n’est pas possible d’éditer les propriétés d’une condition du tableau depuis la vue Map, il faut passer par la vue Liste des objets et ensuite sélectionner la condition.

=== '''Fonctionnement''' ===

==== '''Multiligne''' ====
L’option Multiligne s’active via une case à cocher dans les propriétés de la zone.
[[Fichier:Multiligne.png]]
Elle permet d’adapter le texte à la longueur de la zone.

''Zone Texte Normal :''
[[Fichier:Multiligne2.png]]
''Aperçu sans Multiligne :''
[[Fichier:Multiligne3.png]]
Le texte dépasse de la zone.

''Aperçu avec le Multiligne :''

[[Fichier:Multiligne4.png]]

Le texte ne sort pas de la zone et effectue un retour automatique à la ligne.

==== '''Tableau''' ====
Pour transformer un groupe fixe ou variable en tableau, il faut cocher la case Tableau depuis les propriétés du groupe.

[[Fichier:Tableau.png]]

''Groupe normal :''

[[Fichier:Tableau2.png]]

''Aperçu'' :

[[Fichier:Tableau3.png]]

''Groupe en mode Tableau :''

[[Fichier:Tableau4.png]]

''Aperçu du mode Tableau :''

[[Fichier:Tableau5.png]]

En activant le mode Tableau, deux nouvelles options apparaissent dans les propriétés du groupe, Borders et Columns

Il est possible d’éditer ces paramètres pour tout le groupe ou bien pour chaque condition.

===== '''Borders''' =====
Sont réglables les bordures haute, droite, basse et gauche.

Pour chacune d’entre elles il est possible de définir l’épaisseur, la couleur et le type du trait.

[[Fichier:Borders.png]]

===== '''Columns''' =====
Il est possible d’ajouter des colonnes supplémentaires en cliquant sur Add Col (et de les supprimer avec le bouton Del Col x)

[[Fichier:Columns.png]]

Par défaut, les colonnes sont en largeur automatique, il est possible de les modifier en cliquant sur le bouton Edition Col x

[[Fichier:Columns2.png]]

===== '''Condition''' =====
Les paramètres Borders et Columns sont également disponible pour chaque condition du tableau.

Par défaut, les conditions utilisent les colonnes du groupe.

[[Fichier:Condition.png]]

Pour que les zones conditionnées utilisent leurs propres colonnes, il faut décocher la case Utiliser les col du groupe

[[Fichier:Condition2.png]]

Fichier:Condition2.png

2020-07-09T14:04:39Z

Nturpin :

condition2

Fichier:Condition.png

2020-07-09T14:04:18Z

Nturpin :

condition

Fichier:Columns2.png

2020-07-09T14:03:56Z

Nturpin :

columns2

Fichier:Columns.png

2020-07-09T14:03:36Z

Nturpin :

columns

Fichier:Borders.png

2020-07-09T14:03:14Z

Nturpin :

borders

Fichier:Tableau5.png

2020-07-09T14:02:49Z

Nturpin :

tableau5

Fichier:Tableau4.png

2020-07-09T14:02:28Z

Nturpin :

tableau4

Fichier:Tableau3.png

2020-07-09T14:02:04Z

Nturpin :

tableau3

Fichier:Tableau2.png

2020-07-09T14:01:33Z

Nturpin :

tableau2

Fichier:Tableau.png

2020-07-09T14:01:11Z

Nturpin :

tableau

Fichier:Multiligne4.png

2020-07-09T14:00:43Z

Nturpin :

multiligne4

Fichier:Multiligne3.png

2020-07-09T13:59:21Z

Nturpin :

multiligne3

Fichier:Multiligne2.png

2020-07-09T13:58:43Z

Nturpin :

multiligne2

Fichier:Multiligne.png

2020-07-09T13:56:46Z

Nturpin :

multiligne

ONYX:9.0:Utilisation:Génération de fichiers PDF

2020-06-04T10:12:22Z

Nturpin : /* Onglet encrypt advanced */

==Description de l'interface==

Pour accéder à l'interface de génération de PDF, double_cliquer sur la commande en question, choisir "XPS to Web format", choisir "Vers PDF".
===Onglet standard===
 
[[Fichier:OX S XPS-PDF STD.png|centré|sans_cadre|692x692px]]

Input filename : Fichier XPS à convertir en PDF (chemin + nom du fichier renseignés en dur ou MAP_FILE_IN)

Output file : Chemin + nom du ou des fichiers PDF à générer (en dur ou MAP_FILE_OUT)

Profile : Profil de conversion à utiliser (FACULTATIF)

===Onglet pages===

[[Fichier:OX S XPS-PDF PG.png|centré|sans_cadre|618x618px]]

Ces paramètres permettent de spécifier le numéro de page de début et le numéro de page de fin du PDF à générer.

Output start page : Numéro de page de début (valeur en dur ou paramètre MAP_STARTPAGE reprenant les numéros de pages du fichier XPS en entrée)

Output end page : Numéro de page de fin (valeur en dur ou paramètre MAP_STOPPAGE reprenant les numéros de pages du fichier XPS en entrée)

===Onglet indexes===

[[Fichier:OX S XPS-PDF index.png|centré|sans_cadre|625x625px]]

Cet onglet permet de générer un fichier d’index (XML, TXT ou CMOD) avec le ou les fichiers PDF (Fichiers d’indexes)
Index export type : Ce paramètre permet de spécifier le type de fichiers d’indexes généré

Output index file name : Ce paramètre permet de spécifier le chemin et le nom du fichier d’index à générer

Export all indexes values on all pages : Ce paramètre définit la façon d’exporter les valeurs.

Soit le fichier d’index contient les indexes de toutes les pages (coché), soit le fichier d’index contient uniquement 1 seule fois l’index. (Les pages ayant le même index ne sont pas répétées)

Export indexes with no value : Si coché, ce paramètre permet également d’exporter les indexes ayant une valeur vide, sinon (non coché), uniquement les indexes avec une valeur non nulle seront exportés.

===Onglet signature===
L’ensemble des paramètres suivants permettent d’apposer une signature électronique aux documents PDF en sortie d'Onyx Server :
<signclass>3</signclass>
<signmode>FILENAME</signmode>
<signpassword>test</signpassword>
<signdriver>OPENSSL</signdriver>
<signsha1hash>3eb783643e522c81d1e34c1943e6f4163e9ad439</signsha1hash>
<signpemfile>C:\tmp\test.pem</signpemfile>
<signcerfile>C:\tmp\test.cer</signcerfile>
<signpfxfile>C:\tmp\valid.pfx</signpfxfile>
<timestampurl>http://servertemp.domain/tsp</timestampurl>

Par défaut, les documents PDF produits par Onyx Server ne sont pas signés.

Si '''signmode''' est vide alors '''La signature est désactivée''' et aucun des autres paramètres n'aura un effet

[[Fichier:OX S sig.png|centré|sans_cadre|634x634px]]

===Onglet encrypt===

[[Fichier:OX S Encrypt.png|centré|sans_cadre|623x623px]]

Cet onglet permet de protéger le fichier PDF par un mot de passe (obligatoire dans la gestion des droits spéciaux des PDF, voir Onglet « Encrypt advanced »).

Encrypt mode : Ce paramètre permet d’activer ou de désactiver la mise en place d’un mot de passe sur le PDF :

*Default : L’encryptage est désactivé
*No : L’encryptage est désactivé
*Yes : L’encryptage est activé

Encrypt user password : Ce paramètre permet de saisir un mot de passe qui sera demandé à chaque ouverture du PDF. L’accès par le mot de passe utilisateur ne donne pas accès aux fonctionnalités bloquées.

Encrypt owner password : Ce paramètre permet de saisir un mot de passe qui sera demandé pour pouvoir modifier les autorisations (impression, modification, copie, etc.) une fois que le PDF sera créé.

Remarques :

#Si le mot de passe utilisateur et le mot de passe propriétaire sont identiques, l’utilisateur aura toutes les autorisations à l’ouverture du fichier.
#Adobe Reader demande le mot de passe à l’ouverture uniquement s’il y a un mot de passe utilisateur. S’il n’y a qu’un mot de passe propriétaire, on ne peut passer en mode propriétaire qu’avec la version payante d’Abobe Reader.
#Le paramètre « Encrypt mode » à default = no.
#Si le paramètre « Encrypt mode » à no = pas de prise en compte de la gestion des mots de passe et des droits sur les fichiers.

===Onglet encrypt advanced===

[[Fichier:OX S encryptadvanced.png|centré|sans_cadre|633x633px]]

Cet onglet permet la gestion des droits spéciaux appliqués au fichier PDF généré. Les droits en question sont :

*Droit d’impression : Donne la possibilité d’imprimer ou non le PDF
*Droit de modification : Donne la possibilité ou non de modifier le PDF (via Acrobat Reader Pro par exemple)
*Droit d’extraction de page : Donne la possibilité ou non d’extraire des pages (via PDF Fill par exemple) :
*:https://www.pdfill.com/document_pages_extract.html
*Droit de commentaire : Donne la possibilité ou non d’ajouter des commentaires
*Droit de signature : Donne la possibilité ou non d’apposer une signature
*Droit d’accessibilité : Donne la possibilité ou non de copier le contenu du fichier PDF
*Droit d’assemblage : Donne la possibilité ou non de modifier l’ordre des pages, d’en supprimer ou d’en insérer
*Droit de hauteur de page : Modifie la résolution d'impression Si No = Basse résolution (150pp), si Yes = Haute résolution

Remarques :

#Pour jouer avec les différents droits, il faut mettre un mot de passe utilisateur et mot de passe propriétaire. (Onglet Encrypt) et ouvrir le PDF avec le mot de passe de l’utilisateur. :
#*Le propriétaire a toujours tous les droits sur le PDF (donc les droits spécifiés dans l’onglet « Encrypt advanced » ne sont pas pris en compte).
#*L’utilisateur a les droits spécifiés dans l’onglet « Encrypt advanced »
#La valeur « default » a pour valeur YES.
#Si « Encrypt allow all » = YES ou DEFAULT alors l’utilisateur a tous les droits
#:Si « Encrypt allow all » = NO alors l’utilisateur a les droits spécifiés dans les listes déroulantes suivantes

==Exemples==

===Variante 1 : Création dun simple PDF===
Prenons pour exemple le workflow suivant :

[[Fichier:OX S CRT PDF.png|centré|sans_cadre|296x296px]]

A)Action « Parameter » : FILE_NAME

Cette action initialise une variable avec une partie d’une autre variable.

Ici nous :

*Créons une variable : FILE_NAME
*Initialisons cette variable avec le basename de la variable MAP_TITLE

(ex : MAP_TITLE : C:\Repertoire\monfichier.txt -> Le basename est : monfichier.txt)

Cette variable est utilisée dans le nommage du PDF.
Voir documentation : Workflow String

B)Action « Parameter » : FILE_NAME

Cette action convertit un fichier XPS en PDF.
Le nom du PDF sera fonction de la variable créée précédemment.

[[Fichier:OX S CRTPDF.png|centré|sans_cadre|799x799px]]

===Variante 2 : Création d'un fichier PDF avec un fichier d'index===

Cette variante permet en plus de créer un fichier PDF, la création d’un fichier XML listant les indexes du fichier XPS d’origine.

[[Fichier:OX S CRTPDFINDEX.png|centré|sans_cadre|626x626px]]

Exemples de génération de fichier d’index :

“Exporter toutes les valeurs d'index sur toutes les pages” non cochée

“Écrire les index même s'ils n'ont pas de valeur” non cochée

*Exporte les indexes une seule fois (uniquement sur la 1ere page trouvée)

“Exporter toutes les valeurs d'index sur toutes les pages” Non cochée

“Écrire les index même s'ils n'ont pas de valeure” Cochée

*Export les indexes une seule fois (uniquement sur la 1ere page trouvée)
*Export des indexes sans valeur ex : IDX_DESCRL

“Exporter toutes les valeurs d'index sur toutes les pages” Cochée

“Écrire les index même s'ils n'ont pas de valeur” Cochée

*Exporte les indexes de toutes les pages, même si ayant les mêmes valeurs que la page précédente.

===Variante 3 : Eclatement par valeur d'index===

Dans l’exemple ci-dessus (Variante 2), nous avons vu que le fichier XPS d’origine comporte des indexes sur certaines pages.
Cette variante montre comment nous pouvons utiliser ces indexes pour créer un fichier PDF par valeur d’index.
Prenons pour exemple un fichier XPS de 3 pages, 1 page par client différent. Nous voulons éclater le PDF par numéro de client (Index IDX_CUSTOMER).

[[Fichier:OX S EcltValIndx.png|centré|sans_cadre|582x582px]]

*Remarque 1: La syntaxe <nowiki>[[NOM_INDEX]]</nowiki>dans le nom du PDF génère 1 PDF par valeur différente d’index <nowiki>[[NOM_INDEX]]</nowiki>
*Remarque 2: Si dans le nom, nous avons 2 valeurs d’index :<code> C:\TEST_AUTO\TOPDF\OUT\DOCUMENT_<nowiki>[[IDX_DOCNUM]]</nowiki>_CUST_<nowiki>[[IDX_CUSTOMER]]</nowiki>.pdf </code>

Il y aura autant de fichiers PDF créés que de combinaisons de valeurs différentes des 2 indexes.

Dans cet exemple :

3 PDF d’une page ayant comme nom DOCUMENT_CUST_00001.pdf, DOCUMENT_CUST_00002.pdf, DOCUMENT_CUST_00003.pdf

===Variante 4 :Gestion des droits===

Cette variante permet de créer un fichier PDF avec des droits spécifiques.

1) Tout d’abord, il faut spécifier un mot de passe pour le propriétaire et un mot de passe pour l’utilisateur :

[[Fichier:OX S gestiondroits.png|centré|sans_cadre|587x587px]]

Le « encrypt mode » doit être à YES. Sinon l’encryptage ne sera pas activé et les mots de passe renseignés n’auront aucun effet.
Ici, le mot de passe utilisateur est « user » et le mot de passe propriétaire est « owner ».

2) Ensuite, il faut renseigner les droits spécifiques :

[[Fichier:OX S GestDroit advancd.png|centré|sans_cadre|579x579px]]

« Encrypt allow all » doit être à NO (si YES alors l’utilisateur aura tous les droits, peu importe les droits renseignés).
L’utilisateur aura uniquement les droits d’impression sur le PDF généré. L’utilisateur est la personne qui ouvre le PDF avec le mot de passe utilisateur : « user ».

Si le PDF est ouvert grâce au mot de passe propriétaire « owner », alors tous les droits seront autorisés.

Remarque : Sur Acrobat Reader, les droits « Assemblage du document » et « Extraction de pages » sont toujours « Non autorisé(e) ». Acrobat Reader désactive automatiquement ces deux autorisations, même si le PDF d’origine les possède.

OPALE:10.1:Controle intégrité des ressources IBM-i

2020-03-03T16:57:19Z

Nturpin : /* Contrôle de l'intégrité à l'importation d'un format */

===Introduction===
Le contrôle d’intégrité permet de contrôler l’intégrité des fichiers de liens existants, afin de vérifier que les liens entre maquettes et objets ne soient pas rompu.

===Contrôle de l'intégrité via un programme===
Pour lancer un contrôle d’intégrité, il faut appeler l’entrée de commandes système et taper :

CALL MAP_C862

Le programme lance alors une première requête SQL :

SELECT mapnam,mapseq FROM maplnk | INNER JOIN mapobj o ON l.objtyp=o.objtyp AND
((l.objnam=o.objnam and l.objnum<>o.objnum) OR (l.objnam<>o.objnam and l.objnum=o.objnum)) WHERE l.objtyp<>’XPS’ GROUP BY l.mapnam, l.mapseq ORDER BY l.mapnam, l.mapseq

Cette première requête donne la liste des formats/séquences mapping utilisant un objet avec un numéro différent ou un même numéro d’objet avec un nom différent.

Le programme lance ensuite une seconde requête SQL :

SELECT l.objtyp,l.objnam,l.objnum FROM maplnk | INNER JOIN mapobj o ON l.objtyp=o.objtyp AND l.objnam=o.objnam AND l.objnum<>o.objnum WHERE l.objTyp <> 'XPS' GROUP BY l.objtyp, l.objnam, l.objnum ORDER BY l.objtyp, l.objnam, l.objnum

Cette seconde requête donne la liste des objets où le même nom d’objet est référencé avec un autre numéro.

Le programme lance ensuite une troisième requête SQL :

SELECT l.objtyp,l.objnam,l.objnum FROM maplnk | INNER JOIN mapobj o ON l.objtyp=o.objtyp AND l.objnam<>o.objnam AND l.objnum=o.objnum WHERE l.objTyp <> 'XPS' GROUP BY l.objtyp, l.objnum, l.objnam ORDER BY l.objtyp, l.objnum, l.objnam

Cette requête donne la liste des objets référencés avec le même numéro mais un texte différent.

Le résultat de ces 3 requêtes est édité dans un fichier spool appelé CTL_INTEG retenu dans votre file d’attente.

Noter que le type XPS n’est pas analysé puisque le numéro d’objet n’est pas utilisé dans les objets XPS …

Si le listing montre une/des erreur(s), vous devez régénérer le fichier lstobj.txt (Call map_823) et éventuellement régénérer vos maquettes.

===Contrôle de l'intégrité à l'importation d'un format===
Lors de l'import d'un format, le programme vérifie l'intégrité du fichier .spt et le compare aux ressources existantes (polices, logos et fonds de page).

Le programme contrôle pour toutes les ressources du fichier qu’il n’existe pas la même ressource affectée à un autre numéro d'objet ou de ressource différente affectée au même numéro d’objet.

Pour cela, il lance 2 requêtes SQL :

SELECT COUNT(*) FROM maplnk WHERE objnam=’OOO’ AND objtyp=’TTT’ AND (mapnam<>’NNN’ OR mapseq<>’SSS’)

Avec OOO,TTT,NNN et SSS remplacées par les valeurs du fichier pst.

Si une ressource existe (même nom et même type) avec un autre numéro et pour une autre maquette, l’importation s’arrête.
[[Fichier:OP S CHECK 1.png|néant|vignette|537x537px]]

Une seconde requête SQL :

SELECT COUNT(*) FROM maplnk WHERE objnam<>’OOO’ AND objtyp=’TTT’ AND Objnum=NNN AND (mapnam<>’NNN’ OR mapseq<>’SSS’)

Avec OOO,TTT,NNN et SSS remplacées par les valeurs du fichier pst.

Si un numéro de ressource existe déjà pour une maquette différente, l’importation s’arrête.
[[Fichier:OP S CHECK 1.png|néant|vignette|537x537px]]

Le résultat de ces requêtes est édité dans un fichier spool appelé CTL_INTEG retenu dans votre file d’attente.
[[Fichier:OP S CHECK 2.png|néant|vignette|470x470px]]

Les ressources de type XPS ne sont pas contrôlées, le numéro de ressource n’étant pas utilisé.

Fichier:OP S CHECK 2.png

2020-03-03T16:33:53Z

Nturpin :

OP_S_CHECK_2

Fichier:OP S CHECK 1.png

2020-03-03T16:29:36Z

Nturpin :

OP_S_CHECK_1

OPALE:10.1:Controle intégrité des ressources IBM-i

2020-03-03T16:25:54Z

Nturpin : /* Contrôle de l'intégrité à l'importation d'un format */

===Introduction===
Le contrôle d’intégrité permet de contrôler l’intégrité des fichiers de liens existants, afin de vérifier que les liens entre maquettes et objets ne soient pas rompu.

===Contrôle de l'intégrité via un programme===
Pour lancer un contrôle d’intégrité, il faut appeler l’entrée de commandes système et taper :

CALL MAP_C862

Le programme lance alors une première requête SQL :

SELECT mapnam,mapseq FROM maplnk | INNER JOIN mapobj o ON l.objtyp=o.objtyp AND
((l.objnam=o.objnam and l.objnum<>o.objnum) OR (l.objnam<>o.objnam and l.objnum=o.objnum)) WHERE l.objtyp<>’XPS’ GROUP BY l.mapnam, l.mapseq ORDER BY l.mapnam, l.mapseq

Cette première requête donne la liste des formats/séquences mapping utilisant un objet avec un numéro différent ou un même numéro d’objet avec un nom différent.

Le programme lance ensuite une seconde requête SQL :

SELECT l.objtyp,l.objnam,l.objnum FROM maplnk | INNER JOIN mapobj o ON l.objtyp=o.objtyp AND l.objnam=o.objnam AND l.objnum<>o.objnum WHERE l.objTyp <> 'XPS' GROUP BY l.objtyp, l.objnam, l.objnum ORDER BY l.objtyp, l.objnam, l.objnum

Cette seconde requête donne la liste des objets où le même nom d’objet est référencé avec un autre numéro.

Le programme lance ensuite une troisième requête SQL :

SELECT l.objtyp,l.objnam,l.objnum FROM maplnk | INNER JOIN mapobj o ON l.objtyp=o.objtyp AND l.objnam<>o.objnam AND l.objnum=o.objnum WHERE l.objTyp <> 'XPS' GROUP BY l.objtyp, l.objnum, l.objnam ORDER BY l.objtyp, l.objnum, l.objnam

Cette requête donne la liste des objets référencés avec le même numéro mais un texte différent.

Le résultat de ces 3 requêtes est édité dans un fichier spool appelé CTL_INTEG retenu dans votre file d’attente.

Noter que le type XPS n’est pas analysé puisque le numéro d’objet n’est pas utilisé dans les objets XPS …

Si le listing montre une/des erreur(s), vous devez régénérer le fichier lstobj.txt (Call map_823) et éventuellement régénérer vos maquettes.

===Contrôle de l'intégrité à l'importation d'un format===
Lors de l'import d'un format, le programme vérifie l'intégrité du fichier .spt et le compare aux ressources existantes (polices, logos et fonds de page).

Le programme contrôle pour toutes les ressources du fichier qu’il n’existe pas la même ressource affectée à un autre numéro d'objet ou de ressource différente affectée au même numéro d’objet.

Pour cela, il lance 2 requêtes SQL :

SELECT COUNT(*) FROM maplnk WHERE objnam=’OOO’ AND objtyp=’TTT’ AND (mapnam<>’NNN’ OR mapseq<>’SSS’)

Avec OOO,TTT,NNN et SSS remplacées par les valeurs du fichier pst.

Si une ressource existe (même nom et même type) avec un autre numéro et pour une autre maquette, l’importation s’arrête.

Une seconde requête SQL :

SELECT COUNT(*) FROM maplnk WHERE objnam<>’OOO’ AND objtyp=’TTT’ AND Objnum=NNN AND (mapnam<>’NNN’ OR mapseq<>’SSS’)

Avec OOO,TTT,NNN et SSS remplacées par les valeurs du fichier pst.

Si un numéro de ressource existe déjà pour une maquette différente, l’importation s’arrête.

Les ressources de type XPS ne sont pas contrôlées, le numéro de ressource n’étant pas utilisé.