Importar atividades de um arquivo CSV

Você pode importar várias atividades de uma fonte externa para o Maintain. Para isso, carregue um arquivo de texto no formato CSV contendo dados de atividades e faça a ingestão dele nas atividades. É possível visualizar e modificar essas atividades da mesma forma como você faz com as criadas no Maintain.

Baixar o modelo de arquivo CSV

O arquivo CSV importado precisa estar em conformidade com o modelo específico do projeto. Para baixar o arquivo maintain-import-template.csv:

1. Vá até Atividades e selecione Adicionar atividade.
2. Selecione Importar atividades.
3. Selecione Baixar modelo.

Preencher o modelo de arquivo CSV

O modelo CSV conterá apenas uma linha de valores. Eles representam os valores que você pode fornecer para uma atividade importada. Essa linha é chamada de linha de cabeçalho e não deve ser removida ao preencher o modelo.

dica

Embora a linha de cabeçalho não deva ser removida, você pode excluir valores específicos do cabeçalho ou alterar a ordem deles. Por exemplo, quando um determinado campo não é necessário na importação de um cenário específico, você pode removê-lo do cabeçalho e das linhas subsequentes. Assim, esse campo ficará 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 célula da nova linha deve conter o valor que você quer preencher de acordo com o cabeçalho fornecido no modelo.

Por exemplo, se o seu modelo contiver a seguinte linha de cabeçalho: title,status,department (título, status e departamento), crie um arquivo CSV com uma linha adicional como esta:

title,status,department
Erect scaffolding,Done,Rigging

Ao fazer a importação, isso criará uma atividade com o título "Erect scaffolding" (Montagem de andaime), o status "Done" (Concluída) e o departamento "Rigging" (Montagem).

Formatar campos de data

Alguns campos de atividade no Maintain representam datas e devem ter um formato específico para serem importados corretamente. No modelo CSV, esses campos têm um valor de cabeçalho especial no formato StartTime (DD/MM/YYYY). Neste exemplo, startTime é o nome do campo e DD/MM/YYYY (DD/MM/AAAA) é o formato de data que precisa ser usado nas linhas subsequentes do arquivo CSV.

Por exemplo, a importação do arquivo a seguir resultará na criação da atividade com a startTime definida para 10 de dezembro de 2023.

title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023

Formatar campos booleanos

Alguns campos de atividade no Maintain representam valores booleanos, como true (verdadeiro) ou false (falso). No modelo CSV, esses campos têm um valor de cabeçalho especial no formato isActive (true/false). Eles têm apenas dois valores válidos, true (verdadeiro) ou false (falso).

Por exemplo, a importação do arquivo a seguir resultará na criação da atividade com isActive definido como false.

title,isActive (true/false)
Erect scaffolding,false

Formatar valores contendo vírgulas

Devido ao formato CSV separar valores com vírgulas, tenha cuidado quando um campo de atividade também precisar conter vírgulas. O Maintain processa arquivos CSV de acordo com a norma RFC 4180, que determina que valores com vírgulas sejam colocados entre aspas duplas.

Por exemplo, a importação do arquivo a seguir resultará na criação da atividade com o campo city (cidade) definido como Boston, MA.

title,city
Erect scaffolding,"Boston, MA"

Valores indefinidos

Você pode deixar em branco os campos que não são obrigatórios para representar valores ausentes ou irrelevantes para uma atividade específica.

Por exemplo, a importação do arquivo a seguir resultará na criação da atividade com o campo state (estado) definido como New York, mas sem nenhum valor no campo city (cidade).

title,city,state
Erect scaffolding,New York

Conectar uma atividade a um ativo

No Maintain, é possível vincular atividades a ativos do CDF. Isso é útil para contextualizar a atividade em modelos 3D, documentos, PSN etc. Para o Maintain criar o vínculo correto com um ativo no CDF, informe o ID externo do ativo do CDF no modelo de importação.

Se houver contextualização de ativos no seu projeto, haverá um campo especial assetExternalId no modelo que você precisará preencher com o ID externo do ativo da atividade.

Por exemplo, ao importar o arquivo a seguir, supondo que exista um ativo do CDF ID externo NY_BUILDING_23, a atividade será contextualizada para esse ativo quando ingerida no Maintain.

title,assetExternalId
Erect scaffolding,NY_BUILDING_23

Se não ocorrer a exportação do ID externo informado, será exibido um erro durante a importação.

dica

Os usuários finais talvez não saibam o ID externo do ativo ao qual a atividade está vinculada. Caso seja necessário fornecer aos usuários finais uma lista de ativos possíveis e seus respectivos IDs externos, recomendamos recuperar esses dados usando a API de ativos do CDF ou outros extratores de dados.

Importar um arquivo CSV preenchido

Se você já tem um modelo CSV preenchido, pode importá-lo para o Maintain:

1. Acesse Atividades > Adicionar atividade.
2. Selecione Importar atividades.
3. Selecione o campo Clique para selecionar o arquivo CSV a importar.
4. Selecione e carregue o arquivo CSV preenchido que está no seu computador.
5. Para conferir o arquivo a ser importado, verifique a seção Inspetor de arquivos. Uma mensagem em verde mostra o número de linhas que serão importadas e possíveis avisos ou erros.
6. Se não houver erros, selecione Importar para iniciar o processo de importação.
7. Se a importação for bem-sucedida, será exibida uma mensagem de sucesso em verde com o botão Mostrar atividades.
8. Opcional: selecione Mostrar atividades para ir até as atividades importadas e verificar se elas correspondem ao arquivo CSV.