Importați activitățile în Maintain

Maintain acceptă trei metode pentru importul activităților:

Încărcare CSV: Importați activități folosind interfața utilizatorului (doar mod APM).
Cognite Toolkit: Ingerați activități utilizând modelarea datelor Cognite Toolkit (modurile APM și IDM/CDM).
Transformări: Convertiți datele din tabele RAW sau din alte surse utilizând CDF Transformări (modurile APM și IDM/CDM).

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

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

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

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:

Navigați la Activități și selectați Adăugați activitate.
Selectați Importați activități.
Selectați Descărcați șablonul.

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.

Deși rândul de antet nu trebuie eliminat, puteți elimina valori specifice din antet sau puteți 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.

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 conține următorul rând de antet: title,status,department, creați un fișier CSV cu un rând suplimentar:

title,status,department
Erect scaffolding,Done,Rigging

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

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 specială a antetului, de forma startTime (DD/MM/YYYY). În acest exemplu, startTime este denumirea câmpului, în vreme ce DD/MM/YYYY este formatul de dată care trebuie folosit în rândurile următoare din fișierul CSV. De exemplu, importarea următorului fișier va avea ca rezultat crearea activității cu startTime setat la 10 decembrie 2023.

title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023

Formatarea câmpurilor booleene

Unele câmpuri de activitate din Maintain reprezintă valori booleene, cum ar fi true sau false. Câmpurile booleene pot fi identificate în șablonul CSV printr-o valoare specială de antet sub forma isActive (true/false). Aceste câmpuri pot conține doar două valori, true sau false. De exemplu, importarea următorului fișier va duce la crearea activității cu isActive având valoarea false.

title,isActive (true/false)
Erect scaffolding,false

Formatarea valorilor care conțin virgule

Deoarece formatul CSV separă valorile folosind virgule, aveți grijă atunci când un câmp de activitate trebuie să conțină și o virgulă. Maintain procesează fișierele CSV conform standardului RFC 4180, care impune ca valorile ce conțin virgule să fie incluse între ghilimele duble. De exemplu, importarea următorului fișier va duce la crearea activității cu city având valoarea Boston, MA.

title,city
Erect scaffolding,"Boston, MA"

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 determina crearea activității cu state având valoarea New York, dar fără să aibă nicio valoare în câmpul city.

title,city,state
Erect scaffolding,New York

Conectarea unei activități la un activ

Maintain acceptă legarea activităților de active CDF, ceea ce este utilizat pentru a contextualiza activitatea în modele 3D, documente, PSN și multe 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 contextualizări de active în proiectul dvs., va exista un câmp assetExternalId special în șablon pe care va trebui să-l completați cu ID-ul extern al activului activității. De exemplu, la importarea următorului fișier și presupunând că există un activ CDF cu ID-ul extern NY_BUILDING_23, activitatea va fi contextualizată la acest activ atunci când este preluată în Maintain.

title,assetExternalId
Erect scaffolding,NY_BUILDING_23

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

Utilizatorii finali s-ar putea să nu cunoască ID-ul extern al activului la care este legată activitatea. Dacă este necesar să furnizați utilizatorilor finali o listă cu activele posibile și ID-urile lor externe, vă recomandăm să preluați aceste date utilizând API-ul de active al CDF sau alți extractori de date.

Importarea unui fișier CSV completat

După ce aveți un șablon CSV completat, îl puteți importa în Maintain:

Navigați la Activități > Adăugați activitate.
Selectați Importați activități.
Selectați câmpul Dați clic pentru a selecta fișierul CSV de importat.
Selectați și încărcați fișierul CSV completat din computer.
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.
Dacă nu există erori, selectați Importați pentru a începe procesul de importare.
Când importarea reușește, veți vedea un mesaj verde cu butonul Afișați activitățile.
Opțional. Selectați Afișați activitățile pentru a naviga la activitățile importate și a vă asigura că arată corect conform fișierului CSV.

Import prin Cognite Toolkit

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

