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

Como editar ativos no Fracttal One utilizando o Fracttal Hub?

Atualizado

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

Este 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 eliminaçã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 folha 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 para o seu computador. Guarde-o em um lugar seguro, pois contém suas credenciais de acesso.

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

Agora prepararemos a folha que conterá os dados a atualizar.

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

Compartilhe a folha:

  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 folha, 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 folha
  • 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 folha (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 conforme os dados da folha.

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

 

Artigos relacionados