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: Ingestera aktiviteter med hjälp av Cognite Toolkit datamodellering (APM- och IDM/CDM-lägen).
Transformationer: Konvertera data från RAW-tabeller eller andra källor med hjälp av CDF Transformationer (APM- och IDM/CDM-lägen).

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

Tillgänglighet av lägen: 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 modifieras 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.

Medan rubriken rad 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.Till exempel, om din mall innehåller följande rubrikrad: titel,status,avdelning, skapa en CSV-fil med en ytterligare rad:

titel,status,avdelning
Resa ställningar,Klart,Riggning

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 importeras korrekt. Datumfält kan identifieras i CSV-mallen genom ett speciellt rubrikvärde i formen startTid (DD/MM/YYYY). I detta exempel är startTid namnet på fältet, medan DD/MM/YYYY är datumformatet som måste användas i efterföljande rader i CSV-filen.Till exempel, import av följande fil kommer att resultera i att aktiviteten skapas med startTid inställt på 10 december 2023.

titel,startTid (DD/MM/YYYY)
Resa ställningar,10/12/2023

Formatera booleanfält

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

titel,ärAktiv (sant/falskt)
Resa ställningar,false

Formatera värden som innehåller kommatecken

På grund av CSV-formatet som 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, som kräver att värden som innehåller kommatecken ska omges av citattecken.Till exempel, att importera följande fil kommer att resultera i att aktiviteten skapas med stad inställt på Boston, MA.

titel,stad
Resa ställningar,"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, att importera följande fil kommer att resultera i att aktiviteten skapas med stat inställt på New York, men det kommer att sakna värde i stad fältet.

titel,stad,stat
Resa ställningar,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 och mer. För Maintain att skapa den lämpliga länken 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 särskilt 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 det externa ID:t NY_BUILDING_23, kommer aktiviteten att kontextualiseras till denna tillgång när den importeras till Maintain.

titel,assetExternalId
Resa ställningar,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 ge slutanvändare en lista över möjliga tillgångar och deras externa ID:n, rekommenderar vi att hämta dessa data med hjälp av CDF:s asset API eller andra datautdragare.

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 Klicka för att välja CSV-fil att importera fältet.
Välj och ladda upp den ifyllda CSV-filen från din dator.
Verifiera att du har importerat filen genom att kontrollera Filinspektör avsnittet. 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 påbörja importprocessen.
När importen lyckas, kommer du att se ett grönt framgångsmeddelande med Visa aktiviteter knappen.
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

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

Använd Cognite Toolkit för att tillföra aktiviteter genom CDF:s datamodelleringsmöjligheter. 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 den standard CogniteMaintenanceOrder vyn från cdf_idm)
Aktivitetsvyn mappad i din Maintain-konfiguration under viewMappings
Tillgång till Cognite Toolkit

Konfigurera aktivitetsvy-mappningen

I din Maintain-konfiguration, verifiera att viewMappings avsnittet 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 för att peka på din anpassade vy:

"viewMappings": {
  "activity": {
    "type": "view",
    "space": "maintain_schema_extention",
    "version": "v1",
    "externalId": "APM\_Activity"
  }
}

Lär dig mer om att utöka datamodeller och att konfigurera vy-mappningar.

Ingestera aktiviteter med Cognite Toolkit

Använd Cognite Toolkit som den rekommenderade metoden för att ingestera 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 vyegenskaper och relationer
apmActivities.Node.yaml - Innehåller dina aktivitetsinstanser Se Cognite Toolkit-dokumentationen för detaljerade exempel och mallar.

Konfigurera fältmappningar

Se till att dina aktivitetsnoder inkluderar de nödvändiga fälten för Maintain:

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

Inkludera ytterligare fält baserat på dina Fältkonfiguration inställningar i Maintain.

Distribuera aktiviteterna

Distribuera dina aktivitetsdata med Cognite Toolkit:

cdf deploy --env dev

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

cdf deploy --env dev --drop-data

Lär dig mer om Cognite Toolkit distributionsflaggor.

Verifiera i Maintain

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

Ingestera aktiviteter med Transformationer

Tillgänglighet av lägen: 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 utrymme, vy och version
Saknade fält	Kontrollera att din fältkonfiguration inkluderar alla fält du ingesterar
Trasiga tillgångslänkar	Se till att `assetExternalId` eller `mainAsset` relationer pekar på befintliga tillgångar
Fel rotplats	Verifiera att `rootLocation` matchar din platskonfiguration

​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

​Ingestera 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

Ingestera aktiviteter med Cognite Toolkit

Ingestera aktiviteter med Transformationer

Felsökning