Au travers des composants, il est possible d’accéder aux informations pertinentes existantes au sein de l'environnement Microsoft 365.

Cependant, certaines informations utiles et/où utilisées par nos collaborateurs peuvent être fournies par des solutions externes à l'environnement Microsoft 365, auquel cas il devient difficile d'y accéder tout en restant dans notre espace de collaboration.

Pour illustrer ce cas, prenons l'exemple suivant : Afin de garantir l'unicité de certaines informations, consommées par l'ensemble de nos collaborateurs, notamment concernant des produits et des nouveautés, un référentiel de donnée a été créé.

Une application interne a été développée afin que nos collaborateurs puissent exploiter ces informations. Actuellement, mon équipe marketing, qui bénéficie d'un espace de collaboration, a configuré un lien dans cet espace vers l'application interne.

Toutefois, elle aimerait pouvoir consommer ces informations sans avoir à sortir de cet espace de collaboration. 

C'est dans ce but que la fonctionnalité concernant des API tierce a été créée, afin de faciliter l'accès à des données/informations externes à l'environnement Microsoft 365, sans avoir à changer de contexte.

La fonctionnalité est actuellement disponible pour les composants suivants :

• Recherche avancée

Dans le but de préparer la configuration de cette fonctionnalité, veillez à disposer des informations concernant l'API que vous souhaitez exploiter. Particulièrement au sujet des méthodes d'authentification disponibles auprès de cette API, le point de terminaison à utiliser afin de récupérer les données ainsi que le schéma des données récupérées. Une fois ces informations à votre disposition, veuillez vous rapprocher du responsable de l’intégration Jint.

• Entrez en mode édition
• Modifiez le composant
• Activez "Récupérer les données d'une API tiers" 
• Cliquez sur "Ajouter une API tiers"
• Complétez le champ Titre

Configuration de l'authentification :

• Activez le bouton "Configurer l'authentification?"
• Complétez le champ "Point de terminaison d'authentification" 
• En fonction des méthodes d'authentifications supportées par l'API, complétez les parties "Header" et "Body"

Cliquez ensuite sur le bouton Vérifier

• Si les informations fournies on permit de s'authentifier, choisissez le jeton d'accès à utiliser.
• En cas d'échec, un message d'erreur apparaît​​​​​​​

Mot clé disponible :

• {tokenSharePoint} : récupération du token SharePoint.
• {tokenJint} : récupération du token Jint

• Compléter le champ "URL" avec l'URL de récupération des données. Si un paramètre de recherche est utilisé dans l'URL, remplacez la valeur par le mot clé {searchTerms}. Par exemple, si mon URL est https://monpointdeterminaison/search?terms=Produit1 elle devient https://monpointdeterminaison/search?terms={searchTerms}
• En fonction des informations requises, complétez la partie "Header"
  • Si l'authentification est configurée, la valeur du token d'accès peu être utilisée grâce au mot clé : {tokenAuthentification}
• Si le mot clé {searchTerms}, renseignez la valeur par défaut à utiliser.

Cliquez ensuite sur le bouton Vérifier

• Si les informations fournies on permit de récupérer des données, choisissez le nœud racine qui contient les données
• En cas d'échec, un message d'erreur apparaît​​​​​​​​​​​​​​

• Titre : choisissez la propriété à utiliser comme Titre
• Chapo : choisissez la propriété à utiliser comme Chapo 
• ImageUrl : choisissez la propriété à utiliser comme Image
• URL : choisissez la propriété à utiliser comme URL de redirection
• Date : choisissez la propriété à utiliser comme date
• Contact : choisissez la propriété à utiliser comme contact

• Cocher les sources de résultats devant utiliser cet API.