Utilizați Cognite Toolkit pentru a ingera 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 vizualizare personalizată a activității configurată în spațiul modelului dvs. de date (sau utilizați vizualizarea standard CogniteMaintenanceOrder din cdf_idm)
Vizualizarea activității mapată în configurația Maintain sub viewMappings
Acces la Cognite Toolkit

Configurați maparea vederii activității

În configurația Maintain, verificați dacă secțiunea viewMappings indică vizualizarea activității dvs.:

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

Dacă ați creat o vizualizare personalizată a activității (de exemplu, APM_Activity sau ExtendedActivity), actualizați maparea pentru a indica vizualizarea personalizată:

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

Aflați mai multe despre extinderea modelelor de date și configurarea mapărilor de vizualizare.

Ingerați activități cu Cognite Toolkit

Utilizați Cognite Toolkit ca abordare recomandată pentru ingerarea activităților în modul IDM.

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_Activity.Container.yaml - Definește schema containerului
APM_Activity.View.yaml - Definește proprietățile și relațiile vizualizării
apmActivities.Node.yaml - Conține instanțele activității dvs. Consultați documentația Cognite Toolkit pentru exemple și șabloane detaliate.

Configurează mapările câmpurilor

Asigurați-vă că nodurile de activitate includ câmpurile necesare pentru Maintain:

Field	Descriere	Obligatoriu
`externalId`	Identificator unic pentru activitate	Da
`title`	Titlul activității	Da
`status`	Starea activității (de exemplu, „Deschisă”, „În curs”, „Finalizată”)	Recomandat
`startTime`	Data/ora de început	Recomandat
`endTime`	Data/ora de sfârșit	Recomandat
`rootLocation`	Identificator locație rădăcină	Recomandat
`assetExternalId`	ID extern al activului legat	Opțional
`mainAsset`	Relație directă cu activul	Opțional

Includeți câmpuri suplimentare pe baza setărilor Configurare câmp din Maintain.

Dezvoltă activitățile

Implementați datele activității utilizând Cognite Toolkit:

cdf deploy --env dev

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

cdf deploy --env dev --drop-data

Aflați mai multe despre semnalizatoarele de implementare ale Cognite Toolkit.

Verifică în Maintain

Conectați-vă la Maintain.
Navigați la Activități.
Verificați dacă activitățile importate apar cu datele corecte.

Ingestați activitățile cu Transformări

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

Alternativ, puteți utiliza CDF Transformări pentru a converti datele din tabelele RAW sau din 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ăți nevizibile	Verificați dacă configurația `viewMappings` indică spațiul, vizualizarea și versiunea corecte
Câmpuri lipsă	Verificați ca Configurația câmpurilor dvs. să includă toate câmpurile pe care le ingerați
Linkuri către active întrerupte	Asigurați-vă că relațiile `assetExternalId` sau `mainAsset` indică active existente
Locație rădăcină incorectă	Verificați dacă `rootLocation` corespunde configurației locației dvs.

Flows

InField

Maintain

Resurse externe

Importați activitățile în Maintain

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

Formatarea câmpurilor de date

Formatarea câmpurilor booleene

Formatarea valorilor care conțin virgule

Valori nesetate

Conectarea unei activități la un activ

Import prin Cognite Toolkit

Cerințe preliminare

Configurați maparea vederii activității

Ingerați activități cu Cognite Toolkit

Ingestați activitățile cu Transformări

Depanare

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

​Formatarea câmpurilor de date

​Formatarea câmpurilor booleene

​Formatarea valorilor care conțin virgule

​Valori nesetate

​Conectarea unei activități la un activ

​Import prin Cognite Toolkit

​Cerințe preliminare

​Configurați maparea vederii activității

​Ingerați activități cu Cognite Toolkit

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

​Depanare

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

Formatarea câmpurilor de date

Formatarea câmpurilor booleene

Formatarea valorilor care conțin virgule

Valori nesetate

Conectarea unei activități la un activ

Import prin Cognite Toolkit

Cerințe preliminare

Configurați maparea vederii activității

Ingerați activități cu Cognite Toolkit

Ingestați activitățile cu Transformări

Depanare