Skip to main content
Maintain suporta três métodos para importar atividades:
  • Carregamento de CSV: Importar atividades usando a interface do usuário (apenas modo APM).
  • Cognite Toolkit: Ingira atividades usando modelagem de dados Cognite Toolkit (modos APM e IDM/CDM).
  • Transformações: Converta dados de tabelas RAW ou outras fontes usando CDF Transformações (modos APM e IDM/CDM).

​
Importar via carregamento de CSV (modo APM)

Disponibilidade do modo: Apenas modo APM. O modo IDM/CDM não suporta importação de CSV na interface do usuário.
Atividades importadas via CSV podem ser visualizadas e modificadas como atividades criadas em Maintain.
1

Baixe o modelo de arquivo CSV

O arquivo CSV importado precisa estar em conformidade com o seu modelo específico do projeto. Para baixar maintain-import-template.csv:
  1. Navegue até Atividades e selecione Adicionar atividade.
  2. Selecione Importar atividades.
  3. Selecione Baixar modelo.
2

Preencha o modelo de arquivo CSV

O modelo CSV conterá apenas uma única linha de valores representando os possíveis valores que você pode fornecer para uma atividade importada. Esta linha é chamada de linha de cabeçalho e não deve ser removida ao preencher o modelo.
Embora a linha de cabeçalho não deva ser removida, você pode remover valores específicos do cabeçalho ou alterar a ordem dos valores. Por exemplo, se um determinado campo não for relevante para importar em um cenário específico, você pode removê-lo do cabeçalho e das linhas subsequentes. Isso resultará no campo sendo deixado em branco em todas as atividades importadas.
Para importar uma única atividade, adicione uma nova linha ao modelo e insira os valores apropriados separados por vírgulas. Cada valor na nova linha deve conter o valor que você deseja preencher na respectiva linha de cabeçalho que foi fornecida no modelo. Por exemplo, se o seu modelo contiver a seguinte linha de cabeçalho: title,status,department, crie um arquivo CSV com uma linha adicional:
Você criará uma atividade com o título “Montar andaimes”, status “Concluído” e departamento “Rigging” quando importado.

​
Formatar campos de data

Alguns campos de atividade em Maintain representam datas e devem ter um formato específico para serem importados corretamente. Campos de data podem ser identificados no modelo CSV por um valor de cabeçalho especial no formato startTime (DD/MM/YYYY). Neste exemplo, startTime é o nome do campo, enquanto DD/MM/YYYY é o formato de data que precisa ser usado nas linhas subsequentes do arquivo CSV. Por exemplo, importar o arquivo a seguir resultará na criação da atividade com startTime definido como 10 de dezembro de 2023.

​
Formatar campos booleanos

Alguns campos de atividade em Maintain representam valores booleanos, como true ou false. Campos booleanos podem ser identificados no modelo CSV por um valor de cabeçalho especial no formato isActive (true/false). Esses campos possuem apenas dois valores válidos, true ou false. Por exemplo, a importação do seguinte arquivo resultará na criação da atividade com isActive definido como false.

​
Formatar valores que contêm vírgulas

Devido ao formato CSV separar valores usando vírgulas, tenha cuidado quando um campo de atividade também precisar conter uma vírgula. Maintain processa arquivos CSV de acordo com o padrão RFC 4180, que exige que os valores que contêm vírgulas sejam colocados entre aspas duplas. Por exemplo, a importação do seguinte arquivo resultará na criação da atividade com city definido como Boston, MA.

​
Valores não definidos

Você pode deixar o campo em branco em campos de atividade não obrigatórios para representar valores ausentes ou irrelevantes para a atividade específica. Por exemplo, a importação do seguinte arquivo resultará na criação da atividade com state definido como New York, mas não haverá valor no campo city.

​
Conectar uma atividade a um ativo

