Ir para o conteúdo

Conector do App Builder no Jitterbit App Builder

Visão geral

O App Builder Connector é um recurso projetado para conectar duas instâncias diferentes do App Builder e tratá-las como uma regra. Importe a tabela e comece a usá-la.

Como desenvolvedor, você pode usar o App Builder Connector para conectar duas instâncias diferentes em execução no mesmo ambiente (Local) ou em dois ambientes diferentes via HTTP (Remoto). As etapas para configurar os App Builder Connectors locais e remotos são fornecidas neste artigo.

Se você estiver tentando resolver um cenário de dependência do App Builder LP, recomendamos que você use Herança de Tabela ou Estender Tabela e não usar o Conector do App Builder para resolver isso. O recurso Estender Tabela permite que você selecione facilmente as 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 empacotar e enviar seu LP de aplicativo.

Um exemplo do cenário de dependência do App Builder LP:
Você tem duas fontes de dados do App Builder residindo na mesma instância ou ambiente e está procurando unir a fonte de dados A e a fonte de dados B. Se seu aplicativo estiver usando a fonte de dados A e você quiser usar uma tabela da fonte de dados B e precisar enviar uma versão do aplicativo A, que usa apenas uma tabela do aplicativo B, será necessário agrupar e enviar os aplicativos A e B. Novamente, a maneira recomendada de resolver esse tipo de cenário é usar Tabelas estendidas. Esta é uma solução muito mais simples e eficiente de usar.

Aviso

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

Conector do Local App Builder

