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

# Importēt aktivitātes programmā Maintain

> Uzziniet, kā importēt aktivitātes, izmantojot lietotāja saskarni (APM režīms), Cognite Toolkit vai Transformācijas.

Maintain atbalsta trīs metodes aktivitāšu importēšanai:

* **CSV augšupielāde**: Importēt aktivitātes, izmantojot lietotāja saskarni (tikai APM režīms).
* **Cognite Toolkit**: Iegūt aktivitātes, izmantojot [Cognite Toolkit](/cdf/deploy/cdf_toolkit/) datu modelēšanu (APM un IDM/CDM režīmi).
* **Transformācijas**: Pārveidot datus no RAW tabulām vai citiem avotiem, izmantojot [CDF Transformations](/cdf/integration/) (APM un IDM/CDM režīmi).

## Importēt, izmantojot CSV augšupielādi (APM režīms)

<Info>
  **Režīma pieejamība**: Tikai APM režīms. IDM/CDM režīms neatbalsta CSV importu lietotāja saskarnē.
</Info>

CSV veidā importētās aktivitātes var vizualizēt un modificēt kā aktivitātes, kas izveidotas programmā Maintain.

<Steps>
  <Step title="Lejupielādējiet CSV faila veidni">
    Importētajam CSV failam jāatbilst jūsu projekta specifiskajam veidam. Lai lejupielādētu **maintain-import-template.csv**:

    1. Pārejiet uz **Aktivitātes** un izvēlieties **Pievienot aktivitāti**.
    2. Izvēlieties **Importēt aktivitātes**.
    3. Izvēlieties **Lejupielādēt veidni**.
  </Step>

  <Step title="Aizpildiet CSV faila veidni">
    CSV veidne saturēs tikai vienu rindu ar vērtībām, kas attēlo iespējamos vērtības, kuras varat sniegt importētai aktivitātei. Šī rinda tiek saukta par galvenes rindu un to nedrīkst noņemt, aizpildot veidni.

    <Tip>
      Lai gan galvene **rinda** nedrīkst tikt noņemta, jūs varat noņemt konkrētas vērtības no galvenes vai mainīt vērtību secību. Piemēram, ja noteikts lauks nav būtisks importēšanai konkrētā scenārijā, jūs varat to noņemt no galvenes un sekojošajām rindām. Tas rezultēs tajā, ka lauks visās importētajās aktivitātēs paliks tukšs.
    </Tip>

    Lai importētu vienu aktivitāti, pievienojiet jaunu rindu veidnei un ievadiet atbilstošās vērtības, kas atdalītas ar komatiem. Katram vērtībai jaunajā rindā jāietver vērtība, ko vēlaties aizpildīt attiecīgajā galvenes rindā, kas tika sniegta veidnē.

    Piemēram, ja jūsu veidne satur sekojošo galvenes rindu: `nosaukums,status,departaments`, izveidojiet CSV failu ar papildu rindu:

    ```
    nosaukums,status,departaments
    Uzstādīt skatuves,Izpildīts,Rigging
    ```

    Importējot, jūs izveidosiet aktivitāti ar nosaukumu "Uzstādīt skatuves", statusu "Izpildīts" un departamentu "Rigging".

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

    ### Formatējiet datuma laukus

    Daži aktivitāšu lauki **Maintain** attēlo datumus un tiem jābūt noteiktā formātā, lai tos varētu pareizi importēt. Datuma lauki CSV veidnē var tikt identificēti ar īpašu galvenes vērtību formā `sākumaLaiks (DD/MM/GGGG)`. Šajā piemērā `sākumaLaiks` ir lauka nosaukums, bet `DD/MM/GGGG` ir datuma formāts, kas jāizmanto sekojošajās CSV faila rindās.

    Piemēram, importējot sekojošo failu, rezultāts būs aktivitātes izveide ar `sākumaLaiks`, kas iestatīts uz 2023. gada 10. decembri.

    ```
    nosaukums,sākumaLaiks (DD/MM/GGGG)
    Uzstādīt skatuves,10/12/2023
    ```

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

    ### Formatējiet loģiskos laukus

    Daži aktivitāšu lauki **Maintain** attēlo loģiskās vērtības, piemēram, `patiesi` vai `nepatiesi`. Loģiskie lauki CSV veidnē var tikt identificēti ar īpašu galvenes vērtību formā `irAktīvs (patiesi/nepatiesi)`. Šiem laukiem ir tikai divas derīgas vērtības, `patiesi` vai `nepatiesi`.

    Piemēram, importējot sekojošo failu, rezultāts būs aktivitātes izveide ar `irAktīvs`, kas iestatīts uz `nepatiesi`.

    ```
    nosaukums,irAktīvs (patiesi/nepatiesi)
    Uzstādīt skatuves,nepatiesi
    ```

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

    ### Formatējiet vērtības, kas satur komatus

    Ņemiet vērā, ka CSV formāts atdala vērtības, izmantojot komatus, tāpēc esiet uzmanīgi, ja aktivitātes laukam arī jāietver komats. **Maintain** apstrādā CSV failus saskaņā ar [RFC 4180 standartu](https://www.rfc-editor.org/rfc/rfc4180), kas prasa, lai vērtības, kas satur komatus, tiktu ietvertas dubultās pēdiņās.

    Piemēram, importējot šādu failu, aktivitāte tiks izveidota ar `pilsētu`, kas iestatīta uz `Boston, MA`.

    ```
    nosaukums,pilsēta
    Uzstādīt skatuves,"Boston, MA"
    ```

    <a id="unset-values" />

    ### Nekonfigurētas vērtības

    Jūs varat atstāt lauku tukšu neobligātajās aktivitātes laukos, lai attēlotu trūkstošas vai neatbilstošas vērtības konkrētajai aktivitātei.

    Piemēram, importējot šādu failu, aktivitāte tiks izveidota ar `statu`, kas iestatīta uz `Ņujorka`, bet tai nebūs vērtības `pilsētas` laukā.

    ```
    nosaukums,pilsēta,stāts
    Uzstādīt skatuves,Ņujorka
    ```

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

    ### Savienojiet aktivitāti ar aktīvu

    **Maintain** atbalsta aktivitāšu saistīšanu ar CDF aktīviem, kas tiek izmantoti, lai kontekstualizētu aktivitāti 3D modeļos, dokumentos, PSN un citur. Lai **Maintain** izveidotu atbilstošu saiti uz aktīvu CDF, jums jānorāda CDF aktīva ārējais ID importēšanas veidnē.

    Ja jūsu projektā ir aktīvu kontekstualizācija, veidnē būs īpašs `aktīvaĀrējaisId` lauks, kuru jums jāaizpilda ar aktivitātes aktīva ārējo ID.

    Piemēram, importējot šādu failu un pieņemot, ka CDF aktīvs pastāv ar ārējo ID `NY_BUILDING_23`, aktivitāte tiks kontekstualizēta šim aktīvam, kad tā tiks iekļauta Maintain.

    ```
    nosaukums,aktīvaĀrējaisId
    Uzstādīt skatuves,NY_BUILDING_23
    ```

    Ja norādītais ārējais ID netiek eksportēts, lietotājs importēšanas laikā redzēs kļūdu.

    <Tip>
      Beigu lietotāji var nezināt aktīva ārējo ID, ar kuru aktivitāte ir saistīta. Ja ir nepieciešams sniegt beigu lietotājiem iespējamo aktīvu un to ārējo ID sarakstu, mēs iesakām iegūt šos datus, izmantojot CDF [aktīvu API](/api-reference/concepts/20230101/assets) vai citus datu ekstraktorus.
    </Tip>
  </Step>

  <Step title="Importējiet aizpildītu CSV failu">
    Kad jums ir aizpildīta CSV veidne, jūs to varat importēt **Maintain**:

    1. Pārejiet uz **Aktivitātes** > **Pievienot aktivitāti**.
    2. Izvēlieties **Importēt aktivitātes**.
    3. Izvēlieties **Noklikšķiniet, lai izvēlētos CSV failu importēšanai** lauku.
    4. Izvēlieties un augšupielādējiet aizpildīto CSV failu no sava datora.
    5. Pārliecinieties, ka esat importējis failu, pārbaudot **Failu inspektors** sadaļu. Zaļā ziņa jāparāda ar importējamo rindu skaitu un, ja jums ir kādi brīdinājumi vai kļūdas.
    6. Ja nav kļūdu, izvēlieties **Importēt**, lai uzsāktu importēšanas procesu.
    7. Kad imports ir veiksmīgs, jūs redzēsiet zaļu panākumu ziņu ar **Rādīt aktivitātes** pogu.
    8. Pēc izvēles: Izvēlieties **Rādīt aktivitātes**, lai pārietu uz importētajām aktivitātēm un pārbaudītu, vai tās izskatās pareizi saskaņā ar CSV failu.
  </Step>
</Steps>

## Importēt, izmantojot Cognite Toolkit

<Info>
  **Režīma pieejamība**: APM un IDM/CDM režīmi. Šī ir ieteicamā pieeja programmatiskai aktivitāšu iekļaušanai.
</Info>

Izmantojiet [Cognite Toolkit](/cdf/deploy/cdf_toolkit/), lai iekļautu aktivitātes, izmantojot CDF datu modelēšanas iespējas. Šī metode darbojas abos izvietošanas režīmos un nodrošina versiju kontroli un reproducējamas izvietošanas.

### Prasības

Pirms aktivitāšu importēšanas, izmantojot Cognite Toolkit, pārliecinieties, ka jums ir:

* Pielāgota aktivitāšu skata konfigurācija jūsu datu modeļa telpā (vai izmantojiet standarta `CogniteMaintenanceOrder` skatu no `cdf_idm`)
* Aktivitāšu skats ir kartēts jūsu Maintain konfigurācijā sadaļā `viewMappings`
* Piekļuve [Cognite Toolkit](/cdf/deploy/cdf_toolkit/)

### Konfigurējiet aktivitāšu skata kartēšanu

Jūsu Maintain konfigurācijā pārliecinieties, ka `viewMappings` sadaļa norāda uz jūsu aktivitāšu skatu:

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

Ja esat izveidojis pielāgotu aktivitāšu skatu (piemēram, `APM_Activity` vai `ExtendedActivity`), atjauniniet kartējumu, lai norādītu uz savu pielāgoto skatu:

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

Uzziniet vairāk par [datu modeļu paplašināšanu](/cdf/maintain/guides/config#extend-data-models) un [skatu kartējumu konfigurēšanu](/cdf/maintain/guides/config#view-mappings).

### Iegūstiet aktivitātes ar Cognite Toolkit

Izmantojiet [Cognite Toolkit](/cdf/deploy/cdf_toolkit/) kā ieteicamo pieeju aktivitāšu iegūšanai IDM režīmā.

<Steps>
  <Step title="Izveidojiet aktivitāšu datu struktūru">
    Ja vēl neesat to izdarījis, izveidojiet konteineru, skatu un mezglu YAML failus savām aktivitātēm. Ievērojiet standarta datu modelēšanas struktūru:

    * `APM_Activity.Container.yaml` - Definē konteineru shēmu
    * `APM_Activity.View.yaml` - Definē skata īpašības un attiecības
    * `apmActivities.Node.yaml` - Satur jūsu aktivitāšu instancēm
      Skatiet [Cognite Toolkit dokumentāciju](/cdf/deploy/cdf_toolkit/) detalizētiem piemēriem un veidnēm.
  </Step>

  <Step title="Konfigurējiet lauku kartēšanu">
    Pārliecinieties, ka jūsu aktivitāšu mezgli ietver nepieciešamos laukus Maintain:

    | Lauks             | Apraksts                                                          | Nepieciešams |
    | ----------------- | ----------------------------------------------------------------- | ------------ |
    | `externalId`      | Unikāls identifikators aktivitātei                                | Jā           |
    | `title`           | Aktivitātes nosaukums                                             | Jā           |
    | `status`          | Aktivitātes statuss (piemēram, "Atvērts", "Procesā", "Izpildīts") | Ieteicams    |
    | `startTime`       | Sākuma datums/laiks                                               | Ieteicams    |
    | `endTime`         | Beigu datums/laiks                                                | Ieteicams    |
    | `rootLocation`    | Saknes atrašanās vietas identifikators                            | Ieteicams    |
    | `assetExternalId` | Saistītā aktīva ārējais ID                                        | Opcional     |
    | `mainAsset`       | Tieša attiecība uz aktīvu                                         | Opcional     |

    <Tip>
      Iekļaujiet papildu laukus, pamatojoties uz jūsu [laukuma konfigurācijas](/cdf/maintain/guides/config#field-configuration) iestatījumiem Maintain.
    </Tip>
  </Step>

  <Step title="Izvietojiet aktivitātes">
    Izvietojiet savus aktivitāšu datus, izmantojot Cognite Toolkit:

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

    Izmantojiet `--drop-data` karogu, ja jums ir nepieciešams aizstāt esošās aktivitātes:

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

    Uzziniet vairāk par [Cognite Toolkit izvietošanas karogiem](/cdf/maintain/guides/config#critical-deployment-flags).
  </Step>

  <Step title="Pārbaudiet sadaļā Maintain">
    1. Piesakieties [Maintain](https://maintain.cogniteapp.com).
    2. Pārejiet uz **Aktivitātēm**.
    3. Pārliecinieties, ka jūsu importētās aktivitātes parādās ar pareiziem datiem.
  </Step>
</Steps>

### Iegūstiet aktivitātes ar Transformācijām

<Info>
  **Režīma pieejamība**: APM un IDM/CDM režīmi. Šī ir ieteicamā pieeja lielapjoma datiem.
</Info>

Alternatīvi, jūs varat izmantot [CDF Transformācijas](/cdf/integration/), lai pārvērstu datus no RAW tabulām vai citiem avotiem par aktivitāšu mezgliem.

### Problēmu novēršana

Ja pēc iegūšanas rodas problēmas ar aktivitātēm, skatiet tabulu par cēloņiem un risinājumiem.

| Problēma                         | Risinājums                                                                                  |
| -------------------------------- | ------------------------------------------------------------------------------------------- |
| Aktivitātes nav redzamas         | Pārliecinieties, ka `viewMappings` konfigurācija norāda uz pareizo telpu, skatu un versiju  |
| Trūkstoši lauki                  | Pārbaudiet, vai jūsu Lauku konfigurācija ietver visus laukus, kurus jūs iegūstat            |
| Aktīvu saites pārtrauktas        | Pārliecinieties, ka `assetExternalId` vai `mainAsset` attiecības norāda uz esošiem aktīviem |
| Nepareiza saknes atrašanās vieta | Pārliecinieties, ka `rootLocation` atbilst jūsu atrašanās vietas konfigurācijai             |