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

Différence entre versions

De MappingDoc
(Page créée avec « =Description de l'interface= ==Onglet standard== '''Input filename''' : Fichier XPS à convertir en PDF (chemin + nom du fichier renseignés en dur ou MAP_FILE_IN) '''Ou... »)
 
Ligne 1 : Ligne 1 :
=Description de l'interface=
+
==Description de l'interface==
  
==Onglet standard==
+
===Onglet standard===
 
'''Input filename''' : Fichier XPS à convertir en PDF (chemin + nom du fichier renseignés en dur ou MAP_FILE_IN)
 
'''Input filename''' : Fichier XPS à convertir en PDF (chemin + nom du fichier renseignés en dur ou MAP_FILE_IN)
  
Ligne 8 : Ligne 8 :
 
'''Profile''' : Profil de conversion à utiliser (FACULTATIF)
 
'''Profile''' : Profil de conversion à utiliser (FACULTATIF)
  
==Onglet pages==
+
===Onglet pages===
 
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.
 
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.
  
Ligne 15 : Ligne 15 :
 
'''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)
 
'''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==
+
===Onglet indexes===
  
 
Cet onglet permet de générer un fichier d’index (XML, TXT ou CMOD) avec le ou les fichiers PDF (Fichiers d’indexes)
 
Cet onglet permet de générer un fichier d’index (XML, TXT ou CMOD) avec le ou les fichiers PDF (Fichiers d’indexes)
Ligne 28 : Ligne 28 :
 
'''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.
 
'''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==
+
===Onglet signature===
 
En cours de correction.
 
En cours de correction.
  
==Onglet encrypt==
+
===Onglet encrypt===
 
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 »).
 
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 »).
  
Ligne 48 : Ligne 48 :
 
# 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.  
 
# 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==  
+
===Onglet encrypt advanced===  
 
Cet onglet permet la gestion des droits spéciaux appliqués au fichier PDF généré. Les droits en question sont :
 
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 d’impression : Donne la possibilité d’imprimer ou non le PDF
Ligne 69 : Ligne 69 :
 
#: Si « Encrypt allow all » = NO alors l’utilisateur a les droits spécifiés dans les listes déroulantes suivantes
 
#: Si « Encrypt allow all » = NO alors l’utilisateur a les droits spécifiés dans les listes déroulantes suivantes
  
=EXEMPLES=
+
==EXEMPLES==
  
==VARIANTE 1 : CREATION D’UN SIMPLE PDF==
+
===VARIANTE 1 : CREATION D’UN SIMPLE PDF===
 
Prenons pour exemple le workflow suivant :  
 
Prenons pour exemple le workflow suivant :  
  
Ligne 91 : Ligne 91 :
 
Le nom du PDF sera fonction de la variable créée précédemment.
 
Le nom du PDF sera fonction de la variable créée précédemment.
  
==VARIANTE 2 : CREATION D’UN FICHIER PDF AVEC UN FICHIER D’INDEX==
+
===VARIANTE 2 : CREATION 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.
 
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.
Ligne 115 : Ligne 115 :
 
* Exporte les indexes de toutes les pages, même si ayant les mêmes valeurs que la page précédente.
 
* 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’INDEXE==
+
===VARIANTE 3 : ECLATEMENT PAR VALEUR D’INDEXE===
  
 
Dans l’exemple ci-dessus (Variante 2), nous avons vu que le fichier XPS d’origine comporte des indexes sur certaines pages.
 
Dans l’exemple ci-dessus (Variante 2), nous avons vu que le fichier XPS d’origine comporte des indexes sur certaines pages.
Ligne 130 : Ligne 130 :
 
3 PDF d’une page ayant comme nom DOCUMENT_CUST_00001.pdf, DOCUMENT_CUST_00002.pdf, DOCUMENT_CUST_00003.pdf  
 
3 PDF d’une page ayant comme nom DOCUMENT_CUST_00001.pdf, DOCUMENT_CUST_00002.pdf, DOCUMENT_CUST_00003.pdf  
  
==VARIANTE 4 : GESTIONS DES DROITS==
+
===VARIANTE 4 : GESTIONS DES DROITS===
  
 
Cette variante permet de créer un fichier PDF avec des droits spécifiques.
 
Cette variante permet de créer un fichier PDF avec des droits spécifiques.

Version du 2 avril 2019 à 12:15

Description de l'interface

Onglet standard

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

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

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

En cours de correction.

Onglet encrypt

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 :

  1. 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.
  2. 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.
  3. Le paramètre « Encrypt mode » à default = no.
  4. 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

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 : A documenter


Remarques :

  1. 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 »
  2. La valeur « default » a pour valeur YES.
  3. 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 : CREATION D’UN SIMPLE PDF

Prenons pour exemple le workflow suivant :

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.

VARIANTE 2 : CREATION 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.

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

“Export all index values on all pages” non cochée “Export indexes with no value” non cochée


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

“Export all index values on all pages” Non cochée “Export indexes with no value” Cochée


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

“Export all index values on all pages” Cochée “Export indexes with no value” 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’INDEXE

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


Remarque 1: La syntaxe NOM_INDEX dans le nom du PDF génère 1 PDF par valeur différente d’index NOM_INDEX

Remarque 2: Si dans le nom, nous avons 2 valeurs d’index : C:\TEST_AUTO\TOPDF\OUT\DOCUMENT_IDX_DOCNUM_CUST_IDX_CUSTOMER.pdf 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 : GESTIONS 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 : 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 : « 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.