Importa attività in Maintain

Maintain supporta tre metodi per importare attività:

Caricamento CSV: Importa attività utilizzando l’interfaccia utente (solo modalità APM).
Cognite Toolkit: Ingestisci attività utilizzando Cognite Toolkit per la modellazione dei dati (modalità APM e IDM/CDM).
Trasformazioni: Converti i dati da tabelle RAW o altre fonti utilizzando Trasformazioni CDF (modalità APM e IDM/CDM).

Importa tramite caricamento CSV (modalità APM)

Disponibilità della modalità: Solo modalità APM. La modalità IDM/CDM non supporta l’importazione CSV nell’interfaccia utente.

Le attività importate tramite CSV possono essere visualizzate e modificate come attività create in Maintain.

Scarica il modello di file CSV

Il file CSV importato deve conformarsi al modello specifico del tuo progetto. Per scaricare maintain-import-template.csv:

Naviga su Attività e seleziona Aggiungi attività.
Seleziona Importa attività.
Seleziona Scarica modello.

Compila il modello di file CSV

Il modello CSV conterrà solo una singola riga di valori che rappresentano i possibili valori che puoi fornire per un’attività importata. Questa riga è chiamata riga di intestazione e non deve essere rimossa quando si popola il modello.

Sebbene la riga di intestazione row non debba essere rimossa, puoi rimuovere valori specifici dall’intestazione o cambiare l’ordine dei valori. Ad esempio, se un certo campo non è rilevante per l’importazione in uno scenario specifico, puoi rimuoverlo dall’intestazione e dalle righe successive. Ciò comporterà che il campo rimanga vuoto in tutte le attività importate.

Per importare un’attività singola, aggiungi una nuova riga al modello e inserisci i valori appropriati separati da virgole. Ogni valore nella nuova riga dovrebbe contenere il valore che desideri popolare nella rispettiva riga di intestazione fornita nel modello. Ad esempio, se il tuo modello contiene la seguente riga di intestazione: title,status,department, crea un file CSV con una riga aggiuntiva:

title,status,department
Erect scaffolding,Done,Rigging

Creerai un’attività con il titolo “Erect scaffolding”, stato “Done” e dipartimento “Rigging” quando importato.

Formatta i campi data

Alcuni campi attività in Maintain rappresentano date e devono avere un formato specifico per essere importati correttamente. I campi data possono essere identificati nel modello CSV da un valore di intestazione speciale nella forma 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, importando il seguente file si otterrà l’attività creata con startTime impostato al 10 dicembre 2023.

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

Formatta i campi booleani

Alcuni campi attività in Maintain rappresentano valori booleani, come true o false. I campi booleani possono essere identificati nel modello CSV da un valore di intestazione speciale nella forma isActive (true/false). Questi campi hanno solo due valori validi, true o false. Ad esempio, importando il seguente file si otterrà l’attività creata con isActive impostato a false.

titolo, è attivo (vero/falso)
Montare ponteggi, falso

Formattare valori contenenti virgole

A causa del formato CSV che separa i valori utilizzando le virgole, prestare attenzione quando un campo attività deve contenere anche una virgola. Mantenere i processi dei file CSV secondo il standard RFC 4180, che richiede che i valori contenenti virgole siano racchiusi tra virgolette doppie. Ad esempio, importando il seguente file, l’attività verrà creata con città impostata su Boston, MA.

titolo,città
Montare ponteggi,"Boston, MA"

Valori non impostati

È possibile lasciare il campo vuoto nei campi attività non richiesti per rappresentare valori mancanti o irrilevanti per l’attività specifica. Ad esempio, importando il seguente file, l’attività verrà creata con stato impostato su New York, ma non avrà alcun valore nel campo città.

titolo,città,stato
Montare ponteggi,New York

Collegare un’attività a un bene

Mantenere supporta il collegamento delle attività agli asset CDF, che viene utilizzato per contestualizzare l’attività in modelli 3D, documenti, PSN e altro. Affinché Mantenere crei il collegamento appropriato a un bene in CDF, è necessario fornire l’ID esterno dell’asset CDF nel modello di importazione. Se hai la contestualizzazione degli asset nel tuo progetto, ci sarà un campo speciale assetExternalId nel modello che devi compilare con l’ID esterno dell’asset dell’attività. Ad esempio, importando il seguente file e assumendo che esista un asset CDF con ID esterno NY_BUILDING_23, l’attività sarà contestualizzata a questo asset quando verrà inserita in Mantenere.

titolo,assetExternalId
Montare ponteggi,NY_BUILDING_23

Se l’ID esterno fornito non viene esportato, l’utente vedrà un errore durante l’importazione.

Gli utenti finali potrebbero non conoscere l’ID esterno del bene a cui è collegata l’attività. Se è necessario fornire agli utenti finali un elenco dei possibili beni e dei loro ID esterni, si consiglia di recuperare questi dati utilizzando l’API asset di CDF o altri estrattori di dati.

Importa un file CSV compilato

Una volta che hai un modello CSV popolato, puoi importarlo in Mantenere:

Naviga a Attività > Aggiungi attività.
Seleziona Importa attività.
Seleziona il campo Clicca per selezionare il file CSV da importare.
Seleziona e carica il file CSV popolato dal tuo computer.
Verifica di aver importato il file controllando la sezione Ispettore file. Un messaggio verde dovrebbe mostrare il numero di righe da importare e se hai avvisi o errori.
Se non ci sono errori, seleziona Importa per avviare il processo di importazione.
Quando l’importazione ha successo, vedrai un messaggio di successo verde con il pulsante Mostra attività.
Facoltativo. Seleziona Mostra attività per navigare alle attività importate e controllare che siano corrette secondo il file CSV.

