OMS
From PlcWiki
Spuštění aplikace
Jedná se o webovou aplikaci kompatibilní s běžnými internetovými prohlížeči. Testována je pro MS-IE, Firefox a Safari.
Parametry URL (např.: ...?mute&noheader&locale=en):
- mute - vypne zvuky
- noheader - skreje horní pruh
- locale - nastaví jazyk
Periferní aplikace
Revidovanou OMS lze vytisknout do formátu PDF nebo online prohlížet pomocí webové aplikace "OMS Browser". V obou případech se jedná o samostatné webové aplikace postavené na šablonovacím systému.
Přednastavená šablona pro generování PDF je "oms". Systém nejprve zjišťuje, zda má uživatel nastavenu svou vlastní šablonu, když ne, tak zjišťuje zda není nakonfigurovaná šablona pro celou aplikaci (klíč "template.printer").
Přednastavená šablona pro zobrazování OMS je "basic.ftl". Systém nejprve zjišťuje, zda má uživatel nastavenu svou vlastní šablonu, když ne, tak zjišťuje zda není nakonfigurovaná šablona pro celou aplikaci (klíč "template.browser").
Grafické rozhraní tabulky
Tabulky umožňují data filtrovat, třídit i agregovat. Oblast filtru se nachází v horní části tabulky (B). V některých případech lze použít zástupný znak '*' (případně znaky kompatibilní s SQL LIKE). Filtrování zašktávacích políček (A) ma tři stavy: filtrování vypnuto, zaškrtnuto, nezašktrnuto. Odeslání požadavku na fltraci je buď tlačítkem (C) nebo klávesou 'Enter'.
Stručný přehled hlavních komponent (záložek) aplikace
- OMS - Seznam všech zarevidovaných OMS postupů. Lze tisknout a měnit datum.
- Sekvence - Seznam jednotlivých sekvencí v pracovním (nezarevidovaném) stavu. Lze editovat, vytvářet atp.
- Pracoviště - Seznam všech pracovišť a všech nástrojů, které se zde zároveň přidělují na jednotlivá pracoviště.
- Kusovník - Seznam dílů pro konkrétní CPN. Viditelnost položek je dána příznaky (ItemType).
- Schválené díly - Seznam dílů, které jsou schváleny. Slouží pouze k ověřování používaných dílů z Kusovníku.
- Oprávnění - Seznam práv uživatele na jednotlivé funkcionality v aplikaci. Nastavuje se zde také e-mail pro notifikace a jméno uživatele pro zobrazení v OMS.
Uživatelský prostor (projekt)
Prostorem se rozumí izolovaný soubor dat, ke kterému mají přístup různí uživatelé. Každý uživatel má vlasní prostor, ke kterému může zmocnit další uživatele s různým oprávněním. Pokud je přednastaven v aplikaci globální jednotný prostor ("root") je uživateli po přihlášení automaticky nastaven. Je-li uživatel zmocněn k více prostorům, jsou mu nabídnuty po přihlášení k výběru.
Nástroje
Tabulka nástrojů se objevuje v aplikaci na dvou místech: v sekvenci (podmnožina podle pracoviště) a v hlavní záložce pracovišť, kde je úplný seznam všech nástrojů. Na této záložce lze nástroje přidávat ručním způsobem po jednom nástroji, nebo provést hromadný import z CSV souboru. Formát CSV jsou dva sloupce: název pracoviště a název nástroje. Pokud se shoduje název pracoviště s existujícím pracovištěm, je nástroj automaticky k němu přidán, jinak vznikne nové pracoviště.
Nástroje se přidělují v hlavní záložce pracovišť na jednotlivá pracoviště pomocí zaškrtnutí v dialog boxu:
Každý nástroj přidělený k pracovišti je poté k dispozici v nabídce nástrojů sekvence, která odpovídá tomuto pracovišti:
Pokud nástroj, již před tím přidělený k určité sekvenci, byl z pracoviště odebrán (v záložce pracovišť), zobrazí se v sekvenci podbarvený červeně a indikuje tak svou momentální nedostupnost:
Pracoviště
Mazání, editace a přidávání pracovišť je součástí hlavní záložky pracovišť. Pracoviště figurují v nástrojích a sekvencích. Při změně pracoviště v sekvenci dojde k validaci dostupnosti nástrojů pro dané pracovište (nedostupný nástroj je podbarven červeně).
Verzování postupů OMS
Nová verze OMS vznikne v záložce sekvencí tak, že na pozadí jsou během akce vybrány všechny sekvence stejného pracoviště jako je aktuálně označený řádek. Z tohoto důvodu zůstává vyplněný filtr názvem pracoviště. Úspěšnost akce a číslo revize je zobrazeno v informativním dialogu. Tuto revizi spolu s ostaními najdete v hlavní záložce OMS, kde je lze tisknout a nebo dvojklikem editovat sloupec platnosti do.
OMS Browser
Jedná se o samostatnou aplikaci na prohlížení revidovaných OMS, která má dvě uživatelská rozhraní. Jedno rozhraní je pro moderní prohlížeče (GWT) a druhé je určeno pro výkonostně slabší počítače (HTML).
Jejich URL jsou obvykle:
- Plné rozhraní (GWT): /omsbrowser
- Jednoduché (plain HTML): /omsbrowser/dir
Spuštění aplikace (konfigurace) je založena na URL parametrech. Příklad: /omsbrowser/dir?cpn=A7&wp=C01&revision=3&template=xc.ftl&w=1200&h=700&page=1&wpt=xc_workplace.ftl
Význam parametrů (obě rozhraní):
- cpn = Název stroje (CPN)
- wp = Název pracoviště
- revision = Číslo revize (hodnota je číslo nebo "auto")
- template = Šablona pro zobrazení OMS
- wpt = Šablona pro zobrazení informační stránky o pracovišti
Význam parametrů (rozhraní plain HTML - dir):
- w = Šířka obrazovky
- h = Výška obrazovky
- page = Číslo stránky (0 = informace o pracovišti)
- redir = Čas v sekundách, za který se má automaticky zobrazit stránka s informací o pracovišti
Význam parametrů (rozhraní GWT):
- overflow = Zapíná vertikální posuvník prohlížeče (roluje celá stránka)
- noheader = Nezobrazí hlavičku stránky
Zakládání a editace sekvence
Editor sekvencí má tři hlavní části: popis sekvence, materiál a obrazovou dokumentaci. Všechny sekvence existují v tzv. revizi 0, která označuje pracovní data, ze kterých se provádí následně revize.
Výběr čísla sekvence podléhá validaci na neobsazenou pozici formou upozornění.
Materiál se přiděluje k sekvenci přetažením (DnD). V pravé horní části sekce materiálu sekvence jsou ovládací prvky. 
První dva (zelené šipky) slučují option materiál do jednoho řádku a naopak. Další dvě tlačítka regulují zobrazení/skrytí již spotřebovaného materiálu ve spodní tabulce (kusovník). Zaškrtávací pole indikuje automatické skrývání spotřebovaných položek. Vyhodnocení se děje vždy po každém přetažení materiálu k sekvenci (reload kusovníku).
Dokumentace sekvence povoluje nahrát tyto souborové typy (extenze): svg (integrovaný online editor), png, jpg, jpeg, ppt, tif, tiff, pptx. Nahraný dokument může být nastaven jako skrytý a to znamená, že se nebude tisknout (zobrazení revidované OMS v PDF formátu).
Hlavní záložka seznamu sekvencí obsahuje tlačítko kontroly na přítonost neschváleného materiálu, která je provedena v množině všech sekvencí aktuálně vybraného stroje.
Testovací sekvence
Testovací sekvence má přiděleno svoje pracovní místo, pořadí, čas, popis a obrazovou dokumentaci obdobně jako tomu je u normální sekvence. Pracovní místo (workplace) musí být typu "1". Příznak lze vynutit založením nového prac. místa s názvem ve tvaru "TEST 1".
Kusovník a detekce změn
Tabulka kusovníku se fakticky vyskytuje i v editoru sekvence, kde se z něho vybírá materiál.
Přidávání a editace dílů nezasahuje do dílů, které jsou již naimportovány. Pro orientaci jsou uživatelsky přidané díly označeny zaškrtávátkem po levé straně tabulky a pouze tyto lze editovat a mazat z prostředí aplikace OMS.
Označování úrovní je číselník, podle kterého se během nočního zpracování kusovníku (import) generuje viditelnost dílů kusovníku pro aplikaci OMS. Proto jakákoliv změna v této tabulce se projeví až při příštím importu kusovníku.
Zobrazení vazby označeného materiálu na sekvence je tabulka obsahující následující informace jako je pracovní místo, revize a počet měrných jednotek:
Zobrazení sekvencí s vazbou na koncesi nebo CPN je tabulka jejímž vstupem je dialog do kterého lze zadat koncesi nebo CPN.
Historie importovaných změn je zobrazena 30 dní zpět. (přidržením klávesy 'alt' během stisku tlačítka je zobrazena historie 360 dní dozadu). Na obrázku je vidět změna hodnoty revize z D na E:
Zdůvodňování nevyužitých počtů materiálu je zde z důvodu správného odpočítávání použitého materiálu, které by v konečném výsledku mělo dosáhnout nuly (vše bylo spotřebováno). Zdůvodněních k jednomu materálu může být více a obsahuje počet a popis (důvod nevyužití).
Číselník NV má dva sloupce: zkratku a popis. Z důvodu možnosti změnit již nastavené NV u sekvence na prázdnou (žádnou) hodnotu, je v číselníku speciální položka, kde zkratka je jedna prázdná mezera. Tato položka se pak nabízí ve výběru NV u sekvencí.
Barevné zvýraznění kusovníku:
| Barva | Podmínka |
| FFCC99 | Level = 1 |
| CCFF99 | ItemType = "OPTION ITEM" |
| FF0000 | Nepoužité díly = 0 |
| FFFFCC | ItemType = "PURCHASED" OR "OPTION BUY" OR "PREASSEMBLED KIT" OR "SUBASSEMBLY" |
| orange | Díl byl změněn (flag = 94). Odstranění (vzetí změny na vědomí) tohoto zvýraznění lze provést tlačítkem smazání příznaku pro konkrétní díl v záložce kusovníku. |
Smazané díly (nočním zpracováním nebo smazáním ručně přidaného dílu), které jsou již přiděleny k sekvenci, se v editoru sekvence zobrazují červeně v tabulce sekvenčního materiálu (tabulka nad kusovníkem). V kusovníku se smazané díly nezobrazují.
Práce se schválenými díly
Import schválených dílů
V hlavní záložce "Schválené díly" lze provést import ze souboru csv. Soubor by měl mít kódování UTF-16 a data odděleny středníkem. Struktura tabulky musí mít 28 sloupců s následujícím pořadím (počítáno od nuly):
- sloupec 0: material.setOtherId(token);
- sloupec 1: material.setOtherUpdateId(token);
- sloupec 2: material.setMachineCPN(token);
- sloupec 3: material.setMachineNameIRCR(token);
- sloupec 4: material.setValidTo(toDate(token, "yyyy-MM-dd HH:mm:ss.S"));
- sloupec 5: material.setOrder(toInt(token));
- sloupec 6: material.setParentItemOrder(toInt(token));
- sloupec 7: material.setLevel(toInt(token));
- sloupec 8: material.setItemSequence(token);
- sloupec 9: material.setOperationSequence(toInt(token));
- sloupec 10: material.setItem(token);
- sloupec 11: material.setDescription(token);
- sloupec 12: material.setRevision(token);
- sloupec 13: material.setUnitOfMeasure(token);
- sloupec 14: material.setQuantity(toFlo(token));
- sloupec 15: material.setEffectiveDate(toDate(token, "yyyy-MM-dd HH:mm:ss.S"));
- sloupec 16: material.setDisableDate(toDate(token, "yyyy-MM-dd HH:mm:ss.S"));
- sloupec 17: material.setExtendedQuantity(toFlo(token));
- sloupec 18: material.setEngineeringChangeOrder(token);
- sloupec 19: material.setCatalogElement(token);
- sloupec 20: material.setElementValue(token);
- sloupec 21: material.setPlanPercent(toInt(token));
- sloupec 22: material.setItemType(token);
- sloupec 23: material.setItemStatus(token);
- sloupec 24: material.setPlannerCode(token);
- sloupec 25: material.setReleaseCode(token);
- sloupec 26: material.setImportErrorMessage(token);
- sloupec 27: material.setPurchasedLevel(toInt(token));
POZOR: Před každým importem dojde ke smazání celého obsahu stávajících dílů.
Položky item, machineCPN, order, parentItemOrder jsou povinné.
Nastavení práv
Nastavení práv se provádí v hlavní záložce, která je zobrazena pouze pokud je aplikace spouštěna s URL parametrem 'rights'.
Jednotlivá práva se vztahují vždy k vybranému uživateli (defaultně je to přihlášený uživatel) jehož jméno je na tlačítku v pravém panelu. Tímto tlačítkem lze měnit uživatele jehož práva se nastavují/zobrazují. Tabulka práv má dva sloupce (hodnoty): parametr a název procesu. Parametrem je hodnota vstupující do funkce a může se zadat jako konkrétní řetězec nebo jako zástupný znak '*', případně '--' (znamená prázdnou hodnotu NULL). Název procesu lze opakovat s různou hodnotou (OR), např. Zobrazení stroje. Seznam všech procesů je generován automaticky ze serveru a nesou identické jméno skutečné serverové vstupní funkce, kterou volá klient (IE). Některé jsou zahrnuty do překladového slovníku aplikace (i18n).
Základní funkce:
| ID procesu | Název | Poznámka |
| fetchMachines (@Check cpn) | Zobrazení stroje | Dialog seznamu strojů, ze kterého si přihlášený uživatel vybírá. |
| fetchOperation (@Check cpn) | Zobrazení operací | Zobrazení obsahu hlavní záložky operací |
| fetchUserNames | Zobrazení uživatelských jmen | Záložka práv (tl. vpravo dole) - zobrazí seznam jmen uživatelů |
| fetchUserRights (@Check user) | Zobrazení uživatelských práv | Záložka práv - načtení obsahu záložky |
| updateUserRights | Změna uživatelských práv | Záložka práv - právo změny nastavení práv |
| deleteRevision | Mazání revizí | Administrační právo, pokud by bylo potřeba smazat revizi. Na varovacím dialogu při stisku OK držet klávesu Alt. |
| addCPN | Založení nového CPN | |
| clearFlag | Potvrzení modifikace dílu | Viz. barevné ozn. - záložka kusovníku, tl. vpravo |
| updateNV | Změna položky číselníku navážení | Číselník je přístupný v kusovníku, tl. vpravo |
| deleteNV | Smazání položky číselníku | |
| updateWorkplace | Úprava položky pracoviště | Hlavní záložka pracovišť |
| deleteWorkplace | Smazání položky pracoviště | Hlavní záložka pracovišť |
| addDescUnused | Přidání zdůvodnění o nevyužití materiálu | Záložka kusovníku (parametry seznam a materialId) |
| updateLevelFlag | Změna položky číselníku úrovní (podle kterých se řídí viditelnost dílů v kusovníku) | Záložka kusovníku |
| addLevelFlag | Přidání položky číselníku úrovní viditelnosti dílů kusovníku | Záložka kusovníku |
| deleteLevelFlag | Smazání položky číselníku úrovní | Záložka kusovníku |
| updateMaterial | Změna materiálu, který byl ručně přidaný | Záložka kusovníku |
| revise (@Check cpn) | Právo provést revizi | Hlavní záložka sekvencí |
| updateRevision | Možnost nastavit platnost revize | Hlavní záložka OMS |
| deleteTool | Smazání nástroje | Dialog vyvolaný tlačítkem (Nástroje) v hlavní záložce Pracoviště |
| deleteWorkplToolRel | Odebrání vazby nástroje k pracovišti (checkbox) | Dialog vyvolaný tlačítkem (Nástroje) v hlavní záložce Pracoviště |
| updateTool | Změna nástroje | Dialog vyvolaný tlačítkem (Nástroje) v hlavní záložce Pracoviště |
| updateOperation (@Check cpn) | Potvrzení (OK) editované sekvence | Editor sekvencí |
Legenda: červeně jsou práva administrátora a žlutě jsou práva (read-only), která budou nastavena každému uživateli. Ostatní práva se vztahují k operacím, které něco mění nebo mažou. Označení @Check znamená, že vstupní parametr funkce rovněž podléhá autorizaci. Příklad: "* fetchUserRights" znamená, že mohu zobrazit uživatelská práva kohokoliv, ale "Novák fetchUserRights" znamená, že zobrazím práva pouze uživatele Novák.
Kontrola práv je prováděna na serveru a v případě, že se uživatel pokusí zavolat funkčnost, na kterou nemá oprávnění, je mu zobrazeno varování:
Odkazy
Verze
| Datum | Popis |
| 4.12.2012 | Zohlednění CPN v reportu operací v záložce kusovníku. Rozšíření možnosti změny ručně přidaného dílu (update) o quantity, unit, level a IRCR name. |
| 13.12.2012 | Optimalizace paměti v ORM. Doplnění některých českých textů a opravy filtrování tabulek (záložek) OMS, Sekvence a Pracoviště. Ruční zakládání nového CPN a možnost přidání nového dílu v editoru sekvence. |
| 17.12.2012 | Persistence nastavení viditelnosti sloupců v kusovníku v rámci přihlášeného uživatele. |
| 19.12.2012 | Hlavička aplikace. Automatické přidělování práv na nově vytvořené CPN. |
| 27.12.2012 | Formulář pro zadávání nového CPN rozšířen o Produkt (IRCR) |
| 2.1.2013 | Potvrzovací dialog při mazání klávesou "delete" v záložce Sekvence. Našeptávač schválených dílů (kusovník). |
| 3.1.2013 | Opravy editace dílu v kusovníku. |
| 7.1.2013 | Oprava filtrování v kusovníku podle "Item" |
Poznámka: Po nasazení nové verze je nutno provést "reload" aplikace v internetovém prohlížeči (Ctrl+R, atp.)
