Üzemeltetési Kézikönyv kiegészítés 4. Automatikus CSV alapú mérési eredmény export

PortaWin (PW2) Jármű mérlegelő program

Módosítva: 2014. 1. 9.

Ver:1.2

Érvényes:2013. 10. 21.

METRISoft Mérleggyártó KFT 6800 Hódmezővásárhely Jókai u. 30 Telefon: (62) 246-657, Fax: (62) 249-765 e-mail: [email protected] Web: http://www.metrisoft.hu D:\R\PW2\Leiras\Uzem\Ukieg04.odt

PortaWin (PW2) Jármű mérlegelő program Üzemeltetési Kézikönyv kiegészítés 4. Automatikus CSV alapú mérési eredmény export

Hódmezővásárhely, 2014. január 9. Készítette: Petényi István programozó METRISoft Kft.

11/2

Http://www.metrisoft.hu

PW2 Jármű Mérlegelő Program Üzemeltetési Kézikönyv kiegészítés 4.

METRISoft KFT Hmvhely Jókai u.30.


PW2 Jármű Mérlegelő Program Automatikus CSV alapú mérési eredmény export

11/3

Tartalomjegyzék 1. TEXT EXPORT SZOLGÁLTATÁS ÁLTALÁNOS ISMÉRVEI..................................................................4 2. ÁLTALÁNOS BEÁLLÍTÁSOK........................................................................................................................4 2.1. ÁLTALÁNOS EXPORT OPCIÓK KONFIGURÁLÁSA.......................................................................................................4 2.2. AZ EXPORTÁLHATÓ ADATOSZLOPOK......................................................................................................................6 2.3. EGYSZERŰ (FORMÁZOTT) REKORD EXPORT TARTALMI BEÁLLÍTÁSOK AZ ADATSZÓTÁRBAN ......................................6 2.3.1. Exportálandó mezők meghatározása 'Egyszerű rekord export'.................................................................7 2.3.2. Exportálandó mezők meghatározása 'Egyszerű formázott rekord export'................................................7 2.3.2.1Karakteres adatok formázása (STRCUT)...............................................................................................................7 2.3.2.2Dátum mezők formázása........................................................................................................................................8 2.3.2.3Fixpontos (float) számok formázása.......................................................................................................................9 2.3.2.4Logikai adat formázása...........................................................................................................................................9

2.4. FORMÁZÁS KÜLÖN FORMÁTUMFÁJL SEGÍTSÉGÉVEL.................................................................................................9

Mellékletek: További dokumentumok: PW2 Jármű Mérlegelő Program Üzemeltetési Kézikönyv PW2 Jármű Mérlegelő Program Üzemeltetési Kézikönyv Kiegészítés I. PW2 Jármű Mérlegelő Program Üzemeltetési Kézikönyv Kiegészítés II. PW2 Jármű Mérlegelő Program Üzemeltetési Kézikönyv Kiegészítés III.

File:D:\R\PW2\Leiras\Uzem\Ukieg04.odt

11/4



1. Text export szolgáltatás általános ismérvei Az export szolgáltatás egy opció, melyet megrendelés esetén a Szoftver Licensz engedélyez! Ennek alkalmazási területe: a mérlegelési tétel archiválásakor, egyetlen alkalommal az adatrekord egy előírt formában fizikai fájlba íródik. Az így exportált fájl(ok) a továbbiakban más rendszerek számára hozzáférhetők. Az export nem ismételhető meg. Az export automatikusan történik, a kezelő személy számára ez nem látható. Az export szolgáltatás minden vonatkozásban igen változatosan konfigurálható, így jól illeszthető a feldolgozó rendszerek bemenetéhez. Az export szolgáltatást adott esetben maga a mérlegprogram is kihasználja, ha igény szerint a mérlegelési adatokat pl. a beépített e-mail küldési lehetőséggel kell 'postázni'. Az export akár egy egyszerű archiválást is jelenthet, amely segítségével adatállomány sérülések után az adatok visszanyeréséhez támogatásként szolgálhat1.

