proALPHA

• « Quels domaines de données notre proALPHA ouvre-t-il via l'interface ? »
• « Montre-moi les 20 premiers enregistrements du point de terminaison Articles. »
• « Que signifient les noms de champs de ce point de terminaison ? »
• « Lis intégralement l'enregistrement avec cet identifiant. »
• « Résume quels champs le point de terminaison Clients renvoie. »

L'assistant prend toujours le même chemin: d'abord lister les domaines, puis les points d'accès, puis leur version, puis la description des champs, et seulement ensuite les enregistrements. Cela paraît lourd, mais c'est le seul chemin honnête, car chez proALPHA chaque installation est autre.

Parce que proALPHA ne livre pas de liste fixe d'interfaces. L'API de lecture est un kit: quels points d'accès existent, c'est votre installation qui le décide. Un consultant, un partenaire ou votre propre IT les crée sous Échange de données, Configuration des points REST. Deux clients proALPHA ont donc deux interfaces différentes.

Ce qui est partout pareil, c'est la construction de l'API de lecture elle-même, et heureusement elle se décrit toute seule. C'est pourquoi l'assistant demande d'abord à votre système ce qu'il donne, au lieu de deviner des domaines qui n'existent peut-être pas chez vous.

1. 01Dans proALPHA, ouvrez la gestion des utilisateurs et créez un utilisateur M2M dédié. Un login ERP normal ne suffit pas.
2. 02Dans l'onglet Autorisation, cochez uniquement REST-SERVICES.
3. 03Donnez un mot de passe fort et notez identifiant et mot de passe en lieu sûr.
4. 04Assurez-vous que sous Échange de données, configuration des points REST, au moins un point de lecture existe.

1. 01Dans anymize, ouvrez Apps, puis Connecteurs, et choisissez proALPHA.
2. 02Saisissez l'adresse de votre installation, par exemple https://erp.votre-entreprise.fr, plus l'utilisateur M2M et son mot de passe de la section ci-dessus.
3. 03Définissez les domaines que l'assistant peut utiliser: le répertoire des points de terminaison et les enregistrements.

Si votre proALPHA tourne en interne, l'interface doit être joignable de l'extérieur. C'est un accord avec votre IT, pas une erreur du connecteur. Dans le cloud proALPHA, elle l'est en général déjà.

Non. Ici, même l'éditeur tire la limite: l'API de lecture est la moitié lecture du kit, l'écriture passe par d'autres chemins qu'anymize n'aborde pas. S'y ajoute notre propre règle: pas d'outils d'écriture.

L'utilisateur M2M ne devrait quand même porter que l'autorisation REST-SERVICES. Deux limites valent mieux qu'une.

• Filtrer par contenu de champ ne marche pas encore. proALPHA filtre via des paramètres nommés d'après vos propres champs, et personne ne les connaît à l'avance. L'assistant feuillette à la place.
• Une page compte au plus 50 enregistrements. C'est voulu: les grandes extractions via l'interface se ressentent sur votre serveur d'application, proALPHA l'écrit lui-même dans sa documentation.
• La description des champs aide à comprendre: les noms de champs proALPHA sont souvent des colonnes allemandes abrégées, et l'assistant peut les traduire en libellés lisibles.

proALPHA tourne sur votre propre installation, en interne ou dans le cloud de l'éditeur. anymize ne parle qu'à l'adresse que vous avez saisie, et les identifiants restent chiffrés dans votre espace de travail.

Ce qui vient de l'ERP, ce sont des données métier à l'état pur. Noms de clients, adresses, interlocuteurs, numéros client et fournisseur et coordonnées bancaires sont remplacés par des placeholders avant qu'un enregistrement aille à un modèle d'IA.