Importați activitățile în Maintain

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 (modurile APM și IDM/CDM).
Transformări: Convertiți datele din tabele RAW sau alte surse folosind Transformările CDF (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ățile 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 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.

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.

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

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

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, 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"

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

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.

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 al CDF sau alte extratoarele de date.

Importarea unui fișier CSV completat

Odată 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 verificați că acestea arată corect conform fișierului CSV.

Importați 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 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

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:

"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ă:

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

Ingestați activitățile cu Cognite Toolkit

Utilizați Cognite Toolkit ca abordare recomandată pentru a ingesta activități î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_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 pentru exemple detaliate și șabloane.

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

Includeți câmpuri suplimentare pe baza setărilor dumneavoastră Configurare Câmp în Maintain.

Dezvoltă activitățile

Implementați datele activității dumneavoastră folosind Cognite Toolkit:

cdf deploy --env dev

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

cdf deploy --env dev --drop-data

Aflați mai multe despre flag-urile de implementare 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 folosi CDF Transformations 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ă

​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

​Importați prin Cognite Toolkit

​Cerințe preliminare

​Configurați maparea vederii activității

​Ingestați activitățile 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

Importați prin Cognite Toolkit

Cerințe preliminare

Configurați maparea vederii activității

Ingestați activitățile cu Cognite Toolkit

Ingestați activitățile cu Transformări

Depanare