Connecteurs personnalisés

Cette page présente la fonctionnalité de connecteurs personnalisés dans Integration Connectors. Elle suppose que vous connaissez les concepts suivants :

La fonctionnalité de connecteurs personnalisés vous permet d'utiliser des connecteurs qui ne font pas partie les connecteurs standards fournis par Integration Connectors. Par exemple, vous pouvez disposer d'un système de gestion des ressources humaines (SIRH) interne avec un protocole de connectivité propriétaire que vous souhaitez exposer à l'intégration d'applications via un connecteur. La fonctionnalité de connecteur personnalisé est utile dans les scénarios suivants :

  • Les connecteurs intégrés ne sont pas disponibles dans Integration Connectors pour une source de données ou un service que vous souhaitez connecter.
  • Des connecteurs intégrés sont disponibles dans Integration Connectors, mais ils ne répondent pas à vos exigences.

Comment Integration Connectors est-il compatible avec un connecteur personnalisé ?

Integration Connectors est compatible avec les connecteurs personnalisés via la spécification OpenAPI (la version 3.0.0 et toutes ses versions mineures). Vous pouvez exposer votre backend en tant que point de terminaison public, puis utiliser la spécification Open API de votre point de terminaison pour créer un connecteur qui se connecte à votre point de terminaison (backend).

La spécification OpenAPI d'un point de terminaison définit le contrat entre Integration Connectors et le point de terminaison. Integration Connectors utilise la spécification de l'API pour générer les actions et entités du connecteur. La spécification de l'API peut être au format JSON ou YAML. Voici un extrait d'un exemple de spécification OpenAPI pour un service backend :

{
"openapi":"3.0.2",
"info":{
	"title":"Swagger Petstore - OpenAPI 3.0",
	"description":"This is a sample Pet Store Server based on the OpenAPI 3.0 specification.
  You can find out more about\nSwagger at [
	http://swagger.io](http://swagger.io). In the third iteration of the pet store,
	we've switched to the design first approach!\nYou can now help us improve the API whether
  it's by making changes to the definition itself or to the code.\nThat way,
	with time, we can improve the API in general, and expose some of the new
  features in OAS3.\n\nSome useful links:\n-
  [
	   The Pet Store repository
	]
.....
.....
"paths":{
"/pet/{petId}/uploadImage":{
  "post":{
    "tags":[  
},
.....
.....  
"/pet/findByStatus":{
  "get":{
    "tags":[
      "pet"
    ],
.....
.....  
},
"api_key":{
  "type":"apiKey",
  "name":"api_key",
  "in":"header"
}
}
}
}

Pour voir l'exemple de spécification complet, consultez Exemple de dépôt d'une animalerie. Supposons que vous utilisiez cet exemple de spécification pour créer un connecteur personnalisé. Dans ce cas, Integration Connectors génère une action distincte pour chaque dans path. Par exemple, uploadImage et findByStatus seraient répertoriés comme actions compatibles avec le connecteur personnalisé.

Scénarios de connectivité backend

Les connecteurs d'intégration sont compatibles avec les connecteurs personnalisés pour les scénarios de connectivité de backend suivants :

  • Connectivité backend directe
  • Connectivité backend indirecte

Scénario : Connectivité directe au backend

Dans ce scénario, l'environnement d'exécution Integration Connectors établit directement la connectivité à votre Backend compatible avec l'API ouverte L'illustration suivante montre la connectivité du connecteur dans ce scénario :

connectivité backend directe

Scénario – Connectivité backend indirecte

Dans ce scénario, l'environnement d'exécution Integration Connectors établit la connectivité vers votre backend via un service intermédiaire (façade) conforme à la norme OpenAPI. Le service intermédiaire se connecte ensuite à votre backend. L'illustration suivante montre la connectivité du connecteur dans ce scénario :

connectivité backend indirecte

Versions de connecteurs personnalisés

Cette fonctionnalité vous permet de créer plusieurs versions d'un connecteur personnalisé. Chaque version peut avoir une spécification OpenAPI, une méthode d'authentification et des variables de backend différentes. Par conséquent, il vous offre une grande flexibilité pour créer un connecteur avec différentes configurations.

Lorsque vous créez un connecteur, la première version est créée automatiquement pour vous. Les détails de la version s'affichent dans l'onglet Versions de la page d'informations du connecteur personnalisé. Pour savoir comment créer une version d'un connecteur, consultez .

Étape suivante

Découvrez comment créer un connecteur personnalisé.