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 pelos Integration Connectors. Por exemplo, talvez você tenha um sistema de gerenciamento de recursos humanos (HRMS, na sigla em inglês) com um protocolo de conectividade reservado, que você expor ao Application Integration por 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 os conectores de integração oferecem suporte a um conector personalizado?

O Integration Connectors aceita conectores personalizados com a especificação OpenAPI (versão 3.0.0 e todas as versões secundárias). É possível expor o back-end como um endpoint público e depois usar a especificação OpenAPI do endpoint para criar um novo conector que se conecta 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 a seguir um trecho de uma especificação de exemplo da OpenAPI 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!\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 conferir a especificação de exemplo completa, consulte o Exemplo de repositório 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 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 conectividade com seu Back-end compatível com APIs abertas. A ilustração a seguir mostra a conectividade do conector nesse cenário:

conectividade de back-end direta

Cenário: conectividade de back-end indireta

Nesse cenário, o runtime dos Integration Connectors 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:

conectividade de back-end indireta

Versões do conector personalizado

Com o recurso de versões, é possível criar várias versões de um conector personalizado. Cada podem ter especificação OpenAPI, 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. para você, 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.