Műszaki-hely fa betöltése Excelből

A Karbantartás → Beállítások → Import fülön a telephely teljes műszaki-hely fáját (üzem → technológia → alrendszer → … → pozíció) egyszerre töltheted be egy xlsx- vagy CSV-fájlból, ahelyett hogy elemenként vennéd fel. A betöltés két lépésben megy: előbb egy Ellenőrzés, amely semmit nem ír, de pontosan megmondja, mi történne; utána a Betöltés, amely minden vagy semmi alapon véglegesít.

Mielőtt nekikezdesz

Jogosultság: cmms:manage (Karbantartás kezelése). Enélkül az Import fül nem érhető el.
Előfeltétel: a Karbantartás modul be van kapcsolva, és van legalább egy telephelyed, amelyhez hozzáférsz. Az import egy telephely fájába tölt; ha több telephelyed van, az oldal tetején választod ki, melyikbe.
A szint-létra kész: a fa a telephely szint-létrája szerint épül (Beállítások → Szintek). A sablon ebből készül, ezért a létrát előbb állítsd be.
Az adat a tiéd: a fájl nem tárolódik — csak a neve és az ujjlenyomata kerül az auditnaplóba.

A lépések

Nyisd meg a Karbantartás → Beállítások → Import oldalt. Több telephely esetén válaszd ki a cél-telephelyet — a sablon és a betöltés is erre vonatkozik.
Kattints a Sablon letöltése gombra. A letöltött xlsx első lapja (Műszaki helyek) a fejlécet tartalmazza, a második lap (Útmutató) rövid leírást és a géptípusok listáját (kód és név).
Töltsd ki a sablont: soronként egy útvonal, fentről lefelé haladva a szinteken. Az oszlopok jelentését lásd lentebb.
A Feltöltés blokkban válaszd ki a fájlt (.xlsx vagy .csv), és ha kell, az Alapértelmezett üzemet.
Kattints az Ellenőrzés gombra. Olvasd át a jelentést (lásd lentebb), javítsd a fájlt, és ismételd, amíg hibátlan.
Ha a jelentés ezt mondja: „Az ellenőrzés hibátlan — a fájl betölthető.”, kattints a Betöltés gombra. A gomb addig le van tiltva, amíg az aktuális fájlra nincs hibátlan ellenőrzés; fájl- vagy üzemcsere után újra ellenőrizni kell.

Az oszlopok jelentése

A fejléc nem érzékeny az ékezetekre, a kis- és nagybetűkre és az írásjelekre. A legbiztosabb, ha a letöltött sablonból indulsz.

Oszlop	Mit írj bele
Szint-oszlopok — szintenként kettő: a szint címkéje (pl. `Technológia`) és a `… kód` (pl. `Technológia kód`)	A csomópont neve és (ha van) a kódja. Az üres szint kimarad — a mélység soronként változhat. Ha csak a kód van kitöltve, a kód lesz a név is.
Üzemeltetési kritikusság, HSE kritikusság	A sor legmélyebb csomópontjának kritikussága (az, amelyik a sorban legalul áll).
Géptípus	A géptípus kódja vagy neve (az Útmutató lap listájából). Ismeretlen vagy nem egyértelmű név hiba.
Leírás	A legmélyebb csomópont leírása.
Tulajdonságok (pl. `Névleges teljesítmény [kW]`)	A telephelyen megadott tulajdonságok — a fejléc a tulajdonság címkéje (opcionálisan az egységgel). Az értéknek illenie kell a típushoz.

Fontos tudnivalók:

A sor legmélyebb csomópontjára kerül a kritikusság, a géptípus, a leírás és a tulajdonságok; a feljebbi szintek csak a hierarchiát adják.
A telephelyet és az üzemet nem a fájl adja. Ezt az oldalon választod; a fájlban erre nincs oszlop, és nem írhatja felül.
Az Alapértelmezett üzem csak az újonnan létrejövő, még üzem-kötés nélküli szülő alá kerülő csomópontokra kerül; a meglévő üzem-kötés nem változik, és öröklődik. A „Nincs” választással semmi nem kap üzemet az importtól.
A tulajdonság-értékek típusosak: a szám lehet tizedesvesszős is; a dátum ÉÉÉÉ-HH-NN (az Excel dátum-cellája is jó); a logikai érték igen/nem. Érvénytelen érték hiba.
A cella mindig szöveg: az Excel-képletet a rendszer nem számolja ki. Ha egy név vagy kód = jellel kezdődik, szövegként tárolódik, és figyelmeztetést kapsz.
Formátum: xlsx esetén az első munkalap olvasódik; CSV esetén UTF-8 kódolás kell, az elválasztót a rendszer felismeri. A fájl kiterjesztése egyezzen a tartalmával.

