Entrée de Registre Convert

Définissez comment convertir un document d'un format à un autre quand un document est ajouté au dépôt Multimédia.

L'entrée de Registre Convert fournit un mécanisme pour la conversion d'un format de document à un autre format. Comme une conversion d'un type de document à un autre est définie comme étant une entrée de Registre séparée, fournir une nouvelle conversion est une simple question d'ajouter une nouvelle entrée de Registre Convert.

Note: Une entrée de Registre Convert définit le mécanisme par lequel un format de document est converti dans un autre format. Elle ne rend pas la conversion disponible pour un utilisateur / groupe. Une entrée de Registre Documents est nécessaire pour rendre la conversion disponible pour les utilisateurs / groupes.

La trame de conversion est composée de trois types de filtres :

  • Filtre côté client : conversion de documents exécutée par un programme côté client (Windows).
  • DDE client : conversion de documents exécutée par un serveur DDE côté client (Windows).
  • Filtre côté serveur : conversion de documents exécutée par un programme côté serveur.

Chaque conversion traduit un format de départ vers un format d'arrivée ; par exemple, on peut commencer avec un document Word et terminer avec un document HTML. Pour chaque entrée de format de départ et d'arrivée, l'un des filtres ci-dessus peut être utilisé.

Les documents du module Multimédia formatés en HTML, RTF ou TEXT (ceux dont le type MIME est text/html ou text/plain) sont automatiquement indexés et entièrement interrogeables.

Quand un document est ajouté au module Multimédia, il est possible d'avoir d’autres formats de document générés automatiquement par le Système. Une entrée de Registre Documents spécifie quel type de document est créé automatiquement lorsqu'un document est ajouté au module Multimédia. Une entrée de Registre Convert spécifie comment convertir un document d'un type de format vers un autre.

Grâce à ce mécanisme, les documents peuvent être convertis en un format indexable et leurs contenus deviennent entièrement consultables.

Voir Comment lancer une recherche dans des documents joints ? pour plus de détails.

Utilisation

Cette entrée de Registre peut-être attribuée aux utilisateurs, aux groupes et à l'ensemble du système :

Clé Utilisateur Groupe Système
Clé 1 User Group System
Clé 2 utilisateur groupe Setting
Clé 3 Setting Multimedia
Clé 4 Multimedia Convert
Clé 5 Convert handle
Clé 6 handle fileext
Clé 7 fileext filtertype
Clé 8 filtertype  
Valeur options
User utilisateur Setting Multimedia Convert handle fileext filtertype options
Group groupe Setting Multimedia Convert handle fileext filtertype options
System Setting Multimedia Convert handle fileext filtertype options

où :

handle

est un pseudonyme de document utilisé pour identifier le type de document à convertir (le format au début).

Un pseudonyme de document est une étiquette utilisée pour identifier un format de document. Par exemple, le pseudonyme d'un fichier HTML est HTMLFile. Le pseudonyme est utilisé à la place de l'extension de document pour attacher un fichier à une partie de logiciel.

En utilisant le handle du document, il est possible de configurer différentes entrées de Registre de conversion pour les documents ayant la même extension de fichier. Par exemple, si MS Word est installé sur un ordinateur, le handle du document pour les fichiers .doc est Word.Document.8. Si WordPad est installé au lieu de MS Word, le handle de document pour les fichiers .doc sera Wordpad.Document.1. Comme les handles sont différents, même si l'extension du fichier est la même, divers filtres de conversion peuvent être configurés. Cela permet de définir des filtres en fonction des logiciels installés sur la machine d'un utilisateur.

Pour déterminer la correspondance entre un pseudonyme et un type de fichier, il est nécessaire de consulter la base de Registre de Windows. Le pseudonyme est la valeur de Registre (Default) de la clé de Registre :

\HKEY_CLASSES_ROOT\fileextension

ex. pour une extension de fichier .aif, en consultant les Registres de Windows, la valeur de (Default) pour \HKEY_CLASSES_ROOT\.aif donne le pseudonyme AIFFile :

Éditeur de registre Windows

De même, en vérifiant l'extension de fichier .html (ou .htm), on trouve la valeur htmlfile, pour des fichiers .txt, on trouve txtfile.

