# Menu XSync

## Avertissement !

{% hint style="warning" %}
Ce site est en cours de rédaction. Nous utilisons différentes icônes dans le menu en fonction du statut du contenu.

* :pick: Ce document est en cours de rédaction ; ni le contenu ni la syntaxe ne sont aboutis
* :hammer\_pick: Ce document est en cours de relecture ; il ne devrait changer que légèrement
* Pas d'icône, la page est censée être terminée 
  {% endhint %}

## Introduction

La solution XSync permet de synchroniser des données entre des systèmes distants (**Remote System**) et Cn285.

Cn285 utilise XSync pour ses besoins de synchronisation.

### Principe de fonctionnement

XSync permet de configurer la connexion de Cn285 aux différents systèmes distants qui peuvent être référentiels sur les clients, produits,...Dans ce cas, les systèmes distants sont appelés **Master System**.

XSync permet le mapping et la synchronisation des champs entre les systèmes sur des entités telles que:

* Customers (via des mappers standards, c'est à dire préconfigurés)
* Products (via des mappers standards, c'est à dire préconfigurés)
* Invoices (via des mappers standards, c'est à dire préconfigurés)
* Users (Mapping manuel)
* Payment Terms (Mapping manuel)
* Bank Account (via des mappers standards, c'est à dire préconfigurés)

### Mapping des données

XSync utilise des **mappers** afin de faire correspondre les données entre Cn285 et le système distant.

Pour certaines entités (voir ci-dessus), il est nécessaire de faire un mapping manuel. Pour cela il faut configurer dans l’onglet “**XSync**” de la vue détaillé de l’entité, les champs suivants:

* **Remote System**: Le système distant associé.
* **Remote Record Type**: Le nom technique du type de donnée dans le système distant.
* **Remote Id** : L’identifiant dans le système distant.

![Exemple de mapping manuel pour l'employé Administrator.](/files/xLDy90JLEqsMnkvyot0g)

### Mode synchrone et asynchrone

Lorsqu'une synchronisation est lancée de manière **asynchrone**, un message est créé et mis dans une file d'attente (aussi appelée queue) pour être traité par un ou plusieurs worker(s). Ce mode de fonctionnement permet de suivre l'avancement de la synchronisation, de garder une trace de cette synchronisation et de gérer les éventuelles erreurs. La visualisation des ces messages est possible depuis le menu [Menu QS](/cn285-documentation/menu-qs.md).

Lorsqu'une synchronisation est lancée de manière **synchrone**, celle-ci est exécutée en direct. Le suivi de la synchronisation n'est donc pas possible. Si une erreur survient durant cette synchronisation, il n'y a aucun moyen de connaitre quel entité est responsable de cette erreur.

{% hint style="warning" %}
Nous vous recommandons de toujours lancer les synchronisations de manière asynchrone.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cn285.app/cn285-documentation/menu-xsync.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.