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

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: Aceda à consola do Google Cloud

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

  1. Aceda à consola do Google Cloud.

  2. No menu de navegação, vá a 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 descarregar a chave da conta de serviço

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

  1. Na lista de contas de serviço, clique no e-mail da conta que acabou de criar.

  2. Vá à 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á descarregado automaticamente no seu computador. Guarde este arquivo em um local seguro, pois contém as credenciais de acesso.

Passo 3: Compartilhar a folha de cálculo do Google com a conta de serviço

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

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

  2. Abra sua folha de cálculo no Google Sheets.

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

  4. Cole o e-mail 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 folha de cálculo do Google Sheets

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

  1. Aceda à 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 da última 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 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 descarregado 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 folha de cálculo (encontra-se na URL, entre /d/ e /edit/).

  • sheet: Escreva 0 para ler a primeira aba.

  • 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 folha (Origem) com os do sistema (Destino), garantindo que coincidam:


Passo 7: Executar e verificar o fluxo

  1. Clique em Salvar para guardar 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á a Tarefas > Plano de Tarefas, selecione o plano correspondente e, na aba Ativos Vinculados, verá o ativo que foi associado através da folha de cálculo.

Notas:

  • Este método é compatível unicamente 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 múltiplas linhas na sua folha do Google Sheets para associar vários ativos a um ou mais planos de uma só vez.

Artigos relacionados