Conectores de Vinyl¶

Visão Geral¶

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

Como desenvolvedor, você pode usar o Vinyl 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 conectores de Vinyl locais e remotos são fornecidas neste artigo.

Se você está tentando resolver um cenário de dependência de Vinyl LP, recomendamos que você use o Table Inheritance or Extend Table recurso e não usar o conector de Vinyl para resolver isso. O recurso Estender tabela permite que você escolha facilmente as tabelas que deseja usar de outras fontes de dados residentes 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 aplicativo LP.

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

Conector de Vinyl Local¶

O Local Vinyl 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 de Vinyl Local¶

• No IDE, clique em Servidores de dados
• Clique em + Servidor no painel Servidores de dados
• Nome a conexão do seu servidor
  • A convenção de nomenclatura recomendada é nomear o servidor como 'Vinyl local'
• Selecione o tipo Vinyl na seção Configurações do servidor
• Selecione o tipo de Vinyl Local
• Clique em Salvar

2. Criando uma Fonte de Dados Usando o Local Vinyl Connector¶

• No IDE, clique em Servidores de dados
• Clique para selecionar a entrada Local Vinyl no painel Data Servers
• 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 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 à 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ária na fonte de dados para que ela seja selecionada como 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 do aplicativo que você deseja usar
• Clique no ficha Regras da camada de negócios
• Selecione Fonte de dados do aplicativo para refletir a fonte de dados que contém 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 ativar 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 ativar Ler e/ou Escrever
    • 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 o Seu Conector¶

• Navegue até IDE, clique em Servidores de dados
• Clique para selecionar a entrada Local Vinyl no painel Data Servers
• 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 em Padrão de importação para importar apenas um subconjunto das tabelas públicas/objetos de negócios
• Clique em Continuar e um trabalho em segundo plano será executado para executar a tarefa

5. Adicione Seu Conector de Vinyl Local Como Fonte de Dados ao 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 Fonte do link
• Revise a atualização proposta e clique em Concluído

6. Vincule Sua Fonte de Dados Local do Vinyl Connector a um 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 banco de dados relacional ao qual deseja vincular
• Clique no botão Link Sources para a fonte de dados selecionada
• Clique em Criar e selecione a fonte de dados do Local Vinyl Connector 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 Conector de Vinyl Local¶

• Navegue até o App Workbench do aplicativo que você deseja modificar
• Clique no botão Fontes de dados
• Clique para selecionar o conector de Vinyl local ao qual deseja vincular
• Clique no botão Link Sources 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 de Vinyl Remoto¶

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

1. Crie o Objeto para Compartilhar Usando o Vinyl Connector¶

• Navegue até App Workbench do aplicativo do qual 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ócios
• Confirme o Alvo. Por exemplo: Cliente
• Clique em Criar
• Na aba Tabelas, clique para selecionar as colunas que deseja exibir
• Vá para Mais > Caso Edge
• Em Permitir acesso público, marque para ativar Ler e/ou Escrever conforme apropriado
• Clique em Continuar

2. Habilite Conexões Remotas de Vinyl¶

• Navegue até o IDE
• Clique no botão Configurações adicionais
• Clique no botão Conexões remotas de Vinyl
• Marque a coluna Permitir do aplicativo que você deseja permitir conexões remotas de Vinyl
• 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 * Chave de API * ativado configurado. Caso contrário, é necessário configurá-lo.
• Consulte Provedor de segurança - Chave de API Para maiores informações

4. Crie uma Função para Compartilhar o Objeto¶

• Navegue até o App Workbench do 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

5. Crie um Grupo e 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: Vinyl
• Clique no botão Conceder que aparece para a inscrição selecionada na etapa anterior
• Clique no botão Conceder para o conector remoto de Vinyl
• 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 de 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

6. Configuração a Partir do Ambiente Remoto¶

• Navegue até o ambiente remoto ao qual 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 Categoria de conexão
• Localize e selecione Vinyl e clique em Avançar
• Atribua um Nome de servidor. Por exemplo: Remoto
• Confirme se Tipo de Vinyl está definido como Remoto
• Cole o valor Api Key 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 analise as atualizações propostas e clique em Concluído
• Selecione Fonte de dados do conector de Vinyl remoto e clique em Logic
• Clique no ícone Resultados para ver 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 se agora você vê a atualização

Limitações e Frases de Destaque¶

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

Solução de Problemas¶

403 Erro Proibido¶

Se você receber uma mensagem de erro 403 Forbidden com o Vinyl Connector, verifique se você concedeu ao usuário a papel"Vinyl Remote Connector". Consulte a seção Criar um grupo e um 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://{{VinylRootURI}}/connector/v1/count
Remote DataSourceId
19b4051a-b959-4b0c-9bd4-98b7cf2be132
Remote Table Name
DataSource_Public
Remote Event Name
null
Source
Vinyl.Business