Importera aktiviteter till Maintain

Maintain stöder tre metoder för att importera aktiviteter:

CSV-uppladdning: Importera aktiviteter med hjälp av användargränssnittet (endast APM-läge).
Cognite Toolkit: Mata in aktiviteter med Cognite Toolkit datamodellering (APM- och IDM/CDM-lägen).
Transformationer: Konvertera data från RAW-tabeller eller andra källor med CDF Transformationer (APM- och IDM/CDM-lägen).

Importera via CSV-uppladdning (APM-läge)

Lägestillgänglighet: Endast APM-läge. IDM/CDM-läge stöder inte CSV-import i användargränssnittet.

Aktiviteter som importeras via CSV kan visualiseras och ändras som aktiviteter skapade i Maintain.

Ladda ner CSV-filens mall

Den importerade CSV-filen måste följa din projektspecifika mall. För att ladda ner maintain-import-template.csv:

Navigera till Aktiviteter och välj Lägg till aktivitet.
Välj Importera aktiviteter.
Välj Ladda ner mall.

Fyll i CSV-filens mall

CSV-mallen kommer endast att innehålla en enda rad av värden som representerar de möjliga värdena du kan ange för en importerad aktivitet. Denna rad kallas rubrikrad och bör inte tas bort när du fyller i mallen.

Även om rubrik raden inte får tas bort, kan du ta bort specifika värden från rubriken eller ändra ordningen på värdena. Till exempel, om ett visst fält inte är relevant att importera i ett specifikt scenario, kan du ta bort det från rubriken och de efterföljande raderna. Detta kommer att resultera i att fältet lämnas tomt på alla importerade aktiviteter.

För att importera en enda aktivitet, lägg till en ny rad i mallen och ange de lämpliga värdena åtskilda av kommatecken. Varje värde i den nya raden bör innehålla det värde du vill fylla i på den respektive rubrikrad som angavs i mallen. Om din mall till exempel innehåller följande rubrikrad: title,status,department, skapa en CSV-fil med en ytterligare rad:

title,status,department
Erect scaffolding,Done,Rigging

Du kommer att skapa en aktivitet med titeln “Resa ställningar”, status “Klart” och avdelning “Riggning” när den importeras.

Formatera datumfält

Vissa aktivitetsfält i Maintain representerar datum och måste ha ett specifikt format för att kunna importeras korrekt. Datumsfält kan identifieras i CSV-mallen genom ett särskilt rubrikvärde i formen startTime (DD/MM/YYYY). I det här exemplet är startTime namnet på fältet, medan DD/MM/YYYY är datumformatet som måste användas i efterföljande rader i CSV-filen. Om du till exempel importerar följande fil kommer aktiviteten att skapas med startTime inställt på 10 december 2023.

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

Formatera booleanfält

Vissa aktivitetsfält i Maintain representerar booleska värden, såsom true eller false. Booleska fält kan identifieras i CSV-mallen genom ett särskilt rubrikvärde i formen isActive (true/false). Dessa fält har endast två giltiga värden, true eller false. Till exempel kommer import av följande fil att resultera i att aktiviteten skapas med isActive inställt på false.

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

Formatera värden som innehåller kommatecken

Eftersom CSV-formatet separerar värden med kommatecken, var försiktig när ett aktivitetsfält också behöver innehålla ett kommatecken. Maintain bearbetar CSV-filer enligt RFC 4180-standarden, vilket kräver att värden som innehåller kommatecken omsluts av dubbla citattecken. Till exempel kommer import av följande fil att resultera i att aktiviteten skapas med city inställt på Boston, MA.

title,city
Erect scaffolding,"Boston, MA"

Oinställda värden

Du kan lämna fältet tomt på icke-obligatoriska aktivitetsfält för att representera saknade eller irrelevanta värden för den specifika aktiviteten. Till exempel kommer import av följande fil att resultera i att aktiviteten skapas med state inställt på New York, men den kommer inte att ha något värde i fältet city.

title,city,state
Erect scaffolding,New York

Koppla en aktivitet till en tillgång

Maintain stöder länkning av aktiviteter till CDF-tillgångar, vilket används för att kontextualisera aktiviteten i 3D-modeller, dokument, PSN med mera. För att Maintain ska skapa lämplig länk till en tillgång i CDF, måste du ange CDF-tillgångens externa ID i importmallen. Om du har tillgångskontextualisering i ditt projekt kommer det att finnas ett speciellt assetExternalId-fält i mallen som du behöver fylla i med det externa ID:t för aktivitetens tillgång. Till exempel, när du importerar följande fil och förutsätter att en CDF-tillgång finns med externt ID NY_BUILDING_23, kommer aktiviteten att kontextualiseras till denna tillgång när den matas in i Maintain.

title,assetExternalId
Erect scaffolding,NY_BUILDING_23

Om det angivna externa ID:t inte exporteras, kommer användaren att se ett fel under importen.

Slutanvändare kanske inte känner till det externa ID:t för den tillgång som aktiviteten är kopplad till. Om det är nödvändigt att förse slutanvändare med en lista över möjliga tillgångar och deras externa ID:n, rekommenderar vi att du hämtar denna data med hjälp av CDFs tillgångs-API eller andra dataextraktorer.

Importera en ifylld CSV-fil

När du har en ifylld CSV-mall kan du importera den till Maintain:

Navigera till Aktiviteter > Lägg till aktivitet.
Välj Importera aktiviteter.
Välj fältet Klicka för att välja CSV-fil att importera.
Välj och ladda upp den ifyllda CSV-filen från din dator.
Verifiera att du har importerat filen genom att kontrollera avsnittet Filinspektör. Ett grönt meddelande ska visa antalet rader som ska importeras och om du har några varningar eller fel.
Om det inte finns några fel, välj Importera för att starta importprocessen.
När importen lyckas ser du ett grönt meddelande om att det lyckades med knappen Visa aktiviteter.
Valfritt. Välj Visa aktiviteter för att navigera till de importerade aktiviteterna och kontrollera att de ser korrekta ut enligt CSV-filen.

