Skip to main content
Maintain støtter tre metoder for import av aktiviteter:
  • CSV-opplasting: Importer aktiviteter ved hjelp av brukergrensesnittet (kun APM-modus).
  • Cognite Toolkit: Importere aktiviteter ved bruk av Cognite Toolkit datamodellering (APM- og IDM/CDM-moduser).
  • Transformasjoner: Konverter data fra RAW-tabeller eller andre kilder ved bruk av CDF transformasjoner (APM- og IDM/CDM-moduser).

​
Importer via CSV opplasting (APM-modus)

Modustilgjengelighet: Kun APM-modus. IDM/CDM-modus støtter ikke CSV-import i brukergrensesnittet.
Aktiviteter importert via CSV kan visualiseres og endres som aktiviteter opprettet i Maintain.
1

Last ned CSV-filmalen

Den importerte CSV-filen må overholde din prosjektspesifikke mal. Slik laster du ned maintain-import-template.csv:
  1. Naviger til Aktiviteter og velg Legg til aktivitet.
  2. Velg Importer aktiviteter.
  3. Velg Last ned mal.
2

Fyll ut CSV-filmalen

CSV-malen vil kun inneholde en enkelt rad med verdier som representerer de mulige verdiene du kan gi for en importert aktivitet. Denne raden kalles header-raden og bør ikke fjernes når du fyller ut malen.
Selv om overskriftsraden ikke må fjernes, kan du fjerne spesifikke verdier fra overskriften eller endre rekkefølgen på verdiene. For eksempel, hvis et bestemt felt ikke er relevant å importere i et spesifikt scenario, kan du fjerne det fra headeren og de påfølgende radene. Dette vil resultere i at feltet blir stående tomt på alle importerte aktiviteter.
For å importere en enkelt aktivitet, legg til en ny rad i malen og skriv inn de passende verdiene adskilt med komma. Hver verdi i den nye raden skal inneholde verdien du ønsker å fylle ut på den respektive header-raden som ble gitt i malen. Hvis malen din for eksempel inneholder følgende overskriftsrad: title,status,department, oppretter du en CSV-fil med en ekstra rad:
Du vil opprette en aktivitet med tittelen “Bygg stillas”, status “Utført,” og avdeling “Rigging” når den importeres.

​
Formater datofelt

Noen aktivitetsfelt i Maintain representerer datoer og må ha et spesifikt format for å bli importert på riktig måte. Datofelt kan identifiseres i CSV-malen ved en spesiell overskriftsverdi i formen startTime (DD/MM/YYYY). I dette eksemplet er startTime navnet på feltet, mens DD/MM/YYYY er datoformatet som må brukes i etterfølgende rader i CSV-filen. Import av følgende fil vil for eksempel føre til at aktiviteten opprettes med startTime satt til 10. desember 2023.

​
Formater boolske felt

Noen aktivitetsfelt i Maintain representerer boolske verdier, som true eller false. Bolske felt kan identifiseres i CSV-malen ved en spesiell overskriftsverdi i formen isActive (true/false). Disse feltene har bare to gyldige verdier, true eller false. For eksempel vil import av følgende fil føre til at aktiviteten opprettes med isActive satt til false.

​
Formater verdier som inneholder komma

Siden CSV-formatet skiller verdier med komma, må du være forsiktig når et aktivitetsfelt også må inneholde et komma. Maintain behandler CSV-filer i henhold til RFC 4180-standarden, som krever at verdier som inneholder komma, omsluttes av doble anførselstegn. For eksempel vil import av følgende fil føre til at aktiviteten opprettes med city satt til Boston, MA.

​
Fjernede verdier

Du kan la feltet stå tomt på ikke-obligatoriske aktivitetsfelt for å representere manglende eller irrelevante verdier for den spesifikke aktiviteten. For eksempel vil import av følgende fil føre til at aktiviteten opprettes med state satt til New York, men den vil ikke ha noen verdi i city-feltet.

​
Koble en aktivitet til en ressurs

Maintain støtter kobling av aktiviteter til CDF-ressurser, som brukes til å kontekstualisere aktiviteten i 3D-modeller, dokumenter, PSN og mer. For at Maintain skal kunne opprette riktig kobling til en ressurs i CDF, må du oppgi den eksterne ID-en til CDF-ressursen i importmalen. Hvis du har ressurskontekstualisering i prosjektet ditt, vil det være et spesielt assetExternalId-felt i malen som du må fylle ut med den eksterne ID-en til aktivitetens ressurs. For eksempel, når du importerer følgende fil og antar at en CDF-ressurs eksisterer med ekstern ID NY_BUILDING_23, vil aktiviteten bli kontekstualisert til denne ressursen når den hentes inn i Maintain.
Hvis den oppgitte eksterne ID-en ikke eksporteres, vil brukeren se en feil under import.
Sluttbrukere kjenner kanskje ikke den eksterne ID-en til ressursen som aktiviteten er koblet til. Hvis det er nødvendig å gi sluttbrukere en liste over mulige ressurser og deres eksterne ID-er, anbefaler vi at du henter disse dataene ved hjelp av CDFs ressurs-API eller andre datauttrekkere.
3

