Conectores personalizados
Nesta página, você encontra uma visão geral do recurso de conectores personalizados no Integration Connectors 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 pelo Integration Connectors. Por exemplo, é possível ter um sistema de gerenciamento de recursos humanos (HRMS, na sigla em inglês) interno com um protocolo de conectividade reservado que você queira expor à Application Integration 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 Integration Connectors para uma fonte de dados ou serviço que você quer conectar.
- Os conectores integrados disponíveis nos Integration Connectors, mas não atendem aos seus requisitos.
Como o Integration Connectors oferece suporte a um conector personalizado?
O Integration Connectors aceita conectores personalizados por meio da especificação OpenAPI (versão 3.0.0 e todas as suas versões secundárias). É possível expor seu back-end como um endpoint público e, em seguida, usar a especificação OpenAPI do endpoint para criar um novo conector que se conecte ao seu endpoint (back-end).
A especificação OpenAPI de um endpoint define o contrato entre os Integration Connectors e o endpoint. O Integration Connectors usa a especificação da API para gerar as ações e entidades do conector. A especificação da API pode ser JSON ou YAML. Veja a seguir um trecho de um exemplo de especificação OpenAPI de 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!\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"
}
}
}
}
Para ver o exemplo completo da especificação, consulte Repositório de exemplo para pet shop.
Suponha que você use essa especificação de exemplo para criar um conector personalizado. O Integration Connectors gera uma ação separada para cada elemento em path. Por exemplo, uploadImage e findByStatus seriam listados como ações compatíveis com o conector personalizado.
Cenários de conectividade de back-end
O Integration Connectors aceita conectores personalizados para os seguintes cenários de conectividade de back-end:
- Conectividade direta no back-end
- Conectividade de back-end indireta
Cenário: conectividade de back-end direta
Neste cenário, o ambiente de execução do Integration Connectors estabelece diretamente a conectividade com o back-end compatível com OpenAPI. A ilustração a seguir mostra a conectividade do conector neste cenário:
Cenário: conectividade de back-end indireta
Nesse cenário, o ambiente de execução do Integration Connectors estabelece conectividade com o back-end por meio de um serviço intermediário (fachada) compatível com OpenAPI. O serviço intermediário, por sua vez, se conecta ao back-end. A ilustração a seguir mostra a conectividade do conector neste cenário:
Versões personalizadas do conector
Com o recurso de versões, é possível criar várias versões de um conector personalizado. Cada versão pode ter uma especificação OpenAPI, um método de autenticação e variáveis de back-end diferentes. Como resultado, ele oferece muita flexibilidade na criação de um conector com várias configurações.
Quando você cria um novo conector, a primeira versão dele é criada automaticamente, e os detalhes da versão são exibidos na guia Versões da página de detalhes do conector personalizado. Para entender como criar uma nova versão de um conector, consulte .
A seguir
Entenda como criar um conector personalizado.