O Local App Builder Connector 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 Servidores de Dados
  • Nome sua conexão com o servidor
    • A convenção de nomenclatura de melhor prática é nomear o servidor 'Local App Builder'
  • Selecione o Tipo App Builder na seção 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 Servidores de Dados
  • Clique no botão + Fonte no painel Fontes de Dados
  • Clique em + Criar banco de dados
  • Nomeie sua fonte de dados no campo Nome do banco de dados
    • A convenção de nomenclatura de melhor prática é nomear a Fonte de Dados da seguinte forma: [Data Source You're Connecting to] ([Application using the connector])
      • Por exemplo: se você estivesse criando um conector local para o Northwinds e o conectando a um aplicativo chamado Meu Aplicativo, o nome seria: Northwinds (Meu Aplicativo)

  • Selecione a Fonte de Dados com a qual 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 ele seja selecionado como Banco de Dados.

  • Clique em Avançar

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

Nota

Recomendamos criar uma fonte de dados diferente sempre que desejar conectar seu aplicativo a outro banco de dados relacional.

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

  • Northwinds (Minha Aplicação 1)
  • Northwinds (Minha Aplicação 2)

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

  • Navegue até o App Workbench do aplicativo que você deseja usar
  • Clique no ficha Regras da Camada de Negócios
  • Selecione a Fonte de dados do aplicativo 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ócios que você deseja usar em seu conector como Públicas
    • Para marcar uma tabela como Pública, clique no ícone Abrir Registro > clique em Mais > Caso Extremo > no grupo Acesso Público, marque para habilitar Permitir Leitura e/ou Permitir Gravação
    • Para marcar uma regra de negócios como Pública, clique duas vezes na Regra para navegar até a página Definição de Regra > clique em Mais > Caso Extremo > no conjunto de controle Permitir Acesso Público, marque para habilitar Leitura e/ou Gravação
      • Ler permitirá que você leia os dados naquela tabela/objeto
      • Escrever 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 após ele ter sido tornado público e usado em um conector. Consulte a seção de limitações abaixo para obter mais informações.

4. Importe tabelas/objetos de negócios para seu conector

  • Navegue até o IDE, clique em Servidores de Dados
  • Clique para selecionar a entrada Local App Builder no painel Servidores de Dados
  • Clique no botão Detalhes no painel Fontes de dados
  • Clique no botão Importar e Importar novamente em Recursos de importação para importar todas as tabelas marcadas como públicas OU digite o nome da tabela/objeto comercial no Padrão de importação para importar apenas um subconjunto das tabelas/objetos comerciais públicos
  • Clique em Continuar e um trabalho em segundo plano será executado para executar a tarefa

5. Adicione seu conector local do App Builder como uma fonte de dados para seu aplicativo

  • Navegue até o App Workbench do aplicativo que você deseja modificar
  • Clique no ficha Fontes de Dados
  • Clique em + Fonte
  • Selecione Link para fonte existente
  • Clique em Avançar
  • Localize a Fonte de Dados nomeada criada na etapa 2 e clique em Vincular Fonte
  • Revise a atualização proposta e clique em Concluído
  • Navegue até o App Workbench do aplicativo que você deseja modificar
  • Clique no botão Fontes de Dados
  • Clique para selecionar o banco de dados relacional ao qual deseja vincular
  • Clique no botão Vincular fontes para a fonte de dados selecionada
  • Clique em Criar e selecione a fonte de dados do Local App Builder Connector que você adicionou ao seu aplicativo na Etapa 6
  • Clique na marca de seleção para salvar o registro

Nota

Isso permitirá que você use tabelas e objetos de negócios da fonte de dados de vinil local em regras de negócios e regras XP CRUD criadas no banco de dados relacional.

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

  • Navegue até o App Workbench do aplicativo que você deseja modificar
  • Clique no botão Fontes de Dados
  • Clique para selecionar o conector do Local App Builder ao qual deseja vincular
  • Clique no botão Vincular fontes para a fonte de dados selecionada
  • Clique em Criar e selecione a fonte de dados relacional à qual deseja se conectar
  • Clique na marca de seleção 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 criadas no conector de vinil local.

Isso também permitirá que você crie regras XP CRUD com a fonte de dados de origem da fonte de dados de vinil local e a fonte de dados de destino da sua fonte de dados relacional. Essas regras XP CRUD precisarão ser criadas no banco de dados relacional.

Conector remoto

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

1. Crie o objeto a ser compartilhado usando o conector do App Builder

  • Navegue até o App Workbench a partir do aplicativo que você deseja compartilhar
  • Clique em + Regra
  • Atribua um Nome para a regra. Por exemplo: Cliente (Remoto)
  • Defina o Objetivo. 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 Extremo
  • Em Permitir acesso público, marque para habilitar Leitura e/ou Gravação conforme apropriado
  • Clique em Continuar

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 do Remote App Builder
  • Marque a coluna Permitir do aplicativo para o qual deseja permitir conexões remotas do App Builder
  • Clique em Continuar

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

  • Navegue até o IDE
  • Clique no botão Provedores de Segurança
  • Confirme se há um provedor de segurança com * Chave de API * habilitado configurado. Caso contrário, é necessário configurar um.
  • Consulte Provedor de segurança - Chave de API para mais informações

4. Crie uma papel para compartilhar o objeto

  • Navegue até o App Workbench para o aplicativo
  • Clique no ficha Funções
  • Clique em + Função
  • Atribua um Nome. Por exemplo: Conector Remoto
  • Clique em Salvar
  • Clique no botão + Permissão
  • Selecione o objeto criado no passo 1
  • Clique na marca de seleção para salvar

Nota

Para mais informações sobre Funções, consulte 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 Aplicação como Tipo
  • Selecione o Aplicativo apropriado no menu. Por exemplo: Importações Globais
  • Clique em Salvar
  • Clique em Criar
  • Selecione Aplicação como 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 App Builder Remote Connector
  • Clique na aba de navegação Usuários e clique em + Usuário
  • Atribua um Nome de Usuário. Por exemplo, RemoteConnector
  • Clique em Salvar
  • Clique no botão Mais e selecione Chaves
  • Clique no botão Criar
  • Selecione a Chave API como Provedor e clique em Salvar
  • Copie o valor Key gerado para a área de transferência.
  • Clique em + Assinatura
  • Selecione o Grupo criado (Conector Remoto) e clique na marca de seleção 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, você precisará gerar um novo valor de Chave.

6. Configuração do ambiente remoto

  • Navegue até o ambiente remoto ao qual você deseja se conectar
  • Acesse o App Workbench do aplicativo que você deseja conectar
  • Clique no ficha Fontes de Dados
  • Clique em + Fonte
  • Selecione Nova conexão e clique em Avançar
  • Selecione Outro como Categoria de Conexão
  • Localize e selecione App Builder e clique em Avançar
  • Atribua um Nome de Servidor. Por exemplo: Remoto
  • Confirme se Tipo de App Builder está definido como Remoto
  • Cole o valor da Chave de API copiado na etapa 5
  • Insira o valor Url do outro ambiente ao qual você está se conectando. Por exemplo: https://example.com
  • Clique em Avançar, Avançar
  • Clique em Importar Esquema para as tabelas, visualizações e procedimentos armazenados que você deseja conectar
  • Clique em Avançar e revise as atualizações propostas, depois clique em Concluído
  • Selecione Fonte de dados do conector do Remote App Builder * e clique em *Lógica**
  • Clique no ícone Resultados para uma entrada que aparece para confirmar que você vê os 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 chamadas

  • O App Builder Connector não oferece suporte ao Reach
  • O App Builder Connector oferece suporte à auditoria, mas a auditoria deve ser habilitada na tabela subjacente para que funcione
  • Para o Local App Builder Connector, ambos os bancos de dados devem ser bancos de dados relacionais e existir no mesmo ambiente de servidor.
  • Para o Local App Builder Connector, se você adicionar/modificar colunas em tabelas públicas ou objetos comerciais, será necessário manter manualmente as tabelas/objetos comerciais sincronizados.

Nota

A prática recomendada é criar novos Objetos de Negócios que serão usados apenas para o Conector do App Builder. Após importar o objeto, você só deve alterar o objeto público se necessário. Se você alterá-lo, certifique-se de fazer a mesma alteração no Conector do App Builder Local.

Solução de problemas

Erro 403 proibido

Se você receber a mensagem de erro 403 Proibido com o Conector do App Builder, verifique se você concedeu ao seu usuário a papel "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