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

Como vincular um ativo a um plano de manutenção a partir do Fracttal Hub?

Atualizado

Fracttal Hub permite associar ativos a planos de manutenção de forma massiva a partir do Google Sheets. Para que o carregamento seja válido, o ativo não deve estar vinculado a outro plano, deve ser uma localização, equipamento ou ferramenta, e o plano não pode incluir ativadores nem subtarefas com leituras de medidor.

Passo 1: Acesse o console do Google Cloud

A comunicação entre Fracttal e Google Sheets é realizada de forma segura por meio de uma conta de serviço.

  1. Acesse o console do Google Cloud.

  2. No menu de navegação, vá para IAM e administrador > Contas de serviço.
  3. Clique em + CRIAR CONTA DE SERVIÇO.

  4. Atribua um nome à conta de serviço que seja fácil de identificar, por exemplo: associar-ativo-plano-manutencao.

  5. Clique em FINALIZAR para criar a conta sem configurar permissões adicionais.

Passo 2: Gerar e baixar a chave da conta de serviço

Para que o Fracttal possa se autenticar, é necessário gerar uma chave privada para a conta de serviço.

  1. Na lista de contas de serviço, clique no email da conta que você acabou de criar.

  2. Vá para a aba CHAVES.

  3. Clique em ADICIONAR CHAVE e selecione Criar nova chave.
  4. Escolha o tipo de chave JSON e clique em CRIAR.

  5. Um arquivo .json será baixado automaticamente em seu computador. Guarde este arquivo em um local seguro, pois contém as credenciais de acesso.

Passo 3: Compartilhar a planilha do Google com a conta de serviço

Agora você precisa conceder permissões à conta de serviço para acessar e editar sua planilha.

  1. Abra o arquivo .json que você baixou. Localize e copie o valor do campo "client_email".

  2. Abra sua planilha no Google Sheets.

  3. Clique no botão Compartilhar (parte superior direita).

  4. Cole o email da conta de serviço no campo de compartilhamento.

  5. Certifique-se de conceder a permissão de Editor.

  6. Clique em Enviar.

Passo 4: Preparar a planilha do Google Sheets

A primeira linha da sua planilha deve conter os cabeçalhos (parâmetros) exatos que o Fracttal espera receber.

  1. Acesse a documentação da API do Fracttal para consultar os parâmetros necessários.

  2. Na primeira linha, insira os seguintes cabeçalhos:

    id_tasks_plan  code_user  item_code  last_date_maintenance 
    2845581928182192HUB-0012025-03-12T20:00:00-03

  3. Preencha as linhas seguintes com os dados correspondentes:

  • id_tasks_plan: ID do plano de tarefas ao qual você deseja associar o ativo. Você pode encontrá-lo no Fracttal.

  • code_user: Código do usuário responsável pela transação. Encontre-o em Catálogos > Recursos Humanos.

  • item_code: Código do ativo (equipamento, localização, etc.) que você deseja vincular. Encontre-o em Catálogos > Ativos.

  • last_date_maintenance: Data do último manutenção.

Importante: O formato da data last_date_maintenance deve ser AAAA-MM-DDTHH:MM:SS-UTC.
 Copie o formato da documentação da API para evitar erros.

Passo 5: Criar a conexão no Fracttal One

Agora vamos configurar a conexão dentro do Fracttal para que ele 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:app.fracttal.com_config (64)03.PNG

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

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

Passo 6: 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 ativador:

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

app.fracttal.com_config (69)05.PNG

Configuração da Fonte:

app.fracttal.com_config (69)06.PNG

  • 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 guia.

  • Campos: Adicione os nomes das colunas:  description, item_code, unit_code, is_counter.

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

Configuração de campos (mapeamento):

app.fracttal.com_dispatcher_hub (45)08.PNG

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

  • Mapeie os campos da planilha (Origem) com os do sistema (Destino), certificando-se de que coincidam:


Passo 7: Executar e verificar o fluxo

  1. Clique em Salvar para salvar a configuração do fluxo.app.fracttal.com_dispatcher_hub (49)09.PNG
  2. Ative o interruptor Habilitado.
  3. Clique novamente em Salvar.

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

Para verificar, vá para Tarefas > Plano de Tarefas, selecione o plano correspondente e, na aba Ativos Vinculados, você verá o ativo que foi associado por meio da planilha.

Notas:

  • Este método é compatível apenas com planos de tarefas baseados em frequência (data). Não é compatível com planos que tenham ativadores por leitura de medidor.

  • Você pode adicionar várias linhas em sua planilha do Google Sheets para associar vários ativos a um ou mais planos de uma só vez.

Artigos relacionados