Conectores personalizados

Esta página apresenta uma visão geral do recurso de conectores personalizados nos Integration Connectors e pressupõe que você esteja familiarizado com os seguintes conceitos:

Com o recurso de conectores personalizados, é possível usar conectores que não fazem parte dos conectores padrão fornecidos pelo Integration Connectors. Por exemplo, você pode ter um sistema interno de gestão de recursos humanos (HRMS) com um protocolo de conectividade proprietário que quer expor à Integração de aplicativos 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 um serviço que você quer conectar.
  • Os conectores integrados estão disponíveis nos Integration Connectors, mas não atendem aos seus requisitos.

Como o Integration Connectors oferece suporte a um conector personalizado?

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). É possível expor seu back-end como um endpoint público e usar a especificação OpenAPI do endpoint para criar um conector que se conecte a ele (back-end).

A especificação da API aberta de um endpoint define o contrato entre o 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 um JSON ou um YAML. Confira a seguir um trecho de uma especificação Open API 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! 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 completa da amostra, consulte Repositório de exemplo de uma pet shop. Suponha que você use essa especificação de amostra para criar um conector personalizado. O Integration Connectors vai gerar uma ação separada para cada elemento em path. Por exemplo, uploadImage e findByStatus seriam listadas como ações compatíveis com o conector personalizado.

Cenários de conectividade de back-end

Integration Connectors são compatíveis com conectores personalizados para os seguintes cenários de conectividade de back-end:

  • Conectividade direta de back-end
  • Conectividade indireta de back-end

Cenário: conectividade direta com o back-end

Nesse cenário, o ambiente de execução do Integration Connectors estabelece conectividade direta com seu back-end compatível com a API aberta. A ilustração a seguir mostra a conectividade do conector nesse cenário:

conectividade direta de back-end

Cenário: conectividade indireta de back-end

Nesse cenário, o tempo de execução do Integration Connectors estabelece conectividade com seu back-end por um serviço intermediário (fachada) compatível com a API Open. O serviço intermediário se conecta ao back-end. A ilustração a seguir mostra a conectividade do conector neste cenário:

conectividade indireta de back-end

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 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 conector, a primeira versão dele é criada automaticamente para você, e os detalhes da versão são mostrados na guia Versões da página de detalhes do conector personalizado. Para entender como criar uma nova versão de um conector, consulte Gerenciar versões de conectores personalizados.

A seguir

Entenda como criar um conector personalizado.