Pour le développement et la DSI
L’interface – ce qu’elle fait et comment l’appeler.
TAOM met à disposition processus, attributs et fonctions via une interface. Cette page décrit à quoi elle sert et à quoi ressemble un accès. Elle ne remplace pas une référence complète – les clients la reçoivent avec leur accès.
Bases
Quatre points préalables
Versionnée
L’interface se trouve sous un espace de noms versionné. Une nouvelle version ne remplace pas l’ancienne en silence ; les intégrations existantes continuent.
Accès nommés
Un accès par application connectée, avec portée, mandant et date d’expiration. Révocable individuellement, l’usage est consigné.
Portée plutôt qu’accès total
Lecture seule, lecture et écriture, ou accès complet. La suppression exige le niveau le plus élevé. La portée est vérifiée à chaque appel.
Lié au mandant
Si un accès porte un mandant, il n’atteint que ses espaces de travail – quel que soit l’identifiant transmis.
Authentification
Un champ d’en-tête, rien de plus
GET https://votre-environnement/wp-json/taom/v1/… Authorization: Bearer <votre clé d'accès>
La clé est affichée une fois à la création puis conservée seulement sous forme d’empreinte. Elle a sa place sur le serveur, jamais dans une application du navigateur.
Domaines
Ce que l’on peut appeler
Espaces de travail et modèles
Créer, lire, modifier, récupérer les versions. Plus phases, métadonnées, groupes de plusieurs diagrammes et sceau de provenance – chaque fichier de modèle produit le porte, et il peut être vérifié sans accès à TAOM.
Enrichissement
Lancer un traitement, interroger son état, récupérer le résultat – pour un élément ou le modèle entier.
Événements de Jira et Confluence
Les changements de statut dans Jira et les passages de texte modifiés dans Confluence reviennent au modèle via notre propre application Atlassian. Le champ détermine qui fait foi. Aller, retour et compétence par champ →
Pièces jointes
Téléverser, lister, récupérer et supprimer des documents – liés à l’élément auquel ils appartiennent.
Agents
Répertoire, profil de style, bibliothèque, ainsi que requête et résultat d’un traitement.
Utilisateurs et licence
Connexion, compte, état de licence – la base pour qu’une application tierce agisse au nom d’un utilisateur autorisé.
Présence
Qui travaille sur un modèle en ce moment. Le travail commun peut ainsi être reflété hors de l’interface.
Deux schémas
À quoi ressemble une intégration habituelle
Récupération
L’application tierce demande, TAOM répond. Adapté aux analyses, aux tableaux de bord et à tout ce qui lit l’état.
Tâche et rappel
Un traitement est lancé, TAOM répond immédiatement par un accusé et signale le résultat plus tard à une adresse enregistrée. Nécessaire car un traitement d’agent dure plus longtemps qu’une requête ne peut attendre.
Possible depuis peu
Interroger tous les espaces de travail
L’interrogation de tout le fonds fonctionne : par attribut, en texte libre ou via treize questions prêtes – par exemple « contrôle requis mais sans cas de test ». La réponse indique modèle, phase et rôle par résultat.
Pas encore disponible
Ce qu’il faut honnêtement ajouter
Propositions pendant la modélisation
La bibliothèque du Learning Model est en place. La proposer pendant la saisie n’est réalisé qu’à un seul endroit.
Limites d’appels
Des plafonds par accès sont prévus mais pas encore fixés.