Besoin d'aide ?
L’exploitation du format XML d’export Damaris RM
Le format XML d’export Damaris RM vous permet de mieux exploiter les données extraites depuis Damaris RM pour intégrer les données et les documents dans vos autres outils informatiques.
Il est à noter que d’autres fonctions sont disponibles dans Damaris RM pour partager des informations métier et ainsi de faciliter l’usage des applications au sein de votre organisation.
Nos clients utilisent également :
- Les API Web Services Damaris RM
- Les exports au format CSV
- Les tâches de convertisseur des données XML ou CSV
Qui génère les fichiers XML d’export Damaris RM ?
Les fichiers XML d’export Damaris RM sont générés par la tâche d’export documents numériques.
Ce type de tâche vous permet de configurer des exportations des documents accompagnés des métadonnées utilisées lors de leur archivage ou mises à jour après coup.
A quoi peut servir les fichiers XML d’export Damaris RM ?
Ces fichiers contiennent toutes les informations nécessaires pour vous permettre d’importer à nouveau les documents, dans au même niveau d’informations, en utilisant les métadonnées.
Le contenu du fichier XML d’export Damaris RM
Un fichier XML d’export Damaris RM contient les informations suivantes :
- La typologie du document
- Les critères d’indexation
- Un lien vers le document lui-même
Les fichiers PDF exportés sont liés à chaque tag principal permettant de les indexer avec les métadonnées disponibles dans le fichier XML.
Les notions de Notice et de Notice étendue
Les documents Damaris RM sont décrits grâce à des critères principaux, le “Notices”, ainsi qu’avec des critères secondaires appelés les “Notices étendues”.
Pour chaque Notice, il est possible d’attacher 0 à N notices étendues.
De plus, il vous est possible d’attacher plusieurs types de notices étendues pour une notice donnée.
Par exemple, vous pouvez décrire une facture avec une notice contenant les critères globaux de la facture, y ajouter une notice étendue pour les lignes de facturation et une autre notice étendue pour la liste des TVA.
Les Notices
Le tag <numdoc filename=”NOM_FICHIER” pagecount=N>
Ce tag indique le nom du fichier PDF indexé. Le nom du fichier PDF s’y trouve ainsi que le nombre de pages composant ce fichier.
Le tag <document code=”CODE_DOC”>
Ce tag contient le code de la typologie du document concerné.
Cette information est disponible dans le menu Configuration Typologies / Liste des typologies.
Pour chaque typologie (Exemple : Factures fournisseurs, Bulletins de paie, etc.) l’administrateur a paramétré un code document. C’est cette valeur qui se retrouve dans ce tag.
le tag <checksum hash=”PDF_SHA256_HASH”/>
Ce tag contient le hash code SHA-256 du fichier PDF lié aux données.
Le tag <indexes>
Dans ce tag, vous allez retrouver les valeurs des critères d’indexation principaux, les “Notices”.
Le tag <index code=”IDX_CODE” value=”IDX_VALUE”/>
Chaque valeur d’index est présente ici sous la forme du code de l’index et de sa valeur pour ce document en particulier.
Le tag <extendedNotices>
Regroupe toutes les notice étendues.
Le tag <e_documentType code=”CODE_NOTICE_ETENDUE”>
Dans Damaris RM, chaque Notice étendue est définie avec un code de typologie. Ce tag reflète cette information.
Le tag <e_indexes>
Il regroupe toutes les valeurs des critères de la notice étendue en question.
Le tag <e_index code=”NE_IDX_CODE” value=”NE_VALEUR”/>
Idem que les notices, ce tag contient tous les critères par notice étendue.
Un exemple de fichier XML
<?xml version="1.0" encoding="UTF-8"?>
<damaris_electronic_document_exportation timestamp="29/08/2024 19:08:03">
<numdoc filename="20240829190803387.pdf" pagecount="1">
<document code="FactFourn">
<indexes>
<index code="CodeFourn" value="R0001X"/>
<index code="NomFourn" value="RICCI"/>
<index code="TypeDoc" value="Facture"/>
<index code="NumFact" value="14000x"/>
<index code="DateFact" value="2022-03-01"/>
<index code="MntFactHT" value="237,80"/>
<index code="SiretFourn" value=""/>
<index code="TVAIntraco" value=""/>
<index code="DateArchivage" value=""/>
<index code="VCode" value="END"/>
<index code="Statut" value="END"/>
<index code="MntTVA" value="10,00"/>
<index code="MntTTC" value="227,80"/>
<index code="Engagement" value=""/>
<index code="Valideur" value=""/>
<index code="SocieteFacturtee" value=""/>
<index code="CadreFacturation" value=""/>
<index code="ModeDepot" value=""/>
<index code="Devise" value="EUR"/>
<index code="NumCdeContrat" value=""/>
<index code="DateReception" value=""/>
<index code="ModePaiement" value=""/>
<index code="Destinataire" value=""/>
<index code="EtatFacture" value=""/>
<index code="DateEcheance" value=""/>
<index code="NumEcriture" value="00001"/>
<extendedNotices>
<e_documentType code="EcritureComptable">
<e_indexes>
<e_index code="CodeJournal" value=""/>
<e_index code="NumEcriture" value="00001"/>
<e_index code="DateEcriture" value="2023-08-24"/>
<e_index code="NumCpte" value="602000"/>
<e_index code="LibCG" value="Achat n° facture 14000x"/>
<e_index code="AuxTiersAna" value="R0001X"/>
<e_index code="LibAux" value=""/>
<e_index code="RefPiece" value="14000x"/>
<e_index code="DatePiece" value="2022-03-01"/>
<e_index code="Debit" value="237,80"/>
<e_index code="Credit" value=""/>
<e_index code="Devise" value="EUR"/>
<e_index code="Statut" value=""/>
<e_index code="VCode" value=""/>
</e_indexes>
<e_indexes>
<e_index code="CodeJournal" value=""/>
<e_index code="NumEcriture" value="00001"/>
<e_index code="DateEcriture" value="2023-08-24"/>
<e_index code="NumCpte" value="4456"/>
<e_index code="LibCG" value="Achat n° facture 14000x"/>
<e_index code="AuxTiersAna" value="R0001X"/>
<e_index code="LibAux" value=""/>
<e_index code="RefPiece" value="14000x"/>
<e_index code="DatePiece" value="2022-03-01"/>
<e_index code="Debit" value=""/>
<e_index code="Credit" value="10,00"/>
<e_index code="Devise" value="EUR"/>
<e_index code="Statut" value=""/>
<e_index code="VCode" value=""/>
</e_indexes>
<e_indexes>
<e_index code="CodeJournal" value=""/>
<e_index code="NumEcriture" value="00001"/>
<e_index code="DateEcriture" value="2023-08-24"/>
<e_index code="NumCpte" value="4456"/>
<e_index code="LibCG" value="Achat n° facture 14000x"/>
<e_index code="AuxTiersAna" value="R0001X"/>
<e_index code="LibAux" value=""/>
<e_index code="RefPiece" value="14000x"/>
<e_index code="DatePiece" value="2022-03-01"/>
<e_index code="Debit" value=""/>
<e_index code="Credit" value="10,00"/>
<e_index code="Devise" value="EUR"/>
<e_index code="Statut" value=""/>
<e_index code="VCode" value=""/>
</e_indexes>
</e_documentType>
</extendedNotices>
</indexes>
</document>
<checksum hash="e2c8ad156459476cfdc1fd2aa89a586f497c96d380585653919410276568fb0c"/>
</numdoc>
</damaris_electronic_document_exportation>