Il est important de se rappeler que le handle du document est utilisé pour déterminer comment un document est traduit d'un format à un autre. Par exemple, si vous convertissez un fichier .doc sur une machine sur laquelle MS Word est installé (avec un handle de document Word.Document.8) en un fichier HTML (avec une extension html), les entrées de registre EMu qui s'appliqueraient seraient les suivantes :

Clé Utilisateur Groupe Système
Clé 1 User Group System
Clé 2 utilisateur groupe Setting
Clé 3 Setting Multimedia
Clé 4 Multimedia Convert
Clé 5 Convert Word.Document.8
Clé 6 Word.Document.8 html
Clé 7 html filtertype
Clé 8 filtertype  
Valeur options

Si la même conversion devait prendre place sur une machine qui a WordPad d'installé plutôt que MS Word, les entrées de Registre suivantes seraient applicables :

Clé Utilisateur Groupe Système
Clé 1 User Group System
Clé 2 utilisateur groupe Setting
Clé 3 Setting Multimedia
Clé 4 Multimedia Convert
Clé 5 Convert Wordpad.Document.1
Clé 6 Wordpad.Document.1 html
Clé 7 html filtertype
Clé 8 filtertype  
Valeur options

Note: Lorsque vous installez de nouvelles entrées de Registre de conversion, il est important de vous assurer que le bon pseudonyme est utilisé pour spécifier le format original du document à convertir. Il est également utile d'envisager quel logiciel peut être installé pouvant effectuer la conversion. Si une entrée de Registre n'est pas trouvée, la conversion n'a pas lieu et le document attendu n'est pas produit.

fileext

