Ir para o conteúdo

Conector do App Builder no Jitterbit App Builder

Visão Geral

Conector do App Builder é um recurso projetado para conectar duas instâncias diferentes do App Builder e tratá-las como uma Regra, importar a Tabela e começar a usá-la.

Como Desenvolvedor, você pode usar o Conector do App Builder para conectar duas instâncias diferentes que estão rodando no mesmo ambiente (Local) ou em dois ambientes diferentes via HTTP (Remoto). Os passos para configurar Conectores do App Builder Locais e Remotos são fornecidos neste artigo.

Se você está tentando resolver um cenário de dependência de LP do App Builder, recomendamos que você use o recurso Herdar Tabela ou Estender Tabela e não use o Conector do App Builder para resolver isso. O recurso Estender Tabela permite que você escolha facilmente tabelas que deseja usar de outras Fontes de Dados que residem na mesma instância ou ambiente, e não cria uma dependência em nenhum dos outros aplicativos quando estiver pronto para agrupar e enviar seu LP de aplicativo.

Um exemplo do cenário de dependência de LP do App Builder:
Você tem duas Fontes de Dados do App Builder residindo na mesma instância ou ambiente e está procurando juntar entre a Fonte de Dados A e a Fonte de Dados B. Se seu aplicativo está usando a Fonte de Dados A e você deseja usar uma tabela da Fonte de Dados B, e então você precisa enviar uma versão do aplicativo A, que usa apenas 1 tabela do aplicativo B, você precisa agrupar e enviar ambos os aplicativos A e B. Aqui novamente, a maneira recomendada de resolver esse tipo de cenário é usando Tabelas Estendidas. Esta é uma solução muito mais simples e melhor de usar.

Aviso

Geralmente, não é recomendado que qualquer cliente trabalhe com Conectores do App Builder por conta própria sem consultar primeiro seu consultor dedicado da Jitterbit ou contato.

Conector Local do App Builder

O Conector Local do App Builder pode ser usado para estabelecer uma conexão de uma fonte de dados relacional para outra, dentro do mesmo ambiente.

1. Criando um conector local do App Builder

  • No IDE, clique em Servidores de Dados
  • Clique em + Servidor no painel de Servidores de Dados
  • Nomeie sua conexão de servidor
    • A melhor prática de nomenclatura é nomear o servidor como 'Local App Builder'
  • Selecione o Tipo App Builder na seção de Configurações do Servidor
  • Selecione o Tipo de App Builder Local
  • Clique em Salvar

2. Criando uma fonte de dados usando o conector local do App Builder

  • No IDE, clique em Servidores de Dados
  • Clique para selecionar a entrada Local App Builder no painel de Servidores de Dados
  • Clique no botão + Fonte no painel de Fontes de Dados
  • Clique em + Criar Banco de Dados
  • Nomeie sua Fonte de Dados no campo Nome do Banco de Dados
    • A melhor prática de nomenclatura é nomear a Fonte de Dados da seguinte forma: [Fonte de Dados à qual você está se conectando] ([Aplicativo usando o conector])
      • Por exemplo: Se você estivesse criando um conector local para Northwinds e conectando-o a um aplicativo chamado Meu Aplicativo, o nome seria: Northwinds (Meu Aplicativo)

  • Selecione a Fonte de Dados à qual você deseja criar uma conexão no campo Nome do Banco de Dados

    Nota

    Você deve selecionar um banco de dados relacional. Uma tabela/objeto de dados público é necessário na Fonte de Dados para que ela possa ser selecionada como o Banco de Dados.

  • Clique em Próximo

  • Revise as atualizações propostas e clique em Concluído

Nota

Recomendamos criar uma fonte de dados diferente cada vez que você quiser conectar seu aplicativo a outro banco de dados relacional.

Por exemplo: Se você tiver dois aplicativos e quiser usar uma Conexão do App Builder local para se conectar ao Northwinds, você criaria duas fontes de dados. Seguindo nossa convenção de nomenclatura, elas seriam:

  • Northwinds (Meu Aplicativo 1)
  • Northwinds (Meu Aplicativo 2)

3. Permitir acesso público às tabelas/objetos de negócios que você deseja usar em seu conector

  • Navegue até o App Workbench para o aplicativo que você deseja usar
  • Clique no bloco Business Layer Rules
  • Selecione a App Data Source para refletir a fonte de dados que contém as tabelas que você marcará com Acesso Público
  • Marque quaisquer Tabelas ou Regras de Negócio que você deseja usar em seu conector como Públicas
    • Para marcar uma tabela como Pública, clique no ícone Open Record > clique em More > Edge Case > no grupo Acesso Público, marque para habilitar Allow Read e/ou Allow Write
    • Para marcar uma regra de negócio como Pública, clique duas vezes na Regra para navegar até a página de Definição da Regra > clique em More > Edge Case > no controle Allow Public Access, marque para habilitar Read e/ou Write
      • Read permitirá que você leia os dados naquela tabela/objeto
      • Write permitirá que você modifique a data naquela tabela/objeto

