> 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/multigest/connecteurs/connecteur-cmis/binding-soap-legacy.md).

# Binding SOAP (legacy)

{% hint style="warning" %}
Binding historique (SOAP), antérieur au binding REST/JSON actuellement utilisé par le connecteur MG Connect. À vérifier auprès de l'équipe technique s'il est toujours supporté en production avant de s'appuyer dessus pour un nouveau projet.
{% endhint %}

## Principe d'interconnexion

Ce binding expose l'implémentation CMIS de Multigest sous forme de web service **SOAP**, décrit par un fichier WSDL accessible à l'adresse :

```
http://srvged/Interconnexion/CMISService.php
```

L'ensemble des méthodes exposées est documenté dans le [standard CMIS 1.1](http://docs.oasis-open.org/cmis/CMIS/v1.1/CMIS-v1.1.pdf).

Ce connecteur est destiné aux développeurs souhaitant intégrer, au sein d'un progiciel métier ou d'un ERP, un accès direct aux documents stockés dans l'armoire Multigest correspondante — par exemple, retrouver la facture associée à un enregistrement de l'application métier.

{% hint style="info" %}
Les fonctions de cette API ne permettent pas de réaliser des opérations d'administration (utilisateurs, armoires). Le paramétrage complet — armoires, plans de classement, utilisateurs, habilitations — doit être réalisé au préalable dans l'interface web de Multigest.
{% endhint %}

## Prérequis serveur

Sur le serveur Apache/PHP hébergeant Multigest :

* ajouter l'extension `php_soap.dll` dans `php.ini`, puis relancer le service Apache ;
* pour un accès en HTTPS, activer l'extension `php_openssl.dll` (le chemin vers PHP doit être renseigné dans la variable d'environnement `PATH`).

Si le serveur Apache n'est pas lui-même le serveur HTTPS (cas d'un reverse-proxy ou d'une frontale HTTPS distincte), ajouter les lignes suivantes dans `bin\webserveur.ini` :

```ini
[WEBSERVICE]
REMOTE_ADDR=192.168.1.5
SERVER_ADDR=https://domaine.fr
```

## Clé unique de rapprochement

L'interconnexion s'appuie sur une **clé de recherche unique**, permettant de retrouver le même enregistrement à la fois dans l'applicatif métier et dans Multigest (par exemple un numéro de facture). Cette clé peut être composée de plusieurs champs de l'armoire Multigest — elle est alors dite multiple. Dans tous les cas, un contrôle des doublons est réalisé pour chaque opération du connecteur.

La base Multigest ne réplique généralement pas l'ensemble des champs de l'application métier : elle contient le plus souvent la clé de rapprochement, complétée de quelques index (date, nom…) facilitant la recherche directement dans la GED si besoin.

La majorité des fonctions de l'API nécessitent trois paramètres : le nom physique de l'armoire Multigest, le login de l'utilisateur, et la clé unique commune à l'application métier et à Multigest.

{% hint style="warning" %}
Le contrôle d'accès aux documents s'appuie sur des règles d'habilitations fines associées au login transmis. L'accès via ce connecteur ne doit jamais permettre de contourner ces droits : les mêmes vérifications doivent s'appliquer que lors d'un accès direct à l'interface Multigest.
{% endhint %}

## Syntaxe `getObjectByPath`

Les éléments de l'arborescence Multigest (armoire, index de dossier, sous-dossiers, fichiers) sont récupérés par chemin, avec le caractère `|` comme séparateur entre les segments de la clé de recherche multiple.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-56f71b584e8b31d019fbd0f37b1e1adbdce74920%2Fconnecteur-cmis-soap-01-arborescence.webp?alt=media" alt="Schéma d&#x27;une armoire Multigest : Armoire > Index (dossier racine) > Sous dossier > Sous sous dossier > Fichier, avec un second exemple équivalent"><figcaption><p>Arborescence Armoire / Index / Sous dossier / Fichier récupérée via <code>getObjectByPath</code></p></figcaption></figure>

Exemple, pour un dossier identifié par la clé multiple `123456 | Dupond | Robert` dans l'armoire `A000002` :

| Élément Multigest                 | `path` transmis à `getObjectByPath`                              |
| --------------------------------- | ---------------------------------------------------------------- |
| Index (dossier racine)            | `/123456\|Dupond\|Robert`                                        |
| Sous dossier                      | `/123456\|Dupond\|Robert/Sous dossier`                           |
| Sous sous dossier                 | `/123456\|Dupond\|Robert/Sous dossier/Sous sous dossier`         |
| Fichier à la racine               | `/123456\|Dupond\|Robert/Fichier`                                |
| Fichier dans un sous dossier      | `/123456\|Dupond\|Robert/Sous dossier/Fichier`                   |
| Fichier dans un sous sous dossier | `/123456\|Dupond\|Robert/Sous dossier/Sous sous dossier/Fichier` |

Dans tous les cas, l'argument `repositoryId` correspond à l'identifiant de l'armoire (ici `A000002`).

## Correspondance méthode CMIS ↔ élément Multigest

| Méthode CMIS      | Élément Multigest                | Description                                                                                                                                                                                                                     |
| ----------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `getRepositories` | Armoire                          | Liste les armoires (repositories) disponibles.                                                                                                                                                                                  |
| `getObjectByPath` | Index, sous dossier ou fichier   | Récupère un objet Multigest à partir de son chemin (`repositoryId` + `path`), construit avec le séparateur `\|` — voir ci-dessus.                                                                                               |
| `getFolderTree`   | Arborescence sous un dossier     | Récupère la structure des sous-dossiers depuis un `folderId` (obtenu via `getObjectByPath`), avec un paramètre `depth` : `1` (premier niveau), `-1` (tous les niveaux) ou une profondeur donnée (`>1`).                         |
| `createFolder`    | Sous dossier / Sous sous dossier | Crée un dossier sous le `folderId` donné, avec ses propriétés (nom, type d'élément).                                                                                                                                            |
| `createDocument`  | Fichier                          | Ajoute un document sous le `folderId` donné : taille (`length`), type MIME (`mimeType`), nom de fichier (`filename`), contenu binaire encodé en base64 (`stream`), état de versioning (`versioningState`, généralement `none`). |

Dans les quatre cas de création/récupération, le `folderId` utilisé est celui retourné par un appel préalable à `getObjectByPath`.


---

# 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/multigest/connecteurs/connecteur-cmis/binding-soap-legacy.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.
