> For the complete documentation index, see [llms.txt](https://interfacing.gitbook.io/interfacing-help-files/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://interfacing.gitbook.io/interfacing-help-files/interfacing-help-files-fr/developpeurs-de-solutions/integrations/integration-amos-kpi.md). # Intégration AMOS KPI Importez automatiquement des valeurs KPI depuis des systèmes externes vers EPC et IMS grâce à l’intégration AMOS KPI. ## Présentation L’**intégration AMOS KPI** permet de transférer vers EPC et IMS les valeurs KPI générées par un système externe. Les fichiers sont généralement transmis par **SFTP** et traités automatiquement par EPC Sync. Chaque fichier est suivi durant le processus. Les équipes d’assistance peuvent vérifier si les données ont été importées ou nécessitent une intervention. {% hint style="info" %} **Bon à savoir**\ Le comportement fonctionnel de l’intégration AMOS KPI est identique dans les versions 15.4.x et 16.0.x. {% endhint %} *** ## Fonctionnement Le processus est principalement automatisé. Dès que le fichier de KPI respecte le format attendu, EPC Sync traite et transmet les données. {% stepper %} {% step %} #### **Les données de KPI sont générées** Un système externe génère un fichier CSV contenant les valeurs de KPI. {% endstep %} {% step %} #### **Le fichier est transmis** Le fichier est placé dans l’emplacement SFTP convenu. {% endstep %} {% step %} #### **EPC Sync reçoit le fichier** Le fichier et ses lignes sont ajoutés à la file de traitement. {% endstep %} {% step %} #### **Les données sont transférées** EPC Sync envoie les valeurs de KPI à EPC/BPC. {% endstep %} {% step %} #### **Le résultat est suivi** Les équipes d’assistance peuvent vérifier le statut de traitement en cas de problème. {% endstep %} {% endstepper %} *** ## Format de fichier Pour traiter correctement un fichier, l’intégration exige un **nom de fichier** et une **structure CSV** conformes au format attendu. #### Nom de fichier Chaque fichier doit respecter le modèle suivant : ``` kpi___.csv ``` Le nom de fichier identifie : | Élément | Description | | ---------------- | ------------------------------------------- | | `company` | L’entreprise associée au KPI | | `kpi-uid` | L’identifiant unique du KPI dans EPC et IMS | | `yyyyMMddHHmmss` | La date et l’heure de la mesure | #### Structure CSV Le fichier doit contenir l’en-tête suivant : ``` id,value ``` Les lignes contiennent ensuite l’ID de référence et la valeur du KPI: ``` id,value row-001,98.2 row-002,97.4 ``` {% hint style="danger" %} **Important**\ Conservez l’en-tête `id,value` exactement comme indiqué. Toute modification peut empêcher le traitement du fichier. {% endhint %} *** ## Comprendre les données KPI Chaque fichier représente **un KPI et un horodatage de mesure**. | Élément | Source | | ---------------------------- | -------------- | | **KPI** | Nom du fichier | | **Date de mesure** | Nom du fichier | | **Valeurs du KPI** | Lignes CSV | | **Référence de traçabilité** | Colonne `id` | Le nom et le contenu du fichier permettent donc d’identifier et de transférer correctement les données KPI. *** ## Statuts de traitement Après réception, un fichier passe par différents statuts de traitement. | Statut | Signification | | ----------------------- | --------------------------------------------------------------------- | | **NEW** | Le fichier est reçu et attend son traitement. | | **PROCESSING** | Le fichier est en cours de traitement et ses valeurs sont transmises. | | **DONE** | Le fichier a été traité avec succès. | | **FAILED** | Le fichier ou l’une de ses lignes n’a pas pu être traité. | | **RETRY** | Le système tentera automatiquement de traiter le fichier à nouveau. | | **PERMANENTLY\_FAILED** | Le nombre maximal de tentatives automatiques est atteint. | ### Que faire si un fichier échoue ? Si un fichier a le statut **FAILED** ou **PERMANENTLY\_FAILED**, l’équipe d’assistance doit examiner le fichier et les détails du traitement pour en déterminer la cause. Les causes courantes incluent : * Un nom de fichier incorrect * Un en-tête CSV incorrect * Des données non valides ou mal formatées dans une ligne * Une valeur non numérique * Un problème avec le système de réception *** ## Questions fréquentes
Pourquoi mon fichier a-t-il été ignoré ? Le nom de fichier existe peut-être déjà dans l’historique de traitement. La réutilisation du même nom de fichier ne déclenche **pas** un nouveau traitement. Assurez-vous que chaque nouveau fichier porte un nom unique.
Pourquoi l’ensemble du fichier a-t-il échoué ? Le nom de fichier ou l’en-tête CSV ne respecte peut-être pas le format attendu. Vérifiez les éléments suivants : * Le nom de fichier respecte la convention de nommage requise * L’en-tête CSV est exactement `id,value`
Pourquoi seules certaines lignes échouent-elles ? Certaines lignes peuvent contenir des données non valides ou mal formatées. Par exemple, une valeur KPI non numérique peut empêcher le traitement correct de cette ligne.
Pourquoi mes lignes sont-elles toujours en attente ? Le fichier attend peut-être encore la tâche de traitement planifiée. Le système de réception des données peut aussi être temporairement indisponible.
*** ## Bonnes pratiques Pour assurer le traitement correct des fichiers KPI :

Utilisez des noms de fichier uniques

Assurez-vous que chaque nouveau fichier KPI porte un nouveau nom. La réutilisation d’un nom peut entraîner le traitement du fichier comme doublon.

Vérifiez l’identifiant du KPI

Assurez-vous que l’UID du KPI dans le nom de fichier correspond au bon KPI dans EPC.

Conservez le format CSV

Utilisez toujours l’en-tête exact id,value et assurez-vous que les valeurs sont correctement formatées.

Surveillez les fichiers en échec

Les équipes d’assistance doivent surveiller régulièrement les fichiers aux statuts FAILED ou PERMANENTLY_FAILED.

*** --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://interfacing.gitbook.io/interfacing-help-files/interfacing-help-files-fr/developpeurs-de-solutions/integrations/integration-amos-kpi.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.