Como criar um equipamento usando Fracttal Hub?

A integração com Fracttal Hub facilita a incorporação controlada de novos equipamentos na plataforma, garantindo que os dados sigam uma estrutura padronizada. Este guia explica como configurar um fluxo seguro para criar equipamentos no Fracttal One utilizando uma folha de cálculo como origem de dados.

A conexão será estabelecida utilizando uma Conta de Serviço (Service Account) da Google Cloud Platform, que é o método recomendado para integrações de servidor a servidor, garantindo segurança e autonomia.

Etapa 1: Configuração na Google Cloud Platform (GCP)

O primeiro passo é criar as credenciais necessárias na plataforma do Google para permitir que o Fracttal One aceda à sua folha de forma segura.

1.1. Aceda à conta de serviço

• Aceda à Consola da Google Cloud Platform.

• No menu de navegação, vá a APIs e serviços > Credenciais.

• Clique em + CRIAR CREDENCIAIS e selecione a opção Conta de serviço.

• Preencha os seguintes campos:
  • Nome da conta de serviço: Atribua um nome descritivo.
  • ID da conta de serviço: Geralmente é gerado automaticamente a partir do nome.

• Clique em "Concluído" para finalizar a criação da credencial.

1.2. Gerar a Chave de Acesso (JSON)

• Na tela de Credenciais, localize a conta de serviço recém-criada e clique no seu endereço de e-mail.
• Vá para a aba CHAVES.
• Clique em ADICIONAR CHAVE e selecione Criar nova chave.

• Escolha o tipo JSON (recomendado) e clique em CRIAR.

• Um arquivo .json será baixado automaticamente para o seu computador. Guarde-o em um local seguro, pois contém as credenciais de acesso e será necessário na Etapa 3.

Etapa 2: Preparação da folha do Google Sheets

Agora prepararemos a folha que servirá como fonte de dados.

• Abra a sua folha do Google Sheets.

Estrutura dos cabeçalhos:
Na primeira linha, certifique-se de que os nomes das colunas coincidam exatamente com os parâmetros requeridos pela API do Fracttal para a criação de ativos. Os campos obrigatórios são:

• code: Código único do ativo.
• id_type_item: ID numérico do tipo de ativo (por exemplo: 2 para Equipamentos, de acordo com a documentação da API).
• field_1: Corresponde ao Nome do ativo.

Partilhar a folha:
É crucial conceder permissão de acesso à Conta de Serviço que criamos.

• Na GCP, copie o e-mail da sua conta de serviço.

• Volte à folha de cálculo, clique em Partilhar.
• Cole o e-mail no campo de partilha.
• Atribua a permissão de Editor.

• Clique em Enviar/Partilhar.

  

Etapa 3: Configuração da conexão no Fracttal One

Com as credenciais e a folha prontas, configuraremos a ponte de comunicação dentro do Fracttal One.

• No Fracttal One, navegue até Configuração > Catálogos Auxiliares.

• No seletor de catálogos, escolha Conexões.
• Clique no ícone + para adicionar uma nova conexão.

Configure os seguintes campos:

• Tipo: Selecione Google Sheet (Service Account).
• Descrição: Insira um nome claro para esta conexão, por exemplo, CRIAR EQUIPAS.

Complete as credenciais:

Abra o arquivo .json baixado na Etapa 1.2 e copie e cole o conteúdo de cada campo no formulário do Fracttal One:

• private_key
• client_email
• client_id
• client_x509_cert_url
• ...e os demais campos requeridos.

Clique em Guardar.

Etapa 4: Criar o fluxo no Automatizador (Fracttal Hub)

Finalmente, criaremos o fluxo de automação que lerá os dados e criará os ativos.

• Vá ao menu principal e selecione Automatizador > Fracttal Hub.

• Clique no ícone + para criar um novo fluxo.

• Atribua um nome ao fluxo.

4.1. Configurar a Fonte (Source)

• Ativador

 Para este exemplo, selecione Manual. Isto permite-lhe executar o fluxo quando desejar.

• Fonte:

• Módulo: Selecione GoogleSheet.
• Conexão: Selecione a conexão criada na Etapa 3 (CRIAR EQUIPAS).
• Ação: Selecione Ler.
• spreadsheet_id: Cole o ID da sua folha. Pode encontrá-lo na URL (o código longo entre /d/ e /edit).
• sheet: Insira 0 para ler a primeira aba (a numeração começa em 0).
• Campos: Adicione os nomes dos cabeçalhos da sua folha (code, id_type_item, field_1).

4.2. Configurar o Destino (Destination)

• Conexão:

• Módulo: Selecione Fracttal.
• Conexão: Selecione FRACTTAL HUB.
• Ação: Selecione Atualizar ou criar um ativo.

• Configuração

• Clique no ícone de engrenagem (Configuração).
• Mapeie os campos de origem (Google Sheet) com os de destino (API do Fracttal), assegurando-se de que coincidam:

• Clique para guardar o mapeamento e depois em Guardar no canto superior direito para guardar todo o fluxo.