2. Általános beállítások Az általános paraméterek a program Beállítások >> Program konfiguráció [leállított rendszer] ablakban állíthatók be. Kapcsolat konfigurálás PW2 rendszerben: * Az export szolgáltatás védett konfigurációban be/kikapcsolható. (NaploTextExport) * Az import szolgáltatás listázó munkahelyeken védett konfigurációban be/kikapcsolható. (NaploTextImport) /ez a szolgáltatás a program V2.3.9.29 verziótól használható/ * A mérési naplóban levő összes adatmező bármelyike szükség/igény szerint tetszőleges sorrendben és szinte tetszőleges formázással exportálható. Ha külön nincs meghatározva más, akkor minden adatmező exportra kerül a mérési napló tábla oszlopok sorrendjében. * Konfigurálható az átadó text file: neve NaploTextExportFile, útvonala NaploTextExportPath, a szövegadatok kódlapja TextExportToOEM (magyar nyelvű windows esetén): OEM (hun852) vagy ACP (win1250). Default beállítás: \PW2\DBF\EXPORT\NSEND.TXT, win1250 kódlappal * Az export rekordokban a mezők elválasztó karaktere konfigurálható Default beállítás: 0FEHEX (254DEC) (NaploTextExpDelimiter) * Az export file egy text file az export rekordokban a sorok elválasztó karaktere konfigurálható Default beállítás: $13$10 (NaploTextExpRowEnd), ami standard sorvéget jelent. * Egyszerű rekord exportálási mód, amely text vagy DBF formátum / illetve formafájl szerint formázott text exportálási mód határozható meg a NaploTextExportForm paraméterben. A fileműveletek definiciója a PW2 rendszerben * A rekord kiírása a mérési adatlap lezárásakor kerül végrehajtásra, ezért a rekordok ezt a sorrendet követik. * A fileművelethez a file exclusive megnyitása történik meg. Ütközés esetén a PW2 egy konfigurált időzítés szerint ciklikusan kísérletezik a tranzakció végrehajtásával: az export mindenképpen meg fog történni. Megjegyezzük, hogy az ütközés miatt még nem exportált lezárt mérési rekordok a PW2 rendszer napló adatbázisába sem jutnak el a sikeres export lefutásáig! * Minden exportfile létrehozáskor a program konfigurációtól függően az első sorban kiírja az érvényes, exportra kerülő mezőnév listát. Ezzel a feldolgozó program a konstans mezőnevek szerint vektor-táblát építhet, hogy minden esetben a megfelelő adatértéket dolgozza fel. * Az adatok átvétele után a file szabadon törölhető. * Ha az export file nem létezik, a PW2 automatikusan létrehozza az első rekord kiírásával, ezért az átvevő rendszer tetszése szerint törölheti a file-t feldolgozás után. Ügyelni kell arra, hogy az átvevő program a feldolgozást követően a file zárása után késedelem nélkül törölje a file-t, nehogy a két művelet közti időrés alatt a PW2 újabb rekordot írjon a végére. * Minden eredményrekord egyetlen alkalommal kerül exportra, ennek ismétlése nem lehetséges.

2.1. Általános export opciók konfigurálása Elérési mód: beállítások => Program konfiguráció ablakban 1301[V]:NaploTextExport Ha a Szoftver Licensz engedélyezi az automatikus mérési eredmény export szolgáltatást, akkor ezzel a kapcsolóval ez külön engedélyezhető, tiltható. 8020[V]:FeladForma 1

A mérlegprogram gyárilag nem tartalmaz ilyen visszatöltési funkciót!




11/5

