Conetores personalizados

Esta página oferece uma vista geral da funcionalidade de conetores personalizados nos Integration Connectors e pressupõe que está familiarizado com os seguintes conceitos:

A funcionalidade de conetores personalizados permite-lhe usar conetores que não fazem parte dos conetores padrão fornecidos pelos Integration Connectors. Por exemplo, pode ter um sistema de gestão de recursos humanos (HRMS) interno com um protocolo de conetividade proprietário que quer expor à integração de aplicações através de um conetor. A funcionalidade de conector personalizado é útil nos seguintes cenários:

  • Os conetores incorporados não estão disponíveis nos conetores de integração para uma origem de dados ou um serviço ao qual quer estabelecer ligação.
  • Os conetores incorporados estão disponíveis nos Conetores de integração, mas não cumprem os seus requisitos.

Como é que os conetores de integração suportam um conetor personalizado?

Os conectores de integração suportam conectores personalizados através da especificação da API aberta (versão 3.0.0 e todas as respetivas versões secundárias). Pode expor o seu back-end como um ponto final público e, em seguida, usar a especificação da API aberta do ponto final para criar um novo conetor que se ligue ao ponto final (back-end).

A especificação da API aberta de um ponto final define o contrato entre os conetores de integração e o ponto final. Os conectores de integração usam a especificação da API para gerar as ações e as entidades do conetor. A especificação da API pode ser um JSON ou um YAML. Segue-se um excerto de uma especificação da API aberta de um serviço de back-end de exemplo:

{
"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 ver a especificação de exemplo completa, consulte o repositório de lojas de animais de estimação de exemplo. Suponhamos que usa esta especificação de exemplo para criar um conector personalizado. Os Integration Connectors geram uma ação separada para cada elemento em path. Por exemplo, uploadImage e findByStatus seriam apresentadas como ações suportadas pelo conetor personalizado.

Cenários de conetividade de back-end

Os conetores de integração suportam conetores personalizados para os seguintes cenários de conetividade de back-end:

  • Conetividade direta de back-end
  • Conetividade de back-end indireta

Cenário: conetividade direta de back-end

Neste cenário, o tempo de execução dos conectores de integração estabelece diretamente a conetividade com o seu back-end compatível com a API aberta. A ilustração seguinte mostra a conetividade do conetor neste cenário:

conetividade direta de back-end

Cenário: conetividade de back-end indireta

Neste cenário, o tempo de execução dos Integration Connectors estabelece a conetividade ao seu back-end através de um serviço intermediário (fachada) compatível com a API aberta. O serviço intermediário, por sua vez, liga-se ao seu back-end. A ilustração seguinte mostra a conetividade do conetor neste cenário:

conetividade de back-end indireta

Versões de conetores personalizados

Com a funcionalidade de controlo de versões, pode 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, oferece-lhe muita flexibilidade na criação de um conector com várias configurações.

Quando cria um novo conector, a primeira versão do conector é criada automaticamente para si, e os detalhes da versão são apresentados no separador Versões da página de detalhes do conector personalizado. Para saber como criar uma nova versão de um conetor, consulte o artigo Gerir versões de conetores personalizados.

O que se segue?

Compreenda como criar um conector personalizado.