Importēt aktivitātes programmā Maintain

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 datu modelēšanu (APM un IDM/CDM režīmi).
Transformācijas: Pārveidot datus no RAW tabulām vai citiem avotiem, izmantojot CDF Transformations (APM un IDM/CDM režīmi).

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

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

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

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:

Pārejiet uz Aktivitātes un izvēlieties Pievienot aktivitāti.
Izvēlieties Importēt aktivitātes.
Izvēlieties Lejupielādēt veidni.

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.

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.

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

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

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

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

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

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.

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 vai citus datu ekstraktorus.

Importējiet aizpildītu CSV failu

Kad jums ir aizpildīta CSV veidne, jūs to varat importēt Maintain:

Pārejiet uz Aktivitātes > Pievienot aktivitāti.
Izvēlieties Importēt aktivitātes.
Izvēlieties Noklikšķiniet, lai izvēlētos CSV failu importēšanai lauku.
Izvēlieties un augšupielādējiet aizpildīto CSV failu no sava datora.
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.
Ja nav kļūdu, izvēlieties Importēt, lai uzsāktu importēšanas procesu.
Kad imports ir veiksmīgs, jūs redzēsiet zaļu panākumu ziņu ar Rādīt aktivitātes pogu.
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.

Importēt, izmantojot Cognite Toolkit

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

Izmantojiet Cognite 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

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:

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

"viewMappings": {
  "activity": {
    "type": "view",
    "space": "maintain_schema_extention",
    "version": "v1",
    "externalId": "APM\_Activity"
  }
}

Uzziniet vairāk par datu modeļu paplašināšanu un skatu kartējumu konfigurēšanu.

Iegūstiet aktivitātes ar Cognite Toolkit

Izmantojiet Cognite Toolkit kā ieteicamo pieeju aktivitāšu iegūšanai IDM režīmā.

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 detalizētiem piemēriem un veidnēm.

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

Iekļaujiet papildu laukus, pamatojoties uz jūsu laukuma konfigurācijas iestatījumiem Maintain.

Izvietojiet aktivitātes

Izvietojiet savus aktivitāšu datus, izmantojot Cognite Toolkit:

cdf deploy --env dev

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

cdf deploy --env dev --drop-data

Uzziniet vairāk par Cognite Toolkit izvietošanas karogiem.

Pārbaudiet sadaļā Maintain

Piesakieties Maintain.
Pārejiet uz Aktivitātēm.
Pārliecinieties, ka jūsu importētās aktivitātes parādās ar pareiziem datiem.

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

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

Alternatīvi, jūs varat izmantot CDF Transformācijas, 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

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

​Formatējiet datuma laukus

​Formatējiet loģiskos laukus

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

​Nekonfigurētas vērtības

​Savienojiet aktivitāti ar aktīvu

​Importēt, izmantojot Cognite Toolkit

​Prasības

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

​Iegūstiet aktivitātes ar Cognite Toolkit

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

​Problēmu novēršana

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

Formatējiet datuma laukus

Formatējiet loģiskos laukus

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

Nekonfigurētas vērtības

Savienojiet aktivitāti ar aktīvu

Importēt, izmantojot Cognite Toolkit

Prasības

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

Iegūstiet aktivitātes ar Cognite Toolkit

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

Problēmu novēršana