Importa tramite Cognite Toolkit

Disponibilità della modalità: Modalità APM e IDM/CDM. Questo è l’approccio raccomandato per l’ingestione programmatica delle attività.

Utilizza il Cognite Toolkit per ingerire attività attraverso le capacità di modellazione dei dati di CDF. Questo metodo funziona per entrambe le modalità di distribuzione e fornisce controllo delle versioni e distribuzioni riproducibili.

Requisiti

Prima di importare attività tramite il Cognite Toolkit, assicurati di avere:

Una vista attività personalizzata configurata nel tuo spazio di modello dati (o utilizza la vista standard OrdineManutenzioneCognite da cdf_idm)
La vista attività mappata nella tua configurazione di Maintain sotto viewMappings
Accesso al Cognite Toolkit

Configura la mappatura della vista attività

Nella tua configurazione di Maintain, verifica che la sezione viewMappings punti alla tua vista attività:

{
  "viewMappings": {
    "activity": {
      "type": "view",
      "space": "cdf_idm",
      "version": "v1",
      "externalId": "CogniteMaintenanceOrder"
    }
  }
}

Se hai creato una vista di attività personalizzata (ad esempio, APM_Activity o ExtendedActivity), aggiorna la mappatura per puntare alla tua vista personalizzata:

{
  "viewMappings": {
    "activity": {
      "type": "view",
      "space": "maintain_schema_extention",
      "version": "v1",
      "externalId": "APM_Activity"
    }
  }
}

Scopri di più su estendere i modelli di dati e configurare le mappature delle viste.

Ingestisci attività con il Cognite Toolkit

Utilizza il Cognite Toolkit come approccio raccomandato per l’ingestione delle attività in modalità IDM.

Crea la struttura dei dati dell'attività

Se non lo hai già fatto, crea file YAML per Container, View e Node per le tue attività. Segui la struttura standard di modellazione dei dati:

APM_Activity.Container.yaml - Definisce lo schema del contenitore
APM_Activity.View.yaml - Definisce le proprietà e le relazioni della vista
apmActivities.Node.yaml - Contiene le istanze delle tue attività Consulta la documentazione del Cognite Toolkit per esempi dettagliati e modelli.

Configura le mappature dei campi

Assicurati che i tuoi nodi di attività includano i campi richiesti per Mantenere:

Campo	Descrizione	Richiesto
`externalId`	Identificatore unico per l’attività	Sì
`title`	Titolo dell’attività	Sì
`status`	Stato dell’attività (ad esempio, “Aperto”, “In Corso”, “Fatto”)	Raccomandato
`startTime`	Data/ora di inizio	Raccomandato
`endTime`	Data/ora di fine	Raccomandato
`rootLocation`	Identificatore della posizione principale	Raccomandato
`assetExternalId`	ID esterno dell’asset collegato	Facoltativo
`mainAsset`	Relazione diretta con l’asset	Facoltativo

Includi campi aggiuntivi in base alle tue impostazioni di Configurazione dei Campi in Mantenere.

Distribuisci le attività

Distribuisci i tuoi dati di attività utilizzando il Cognite Toolkit:

cdf deploy --env dev

Utilizza il --drop-data flag se hai bisogno di sostituire le attività esistenti:

cdf deploy --env dev --drop-data

Scopri di più sui flag di distribuzione del Toolkit Cognite.

Verifica in Maintain

Accedi a Manutenzione. 2. Naviga verso Attività. 3. Verifica che le tue attività importate appaiano con i dati corretti.

Ingestisci attività con Trasformazioni

Disponibilità della modalità: Modalità APM e IDM/CDM. Questo è l’approccio consigliato per i dati in blocco.

In alternativa, puoi utilizzare Trasformazioni CDF per convertire i dati da tabelle RAW o altre fonti in nodi di attività.

Risoluzione dei problemi

Se riscontri problemi con le attività dopo l’ingestione, consulta la tabella per cause e soluzioni.

Problema	Soluzione
Attività non visibili	Verifica che la configurazione `viewMappings` punti allo spazio, alla vista e alla versione corretti
Campi mancanti	Controlla che la tua Configurazione dei Campi includa tutti i campi che stai ingerendo
Collegamenti agli asset interrotti	Assicurati che le relazioni `assetExternalId` o `mainAsset` puntino a asset esistenti
Posizione radice errata	Verifica che `rootLocation` corrisponda alla tua configurazione della posizione

​Importa tramite caricamento CSV (modalità APM)

​Formatta i campi data

​Formatta i campi booleani

​Formattare valori contenenti virgole

​Valori non impostati

​Collegare un’attività a un bene

​Importa tramite Cognite Toolkit

​Requisiti

​Configura la mappatura della vista attività

​Ingestisci attività con il Cognite Toolkit

​Ingestisci attività con Trasformazioni

​Risoluzione dei problemi

Importa tramite caricamento CSV (modalità APM)

Formatta i campi data

Formatta i campi booleani

Formattare valori contenenti virgole

Valori non impostati

Collegare un’attività a un bene

Importa tramite Cognite Toolkit

Requisiti

Configura la mappatura della vista attività

Ingestisci attività con il Cognite Toolkit

Ingestisci attività con Trasformazioni

Risoluzione dei problemi