Az Ellenőrzés jelentése

Az ellenőrzés ugyanazt az utat futtatja le, mint a betöltés, csak a végén mindent visszavon — így a jelentés a valódi eredményt mutatja, nem becslést.

Számok (a teljes fájlra, csomópontokban): Sor · Új (létrejönne) · Frissített (már létezik, és ténylegesen változna) · Változatlan (már létezik, és nem változna) · Hibás sor · Üres sor (a teljesen üres sorokat a rendszer átugorja).
Hibák: sorszámmal („12. sor: …”) mondják meg, mi a baj. Amíg akár egy hiba van, a Betöltés nem fut le — lásd a következő szakaszt.
Figyelmeztetések: nem akadályozzák a betöltést, de érdemes átnézni. Ilyen: ugyanarra a csomópontra ütköző érték a fájlban (az utolsó érvényes), a csomópontra nem vonatkozó tulajdonság (kimarad), vagy képletnek látszó érték (szövegként tárolódik).
Fel nem ismert oszlopok: az ilyen fejléc oszlopa kimarad, és a jelentés névvel felsorolja — így nem vész el némán, ha elgépeltél egy fejlécet. Ha ugyanaz a szerep kétszer szerepel, fájl-szintű hibát kapsz.
Soronként: minden sor mellett látszik, hogy új, frissül vagy változatlan. A képernyőn az első 300 sor látszik; a levágást az oldal kimondja, a számok viszont a teljes fájlra szólnak.

A leggyakoribb hibák

Hibaüzenet (értelme)	Mit tegyél
ismeretlen géptípus	Javítsd a nevet vagy a kódot az Útmutató lap listája szerint.
a géptípus neve nem egyértelmű	Használd a géptípus kódját.
a szülő alatt több azonos nevű/kódú csomópont van	Adj meg kódot, amely megkülönbözteti őket, vagy vond össze a duplikátumot a fán.
a meglévő csomópont más szinten áll	Az import nem sorol át — a fában már ott van ez az elem, de más szinten. Javítsd a fájlt, vagy a fán helyezd át előbb.
a szint-létra nem engedi	Lásd lentebb a létra szabályait.
érvénytelen érték a tulajdonság típusához	Javítsd az értéket (szám, dátum, igen/nem).
túl hosszú cella	Egy cella legfeljebb 300 karakter.
nincs kitöltött szint-oszlop	A sor egyik szint-oszlopa sincs kitöltve — töröld a sort vagy írd be az útvonalat.

Minden vagy semmi

A Betöltés egyetlen tranzakcióban fut. Ha akár egy sor hibás, semmi nem íródik be — nem marad félig betöltött fa. A jelentés a hibás sorokat sorszámmal felsorolja; javítsd őket, és ellenőrizd újra. A betöltés ismét teljes ellenőrzést végez a szerveren, nem csak a korábbi eredményben bízik: ha időközben a fa megváltozott, a friss állapot szerint dönt.

Sikeres betöltés után ez áll: „Betöltve. A fa frissült.”, és a betöltés auditnyomot hagy (fájlnév, ujjlenyomat, darabszámok).

Újrafuttatás: ugyanaz a fájl kétszer

Az import idempotens: ugyanazt a fájlt kétszer betöltve ugyanazt a fát kapod — a második futás 0 új, 0 frissített csomópontot jelent.