A táblák feladási formájának meghatározása: 0:Feladás DBASE táblákban 1:**N/A** Feladás TEXT SDF formában >> ez nincs implementálva! N/A 2:Feladás TEXT DELIMITED(,) formában 3:Feladás formázott szövegként A fentiek közül a (3) esetén a feladási formát nem az adatszótárban, hanem egy külön karbantartható szöveges konfig fájlban kell meghatározni. Ez lényegesen több lehetőséget nyújt, mint az egyszerű rekord szintű export. Ez utóbbi mezőit és azok sorrendjét közvetlenül az adatszótárban kell meghatározni. 8030[V]:DeletedMark N/A Text SDF export/feladás során kimenő text sorokba ki kell-e írni a Deleted mark oszlopot. (Egyes rendszerek a DBASE SDF rekordokat egyszerű blokkmásolással olvassák be. A Deleted Mark adatoszlop a DBASE táblák legelső, rejtett oszlopa, amely 1 karakteres. Mivel az SDF export nincs implementálva, ezért ez a paraméter sincs jelenleg használva a PortaWIn programban. 1300[V]:TextExportToOEM A Windows külön kódlap használatát teszi lehetővé a megnyitott konzol (DOS) ablakokban és a grafikus felületen. A két karakterkészlet között konverzió lehetséges. A program számára előírható, hogy a szövegeket alakítsa át OEM kódlapra, mielőtt szövegfile-ba írja. Szabályosan telepített HUN (magyar) Windows esetén az OEM kódlap a HUN852 karaktertáblát, a másik az ún. ACP (ANSI) kódlap pedig a Win-1250 karaktertáblát használja. A konverzió engedélyezése az ACP kódlapról az OEMCP kódlapra fog átalakítást engedélyezni. A konverzió hatásos a standard DBASE Text és az automatikus Text export esetében. Standard Excel, illetve Winword text export esetén ez a konverzió nem hatásos (a szövegek ACP-ben kerülnek kiírásra). 1302[V]:NaploTextExportPath Létező, írható-olvasható lemezútvonalnak kell lennie. Alapértelmezés szerint a program könyvtárából nyíló DBF\EXPORT könyvtár. 1304[V]:NaploTextExportFile Alapértelmezés szerint NSEND.TXT a file neve. Ez itt átírható. A filenévben speciális változóhivatkozások is történhetnek. Ezzel a filenév akár rekordonként egyedivé válhat. %TELEP% (mérésrekord TELEP oszlop értéke) %NOW% (kurrens időpont yyyymmddhhnnss formában) %BIZSORSZ% (mérésrekord BIZSORSZ oszlop értéke 99999999 formában) %LANCNR% (mérésrekord LANCNR oszlop értéke 99 formában) %NR% (mérésrekord NR oszlop értéke 99999999 formában) %GKRSZ% (mérésrekord GKRSZ oszlop értéke) %BIZSORSZ6% (mérésrekord BIZSORSZ oszlop értéke 999999 formában /jobbról 6 karakter/) Példa: ME%BIZSORSZ6%.CSVesetén, ha a méréstétel mérési sorszáma 00123456, akkor ez a méréstétel a ME123456.CSV nevű fájlba fog kerülni! 1306[F]:NaploTextExpDelimiter A mérésrekordon belül az adatmezők az itt megadott karakterrel különíthetők el. Olyan jelet kell itt megadni (annak kódját), amely nem fordulhat elő egyetlen adatmezőben sem. Az export során, az adatmező értékekben a program minden elválasztójel előfordulást egy '?' ($3F) karakterrel helyettesít. Ha az elválasztójel éppen '?', akkor nem történik helyettesítés és az export rekordban illegális elválasztójel szerepelhet! Megadható: 1 db decimális kód (pl. 254 >> chr(254) lesz) vagy hexa karakter, pl. $3A Export helyettesítés csak akkor történik, ha 1 karakteres a delimiter! 1306[F]:NaploTextExpRowEnd (V2.4.0.57 verziótól) Az eredményrekordok alapértelmezés szerint egymástól standard soremeléssel (#13#10) vannak elválasztva. Ebben a paraméterben ez az érték módosítható. A megadási forma hexadecimális $XX$XX... formában.



11/6


Olyan jelet kell itt megadni (annak kódját), amely nem fordulhat elő egyetlen adatmezőben sem. Több karakter megadható. Minden karaktert hexadecimális formában kell megadni 3 karakteren: $00..$FF Alapértelmezés szerinti beállítása: $0D$0A tehát standard CRLF sorvég kerül kiírásra. 1308[V]:NaploTextExportHeader Minden exportfile létrehozáskor a program e kapcsolótól függően az első sorban kiírja az érvényes, exportra kerülő mezőnév listát. Ezzel a feldolgozó program a konstans mezőnevek szerint indextáblát építhet, hogy minden esetben a megfelelő adatértéket dolgozza fel. Az exportra kerülő mezők nagybetűs nevének kiírása a mindenkori exportfile első sorába. Ez lehetővé teszi, hogy a file feldolgozása a mezőnevek értelmezésével konfiguráció függővé váljon. A paraméternek a FeladForma=3 esetben nincs szerepe! 1312[V]:NaploTextExpMertip Az automatikus text export szolgáltatásba bevonható méréstípusok felsorolása. Ha nincs kitöltve, minden méréstípus exportálásra kerül A kitöltés a méréstípusok kódjának felsorolásával történik: 0:Anyag kiszállítás 1:Anyag beszállítás 2:Ellenörző mérés 3:Idegen (bér) mérés 4:Raktárközi átadás 5:Helyesbítő számla pl. 0,1,4

>> be/ki/raktárközi

A paraméternek a FeladForma=3 esetben nincs szerepe! 1310[V]:NaploTextExpForm Text export esetén, ha a "Feladforma" a "3:Feladás formázott szövegként" módot jelöli meg, akkor a formázáshoz megadható űrlap fájl megnevezése adható itt meg. Ha az űrlap nincs definiálva, egyszerű formázott üzenet keletkezik. A fájl kötelezően a CNFPATH (default= "..\CONF") útvonalon kell legyen. Az itt megadható filenévben egyetlen változókifejezés szerepelhet: %TELEP% (mérésrekord TELEP oszlop értéke) Ez lehetővé teszi, hogy „többcéges mérlegelés” esetén cégenként külön formátum fájl készüljön.

2.2. Az exportálható adatoszlopok A program adatállományainak leírása és paraméterezése külön ún. adatszótár táblázatban van megadva. Ez a táblázat egyrészt befogadja az exportáláshoz szükséges paraméterek nagy részét, másrészt információs táblaként szolgálhat arról, hogy mely adatmezőket, milyen tartalommal lehet a külső rendszerek számára átadni. Az adatszótár elérése a külső DBGEN programmal történik. Használata előtt adott esetben a mérlegprogramból ki kell lépni. Módosítási igény esetén előtte mindenképpen készüljön egy mentés a CONF\Conf_DBF és Conf_IDX táblákról!! A programot indítva és a „Szótár nyit” gombra kattintva a beadható jelszó: modeng módosítási igény esetén. Csak megtekintéshez nem szükséges jelszó. A táblázatban blokkos felépítésben megtalálhatók a program adattábláinak leírása. Kezdve a „fej” leíróval, folytatva az adatoszlopok leírásával. A DBF_NAME oszlop tartalma fogja össze az egy állományhoz tartozó definíciókat. A FIELD_NAME oszlopban vannak az adatmező nevek. Az export szempontjából a szótár elején található NAPLO blokk tartalma az érdekes!

2.3. Egyszerű (formázott) rekord export tartalmi beállítások az adatszótárban Ha a FeladForma = 0, 1 vagy 2, akkor egyszerű rekord exportról vagy egyszerű formázott rekord exportról beszélünk! Ennek a beállítása is egyszerű. Ha nincs speciális beállítás, akkor az összes NAPLO adattábla oszlop küldésre kerül. Az adatoszlopok sorrendje megegyezik a táblamezők sorrendjével.




11/7

2.3.1. Exportálandó mezők meghatározása 'Egyszerű rekord export' Ha egyszerű rekord export történik, akkor a rekord export során a program alapértelmezett formázásokat használ, melyhez az adatszótárban levő beállításokat használja /Az adatmezőknél található LEN (karakterszám) és DEC (tizedesjegyek) ehhez felhasználásra kerülnek/: * A dátum kiírása konfigurálható, gyárilag a BDE (Borland Database Engine) aktuális beállítása szerint történik. * A fixpontos numerikus számok kiírása fixpontos alakban történik a (Len, Dec) szerint. A tizedesjel a Delphi DecimalSeparator globális változója, tehát a Windows határozza meg (általában vessző) * Logikai mezők kiírása 'True'/'False' értékkel történik (vagy üres, ha nem inicializált a mező. Ezt tekintsük False értéknek) Dátum nyomtatási formák speciális formázása /Picture_tx oszlop az adatszótárban/: Maximális forma: ‘yyyy.mm.dd hh:nn:ss’ A fentiek szerint a dátum - óra bármely része kiírható vagy elhagyható. yyyy esetén yy alkalmazható. A dátumban az év-hó-nap sorrend változtatható. Az elválasztó karakterek fix értékek, szabadon megadhatók, elhagyhatók. példák: ‘yymmdd’, ‘hhnn’, ‘mm/dd/yyyy’, ‘dd-mm-yy’, stb. Ha nem adnak meg speciális előírást, akkor a kiírást a BDE dátumforma határozza meg. A NAPLO blokk PARAM mezőiben elhelyezett ‘-ex’ jelzés előírja az adott adatmező exportját. Ehhez a DBGEN Adatszótár kezelő programot kell használni. Ez egy egyszerű konfigurálás: a mezők sorrendje a táblázat oszlopsorrendjében történik.

2.3.2. Exportálandó mezők meghatározása 'Egyszerű formázott rekord export' A NAPLO blokk PARAM mezőiben elhelyezett ‘-ex(nnn)’ jelzés előírja az adott adatmező exportját. Ehhez a DBGEN Adatszótár kezelő programot kell használni. Ugyanitt, elhelyezhető egy '-exnnn(formázás);' jelzés is, amley az export során a formázást határozza meg. Az nnn index az export listában az adatoszlop pozícióját határozza meg. Tehát pl. -ex(053); azt jelenti, hogy a kimeneti listában az 53. pozícióban kell az adatértéket elhelyezni. Egy adattábla mezőnél akár több kihelyezési utasítás is elhelyezhető (egy adat a kimeneti sor több pozícióján is szerepel). Az ehhez kapcsolódó formázási utasítás határozhatja meg, hogy miként legyen az adat megformázva. Ha nincs ilyen utasítás, akkor az egyszerű rekord export módszer kerül alkalmazásra. A formázás nem kötelező, ilyen esetben az adatmező formázás egyéb előírásai hatásosak (pl. az adatszótár LEN oszlopa a karakter/számjegy számot határozza meg általánosan, a DEC oszlop fixpontos számok esetén a tizedesjegyek számát)

2.3.2.1Karakteres adatok formázása (STRCUT) „STRCUT” Karakteres formázás (ez lehet karakter és egész szám típusú adatoszlopokra is): Kifejezés példa megjegyzés L,x,y Copy(Value,x,y) L,2,3 „ABCDEF” > BCD R,x,y Right(Value,x,y) R,3,2 „ABCDEF” > DE GL,s,y Copy(GetStr(Value,s,jfLeft),1,y) //Ha y=0: nincs GL,:,3 „ABCD:EFGH” > ABC Copy GR,s,y Copy(GetStr(Value,s,jfRight),1,y) //Ha y=0: nincs GR,:,3 „ABCD:EFGH” > EFG Copy JL,s,Y Justify(Value,y,s,jfLeft) (s követő karakterrel Y JL,*,5 „ABC” >> ABC** hosszra kiegészít) JR,s,Y Justify(Value,y,s,jfRight) (s vezető karakterrel Y JR,*,5 „ABC” >> **ABC hosszra kiegészít) CL,s,Y,Z Cut and Justify left (Y hosszra levág és Z hosszra s CL,*,3,5 „ABCDEFG” > ABC** karakterrel kiegészit) XC,s 'Indexed Char' Value kötelezően számérték XC,ABCDEFG Value=3 >> C '0'..Length(s) Result:=s[Int(Value)+1] CR,s,Y,Z Cut and Justify right: StrZero(Right(Value,Y),s,Z) CR,*,3,5 „ABCDEFG” > **EFG jobbról Y karakter, vezető s karakterrel Z hosszra kiegészítve



11/8 NR,s,Y[,Z]

NR,0,5 „123” >> 00123

IB,x LT,s,"Y","Z"

IB,8 „65535” >> 11111111 LT,AB,IGEN,NEM „AB” >> IGEN

LS,s,"Y","Z”

LS,A|B|C,IGEN,NEM „A” >> IGEN LS,A|B|C,IGEN,NEM „D” >> NEM


Numeric justify right: StrZero(StrToInt(Value),s,Y) számmá alakítva jobbra illeszt s karakterrel Y hosszban Ha van Z akkor az a default érték, ha nem lehet számmá alakítani! Integer value to Bin str. x = Output length Logical TRUE (Ha az érték = s, "Y" string, egyébként "Z" string kerül beszerkesztésre. Case insensitive!) Logical SET (Ha az érték az [s] felsorolásban van, "Y" string, egyébként "Z" string kerül beszerkesztésre. Case insensitive!) s = '[érték|érték|...|érték]'

2.3.2.2Dátum mezők formázása Ezt a formázási módot részletesen a Hiba: A hivatkozás forrása nem található. fejezetben lehet tanulmányozni! Egy standard ANSI HUN formázás pl. 'yyyy.mm.dd hh:nn:ss'. Ha nem kerül meghatározásra a formázás, akkor a program megpróbálja a Windows Shortdateformat formázását végrehajtani! Speciális dátum formázási előírások arra az esetre, ha a tárolt dátumérték nem valós (nincs feltöltve értékkel) 'CANNULL' a kimenetre a dátum helyett a 'NULL' szöveg kerül 'CANZERO' a kimenetre dátumként az '1899.12.30 12:00' kerül (az előírás szerint formázva) pl. -ex001(CANNULL,yyyy.mm.dd) >> hibás dátum esetén 'NULL', egyébként a dátum, formázva A dátum (óra, dátumóra) típusú adatok formázásának általános módja az alábbi: Ha a program adatszótárában egy dátum típusú adatmezőre a kiíratási forma paraméterezhető, akkor az alábbi Delphi help kivonat által ismertetett paraméterezés tehető meg: FormatDateTime formats the date-and-time value given by DateTime using the format given by Format. The following format specifiers are supported: Specifier

Displays

c

Displays the date using the format given by the ShortDateFormat global variable, followed by the time using the format given by the LongTimeFormat global variable. The time is not displayed if the fractional part of the DateTime value is zero.

d

Displays the day as a number without a leading zero (1-31).

dd

Displays the day as a number with a leading zero (01-31).

ddd

Displays the day as an abbreviation (Sun-Sat) using the strings given by the ShortDayNames global variable.

dddd

Displays the day as a full name (Sunday-Saturday) using the strings given by the LongDayNames global variable.

ddddd

Displays the date using the format given by the ShortDateFormat global variable.

dddddd

Displays the date using the format given by the LongDateFormat global variable.

m

Displays the month as a number without a leading zero (1-12). If the m specifier immediately follows an h or hh specifier, the minute rather than the month is displayed.

mm

Displays the month as a number with a leading zero (01-12). If the mm specifier immediately follows an h or hh specifier, the minute rather than the month is displayed.

mmm

Displays the month as an abbreviation (Jan-Dec) using the strings given by the ShortMonthNames global variable.

mmmm

Displays the month as a full name (January-December) using the strings given by the LongMonthNames global variable.

yy

Displays the year as a two-digit number (00-99).

yyyy

Displays the year as a four-digit number (0000-9999).

h

Displays the hour without a leading zero (0-23).

hh

Displays the hour with a leading zero (00-23).

n

Displays the minute without a leading zero (0-59).




11/9

Specifier

Displays

nn

Displays the minute with a leading zero (00-59).

s

Displays the second without a leading zero (0-59).

ss

Displays the second with a leading zero (00-59).

t

Displays the time using the format given by the ShortTimeFormat global variable.

tt

Displays the time using the format given by the LongTimeFormat global variable.

am/pm

Uses the 12-hour clock for the preceding h or hh specifier, and displays 'am' for any hour before noon, and 'pm' for any hour after noon. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly.

a/p

Uses the 12-hour clock for the preceding h or hh specifier, and displays 'a' for any hour before noon, and 'p' for any hour after noon. The a/p specifier can use lower, upper, or mixed case, and the result is displayed accordingly.

ampm

Uses the 12-hour clock for the preceding h or hh specifier, and displays the contents of the TimeAMString global variable for any hour before noon, and the contents of the TimePMString global variable for any hour after noon.

/

Displays the date separator character given by the DateSeparator global variable.

: Displays the time separator character given by the TimeSeparator global variable. 'xx'/"xx" Characters enclosed in single or double quotes are displayed as-is, and do not affect formatting. Format specifiers may be written in upper case as well as in lower case letters--both produce the same result. If the string given by the Format parameter is empty, the date and time value is formatted as if a 'c' format specifier had been given.

2.3.2.3Fixpontos (float) számok formázása Fixpontos számok kiíratása lehetséges alapértelmezett formázással, egyszerű fixpontos formázással és kiterjesztett fixpontos formázással. Ha nincs formázási előírás, akkor a fixpontos szám kiíratása az adatszótárban megadott számjegyszámmal (LEN) és tizedesjegy számmal (DEC) történik Egyszerű fixpontos formázás esetén a formázási utasítás '%' jellel kezdődik: Formálisan % [:] [-] [számjegyek száma] [. tizedesjegy szám] f [] közöttiek opcionálisak, - jel balra illesztést jelent (ha nem, akkor számjegyek számára jobbra illeszti). Tizedesjegyek száma a számjegyek számából vesz el! A % és az f jel kötelező. pl. -ex001(%-12.2f) >> '1223.125' >> 1223.13 kerül a kimenetre Ha nem % jellel kezdődik a formázás, akkor ez kiterjesztett formázást jelent: Formálisan: [A,]számjegyek száma,tizedesjegy szám[STRCUT] [] közöttiek opcionálisak! A abszolút értéket ír elő. STRCUT a fixpontos kimeneti érték további formázását írhatja elő. Első lépésben a szám fixpontos karakteres kifejezéssé alakul (ha kell abszolútértéket számol), majd az STRCUT szerint a kimeneti kifejezést tovább formázza. „Tíz jegyre vezetőnullákkal, abszolút értékben, három tizedesre kerekítve” pl. -ex001(A,10,3,JR,0,10) >> -123.4567 >> '000123.457'

2.3.2.4Logikai adat formázása A logikai adatok IGEN / NEM értékkel rendelkezhetnek. Formázás nélkül a kimenetre az adott gép nyelvének megfelelően 'IGEN', 'NEM', 'TRUE', 'FALSE' stb. kerül kivitelre. Formázási igény esetén az STRCUT formázási kifejezések használhatók azzal, hogy adatként a függvény számára az Igen = '1', illetve Nem= '0', tehát '1' vagy '0' karakterek kerülnek kiadásra.

2.4. Formázás külön formátumfájl segítségével Ennek két alap kritériuma van: NaploTextExpForm paraméterben a fájl nevét ki kell tölteni FeladForma paraméterben a (3) Feladás formázott szövegként opciót kell beállítani


11/10



Ebben az esetben a mérési rekord küldését a külső forma vezérlő fájl határozhatja meg! Ez egy egyszerű szöveges fájl. A fájlban, mint egy nyomtatványon, fix szövegek adhatók meg, valamint az adott napló adatrekord adatoszlopaira lehet hivatkozni egy speciális formázási kifejezéssel. Ezen kívül a fájlban elhelyezhetők megjegyzés sorok és egy általános paraméterezés, amely pl. a kiírás feltételtét határozhatja meg. Példa: ---------------------------------------------------------------------------- AUTOMATIKUS CSV EXPORT -- 2013.10.10 --------------------------------------------------------------------------FILTER(1,[MERTIP:SC0,1,3,4@MNEXPORT:=LTRUE])ON NWL(); --------------------------------------------------------------------------"0"@@"%(&TELEP;C)%(&BIZSORSZ;I;CR,0,6,6)"@@"%(&ZDATUM;D;ddmmyyyy)" "%(&ASZAM;C)"@@"V"@@ "%(&ANEV;C)"@@"%(&NETTO;F;%-11.3f)"@@ ""@@"%(&UKSH;C)" --------------------------------------------------------------------------A példában látható: a komment sorok két db '-' (mínusz jel) karakterrel kezdődnek. Az első nem komment sorban elhelyezhetők az általános paraméterek. Ebből kétféle van (jelenleg). Az üres sorokat és sortöréseket a feldolgozás figyelembe veszi, ha nincs az általános paraméter sorban elhelyezve az NWL(...) opció. Ha az el van helyezve, akkor a formafájlban levő sortöréseket a feldolgozás kiszűri és nem veszi figyelembe. Az NWL() opcióban azt a mintát kell elhelyezni, amelyet a feldolgozás sortörésre (CR-LF karakterek) konvertálhat. (A példában egy be van helyezve, tehát azon a ponton lesz sortörés.) A FILTER(....)ON utasítás adja a kiírás szűrési feltételét. A példában látható ˝ idézőjelek pl. konstans szövegek. Ehhez hasonlóan bármely szabad szöveg behelyezhető. Adatterület definíció szintaxis: <Mezőkifejezés>@@<Mezőkifejezés>...@@<Mezőkifejezés> A program a @@ karaktereket a 'NaploTextExpDelimiter' paraméterben meghatározott delimiter karakterrel helyettesíti.

2.4.1. Tábla adatoszlop kiíratás Mezőkifejezés: %(&<mezőnév>[^];<mezőtípus>;) mezőnév: az adattábla (NAPLO vagy NYITVA) bármelyik adatoszlop neve nagybetűkkel opcionálisan egy ^ jel követheti, amely az adatérték keretezését írja elő. Ez általában karakteres és dátum típusú adatmezők esetében szokásos. A keretezés szimpla idézőjelekkel történik. Mezőtipus: egyetlen karakter, amely a kiírandó adat formázási típusát határozza meg. Értékei: C=Karakteres, I=Integer, F=fixpontos, L=Logikai, D=Dátum-időpont. formázási utasítás: a kiírandó adat formátuma szerinti további formázási lehetőség. Opcionális. Formázás karakteres mezőre: %(&;C;L,1,7) Ez a formázás azonos a 2.3.2.1. fejezet szerinti STRCUT kifejezések egyikével. Formázás fixpontos számokra: %(&;F;'%-7.2f') vagy %(&;F;'%-7.2f'^hatványkitevő) Ez előírhatja, hogy a számjegy mennyi karaktert tartalmazhat és ebből mennyi a tizedesek száma. Figyelem: ha a forrásadat nem fér az előírt számjegyszámba, ez küldési hibát okoz és az adatrekord továbbítása nem lehetséges. Ha nincs megadva a formázás, akkor a szám az adatbázisban levő egyéb előírás szerint kerül formázásra. A ^hatványkitevő2 opcionális és előírható, hogy a számot 10,100,1000 vagy 0.1, 0.01, 0.001 szorzás után alakítsa át. Tehát a ^-3 esetén (0.001 * érték ) kerül elvégzésre, ^2 esetén (100 * érték). A tizedesjel alapértelmezés szerint pont. Ha más, pl vessző szükséges, akkor ezt a PW2.INI konfigurációs fájlban kell elhelyezni. Ennek szabálya: a napló tábla fej IMPORT mezőben levő SQL(SQLxx);bejegyzésből az SQLxx címkével jelölten megtalálható egy INI bejegyzés az [SQLSCRIPTPARAMS] szekcióban. A tizedesjelet ott lehet vesszőre cserélni! Pl keressünk egy ilyet: [SQLSCRIPTPARAMS] SQL01DECIMALSEPARATOR=, 2

A PW2 program V2.5.1.1 (131104) verziótól alkalmazható!




11/11

Formázás dátum típusra: %(&;D;'yyyy.mm.dd hh:nn:ss) Ezzel a dátum, időpont mezők küldése formázható meg. A szokásos formázási jelek yyyymmddhhnnss. (év hónap nap óra perc másodperc). A mezők közé elválasztójelek helyezhetők (pl. pont, kötőjel stb.). Az évszám átadható kétjegyűen is (yy). A mezők sorrendje is módosítható. A formázáshoz az adatszótárban az IMPORTPAR oszlopban külön elhelyezhető egy @(CANNULL); vagy @(CANZERO); opció. Formázás logikai mezőre: %(&;L;'truestr','falsestr') Ezzel megadható, hogy egy logikai mező false és true tartalma miként legyen a kimenetre írva. Megadási forma: trueérték,falseérték. Pl: %(&USAJAT^;L;Saját,Nem saját); >> False >> 'Nem saját' Integer mező formázása: jelenleg integer számokra nem adható meg formázás.

2.4.2. Speciális változó kiíratás Mezőkifejezés: %(#[^];<mezőtípus>;) változónév:ez néhány címkeszöveg, amely a programban speciális adatérték kiíratását teszi lehetővé. MHAZON

A program konfigruráció MHAZON konstans kiíratása. Ez az érték a mérési rekord létrejöttekor kerül betöltésre a rekord TELEP adatoszlopába. 'Mérlegelés több cég számára' opció esetén az MHAZON és TELEP értékek eltérhetnek, egyébként a TELEP oszlop kiíratása javasolt.

TELEPEK

'Mérlegelés több cég számára' opció esetén a programban használható telephely azonosító lista a LICENSZ.DB adattáblázatból. Az azonosítók ';' karakterrel vannak elválasztva.

%LIC*%

Ha a konfigurációban levő MHAZON konstans értéke '*' karakter, akkor a kiadott érték üres string, egyébként a pillanatnyi szoftver licenc sorszám 5 számjegyen.

DEFAULTURF

Programindításkor, az ini-ből beolvasott, licensz fájlból megerősített URF eladási sorszám. Az INI fájlban az azonos nevű paraméterben lehet megadni a program számára az alapértelmezett cég licenc sorszámot. Ennek 'Mérlegelés több cég számára' opció esetén van jelentősége.

DEFAULTLICENCE

Programindítás után, DEFAULTLICENCE szerint a licensz táblából/cm.mhazon-ból beolvasott mérőhely konstans. Ennek 'Mérlegelés több cég számára' opció esetén van jelentősége.

DEFAULTPCINDEX

Programindítás után, DEFMHIDX szerinti kód (több PW2 együttműködéséhez)

DEFAULTPCNEV

Programindítás után, DEFMHNEV szerinti rövid mérőhely címke (több PW2 együttműködéséhez).

WS_ID

A konfigurációban levő WS_ID konstans aktuális értéke.

WS_LEVEL

A konfigurációban levő WS_LEVEL konstans aktuális értéke.

WS_TYPE

A programban érvényes munkaállomás működési mód értéke. 1=beléptető állomás, 2=minősítő hely

BIZ_TYPE3

A mérésrekordban prioritás szerint érvényes 1:Szállítólevél 2:Számla (Prioritása: 2 > 1 > 0)

BIZ_SORSZ

A mérésrekordban prioritás szerint kiadott Mérlegjegy / Szállítólevél / Számla sorszám (Prioritása: szlasz > szallsz > mjegy).

BIZ_HSORSZ

A mérésrekordban prioritás szerint kiadott stornózott Mérlegjegy / Szállítólevél / Számla sorszám (Prioritása: szlasz > szallsz > mjegy).

A változó kiíratás egyéb paramétereit lásd 2.4.1. pontban!

BIZ_TYPE, BIZ_SORSZ, BIZ_HSORSZ paraméterek a V2.5.1.6 verziótól!

3


bizonylat

0=mérlegelő hely, típus.

0:Mérlegjegy

Üzemeltetési Kézikönyv kiegészítés 4. Automatikus CSV alapú mérési eredmény export

Recommend Documents