|
|
|
Fonctionnalités
|
|
Ce filtre permet d'exporter sous la forme d'un fichier xml personnalisé, les données saisies dans un document formulaire Writer OpenOffice.org.
Le document XML généré peut être ensuite utilisé par une application externe (PGI, GPAO, CAO, service web, ...) ou éventuellement dans OOo par l'intermédiaire d'un filtre XSLT d'import.
|
|
Le formulaire OpenOffice.org doit être paramètré pour que le filtre MaXOOoForm.xsl reconnaisse les données à exporter sous forme xml.
|
Les éléments XML à exporter peuvent être paramètrés sous la forme de sections texte :
|
|
- Pour créer une nouvelle section, positionnez le curseur à l'endroit souhaité dans le document, puis :
Menu / Insertion / Section
- Une section à exporter sous la forme d'un élément xml doit être nommée au format <xml:nom>
ex : <xml:contact>
- Si le schéma xml contient plusieurs éléments de même nom, OOo n'acceptant pas les doublons, le nom des sections texte du formulaire peut être complété d'un indice.
ex: <xml:job> 1
<xml:job> 2
- Les sections texte doivent être imbriquées conformément au schéma xml à exporter. Le navigateur d'OOo facilite cette tâche.
- Les sections dont le nom est au format <xml:nom> et qui ne contiennent aucun contrôle sont exportées sous la forme d'élément avec comme contenu le texte saisie dans les paragraphes de la section.
- Les sections dont le nom n'est pas au format <xml:nom> seront ignorées lors de l'export.
ex : Libelle1
|
A l'intérieur de chaque section xml, les contrôles dont la saisie doit être exportée seront paramètrés de la façon suivante :
|
|
- Pour les contrôles à exporter sous forme d'un élément xml, le nom doit être au format <xml:nom>
ex: <xml:firstname>
- Si le schéma xml contient plusieurs éléments de même nom, OOo n'acceptant pas les doublons, le nom des contrôles du formulaire peut être complété d'un indice.
exemples :
<xml:description> 1
<xml:description> 2
|
|
|
- Pour les contrôles à exporter sous forme d'un attribut xml, le nom doit être au format xml:nom
ex: xml:email
- Si le schéma xml contient plusieurs attributs de même nom, OOo n'acceptant pas les doublons, le nom des contrôles du formulaire peut être complété d'un indice.
exemples :
xml:date[1]
xml:date[2]
- Tous les contrôles de formulaire d'OOo à l'exception de "Table", "Bouton" et "Bouton picto" sont supportés par ce filtre.
|
|
Licence
|
|
Ce filtre XSLT vous est fourni sous licence LGPL ce qui signifie que vous pouvez l'utiliser librement comme extension à Sun StarOffice ou OpenOffice.org au seins de votre entreprise, de votre association ou chez vous.
Vous pouvez également en modifier le code pour corriger des erreurs, en améliorer le fonctionnement ou l'adapter à des besoins spécifiques.
|
|
Reportez vous au texte contenu en entête du fichier MaXOOoForm.xsl pour plus de détail sur la licence.
|
|
Téléchargement
|
|
|
Le fichier MaXOOoForm.zip peut être téléchargé dans la rubrique "Téléchargement".
|
|
Procédure d'installation
|
|
- Assurez vous que le support des filtres XSLT a bien été installé sur votre poste. Pour cela, vérifiez la présence par exemple du filtre XHTML dans "Fichier / Exporter" du module traitement de texte. Un environnement Java doit également être installé sur votre machine. Pour vérifier, vous pouvez lancer à nouveau l'installation d'OOo en mode réparation.
Pour plus d'information sur l'installation de Java : http://fr.openoffice.org/docs/java.htm
- Décompressez le fichier MaXFormsOOo.zip
Il contient les 4 fichiers suivants :
- MaXFormsOOoWriter.jar
- FormulaireCV.sxw
- resume.dtd (ce fichier est vide, il sert uniquement à visualiser sans problème, le fichier xml résultat).
- SpipForm.sxw
- Sélectionnez dans le menu de OOo :
Outils / Paramètrage du filtre XSLT
- Cliquez sur le bouton "Ouvrir le paquetage .."
- Sélectionnez le paquetage MaXFormsOOoWriter.jar
Après clic sur le bouton "Ouvrir", le message suivant doit s'afficher :
"Installation du filtre terminé"
- Sélectionnez le filtre "MaXForms (Writer)" dans la liste puis cliquez sur le bouton "Editer"
- Cliquez sur l'onglet "Transformation". Vérifiez que le chemin d'installation "XSLT pour export" soit bien :
..\OpenOffice.org1.1.x\user\xslt\MaXForms www.maxopeninfo.com (writer)
- L'export de formulaire XML est prêt à fonctionner. Vous pouvez le tester avec les exemples "FormulaireCV.sxw" et "SpipForm.sxw".
Ce nouveau filtre est accessible dans le menu :
Fichier / Exporter... / Format de fichier "MaXForms MaXOpenInfo (Writer) (.xml)"
|
|
Performances
|
|
|
Pour des formulaires d'une ou deux pages (env 50 contrôles) la durée de sauvegarde du fichier xml personnalisé est du même ordre que l'enregistrement au format natif OOo.
|
|
Limites
|
|
- Cet outil a été utilisé jusqu'à présent pour des formulaires < 100 contrôles.
- Actuellement, la suppression et l'ajout des sections xml n'est possible qu'à partir du navigateur.
|
|
Problèmes connus
|
|
- Aucun test n'est effectué sur la syntaxe des noms d'éléments et d'attributs saisis dans le formulaire. Il est donc vivement conseillé de tester le bon fonctionnement après toute modification de paramètrage.
Un outil de contrôle de syntaxe sera donc ajouté dans une prochaine version.
|
|
Améliorations prévues
|
|
- Les tableaux pourront être paramètrés pour la saisie d'informations.
Chaque ligne sera exportée sous la forme d'un élément xml et chaque colonne sous la forme d'un attribut xml.
- Des boutons d'ajout et de suppression des sections xml pourront être ajoutés au formulaire.
- Les fichiers xml créés avec ce filtre pourront être réouverts sous OOo dans le même formulaire.
- Un test de la syntaxe des éléments et des attributs sera effectué.
- Un assistant permettra de créer un formulaire à partir d'un fichier xml personnalisé ou d'un schéma Relax NG.
|
|
|
|
|
|