Importera via Cognite Toolkit

Lägestillgänglighet: APM och IDM/CDM-lägen. Detta är den rekommenderade metoden för programmatisk aktivitetstillförsel.

Använd Cognite Toolkit för att mata in aktiviteter genom CDFs datamodelleringsfunktioner. Denna metod fungerar för båda distributionslägena och ger versionskontroll och reproducerbara distributioner.

Förutsättningar

Innan du importerar aktiviteter via Cognite Toolkit, se till att du har:

En anpassad aktivitetsvy konfigurerad i ditt datamodellutrymme (eller använd standardvyn CogniteMaintenanceOrder från cdf_idm)
Aktivitetsvyn mappad i din Maintain-konfiguration under viewMappings
Åtkomst till Cognite Toolkit

Konfigurera aktivitetsvy-mappningen

I din Maintain konfiguration, verifiera att viewMappings sektionen pekar på din aktivitetsvy:

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

Om du har skapat en anpassad aktivitetsvy (till exempel APM_Activity eller ExtendedActivity), uppdatera mappningen så att den pekar på din anpassade vy:

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

Läs mer om att utöka datamodeller och att konfigurera vymappningar.

Mata in aktiviteter med Cognite Toolkit

Använd Cognite Toolkit som den rekommenderade metoden för att mata in aktiviteter i IDM-läge.

Skapa aktivitetsdatastrukturen

Om du inte redan har gjort det, skapa Container-, View- och Node YAML-filer för dina aktiviteter. Följ den standardiserade datamodelleringsstrukturen:

APM_Activity.Container.yaml - Definierar containerschemat
APM_Activity.View.yaml - Definierar vyns egenskaper och relationer
apmActivities.Node.yaml - Innehåller dina aktivitetsinstanser Se Cognite Toolkit dokumentationen för detaljerade exempel och mallar.

Konfigurera fältmappningar

Säkerställ att dina aktivitetsnoder inkluderar de obligatoriska fälten för Maintain:

Fält	Beskrivning	Obligatoriskt
`externalId`	Unik identifierare för aktiviteten	Ja
`title`	Aktivitetstitel	Ja
`status`	Aktivitetsstatus (till exempel “Öppen”, “Pågår”, “Klar”)	Rekommenderad
`startTime`	Startdatum/-tid	Rekommenderad
`endTime`	Slutdatum/-tid	Rekommenderad
`rootLocation`	Identifierare för rotplats	Rekommenderad
`assetExternalId`	Externt ID för länkad tillgång	Valfritt
`mainAsset`	Direkt relation till tillgång	Valfritt

Inkludera ytterligare fält baserat på dina fältkonfigurationsinställningar i Maintain.

Distribuera aktiviteterna

Distribuera din aktivitetsdata med Cognite Toolkit:

cdf deploy --env dev

Använd flaggan --drop-data om du behöver ersätta befintliga aktiviteter:

cdf deploy --env dev --drop-data

Läs mer om Cognite Toolkit deployment flags.

Verifiera i Maintain

Logga in på Maintain.
Navigera till Aktiviteter.
Verifiera att dina importerade aktiviteter visas med korrekt data.

Ingestera aktiviteter med Transformationer

Lägestillgänglighet: APM och IDM/CDM-lägen. Detta är den rekommenderade metoden för bulkdata.

Alternativt kan du använda CDF Transformationer för att konvertera data från RAW-tabeller eller andra källor till aktivitetsnoder.

Felsökning

Om du stöter på problem med aktiviteter efter ingestion, se tabellen för orsaker och lösningar.

Problem	Lösning
Aktiviteter syns inte	Verifiera att `viewMappings`-konfigurationen pekar på rätt space, vy och version
Saknade fält	Kontrollera att din fältkonfiguration inkluderar alla fält du matar in
Trasiga tillgångslänkar	Säkerställ att `assetExternalId`- eller `mainAsset`-relationer pekar på befintliga tillgångar
Fel rotplats	Verifiera att `rootLocation` matchar din platskonfiguration

Flows

InField

Maintain

Externa resurser

Importera aktiviteter till Maintain

Importera via CSV-uppladdning (APM-läge)

Formatera datumfält

Formatera booleanfält

Formatera värden som innehåller kommatecken

Oinställda värden

Koppla en aktivitet till en tillgång

Importera via Cognite Toolkit

Förutsättningar

Konfigurera aktivitetsvy-mappningen

Mata in aktiviteter med Cognite Toolkit

Ingestera aktiviteter med Transformationer

Felsökning

​Importera via CSV-uppladdning (APM-läge)

​Formatera datumfält

​Formatera booleanfält

​Formatera värden som innehåller kommatecken

​Oinställda värden

​Koppla en aktivitet till en tillgång

​Importera via Cognite Toolkit

​Förutsättningar

​Konfigurera aktivitetsvy-mappningen

​Mata in aktiviteter med Cognite Toolkit

​Ingestera aktiviteter med Transformationer

​Felsökning

Importera via CSV-uppladdning (APM-läge)

Formatera datumfält

Formatera booleanfält

Formatera värden som innehåller kommatecken

Oinställda värden

Koppla en aktivitet till en tillgång

Importera via Cognite Toolkit

Förutsättningar

Konfigurera aktivitetsvy-mappningen

Mata in aktiviteter med Cognite Toolkit

Ingestera aktiviteter med Transformationer

Felsökning