Personnalisation du traitement des fichiers à l'aide des interfaces Java

Les interfaces Java vous permettent de personnaliser le traitement des fichiers au moyen de classes Java que vous écrivez vous-même. Ces interfaces sont InputSorter, InputSource, PreProcessor et PostProcessor.

Les améliorations apportées au pilote requièrent une programmation Java. Pour implémenter cette fonctionnalité, exécutez les processus suivants :


Création d'une classe Java

Un fichier JavaDoc et un exemple de classe sont fournis avec le pilote afin de vous aider à implémenter cette nouvelle fonction. Ces fichiers se trouvent à l'emplacement suivant : plate-forme\dirxml\drivers\delimitedtext\extensions.


Création d'un fichier Java .jar

Une fois le fichier de classe implémenté, créez un fichier Java .jar (archives Java) en utilisant l'outil .jar. Ce fichier .jar doit contenir la classe que vous avez créée. Placez le fichier .jar dans le répertoire novell/nds/lib. Le chemin d'accès variera peut-être en fonction de la plate-forme que vous utilisez, mais l'emplacement doit être le même que celui des fichiers DelimitedTextShim.jar et DelimitedTextUtil.jar.


Configuration du pilote pour qu'il utilise la nouvelle classe.

Une fois que le fichier .jar se trouve à l'emplacement approprié, modifiez les propriétés du pilote afin de le configurer pour qu'il utilise votre nouvelle classe.

  1. Dans iManager, sélectionnez Gestion DirXML > Présentation.

  2. Localisez le pilote dans son ensemble de pilotes.

  3. Cliquez sur l'icône du pilote pour ouvrir la page Présentation du pilote.

  4. Cliquez de nouveau sur l'icône du pilote pour ouvrir la page Modifier l'objet.

  5. Cliquez sur Configuration du pilote > Paramètres de pilote > Édition XML.

  6. Recherchez la section <publisher-options> du fichier.

    Ce fichier définit les paramètres et les valeurs qui apparaissent dans la section Paramètres de pilote de la page Configuration du pilote.

    Pour chaque classe créée sur le canal Éditeur, vous devez entrer une option supplémentaire dans la section <publisher-options>. Une fois ce fichier mis à jour, les nouvelles options apparaissent dans l'interface.

  7. Pour chaque classe créée sur le canal Éditeur, vous devez ajouter une entrée correspondant au type d'interface. Utilisez le tableau suivant pour vous guider :

    Interface Nouvelle entrée

    InputSorter

    <input-sorter display-name="InputSorter Class">com.acme.MaNouvelleClasse</input-sorter>

    <input-sorter-params display-name="InputSorter init string">MES PARAM DE CONFIG</input-sorter-params>

    InputSource

    <input-source display-name="InputSource Class"> com.acme.MaNouvelleClasse</input-source>

    <input-source-params display-name="InputSource init string">MES PARAM DE CONFIG</input-source-params>

    PreProcessor

    <pre-processor display-name="PreProcessor Class">com.acme.MaNouvelleClasse</pre-processor>

    <pre-processor-params display-name="PreProcessor init string">MES PARAM DE CONFIG</pre-processor-params>

    1. Remplacez com.acme.MaNouvelleClasse par le nom de la classe que vous avez définie et par l'identificateur complet du progiciel.

    2. Remplacez MES PARAM DE CONFIG par n'importe quelle information que vous souhaitez transmettre à la méthode init de votre classe.

      Cette méthode se charge alors d'analyser les informations contenues dans cette chaîne. Si votre classe ne requiert pas l'envoi d'une chaîne de configuration vers la méthode init, vous pouvez ignorer l'élément. Dans ce cas, la valeur nulle est transmise à la méthode.

  8. Si vous avez créé une règle PostProcessor, recherchez la section <subscriber-options> du fichier et ajoutez les lignes suivantes :

    <post-processor display-name="PostProcessor Class">com.acme.MaNouvelleClasse</post-processor> 

    <post-processor-params display-name="PostProcessor init string">MES PARAM DE CONFIG</post-processor-params>
    1. Remplacez com.acme.MaNouvelleClasse par le nom de la classe que vous avez définie et l'ensemble des informations sur le progiciel.

    2. Remplacez MES PARAM DE CONFIG par n'importe quelle information que vous souhaitez transmettre à la méthode init de votre classe.

      Cette méthode se charge alors d'analyser les informations contenues dans cette chaîne. Si votre classe ne requiert pas l'envoi d'une chaîne de configuration vers la méthode init, vous pouvez ignorer l'élément. Dans ce cas, la valeur nulle est transmise à la méthode.

  9. Cliquez sur OK.