Importer en utfylt CSV-fil

Når du har en utfylt CSV-mal, kan du importere den til Maintain:
  1. Naviger til Aktiviteter > Legg til aktivitet.
  2. Velg Importer aktiviteter.
  3. Velg feltet Klikk for å velge CSV-fil som skal importeres.
  4. Velg og last opp den utfylte CSV-filen fra datamaskinen din.
  5. Bekreft at du har importert filen ved å sjekke delen Filinspektør. En grønn melding skal vise antall rader som skal importeres og om du har noen advarsler eller feil.
  6. Hvis det ikke er noen feil, velg Importer for å starte importprosessen.
  7. Når importen er fullført, vil du se en grønn suksessmelding med knappen Vis aktiviteter.
  8. Valgfritt. Velg Vis aktiviteter for å navigere til de importerte aktivitetene og kontrollere at de ser riktige ut i henhold til CSV-filen.

​
Importer via Cognite Toolkit

Modustilgjengelighet: APM- og IDM/CDM-modusene. Dette er den anbefalte tilnærmingen for programmatisk aktivitetsoverføring.
Bruk Cognite Toolkit for å hente inn aktiviteter gjennom CDFs datamodelleringsfunksjoner. Denne metoden fungerer for begge distribusjonsmoduser og gir versjonskontroll og reproduserbare distribusjoner.

​
Forutsetninger

Før du importerer aktiviteter via Cognite Toolkit, må du sørge for at du har:
  • En tilpasset aktivitetsvisning konfigurert i datamodellområdet ditt (eller bruk standard CogniteMaintenanceOrder-visning fra cdf_idm)
  • Aktivitetsvisningen tilordnet i Maintain-konfigurasjonen din under viewMappings
  • Tilgang til Cognite Toolkit

​
Konfigurer aktivitetsvisningskartlegging

I Maintain-konfigurasjonen din, bekreft at viewMappings-seksjonen peker til aktivitetsvisningen din:
Hvis du har opprettet en egendefinert aktivitetsvisning (for eksempel APM_Activity eller ExtendedActivity), oppdater tilordningen slik at den peker til den egendefinerte visningen din:
Lær mer om utvidelse av datamodeller og konfigurering av visningstilordninger.

​
Importer aktiviteter med Cognite Toolkit

Bruk Cognite Toolkit som anbefalt fremgangsmåte for innhenting av aktiviteter i IDM-modus.
1

Opprett datakonstruksjonen for aktiviteten

Hvis du ikke allerede har gjort det, opprett Container-, View- og Node YAML-filer for aktivitetene dine. Følg den standard datamodelleringsstrukturen:
  • APM_Activity.Container.yaml – Definerer beholderskjemaet
  • APM_Activity.View.yaml – Definerer visningsegenskapene og relasjonene
  • apmActivities.Node.yaml – Inneholder aktivitetsinstansene dine Se Cognite Toolkit-dokumentasjonen for detaljerte eksempler og maler.
2

Konfigurer feltmappinger

Sørg for at aktivitetsnodene dine inkluderer de påkrevde feltene for Maintain:
Inkluder tilleggsfelt basert på innstillingene for feltkonfigurasjon i Maintain.
3

Distribuer aktivitetene

Distribuer aktivitetsdataene dine ved hjelp av Cognite Toolkit:
Bruk --drop-data-flagget hvis du må erstatte eksisterende aktiviteter:
Lær mer om Cognite Toolkit distribusjonsflagg.
4

Verifiser i Maintain

  1. Logg på Maintain.
  2. Naviger til Aktiviteter.
  3. Bekreft at de importerte aktivitetene vises med riktig data.

​
Importer aktiviteter med transformasjoner

Modustilgjengelighet: APM- og IDM/CDM-modusene. Dette er den anbefalte tilnærmingen for stordata.
Alternativt kan du bruke CDF transformasjoner til å konvertere data fra RAW-tabeller eller andre kilder til aktivitetsnoder.

​
Feilsøking

Hvis du opplever problemer med aktiviteter etter inntak, se tabellen for årsaker og løsninger.
Sist endret 8. september 2026