Datagate HUE (Pré-visualização)

O Datagate é uma plataforma de gerenciamento de dados de Software como Serviço do Works Applications que fornece aos usuários um método simplificado para armazenar, gerenciar e gerar insights a partir de seus dados de negócios. Esse conector permite que você aproveite seus dados de negócios no Datagate a partir da Power Platform.

Este conector está disponível nos seguintes produtos e regiões:

O Datagate é uma plataforma de gerenciamento de dados de Software como Serviço do Works Applications que fornece aos usuários um método simplificado para armazenar, gerenciar e gerar insights a partir de seus dados de negócios. Ele pode servir como uma plataforma centralizada para armazenar dados e gerenciar

Esse conector fornece uma API para você acessar seus dados corporativos no Datagate a partir da Power Platform.

Pré-requisitos

Para usar esse conector, você precisaria dos seguintes itens:

• uma chave de API Datagate com acesso à API OData.
• as credenciais de uma função Datagate (ID da função, segredo da função) com acesso à tabela desejada.
• Conta de usuário do Datagate, para acessar o construtor de consultas no Datagate.

Como obter credenciais

Existem duas camadas de autenticação e autorização para acessar uma tabela no Datagate, ou seja, a Chave de API do Datagate e a função Datagate. Abaixo estão as etapas simplificadas para obter a chave de API Datagate e as credenciais de função Datagate. Para obter mais informações, consulte o manual Datagate em , ou entre em @SUPPORTcontato com nossos consultores.

Para obter a chave de API Datagate:

1. Faça login na tela Datagate.
2. Vá para a página de gerenciamento de chaves da API. O botão Chave da API estaria disponível na barra de navegação esquerda da página. Clique no ícone de chave e selecione "Gerenciamento de chaves de API" para navegar até a página de gerenciamento de chaves de API.
3. Clique no botão criar chave de API no canto superior direito da página.
4. A página Editar API será mostrada com campos vazios.
5. Na seção Informações da chave da API, preencha a descrição desejada.
6. Selecione as permissões desejadas para fornecer a chave de API.
7. Clique no botão 'Salvar chave de API' no canto superior direito da página para criar a chave de API desejada.

Para obter credenciais de função Datagate:

1. Faça login na tela Datagate.
2. Dirija-se à página Gestão de Funções. O link Gerenciamento de Funções estaria disponível na barra de navegação esquerda da página. Clique no ícone da tabela e selecione "Gerenciamento de funções" para navegar até a página Gerenciamento de funções.
3. Clique no botão criar função no canto superior direito da página.
4. A página Criar função será exibida.
5. Na seção de informações da função, preencha o nome da função desejada e selecione o tipo de permissão.
6. Selecione as permissões desejadas para atribuir a função na lista de esquema ou tabela.
7. Clique no botão 'Salvar função' no canto superior direito da página para criar uma nova função e obter as credenciais de função desejadas.

Introdução ao conector

Atualmente, há uma API disponível para uso, a API OData, que permitiria acesso de leitura aos dados da tabela no Datagate. Através da consulta Datagate OData, você pode definir as colunas a serem selecionadas, ordem de classificação, Os parâmetros necessários são a cadeia de caracteres de consulta e credenciais de função de uma função que tem acesso à tabela. Consulte a seção anterior "Como obter credenciais" para obter as etapas para adquirir a chave de API e as credenciais de função necessárias. Para obter uma cadeia de caracteres de consulta, consulte as etapas a seguir.

1. Na tela Datagate, procure a tabela desejada na Página de Lista de Tabelas.
2. Abra a página do Visualizador de dados da tabela desejada.
3. Defina os parâmetros desejados e copie a cadeia de caracteres de consulta resultante.

Enviar Relatório Diário por E-mail

Usando o conector do Datagate, crie um fluxo de energia que envia automaticamente um relatório de vendas diariamente

1. Prepare a chave da API a ser usada. (Consulte a seção anterior "Como obter credenciais")
2. Preparar função (ID da função e segredo da função). (Consulte a seção anterior "Como obter credenciais")
3. Obtenha a consulta para a tabela de saída.
4. Crie um fluxo de nuvem agendado.
5. Defina o cronograma desejado.
6. Verifique se o agendamento definido está correto.
7. Adicione a etapa para obter a hora da data atual e converta do fuso horário UTC para o fuso horário desejado.
8. Adicionar etapa da API OData. É possível gerar cadeias de caracteres de consulta dinâmicas inserindo variáveis na cadeia de caracteres de consulta.
9. Adicionar etapa de conversão JSON. Gere o esquema usando uma carga JSON de exemplo.
10. Adicionar etapa para criar uma tabela HTML.
11. Adicione a etapa para enviar e-mails, insira o corpo do e-mail desejado e salve o conector. Você pode optar por testar o fluxo executando-o manualmente.
12. O e-mail seria enviado no seguinte formato no cronograma definido.

Problemas conhecidos e limitações

O tamanho máximo dos dados retornáveis é de 6 MB por chamada de API.

Se o tamanho do conjunto de dados solicitado for maior que 6MB, a chamada de API retornará com um erro, "413 Payload Too Large".

Erros e soluções comuns

Atualmente, há apenas uma API no conector, a API OData. A seguir estão alguns dos possíveis erros que podem ser enfrentados ao usar a API.

200 OK

"relação "public_view.table_name" não existe"

A tabela pode não existir mais. Verifique se a tabela está acessível através do visualizador de dados do Datagate.

""Falha ao analisar o filtro (XXX)" (linha X, coluna X)"

Há algum problema com a consulta fornecida. Confirme se a consulta foi copiada da tela Datagate corretamente.

413 Carga útil demasiado grande

Há um limite de 6MB para o tamanho da carga da API OData. Defina um limite inferior para a contagem de linhas definindo o parâmetro "limit" na consulta OData.

500 Erro interno do servidor

Não foi possível estabelecer a ligação ao servidor. Verifique com nossos consultores se o problema persiste.

FAQ

A seguir estão perguntas comuns de usuários do Datagate. Para questões não abordadas aqui ou para mais detalhes, consulte o manual Datagate disponível na plataforma Works Applications @SUPPORT , caso contrário entre em contato com nossos consultores.

Como faço para obter dados de tabela externa do conector?

Acesse a página do visualizador de dados da tabela externa desejada e obtenha a cadeia de caracteres de consulta relevante do construtor de consultas.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Ações

OData API