Importer aktiviteter til Vedlikehold

Vedlikehold støtter tre metoder for import av aktiviteter:

CSV opplasting: Importer aktiviteter ved hjelp av brukergrensesnittet (kun APM-modus).
Cognite Toolkit: Ingest aktiviteter ved hjelp av Cognite Toolkit datamodellering (APM- og IDM/CDM-modus).
Transformasjoner: Konverter data fra RAW-tabeller eller andre kilder ved hjelp av CDF Transformasjoner (APM- og IDM/CDM-modus).

Importer via CSV opplasting (APM-modus)

Modus tilgjengelighet: 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 Vedlikehold.

Last ned CSV-filmalen

Den importerte CSV-filen må overholde din prosjektspesifikke mal. For å laste ned maintain-import-template.csv:

Naviger til Aktiviteter og velg Legg til aktivitet.
Velg Importer aktiviteter.
Velg Last ned mal.

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 header rad ikke må fjernes, kan du fjerne spesifikke verdier fra headeren 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. For eksempel, hvis malen din inneholder følgende header-rad: tittel,status,avdeling, opprett en CSV-fil med en ekstra rad:

tittel,status,avdeling
Bygg stillas,Utført,Rigging

Du vil opprette en aktivitet med tittelen “Bygg stillas”, status “Utført,” og avdeling “Rigging” når den importeres.

Formater datofelt

Noen aktivitetsfelt i Vedlikehold representerer datoer og må ha et spesifikt format for å bli riktig importert. Datofelt kan identifiseres i CSV-malen ved en spesiell headerverdi i formen startTid (DD/MM/YYYY). I dette eksemplet er startTid navnet på feltet, mens DD/MM/YYYY er datoformatet som må brukes i påfølgende rader i CSV-filen. For eksempel, importering av følgende fil vil resultere i at aktiviteten blir opprettet med startTid satt til 10. desember 2023.

tittel,startTid (DD/MM/YYYY)
Bygg stillas,10/12/2023

Formater boolske felt

Noen aktivitetsfelt i Vedlikehold representerer boolske verdier, som ja eller nei. Boolske felt kan identifiseres i CSV-malen ved en spesiell headerverdi i formen erAktiv (ja/nei). Disse feltene har kun to gyldige verdier, ja eller nei. For eksempel, importering av følgende fil vil resultere i at aktiviteten blir opprettet med erAktiv satt til nei.

tittel,erAktiv (sann/usann)
Oppsett av stillas,falsk

Formater verdier som inneholder komma

På grunn av CSV-formatet som skiller verdier med komma, vær forsiktig når et aktivitetsfelt også må inneholde et komma. Oppretthold prosesser CSV-filer i henhold til RFC 4180-standarden, som krever at verdier som inneholder komma må være omsluttet av doble anførselstegn. For eksempel, import av følgende fil vil resultere i at aktiviteten blir opprettet med by satt til Boston, MA.

tittel,by
Oppsett av stillas,"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, import av følgende fil vil resultere i at aktiviteten blir opprettet med stat satt til New York, men den vil ikke ha noen verdi i by feltet.

tittel,by,stat
Oppsett av stillas,New York

Koble en aktivitet til en ressurs

Oppretthold støtter kobling av aktiviteter til CDF-ressurser, som brukes til å kontekstualisere aktiviteten i 3D-modeller, dokumenter, PSN og mer. For at Oppretthold skal opprette den riktige koblingen til en ressurs i CDF, må du oppgi den eksterne ID-en til CDF-ressursen i importmalen. Hvis du har ressurs-kontekstualisering i prosjektet ditt, vil det være et spesialfelt ressursEksternId 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 forutsetter at en CDF-ressurs eksisterer med ekstern ID NY_BYGNING_23, vil aktiviteten bli kontekstualisert til denne ressursen når den blir importert til Oppretthold.

tittel,ressursEksternId
Oppsett av stillas,NY_BYGNING_23

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 å hente disse dataene ved hjelp av CDFs ressurs API eller andre datauttrekkere.

Importer en utfylt CSV-fil

Når du har en utfylt CSV-mal, kan du importere den til Oppretthold:

Naviger til Aktiviteter > Legg til aktivitet.
Velg Importer aktiviteter.
Velg Klikk for å velge CSV-fil for import feltet.
Velg og last opp den utfylte CSV-filen fra datamaskinen din.
Bekreft at du har importert filen ved å sjekke Filinspektør seksjonen. En grønn melding skal vise antall rader som skal importeres og om du har noen advarsler eller feil.
Hvis det ikke er noen feil, velg Importer for å starte importprosessen.
Når importen lykkes, vil du se en grønn suksessmelding med Vis aktiviteter knappen.
Valgfritt. Velg Vis aktiviteter for å navigere til de importerte aktivitetene og sjekke at de ser riktige ut i henhold til CSV-filen.

