Skip to main content
Maintain atbalsta trīs aktivitāšu importēšanas metodes:
  • CSV augšupielāde: Importēt aktivitātes, izmantojot lietotāja saskarni (tikai APM režīms).
  • Cognite Toolkit: Iegūstiet aktivitātes, izmantojot Cognite Toolkit datu modelēšanu (APM un IDM/CDM režīmi).
  • Transformācijas: Konvertējiet datus no RAW tabulām vai citiem avotiem, izmantojot CDF Transformācijas (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 failā importētās aktivitātes var vizualizēt un modificēt kā aktivitātes, kas izveidotas Maintain.
1

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. Naviģējiet uz Aktivitātes un atlasiet Pievienot aktivitāti.
  2. Atlasiet Importēt aktivitātes.
  3. Atlasiet Lejupielādēt veidni.
2

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 galvenes rindu nedrīkst noņemt, 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 veidnē ir šāda galvenes rinda: title,status,department, izveidojiet CSV failu ar papildu rindu:
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 apzīmē datumus, un tiem jābūt noteiktā formātā, lai tos varētu pareizi importēt. Datuma laukus CSV veidnē var identificēt pēc īpašas galvenes vērtības formā startTime (DD/MM/YYYY). Šajā piemērā startTime ir lauka nosaukums, savukārt DD/MM/YYYY ir datuma formāts, kas jāizmanto turpmākajās CSV faila rindās. Piemēram, importējot šādu failu, aktivitāte tiks izveidota ar startTime, kas iestatīts uz 2023. gada 10. decembri.

​
Formatējiet loģiskos laukus

Daži aktivitāšu lauki Maintain apzīmē Būla vērtības, piemēram, true vai false. Būla laukus CSV veidnē var identificēt pēc īpašas galvenes vērtības formā isActive (true/false). Šiem laukiem ir tikai divas derīgas vērtības: true vai false. Piemēram, importējot šo failu, darbība tiks izveidota ar isActive, kas iestatīts uz false.

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

Tā kā CSV formātā vērtības tiek atdalītas ar komatiem, esiet uzmanīgi, ja darbības laukā arī ir jāiekļauj komats. Maintain apstrādā CSV failus saskaņā ar RFC 4180 standard, kas pieprasa, lai vērtības, kurās ir komati, tiktu ietvertas pēdiņās. Piemēram, importējot šo failu, darbība tiks izveidota ar city, kas iestatīts uz 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 šo failu, darbība tiks izveidota ar state, kas iestatīts uz New York, taču laukā city vērtības nebūs.

​
Savienojiet aktivitāti ar aktīvu

Maintain atbalsta darbību saistīšanu ar CDF līdzekļiem, ko izmanto, lai kontekstualizētu darbību 3D modeļos, dokumentos, PSN un citur. Lai Maintain izveidotu atbilstošu saiti uz līdzekli CDF, importēšanas veidnē ir jānorāda CDF līdzekļa ārējais ID. Ja jūsu projektā ir līdzekļu kontekstualizācija, veidnē būs īpašs assetExternalId lauks, kas jāaizpilda ar darbības līdzekļa ārējo ID. Piemēram, importējot šo failu un pieņemot, ka pastāv CDF līdzeklis ar ārējo ID NY_BUILDING_23, darbība tiks kontekstualizēta šim līdzeklim, kad tā tiks ievadīta Maintain.
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 galalietotājiem iespējamo līdzekļu un to ārējo ID sarakstu, mēs iesakām iegūt šos datus, izmantojot CDF asset API vai citus datu ekstraktorus.
3

Importējiet aizpildītu CSV failu

Kad esat aizpildījis CSV veidni, varat to importēt Maintain:
  1. Dodieties uz Aktivitātes > Pievienot aktivitāti.
  2. Atlasiet Importēt aktivitātes.
  3. Atlasiet lauku Noklikšķiniet, lai atlasītu importējamo CSV failu.
  4. Izvēlieties un augšupielādējiet aizpildīto CSV failu no sava datora.
  5. Pārbaudiet, vai esat importējis failu, apskatot sadaļu Failu inspektors. 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 kļūdu nav, atlasiet Importēt, lai sāktu importēšanas procesu.
  7. Kad imports būs veiksmīgs, redzēsit zaļu ziņojumu par panākumiem ar pogu Rādīt aktivitātes.
  8. Pēc izvēles: Atlasiet Rādīt aktivitātes, lai pārietu uz importētajām darbībām un pārbaudītu, vai tās izskatās pareizi atbilstoši CSV failam.

​
Imports, 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 ievadītu darbības, 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 darbību importēšanas, izmantojot Cognite Toolkit, pārliecinieties, vai esat:
  • Konfigurējis pielāgotu darbību skatu savā datu modeļa telpā (vai izmantojiet standarta CogniteMaintenanceOrder skatu no cdf_idm)
  • Darbību skats, kas kartēts jūsu Maintain konfigurācijā sadaļā viewMappings
  • Piekļuve Cognite Toolkit

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

Savas Maintain konfigurācijas ietvaros pārbaudiet, vai viewMappings sadaļa norāda uz jūsu aktivitāšu skatu:
Ja esat izveidojis pielāgotu aktivitāšu skatu (piemēram, APM_Activity vai ExtendedActivity), atjauniniet kartēšanu, lai tā norādītu uz jūsu pielāgoto skatu:
Uzziniet vairāk par datu modeļu paplašināšanu un skatu kartēšanas konfigurēšanu.

​
Iegūstiet aktivitātes ar Cognite Toolkit

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

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ē konteinera shēmu
  • APM_Activity.View.yaml - Definē skata rekvizītus un attiecības
  • apmActivities.Node.yaml - Satur jūsu aktivitāšu instances Skatiet Cognite Toolkit dokumentāciju, lai iegūtu detalizētus piemērus un veidnes.
2

Konfigurējiet lauku kartēšanu

Pārliecinieties, vai jūsu aktivitāšu mezglos ir iekļauti nepieciešamie lauki Maintain:
Iekļaujiet papildu laukus, pamatojoties uz saviem lauku konfigurācijas iestatījumiem Maintain.
3

Izvietojiet aktivitātes

Izvietojiet savus darbības datus, izmantojot Cognite Toolkit:
Izmantojiet --drop-data karodziņu, ja jums ir jāaizstāj esošās darbības:
Uzziniet vairāk par Cognite Toolkit izvietošanas karogiem.
4

Pārbaudiet sadaļā Maintain

  1. Pierakstieties Maintain.
  2. Dodieties uz Activities (Darbības).
  3. 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 varat izmantot CDF Transformations, lai konvertētu datus no RAW tabulām vai citiem avotiem darbību mezglos.

​
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.
Pēdējoreiz mainīts 2026. gada 8. septembris