Maintain oferece suporte à vinculação de atividades a ativos CDF, o que é usado para contextualizar a atividade em modelos 3D, documentos, PSN e muito mais. Para que Maintain crie o link apropriado para um ativo em CDF, você deve fornecer o ID externo do ativo CDF no modelo de importação. Se você tiver contextualização de ativos em seu projeto, haverá um campo assetExternalId especial no modelo que você precisa preencher com o ID externo do ativo da atividade. Por exemplo, ao importar o seguinte arquivo e assumindo que um ativo CDF exista com o ID externo NY_BUILDING_23, a atividade será contextualizada para este ativo quando ingerida no Maintain.
Se o ID externo fornecido não for exportado, o usuário verá um erro durante a importação.
Os usuários finais podem não saber o ID externo do ativo ao qual a atividade está vinculada. Se for necessário fornecer aos usuários finais uma lista dos possíveis ativos e seus IDs externos, recomendamos recuperar esses dados usando a API de ativos do CDF ou outros extratores de dados.
3

Importe um arquivo CSV preenchido

Depois de ter um modelo CSV preenchido, você pode importá-lo para Maintain:
  1. Navegue até Atividades > Adicionar atividade.
  2. Selecione Importar atividades.
  3. Selecione o campo Clique para selecionar o arquivo CSV para importar.
  4. Selecione e carregue o arquivo CSV preenchido do seu computador.
  5. Verifique se você importou o arquivo conferindo a seção Inspetor de arquivos. Uma mensagem verde deve mostrar o número de linhas a serem importadas e se você tem avisos ou erros.
  6. Se não houver erros, selecione Importar para iniciar o processo de importação.
  7. Quando a importação for bem-sucedida, você verá uma mensagem de sucesso verde com o botão Mostrar atividades.
  8. Opcional: Selecione Mostrar atividades para navegar até as atividades importadas e verificar se elas estão corretas de acordo com o arquivo CSV.

​
Importar via Cognite Toolkit

Disponibilidade do modo: Modos APM e IDM/CDM. Esta é a abordagem recomendada para a ingestão programática de atividades.
Use o Cognite Toolkit para ingerir atividades por meio dos recursos de modelagem de dados do CDF. Este método funciona para ambos os modos de implantação e fornece controle de versão e implantações reproduzíveis.

​
Pré-requisitos

Antes de importar atividades via Cognite Toolkit, certifique-se de que você tem:
  • Uma visualização de atividade personalizada configurada no seu espaço de modelo de dados (ou use a visualização CogniteMaintenanceOrder padrão do cdf_idm)
  • A visualização de atividade mapeada na sua configuração Maintain em viewMappings
  • Acesso ao Cognite Toolkit

​
Configure o mapeamento da visualização de atividade

Na sua configuração Maintain, verifique se a seção viewMappings aponta para sua visualização de atividade:
Se você criou uma visualização de atividade personalizada (por exemplo, APM_Activity ou ExtendedActivity), atualize o mapeamento para apontar para sua visualização personalizada:
Saiba mais sobre estender modelos de dados e configurar mapeamentos de visualização.

​
Ingerir atividades com o Cognite Toolkit

Use o Cognite Toolkit como a abordagem recomendada para ingerir atividades no modo IDM.
1

Crie a estrutura de dados da atividade

Se você ainda não o fez, crie arquivos YAML de Container, View e Node para suas atividades. Siga a estrutura padrão de modelagem de dados:
  • APM_Activity.Container.yaml - Define o esquema do contêiner
  • APM_Activity.View.yaml - Define as propriedades e os relacionamentos da visualização
  • apmActivities.Node.yaml - Contém suas instâncias de atividade Consulte a documentação do Cognite Toolkit para exemplos detalhados e modelos.
2

Configure os mapeamentos de campos

Certifique-se de que seus nós de atividade incluam os campos obrigatórios para Maintain:
Inclua campos adicionais com base nas suas configurações de Configuração de Campo em Maintain.
3

Implante as atividades

Implante seus dados de atividade usando Cognite Toolkit:
Use a flag --drop-data se precisar substituir atividades existentes:
Saiba mais sobre os sinalizadores de implantação do Cognite Toolkit.
4

Verifique em Maintain

  1. Faça login em Maintain.
  2. Navegue até Atividades.
  3. Verifique se suas atividades importadas aparecem com os dados corretos.

​
Ingestão de atividades com Transformações

Disponibilidade do modo: Modos APM e IDM/CDM. Esta é a abordagem recomendada para dados em massa.
Alternativamente, você pode usar CDF Transformações para converter dados de tabelas RAW ou outras fontes em nós de atividade.

​
Solução de problemas

Se você encontrar problemas com atividades após a ingestão, consulte a tabela para causas e soluções.
Última modificação em 8 de setembro de 2026