PDF file generation

Interface description

To access the PDF generation interface, double-click on the command in question, choose "XPS to Web format", choose "Vers PDF".

Standard tab

Input filename: XPS file to convert to PDF (path + file name entered in hard text or MAP_FILE_IN)

Output file: Path + name of the PDF file(s) to generate (hardcoded or MAP_FILE_OUT)

Profile: Conversion profile to use (OPTIONAL)

Pages tab

These parameters allow you to specify the start page number and the end page number of the PDF to be generated.

Output start page: Start page number (hardcoded value or MAP_STARTPAGE parameter including the page numbers of the input XPS file)

Output end page: End page number (hardcoded value or MAP_STOPPAGE parameter including the page numbers of the input XPS file)

Indexes tab

This tab allows you to generate an index file (XML, TXT or CMOD) with the PDF file(s) (Index Files) Index export type: This parameter allows you to specify the type of index files generated

Output index file name: This parameter allows you to specify the path and name of the index file to generate

Export all indexes values ​​on all pages: This setting defines how to export the values.

Either the index file contains the indexes of all pages (checked), or the index file only contains the index once. (Pages with the same index are not repeated)

Export indexes with no value: If checked, this parameter also allows you to export indexes with an empty value, otherwise (unchecked), only indexes with a non-zero value will be exported.

Signature tab

All of the following parameters allow you to affix an electronic signature to PDF documents output from 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

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 : Modifie la résolution d'impression Si No = Basse résolution (150pp), si Yes = Haute résolution

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 : Création dun 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 : 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.

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

• 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 :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 :

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.