Conectores personalizados
Esta página apresenta uma visão geral do recurso de conectores personalizados nos conectores de integração e pressupõe que você esteja familiarizado com os seguintes conceitos:
O recurso de conectores personalizados permite usar conectores que não fazem parte dos conectores padrão fornecidos pelos Integration Connectors. Por exemplo, você pode ter um sistema interno de gerenciamento de recursos humanos (HRMS, na sigla em inglês) com um protocolo de conectividade reservado que você quer expor à integração de aplicativos por meio de um conector. O recurso de conector personalizado é útil nos seguintes cenários:
- Os conectores integrados não estão disponíveis nos conectores de integração para uma fonte de dados ou um serviço que você quer conectar.
- Os conectores integrados estão disponíveis nos conectores de integração, mas não atendem aos seus requisitos.
Como os conectores de integração oferecem suporte a um conector personalizado?
Os Integration Connectors são compatíveis com conectores personalizados pela especificação OpenAPI (versão 3.0.0 e todas as versões secundárias). Você pode expor seu back-end como um endpoint público e usar a especificação da API aberta dele para criar um novo conector que se conecte ao endpoint (back-end).
A especificação da API aberta de um endpoint define o contrato entre os conectores de integração e o endpoint. Os Integration Connectors usam a especificação da API para gerar as ações e entidades do conector. A especificação da API pode ser JSON ou YAML. Confira abaixo um trecho de uma especificação de API aberta de exemplo para um serviço de back-end:
{
"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"
}
}
}
}Para conferir a especificação de exemplo completa, consulte o Repositório de exemplo de pet shop.
Suponha que você use esta especificação de exemplo para criar um conector personalizado. Os conectores de integração vão gerar uma ação separada para cada elemento em path. Por exemplo, uploadImage e findByStatus seriam listados como ações aceitas pelo conector personalizado.
Cenários de conectividade de back-end
Os Integration Connectors oferecem suporte a conectores personalizados para os seguintes cenários de conectividade de back-end:
- Conectividade de back-end direta
- Conectividade de back-end indireta
Cenário: conectividade direta de back-end
Nesse cenário, o runtime dos conectores de integração estabelece conectividade diretamente ao back-end compatível com a API aberta. A ilustração a seguir mostra a conectividade do conector nesse cenário:
Cenário: conectividade de back-end indireta
Nesse cenário, o runtime dos conectores de integração estabelece conectividade ao back-end por um serviço intermediário (façanha) compatível com a API aberta. O serviço intermediário se conecta ao back-end. A ilustração a seguir mostra a conectividade do conector neste cenário:
Versões do conector personalizado
Com o recurso de controle de versões, é possível criar várias versões de um conector personalizado. Cada versão pode ter uma especificação, um método de autenticação e variáveis de back-end diferentes da OpenAPI. Como resultado, ele oferece muita flexibilidade na criação de um conector com várias configurações.
Quando você cria um conector, a primeira versão é criada automaticamente. Os detalhes da versão são exibidos na guia Versões da página de detalhes do conector personalizado. Para saber como criar uma nova versão de um conector, consulte Gerenciar versões personalizadas de conectores.
A seguir
Entenda como criar um conector personalizado.