Pular para o conteúdo principal
Português do Brasil English (US) Español (España) Français Português (Portugal)

Como editar ativos no Fracttal One utilizando o Fracttal Hub?

Atualizado

Fracttal Hub permite automatizar processos para otimizar a gestão de manutenção. Uma de suas funcionalidades mais poderosas é a capacidade de editar informações de ativos existentes em massa, utilizando uma planilha do Google Sheets como fonte de dados.

Esse método é ideal em cenários onde é necessário modificar campos específicos (como tipo, nome, campos personalizados, etc.) para um grande número de ativos já registrados no Fracttal One, evitando o processo de exclusão e reimportação.

Passo 1: Configuração da Conta de Serviço no Google Cloud

Para que o Fracttal One possa ler os dados da sua planilha de forma segura, é necessário criar uma credencial de acesso através de uma Conta de Serviço no Google Cloud.

  1. Acesse o Google Cloud Platform.
  2. No menu de navegação, vá para IAM e administrador > Contas de serviço.

  3. Clique em CRIAR CONTA DE SERVIÇO.

    Atribua um nome e uma descrição à sua conta de serviço (por exemplo, “Editar Equipos”) e clique em CONTINUAR. 

     

  4. Na lista, procure a conta que você acabou de criar e clique sobre ela.
  5. Vá para a aba CHAVES.
  6. Clique em ADICIONAR CHAVE > Criar nova chave.
  7. Selecione o tipo de chave JSON e clique em CRIAR. Um arquivo .json será baixado no seu computador. Guarde-o em um local seguro, pois contém suas credenciais de acesso.

Passo 2: Preparação da planilha do Google Sheets

Agora prepararemos a planilha que conterá os dados a serem atualizados.

  1. Crie uma nova planilha no Google Sheets.
  2. Atribua um nome descritivo à planilha (ex: Editar Equipos).

Compartilhe a planilha:

  1. Volte para a página da sua Conta de Serviço no Google Cloud e copie seu endereço de e-mail.

  2. Na sua planilha, clique em Compartilhar.

  3. Cole o e-mail da Conta de Serviço, atribua permissão de Editor e clique em Enviar.

Estrutura das colunas:
A primeira linha deve conter os nomes dos campos que você deseja atualizar. O campo code é obrigatório para identificar qual ativo será modificado.

code id_type_item group  
HUB-001 2 CAMIONETAS  
       

Definição de campos:

  • code (Obrigatório): Código único do ativo já existente no Fracttal One.
  • id_type_item (Obrigatório): ID numérico do tipo de ativo (ex: 2 para Equipos).
  • group (Obrigatório): O "Tipo" do ativo. O valor deve coincidir exatamente com um já registrado em Catálogos Auxiliares > Ativos.

Importante: Para saber quais outros campos podem ser atualizados, consulte a documentação da nossa API no endpoint “Atualizar um ativo”. Para mais informações sobre campos personalizados, revise o artigo sobre O que são os formulários personalizados?

 

Passo 3: Criação da Conexão no Fracttal One

Com as credenciais prontas, criaremos a ponte de conexão entre o Fracttal One e o Google Sheets.

  1. No Fracttal One, vá para Configuração > Conexões.

  2. Clique no ícone + para adicionar uma nova conexão

  3. Selecione o tipo Google Sheet (Conta de Serviço).

  4. Adicione uma Descrição (ex: “Editar Equipos”).

  5. Abra o arquivo .json que você baixou no Passo 1 e copie o conteúdo de cada campo (project_id, private_key, client_email, etc.) nos campos do formulário do Fracttal One.
  6. Clique no ícone Salvar no canto superior direito.

Passo 4: Criação da Regra no Fracttal Hub

Neste passo final, configuraremos a lógica de automação.

  1. Acesse o menu Automatizador > Fracttal Hub.

  2. Clique no ícone + para criar uma nova regra.

  3. Adicione uma Descrição como “Editar Equipos”.

Configure o fluxo:

  • Ativador: Selecione Manual.

Origem (Fonte):

  • Módulo: GoogleSheet
  • Conexão: Selecione a conexão criada no Passo 3
  • Ação: Ler
  • spreadsheet_id: Copie o ID da sua planilha
  • sheet: Escreva 0 para selecionar a primeira aba
  • Campos: Adicione os nomes das colunas (code, id_type_item, group)

Conexão:

  • Módulo: Fracttal
  • Conexão: FRACTTAL HUB
  • Ação: Selecione Ler

Configuração (Mapeamento de campos):

  • Mapeie os campos da sua planilha (Origem) com os do sistema (Destino). Por exemplo:
  • Clique no ícone de salvar (✓) para confirmar o mapeamento.

Passo 5: Execução e Verificação

  1. Após configurar a regra, clique em Salvar no canto superior direito.
  2. Para iniciar o processo, clique em Executar.
  3. Você pode monitorar o progresso no Histórico de Execução. Um processo bem-sucedido mostrará “Sim” nas colunas de Extração, Transformação e Carga, junto com um código de resposta "200".

Finalmente, acesse o módulo de Ativos e verifique se as informações dos seus equipamentos foram atualizadas de acordo com os dados da planilha.

Com esses passos, você poderá manter atualizada sua base de dados de ativos de forma rápida, em massa e automatizada.

Artigos relacionados