Conversion au format PDF

Le bouton Conversion PDF de la fenêtre principale de XDivaltoParamMapi.dhop donne accès aux paramètres de conversion au format PDF. Les options suivantes sont proposées :
 

  1. Convertir les fichiers DivaltoViewer au format PDF lors de l'envoi par mail.
    Demande la conversion du mail au format PDF.

  2. Convertir les fichiers DivaltoViewer au format PDF lors de l'envoi par fax (2).
    Demande la conversion du fax au format PDF.

  3. Lancer Adobe Acrobat Reader avec la commande OPEN ou READ.
    Si vous souhaitez que le ficher PDF issu de la conversion soit immédiatement affiché, cochez cette case et, au besoin, précisez la commande à utiliser au lancement de l'utilitaire de lecture du fichier (OPEN, READ, EDIT, ...).
    Ceci concerne les conversions demandées à partir de DivaltoViewer.  

  4. Ajouter les fichiers joints au PDF.
    Cochez cette case si les fichiers joints doivent être ajoutés au fichier PDF.

  5. Lancer directement Adobe Acrobat Reader en mode aperçu.
    Cochez cette case si l'utilitaire de lecture du fichier PDF doit être appelé après la conversion, en mode "Aperçu avant impression".
    Attention : des fonctions comme l'impression avec les paramètres d'origine ne seront plus disponibles.

 

Paramètres avancés - Polices de caractères

Ce bouton donne accès à un paramétrage avancé de l'utilisation des polices de caractères lors de la conversion.

 

Paramètres avancés - Protections

  1. Générer des fichiers PDF protégés par mots de passe.
    Ce multi-choix (Jamais / Toujours sans question / Poser la question / Toujours avec question) permet de choisir si les fichiers PDF produits par DivaltoViewer doivent être protégés. Si oui :

    1. Mot de passe pour autoriser la lecture.
      Si vous garnissez cette zone, l'utilisateur devra connaître ce mot de passe pour pouvoir lire le fichier (qui est alors crypté).

    2. Mot de passe pour autoriser la modification de la protection.
      Par défaut, le fichier peut être lu et imprimé mais il ne peut pas être modifié et il est interdit d’en sélectionner une partie pour la copier.
      Si vous garnissez cette zone, les droits d’accès au fichier pourront être modifiés en fournissant ce mot de passe. Les droits concernent la sélection et la copie d’une partie du fichier, la modification des annotations et la modification du texte.
       

  3. PDF sécurisés.
    Ce cadre permet de spécifier des règles de sécurisation des fichiers PDF générés :

    1. Toujours générer des fichiers PDF sécurisés.
      Cochez cette case pour que les fichiers PDF générés par DivaltoViewer soient cryptés.

    2. Utiliser une clé 128 bits.
      Par défaut, la clé de cryptage utilisée est une clé 40 bits. Cochez cette case pour la passer à 128 bits.

Le cadre "Demander à Adobe Acrobat Reader d'interdire" permet de spécifier les fonctions interdites à l'utilisateur (Copie des textes et graphiques, Ajout d'annotation, Modification, Impression)).

 

Paramètres avancés - Traitement des pages

Ce bouton donne accès à des options avancées concernant une éventuelle :

  1. Compression du contenu.

  2. Conversion sous forme d'image.

  3. Mise en page (marges, format, centrage).

 

Paramètres avancés - Gestion des images

  1. Toujours gérer les images en mode fichier plutôt qu'en mode mémoire.
    Cette option est surtout intéressante si vous êtes amené à effectuer des conversions "massives" d'états dhvw au format PDF (plus de 100 états par exemple) :

    1. Mode "mémoire" (mode par défaut).
      A fin d'optimisation, l'image du fond de chaque page de l’état est d’abord générée en mémoire.
      L'ensemble de ces images est stocké par Windows dans une zone mémoire spécifique, susceptible de saturer si le nombre et la taille des images devient très important.

    2. Mode "fichier".
      Windows peut aussi stocker les images dans des fichiers temporaires.
      Dans ce cas, le traitement est beaucoup plus lent mais il permet de ne plus avoir de limite de taille.
       

  3. Comprimer les images.
    Cochez cette case pour que les images soient compressées dans le PDF généré.

 

Paramètres avancés - Gestion des erreurs

  1. Enregistrer la liste des erreurs de conversion.
    Cochez cette case pour générer un fichier mouchard répertoriant la liste des fichiers dhvw dont la conversion ne s'est pas correctement effectuée. Auquel cas :

    1. Nom du fichier log où enregistrer les erreurs.
      Indiquez ici le nom du fichier mouchard (CompteRenduConversionPDF.log par défaut). Ce fichier se trouve dans le répertoire /Divalto/DivaltoLog. Le contenu de ce fichier est précisé ci-dessous.

    2. Répertoire de copie des fichiers erronés.
      Indiquez ici le nom d'un dossier où seront copiés les fichiers en erreur.
      Par défaut, ces fichiers ne sont pas copiés.

    3. Répertoire de copie des fichiers convertis sans erreur.
      Indiquez ici le nom d'un dossier où seront copiés les fichiers convertis sans erreur.
      Par défaut, ces fichiers ne sont pas copiés.
       

  3. Délai d'attente maximum si DivaltoViewer ne répond pas (en secondes).
    Un time-out est demandé par DivaltoViewer afin d'être débloqué si la conversion ne répond pas. Cette valeur permet de spécifier la durée de ce time-out (180s par défaut).

 

Le fichier mouchard contient, pour chaque fichier converti en erreur, une ligne de la forme :

  1. <fileorg> : chemin et nom du fichier dhvw d’origine.

  2. <filedest> : chemin et nom du fichier pdf de destination.

  3. <page> : numéro de la page où l'erreur s’est produite.
    Remarque : Si le numéro de page est égal à 0, l’erreur s’est produite avant la conversion de la première page, lors de la génération des informations sur le PDF à produire. Si le numéro de page est égal à 9999, l’erreur s’est produite après la conversion de la dernière page, lors de l’écriture du flux PDF.

  4. <time> : date et heure au format jj/mm/aaaa hh:mm:ss.

  5. <msg> : texte de l’erreur.

 

A l'attention des développeurs :

Vous pouvez traiter le fichier des erreurs :

  1. Effacer le fichier avant de commander la conversion des dhvw en pdf.

  2. A la fin du traitement, ouvrez le fichier. S'il est vide, c'est que la conversion s'est effectuée sans erreur.

  3. Si vous lisez le fichier, attention à prévoir un buffer de lecture suffisant (4096 octets par ligne).

Si les fichiers dhvw sont toujours présents sur le disque, vous pouvez relancer la conversion en lisant chaque ligne du fichier des erreurs et en récupérant les informations (au format hmp) par hmpseek.
 

Exemple :

include "zmapi.dhsp"

1 ficorg  260

1 ficdest 260

1 i       X

...

i = MapiOpen

if i <> 0

   ...                       ;erreur

endif

 

if MapiTestSiConvertPDF

   do

      i = fread (tdf,enreg,"F")

   while (i = 0)

      ficorg  = hmpseek ("fileorg",enreg)   

      ficdest = hmpseek ("filedest",enreg)

      MapiConvertPDF (ficorg,ficdest)

   wend

endif

 

MapiClose

...