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

# Importați activitățile în Maintain

> Învățați cum să importați activități folosind interfața utilizatorului (mod APM), Cognite Toolkit sau Transformări.

Maintain suportă trei metode pentru importarea activităților:

* **Încărcare CSV**: Importați activități folosind interfața utilizatorului (doar mod APM).
* **Cognite Toolkit**: Ingestați activități folosind modelarea datelor [Cognite Toolkit](/cdf/deploy/cdf_toolkit/) (modurile APM și IDM/CDM).
* **Transformări**: Convertiți datele din tabele RAW sau alte surse folosind [Transformările CDF](/cdf/integration/) (modurile APM și IDM/CDM).

## Importați prin încărcare CSV (mod APM)

<Info>
  **Disponibilitatea modului**: Doar mod APM. Modul IDM/CDM nu suportă importul CSV în interfața utilizatorului.
</Info>

Activitățile importate prin CSV pot fi vizualizate și modificate ca activitățile create în Maintain.

<Steps>
  <Step title="Descărcarea șablonului de fișier CSV">
    Fișierul CSV importat trebuie să se conformeze șablonului specific proiectului dumneavoastră. Pentru a descărca **maintain-import-template.csv**:

    1. Navigați la **Activități** și selectați **Adăugați activitate**.
    2. Selectați **Importați activități**.
    3. Selectați **Descărcați șablonul**.
  </Step>

  <Step title="Completarea șablonului de fișier CSV">
    Șablonul CSV va conține un singur rând cu tipurile de valori pe care le puteți introduce pentru o activitate importată. Acest rând poartă denumirea de rând de antet și trebuie păstrat la completarea șablonului.

    <Tip>
      Deși antetul **rând** nu trebuie eliminat, puteți elimina valori specifice din antet sau schimba ordinea valorilor. De exemplu, dacă un anumit câmp nu este relevant pentru a fi importat într-un anumit scenariu, îl puteți elimina din antet și din rândurile următoare. Astfel, câmpul va rămâne necompletat pentru toate activitățile importate.
    </Tip>

    Pentru a importa o singură activitate, adăugați un nou rând în șablon și introduceți valorile corespunzătoare, separate prin virgule. Fiecare valoare din rândul nou trebuie să conțină valoarea pe care doriți să o completați în rândul de antet corespunzător, inclus în șablon.

    De exemplu, dacă șablonul dumneavoastră conține următorul rând de antet: `titlu,status,departament`, creați un fișier CSV cu un rând suplimentar:

    ```
    titlu,status,departament
    Montați schele,Finalizat,Montaj
    ```

    Veți crea o activitate cu titlul „Montaj schele”, stadiul „Finalizat” și departamentul „Manevre” la importare.

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

    ### Formatarea câmpurilor de date

    Unele câmpuri de activitate din **Maintain** reprezintă date și trebuie să aibă un format specific pentru a fi importate corect. Câmpurile de date pot fi identificate în șablonul CSV printr-o valoare de antet specială în forma `startTime (ZZ/LL/AAAA)`. În acest exemplu, `startTime` este numele câmpului, în timp ce `ZZ/LL/AAAA` este formatul datei care trebuie utilizat în rândurile următoare ale fișierului CSV.

    De exemplu, importarea următorului fișier va rezulta în crearea activității cu `startTime` setat la 10 decembrie 2023.

    ```
    titlu,startTime (ZZ/LL/AAAA)
    Ridicați schele,10/12/2023
    ```

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

    ### Formatarea câmpurilor booleene

    Unele câmpuri de activitate din **Maintain** reprezintă valori booleene, cum ar fi `adevărat` sau `fals`. Câmpurile booleene pot fi identificate în șablonul CSV printr-o valoare de antet specială în forma `isActive (adevărat/fals)`. Aceste câmpuri au doar două valori valide, `adevărat` sau `fals`.

    De exemplu, importarea următorului fișier va rezulta în crearea activității cu `isActive` setat la `fals`.

    ```
    titlu,isActive (adevărat/fals)
    Ridicați schele,fals
    ```

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

    ### Formatarea valorilor care conțin virgule

    Datorită formatului CSV care separă valorile folosind virgule, fiți atenți atunci când un câmp de activitate trebuie să conțină și o virgulă. **Maintain** procesează fișiere CSV conform [standardului RFC 4180](https://www.rfc-editor.org/rfc/rfc4180), care necesită ca valorile care conțin virgule să fie înfășurate în ghilimele duble.

    De exemplu, importarea următorului fișier va rezulta în crearea activității cu `oraș` setat la `Boston, MA`.

    ```
    titlu,oraș
    Ridicați schele,"Boston, MA"
    ```

    <a id="unset-values" />

    ### Valori nesetate

    Puteți lăsa necompletate câmpurile care nu sunt obligatorii pentru a reflecta valori lipsă sau irelevante pentru activitatea respectivă.

    De exemplu, importarea următorului fișier va rezulta în crearea activității cu `stat` setat la `New York`, dar nu va avea nicio valoare în câmpul `oraș`.

    ```
    titlu,oraș,stat
    Ridicați schele,New York
    ```

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

    ### Conectarea unei activități la un activ

    **Maintain** suportă legarea activităților la active CDF, care este utilizată pentru a contextualiza activitatea în modele 3D, documente, PSN și altele. Pentru ca **Maintain** să creeze legătura corespunzătoare cu un activ în CDF, trebuie să furnizați ID-ul extern al activului CDF în șablonul de import.

    Dacă aveți contextualizare a activelor în proiectul dumneavoastră, va exista un câmp special `assetExternalId` în șablon pe care trebuie să-l completați cu ID-ul extern al activului activității.

    De exemplu, când importați următorul fișier și presupunând că există un activ CDF cu ID extern `NY_BUILDING_23`, activitatea va fi contextualizată la acest activ atunci când este preluată în Maintain.

    ```
    titlu,assetExternalId
    Ridicați schele,NY_BUILDING_23
    ```

    Dacă ID-ul extern furnizat nu se exportă, utilizatorul va vedea o eroare în timpul importării.

    <Tip>
      Utilizatorii finali s-ar putea să nu cunoască ID-ul extern al activului la care este legată activitatea. Dacă este necesar să oferiți utilizatorilor finali o listă a activelor posibile și a ID-urilor lor externe, vă recomandăm să recuperați aceste date folosind [API-ul activelor](/api-reference/concepts/20230101/assets) al CDF sau alte extratoarele de date.
    </Tip>
  </Step>

  <Step title="Importarea unui fișier CSV completat">
    Odată ce aveți un șablon CSV completat, îl puteți importa în **Maintain**:

    1. Navigați la **Activități** > **Adăugați activitate**.
    2. Selectați **Importați activități**.
    3. Selectați câmpul **Dați clic pentru a selecta fișierul CSV de importat**.
    4. Selectați și încărcați fișierul CSV completat din computer.
    5. Confirmați că ați importat fișierul verificând secțiunea **Inspector fișier**. Un mesaj verde ar trebui să afișeze numărul de rânduri care se vor importa, precum și dacă aveți avertismente sau erori.
    6. Dacă nu există erori, selectați **Importați** pentru a începe procesul de importare.
    7. Când importarea reușește, veți vedea un mesaj verde cu butonul **Afișați activitățile**.
    8. Opțional. Selectați **Afișați activitățile** pentru a naviga la activitățile importate și verificați că acestea arată corect conform fișierului CSV.
  </Step>
</Steps>

## Importați prin Cognite Toolkit

<Info>
  **Disponibilitatea modului**: Modurile APM și IDM/CDM. Aceasta este abordarea recomandată pentru ingestia programatică a activităților.
</Info>

Utilizați [Cognite Toolkit](/cdf/deploy/cdf_toolkit/) pentru a ingesta activități prin capacitățile de modelare a datelor ale CDF. Această metodă funcționează pentru ambele moduri de desfășurare și oferă control al versiunilor și desfășurări reproducibile.

### Cerințe preliminare

Înainte de a importa activități prin Cognite Toolkit, asigurați-vă că aveți:

* O vedere personalizată a activităților configurată în spațiul dvs. de modelare a datelor (sau utilizați vederea standard `CogniteMaintenanceOrder` din `cdf_idm`)
* Vederea activității mapată în configurația dvs. de Maintain sub `viewMappings`
* Acces la [Cognite Toolkit](/cdf/deploy/cdf_toolkit/)

### Configurați maparea vederii activității

În configurația dvs. de Maintain, verificați că secțiunea `viewMappings` indică spre vederea dvs. a activității:

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

Dacă ați creat o vedere personalizată a activității (de exemplu, `APM_Activity` sau `ExtendedActivity`), actualizați maparea pentru a indica spre vederea dvs. personalizată:

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

Aflați mai multe despre [extinderea modelelor de date](/cdf/maintain/guides/config#extend-data-models) și [configurarea mapărilor de vizualizare](/cdf/maintain/guides/config#view-mappings).

### Ingestați activitățile cu Cognite Toolkit

Utilizați [Cognite Toolkit](/cdf/deploy/cdf_toolkit/) ca abordare recomandată pentru a ingesta activități în modul IDM.

<Steps>
  <Step title="Creează structura de date pentru activitate">
    Dacă nu ați făcut-o deja, creați fișiere YAML pentru Container, View și Node pentru activitățile dumneavoastră. Urmați structura standard de modelare a datelor:

    * `APM_Activitate.Container.yaml` - Definește schema containerului
    * `APM_Activitate.View.yaml` - Definește proprietățile și relațiile vizualizării
    * `apmActivities.Node.yaml` - Conține instanțele activităților dumneavoastră
      Consultați [Cognite Toolkit documentația](/cdf/deploy/cdf_toolkit/) pentru exemple detaliate și șabloane.
  </Step>

  <Step title="Configurează mapările câmpurilor">
    Asigurați-vă că nodurile activității includ câmpurile necesare pentru Maintain:

    | Câmp              | Descriere                                                                 | Necesare   |
    | ----------------- | ------------------------------------------------------------------------- | ---------- |
    | `externalId`      | Identificator unic pentru activitate                                      | Da         |
    | `title`           | Titlul activității                                                        | Da         |
    | `status`          | Starea activității (de exemplu, "Deschis", "În desfășurare", "Finalizat") | Recomandat |
    | `startTime`       | Data/ora de început                                                       | Recomandat |
    | `endTime`         | Data/ora de sfârșit                                                       | Recomandat |
    | `rootLocation`    | Identificatorul locației rădăcină                                         | Recomandat |
    | `assetExternalId` | ID extern al activului legat                                              | Opțional   |
    | `mainAsset`       | Relație directă cu activul                                                | Opțional   |

    <Tip>
      Includeți câmpuri suplimentare pe baza setărilor dumneavoastră [Configurare Câmp](/cdf/maintain/guides/config#field-configuration) în Maintain.
    </Tip>
  </Step>

  <Step title="Dezvoltă activitățile">
    Implementați datele activității dumneavoastră folosind Cognite Toolkit:

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

    Utilizați `--drop-data` flag dacă trebuie să înlocuiți activitățile existente:

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

    Aflați mai multe despre [flag-urile de implementare Cognite Toolkit](/cdf/maintain/guides/config#critical-deployment-flags).
  </Step>

  <Step title="Verifică în Maintain">
    1. Conectați-vă la [Maintain](https://maintain.cogniteapp.com).
    2. Navigați la **Activități**.
    3. Verificați dacă activitățile importate apar cu datele corecte.
  </Step>
</Steps>

### Ingestați activitățile cu Transformări

<Info>
  **Disponibilitatea modului**: Modurile APM și IDM/CDM. Aceasta este abordarea recomandată pentru datele în vrac.
</Info>

Alternativ, puteți folosi [CDF Transformations](/cdf/integration/) pentru a converti datele din tabele RAW sau alte surse în noduri de activitate.

### Depanare

Dacă întâmpinați probleme cu activitățile după ingestie, consultați tabelul pentru cauze și soluții.

| Problemă                      | Soluție                                                                                       |
| ----------------------------- | --------------------------------------------------------------------------------------------- |
| Activitățile nu sunt vizibile | Verificați dacă configurația `viewMappings` indică spațiul, vizualizarea și versiunea corecte |
| Câmpuri lipsă                 | Verificați că Configurarea Câmpului include toate câmpurile pe care le ingestați              |
| Legăturile active sunt rupte  | Asigurați-vă că relațiile `assetExternalId` sau `mainAsset` indică active existente           |
| Locația rădăcină greșită      | Verificați dacă `rootLocation` se potrivește cu configurația locației dumneavoastră           |