Importazione di attività da un file CSV
È possibile importare più attività da un'origine esterna in Maintain caricando un file di testo in formato CSV contenente i dati delle attività e inserendo il file nelle attività. Le attività potranno essere visualizzate e modificate come attività create in Maintain.
Download del modello di file CSV
Il file CSV importato deve essere conforme al modello specifico del progetto. Per scaricare maintain-import-template.csv:
- Andare ad Attività e selezionare Aggiungi attività.
- Selezionare Importa attività.
- Selezionare Scarica modello.
Compilazione del modello di file CSV
Il modello CSV conterrà solo una singola riga di valori che rappresenta i possibili valori che è possibile fornire per un'attività importata. Questa riga è denominata riga di intestazione e non deve essere rimossa quando si compila il modello.
Sebbene la riga di intestazione non debba essere rimossa, è possibile rimuovere valori specifici dall'intestazione o modificare l'ordine dei valori. Ad esempio, se un determinato campo non è rilevante per l'importazione in uno scenario specifico, è possibile rimuoverlo dall'intestazione e dalle righe successive. In questo modo, il campo verrà lasciato vuoto in tutte le attività importate.
Per importare una singola attività, aggiungere una nuova riga al modello e inserire i valori appropriati separati da virgole. Ogni valore nella nuova riga deve contenere il valore che si desidera compilare nella rispettiva riga di intestazione fornita nel modello.
Ad esempio, se il modello contiene la seguente riga di intestazione: title,status,department, creare un file CSV con una riga aggiuntiva:
title,status,department
Erect scaffolding,Done,Rigging
Dopo l'importazione, si creerà un'attività con il titolo "Erect scaffoldin", stato "Done," e reparto "Rigging".
Formattazione dei campi di data
Alcuni campi di attività in Maintain rappresentano le date e devono avere un formato specifico per essere importati correttamente. I campi di data possono essere identificati nel modello CSV da un valore di intestazione speciale nel formato startTime (DD/MM/YYYY). In questo esempio, startTime è il nome del campo, mentre DD/MM/YYYY è il formato della data che deve essere utilizzato nelle righe successive del file CSV.
Ad esempio, con l'importazione del file seguente si creerà l'attività con startTime impostato sul 10 dicembre 2023.
title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023
Formattazione dei campi booleani
Alcuni campi di attività in Maintain rappresentano valori booleani, come true o false. I campi di data possono essere identificati nel modello CSV da un valore di intestazione speciale nel formato isActive (true/false). Questi campi hanno solo due valori validi, true o false.
Ad esempio, con l'importazione del file seguente si creerà l'attività con isActive impostato su false.
title,isActive (true/false)
Erect scaffolding,false
Formattazione dei valori contenenti virgole
Poiché nel formato CSV i valori sono separati da virgole, prestare attenzione quando un campo dell'attività deve contenere anche una virgola. Maintain elabora i file CSV in base allo RFC 4180 standard che richiede di inserire tra virgolette doppie i valori contenenti virgole.
Ad esempio, con l'importazione del file seguente si creerà l'attività con il campo city impostato su Boston, MA.
title,city
Erect scaffolding,"Boston, MA"
Valori non impostati
È possibile lasciare vuoti i campi dell'attività non richiesti per indicare valori mancanti o non rilevanti per l'attività specifica.
Ad esempio, con l'importazione del file seguente si creerà l'attività con state impostato su New York ma senza alcun valore nel campo city.
title,city,state
Erect scaffolding,New York
Collegamento di un'attività a un asset
Maintain consente di collegare le attività agli asset di CDF per contestualizzarle nei modelli 3D, documenti, PSN e così via. Perché Maintain crei il collegamento appropriato a un asset in CDF, è necessario fornire l'ID esterno dell'asset di CDF nel modello di importazione.
Se nel progetto è presente la contestualizzazione dell'asset, il modello conterrà un campo assetExternalId speciale da compilare con l'ID esterno dell'asset dell'attività.
Ad esempio, se si importa il file seguente ed è presente un asset di CDF con ID esterno NY_BUILDING_23, l'attività verrà contestualizzata con questo asset al momento dell'inserimento in Maintain.
title,assetExternalId
Erect scaffolding,NY_BUILDING_23
Se l'ID esterno fornito non viene esportato, l'utente visualizzerà un errore al momento dell'importazione.
Gli utenti finali potrebbero non conoscere l'ID esterno dell'asset a cui è collegata l'attività. Se è necessario fornire agli utenti finali un elenco dei possibili asset e i rispettivi ID esterni, si consiglia di recuperare questi dati utilizzando l'API asset di CDF o altri strumenti di estrazione di dati.
Importazione di un file CSV compilato
Una volta compilato un modello CSV, è possibile importarlo in Maintain:
- Andare ad Attività > Aggiungi attività.
- Selezionare Importa attività.
- Selezionare il campo Fare clic per selezionare il file CSV da importare.
- Selezionare e caricare dal computer il file CSV compilato.
- Verificare di aver importato il file selezionando la sezione File Inspector. Verrà visualizzato un messaggio verde che indica il numero di righe da importare e se sono presenti avvisi o errori.
- Se non sono presenti errori, selezionare Importa per avviare il processo di importazione.
- Se l'importazione ha esito positivo, verrà visualizzato un messaggio verde di operazione riuscita con il pulsante Mostra attività.
- Facoltativo. Selezionare Mostra attività per andare alle attività importate e verificare che siano visualizzate correttamente in base al file CSV.