Intégrations et clés API

Les clés API permettent à d’autres systèmes, avant tout Scolah Compass, de travailler avec Resources : lire les budgets et le stock, vérifier une ligne avant l’approbation d’un lot, enregistrer des engagements et des dépenses, réserver et sortir du stock. Les clés appartiennent à toute l’organisation et se gèrent dans Organisation → Intégrations, par les personnes dont le rôle a l’autorisation Intégrations en écriture (le rôle Administrateur par défaut).

Créer une clé

Cliquez sur Nouvelle clé API.
Donnez-lui un Nom (par exemple « Lien Scolah Compass · budget ») et choisissez ses Portées : Budget, Stock ou les deux.
Cliquez sur Créer la clé.
Copiez la clé tout de suite et enregistrez-la dans le système qui l’utilisera. Elle ne sera plus affichée.

Renouveler une clé sans interruption

Cliquez sur Renouveler sur la clé et confirmez. Une nouvelle clé est émise avec le même nom, les mêmes portées et les mêmes espaces de travail.
Copiez la nouvelle clé tout de suite et donnez-la au système qui utilise l’ancienne.
Une fois que ce système a basculé, cliquez sur Révoquer sur l’ancienne clé.

Les deux clés fonctionnent jusqu’à la révocation de l’ancienne, et la nouvelle clé conserve tout ce que l’ancienne a créé : les engagements ouverts, les demandes de déblocage financier et les réservations de stock restent rattachés à elle. Ne remplacez pas une clé en en créant une nouvelle : une nouvelle clé démarre sans espace de travail et ne voit pas ce que l’ancienne a créé. Les clés révoquées restent listées pour la piste d’audit ; les systèmes qui les utilisent cessent de fonctionner immédiatement.

Connecter Scolah Compass

Quand Scolah Compass se connecte avec une clé, il relie l’une de ses agences à un espace de travail : un espace existant, ou un nouvel espace qu’il crée (qui compte dans la limite d’espaces de travail). L’agence liée apparaît dans Paramètres → Général → Paramètres Compass. Dans Scolah Compass Platform, la connexion entre les deux installations se configure dans Connexions ; voir Scolah Compass Resources dans le catalogue.