Az azonosító a kód. A csomópontot a szülője alatt, ugyanazon a szinten keresi a rendszer: ha van kódja, a kód (kis- és nagybetűre nem érzékenyen), ha nincs, a név alapján. A már meglévő elemet nem hozza létre újra.
Utólag is kaphat kódot. Ha a fát előbb csak nevekkel töltötted be, majd ugyanazokat az útvonalakat kódokkal, a kódos sor a kód nélküli, azonos nevű csomópontra kerül rá (frissítésként látszik), nem jön létre új.
Az egyezés sorrendje (kódos sornál). 1. kód szerint ugyanazon szülő alatt; 2. ha nincs ilyen kód: az azonos nevű, kód nélküli csomópont kapja meg a kódot; 3. egyébként új csomópont jön létre. Két azonos nevű, de eltérő kódú elem (pl. két „Szivattyú”: P-91 és P-92) megfér egymás mellett — egy friss fájl mindkettőt betölti.
Csak a valóban eltérő érték íródik. Ha az Excelben átírsz egy leírást vagy kritikusságot, és újra betöltöd, a csomópont frissül; a többi változatlan marad. A kód alapján talált csomópontnál a megadott név átírja a régit.
Az üres cella soha nem töröl. Az import nem nullázza a meglévő adatot — töröléshez használd a felületi szerkesztést.
Folytathatod darabokban. A darabok egymás után betöltve ugyanazt a fát adják, mintha egyben töltötted volna be: ütköző értéknél fájlon belül is az utolsó érvényes, ahogy két egymás utáni betöltésnél.

Korlátok

Az oldal előre kiírja őket; a szerver kényszeríti:

legfeljebb 5000 adatsor (a fejléc nem számít) — nagyobb fájlt darabolj;
legfeljebb 80 oszlop;
legfeljebb 300 karakter egy cellában;
legfeljebb 4 MB fájlméret.

Rövid időn belül (5 perc alatt) csak korlátozott számú ellenőrzést/betöltést indíthatsz; ha túllépted, kis idő múlva próbáld újra. Két egyidejű import ugyanarra a telephelyre sorba áll.

A szint-létra szabályai

A fa a telephely szint-létrája szerint épül, és az import is betartja ugyanazt, mint a kézi szerkesztés:

A gyerek szintje mindig mélyebb a szülőénél. Azonos vagy feljebbi szinten álló gyerek hiba.
Szint kihagyható. Egy sor ugorhat a létrán (pl. technológiától egyből pozícióig), ha az üres szintek oszlopai üresek.
A létra végén nincs tovább. A legmélyebb szint alá nem lehet gyereket tenni.
Nincs csendes átsorolás. Ha a fában egy elem már létezik, de más szinten, mint amire a fájl állítja, azt az import hibaként jelzi, nem mozgatja.
A szint-oszlopok sorrendje a fájlban mindegy: a rendszer a létra sorrendjében rakja össze az útvonalat, nem az oszlopok sorrendjében.

A létrát a Beállítások → Szintek fülön szerkesztheted. Egy használatban lévő szintet nem lehet archiválni — így a betöltött fa szerkezete nem borul fel.

Ha jól csináltad

Az Ellenőrzés jelentése hibátlan, a számok megfelelnek a várakozásodnak (új/frissített/változatlan), a Betöltés után az Új darabszámnak megfelelő csomópont megjelenik a műszaki-hely fában, és az ugyanazzal a fájllal ismételt ellenőrzés 0 új, 0 frissített csomópontot mutat.

Gyakori hibák

A Betöltés gomb szürke. Még nincs hibátlan ellenőrzés az aktuális fájlra. Futtasd az Ellenőrzést; fájl- vagy üzemcsere után ismételd.
„A fejlécben nincs a telephely szint-létrájának megfelelő oszlop.” A fejléc egyik szint-oszlopa sem ismerhető fel. Indulj a letölthető sablonból, és ne írd át a szint-címkéket.
„A telephelynek nincs szint-létrája — előbb állítsd be a Szintek fülön.” Állítsd be a létrát a Beállítások → Szintek fülön.
A fájl nem olvasható be. xlsx- vagy UTF-8 CSV-fájlt tölts fel; a kiterjesztés egyezzen a tartalommal.
A géptípus mind „ismeretlen”. A név helyett a géptípus kódját írd, az Útmutató lap szerint.
Egy oszlop adata nem került be. Valószínűleg elgépelt fejléc: a jelentés a „Fel nem ismert oszlopok (kimaradtak)” között névvel kiírja; javítsd a sablon szerint.

Kapcsolódó

Ha a fa már áll, a következő esedékességeket az Mi esedékes a következő hetekben: az esedékesség-naptár cikk mutatja.