> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/produit/efalia-compose/mapping-suite/onyx-server/configuration/connecteurs/connecteur-onbase.md).

# Connecteur OnBase

## Prérequis et concept

Cette partie décrit les procédures de paramétrage et d’utilisation du connecteur OnBase.Le fonctionnement de ce connecteur est assuré avec DESIGNER et ONYX Server.Le principe du connecteur OnBase est de produire des flux PDF et CSV en fonction des informations demandées par l’utilisateur, à destination de l’outil de GED édité par Hyland. Les informations exportées sont basées sur les métadonnées positionnées dans le modèle DESIGNER.

* Le PDF généré est à la norme PDF/A.
* Le flux XML au format OnBase s’appuie sur un fichier modèle (ou patron) renseigné lors de l’appel de la commande d’export.

Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED OnBase : l’apport des fichiers CSV modèles et la définition de variables spécifiques de l’environnement d’exécution. Ce guide s’adresse à un public maîtrisant la conception de modèles de documents avec DESIGNER, et la conversion de documents via la commande map\_xps.

## Préparation de l’export : Le fichier modèle

L’export de document vers la solution de GED OnBase s’effectue au format CSV, à partir d’un fichier modèle défini par l’utilisateur. Ce fichier contient :

* (1) Les métadonnées : le nom des index positionnés dans la maquette M-Designer, dans l’ordre attendu par OnBase
* (2) Le nom du fichier à exporter au format PDF

Le séparateur de colonnes dans le fichier modèle doit correspondre au séparateur configuré dans OnBase.ONYX Server génèrera le fichier PDF et le fichier CSV dans un même répertoire. C’est pourquoi seul le nom du fichier PDF (sans le chemin) apparaît dans le fichier CSV.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-217200312f373cd5da5b3078064e6a8cedc7c71f%2Fonyx-server-configuration-connecteurs-connecteur-onbase-01.webp?alt=media" alt="OX S Utilisation fileCnnc.png"><figcaption></figcaption></figure>

Figure 1 Contenu d’un fichier modèle :

Plusieurs fichiers XML patrons peuvent être nécessaires pour des appels dynamiques en fonction des types de documents à archiver. Ils devront être stockés localement dans un dossier du serveur hébergeant la solution MONYX Server. La variable d’environnement `PATH_DOC_CLASS` permet de renseigner le chemin du dossier local. Sur les plateformes Windows et Linux, cette variable peut être renseignée dans le Menu d’Administration/Gestion de la configuration :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-c49dfef435676123eb467ced59f5edd28a154c36%2Fonyx-server-configuration-connecteurs-connecteur-onbase-02.webp?alt=media" alt="OX S Utilisation VARIABLE configOnBase.png"><figcaption></figcaption></figure>

## Mise en œuvre en ligne de commande

L’export de fichiers PDF se fait suite à une conversion au format PDF grâce à la commande MAP\_XPS. Plusieurs conditions sont nécessaires pour déclencher la génération du fichier CSV attaché au fichier converti.

1. Renseigner le format d’export dans la configuration du serveur. Pour cela, créer la variable d’environnement `DMS_PROVIDER` et lui donner la valeur « OnBase ».
2. Préciser le fichier modèle pour l’export : paramètre exporttemplate sur la ligne de commande.
3. Préciser le nom du fichier CSV résultant de l’export : paramètre indexfile sur la ligne de commande.

Exemple : `map_xps.exe infile:C:\Temp\in.xps outfile:C:\Temp\out.pdf toPDF indexfile:C:\temp\out.csv exporttemplate:bill_template.csv`

La ligne de commande en exemple exporte les critères placés dans le document infile dans le fichier indexfile d’après le fichier modèle construit avec `PATH_DOC_CLASS` et exporttemplate.

## Mise en œuvre dans les Workflows

L’appel au connecteur OnBase est placé dans la section ‘XPS to Web Format’ :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-9a1c30fb150f599525a50ecbdab5183e9b07a3d9%2Fonyx-server-configuration-connecteurs-connecteur-onbase-03.webp?alt=media" alt=""><figcaption></figcaption></figure>

Les paramètres présentés dans la ligne de commande sont repris dans cette boite. Les variables `PATH_DOC_TEMP` et `DMS_PROVIDER` sont toujours à renseigner dans l’environnement.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.efalia.com/produit/efalia-compose/mapping-suite/onyx-server/configuration/connecteurs/connecteur-onbase.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
