App Builder Conector¶

Visão Geral¶

App Builder o conector é um recurso projetado para conectar dois dispositivos diferentes App Builder instâncias juntas e tratá-las como uma Regra, importar a Tabela e começar a usá-la.

Como Desenvolvedor, você pode usar App Builder conector para conectar duas instâncias diferentes que estão sendo executadas no mesmo ambiente (Local) ou em dois ambientes diferentes por HTTP (Remoto). Etapas para configurar Local e Remoto App Builder conectores são fornecidos neste artigo.

Se você está tentando resolver para an App Builder cenário de dependência de LP, recomendamos que você use Herança de tabela ou extensão de tabela recurso e não usar o App Builder conector 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 empacotar e enviar seu LP de aplicativo.

Um exemplo do App Builder cenário de dependência LP:
Você tem dois App Builder fontes de dados que residem na mesma instância ou ambiente e você 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, então, precisar enviar uma versão do aplicativo A, que usa apenas 1 tabela do aplicativo B, você precisará 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.

Local App Builder conector¶

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

1. Criação de um Local App Builder conector¶

• No IDE, clique em Data Servers
• Clique em + Server no painel Data Servers
• Nomeie sua conexão de servidor
  • A convenção de nomenclatura de prática recomendada é nomear o servidor 'Local App Builder'
• Selecione o Tipo App Builder na seção Configurações do Servidor
• Selecione o App Builder digite Local
• Clique em Salvar

2. Criação de uma Fonte de Dados Usando o Local App Builder conector¶

• No IDE, clique em Data Servers
• Clique para selecionar o Local App Builder entrada do painel Servidores de Dados
• Clique no botão + Fonte do 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 prática recomendada é 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

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

4. Importe Tabelas/objetos de Negócios para Seu Conector¶

• Navegue até IDE, clique em Data Servers
• Clique para selecionar o Local App Builder entrada do painel Servidores de Dados
• Clique no botão Detalhes do painel Fontes de Dados
• Clique no botão Importar e Importar novamente em Recursos 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ócios no Padrão de Importação para importar apenas um subconjunto das Tabelas/Objetos de Negócios públicos
• Clique em Prosseguir e um trabalho em segundo plano será executado para executar a tarefa

5. Adicione Seu Local App Builder conector 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

6. Vincule Seu Local App Builder conector de Fonte de Dados para um Banco de Dados Relacional¶

• Navegue até o App Workbench para o aplicativo que você deseja modificar
• Clique no botão Data Sources
• Clique para selecionar o banco de dados relacional ao qual você deseja vincular
• Clique no botão Link Sources para a fonte de dados selecionada
• Clique em Create e selecione o Local App Builder fonte de dados do conector que você adicionou ao seu aplicativo na Etapa 6
• Clique na marca de seleção para salvar o registro

7. Vincule Seu Banco de Dados Relacional ao Seu Local App Builder conector¶

• Navegue até o App Workbench para o aplicativo que você deseja modificar
• Clique no botão Data Sources
• Clique para selecionar o Local App Builder conector ao qual 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 à qual você deseja se conectar
• Clique na marca de seleção para salvar o registro

Conector Remoto¶

O controle remoto App Builder o conector pode ser usado para estabelecer uma conexão de um App Builder ambiente para outro via HTTP.

1. Crie o Objeto para Compartilhar Usando App Builder conector¶

• 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. Habilitar Controle Remoto App Builder conexões¶

• Navegue até o IDE
• Clique no botão Configurações adicionais
• Clique no botão Remoto App Builder botão Conexões
• Marque a coluna Permitir para o aplicativo que você deseja permitir acesso remoto App Builder conexões
• Clique em Prosseguir

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 Enabled * API Key* 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

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 conector remoto
• 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

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 Next
• Atribua um Server Name. Por exemplo: Remote
• Confirme App Builder o tipo 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 Remoto App Builder fonte de dados do conector 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¶

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

Solução de Problemas¶

Erro 403 Proibido¶

Se você receber uma mensagem de erro 403 Proibido com o App Builder conector, verifique se você concedeu ao seu usuário o "App Builder papel"Conector Remoto". 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 {{nm.ab_path}}.Business.Application.Events.RemoteEventRunner.AssertSuccessStatusCode(HttpResponseMessage response, string uri, EventTableRef eventTableRef)
at async Task<EventTableRef> {{nm.ab_path}}.Business.Application.Events.RemoteEventRunner.Invoke(EventTableRef eventTableRef, {{nm.ab_path}} connectorEndpoint connectorEndpoint)
at async Task<EventTableRef> {{nm.ab_path}}.Business.Application.Events.RemoteEventRunner.InvokeCountAsync(EventTableRef eventTableRef)
at async Task<EventTableRef> {{nm.ab_path}}.DataSource.{{nm.ab_path}} connector.{{nm.ab_path}} connectorDataSourceServerHandler.CountPublicDataSourcesAsync(EventContext eventContext)
at async Task {{nm.ab_path}}.DataSource.{{nm.ab_path}} connector.{{nm.ab_path}} connectorDataSourceServerHandler.PingAsync(EventContext eventContext, CancellationToken cancellationToken)
at async Task {{nm.ab_path}}.DataSource.Plugins.DataSourceManagement.PingDataSourceServer.InvokeAsync(ValidationRule validationRule, EventInputRow input)

Reason
Forbidden
Status
403
Uri
https://`você{{{{nm.ab}} raizURI}}/connector/v1/count
Remote DataSourceId
19b4051a-b959-4b0c-9bd4-98b7cf2be132
Remote Table Name
DataSource_Public
Remote Event Name
null
Source
{{nm.ab_path}}.Business