Úvod
Tato aplikace je napsána v PML2 a její funkčnost byla testována v PDMS verze 12Sp.6.
Primárním cílem této aplikace je umožnit uživatelům jednoduché operace a i případnou vyměnu tzv. designových drawlistů.
Požadavky
Vlastní aplikace vyžaduje mít právo čtení a zápisu (RW) do adresáře nastaveného v evar pdmsuser a jeho podadresářů.
Předpoklady
Pro užívání této aplikace nejsou vyžadovány žádné nadstandardní znalosti z oblasti PDMS.
Upozornění
Jelikož se jedná o aplikaci vyžadující možnost zápisu souboru na HD a to nejen do předem definovaného adresáře, ale i na jiná místa, kde má uživatel právo zápisu, nelze zamezit smazání těchto souborů mimo PDMS.
Pokud používáte více aplikací z produkce Ripra s.r.o pak při instalaci může dojít k informaci o snaze přepsat existující soubor. S největší pravděpodobností se toto bude týkat grafických souborů *.png. Jde o případ, kdy více aplikací používá tentýž grafický soubor. Pokud si nejste jisti, přepsání nepotvrzujte a proveďte kontrolu shody.
Existují soubory využívané vícero Ripra aplikacemi a mohou se různit na základě postupného vývoje, proto je nutno si ověřit, zda dříve instalovaná aplikace je stále aktuální a přepsáním nedojde k jejímu znehodnocení. Neváhejte nás v jakémkoli případě nejasnosti kontaktovat.
Doporučení
Pro ukládání je vhodné mít, mimo lokálního předdefinovaného uložiště, definované multiuživatelsky přístupné uložiště.
Pro ukládání designových drawlistů není vytvořena omezující podmínka, ale pro jednoduší orientaci a manipulaci doporučujeme definovat projektové uložiště.
Nápověda
Aplikace je sice dodávána včetně tohoto manuálu, ale má zabudovánu nápovědu tzv. Ripra Help. Tím je uživateli umožněno, kdykoliv je připojen k internetu si nastudovat přesnou funkčnost jednotlivých prvků a funkcí aplikace. Zároveň je tím uživateli umožněna kontrola, zda jím používaná verze aplikace je tou poslední a jaká vylepšení má nová verze.
Popis aplikace
Jméno aplikace: |
RA - Drawlist Manager |
Zkratka: |
RADV |
Funkce: |
Aplikace umožňující jednoduchou manipulaci s designovými drawlisty |
Popis: |
Dokovací forma |
Revize: |
1.1 |
Verze PDMS: |
12.0Sp6 |
Autor: |
Ing. František Ringmaier |
GSM: |
+420775650721 |
Email: |
fr@ripra.cz |
Datum: |
11/2012 |
Základní nastavení cest
- /%pmllib%/ripra/icons/
- /%pmllib%/ripra/objects/ *
- /%pmllib%/ripra/radv/
Seznam souborů
- loadripraradv.pmlfnc
- ripraradv.pmlfrm
- riprapum.pmlobj *
- riprapomoc.png
- ripradismis.png
- ripradrawlistzoom.png
- riprafileopen.png
- ripraemall.png
- ripraviewrest.png
- ripraviewsave.png
* pouze pro uživatele více Ripra aplikací
Změny oproti předchozí verzi
- změna zápisu
- odstraněna chybová hláška při přerušení načítání
Souborové složení zachováno, při update z verze 1.0 postačuje pouze náhrada souboru ripraradv.pmlfrm.
Instalace
Při samotné instalaci je třeba na multiuživatelsky dostupný disk provést kopii dodaných souborů do zvoleného adresáře. Cesta do tohoto adresáře musí být deklarována v definici proměnné %PMLLIB%. Tato je obvykle deklarována v souboru %PDMSEXE%\Evars.bat. Pokud u ardresáře zvoleného pro instalaci tomu tak není, je nutno cestu do tohoto adresáře přidat do definice. Dále je nutno zabezpečit práva čtení a zápisu do tohoto adresáře.
Pro jednoduchou zprávu a pozdější snadnou kontrolu a update aplikace doporučujeme následující strukturu.
V multiuživatelsky přístupném adresáři zahrnutém v definici proměnné %PMLLIB% vytvořit podadresář ripra a do něj rozbalit zazipovanou aplikaci. Takže výsledek by mohl vypadat cca. takto:

