Como criar medidores no Fracttal HUB?

Com a opção de automação no Fracttal Hub, é possível gerir a criação de medidores de forma eficiente e sem intervenção manual, especialmente em contextos de alto volume de dados. Esta funcionalidade permite aos utilizadores agilizar processos operacionais e minimizar erros humanos no manuseio de leituras de medidores.

A seguir, encontrarás um guia passo a passo sobre como configurar esta funcionalidade dentro da plataforma Fracttal Hub.

Passo 1: Acede à Consola do Google Cloud

Acede à Google Cloud Console.

• Dirige-te à seção de API e serviços > Credenciais.

• Clica em Criar credenciais > Conta de serviço.

  

   

• Nomeia a conta de serviço como "criar_medidores" e segue o processo até finalizar.

Passo 2: Gera a chave JSON

1. Uma vez criada a conta de serviço, seleciona-a a partir da lista.

   

2. Acede à seção Chaves. Clica em Adicionar chave > Criar nova chave.

   

3. Seleciona o formato JSON.

   

4. Guarda o arquivo gerado numa localização segura; este arquivo será necessário para configurar a integração no Fracttal Hub.

Passo 3: Preparar a folha de cálculo (Google Sheets)

Agora, prepararemos a folha de cálculo que servirá como fonte de dados para a criação dos medidores.

1. Crie uma nova folha de cálculo no Google Sheets.
2. Atribua-lhe um nome descritivo, como CRIAR MEDIDOR.
3. Na primeira linha, defina os cabeçalhos das colunas. Estes devem coincidir com os parâmetros que a API do Fractal requer. Para este exemplo, utilizaremos os seguintes campos obrigatórios e um opcional:
   • Coluna A: description (Descrição do medidor, ex: "Medidor de KM").
   • Coluna B: item_code (Código do ativo ao qual se associará o medidor, ex: "HUB-004").
   • Coluna C: unit_code (Código da unidade do medidor, ex: "KM". Este código deve existir previamente em Configuração > Catálogos Auxiliares > Unidade).
   • Coluna D: is_counter (Opcional, mas recomendado. Indica se o medidor é um acumulador. Escreva TRUE se o for, ou FALSE se não).
4. Preencha as linhas com a informação dos medidores que deseja criar.
5. Partilhar a folha de cálculo: Este é um passo crucial.
   • Copie o e-mail da conta de serviço que criou no Passo 1 (encontrará dentro do arquivo .json no campo client_email).
   • Clique no botão Partilhar na sua folha de cálculo.
   • Cole o e-mail da conta de serviço e atribua-lhe permissões de Editor.

• Clique em Enviar.

Passo 4: Criar a conexão no Fracttal One

Agora vamos configurar a conexão dentro do Fracttal para que possa usar as credenciais da conta de serviço.

1. No Fracttal, navega até Configuração > Catálogos Auxiliares > Conexões.
2. Clica no ícone + para adicionar uma nova conexão.
3. Preenche os seguintes campos:

• Tipo: Seleciona Google Sheet (Conta de Serviço).

• Descrição: Atribui um nome à conexão:

4. Abre o arquivo .json descarregado e copia/cola o conteúdo dos seguintes campos nos respetivos lugares do formulário do Fracttal:

• private_key

• client_email

• client_id

• client_x509_cert_url

5. Clica no ícone ✓ para guardar e depois em Guardar.

Passo 5: Configurar o fluxo no Fracttal Hub

Com a conexão pronta, o último passo é criar o fluxo de automação.

1. Navega até o módulo Fracttal Hub.
2. Clica no ícone + para criar um novo fluxo.
3. Adiciona uma Descrição para o fluxo:

Configuração do ativador:

• Clica em Ativador e seleciona o tipo Manual. Isto permite executar o fluxo quando desejado.

Configuração da Fonte:

• Clica em Fonte.

• Módulo: Seleciona GoogleSheet.

• Conexão: Seleciona a conexão criada no passo anterior.

• Ação: Seleciona Ler.

• spreadsheet_id: Copia o ID da tua folha de cálculo (encontras na URL, entre /d/ e /edit/).

• sheet: Escreve 0 para ler a primeira aba.

• Campos: Adiciona os nomes das colunas: 

Configuração do Destino:

• Clica em Conexão na seção de destino.

• Módulo: Seleciona Fracttal.

• Conexão: Escolhe FRACTTAL HUB.

• Ação: Seleciona Criar Medidores.

Configuração de campos (mapeamento):

• Clica em Configuração na seção de destino.

• Mapeia os campos da folha (Origem) com os do sistema (Destino), assegurando-te de que coincidam:

description ⟵ description

item_code ⟵ item_code

unit code ⟵ unit_code

is_counter ⟵ is_counter
 

Clica em Guardar para guardar a configuração do fluxo.

Passo 7: Executar e verificar o fluxo

1. Ativa o interruptor Habilitado.

2. Clica novamente em Guardar.

3. Clica no botão Executar para iniciar o processo.

Podes monitorizar o progresso nas abas Fila de eventos e Histórico de Execução. Um processo bem-sucedido mostrará "Processo Realizado" e marcará como completas as etapas de Extração, Transformação e Carga.