Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Esta documentação é para a versão 4 e posterior do App Builder, o novo nome do Vinyl. Acesse a documentação do Vinyl aqui.

✕

Conector do App Builder no Jitterbit App Builder

Visão geral

App Builder Connector é 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 App Builder Connector para conectar duas instâncias diferentes que estão sendo executadas no mesmo ambiente (Local) ou em dois ambientes diferentes por 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 extensão de tabela e não usar o App Builder Connector para resolver isso. O recurso Extend Table permite que você selecione facilmente as tabelas que deseja usar de outras Data Sources 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 do App Builder LP:
Você tem duas fontes de dados do App Builder residindo na mesma instância ou ambiente e está procurando unir entre 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 1 tabela do aplicativo B, será necessário agrupar e enviar 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 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 Northwinds e conectando-o a um aplicativo chamado Meu Aplicativo, o nome seria: Northwinds (Meu Aplicativo)

  • Selecione a Fonte de Dados para 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 o 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 para o 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
      • Write permitirá que você modifique a data naquela tabela/objeto

Nota

Recomendamos fortemente que você não modifique a tabela pública/objeto de negócios depois que ele for 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/nome do objeto de negócios no Padrão de importação para importar apenas um subconjunto das tabelas/objetos de negócios 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 para o 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 para o 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 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 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 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 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 que são construídas 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 construídas 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 para compartilhar usando o conector App Builder

  • Navegue até o App Workbench do aplicativo que você 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 Target. 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 que você 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 * API Key* habilitado configurado. Se não, um precisa ser configurado.
  • Veja 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 na etapa 1
  • Clique na marca de seleção para salvar

Nota

Para mais informações sobre Funções, 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 Tipo
  • Selecione o Aplicativo apropriado no menu. Por exemplo: Importações Globais
  • Clique em Salvar
  • Clique em Criar
  • Selecione Aplicativo 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 da Chave gerado para a área de transferência.
  • Clique em + Associação
  • 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
  • Vá para 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 a Categoria de conexão
  • Localize e selecione App Builder e clique em Avançar
  • Atribua um Nome de Servidor. Por exemplo: Remoto
  • Confirme que Tipo de App Builder está definido como Remoto
  • Cole o valor da Chave de API copiado na etapa 5
  • Insira o valor Url para o 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 fazer 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 estar 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 melhor prática é criar novos Business Objects que serão usados somente para o App Builder Connector. Depois de 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 Local App Builder Connector.

Solução de problemas

Erro 403 proibido

Se você receber uma mensagem de erro 403 Forbidden com o App Builder Connector, verifique se você concedeu ao seu usuário a papel " App Builder Remote Connector". Veja 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