Hlavní část této alikace je uložena v podadresáři radv, sdílené části v icons a objects viz. základní nastavení cest a seznam souborů.
Spuštění aplikace
Vlastní aplikace se spouští voláním: !!loadripraradv()
Tento příkaz je po správné instalaci proveditelný jak z příkazové řádky, tak je jej možno přiřadit do menu.
Po vykonání se zakotví u horního okraje forma (viz. obrázek).
Popis formy
Jedná se o dokovací formu s nastavitelnou velikostí. Vlastní forma je tvořena jedním řádkem ovládacích prvků.
Na následujících obrázcích je aplikace zobrazena pro oba stavy přepínače nastavujícího zda se před načtením uloženého drawlistu vyprázdní aktuální designový drawlist či nikoliv.
Popis prvků formy
Ovládací prvek |
Popis |
 |
Přepínač určující, že se před načtením vybraného drawlistu vymažou všechny zobrazene elementy a dojde tedy nejprve k vyprázdnění a poté k naplnění designového drawlistu. |
 |
Přepínač určující, že se před načtením vybraného drawlistu nevymažou všechny zobrazené elementy a dojde tedy k rozšíření stávajícího designového drawlistu. |
 |
Načtení uloženého designového drawlistu z vybraného souboru |
 |
Uložení aktuálního designového drawlistu do souboru s uživatelem definovaným jménem |
 |
Nastaví limity grafického view na aktuální designový drawlist |
 |
Ripra nápověda |
 |
Konec aplikace |
Popis práce s aplikací
Pro rychlejší nalezení souborů s uloženými drawlisty bylo zvoleno omezení volnosti názvů a to omezením definice přípony. Zároveň jméno souboru musí splňovat podmínky pro definici jmen v PDMS. Je tedy zakázáno používání mezer ve jméně souboru. Koncovka souboru je tvořena kodem projektu rozšířenou o řetězec –DISP. Toto umožňuje přímé sortování uložených drawlistů pro daný projekt, ale znovu musíme upozornit, jedná se o externí soubor a jako takový může být uživatelem majícím RW přístup editován, přejmenován nebo smazán mimo PDMS.
Aplikace umožňuje dvě základní funkce:
- Uložení aktuálního designového drawlistu
- Načtení uloženého drawlistu do designového grafického view
- před načtením vybraného drawlistu se vymažou všechny zobrazene elementy a dojde nejprve k vyprázdnění a poté k naplnění designového drawlistu
- před načtením vybraného drawlistu se nevymažou všechny zobrazené elementy a dojde k rozšíření stávajícího designového drawlistu
Uložení aktuálního drawlistu
Pro uložení stávajícího designového drawlistu je nutno kliknout na
. Následně se zobrazí okno (viz. následující obrázek) umožňující uživateli definovat umístění a název souboru do něhož bude uložen obsah aktuálního designového drawlistu.

Načtení vybraného drawlistu
Pro načtení drawlistu z uloženého souboru je nutno kliknout na
. Následně se zobrazí okno (viz. následující obrázek) umožňující uživateli definovat umístění a název souboru z něhož bude aktualizován obsah designového drawlistu a grafické view.
Rozsah vlastní aktualizace je dán stavem přepínače
/
viz popis prvků formy.

Ripra nápověda
Kliknutím na
dojde k spuštění internet exploreru na předem definované adrese.
U tohoto knoflíku může být aktivováno vyskakovací menu umožňující volání jiných Ripra aplikací. Toto menu je aktivováno jen uživatelům používajícím více Ripra aplikací. Pro uživatele pouze této aplikace je logicky neaktivní.
Ukončení aplikace
K ukončení aplikace dojde po kliknutí na
. Aplikace končí ukrytím formy z obrazovky.
Plánovaná rozšíření
- verifikovat pro PDMS 12.1
- umožnit odesílat soubor jako přílohu emailu