Nota

Recomendamos fortemente que você não modifique a tabela/objeto de negócio público uma vez que tenha sido tornado público e usado em um conector. Consulte a seção de limitações abaixo para mais informações.

4. Importar tabelas/objetos de negócio para seu conector

  • Navegue até o IDE, clique em Data Servers
  • Clique para selecionar a entrada Local App Builder no painel Data Servers
  • Clique no botão Details no painel Data Sources
  • Clique no botão Import, e Import novamente nas Capacidades de Importação para importar todas as tabelas que você marcou como públicas OU digite o nome da tabela/nome do objeto de negócio no Import Pattern para importar apenas um subconjunto das Tabelas/Objetos de Negócio públicos
  • Clique em Proceed e um trabalho em segundo plano será executado para realizar a tarefa

5. Adicione seu conector Local App Builder como uma fonte de dados ao seu aplicativo

  • Navegue até o App Workbench para o aplicativo que você deseja modificar
  • Clique no bloco Data Sources
  • Clique em + Source
  • Selecione Link to existing source
  • Clique em Next
  • Localize a Fonte de Dados nomeada criada na etapa 2 e clique em Link Source
  • Revise a atualização proposta e clique em Done
  • Navegue até o App Workbench para o aplicativo que você deseja modificar
  • Clique no botão Fontes de Dados
  • Clique para selecionar o banco de dados relacional que você deseja vincular
  • Clique no botão Vincular Fontes para a fonte de dados selecionada
  • Clique em Criar e selecione a fonte de dados do Conector do App Builder Local que você adicionou ao seu aplicativo na Etapa 6
  • Clique no checkmark para salvar o registro

Nota

Isso permitirá que você use tabelas e objetos de negócios da fonte de dados do App Builder local em regras de negócios e regras XP CRUD que são construídas no banco de dados relacional.

Isso também permitirá que você crie regras XP CRUD com a fonte de dados do banco de dados relacional e a fonte de dados do seu conector do App Builder local. Essas regras XP CRUD precisarão ser construídas no banco de dados relacional.

  • Navegue até o App Workbench para o aplicativo que você deseja modificar
  • Clique no botão Fontes de Dados
  • Clique para selecionar o conector do App Builder local que você deseja vincular
  • Clique no botão Vincular Fontes para a fonte de dados selecionada
  • Clique em Criar e selecione a fonte de dados relacional que você deseja conectar
  • Clique no checkmark para salvar o registro

Nota

Isso permitirá que você use tabelas e objetos de negócios do banco de dados relacional em regras de negócios e regras XP CRUD que são construídas no conector do App Builder local.

Isso também permitirá que você crie regras XP CRUD com a fonte de dados da fonte de dados do vinil local e a fonte de dados do seu banco de dados relacional. Essas regras XP CRUD precisarão ser construídas no banco de dados relacional.

Conector remoto

O Conector do App Builder Remoto pode ser usado para estabelecer uma conexão de um ambiente do App Builder para outro via HTTP.

1. Crie o objeto para compartilhar usando o conector do App Builder

  • Navegue até o App Workbench do aplicativo que deseja compartilhar
  • Clique em + Regra
  • Atribua um Nome para a regra. Por exemplo: Cliente (Remoto)
  • Defina o Propósito. Por exemplo: Objeto de Negócio
  • Confirme o Alvo. Por exemplo: Cliente
  • Clique em Criar
  • Na aba Tabelas, clique para selecionar as colunas que deseja exibir
  • Vá para Mais > Caso Excepcional
  • Em Permitir Acesso Público, marque para habilitar Leitura e/ou Gravação conforme apropriado
  • Clique em Prosseguir

2. Habilite conexões remotas do App Builder

  • Navegue até o IDE
  • Clique no botão Configurações Adicionais
  • Clique no botão Conexões Remotas do App Builder
  • Marque a coluna Permitir para o aplicativo que deseja permitir conexões remotas do App Builder
  • Clique em Prosseguir

3. Confirme que um provedor de segurança de chave de API está configurado

  • Navegue até o IDE
  • Clique no botão Provedores de Segurança
  • Confirme que há um provedor de segurança Chave de API habilitado configurado. Se não houver, um precisa ser configurado.
  • Veja Provedor de segurança - chave de API para mais informações

4. Crie um papel para compartilhar o objeto

  • Navegue até o App Workbench para o aplicativo
  • Clique no bloco Papéis
  • Clique em + Papel
  • Atribua um Nome. Por exemplo: Conector Remoto
  • Clique em Salvar
  • Clique no botão + Permissão
  • Selecione o objeto criado na etapa 1
  • Clique no checkmark para salvar

Nota

Para mais informações sobre Papéis, veja Privilégios e permissões.

