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 des 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 les connecteurs d'intégration 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 les connecteurs d'intégration prennent-ils en charge un connecteur personnalisé ?
Les connecteurs d'intégration sont compatibles avec les connecteurs personnalisés via la spécification OpenAPI (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 les connecteurs d'intégration 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! You 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 consulter l'exemple de spécification complet, consultez Exemple de dépôt d'animalerie.
Supposons que vous utilisiez cet exemple de spécification pour créer un connecteur personnalisé. Les connecteurs d'intégration génèreront une action distincte pour chaque élément de path. Par exemple, uploadImage et findByStatus sont listées comme actions compatibles par 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é directe au backend
- Connectivité indirecte du backend
Scénario : Connectivité directe au backend
Dans ce scénario, l'environnement d'exécution des connecteurs d'intégration établit directement la connectivité avec votre backend conforme à l'API Open. L'illustration suivante montre la connectivité du connecteur dans ce scénario:
Scénario : Connectivité indirecte du backend
Dans ce scénario, l'environnement d'exécution des connecteurs d'intégration établit une connectivité avec votre backend via un service intermédiaire (façade) conforme à l'Open API. Le service intermédiaire se connecte ensuite à votre backend. L'illustration suivante montre la connectivité du connecteur dans ce scénario:
Versions du connecteur personnalisé
La fonctionnalité de gestion des versions 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 Gérer les versions de connecteurs personnalisés.
Étape suivante
Découvrez comment créer un connecteur personnalisé.