HUE Datagate (versão prévia)

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

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

O Datagate é uma plataforma de gerenciamento de dados software como serviço da Works Applications que fornece aos usuários um método simplificado para armazenar, gerenciar e gerar insights 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 de negócios no Datagate do Power Platform.

Pré-requisitos

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

• uma chave de API do Datagate com acesso à API OData.
• 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

Há 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 as credenciais de função chave de API do Datagate e datagate. Para obter mais informações, consulte o manual @SUPPORTdo Datagate ou entre em contato com nossos consultores.

Para obter a Chave de API do Datagate:

1. Faça logon na tela do Datagate.
2. Vá para a página gerenciamento de chaves da API. O botão Chave de 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 da API.
3. Clique no botão criar chave de API no lado superior direito da página.
4. A Página Editar API será mostrada com campos vazios.
5. Na seção Informações da Chave de 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" na parte superior direita da página para criar a Chave de API desejada.

Para obter credenciais de função do Datagate:

1. Faça logon na tela do Datagate.
2. Vá para a Página de Gerenciamento de Funções. O link gerenciamento de funções estaria disponível na barra de navegação à esquerda da página. Clique no ícone de tabela e selecione "Gerenciamento de Função" para navegar até a Página de Gerenciamento de Funções.
3. Clique no botão criar função no lado superior direito da página.
4. A Página Criar Função será mostrada.
5. Na seção de informações de função, preencha o nome da função desejada e selecione o tipo de permissão.
6. Selecione as permissões desejadas para fornecer a função na lista de esquemas ou tabelas.
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 o acesso de leitura aos dados da tabela no Datagate. Por meio da consulta Datagate OData, você pode definir as colunas a serem selecionadas, a ordem de classificação, os parâmetros necessários são a cadeia de caracteres de consulta e as 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 as credenciais de função e chave de API necessárias. Para obter uma cadeia de caracteres de consulta, consulte as etapas a seguir.

1. Na tela do Datagate, pesquise a tabela desejada na página Lista de Tabelas.
2. Abra a página 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 Email

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

1. Prepare a chave de 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 da tabela de saída.
4. Crie um fluxo de nuvem agendado.
5. Defina a agenda desejada.
6. Verifique se o conjunto de agendamentos está correto.
7. Adicione a etapa para obter a hora de data atual e converta do fuso horário UTC para o fuso horário desejado.
8. Adicionar a etapa da API do OData. É possível gerar cadeias de caracteres de consulta dinâmicas inserindo variáveis na cadeia de caracteres de consulta.
9. Adicionar a etapa de conversão JSON. Gere o esquema usando um conteúdo JSON de exemplo.
10. Adicione uma etapa para criar uma tabela HTML.
11. Adicione a etapa para enviar emails e insira o corpo do email desejado e salve o conector. Você pode optar por testar o fluxo executando-o manualmente.
12. O email seria enviado no formato a seguir na agenda definida.

Problemas e limitações conhecidos

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

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

Erros e soluções comuns

Atualmente, há apenas uma API no conector, a API OData. Veja a seguir 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 por meio do visualizador de dados do Datagate.

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

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

Carga 413 muito grande

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

500 Erro interno do servidor

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

perguntas frequentes

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

Como 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.

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

Ações

OData API