5. Crie um grupo e um usuário

  • Navegue até o IDE
  • Clique no botão Gerenciamento de Usuários
  • Selecione a aba de navegação Grupos
  • Clique em + Grupo
  • Atribua um Nome. Por exemplo: Conector Remoto
  • Clique em Gerenciar Privilégios > Criar
  • Selecione Aplicativo como o Tipo
  • Selecione o Aplicativo apropriado no menu. Por exemplo: Importações Globais
  • Clique em Salvar
  • Clique em Criar
  • Selecione Aplicativo como o Tipo
  • Selecione o Aplicativo apropriado no menu. Por exemplo: App Builder
  • Clique no botão Conceder que aparece para o aplicativo selecionado na etapa anterior
  • Clique no botão Conceder para o Conector Remoto do App Builder
  • Clique na aba de navegação Usuários e clique em + Usuário
  • Atribua um Nome de Usuário. Por exemplo: ConectorRemoto
  • Clique em Salvar
  • Clique no botão Mais e selecione Chaves
  • Clique no botão Criar
  • Selecione a Chave de API como o Provedor e clique em Salvar
  • Copie o valor da Chave gerada para a área de transferência.
  • Clique em + Associação
  • Selecione o Grupo criado (Conector Remoto) e clique no checkmark para salvar

Cuidado

O valor da Chave gerada não pode ser recuperado após sair da tela Gerar Chave. Se o valor for perdido, será necessário gerar um novo valor de Chave.

6. Configuração a partir do ambiente remoto

  • Navegue até o ambiente remoto ao qual você deseja se conectar
  • Vá para o App Workbench do aplicativo ao qual você deseja se conectar
  • Clique no bloco Fontes de Dados
  • Clique em + Fonte
  • Selecione Nova Conexão e clique em Próximo
  • Selecione Outro como a Categoria de Conexão
  • Localize e selecione App Builder e clique em Próximo
  • Atribua um Nome do Servidor. Por exemplo: Remoto
  • Confirme que o Tipo de App Builder está definido como Remoto
  • Cole o valor da Chave da API copiado na etapa 5
  • Insira o valor da Url para o outro ambiente ao qual você está se conectando. Por exemplo: https://example.com
  • Clique em Próximo, Próximo
  • Clique em Importar Esquema para as tabelas, visualizações e procedimentos armazenados aos quais você deseja se conectar
  • Clique em Próximo e revise as atualizações propostas, em seguida clique em Concluído
  • Selecione Fonte de Dados do Conector de App Builder Remoto, em seguida clique em Lógica
  • Clique no ícone Resultados para uma entrada que aparece para confirmar que você vê dados
  • Teste fazendo uma edição em um registro de dados, salve e navegue de volta para o outro ambiente e confirme que agora você vê a atualização

Limitações e observações

  • O Conector de App Builder não suporta Reach
  • O Conector de App Builder suporta Auditoria, mas a Auditoria deve estar habilitada na tabela subjacente para funcionar
  • Para o Conector de App Builder Local, ambos os bancos de dados devem ser bancos de dados relacionais e existir no mesmo ambiente de servidor.
  • Para o Conector de App Builder Local, se você adicionar/modificar colunas em tabelas públicas ou objetos de negócios, precisará manter manualmente as tabelas/objetos de negócios sincronizados.

Nota

A melhor prática é criar novos Objetos de Negócios que serão usados apenas para o Conector de App Builder. Uma vez que você importe o objeto, você deve apenas alterar o objeto público se necessário. Se você fizer alterações, certifique-se de fazer a mesma alteração no Conector de App Builder Local.

Solução de Problemas

Erro 403 proibido

Se você receber uma mensagem de erro 403 Proibido com o Conector do App Builder, verifique se você concedeu ao seu usuário o papel de "Conector Remoto do App Builder". Consulte a seção Criar um Grupo e Usuário deste artigo para obter informações sobre como configurar.

Detalhes completos do erro:

Response status code does not indicate success
at void Vinyl.Business.Application.Events.RemoteEventRunner.AssertSuccessStatusCode(HttpResponseMessage response, string uri, EventTableRef eventTableRef)
at async Task<EventTableRef> Vinyl.Business.Application.Events.RemoteEventRunner.Invoke(EventTableRef eventTableRef, VinylConnectorEndpoint connectorEndpoint)
at async Task<EventTableRef> Vinyl.Business.Application.Events.RemoteEventRunner.InvokeCountAsync(EventTableRef eventTableRef)
at async Task<EventTableRef> Vinyl.DataSource.VinylConnector.VinylConnectorDataSourceServerHandler.CountPublicDataSourcesAsync(EventContext eventContext)
at async Task Vinyl.DataSource.VinylConnector.VinylConnectorDataSourceServerHandler.PingAsync(EventContext eventContext, CancellationToken cancellationToken)
at async Task Vinyl.DataSource.Plugins.DataSourceManagement.PingDataSourceServer.InvokeAsync(ValidationRule validationRule, EventInputRow input)

Reason
Forbidden
Status
403
Uri
https://{{App BuilderRootURI}}/connector/v1/count
Remote DataSourceId
19b4051a-b959-4b0c-9bd4-98b7cf2be132
Remote Table Name
DataSource_Public
Remote Event Name
null
Source
Vinyl.Business