Egyszerű szkórlap generáló GenScoreCard V. 1.0.2 janu 2015. január 6. A technika fejlődésével a bridzsversenyek is jelentős változáson mentek keresztül. Amíg régebben fáradságos kézi számolással állapították meg az eredményt, ma már gyakorlatilag a verseny (forduló) befejezését követően néhány perc alatt számítógépes programmal előállítható. A PALATINUS BRIDGE KLUB jelenleg még nem rendelkezik elektronikus eredmény rögzítővel, de mindent megtesz annak érdekében, hogy a versenyek eredményét a lehető leghamarabb nyilvánosságra hozza. Jelenleg a papír alapú szkór vezetés a megoldás, amit rögzítenek és számítógépes program állapítja meg az eredményt. A szkórlapok elkészítéséhez egy Excel-makró szolgált. Ennek komolyabb módosításával, egyes részeinek teljes átdolgozásával új megoldás született. Ez a dokumentáció a telepítéssel és a használattal foglalkozik. Tartalomjegyzék 1. Rövid ismertető 1 2. Telepítés 2 2.1. A fájlok elhelyezése............................. 2 2.2. A Competitions.txt szerkezete...................... 3 3. A makró használata 3 4. Korlátok 4 5. Hibajelenségek 4 6. Történet 5 1. Rövid ismertető Ma már majdnem minden klubban természetes az előre elkészített leosztások. Ezeket jellemzően programmal és osztógéppel állítják elő. Az osztógépet vezérlő program ké- PALATINUS BRIDGE KLUB kiadvány 1
2 TELEPÍTÉS pes.pbn 1 fájlokat is előállítani, ami számos olyan információt is tartalmaz(hat), ami az leosztás elemzéséhez támogatást nyújt(hat). Az ismertetendő Excel makró ezt a lehetőséget használja ki. A leosztást tartalmazó.pbn fájlok előállításához feltétlenül szükséges az előállító program elemzőjét is futtatni (ma már ez a generálás során automatikusan indul). A szkórlap generáló egyik szolgáltatását ugyanis az így nyert adatok alapján képzi. Feltételezésünk szerint ez az egyes partik helyben történő, lejátszás utáni mérlegeléséhez segítséget nyújt. A következő képen látható a beépített többlet-információ: a kezenkénti (égtájankénti) lehetséges ütésszám, valamint az elemző által megállapított optimális felvétel. Lényeges a játékosok figyelmét arra felhívni, hogy az itt látható ütésszám, illetve optimális felvétel meghatározása ún. 52 lapos elemzéssel történt, ami nem minden esetben érhető el asztal melletti licitálással, illetve játékkal. De a legtöbb esetben természetesen az elemző helyesen állapította meg a feltüntetett értékeket. További újdonság a könnyebb kezelhetőség. Ezt a program használatánál ismertetem. 2. Telepítés Az Excel makrónak (értelemszerűen :-) ) szüksége van telepített Microsoft Windows R rendszerre, és olyan Microsoft Office R programcsomagra, ami tartalmazza az Excel R programot is. A telepítés egyszerűsége miatt nincs külön telepítő megoldás. 2.1. A fájlok elhelyezése Az Excel-makró bárhol elhelyezhető, ahol a felhasználók elérhetik (nem kell hozzá rendszergazdai jogosultság). Tekintettel arra, hogy a makró megnyit és olvas egy szöveges állományt, amely a szóba jöhető versenyeket tartalmazza, és ennek helye kötött, javaslom magát az Excel fájlt ugyanott elhelyezni. A véletlen felülírás elkerülésére célszerű csak olvasható beállítással ellátni. A segédállomány neve: Competitions.txt, helye: C:\Program Files\GeScoreCard. A neve is kötött. Ezt is érdemes csak olvasható -vá tenni a véletlen felülírás elkerülésére. 1 Portable Bridge Notation file www.palatinusbridge.hu 2
2.2 A Competitions.txt szerkezete 3 A MAKRÓ HASZNÁLATA 2.2. A Competitions.txt szerkezete Ez az egyszerű szöveges állomány lényegében egy verseny elnevezéseket tartalmazó fájl. az 1. pozíción a verseny napja szerepel számmal (1: hétfő, 2: kedd stb.). Elvileg az egyes tételek sorrendje kötetlen, mégis javaslom a napok szerinti sorrend megtartását. a 2. pozíciótól kezdve a verseny egyedi elnevezése szerepel. Ez nem haladhatja meg a 30 karaktert (de túl sok nagybetű használata esetén ez kevesebb is lehet), ellenkező esetben a forma szétesik. Az egyediség elengedhetetlen, mert ez a rendezési kulcs. Ugyanolyan nevű verseny meghiúsítja a program működését (akkor is, ha nem ugyanazon a napon van). Ezzel szemben eltérő nevű, de ugyanazon a napon lévő verseny kezelésére a makró alkalmas. Egy sorban csak egy tétel szerepelhet és az utolsó tétel után is szükséges egy újsor karakter. Üres sorokat lehet alkalmazni a jobb olvashatóság érdekében (bár ilyen kis állomány esetén nincs jelentősége), azonban megjegyzés sorokat a makró jelenleg nem kezel. 3. A makró használata Különösebb ismeretet nem igényel. Elindítását követően megjelenik egy legördülő menüt tartalmazó ablak, amelyet lenyitva látható a kiválasztható versenyek listája dátum sorrendben. Jelenleg csak egy hétre előre lehet a szkórlapokat előállítani, és nem tervezem ennek kibővítését 2. Ha a Mégse gombra kattintunk, egy figyelmeztető ablak jelenik meg, amiben az OK -ra kattintva a futás befejezhető. A megfelelő verseny kiválasztása után megjelenik a fájlválasztó ablak. Jelenleg nincs preferált könyvtár, így ezen belül kell megkeresni a megfelelő tárolót. Amennyiben nem választunk ki fájlt, a Rendben ( OK ) gombra kattintva nem lehet kilépni. Ha a Mégsem ( Cancel ) gombot nyomjuk meg, az előzőhöz hasonló figyelmeztető ablak jelenik meg, az itt lévő OK gomb lenyomásával a makró futása befejeződik (megszakad). A makró ezek után a kiválasztott állomány adataiból megállapítja a szükséges tokszámot, majd az adatok beolvasását követően elkészíti a szkórlapokat. Amennyiben páratlan számú leosztás készült, az utolsó lapon jobboldalt 0 tokszámmal egy üres szkórlap szerepel. A befejezésről egy tájékoztató üzenet jelenik meg, ami szerint a teljes nyomtatandó terület ki lett jelölve, így az OK lenyomását követően a nyomtatás azonnal megkezdhető. A legenerált szkórlapok nyomtatását követően az Excel-ből mentési figyelmeztetés nélkül ki lehet lépni. Ha az elkészült állomány mentésére szükség lenne, a Fájl Mentés másként menüponton keresztül van erre lehetőség. 2 De ha komoly igény mutatkozik... www.palatinusbridge.hu 3
5 HIBAJELENSÉGEK 4. Korlátok Az eredeti 3 makróval szemben jelenleg csak 64 leosztás kezelésére alkalmas ez a változat. Nagyobb tokszámot nem látok indokoltnak, de igény esetén ez a korlát emelhető. Habár a makró amennyire ez Excelből lehetséges üríti a vágólapot, mégis előfordulhat, hogy kilépéskor figyelmeztető üzenet jelenik meg, ami egyben felajánlja a vágólap tartalmának más programok számára való megőrzését. Ezt érdemes figyelme kívül hagyni. 5. Hibajelenségek A hibakezelés nem teljes körű. Ennek egyrészt az az oka, hogy a táblázatkezelők makrónyelvének korlátai vannak 4, másrészt az elsődleges cél a működőképesség volt, ezért jelenleg a verseny-megnevezés egyediségének megsértése a működést ellehetetleníti, de ennek figyelése a jövőben megoldandó feladat. Feltételezésem szerint a kezelő elvárható gondossággal tudja ezt biztosítani, üres Competitions.txt állomány azzal a következménnyel járhat, hogy a verseny kiválasztó ablak üres marad. Ha a verseny megnevezése üres, akkor a dátum alapján a tétel kiválasztható és a szkórlapok generálhatók (bár ezt nem próbáltam ki), bár nem hiba, de itt említem meg, hogy a szkórlap generálása elég lassú. Ennek elsőrendű oka a kijelölt lap másolásának lassúsága..., nem ismerem az összes eredmény számoló programot, de valószínűleg mindegyik régebbi változatánál felmerül, hogy a.pbn fájlok szerkezete már eltérő. A makró a BOS V. 7.0.6 5 által szolgáltatott állományt veszi alapul. Amennyiben régebbi program állította elő a referencia állományt, elképzelhető, hogy az optimális felvétel (par score) nem jelenik meg. Ebben az esetben egy modernebb programon keresztül új elemzést kell készíttetni. Ez visszafelé is igaz, ha az újabb programmal készített referencia állományt a makró kezeli, de a régebbi eredmény számítók az elemző eredményét nem tudják értelmezni, ezért a teljesség érdekében ebben a programban is futtatni kell az elemzőt, ha az elemzés nem fejeződött be, és ilyen állomány kerül a makró kezelésébe, futási hiba jelentkezik. Mindenképpen meg kell győződni arról, hogy az elemző minden partit kielemzett! Az itt nem említett hibák előfordulása esetén jelzést kérek a hgjanu@palatinusbridge.hu e-mail címre. 3 Marjai Gábor által írt 4 Ez nemcsak az Excelre, de más forgalomban lévő táblázatkezelőre is igaz. 5 Copyright c Jannersten Vörlag www.palatinusbridge.hu 4
6 TÖRTÉNET 6. Történet 0.4.1 2014. június 11. Az eredeti változat:.pbn fájl alapján az elemzés beépítése. 0.9.15 2015. január 4. A dirty flag beállítása: most már nem akar menteni, ha kilépünk. Ha mégis kell mentés, azt külön el kell végezni. 1.0.2 2015. január 6. Kisebb kódtisztítás mellett a makró neve és verzió száma megjelenik a szkórlapon. Egyelőre ezt véglegesnek szánom. www.palatinusbridge.hu 5