est l'extension de fichier du document à produire, sans le point devant l'extension (le document d'arrivée).

filtertype

indique quel est le type de filtre à utiliser. Les valeurs autorisées sont :

  • DDE

    Un filtre DDE côté client utilise le mécanisme Microsoft Dynamic Data Exchange pour convertir un document dans un nouveau format. DDE permet d'appeler un programme et d'exécuter les commandes qui lui sont envoyées. En utilisant cette technologie, il est possible de « piloter » une application à partir d'EMu. Pour que DDE fonctionne, une configuration client/serveur est nécessaire. EMu fonctionne comme un client se connectant à un serveur DDE. Le serveur doit prendre en charge la transaction Exécuter.

    Un exemple de serveur DDE est MS Word. Dans le but de convertir un document d'un format interne Word (.doc) vers un document HTML, il est possible d'invoquer Word en ouvrant le fichier à convertir, en utilisant Enregistrer Sous, en choisissant le format HTML puis en refermant Word. De même, la fonction Enregistrer Sous peut servir à générer des documents TEXT et RTF.

    DDE utilise une étiquette Application pour déterminer quel serveur DDE doit être exécuté. L'étiquette Application est déterminée à partir du Registre Windows. Par exemple, l'étiquette Application pour Microsoft Windows est WinWord. Au sein d'une application, un Sujet est défini pour déterminer quelle partie de l'application doit être utilisée. Les serveurs DDE doivent tous prendre en charge le Sujet du Système. Grâce aux propriétés de l'Application et du Sujet, il est possible d'appeler un serveur DDE et de le préparer à exécuter des commandes. Les entrées de registre d'EMu qui conviennent pour paramétrer l'Application sont les suivantes :

    Clé Utilisateur Groupe Système
    Clé 1 User Group System
    Clé 2 utilisateur groupe Setting
    Clé 3 Setting Multimedia
    Clé 4 Multimedia Convert
    Clé 5 Convert handle
    Clé 6 handle fileext
    Clé 7 fileext DDE
    Clé 8 DDE Application
    Clé 9 Application  
    Valeur application

    et le Sujet :

    Clé Utilisateur Groupe Système
    Clé 1 User Group System
    Clé 2 utilisateur groupe Setting
    Clé 3 Setting Multimedia
    Clé 4 Multimedia Convert
    Clé 5 Convert handle
    Clé 6 handle fileext
    Clé 7 fileext DDE
    Clé 8 DDE Topic
    Clé 9 Topic  
    Valeur topic

    Note: Pour déterminer les valeurs requises pour Application et Topic pour un serveur DDE donné, il est nécessaire de consulter la documentation du serveur.

    Une fois que le serveur a été appelé, il est possible de lancer la commande d'exécution. Le format de la commande varie d'un serveur à un autre. La commande doit ouvrir le fichier original, l'enregistrer dans le format requis et refermer le fichier original. Le format d'une entrée de Registre Commande répondant à ce besoin sera :

    Clé Utilisateur Groupe Système
    Clé 1 User Group System
    Clé 2 utilisateur groupe Setting
    Clé 3 Setting Multimedia
    Clé 4 Multimedia Convert
    Clé 5 Convert handle
    Clé 6 handle fileext
    Clé 7 fileext DDE
    Clé 8 DDE Command
    Clé 9 Command  
    Valeur commande

    commande est une séquence d'instructions envoyée au serveur DDE pour exécution. Comme pour toutes les commandes, %1 et %2 sont respectivement remplacés par les fichiers d'entrée et de sortie.

    Le dernier paramètre permet de définir un délai après la fin de l'exécution de la commande. Certains serveurs DDE peuvent indiquer que la commande est terminée avant que le fichier de sortie soit prêt à être utilisé par EMu (c'est le cas si EMu ne peut pas ouvrir le fichier généré). L'entrée de Registre pour le délai est :

    Clé Utilisateur Groupe Système
    Clé 1 User Group System
    Clé 2 utilisateur groupe Setting
    Clé 3 Setting Multimedia
    Clé 4 Multimedia Convert
    Clé 5 Convert handle
    Clé 6 handle fileext
    Clé 7 fileext DDE
    Clé 8 DDE Wait
    Clé 9 Wait  
    Valeur secondes

    où secondes est le nombre de secondes à attendre une fois que le serveur a fini d'exécuter la commande et avant qu'EMu accède au fichier de sortie. Si l'entrée de Registre n'existe pas, la valeur par défaut est de 10 secondes. Si EMu ne peut pas accéder au fichier de sortie après la traduction, augmenter cette valeur peut résoudre le problème.

    Les entrées de Registre suivantes peuvent être utilisées pour convertir un document MS Word en un document HTML :

    Clé Système Système Système Système
    Clé 1 System System System System
    Clé 2 Setting Setting Setting Setting
    Clé 3 Multimedia Multimedia Multimedia Multimedia
    Clé 4 Convert Convert Convert Convert
    Clé 5 Word.Document.8 Word.Document.8 Word.Document.8 Word.Document.8
    Clé 6 HTML HTML HTML HTML
    Clé 7 DDE DDE DDE DDE
    Clé 8 Application Topic Wait Command
    Valeur WinWord System 20 [FileOpen("%1")][FileSaveAs("%2", ConverterLookup ("HTML"))][FileClose(0)]

    Toutes les entrées de Registre ci-dessus, doivent être renseignées ligne par ligne. L'entrée Command est composée d'une série de commandes VBA exécutées par Word pour ouvrir le document original, l'enregistrer en HTML et refermer l'original. Notons que si Word est déjà ouvert, DDE n'ouvrira pas de nouvelles instances, il utilisera l'existante.

  • Command

    Un filtre côté client est un programme exécuté sur une machine Windows pour convertir un document de son format original dans un autre format. EMu va exécuter le filtre et attendre qu'il soit terminé. Une fois terminé, EMu utilise le fichier de sortie comme document traduit. Le format des entrées de Registre pour les commandes côté client est le suivant :

    Clé Utilisateur Groupe Système
    Clé 1 User Group System
    Clé 2 utilisateur groupe Setting
    Clé 3 Setting Multimedia
    Clé 4 Multimedia Convert
    Clé 5 Convert handle
    Clé 6 handle fileext
    Clé 7 fileext Command
    Clé 8 Command  
    Valeur commande

    Lorsqu'un filtre côté client est exécuté, EMu crée un fichier temporaire avec la bonne extension de fichier (comme spécifié par la valeur fileext). Le fichier temporaire est utilisé comme fichier de sortie dans lequel le document traduit doit être placé. Le format de la commande est le nom du programme devant effectuer la conversion ainsi que les options et arguments associés. Deux espaces réservés peuvent être utilisés dans la commande :

    • Le premier est %1 qui est remplacé par le chemin d'accès complet au fichier à convertir.
    • Le second est %2 qui est remplacé par le nom du fichier qui va héberger le fichier de sortie.

    Par exemple, un script VBA a été développé pour convertir un document HTML en un document texte. Le script utilise deux arguments. Le premier est le nom du fichier HTML à convertir, le second est le nom du fichier de sortie où le fichier texte sera placé. Une entrée de Registre appropriée est :

    Clé Système
    Clé 1 System
    Clé 2 Setting
    Clé 3 Multimedia
    Clé 4 Convert
    Clé 5 HTMLFile
    Clé 6 txt
    Clé 7 Command
    Valeur MyScript %1 %2

    où :

    HTMLFile

    est le pseudonyme du document pour les fichiers HTML.

    txt

    est le nom du fichier à générer.

    Lorsque la commande sera exécutée %1 et %2 seront respectivement remplacés par le fichier à convertir et le fichier de sortie. Notez qu'EMu suspendra l'exécution jusqu'à ce que le filtre ait terminé son exécution. Si le fichier de sortie n'existe pas après l'arrêt des filtres, la conversion est considérée comme échouée et est donc avortée.

    Dans un cas particulier, commande peut prendre la valeur de None. Dans ce cas le fichier d'entrée est simplement copié dans le fichier de sortie sans recours à un filtre.

  • Server Command

    Un filtre côté serveur est très similaire à un filtre côté client, sauf que la commande est exécutée sur le serveur EMu. L'utilisation de filtres côté serveur permettra d'installer le logiciel de traduction sur une seule machine (le serveur) tout en étant accessible à tous les utilisateurs (clients). Les entrées de Registre correspondantes sont :

    Clé Utilisateur Groupe Système
    Clé 1 User Group System
    Clé 2 utilisateur groupe Setting
    Clé 3 Setting Multimedia
    Clé 4 Multimedia Convert
    Clé 5 Convert handle
    Clé 6 handle fileext
    Clé 7 fileext Server Command
    Clé 8 Server Command  
    Valeur commande

    Le format de la commande est exactement le même que pour les filtres côté client. En d'autres termes, il s'agit du programme qui effectue la traduction ainsi que de ses options et arguments. Les emplacements réservés %1 et %2 sont respectivement remplacés par les fichiers d'entrée et de sortie. Lorsqu'un filtre côté serveur est appelé, EMu copie le fichier original depuis la machine client vers une zone temporaire sur le serveur. La commande est ensuite exécutée sur le serveur. Une fois que la tâche est exécutée le fichier de sortie est recopié du serveur vers la machine client.

    Supposons qu'un filtre appelé /usr/local/bin/pdftotext soit installé sur le serveur EMu et qu'il puisse convertir des fichiers PDF en texte. Le filtre prend quelques options et deux arguments, à savoir les fichiers d'entrée et de sortie respectivement. Une entrée de Registre appropriée est :

    Clé Système
    Clé 1 System
    Clé 2 Setting
    Clé 3 Multimedia
    Clé 4 Convert
    Clé 5 AcroExch.Document
    Clé 6 txt
    Clé 7 Server Command
    Valeur /usr/local/bin/pdftotext -eol dos %1 %2

    où :

    AcroExch.Document

    est le pseudonyme du document pour un fichier PDF.

    Note: Le handle du document n'est pas nécessairement AcroExch.Document dans votre environnement - cela dépend de l'application installée pour lire les documents PDF. Vous pouvez identifier le handle en vérifiant l'entrée de Registre Windows \HKEY_CLASSES_ROOT\.pdf

    La commande exécutée sur le serveur est appelée au sein d'un shell UNIX (/bin/sh) ; toute syntaxe shell valide peut donc être utilisée. Si un message d'erreur est envoyé à STDERR, le filtre est considéré comme ayant échoué et la traduction est abandonnée.

    Note: Il existe également un filtre pdftohtml qui fonctionne de la même manière.

options

dépendent du filtertype sélectionné (ex. pour un filtre du type command on peut choisir le nom du programme à lancer).

Les trois filtres et leurs options sont détaillés dans les pages suivantes.

Note: Bien que les entrées de Registre puissent être paramétrées pour un utilisateur ou un groupe, habituellement le format System est utilisé.