Importer via Cognite Toolkit

Modus tilgjengelighet: APM- og IDM/CDM-modusene. Dette er den anbefalte tilnærmingen for programmatisk aktivitetsoverføring.

Bruk Cognite Toolkit for å overføre aktiviteter gjennom CDFs datamodelleringskapabiliteter. 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 den standard CogniteMaintenanceOrder visningen fra cdf_idm)
Aktivitetsvisningen kartlagt i din Maintain-konfigurasjon under viewMappings
Tilgang til Cognite Toolkit

Konfigurer aktivitetsvisningskartlegging

I din Maintain-konfigurasjon, bekreft at viewMappings seksjonen peker til aktivitetsvisningen din:

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

Hvis du har opprettet en tilpasset aktivitetsvisning (for eksempel APM_Activity eller ExtendedActivity), oppdater kartleggingen til å peke på din tilpassede visning:

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

Lær mer om utvidelse av datamodeller og konfigurering av visningskartlegginger.

Ingest aktiviteter med Cognite Toolkit

Bruk Cognite Toolkit som den anbefalte metoden for å importere aktiviteter i IDM-modus.

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 containerskjemaet
APM_Activity.View.yaml - Definerer visningsegenskaper og relasjoner
apmActivities.Node.yaml - Inneholder aktivitetene dine Se Cognite Toolkit-dokumentasjonen for detaljerte eksempler og maler.

Konfigurer feltmappinger

Sørg for at aktivitetene dine inkluderer de nødvendige feltene for Vedlikehold:

Felt	Beskrivelse	Påkrevd
`externalId`	Unik identifikator for aktiviteten	Ja
`tittel`	Aktivitetstittel	Ja
`status`	Aktivitetens status (for eksempel, “Åpen”, “Under behandling”, “Ferdig”)	Anbefalt
`startTime`	Startdato/tid	Anbefalt
`endTime`	Sluttdato/tid	Anbefalt
`rootLocation`	Rotlokasjonsidentifikator	Anbefalt
`assetExternalId`	Ekstern ID for tilknyttede eiendeler	Valgfritt
`mainAsset`	Direkte relasjon til eiendel	Valgfritt

Inkluder ytterligere felt basert på dine Feltkonfigurasjon innstillinger i Vedlikehold.

Distribuer aktivitetene

Distribuer aktivitetsdataene dine ved hjelp av Cognite Toolkit:

cdf deploy --env dev

Bruk --drop-data flagget hvis du trenger å erstatte eksisterende aktiviteter:

cdf deploy --env dev --drop-data

Lær mer om Cognite Toolkit distribusjonsflagg.

Verifiser i Maintain

Logg inn på Vedlikehold.
Naviger til Aktiviteter.
Bekreft at de importerte aktivitetene vises med riktig data.

Ingest aktiviteter med transformasjoner

Modus tilgjengelighet: APM- og IDM/CDM-modusene. Dette er den anbefalte tilnærmingen for stordata.

Alternativt kan du bruke CDF Transformasjoner for å 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.

Problem	Løsning
Aktiviteter ikke synlige	Bekreft at `viewMappings` konfigurasjonen peker til riktig rom, visning og versjon
Manglende felt	Sjekk at din feltkonfigurasjon inkluderer alle feltene du inntar
Ødelagte eiendelkoblinger	Sørg for at `assetExternalId` eller `mainAsset` relasjoner peker til eksisterende eiendeler
Feil rotplassering	Bekreft at `rootLocation` samsvarer med din plasseringkonfigurasjon

​Importer via CSV opplasting (APM-modus)

​Formater datofelt

​Formater boolske felt

​Formater verdier som inneholder komma

​Fjernede verdier

​Koble en aktivitet til en ressurs

​Importer via Cognite Toolkit

​Forutsetninger

​Konfigurer aktivitetsvisningskartlegging

​Ingest aktiviteter med Cognite Toolkit

​Ingest aktiviteter med transformasjoner

​Feilsøking

Importer via CSV opplasting (APM-modus)

Formater datofelt

Formater boolske felt

Formater verdier som inneholder komma

Fjernede verdier

Koble en aktivitet til en ressurs

Importer via Cognite Toolkit

Forutsetninger

Konfigurer aktivitetsvisningskartlegging

Ingest aktiviteter med Cognite Toolkit

Ingest aktiviteter med transformasjoner

Feilsøking