Como criar medidores no Fracttal HUB?

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

A seguir, você encontrará um guia passo a passo sobre como configurar essa funcionalidade dentro da plataforma Fracttal Hub.

Passo 1: Acesse o Console do Google Cloud

Acesse o Google Cloud Console.

• Vá para a seção de API e serviços > Credenciais.

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

  

   

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

Passo 2: Gere a chave JSON

1. Uma vez criada a conta de serviço, selecione-a na lista.

   

2. Acesse a seção Chaves. Clique em Adicionar chave > Criar nova chave.

   

3. Selecione o formato JSON.

   

4. Salve o arquivo gerado em um local seguro; esse arquivo será necessário para configurar a integração no Fracttal Hub.

Passo 3: Preparar a planilha (Google Sheets)

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

1. Crie uma nova planilha no Google Sheets.
2. Dê um nome descritivo, como CRIAR MEDIDOR.
3. Na primeira linha, defina os cabeçalhos das colunas. Estes devem coincidir com os parâmetros exigidos pela API do Fractal. 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 o medidor será associado, 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 for, ou FALSE se não).
4. Preencha as linhas com as informações dos medidores que deseja criar.
5. Compartilhar a planilha: Este é um passo crucial.
   • Copie o e-mail da conta de serviço que você criou no Passo 1 (você encontrará dentro do arquivo .json no campo client_email).
   • Clique no botão Compartilhar na sua planilha.
   • Cole o e-mail da conta de serviço e atribua 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 você possa usar as credenciais da conta de serviço.

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

• Tipo: Selecione Google Sheet (Service Account).

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

4. Abra o arquivo .json baixado e copie/cole o conteúdo dos seguintes campos em seus respectivos lugares do formulário do Fracttal:

• private_key

• client_email

• client_id

• client_x509_cert_url

5. Clique no ícone ✓ para salvar e depois em Salvar.

Passo 5: Configurar o fluxo no Fracttal Hub

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

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

Configuração do gatilho:

• Clique em Gatilho e selecione o tipo Manual. Isso permite executar o fluxo quando desejado.

Configuração da Fonte:

• Clique em Fonte.

• Módulo: Selecione GoogleSheet.

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

• Ação: Selecione Ler.

• spreadsheet_id: Copie o ID da sua planilha (você o encontra na URL, entre /d/ e /edit/).

• sheet: Escreva 0 para ler a primeira aba.

• Campos: Adicione os nomes das colunas: 

Configuração do Destino:

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

• Módulo: Selecione Fracttal.

• Conexão: Escolha FRACTTAL HUB.

• Ação: Selecione Criar Medidores.

Configuração de campos (mapeamento):

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

• Mapeie os campos da planilha (Origem) com os do sistema (Destino), garantindo que coincidam:

description ⟵ description

item_code ⟵ item_code

unit code ⟵ unit_code

is_counter ⟵ is_counter
 

Clique em Salvar para salvar a configuração do fluxo.

Passo 7: Executar e verificar o fluxo

1. Ative o interruptor Habilitado.

2. Clique novamente em Salvar.

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

Você pode monitorar 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.