(Není zobrazeno 17 mezilehlých verzí od 3 dalších uživatelů.)
Řádek 1:
Řádek 1:
== Technické požadavky ==
== Manta ekosystém ==
Tato sekce poskytuje základní technický přehled architektury, požadavků a provozních principů řešení '''Manta''' pro zákazníky a implementační partnery.
=== Aplikační server ===
==== Řešení ====
Manta je navržena jako '''server–terminálové řešení''', kde aplikační server zajišťuje centrální logiku a databázové operace a terminály (Android) slouží jako klientská zařízení.
== Instalace ==
Řešení je optimalizováno pro stabilní provoz ve výrobním prostředí a není extrémně náročné na výkon serveru.
=== Instalace Helios ===
=== Doporučené parametry aplikačního serveru ===
Prvním krokem pro úspěšnou instalaci Manty je zapotřebí mít v Heliosu ( platí jen pro HEI ) nainstalovaný modul "Evidence zboží na lokacích" od firmy Gatema.
Pro standardní nasazení (do cca 50 současně aktivních zařízení):
Dále je zapotřebí mít na aplikačním serveru, kam bude probíhat instalace, nainstalolovanou službu IIS (Internetová Informační Služba)
{{Info|
* '''CPU''': 8+ jader
* '''RAM''': 16+ GB
* '''Uložiště''': 250+ GB SSD/NVMe
* '''Síťové připojení''': 1 Gbit Ethernet
* '''OS:''' Windows Server 2019+
}}
Všechny potřebné softwarové komponenty jsou instalovány automaticky v rámci instalačního procesu Manty.
Nyní se vrátíme k samotné instalaci Manty.
pro funcionalitu je využíván primarně '''IIS (Internet Information Services)'''.
[http://manta.nvsp.cz/hub/prod/Api/MantaPackage/NewestVersion/File Odkaz na stažení Manta balíčku (stažení může chvíli trvat)]
==== zavislosti v IS Helios ====
Pro úspěšnou instalaci Manty musí být v Heliosu (platí pro inuvio) nainstalován modul: '''Evidence zboží na lokacích (Gatema)'''
[http://manta.nvsp.cz/hub/prod/Api/VersionManager/NewestVersion/File Odkaz na stažení Manta version manageru (stažení může chvíli trvat)]
*[http://manta.nvsp.cz/hub/prod/Api/VersionManager/NewestVersion/File Stažení Manta version manageru]
}}
*Spuštění instalátoru '''MantaSetup.exe'''
*Nastavení profilu (testovací / ostrý)
*Spuštění volby Upgrade aplikací a databáze
Po dokončení jsou nainstalovány komponenty v Heliosu a komunikační můstek mezi serverem a terminály.
Objeví se vám okno s dvěma předdefinovanými profily. Vyberu si nějaký profil a kliknu na tři svislé tečky vlevo od názvu profilu a v dalším menu “Editace profilu”. Běžná praxe je, že pro Cvičnou databázi se vybere profil “Testovací” a pro Ostrou profil ”Ostrá” Tyto profily si můžete ještě před instalací přejmenovat na vámi vyhovující název.
# '''Název profilu:''' Necháte stejný, nebo si ho přejmnujete na svůj název
# '''Název profilu:''' Necháte stejný, nebo si ho přejmnujete na svůj název
# '''Cesta k Helios.exe:''' Pomoci “...” vpravo si nalistujete tento soubor, tam kde ho máte umístěný
# '''Cesta k Helios.exe:''' Pomoci “...” vpravo si nalistujete tento soubor, tam kde ho máte umístěný
Řádek 33:
Řádek 53:
# '''Licenční soubor:''' pomocí “...” vpravo si vyberete licenční soubor
# '''Licenční soubor:''' pomocí “...” vpravo si vyberete licenční soubor
# '''Uložit'''
# '''Uložit'''
}}
|}
|}
=== Instalace Manta (Klient) ===
Koncové zařízení tvoří Android zařízení tablet, AIO, nebo ruční zařízení.
Tím jsme si nastavili profil a teď můžeme spustit samotnou instalaci. To se provede tak, že opět klikne na tři svislé tečky vedle profilu a v následujícím menu kliknete na “'''Upgrade aplikací a databáze'''”
Nejjednodušší způsob instalace terminálů je pomocí '''QR kódů'''. Dále je možné APK soubor stáhnout v rámci webové konfigurace.
V následně zobrazeném okně vidíte, na jaký SQL server a jakou databázi se bude instalovat. Pokud to je v pořádku, dáte “OK”
Používají se dva typy QR kódů:
Pokud vše proběhlo v pořádku, tak jste nainstalovali komponenty do Heliosu a komunikační můstek mezi terminálem a Heliosem.
* '''QR kód stažení aplikace''' – stáhne a nainstaluje nejnovější verzi aplikace
* '''QR kód přihlášení''' – nastaví přístupové údaje k serveru
QR kódy lze generovat:
Nyní je zapotřebí nainstalovat aplikace do terminálů.
* v '''instalačním nástroji Manty'''
* ve webové konfiguraci:
{{CodeBox|Menu → Aplikace → Správa APK balíčků}}
=== Instalace terminálů ===
Nejjednodušší způsob instalace termínálů je pomocí QR kódu.
|[[Soubor:Menu nastavení v aplikaci Manta.png|náhled|167x167pixelů|Menu Nastavení]]
!QR kód Stažení nové verze - Obsahuje URL adresu, kde se po kliknutí stáhne a nainstaluje nejnovější verze
|Nastavení lze importovat a exportovat z koncového zařízení i přes soubor '''*.json'''
QR kód Přihlášení do aplikace - Nastaví správné parametry pro přístup do aplikace. Toto načtení se provádí v nastavení spuštěné Manty v terminálu. Nastavení jde i manuálně.
Tyto možnosti jsou v ramci android aplikace v menu nastavení.
Získání QR kódů je možné dvěma způsoby:
# První je, že v rámci instalátoru, když se vše nainstaluje, tak v menu u profilu je “Generovat QR kódy”. Když na to kliknete, tak se vám zobrazí dva QR kódy.
# Stejným způsobem to jde i pomocí Webové konfigurace. Tam se QR kódy nacházejí v menu “Aplikace” -> “Správa APK balíčku”
|}
== Správa APK balíčků ==
Tato správa se nachází ve Webové konfiguraci Menu->Aplikace->Správa APK balíčků.
Slouží k jednak pro správu Apk balíčků, to znamená přídávaní nových a mazaní nepotřebných balíčků pro Manta terminál a Manta, tak i poskytnutí QR kódů pro instalaci a konfiguraci terminálů.
Standardně se nové verze náhravají při kompletní instalaci nebo celkovému update Manty. V případě, že je potřeba nahrát jen nový Apk balíček postup je následující:
# V okně Aplikace si vyberu pro jakou aplikaci chci nahrávat nový balíček. Volby jsou "Manta terminal" a "Manta"
== Nastavení seznamů ==
Vizuální nastavení seznamů (layoutů) se provádí ve ve webové konfiguraci sekce Seznamy. Zde jsou uvedeny všechny seznamy u kterých je možné konfigurovat rozložení. Kliknutím na příslušný seznam se dostaneme do detailu. V detailu je seznam všech rozložení k danému typu seznamu. Vždy musí existovat alespoň jedno rozložení, které nemá vyplněnu žádnou roli ani typ zařízení. Pak můžou následovat libovolné kombinace nastavení pro roli a zařízení. V detailu de rovněž přejít do formátovaná atributů, které se na layoutu zobrazují. Je třeba pomatovat na to, že formátování se váže k podkladovému view a ne ke konkrétnímu layoutu. Tedy změnou formátu můžu ovlivnit chování ve více layoutech pokud čerpají ze stejného view. Kliknutím na tlačítko Přidat rozložení můžu přidat další layout pro novou kombinaci role/typ zařízení. Před samotným založením layoutu jste dotázáni na defaultní počet řádků a sloupců. Toto je třeba si důkladně rozmyslet protože následně už není možné změnit.
[[Soubor:Ikona upozornění.png|vlevo|bezrámu]]
'''Doporučujeme obecně zadat větší čísla ! Například 10 řádků a 6-8 sloupců.''' Prázdné neobsazené řádky layoutu budou při zobrazení ignorovány a sloupce jde slučovat, a tedy získáme možnost jemnějšího "rastru" pro umísťování atributů z view. Plocha layoutu je vždy rozdělena na 3 oblasti
* '''Štítek řádku''' - je zobrazen tučně v záhlaví řádku
* '''Rozložení řádku''' (této oblasti se týká nastavení řádků a sloupců) - je zobrazeno na dalších řádcích pod nadpisem.
* '''Výchozí nezobrazované hodnoty''' - tyto hodnoty nejsou vidět , ale je nutné je mít vyplněné pro fungování Manty. Pokud si tedy zakládáte svůj nový layout zkopírujte tyto atributu z defaultu !
Layout se nastavuje přetažením atributu ze sloupce vlevo (všechny atributy z view) do plochy layoutu v pravé straně.
[[Soubor:Ikona upozornění.png|vlevo|bezrámu]]
'''Pozor! Nejdříve si uložte layout a potom teprve nestavujte řazení!'''
K jednotlivým seznamům se váží také filtry. Ty ovlivňují jaké řádky v layoutech uvidíte (např. fronta práce jen na určité pracoviště) .
Filtry jsou:
* '''Systémové''' - nejdou měnit v Mantě a váží se globálně k celému řešení
* '''Uživatelské''' - jdou měnit v prostředí Manty (trychtýř v pravém horním rohu) a váží se k uživateli
[[Soubor:Ikona upozornění.png|vlevo|bezrámu]]
Obecné doporučení pro filtry je omezit je na nezbytně nutné. Načítání zejména uživatelských filtrů může zpomalit chod aplikace !
== Systémové parametry ==
Kompletní seznam šablon atributů najdete [[Rozšiřující atributy|zde]].
Použití systémových proměnných ve vlastním kódu (vsuvky, háčky):
<code>SELECT @promena=CAST(dbo.'''FMANTA_ReturnParametr'''(<'''IdMaster'''>,<'''Code'''>,<'''Parametr'''>) as <požadovaný datový typ>)</code>
* '''IdMaster''' - id zařízení v případě dohledávání terminálové proměnné, 0 v případě globální proměnné
* '''Code''' - 1 pro terminálovou proměnnou, 2 - pro globální proměnnou
* '''Parametr''' - Textový název hledaného parametru
== Názvy a význam nejpoužívanějších proměněných v procedurách ==
{| class="wikitable"
|+
!Název promněné
!datový typ
!popis
!poznámka
|-
|@TerminalID
|int
|id zařízení z kterého se procedura volá
|
|-
|@EmployeeID
|int
|id operátora, který vyvolal spuštění procedury
|
|-
|@WorkPlaceID
|int
|id pracoviště z kterého se procedura volá
|
|-
|@Barcode
|nvarchar(40)
|sejmutý čárový kód
|
|-
|@checkLevel
|int
|0/1 při 1 kontroluje měkké hlášky, při 0 přeskakuje měkké hlášky
|
|-
|@TW/@TeamWork
|bit
|označení teamové /netýmové práce
|
|-
|@OperationId
|int
|id operace s kterým se procedura volá
|
|-
|@Selectem
|bit
|určuje jestli procedura vrátí select ( při 1) hodnot nebo jednu hodnotu (při 0)
|
|-
|@Quantity
|numeric(19,6)
|vetšinou pro zadání množství
|
|-
|@LogIn
|bit
|určuje zda probíhá zahájení dané (1) akce nebo ukončení dané akce (0).
|
|-
|@TerminalEvent
|smallInt
|určuje o jakou akci v rámci Manty se jedná.
1 Přihlášení operátora na Terminal
2 Přihlášení operátora na pracovišti
3 Přihlášení Operace na pracovišti
4 Přihlášení Operace na operátora
5 Prostoj (zahájení / ukončení)
6 Zápis kusů OK
7 Zápis kusů NOK
8 Snímek zaměstnance
9 Snímek stroje
|
|-
|@returnID
|int
|Návratová hodnota v případě selectem=0
|
|}
|}
== Uživatelské vsuvky (háčky) ==
=== Správa APK balíčků ===
{| class="wikitable"
Ve webové konfiguraci je dostupná sekce:
|Název procedury
{{CodeBox|
|Volá se z
'''Menu → Aplikace → Správa APK balíčků'''
|Parametry
}}
|Popis
Slouží k:
|-
|'''SPMANTA_EP_FindOpBarCode1'''
|SPMANTA_FindOpBarCode
|@TerminalID,
@EmployeeID
,@WorkPlaceID,
@Barcode
,@checkLevel
,@TW
|Vlastní procedura , která zpracuje sejmutý čárový kód a dohledá operace, které se mají přihlásit
|-
|SPMANTA_CHECK_DoReg
|SPMANTA_DoRegistration
|@TerminalId
,@WorkplaceId
,@EmployeeId
,@OperationId
,@WithPrint
,@LastEvid
,@Selectem
,@checkLevel
|slepá procedura pro měkkou kontrolu
|-
|SPMANTA_DoRegistration_EP1
|SPMANTA_DoRegistration
|@TerminalId
,@EmployeeId
,@WorkplaceID
,@operationId
|slepá procedura před výpočtem časů z operací a uložení do přenosové tabulky
|-
|PMANTA_DoRegistration_EP2
|SPMANTA_DoRegistration_EP2
|@TerminalId
,@EmployeeId
,@WorkplaceID
,@operationId
,@Quantity
,@Evid
|slepá procedura po výpočtu časů z operací a uložení do přenosové tabulky
|-
|SPMANTA_EP_WTOD_Te1AfterLogin
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
|uložená procedura po přihlášení operátora na terminál
|-
|SPMANTA_EP_WTOD_Te1AfterLogOut
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
|uložená procedura po odhlášení operátora z terminálu
|-
|SPMANTA_EP_WTOD_Te2AfterLogin
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
,@EmployeeID
,@WorkplaceID
|uložená procedura po přihlášení zaměstnance na pracoviště
|-
|PMANTA_EP_WTOD_Te2AfterLogOut
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
,@EmployeeID
,@WorkplaceID
,@TeamWork
|ložená procedura po odhlášení zaměstnance z pracoviště
|-
|SPMANTA_EP_WTOD_Te3AfterLogin
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
,@EmployeeID
,@WorkplaceID
,@OperationId
,@returnID
|ložená procedura po přihlášení operace na pracoviště
|-
|SPMANTA_EP_WTOD_Te3AfterLogOut
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
,@EmployeeID
,@WorkplaceID
,@OperationId
|uložená procedura po odhlášení operace z pracoviste
|-
|SPMANTA_EP_WTOD_Te4AfterLogin
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
,@EmployeeID
* správě verzí APK
* nahrávání nových balíčků
* generování QR kódů pro instalaci a konfiguraci terminálů
,@WorkplaceID
Standardně se nové APK nahrají automaticky při aktualizaci Manty.
,@OperationId
=== Provoz Manty na Windows terminálech ===
|ložená procedura po přihlášení operace na zaměstnance
Na některých typech zařízení může být Manta provozována prostřednictvím Android aplikace spuštěné v prostředí Windows pomocí subsystému '''WSA (Subsystem Windows pro Android)'''.
|-
{{Alert| '''WSA''' již společnost Microsoft oficialně '''nepodporuje''', nicméně i tak je možné subsystém nainstalovat a využívat}}
|SPMANTA_EP_WTOD_Te4AfterLogOut
{{CodeBox|[http://manta.nvsp.cz/wiki/index.php/Windows_Subsystem_for_Android_(WSA) Instalace '''subsystem Windows pro Android''' ]}}
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
,@EmployeeID
,@WorkplaceID
,@OperationId
|uložená procedura po odhlášení operace ze zaměstnance
|-
|SPMANTA_EP_WTOD_Te6BeforLogin
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
,@EmployeeID
,@WorkplaceID
,@OperationId
,@returnID
|uložená procedura před zápisem kusů
|-
|SPMANTA_EP_WTOD_Te6AfterLogin
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
,@EmployeeID
,@WorkplaceID
,@OperationId
,@returnID
|uložená procedura po zápisu OK kusů
|-
|SPMANTA_EP_WTOD_Te7BeforLogin
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
,@EmployeeID
,@WorkplaceID
,@OperationId
|uložená procedura před zápisem NOK kusů
|-
|SPMANTA_EP_WTOD_Te7AfterLogin
|SPMANTA_WriteToOutdata
|@TerminalId
,@TerminalEvent
,@LogIn
,@EmployeeID
,@WorkplaceID
,@OperationId
,@returnID
|uložená procedura po zápisu NOK kusů
|-
|SPMANTA_EP_WTOD_Te1
|SPMANTA_WTOD_TE1
|@TerminalId
,@TerminalEvent
,@LogIn
,@WorkplaceId
,@ProductOrderId
,@EmployeeId
,@OperationId
,@ToolId
,@ActionCode
,@MU
,@StartDate
,@FinishDate
,@ContractId
,@UnitId
,@LotId
,@DefectCode
,@WorkShift
,@NumberOfCycles
,@quantityOK
,@QuantityNOKRepairable
,@QuantityNOKRepairableIR
,@QuantityNOKNonreparable
,@TimeS
,@Parent
,@Note
,@Raster
,@NeedSN
,@UseSN
,@SNID
,@OutdataID
,@LabelCount
,@Selectem
,@checkLevel
|Procedura nahrazující standardní kód pro přihlášení operace
|-
|SPMANTA_EP_WTOD_Te2
|SPMANTA_WTOD_TE2
|
|Podobně jako SPMANTA_EP_WTOD_Te1, ale pro jiný terminál event
|-
|SPMANTA_EP_WTOD_Te3
|SPMANTA_WTOD_TE3
|
|Podobně jako SPMANTA_EP_WTOD_Te1, ale pro jiný terminál event
|-
|SPMANTA_EP_WTOD_Te4
|SPMANTA_WTOD_TE4
|
|Podobně jako SPMANTA_EP_WTOD_Te1, ale pro jiný terminál event
|-
|SPMANTA_EP_WTOD_Te5
|SPMANTA_WTOD_TE5
|
|Podobně jako SPMANTA_EP_WTOD_Te1, ale pro jiný terminál event
Tato sekce poskytuje základní technický přehled architektury, požadavků a provozních principů řešení Manta pro zákazníky a implementační partnery.
Řešení
Manta je navržena jako server–terminálové řešení, kde aplikační server zajišťuje centrální logiku a databázové operace a terminály (Android) slouží jako klientská zařízení.
Řešení je optimalizováno pro stabilní provoz ve výrobním prostředí a není extrémně náročné na výkon serveru.
Doporučené parametry aplikačního serveru
Pro standardní nasazení (do cca 50 současně aktivních zařízení):
ℹ️
CPU: 8+ jader
RAM: 16+ GB
Uložiště: 250+ GB SSD/NVMe
Síťové připojení: 1 Gbit Ethernet
OS: Windows Server 2019+
Všechny potřebné softwarové komponenty jsou instalovány automaticky v rámci instalačního procesu Manty.
pro funcionalitu je využíván primarně IIS (Internet Information Services).
zavislosti v IS Helios
Pro úspěšnou instalaci Manty musí být v Heliosu (platí pro inuvio) nainstalován modul: Evidence zboží na lokacích (Gatema)
Po dokončení jsou nainstalovány komponenty v Heliosu a komunikační můstek mezi serverem a terminály.
Oprazovka Instalátoru
Po spuštění Instalátoru se objeví zakladní okno pro výběr profilů.
Editace Profilu
💻
Název profilu: Necháte stejný, nebo si ho přejmnujete na svůj název
Cesta k Helios.exe: Pomoci “...” vpravo si nalistujete tento soubor, tam kde ho máte umístěný
Db server: Doplní se automaticky po vyplnění “2”
SQL login: Uživatelské jméno do Heliosu
SQL heslo: Heslo do Heliosu
Databáze: Předvyplní se automaticky po “2” . Kliknutím do pole s názvem databáze se vám zobrazí další databáze, které jsou dostupné a tu kterou chcete si vyberete.
Licenční soubor: pomocí “...” vpravo si vyberete licenční soubor
Uložit
Instalace Manta (Klient)
Koncové zařízení tvoří Android zařízení tablet, AIO, nebo ruční zařízení.
Nejjednodušší způsob instalace terminálů je pomocí QR kódů. Dále je možné APK soubor stáhnout v rámci webové konfigurace.
Používají se dva typy QR kódů:
QR kód stažení aplikace – stáhne a nainstaluje nejnovější verzi aplikace
QR kód přihlášení – nastaví přístupové údaje k serveru
QR kódy lze generovat:
v instalačním nástroji Manty
ve webové konfiguraci:
💻
Menu → Aplikace → Správa APK balíčků
Menu Nastavení
Nastavení lze importovat a exportovat z koncového zařízení i přes soubor *.json
Tyto možnosti jsou v ramci android aplikace v menu nastavení.
Správa APK balíčků
Ve webové konfiguraci je dostupná sekce:
💻
Menu → Aplikace → Správa APK balíčků
Slouží k:
správě verzí APK
nahrávání nových balíčků
generování QR kódů pro instalaci a konfiguraci terminálů
Standardně se nové APK nahrají automaticky při aktualizaci Manty.
Provoz Manty na Windows terminálech
Na některých typech zařízení může být Manta provozována prostřednictvím Android aplikace spuštěné v prostředí Windows pomocí subsystému WSA (Subsystem Windows pro Android).
⚠️
WSA již společnost Microsoft oficialně nepodporuje, nicméně i tak je možné subsystém nainstalovat a využívat