Como criar um equipamento usando o Fracttal Hub?

A integração com o Fracttal Hub facilita a incorporação controlada de novos equipamentos à 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 planilha como origem de dados.

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

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

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

1.1. Acesse a conta de serviço

Acesse o Console do Google Cloud Platform.

$console.cloud.google.com_welcome_inv=1&invt=Ab1nGA&project=fracttal-one-helpcenter.png$

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

01-console.cl01-oud.google.com_welcome_inv=1&invt=Ab1nGA&project=fracttal-one-helpcenter.PNG

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

02- console.cloud.google.com_apis_credentials_inv=1&invt=Ab1m_Q&project=fracttal-one-helpcenter&supportedpurview=project (1).PNG

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.

console.cloud.google.com_iam-admin_serviceaccounts_create_inv=1&invt=Ab1m_Q&project=fracttal-one-helpcenter&supportedpurview=project.png

Clique em "Pronto" para finalizar a criação da credencial.

Uma vez criada, será necessário habilitá-la para que possa ser utilizada nos processos de integração.

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.

05 - console.cloud.google.com_iam-admin_serviceaccounts_details_103039734183100900089;edit=true_keys_inv=1&invt=Ab1m_Q&project=fracttal-one-helpcenter&supportedpurview=project.PNG

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

06 - console.cloud.google.com_iam-admin_serviceaccounts_details_103039734183100900089;edit=true_keys_inv=1&invt=Ab1m_Q&project=fracttal-one-helpcenter&supportedpurview=project (1).PNG

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 planilha do Google Sheets

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

Abra sua planilha do Google Sheets.

Estrutura dos cabeçalhos:
Na primeira linha, certifique-se de que os nomes das colunas coincidam exatamente com os parâmetros exigidos 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, conforme a documentação da API).
field_1: Corresponde ao Nome do ativo.

code	id_type_item	field_1
HUB-001	2	CAMIONETA SUV

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

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

07 - console.cloud.google.com_iam-admin_serviceaccounts_details_103039734183100900089;edit=true_inv=1&invt=Ab1m_Q&project=fracttal-one-helpcenter&supportedpurview=project (2).PNG

Volte para a planilha, clique em Compartilhar.
Cole o e-mail no campo de compartilhamento.
Atribua a permissão de Editor.
Clique em Enviar/Compartilhar.

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

Com as credenciais e a planilha 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 EQUIPAMENTOS.

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

Clique em Salvar.

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.

12 - app.fracttal.com_dispatcher_hub (15).PNG

4.1. Configurar a Fonte (Source)

Ativador

14 - app.fracttal.com_dispatcher_hub (15).PNG

Para este exemplo, selecione Manual. Isso permite que você execute o fluxo quando desejar.

14 - app.fracttal.com_dispatcher_hub (17).PNG

Fonte:

15 - app.fracttal.com_dispatcher_hub (15).PNG

Módulo: Selecione GoogleSheet.
Conexão: Selecione a conexão criada na Etapa 3 (CRIAR EQUIPAMENTOS).
Ação: Selecione Ler.
spreadsheet_id: Cole o ID da sua planilha. Você 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 planilha (code, id_type_item, field_1).