Importa attività in Maintain

Maintain supporta tre metodi per importare le attività:

Caricamento CSV: Importa attività utilizzando l’interfaccia utente (solo modalità APM).
Cognite Toolkit: Ingerisci le attività utilizzando la modellazione dati Cognite Toolkit (modalità APM e IDM/CDM).
Trasformazioni: Converti i dati dalle tabelle RAW o da altre fonti utilizzando CDF Trasformazioni (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:

Vai 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 non debba essere rimossa, è possibile rimuovere valori specifici dall’intestazione o modificare 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 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 uno speciale valore di intestazione nel formato startTime (DD/MM/YYYY). In questo esempio, startTime è il nome del campo, mentre DD/MM/YYYY è il formato data che deve essere utilizzato nelle righe successive del file CSV. Ad esempio, l’importazione del seguente file comporterà la creazione dell’attività 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 uno speciale valore di intestazione nel formato isActive (true/false). Questi campi hanno solo due valori validi, true o false. Ad esempio, l’importazione del seguente file comporterà la creazione dell’attività con isActive impostato su false.

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

Formattare valori contenenti virgole

Poiché il formato CSV separa i valori utilizzando le virgole, fai attenzione quando un campo attività deve contenere anche una virgola. Maintain elabora i file CSV secondo lo standard RFC 4180, che richiede che i valori contenenti virgole siano racchiusi tra virgolette doppie. Ad esempio, l’importazione del seguente file comporterà la creazione dell’attività con city impostato su Boston, MA.

title,city
Erect scaffolding,"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, l’importazione del seguente file comporterà la creazione dell’attività con state impostato su New York, ma non avrà alcun valore nel campo city.

title,city,state
Erect scaffolding,New York

Collegare un’attività a un bene

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

title,assetExternalId
Erect scaffolding,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 asset e dei relativi ID esterni, consigliamo di recuperare questi dati utilizzando l’API asset di CDF o altri estrattori di dati.

Importa un file CSV compilato

Una volta ottenuto un modello CSV popolato, puoi importarlo in Maintain:

Vai a Attività > Aggiungi attività.
Seleziona Importa attività.
Seleziona il campo Fai clic 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 Controllo 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 esito positivo, vedrai un messaggio di successo verde con il pulsante Mostra attività.
Facoltativo. Seleziona Mostra attività per passare alle attività importate e verificare che siano corrette in base al file CSV.

Importazione tramite Cognite Toolkit

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

Utilizza Cognite Toolkit per acquisire le attività tramite le funzionalità di modellazione dati di CDF. Questo metodo funziona per entrambe le modalità di distribuzione e fornisce controllo delle versioni e distribuzioni riproducibili.

Requisiti

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

Una vista attività personalizzata configurata nello spazio del tuo modello dati (o utilizza la vista CogniteMaintenanceOrder standard di cdf_idm)
La vista attività mappata nella configurazione di Maintain sotto viewMappings
Accesso a Cognite Toolkit

Configura la mappatura della vista attività

Nella configurazione Maintain, verificare che la sezione viewMappings punti alla vista attività:

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

Se è stata creata una vista attività personalizzata (ad esempio, APM_Activity o ExtendedActivity), aggiornare la mappatura in modo che punti alla vista personalizzata:

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

Ulteriori informazioni su estensione dei modelli di dati e configurazione delle mappature delle viste.

Ingestione delle attività con Cognite Toolkit

Utilizzare Cognite Toolkit come approccio consigliato 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 dell’attività Vedere la documentazione Cognite Toolkit per esempi e modelli dettagliati.

Configura le mappature dei campi

Assicurarsi che i nodi attività includano i campi richiesti per Maintain:

Campo	Descrizione	Obbligatorio
`externalId`	Identificatore univoco per l’attività	Sì
`title`	Titolo dell’attività	Sì
`status`	Stato dell’attività (ad esempio, “Aperto”, “In corso”, “Completato”)	Consigliato
`startTime`	Data/ora di inizio	Consigliato
`endTime`	Data/ora di fine	Consigliato
`rootLocation`	Identificatore della posizione radice	Consigliato
`assetExternalId`	ID esterno dell’asset collegato	Opzionale
`mainAsset`	Relazione diretta con l’asset	Opzionale

Includi campi aggiuntivi in base alle impostazioni della tua Configurazione campi in Maintain.

Distribuisci le attività

Distribuisci i dati delle tue attività utilizzando Cognite Toolkit:

cdf deploy --env dev

Usa il flag --drop-data se devi sostituire le attività esistenti:

cdf deploy --env dev --drop-data

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

Verifica in Maintain

Accedi a Maintain.
Vai su Attività.
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 CDF Trasformazioni per convertire i dati dalle tabelle RAW o da altre fonti in nodi 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 campi includa tutti i campi che stai acquisendo
Collegamenti agli asset interrotti	Assicurati che le relazioni `assetExternalId` o `mainAsset` puntino ad asset esistenti
Posizione radice errata	Verifica che `rootLocation` corrisponda alla configurazione della tua posizione

Flows

InField

Maintain

Risorse esterne

Importa attività in Maintain

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

Importazione tramite Cognite Toolkit

Requisiti

Configura la mappatura della vista attività

Ingestione delle attività con 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

​Importazione tramite Cognite Toolkit

​Requisiti

​Configura la mappatura della vista attività

​Ingestione delle attività con 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

Importazione tramite Cognite Toolkit

Requisiti

Configura la mappatura della vista attività

Ingestione delle attività con Cognite Toolkit

Ingestisci attività con Trasformazioni

Risoluzione dei problemi