> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importer aktiviteter til Vedlikehold

> Lær hvordan du importerer aktiviteter ved hjelp av brukergrensesnittet (APM-modus), Cognite Toolkit eller Transformasjoner.

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](/cdf/deploy/cdf_toolkit/) datamodellering (APM- og IDM/CDM-modus).
* **Transformasjoner**: Konverter data fra RAW-tabeller eller andre kilder ved hjelp av [CDF Transformasjoner](/cdf/integration/) (APM- og IDM/CDM-modus).

## Importer via CSV opplasting (APM-modus)

<Info>
  **Modus tilgjengelighet**: Kun APM-modus. IDM/CDM-modus støtter ikke CSV-import i brukergrensesnittet.
</Info>

Aktiviteter importert via CSV kan visualiseres og endres som aktiviteter opprettet i Vedlikehold.

<Steps>
  <Step title="Last ned CSV-filmalen">
    Den importerte CSV-filen må overholde din prosjektspesifikke mal. For å laste ned **maintain-import-template.csv**:

    1. Naviger til **Aktiviteter** og velg **Legg til aktivitet**.
    2. Velg **Importer aktiviteter**.
    3. Velg **Last ned mal**.
  </Step>

  <Step title="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.

    <Tip>
      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.
    </Tip>

    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:

    ```csv theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    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.

    <a id="format-date-fields" />

    ### 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.

    ```csv theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    tittel,startTid (DD/MM/YYYY)
    Bygg stillas,10/12/2023
    ```

    <a id="format-boolean-fields" />

    ### 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`.

    ```csv theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    tittel,erAktiv (sann/usann)
    Oppsett av stillas,falsk
    ```

    <a id="format-values-containing-commas" />

    ### 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](https://www.rfc-editor.org/rfc/rfc4180), 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`.

    ```csv theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    tittel,by
    Oppsett av stillas,"Boston, MA"
    ```

    <a id="unset-values" />

    ### 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.

    ```csv theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    tittel,by,stat
    Oppsett av stillas,New York
    ```

    <a id="connect-an-activity-to-an-asset" />

    ### 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.

    ```csv theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    tittel,ressursEksternId
    Oppsett av stillas,NY_BYGNING_23
    ```

    Hvis den oppgitte eksterne ID-en ikke eksporteres, vil brukeren se en feil under import.

    <Tip>
      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](/api-reference/concepts/20230101/assets) eller andre datauttrekkere.
    </Tip>
  </Step>

  <Step title="Importer en utfylt CSV-fil">
    Når du har en utfylt CSV-mal, kan du importere den til **Oppretthold**:

    1. Naviger til **Aktiviteter** > **Legg til aktivitet**.
    2. Velg **Importer aktiviteter**.
    3. Velg **Klikk for å velge CSV-fil for import** feltet.
    4. Velg og last opp den utfylte CSV-filen fra datamaskinen din.
    5. 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.
    6. Hvis det ikke er noen feil, velg **Importer** for å starte importprosessen.
    7. Når importen lykkes, vil du se en grønn suksessmelding med **Vis aktiviteter** knappen.
    8. Valgfritt. Velg **Vis aktiviteter** for å navigere til de importerte aktivitetene og sjekke at de ser riktige ut i henhold til CSV-filen.
  </Step>
</Steps>

## Importer via Cognite Toolkit

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

Bruk [Cognite Toolkit](/cdf/deploy/cdf_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](/cdf/deploy/cdf_toolkit/)

### Konfigurer aktivitetsvisningskartlegging

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

```json theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
{
  "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:

```json theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
{
  "viewMappings": {
    "activity": {
      "type": "view",
      "space": "maintain_schema_extention",
      "version": "v1",
      "externalId": "APM_Activity"
    }
  }
}
```

Lær mer om [utvidelse av datamodeller](/cdf/maintain/guides/config#extend-data-models) og [konfigurering av visningskartlegginger](/cdf/maintain/guides/config#view-mappings).

### Ingest aktiviteter med Cognite Toolkit

Bruk [Cognite Toolkit](/cdf/deploy/cdf_toolkit/) som den anbefalte metoden for å importere aktiviteter i IDM-modus.

<Steps>
  <Step title="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](/cdf/deploy/cdf_toolkit/) for detaljerte eksempler og maler.
  </Step>

  <Step title="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 |

    <Tip>
      Inkluder ytterligere felt basert på dine [Feltkonfigurasjon](/cdf/maintain/guides/config#field-configuration) innstillinger i Vedlikehold.
    </Tip>
  </Step>

  <Step title="Distribuer aktivitetene">
    Distribuer aktivitetsdataene dine ved hjelp av Cognite Toolkit:

    ```bash theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    cdf deploy --env dev
    ```

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

    ```bash theme={"languages":{"custom":["/_languages/kuiper.json","../_languages/kuiper.json"]}}
    cdf deploy --env dev --drop-data
    ```

    Lær mer om [Cognite Toolkit distribusjonsflagg](/cdf/maintain/guides/config#critical-deployment-flags).
  </Step>

  <Step title="Verifiser i Maintain">
    1. Logg inn på [Vedlikehold](https://maintain.cogniteapp.com).
    2. Naviger til **Aktiviteter**.
    3. Bekreft at de importerte aktivitetene vises med riktig data.
  </Step>
</Steps>

### Ingest aktiviteter med transformasjoner

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

Alternativt kan du bruke [CDF Transformasjoner](/cdf/integration/) 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                         |