Génération de fichiers PDF

<languages/>
<translate>
==Description de l'interface== <!--T:1-->

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=== <!--T:2-->
<br />
[[Fichier:OX S XPS-PDF STD.png|centré|sans_cadre|692x692px]]


<!--T:3-->
Input filename : Fichier XPS à convertir en PDF (chemin + nom du fichier renseignés en dur ou MAP_FILE_IN)

<!--T:4-->
Output file : Chemin + nom du ou des fichiers PDF à générer (en dur ou MAP_FILE_OUT)

<!--T:5-->
Profile : Profil de conversion à utiliser (FACULTATIF)

===Onglet pages=== <!--T:6-->


<!--T:7-->
[[Fichier:OX S XPS-PDF PG.png|centré|sans_cadre|618x618px]]


<!--T:8-->
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.

<!--T:9-->
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)

<!--T:10-->
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=== <!--T:11-->


<!--T:12-->
[[Fichier:OX S XPS-PDF index.png|centré|sans_cadre|625x625px]]


<!--T:13-->
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é

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

<!--T:15-->
Export all indexes values on all pages : Ce paramètre définit la façon d’exporter les valeurs. 

<!--T:16-->
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)

<!--T:17-->
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=== <!--T:18-->
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>

<!--T:19-->
Par défaut, les documents PDF produits par Onyx Server ne sont pas signés.


<!--T:20-->
Si '''signmode''' est vide  alors   '''La signature est désactivée''' et aucun des autres paramètres n'aura un effet


<!--T:21-->
[[Fichier:OX S sig.png|centré|sans_cadre|634x634px]]

===Onglet encrypt=== <!--T:22-->


<!--T:23-->
[[Fichier:OX S Encrypt.png|centré|sans_cadre|623x623px]]



<!--T:24-->
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 »).

<!--T:25-->
<u>Encrypt mode</u> : Ce paramètre permet d’activer ou de désactiver la mise en place d’un mot de passe sur le PDF :

<!--T:26-->
*Default : L’encryptage est désactivé
*No : L’encryptage est désactivé
*Yes : L’encryptage est activé


<!--T:27-->
<u>Encrypt user password</u> : 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.

<!--T:28-->
<u>Encrypt owner password</u> : 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éé.

<!--T:29-->
Remarques : 

<!--T:30-->
#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=== <!--T:31-->


<!--T:32-->
[[Fichier:OX S encryptadvanced.png|centré|sans_cadre|633x633px]]



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

<!--T:34-->
*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


<!--T:35-->
Remarques : 

<!--T:36-->
#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== <!--T:37-->

===Variante 1 : Création dun simple PDF=== <!--T:38-->
Prenons pour exemple le workflow suivant :  

<!--T:39-->
[[Fichier:OX S CRT PDF.png|centré|sans_cadre|296x296px]]   

<!--T:40-->
A)Action « Parameter » : FILE_NAME 

<!--T:41-->
Cette action initialise une variable avec une partie d’une autre variable.

<!--T:42-->
Ici nous :

<!--T:43-->
*Créons une variable : FILE_NAME
*Initialisons cette variable avec le basename de la variable MAP_TITLE

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

<!--T:45-->
Cette variable est utilisée dans le nommage du PDF.
Voir documentation : Workflow String

<!--T:46-->
B)Action « Parameter » : FILE_NAME

<!--T:47-->
Cette action convertit un fichier XPS en PDF.
Le nom du PDF sera fonction de la variable créée précédemment.


<!--T:48-->
[[Fichier:OX S CRTPDF.png|centré|sans_cadre|799x799px]]

===Variante 2 : Création d'un fichier PDF avec un fichier d'index=== <!--T:49-->

<!--T:50-->
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.


<!--T:51-->
[[Fichier:OX S CRTPDFINDEX.png|centré|sans_cadre|626x626px]]



<!--T:52-->
Exemples de génération de fichier d’index : 

<!--T:53-->
“Exporter toutes les valeurs d'index sur toutes les pages” <b>non cochée</b>

<!--T:54-->
“Écrire les index même s'ils n'ont pas de valeur” <b>non cochée</b>

<!--T:55-->
*Exporte les indexes une seule fois (uniquement sur la 1ere page trouvée)

<!--T:56-->
“Exporter toutes les valeurs d'index sur toutes les pages” <b>Non cochée</b>

<!--T:57-->
“Écrire les index même s'ils n'ont pas de valeure” <b>Cochée</b>

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

<!--T:59-->
“Exporter toutes les valeurs d'index sur toutes les pages” <b>Cochée</b>

<!--T:60-->
“Écrire les index même s'ils n'ont pas de valeur” <b>Cochée</b>

<!--T:61-->
*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=== <!--T:62-->

<!--T:63-->
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).


<!--T:64-->
[[Fichier:OX S EcltValIndx.png|centré|sans_cadre|582x582px]]


<!--T:65-->
*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>

<!--T:66-->
Il y aura autant de fichiers PDF créés que de combinaisons de valeurs différentes des 2 indexes.

<!--T:67-->
Dans cet exemple : 

<!--T:68-->
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=== <!--T:69-->

<!--T:70-->
Cette variante permet de créer un fichier PDF avec des droits spécifiques.

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

<!--T:72-->
[[Fichier:OX S gestiondroits.png|centré|sans_cadre|587x587px]]


<!--T:73-->
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 ».

<!--T:74-->
2) Ensuite, il faut renseigner les droits spécifiques :


<!--T:75-->
[[Fichier:OX S GestDroit advancd.png|centré|sans_cadre|579x579px]]


<!--T:76-->
« 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 ».

<!--T:77-->
Si le PDF est ouvert grâce au mot de passe propriétaire « owner », alors tous les droits seront autorisés.

<!--T:78-->
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.
</translate>