MDE

Abfragen

Hier werden die Tabellen und Inhalte definiert, die auf die einzelnen mobilen Datenstationen synchronisiert werden sollen.

Funktionen

In diesem Bereich werden die Masken, der Programmablauf, die Prüfungen und Buchungen definiert.

Name

Dieser Name wird auf dem MDE angezeigt, wenn Daten aus diesem Bereich aktualisiert werden.

Ab Version 2.03.004 wird vor dem Namen eine # angezeigt, wenn die Synchronisation bei einem Erstsync unterbrochen wurde. In der Tabelle wird bei jedem Erzeugen der Tabelle eine # vorangestellt. Dieser wird nach vollständiger Synchronisation wieder entfernt. Am MDE-Client ist diese # allerding erst nach einem erneuten Aufruf nach einer Unterbrechung sichtbar.

Geräte

Über diesen Eintrag kann gesteuert werden, auf welchen Geräten diese Daten zur Verfügung stehen. Bleibt das Feld leer, so werden die Daten allen Geräten zur Verfügung stehen. Mehrere Geräte werden Kommagetrennt eingegeben.

Tabelle

Tabellenname in Professional-ERP

Felder

Hier werden Komma getrennt alle gewünschten Felder aufgeführt. Generell werden die Felder ID und CURTIMEST mit übertragen. Diese werden zur Synchronisation benötigt.

Index-Felder

Hier werden die Felder eingetragen, nach denen auf den mobilen Geräten am ehesten gesucht wird. Hier sind aktuell keine zusammen gesetzten Indexe möglich.

Filter

Es werden nur die Datensätze übertragen, für den der Filter gültig ist.

Um auch Gerätespezifische Daten filtern zu können, kann hier auch auf System- bzw. die Konfigurationsvariablen des MDE zugegriffen werden. Diese werden dann in spitzen Klammern angegeben.

and USER=<<MDEUSER>>

Funktion

Diese entsprechen einem kompletten Programmteil, der über das Menü am mobilen Gerät aufgerufen werden kann, oder als Folgedialog z.B. hinter einer Auswahl verbergen kann.

Spezielle Funktionen:

_LOGINWird beim Start der Loginmaske ausgeführt. _INFO zur Anzeige Versionsnummer.

_MENUWird nach dem Login ausgeführt. _LOGIN bei der Anmeldung

_SHUTDOWN Wird beim Abmelden / Beenden ausgeführt

Einsprungspunkt (lokal)

Einsprungspunkte sind wie Programmteile, die auf dem lokalen mobilen Endgerät zu bestimmten Zeiten aufgerufen werden.

Dabei gibt es vordefinierte Namen, die bei allen Funktionen definiert sind. Diese beginnen mit einem Unterstrich z.B. _INIT, _EXIT, _SHUTDOWN, _WHEN, _VISIBLE

Weitere fest definierte Präfixe definieren spezielle Zeitpunkte, wann diese Programmteile ausgeführt werden. Dazu gehören:

- VA_Validierung beim Verlassen des Feldes (Bei CBO und CHK beim Ändern)

- WH_Wird beim Betreten des Feldes gestartet

- VI_Wird beim Anzeigen ausgeführt (Im Einsprungspunkt können über RefThis die Eigenschaften beeinflusst werden. Z.B.:

RefThis.Backcolor= RGB(255,0,0)

- _WHENWird generell beim Betreten eines Feldes

gestartet.

- _VALIDWird generell beim Anzeigen eines Feldes gestartet

- _SHUTOWN Wird generell ausgeführt, wenn das Programm beendet wird.

Bei den beiden letzt genannten Einsprungspunkten steht neben der Variablen vParam1, die den Feldnamen enthält, auch vParam2 zur Verfügung. Hierin steht der Objektname des übergeordneten Objekts. So kann z.B. ein ganzer Container gesperrt werde.

Die jeweiligen Endungen entsprechen den angegebenen Objektnamen bzw. aus Gründen der Updatefähigkeit den Feldnamen.

Alle weiteren Funktionen sind frei und werden aus diesen Funktionen aufgerufen.

Einsprungspunkt (Server)

Daneben gibt es Einsprungspunkte, die nicht auf dem mobilen Gerät ausgeführt werden, sondern auf dem Server gestartet werden.

Diese werden zur Verbuchung der erfassten Daten auf dem MDE benötigt. Details hierzu werden im Kapitel „Serverprozess“ gegeben.

Alle Funktionen aktualisieren

Die Darstellung wird aktualisiert

Als Vorlage speichern

Speichert die aktuell markierte Funktion in das Vorlagen-Verzeichnis

Nur sichtbar, wenn Konfigurationsvariable „MDEVORL=YES“ gesetzt ist

Funktion als XML-Datei exportieren

Speichert die aktuell markierte Funktion im XML-Format auf die Festplatte

Funktion als XML-Datei exportieren

Importiert eine zuvor im XML-Format auf die Festplatte gespeicherte Funktion

Datenregel bearbeiten

Mit dieser Funktion wird der aus den Datenregeln bekannte Editor gestartet und die markierte Funktion geladen.

Funktionsname

Eindeutiger Name für das Programm. Hierüber werden die internen Verknüpfungen und Aufrufe im Programm abgebildet.

Funktionsbezeichnung

So wird das Programm im Menü bezeichnet

Hauptmenüpunkt

Diese Auswahl, die sich nach den Menüpunkten im Professional-ERP richtet, steuert die Zuordnung des Programms zu dem Menüpunkt auf der ersten MDE-Maske.

Sortierung

Gibt die Position des Programms innerhalb des Menüpunktes an.

Geräte

Hier können wieder spezielle Funktionen auf nur bestimmten Geräten sichtbar gemacht werden.

Bleibt das Feld leer, so sehen alle mobilen Geräte diese Funktion. Mehrere Geräte werden Kommagetrennt eingegeben.

Bemerkung

Hier werden die Voraussetzungen für das Programm dokumentiert um auch später noch einen Überblick über das Programm zu haben.

ToDo

NameEindeutiger Name des Einsprungpunktes

Lokal / Server

Hier wird festgelegt, ob der Einsprungspunkt auf dem MDE benötigt wird (Lokal) – Erkenntlich am Icon,

oder ob die Datenregel auf dem Server zur Verarbeitung der MDE-Anforderung ausgeführt wird (Server) – Icon

Datenregel

Code der in diesem Einsprungspunkt ausgeführt wird.

Der Absprung

Der Code wird an der aktuellen Stelle verlassen und setzt mit der ersten Zeile im Einsprungspunkt fort. Ist dieser dann abgearbeitet wird mit der nächsten Zeile nach

do(„…“)

Es ist möglich impliziert einen Rückgabewert zurück zu bekommen.

Der Funktion können mehrere (max. 10) Parameter mit übergeben werden, die dann als private Variablen vParam1 bis vParam<n> angesprochen werden können.

Werden in der aufgerufenen Funktion die Werte über parameter oder lparameter entgegengenommen, so können diese mit sprechenden Namen versehen werden.

do(„MASK“,”P1”,”P2”,…)

Ein @ vor dem Parameter übergibt den Parameter als Referenz.

Der entkoppelnde Absprung

Im Gegensatz zu do(..) wird in SetDo ein Timer-Event angestartet, das die beiden Prozesse entkoppelt. So kehrt der Programmablauf nach Start des Timer-Events in das Programm zurück und arbeitet dies ab. Nach einer gewissen Wartezeit wird dann der Code im Timer ausgeführt.

Diese Methode benötigt man, wenn man z.B. eine Maske schließen will, aber danach noch Code auf der alten Maske ausgeführt werden soll. (VA_...).

Zu beachten ist, dass SetDo keinen Rückgabewert haben kann, da ja de Prozesse entkoppelt wurden.

Der Rücksprung

Der Code eines Einsprungspunktes endet mit der letzten Zeile oder dem Befehl

return

Die Rückgabewerte werden hier im Gegensatz zu DoFunc nicht in Klammern angegeben.

Der Aufruf

Die Funktion wird an der aktuellen Stelle verlassen und die aufgerufene Funktion wird mit dem Einsprungspunkt _INIT gestartet.

Während der Abarbeitung in der aufgerufenen Funktion ist die Variable

func()

Der zweite Parameter gibt an, ob das aufgerufene Programm in einem eigenen Fenster geöffnet werden soll (nur PC)

Es ist darauf zu achten, dass nach der Rückkehr nur die aktuelle Routine abgearbeitet wird, da die Tiefe der aufrufenden Struktur nicht gespeichert wird. Im Laptopmode wird nichts mehr abgearbeitet, da hier die Masken über den 2. Parameter entkoppelt sind (siehe

ParentDo()

Ab der Version 2.5 werden auch weitere Übergabeparameter angenommen. Es besteht auch die Möglichkeit die Parameter per Ferenz zu übergeben (@P2)

Zu beachten ist, dass DoFunc die Private-Variablen des aufrufenden Einsprungs-Punktzerstört. (nicht DoDialog)

Der Aufruf modal

Analog zu DoFunc. Das neue Fenster öffnet sich modal, das heißt das darunterliegende Fenster ist bis zum Abschluss der Arbeiten an dem neuen Fenster nicht bedienbar.

Siehe Beschreibung zu DoFunc. Lediglich der zweite Parameter entfällt hier.

Achtung: In diesem Fall wird die Maske erst mit dem Ende des _INIT gezeichnet. Es können somit keine FOCUS-Anweisungen in diesem Bereich direkt angegeben werden. Für diesen Falls wird über SetDo(„_INIT_SETFOCUS“) dieses in einen Einsprungspunkt ausgelagert und entkoppelt aufgerufen!

Der Rücksprung

Hier erfolgt der Rücksprung zu der Zeile

DoFunc()

/DoDialog()

Maske schließen

Mit Close() wird die aktuelle Maske geschlossen (analog return(cArtNr)) – z.B.: im Init, wenn Maske noch nicht aufgebaut war.

Logout

Schliesst alle offenen Programmfenster und meldet den aktuellen User ab.

Diese Funktion ist bereits im Einsprungspunkt _MENU._LOGIN verfügbar.

Folgeaufruf in aufrufender Maske

Mit dem Verlassen der Maske im Laptopmode, weiß die aufrufende Maske nicht mehr, welche Maske nun geschlossen wird. Es findet somit im Standard keine weitere Funktion statt (auch nicht _INIT). Möchte man aber zum Beispiel eine Refresh der Maske starten, so kann man mit diesem Aufruf eine Funktion der Maske aufrufen, die die aktuelle gestartet hat.

c

Zeichenkette

n

Numerischer Wert

l

logische Variable

d

Datumswert

Die Variablen „nWert1“ und „nWert2“ werden zerstört.

Die Anzahl der Variablen die hier angegeben werden können ist nicht auf 2 begrenzt. Alle weiteren müssen nur mit Komma-getrennt angegeben werden.

Public

Entspricht der bisherigen einfachen Definition ohne Benennung. Die Variablen leben in der aktuellen Funktion.

Local

Diese Variablen leben nur in dem aktuellen Funktionscode

Private

Diese Variablen leben nur in dem aktuellen Einsprungspunkt inkl. aller Aufrufe aus diesem heraus via DO()

Liest den im ersten Parameter angegebenen Wert aus der INI. Wird dieser gefunden erhält man diesen als Rückgabewert. Ist keiner definiert, so wird der Defaultwert, der als 2. Parameter angegeben wurde verwendet.

Schreibt den 2. Parameter zu der Eigenschaft des 1. Parameters in die INI-Datei.

Schreibt Werte in die Registry

1. Wert: Baum in der Registry

2. Wert: Name des Wertes

3. Wert: Wert der gesetzt werden soll

Der 1. Wert wird in einer neuen Version optional und somit vom System gesetzt.

Im Gegensatz zu SetRegKey muss hier zum setzten der Variable nicht der komplette Registry-Baum angegeben werden. Hier reicht es aus erst die Pfade unterhalb von

CURRENT_USER\Software\Software Schmiede\Professional\MDE

1. Wert: Pfad unterhalb …\MDE\

2. Wert: Name des Wertes

3. Wert: Wert der gesetzt werden soll

Beispiel:

SetReg("Vars","TEST","123")

Liest Werte aus der Registry

1. Wert: Baum in der Registry

2. Wert: Name des gesuchten Wertes

3. Wert: Default-Wert, sofern der Wert nicht gesetzt wurde.

Der 1. Wert wird in einer neuen Version optional und somit vom System gesetzt.

Analog zu SetReg() für das lesen der gesetzten Variablen.

Beispiel:

cRet=G

etReg("Vars","TEST","1

11

")

WEBUSER=PROFESS

Name des registrierten Users im Webdienst. Dieser muss passen, sonst wird der Zugriff verweigert.

WEBPW=SWS

Passwort des registrierten Users im Webdienst. Dieser muss passen, sonst wird der Zugriff verweigert.

DBLOCATION=___

Pfad zur lokalen Datenbank. Hier kann auch mit virtuellen Pfaden gearbeitet werden:

DBLOCATION=H:\User\%USERNAME%\Week

Wird hier ein Pfad angegeben, so wird in diesem eine FoxPro Datenbank aufgebaut.

Wird hingegen eine Provider-Info angegeben, so wir diese als Basis für eine SQL-Datenbank genommen:

DBLOCATION=Provider=SQLOLEDB;DRIVER=SQL Server;Address=

<<Server>>

;Trusted_Connection=Yes;

SERVER=

<<Server>>

;DataBase=MDESTD

WEBSERVICE=http://...

WEBSERVICE2= http://...

Internet-Adresse des Webservers. Wird der erste nicht gefunden / erreicht, wird versucht über den Zweiten eine Verbindung herzustellen (Intern / extern).

Dies wird aber nur einmal beim Start des Programmes geprüft. Ändert sich während des Einsatzes etwas, so muss das Professional-MDE neu gestartet werden.

DBSIZE=512

Mit diesem Schalter kann die maximale DB-Größe angegeben.

Default ist 128MB

PW=DBPW

Passwort für die lokale Datenbank. Default ist swsmde.

PW=c3dz

Passwort für den Zugriff auf die lokale Datenbank, sofern hier SQL zum Einsatz kommt.

Eingetragen wird der Verschlüsselte Wert nach Base64

Verschlüsseln:

strconv("sws",13) c3dz

Entschlüsseln:

strconv("c3dz",14) sws

MAXPWERROR

Anzahl, wie oft ein User sein Passwort falsch eingeben kann, bevor die Datenbank lokal gelöscht wird.

Default: 3

DBDEL

Ist dieser Schalter gesetzt, so wird nach 3 maliger falscher Eingabe der Login-Daten die lokale Datenbank gelöscht.

Die Ausprägung JOB löscht die Datenbank ebenfalls, lässt aber die Tabelle MDEJOB mit eventuell unverarbeiteten Jobs stehen (nur bei lokale SQL-Datenbank)

Default: YES

DBINIDEL

Wird die lokale Datenbank gelöscht, so wird diese mit der nächsten Anmeldung wieder aufgebaut. Mit diesem Schalter kann beim Löschen der Datenbank auch gleich die INI mit gelöscht werden. Damit ist ein Neuaufbau der Datenbank ohne neues Einkopieren nicht mehr möglich.

Default: YES

LOGFILE

Gibt die Datei und das Verzeichnis an, wohin das System die Anmeldeversuche und eventuelle Löschungen der lokalen Datenbank protokolliert.

Standard: <<Programm-Verzeichnis>>\SWSMDE.log

LOGLEVEL

Level der Protokollierung

5 – nur Fehler werden protokolliert

8 – auch erfolgreiche Anmeldzungen werden aufgezeichnet

MAXSQL

Gibt an, wieviel Zeichen beim Sync pro Insert verwendet werden. Problem ist, dass bei den Funktionen der SQL-Code für den Insert des kompletten Text zu lange würde. So wird der Text zerlegt und beim ersten Mal ein Teil über Insert eingefügt und danach als Update (Text=Al+Neu) upgedatet. So wird die Befehlszeile nicht zu lang. (Geht so nicht am MDE, da nText+Neu ein Fehler aufwirft)

=20.000

MDEID=MDE1

Eindeutiger Name des mobilen Gerätes

SYNCINTERVAL=60

Angabe der Zeit in Sekunden zwischen zwei Synchronisationsprozessen mit dem Webservice

SYNCROWS=nnn

Der Schalter gibt die Vorgabe der maximalen Anzahl der zu synchronisierenden Sätze für Tabellen an.

Ist der Schalter nicht gesetzt, werden auf dem PC 5000 und auf dem MDE 2000 Sätze auf einmal geholt.

Für die Tabelle MDECODE gibt es bereits ein Sonderhandling, dass hier immer nur 50 Sätze auf einmal geholt werden. (Siehe Schalter SYNCROWSCODE)

SYNCROWSCODE=nnn

Der Schalter gibt die Vorgabe der maximalen Anzahl der zu synchronisierenden Sätze für Funktionen an.

Ist der Schalter nicht gesetzt, werden auf dem PC 50 und auf dem MDE 10 Sätze auf einmal geholt.

WEBTIMEOUT=8000

Zeitdauer, die das Gerät auf eine Datenbankabfrage vom Webservice wartet. Angegeben ist der Default-Wert.

CONNECTTIMEOUT=2000

Zeitdauer, die das Gerät wartet, um die Info zu bekommen, ob eine Verbindung zum Webservice besteht. Angegeben ist der Default-Wert. Wird benötigt, wenn der SYNCINTERVAL zu groß ist und die Verbindung neu etabliert werden muss. Meldung am MDE: „Verbinde mit Server…“

POCKET=YES

Hierüber werden das Betriebssystem, und damit der unterschiedliche Maskenaufbau bezüglich der Position des Menüs, definiert.

YES = Windows mobile PC

NO = Pocket PC

SCALE=2

1 – bei Auflösung 320*

2 – bei Auflösung 640*

FONTBOLD=YES

Damit wird die Schrift der Maskenobjekte fett dargestellt

ERRPROT=____

Schaltet eine Fehlerprotokollierung der SQL-Befehle ein. Angegeben wir Pfad und Dateiname der entstehenden Textdatei.

COVERAGE=_____

Ermittelt bei der Ausführung auf dem Gerät die Zeitdauern pro Zeile und gibt diese in dem angegebenen Textdokument aus.

SQLTEST=_______

Ermittelt bei der Ausführung auf dem Gerät die Zeitdauern je SQL-Statement und gibt diese in dem angegebenen Textdokument aus.

PROTMINMS=<Millisekunden>

Wurde die Protokollierung von Sql-Abfragen auf den MDE-Geräten durch Setzen des Schalters SQLTEST aktiviert, so werden alle Sql-Abfragen in einer Textdatei protokolliert. Oft ist es jedoch interessant, nur die Abfragen zu protokollieren, die eine längere Ausführungszeit besitzen. Ist dies gewünscht, so kann dies erfolgen durch Setzen des Schalters PROTMINMS auf die gewünschte Anzahl an Millisekunden, die überschritten werden muss.

SYNCMULTITS=NO

Wird bei einer Synchronisationsabfrage über mehrere Tabellen gejoint, so werden die Daten der aktuellen Tabelle auch upgedatet, wenn sich der referenzierte Datensatz in der anderen Tabelle geändert hat.

Mit setzten des Schalters auf „NO“, kann dies wieder deaktiviert werden.

SYNCBACK=5

Anzahl von Sekunden, die beim Sync vor dem gespeicherten CURTIMEST noch mit geschaut wird.

MDELANG=E

Mit diesem Parameter wird die Sprache für das MDE gesetzt. Das System versucht nun alle Texte aus der Tabelle LANGUAGE zu ermitteln.

Wird kein Eintrag für das Objekt gefunden, so wird ein Pflegesatz auf dem Server angelegt. Angezeigt wird in diesem Fall der deutsche Text.

Als Voraussetzung muss in der SWSWEB.INI über den Schalter SYSCON die Verbindung zur Systemdatenbank hinterlegt werden und in der Tabelle LANGUAGE muss das Feld LAN_MDE N(1) angelegt sein. Siehe Kapitel „Fremdsprachigkeit“

SWSMDEINI=<Ort der Datei>

Es ist möglich mit einer INI, die nur diesen Inhalt hat, auf die korrekte INI zu verweisen.

Die INI liegt normalerweise im Verzeichnis \My Documents. Macht man die Geräte Kaltstartsicher, so wird diese immer wieder neu aufgebaut. Daher legt man die korrekt INI auf die Storage Card und verweist in der ursprünglichen auf die aktuelle:

SWSMDEINI=\Storage Card\<Pfad>\swsmde.ini

BUTTONMENU=NO

Hiermit kann das Aussehen des Menüs gesteuert werden.

NO - Klassisches TreeView-Menü mit Hauptmenüpunkten

YES – Buttonmenü 2-stufig mit der Ebene der Hauptmenüpunkte

2 - Buttonmenü ohne Hauptmenüebene

Default ist „NO“

LOGINKEYBOARD=YES

Blendet die Tastatur beim Login-Dialog ein

CLOSEPWKEYBOAR

D=YES

Blendet die Tastatur beim Logout mit Passwortaufforderung eine

SYNCLOGOUT=YES

Automatische Abmeldung wenn gedockt (eigentlich CONNECTED – als für WLan-Lösungen unbrauchbar.). In diesen Fällen wird der Einsprungspunkt _SHUTDOWN in der jeweiligen Funktion (auch MENU) ausgeführt

CLOSEPW=<PW>

Passwortabfrage, wenn man Professional-MDE beenden möchte. Geht nur nach Eingabe des korrekten Passworts

LOGOUTUSERCLEAR

=YES

Löscht den Benutzernamen beim Ausloggen

CHANGEPW=YES

Blendet auf der Anmeldemaske den Button zur Passwortänderung ein

SYNCLOGOUT=YES

bewirkt ein automatisches Abmelden sobald Client gedockt ist und synchronisiert.

LSYNCCHECK=2

Steuert die Prüfung, wann zuletzt synchronisiert wurde (Vergleich Zeitstempel letzte Synchronisation Client mit Zeitstempel letzte Synchronisation Server / Soll Probleme unterbinden, wenn auf dem Server eine ältere Datensicherung eingespielt wurde). Ist der Client-TS neuer als der TS auf dem Server, greift der Schalter:

0 = keine Prüfung auf letzte Synchronisation

1 = Meldung Zeitstempelfehler und Abbruch der Synchronisation

2 = Rückfrage ob auf Client alles gelöscht und neu synchronisiert werden soll

3 = Rückfrage ob auf Client alles gelöscht und neu synchronisiert werden soll, bei Verneinung weitere Rückfrage ob Synchronisation trotzdem durchgeführt werden soll

4 = Meldung Zeitstempelfehler und Löschen aller Daten auf Client und neu synchronisieren

5 = sofort alle Daten löschen und neu synchronisieren ohne Meldung

SYNCDEL=YES

Durch setzen dieses Schalters werden auf dem Client bei der Synchronisation die Datensätze gelöscht, die nicht mehr der Sync-Bedingung entsprechen.

MDEDEL=YES

Ist dieser Schalter auf NO gesetzt, so werden auf dem Client keine Sätze mehr aus der Tabelle MDEDEL gelöscht.

Default: YES.

RECDEL=<Prot-File>

Wird dieser Schalter gesetzt (Protokolldatei mit Pfad), so werden alle Satzlöschungen auf dem Client von Sätzen, die nicht mehr auf dem Server vorhanden sind, protokolliert. Standardmäßig werden die Satzlöschungen nicht protokolliert

LABELBOLD=YES

Setzt alle Labels automatisch auf Fett-Schrift

LABELCOLOR=255,255,255

Definiert die Default Label-Farbe auf den angegebenen Wert.

SWSGUI=x

Steuert den MDE-PC Modus

3 = Dynamic Oberfläche

SCALEDEFAULT=120

Setz im Dynamic Mode die Maskengröße der Masken mit Ribbonbar auf 120%, sofern keine Registry-Speicherung für den Dialog vorliegt.

ASKPW=n

Steuert das Verhalten bei der Anmeldung

0 = Default (Anmeldung mit Passwortabfrage)

1 = Ist der Benutzer aus der Betriebssystemanmeldung in Professional angelegt, steht der Maus-Cursor direkt im Passwortfeld

2 = Ist der Benutzer aus der Betriebssystemanmeldung in Professional angelegt, erscheint kein

USER=xxx

Mit der Konfigurationsvariable USER kann der Benutzer bei der Anmeldung am MDE-Gerät vorbelegt werden. Hierzu kann ein fixer Benutzer angegeben werden oder auch durch Angabe von )( erreicht werden, dass der Benutzer der Windows-Anmeldung verwendet wird.

WFPPRIVAT=YES

Die Konfigurationsvariable steuert die Sichtbarkeit privater Termine Anderer im Kalender-Control.

Ist diese nicht gesetzt, so werden diese Termine nicht angezeigt. Mit YES wird der Block angezeigt, aber kein Inhalt.

NEXTID=yymmddnnn

Diese Variable setzt das Programm automatisch, wenn vom MDE-Client neue Sätze in die Datenbank eingefügt werden. Dabei wird der Aufzählung immer das aktuelle Tagesdatum vorangesetzt.

Wird ein MDE neu aufgesetzt und die INI verändert, so muss dieser Wert gelöscht werden, sofern an diesem Tag noch kein Insert stattgefunden hat. Ansonsten muss der Zähler entsprechend hochgesetzt werden,

FILESROOT

=<<MDEDB>>+\FILES

Über diese Variable kann der Speicherort der vom Server synchronisierten Dateien definiert werden.

Default ist das Verzeichnis FILES im Unterordner der MDE-Datenbank.

Ansonsten ist der komplette Pfad in der Variablen anzugeben. Z.B.: C:\Temp\Dateien

FILESDIRLENGTH=3

Über diesen Schalter kann die Zerstückelung der MDI_REFID in eine Ordnerstruktur beeinflusst werden.

Im Standard nimmt das System diese ID, die numerisch 15-stellig ist, und zerteil diese in Pakete der Länge 3. Daraus entsteht die Ordnerstruktur unter der MDI_REFTAB

Bsp: REFID=1234567890123145 REFTAB=ART

\FILES\ART\123\456\789\012\345\

LOGINPWCODE=<Code>

Wird das MDE-Gerät in der Hosentasche transportiert, so kann es relativ schnell vorkommen, dass mehrfach hintereinander ein Login ohne Passwort ausgeführt wird. Da standardmäßig die Datenbank nach der dritten falschen Anmeldung gelöscht wird, kann es hierdurch zu einem Datenverlust kommen. Um dies zu verhindern kann man über den Schalter LOGINPWCODE erreichen, dass der Benutzer vor einem erneuten Anmeldeversuch erst einen Sicherheitscode eingeben muss. Über den Schalter kann definiert werden, was der Benutzer in diesem Fall eingeben muss. Ist der Schalter nicht gesetzt, so erfolgt auch keine Sicherheitsabfrage.

USERFIELDS

Standardmäßig werden nur bestimmte Felder, die für die Anmeldung auf den MDE-Geräten notwendig sind, auf die Geräte synchronisiert.

Erweiterung ist mit diesem Schalter möglich:

USERFIELDS=* // alle Felder synchronisieren

USERFIELDS=USR_TELE,USR_EMAIL //zusätzliche Felder

LOGFILE=<Pfad+Dateiname>

Log-Einträge vom Programm und über den Befehl WriteLog werden standardmäßig im Programmverzeichnis (PC) oder unter MyDocuments (MDE) in der Datei swsmde.log gespeichert. Soll der Speicherort geändert werden, so kann dies über den Schalter LOGFILE entsprechend eingestellt werden.

Default: swsmde.log

LOGLEVEL=<LEVEL>

Log-Einträge vom System sowie Einträge über WriteLog werden nur dann weggeschrieben, wenn der Level des Eintrags größer als oder gleich wie der Wert im Schalter LOGLEVEL ist. Der Default des Wertes ist 5. Wird der Schalter auf 0 gesetzt, so wird grundsätzlich nichts mehr protokolliert.

Beispiel für Protokollierung im Standard:

Anmeldungen mit falschem Passwort werden ab Level 4 protokolliert.

Erfolgreiche Anmeldungen werden erst ab dem Level 8 protokolliert.

Default: 5

Dimensioniert das Array „aVar“ mit 6 Zeilen und dazu jeweils 2 Spalten (Werte).

Gibt die Anzahl der Zeilen des Arrays zurück.

Gibt die Anzahl der Spalten des Arrays zurück.

Gibt die Zeile im Array zurück

1. Wert: Array-Name

2. Wert: Such-Wert

3. Wert: Spalte in der gesucht wird (optional – Default: 1)

B

eachte

, 

Werte 

in 

einem 

Grid-

Array 

sind 

Strings

1. Wert

Bezeichnung auf Maske (Label)

2. Wert

Variable – Einsprungspunkt (CMD,CNT) – Cursor (GRD)

3. Wert

Die ersten 3 Buchstaben geben den Typ des Feldes an (wenn leer=“TXT“)

Die Zeichen dahinter ergeben dann den Objektnamen, anhand dessen die Übersetzung der Labels, Buttons etc. gesteuert wird.

Bsp: TXTART_ARTNR

Hierüber werden auch die Einsprungspunkte WH_, VA_ und VI_ angesprochen.Zur Bewahrung der Updatefähigkeit wird bei der Angabe des Typs mit nur 3 Zeichen, nach wie vor der Variablenname akzeptiert.

4. Wert

Breite des Feldes

5. Wert

Höhe des Feldes

6. Wert

Abstand vom linken Rand

7. Wert

Abstand vom oberen Rand

Gibt den aktuellen Abstand zum oberen Rand des übergeordneten Objekts (Maske, Container, …)

1. Wert

Name des Feldes

2. Wert

Angezeigter Wert

3. Wert

Tabreihenfolge – Reihenfolge der Felder

4. Wert

Pixelposition von oben

5. Wert

Pixelposition von links

6. Wert

Breite des Feldes in Pixel

7. Wert

Höhe des Feldes in Pixel

8. Wert

Feldbreite variabel (.t. oder .f.)

9. Wert

Feldhöhe variabel (.t. oder .f.)

10. Wert

Wievieltes Feld in der gleichen Zeile links von diesem Feld, das seine Größe ändern kann + 1

11. Wert

Anzahl der Elemente in dieser Zeile, die Ihre Breite ändern können

12. Wert

Anzahl der Objekte die oberhalb liegen und in der Höhe geändert werden können + 1

13. Wert

Anzahl der Objekte in vertikaler Richtung die Ihre Höhe ändern können.

PGF

Eigentliche Maske

CNT

Container

vParam1

Name des Page-Frames

vParam2

Nummer des angeklickten Page-Frames

vParam3

Nummer des aktuell aktiven Page-Frames

cntxxx.ScrollPos= nPixel

Damit kann man per Code in einem Container mit Scrollbalken positionieren.

Beispiel:

nAskCNTValue=AskTop()

* Speichere Maskenposition         

aQS[nZaehler,17]=nAskCNTValue

Ask("","aQS["+str(nZaehler)+

",6]",cFieldName,10 &_ 

,,250,nAskCNTValue)

   …

cPosFocus="CHK"+padl(aQS[nZaehler,1],20,"0")

&cPosFocus.

SetFocus

()

   CNTQSVALUE.ScrollPos=aQS[nZaehler,17]

TXT

einzeiliges Textfeld – erzeugt zusätzlich ein gleichnamiges LBL

LBL

Bezeichnungsfeld

Beachte die Angabe der Länge im Ask() wird immer von einem längeren Inhalt übersteuert.

CBO

Combobox (manuell bestückt – 2 dimensional) benötigt zur Füllung die Methode AddItem(<cWert>,<cAnzeige>)

Der Wert, muss immer als String angegeben werden.

Zum leeren des Arrays gibt es die Methode Clear().

CBK

Combobox auf Basis der synchronisierten Tabelle Wahl.

Ist bei den Eigenschaften als CBO anzusprechen.

Angezeigt wird das Kürzel.

CBT

Combobox auf Basis der synchronisierten Tabelle Wahl.

Ist bei den Eigenschaften als CBO anzusprechen.

Angezeigt wird der Text des Kürzels

OPT

Option-Buttons

EDT

mehrzeiliges Textfeld

CMD

Schaltfläche

GRD

Tabelle im klassischen Stil (Basis von .Net)

GRH

SWS-Tabelle mit Überschrift ohne transparenten Hintergrund

GRS

SWS-Tabelle ohne Überschrift ohne transparenten Hintergrund

GRT

SWS-Tabelle ohne Überschrift ohne transparenten Hintergrund

CHK

Checkbox

CAL

Kalender-Control (Termine)

CHA

Grafik-Objekt

Ask("","cData","CHAUMSATZ",820,240,4,4)

cData=“Was“+_TAB+“Wert1“+_TAB_+“Wert2“

Ask("Zeit","Wert","CHADATA",,200)

IMG

Objekt zur Bilder-Darstellung

Ask(cFile,"Image","IMGFile",232,130)

IMGFile.Image=cFile

.UPPER

Eingabe nur in Großbuchstaben möglich

.READONLY

Sperrt das Feld gegen Eingaben

.SELECT

Markiert den Inhalt beim Klick in das Feld

.ENABLED

Aktiviert oder Deaktiviert das Feld

.TABSTOP

Steuert die Reihenfolge der Felder

.FONTSIZE

Angabe der Schriftgröße

.FONTBOLD

Setzt den Inhalt auf fette Schriftart

.FORECOLOR

Angabe der Schriftfarbe

.BACKCOLOR

Angabe der Hintergrundfarbe

.CHANGE=.f.

(generell für alle Felder) Nimmt das Feld aus der Automatik, dass bei einer Änderung das Diskettensymbol aktiv wird (oFields-Bezug) oder umgekehrt (bei fehlendem Bezug)

.CAPTION

Bezeichnung des Feldes

.FONTSIZE

Angabe de Schriftgröße

.FONTBOLD

Setzt den Inhalt auf fette Schriftart

.FORECOLOR

Angabe der Schriftfarbe

.BACKCOLOR

Angabe der Hintergrundfarbe

.CAPTION

Bezeichnung des Feldes

.TABSTOP

Steuert die Reihenfolge der Felder

.FONTSIZE

Angabe der Schriftgröße

.FONTBOLD

Setzt den Inhalt auf fette Schriftart

.FORECOLOR

Angabe der Schriftfarbe

.BACKCOLOR

Angabe der Hintergrundfarbe

.ENABLED

Aktiviert oder Deaktiviert das Feld

.TABSTOP

Steuert die Reihenfolge der Felder

.Style=0

Hiermit wird der Wert der Combobox editierbar für Freitexteingabe (nur im Dynamic-Mode)

.InputMask=“!!!!“

Definierung einer Maskierung der Eingabe in Verbindung mit .Style=0 (nur im Dynamic-Mode)

9 = numerisch

! = Großbuchstaben

.Value

Setzt den Wert, der zurückgegeben wird, wenn die Option gewählt wurde.

Dies ist eine Alternative zu der direkten Angabe des Wertes bei der Definition der Darstellung

.Group

Ordnet das Objekt der entsprechenden Gruppe zu, die dann über WH_ und VI_ summarisch angesprochen werden kann.

.RowHeight

Mit dieser Eigenschaft kann die Zeilenhöhe im Grid angepasst werden (nur Dynamic)

.NoRefresh

Unterbindet die Aktualisierung des Grids bei einem Refresh. Dies verhindert das Neuzeichnen und damit ein eventuelles Flackern am MDE

. ActiveRow

Weist dem Grid die zu markierende Zeile zu. Diese erhält man beim _GRIDSELECT als vParam2 zurück

.GoRec(nZahl)

Markiert im Grid die entsprechende Zeile und führt das _GRIDCHANGE Event aus. Bei gesetztem 2. Parameter wird zusätzlich das _GRIDSELECT Event ausgeführt.

.DelayedChange=.t.

Nur im Multiselect-Grid. Führt nach einem bestimmten Intervall (Default1000 ms) das _GridSelect Event aus.

.TimerInterval=5000

Nur im Multiselect-Grid. Definiert die Zeit für die Verzögerung in ms.

.ActivePos=0

0 = Standardverhalten (wie bisher)

1 = aktive Zeile immer am oberen Gridrand anzeigen

2 = aktive Zeile immer am unteren Gridrand anzeigen

.Multiselect=.f.

Macht aus dem GRH ein Grid mit nur einer Auswahl

.SetCols(cCols2)

Mit dieser Zuweisung kann man im Nachhinein einem Grid neue Spaltendefinitionen zuweisen. Z.B.: umsortieren oder eine andere Ansicht

GRDARTPREIS.SetCols(cColsPreis2)

.SetGrid(„oSearch“)

Mit dieser Zuweisung kann man dem Grid ein neuer Cursor / neue Datenmenge zuweisen.

GRDARTPREIS.SetGrid("oSearchPreis2")

.SetValue(nRow,cField ,nWert)

Mit dieser Anweisung kann man Werte im Grid ändern ohne diese neu aufzubauen.

1. Wert: Zeile im Grid

2. Wert: Spaltename im Grid (ergibt sich aus cCols)

3. Wert: Wert der neu angezeigt werden soll

GRDSEARCHANS.SetValue(1,"ADR_FIRMA2","Test")

Es ist zu beachten, dass diese Werte nicht an den Cursor übergeben werden. Es handelt sich um eine reine Ansicht.

.SelectColor=.f.

Bei Tabellen mit Hintergrundfarbe (Spalte _RGB/_BACK) kann es störend sein, dass die aktiven Zeilen immer mit einem grünen Hintergrund dargestellt wird. Dieser kann über diesen Schalter ausgeschaltet werden.

.SelectRow(n,.f.)

Mit Parameter wird die n.-te Zeile markiert (.f.) bzw. demarkiert (.t.)

Ohne Parameter werden alle Zeilen-Markierungen im Grid (Multiselektions-Grid) entfernt

vParam1

Gibt den Namen des Grids aus der Definition der Anzeige zurück. Darüber wird es möglich auf mehrere Grids auf einer Maske zu reagieren.

vParam2

Enthält die Zeilennummer aus dem, dem Grid zugeordneten Cursor, und dient als Sprungmarke zur Anzeige / Ermittlung der gewünschten Daten.

vParam3

Enthält den Spaltennamen auf dem der Klick ausgeführt wurde.

.Add()

Mit dieser Methode wird diesem Grafikobjekt eine Messreihe zugeordnet.

1. Wert: Bezeichnung der Messreihe

2. Wert: Gibt die Form der Grafikdarstellung

/// 1 = Balken

/// 2 = Linien

/// 3 = Linie mit Punkten und Stufen

3. Wert: Farbe der Messreihe in rgb()

4. wert: Das Werte-Paare-Array als String

.Draw()

Zeichnet die Grafik

.Clear()

Löscht die komplette Grafik

.Show0

Über diese logische Variable kann angegeben werden, ob die Null-Linie angezeigt werden soll.

.YDecimals

Gibt an, wieviel Dezimalstellen bei der y-Achsen-Beschriftung verwendet werden sollen

vParam1

Enthält den Feldnamen, der den Einsprungspunkt ausgelöst hat. Z.B.:

txtFeld1

vParam2

Enthält die übergeordnete Einheit zum Feld. Z.B.: den Container

cntEigensch1

1. Wert

Name der Maske

2. Wert

Breite der Maske in Pixel

3. Wert

Höhe der Maske in Pixel

4. Wert

Name unter welchem die Maskeneinstellungen in der Registry gespeichert werden.

1. Wert

Angezeigter Name

2. Wert

Einsprungspunkt der bei Aktivierung gestartet wird

.Text

Damit kann der Text der Funktion im Programmablauf beeinflusst werden.

.Enabled

Bietet die Möglichkeit Funktionspunkte auf Inaktiv zu setzten.

1. Wert

Angezeigter Name

2. Wert

Einsprungspunkt der bei Aktivierung gestartet wird. Dieser ist hier leer.

3. Wert

Gruppennname der Struktur

1. Wert

Angezeigter Name

2. Wert

Einsprungspunkt der bei Aktivierung gestartet wird.

3. Wert

Gruppennname der damit erzeugter Struktur

4. Wert

Gibt an zu welcher übergeordneten Struktur der Menüpunkt gehört.

5. Wert

Funktionstaste um den Menüpunkt direkt starten zu können.

Erzeugt einen leeren Ribbon Datensatz auf der Maske

Der erste Parameter gibt an, wie dieser im Programmcode angesprochen werden kann.

Der Zweite gibt die Bezeichnung im Reiter des Ribbon auf der Maske an.

Mit dieser Funktion richtet man eine logische Gruppe im Ribbon ein. Erkenntlich wird dies auf der Maske durch die senkrechten Teilungsstriche.

Parameter gibt den Bezug zur Page an

Parameter gibt an, wie die Gruppe weiter im Programmcode angesprochen wird

Parameter gibt die Bezeichnung unterhalb der Gruppe an

Mit dieser Funktion können nun Funktions-Buttons auf dem Ribbon platziert werden.

Parameter gibt den Bezug zur Gruppe im Ribbon an

Parameter gibt an, wie der Button weiter im Programmcode angesprochen wird

Parameter gibt die Beschriftung unterhalb des Buttons an

Parameter gibt den Shortcut zur Bedienung des Ribbons mit der Tastatur an

Parameter ist der Anzeigetext (Tooltip) für die Shortcuts

Parameter gibt den Einsprungspunkt an, hinter dem sich der Code zur Ausführung nach dem Betätigen dieser Auswahl verbirgt

Parameter ist die Nummer des anzuzeigenden Icons.

Parameter: letKeysActive (bool) Ist der Wert gesetzt (.t.), so bleiben Hotkeys bei der Anzeige in der Ribbonbar auch mit Betätigen des aktuellen Hotkeys stehen. So kann über die Tastatur eine ganze Reihe von Befehlen Funktionsaufrufen nacheinander ausgeführt werden. Dies geht so lange, bis ein Button der Ribbonbar betätigt wird, bei welchem die Eigenschaft auf .f. gesetzt ist.

Soll sich hinter einem Button eine weitere Auswahl zur Verfügung gestellt werden, so wird dies über die Sub-Buttons gemacht. Dies bedingt zuerst einen neutralen Button Funktionsaufruf. Auf diesen referenzieren dann die Sub-Buttons.

Parameter gibt den Bezug zur Hauptbutton der Gruppe an

Parameter gibt an, wie der Sub-Button weiter im Programmcode angesprochen wird

Parameter gibt die Beschriftung neben dem Button an

Die weiteren Parameter sind identisch mit denen des Buttons

Mit dieser Funktion wird die Ribbon-Bar neu gezeichnet und alle Valids- und Whens- der einzelnen Objekte neu durchlaufen.

Definiert ein Panelobjekt. Am besten in dem Einsprungspunkt _INIT.

Der Parameter gibt die Ausrichtung an

0 = links

1 = rechts

Eine Benamung der Panels erfolgt hier nicht. Die Reihenfolge der Definition ist hier ausschlaggebend.

Füllt das Panel

1. Parameter – links oder rechts

2. Parameter – Welches Panel

3. Parameter - Inhalt

Leert die Maske komplett und setzt die Überschrift in den Programmkopf.

Der zweite Parameter gibt die Breite der Maske an. Der dritte die Höhe.

Der letzte Parameter kann angegeben werden, wenn sich das System die letzte Position und Größe in der Registry speichern soll.

Mit dieser Eigenschaft kann zur Laufzeit die Höhe der Maske vergrößert oder verkleinert werden - z.B.: Zur Anzeige der Suchergebnisse.

Mit dieser Eigenschaft kann zur Laufzeit die Breite der Maske vergrößert oder verkleinert werden.

Überschrift der Maske neu zuweisen.

Aktuell ist kein Auslesen des Wertes möglich.

Über diese Werte lassen sich die Maskenbegrenzungen einstellen. Das heißt die Masken können dann nicht größer als …MAX und nicht kleiner …MIN werden.

Die Werte lassen sich nicht nur setzen, sondern auch abfragen.

Über diese Methode lässt sich der Fensterstatus abfragen / setzten:

0 = Normal

1 = Minimiert

2 = Maximiert (bis …MAX)

Setzt die Skalierung der Maske auf 130%

Verhindert das Schließen der Maske über das rote X

Da man am MDE immer nur eine Maske hat, führt das Entfernen des X dazu, dass es bei einer eventuellen Rückkehr in einen Vordialog dort auch verschwunden ist. Möchte man den Wert nicht bei jedem Dialog auf .t. setzen, so empfiehlt es sich das Handling um den Funktionsaufruf zu bauen.

_screen.clos

able=.f.

lRet=DoFunc(…)

_

screen.clos

able=.t.

Ordnet allen Feldern auf der Maske die neuen Inhalte zu.

Ordnet allen Feldern in dem angegebenen Objekt die neuen Werte zu. Ohne die gesamte Maske neu aufzubauen.

Setzt den Focus in das Feld „cLager“

Schliesst die aktuelle Maske

Schliesst nicht nur die Maske, sondern führt darüber hinaus noch einen Logout durch. Man findet sich danach wieder in der Anmeldemaske für Professional-MDE

Einsprungspunkt, der beim Druck der Taste <xxx> aufgerufen wird.

Bsp: KEY_ENTER oder KEY_ESCAPE

In der SWSMDE.INI kann über diese Zuweisung einer speziellen Funktionstaste das Verhalten der dahinter angegebenen Taste zugeordnet werden.

Erläuterung: Da es auf manchen MDE die ESC-Taste nicht gibt, wird hier der Taste F15 das Verhalten für ESC zugeordnet. Im Code wird der Einsprungspunkt KEY_ESCAPE ausprogrammiert. Wird nun die taste F15 betätigt wird der Code hinter KEY_ESCAPE ausgeführt.

Verwirft ab dem Setzten die Eingaben über die Tastatur. Dies verhindert Eingaben im Textfeldern und die Einsprungs-Punkte KEY_xxx.

Nimmt nun wieder die Eingaben über die Tasten entgegen.

Löscht den aktuellen Tastatur-Puffer

Meldung an den User durch einen einfachen Meldungsdialog.

Parameter ist der anzuzeigende Text

Parameter wird nur ausgewertet wenn dieser mit

poropob()

Wichtig ist die bei fremdsprachigen Versionen, da die Texte der Meldungsfenster automatisch in die LANGUAGE eingehen. Wird hier der variable Textteil mit im 1. Parameter angegeben, so würde der Text in jeder Variation in der LANGUAGE zum übersetzten ankommen.

In der Funktion

poropob()

Parameter bzw. wenn dieser nicht angegeben wird und der 2. Parameter ein String ist, ist dies die Headline der Meldung (optional)

Rückfragedialog mit den zwei Schaltflächen „JA“ und „NEIN“.

Zurückgegeben wird bei „JA“ eine 1 – bei „NEIN“ eine 0.

Anzuzeigender Text

Default-Button – mit Semikolon getrennt kann die Zeit angegeben werden, wann die Frage automatisch beantwortet wird ("J;25") (Zeitsteuerung geht nur, wenn auch der 3.Parameter = Neuer Rückfragedialog)

Kopfzeile der Maske

Ausrichtung 1=zentriert

Hintergrundfarbe als RGB angegeben

Farbe des 1. Buttons als RGB

Farbe des 2. Buttons als RGB

Schriftgröße der Buttons

Im PC-Modus wird bei einer Parameterzahl <=3 die kleine Messagebox() aus dem Standard verwendet.

Infodialog analog meld(), nur dass hier die ganze Maske dazu verwendet wird und weitere Buttons zur Verfügung stehen.

Parameter:

Anzuzeigender Text

Kopfzeile der Maske

Text-Ausrichtung (0=links – 1=mittig – 2=rechts)

Hintergrundfarbe als RGB angegeben

Farbe des Buttons als RGB

Schriftgröße des Textes

Showme zur Anzeige von Variablen (Arrays) analog Standard-Showme

n=adir("aFiles",cFilePath)

showme("aFiles[3]")

Spielt einen Ton. Es stehen 6 verschiedene Töne zur Verfügung

 (nInt von 1 bis 6)

Spielt die angegebene Wave-Datei ab. Die Angabe muss inkl. Pfad erfolgen.

Setzt den Cursor als symbolische Sanduhr. Die Sanduhr wird automatisch vor einem meld() beendet.

Setzt den Cursor wieder zurück

Potenz

Multiplikation

Division

Addition

Subtraktion

Gleich (Werte)

Identisch (Stringvergleich)

ungleich

Größer (Alle Stringvergleiche ab 2.6.006 auch für Alpha-Werte)

kleiner

größer gleich

kleiner gleich

logisches und

logisches oder

logisches nicht

Zeigt an, ob der übergebene Wert gefüllt ist

Mit den Funktionen kann der Mnimal- bzw. Maximalwert von zwei numerischen Werten ermittelt werden

nErg=min(nWert1,nWert2)

Gibt den Typ des angefragten Objektes zurück:

U – undefiniert

C – Character

N – Numerisch

T – Date-Time

D - Datum

O - Objekt

Wandelt ein Datumswert in einen String.

Wird der zweite Parameter weggelassen, so findet lediglich eine Typwandlung statt.

Mit 1 werden die Hochkommata für Abfragen gesetzt

Mit 2 wird ein Datumswert in das SQL-CE Format gewandelt

Mit 4 entscheidet der Parser, ob es eine PC-Umgebung auf FoxPro-Tabellen oder eine SQL-CE Datenbank ist. Dementsprechend ist der String wie 1 oder 2 formatiert.

Wandelt den Wert aus nWert in einen String mit 12 Vorkomma- und 2 Nachkommastellen um

Schneidet Leerzeichen am Anfang und Ende des Strings ab.

Schneidet Leerzeichen am Anfang des Strings ab.

Schneidet Leerzeichen am Ende des Strings ab.

Wandelt einen Wert in einen String um unter Berücksichtigung der Picture-Klausel (nur Numerische Werte umgesetzt!)

Ergänzt den übergebenen String rechts bis zur angegeben Anzahl (2. Parameter) mit Leerzeichen bzw. dem Zeichen an 3. Stelle.

Ergänzt den übergebenen String links bis zur angegeben Anzahl (2. Parameter) mit Leerzeichen bzw. dem Zeichen an 3. Stelle.

Wandelt den angegeben String in Großbuchstaben um.

Wandelt den angegeben String in Kleinbuchstaben um.

Gibt die Anzahl von Zeichen des übergeben Strings zurück.

Gibt die Stelle im String cText zurück, an der die Such-Zeichenkette cSuch das erste Mal auftritt. at() ist dabei Case-Sensitiv.

Gibt die Zeichen aus dem String (1. Parameter) ab dem zweiten Wert aus. Ist kein dritter Parameter angegeben, dann bis zum Ende des Strings, ansonsten so viele Zeichen, wie der 3. Wert angibt (hier also 2).

Gibt die 5 (2 Parameter) linken Zeichen aus dem String zurück

Gibt die 5 (2 Parameter) rechten Zeichen aus dem String zurück

Prüft, ob der Wert in ersten Parameter (cLand) in der weiteren Aufzählung (ab 2. Parameter) vorhanden ist. Wenn Ja, so gibt die Funktion .t. zurück. Sonst .f.

Ersetzt in dem String

cText

cSuche

cErsetze

Gibt den Teilstring aus

cText

Prüft den übergebenen Text, ob dieser mit einem \ endet. Ist dies nicht der Fall, so wird der String um einen \ erweitert.

Wandelt eine Zahl in den numerischen Wert unter Berücksichtigung der länderspezifischen Trenner („.“, „,“) um.

Handelt es sich um keinen numerischen Ausdruck, so wird 0 zurückgeliefert. (SWS-UDF!)

Interne Funktion von Foxpro und die gibt einen Fehler aus, wenn cText nicht numerisch darstellbar ist.

Gibt den ASCII-Wert des Arguments zurück

Gibt das Zeichen für den ASCII-Wert zurück

Wertet den als String übergebenen Ausdruck aus und gibt den Wert zurück.

In diesem Beispiel interpretiert

eval

aFields[nField,1]

VOR_AUF

oFields.VOR_AUF

eval(oFields.VOR_AUF)

602100

Wandelt den angegeben ASCII-Code in das korrekte Zeichen um. Dies auch für nicht druckbare Zeichen.

Setzt bzw. fragt Werte aus einer Wertepaarstruktur ab. Die Werte werden immer als String gespeichert.

1. Parameter – Name der Struktur

2. Parameter – Name des Wertepaares

3. Parameter – Wert

4. Parameter – Erwarteter Typ der Abfrage

N = numerisch

D = Datum

T = Datum mit Uhrzeit

Wir der 3. Parameter angegeben, so wird dieser gesetzt.

Schneidet den Nachkommawert ab

Rundet den Wert mathematisch auf bzw. ab. Der Wert nStelle ist optional und gibt die Nachkommastelle auf welche gerundet werden soll. Default ist 0. Negative Werte wirken sich auf die Vorkomastellen aus.

Gibt den nächst höheren Integerwert in Bezug auf nWert zurück.

Gibt den positiven Wert zurück als INT bzw. Double.

Ordnet der Variablen das heutige Datum zu

Ordnet der Variablen das kurze Datum {24.12.2011} zu. Werte müssen numerisch übergeben werden (vall())

Ordnet der Variablen das heutige Datum inklusive der Uhrzeit zu

Gibt die aktuelle Uhrzeit als String zurück

64-Bit-10tel Mikrosekunden seit 1. Januar 0001

Ergibt die Sekunden aus der datetime-Variablen

Ergibt die Minuten aus der datetime-Variablen

Ergibt die Stunden aus der datetime-Variablen

Ergibt den Tag aus einer date- bzw. datetime-Variablen

Ergibt den Monat aus einer date- bzw. datetime-Variablen

Ergibt das Jahr aus einer date- bzw. datetime-Variablen

Gibt aus dem Datumsstring inkl. Zeit (31.12.2010 12:01:25) nur das Datum (31.12.2010) zurück.

D.h. es findet einen Konvertierung des Typs von DAteTime zu Date statt

Konvertiert den Date-Time-Wert in einen Text-String

Konvertiert den Datumswert in einen Text-String

Addiert die Anzahl Tage zu dem aktuellen Tagesdatum

Addiert die angegebene Anzahl von Monaten zum Tagesdatum

Addiert die Anzahl der Sekunden zu einem Date-Time-Wert

Gibt den Wochentag des Datums als Zahl zurück (Sonntag=1)

Ermittelt aus dem binären Wert

b

Wert

nBit

Setzten des Bits

nBit

bWert

Löscht in der Variablen

bWert

nBit

Gibt den Bitwert zurück der in beiden Bitwerten gemeinsam gesetzt ist

Gibt den Bitwert zurück der entweder in dem einen oder anderen Bitwert gesetzt ist

If - Schleife

Einzeilige if-Abfrage

Do Case

Do-While – Scheife

Prüft, ob die Funktion „P_XXX“ importiert wurde und vorhanden ist.

Prüft, ob es den Einsprungspunkt _INIT in der Funktion P_XXX gibt.

Erzeugt einen Cursor als Rückgabewert.

1. Parameter - 0=lokale Datenbank

1=Serverdatenbank

2. Parameter – Felder

3. Parameter – Tabelle (from)

4. Parameter – Bedingung (where)

5. Parameter – Sortierung (order by)

6. Parameter – Gruppierung (group by)

7. Parameter – Having

8. Parameter – Name des Cursors für SQL-Server. „~“ Erzeugt den Cursor auf dem SQL-Server. „~NAME“ vergibt zusätz-lich den Namen.

Anmerkung: Ist der erste Parameter nicht numerisch, so wird dieser als “Felder” genommen und alle Parameter verschieben sich nach vorne.

Wird der 8. Parameter gesetzt kommt kein Cursor zurück, sondern ein String. Auf den Cursor auf dem Server kann dann über einen weiteren Select auf ~NAME eventuell #NAME zugegriffen werden.

In diesem Fall muss der Speicher wieder manuell freigegeben werden mit:

DelCursor(oSearch)

Löscht den angegebenen Cursor-Inhalt. Vernichtet aber das Objekt nicht.

Wichtig ist dies vor allem für Cursor, die auf dem SQL-Server erzeugt wurden. Aber auch bei lokale – sehr großen – Cursorn kann hiermit der Speicherbedarf reduziert werden.

Lokal: DelCursor(oSearch)

SQL: DelCursor(„~NAME“)

Gibt die Anzahl der Ergebnissätze des angegebenen Cursors an.

Liest aus dem angegeben Cursor die Zeile, die an zweiter Stelle übergeben wird.

Löscht die angegebene Zeile (nRow) aus dem lokalen Cursor.

Als Rückgabewert wird der Erfolg der Löschung erhalten.

Liest das an zweiter Stelle angegeben Datenbankfeld aus der übergebenen Reihe und übergibt diesen als Rückgabewert,

Befehl zur direkten Ausführung von SQL-Statements. Beginnt der Befehl mit #, so werden Fehler nicht ausgegeben, sondern ignoriert.

Erzeugt eine lokale Tabelle.

1. Parameter - Tabellenname

Danach kommen paarweise, Komma getrennt angegeben die Feldnamen und Feldtypen.

Legt für die Tabelle

TAB

FELD

Fügt in die Tabelle “

TAB

Ändert in der Tabelle „TAB“ den Satz mit der ID=123 (immer 2. Parameter ist die ID) ab. Dabei werden die Felder und Werte wieder paarweise, Komma getrennt angegeben.

Ändert in der Tabelle „TAB“ für alle Sätze die der Where-Bedingung unterliegen, das angegeben Feld auf den angegebenen Wert. Dabei werden die Felder und Werte wieder paarweise, Komma getrennt angegeben. (Massenupdate)

Löscht den Satz der ID=321 (immer 2. Parameter ist die ID) in der Tabelle „TAB“

Löscht die Tabelle „TAB“ aus der lokalen Datenbank.

Prüft, ob das angegebene Feld

ID

TAB

Der zweite Parameter ist optional. Normalerweise werden die Werte von pofda() gecacht. Möchte man das umgehen (z.B. für temporäre Tabellen, so übersteuert der 2. Parameter = .t. das Caching.

Funktion gibt in Abhängigkeit des optionaen 3. Parameters den Wert aus der Tabelle WAHL zurück.

Achtung immer als String!

Parameter gibt den Bereich (WAH_FELD) in dem gesucht wird

Parameter ist das Kürzel als Suchbegriff

Parameter. Ist dieser nicht gefüllt, so wird die Bezeichnung des Kürzels zurück gegeben. Wird hier ein Wert übergeben, so wird dieser als Feldname in der Tabelle WAHL gewertet und der entsprechende Feldinhalt dieser Spalte zurückgegeben.

Für jedes Feld das in der Feldliste des Cursor steht wird nun im Objekt oFields ein Wertepaar definiert. (Name der Spalte, Inhalt der Spalte).

Der zweite Parameter ist optional und gibt den Datensatz im Cursors an, die eingelesen wird. Wird der Parameter weggelassen, so werden die Werte des ersten Datensatz gesetzt.

oFields=

GETBLANK

(oSearch

)

Im Falle, dass man für jedes Feld einen leeren Wert initialisieren möchte, so kann dieser Aufruf genutzt werden.

Erstellt eine mehrdimensionales Array(n,2) aus dem oFields-Objekt.

aFields[n,1]Name der Tabellenspalte

aFields[n,2]Wert in der Tabellenspalte

Die Aufgabe wird an den Server übergeben. Auf eine Antwort wird nicht gewartet. Das heißt am MDE geht die Arbeit sofort weiter.

Folgende Parameter hat die Funktion

Serverfunktion, die aufgerufen werden soll

Parameter-Liste zur Übergabe

Bei mehreren Job-Verarbeitungen kann die Gruppe für die Jobverarbeitung mitgegeben werden.

lNoSync – Nach der Übergabe startet nicht ein Sync, sondern erst, wenn wieder die Zeitspanne für den nächsten Sync erreicht ist. Ohne Gruppe kann der Wert auch als 3. Parameter übergeben werden. (Default ist .f.)

Beispiel

A

SyncJob("PONLINE",cParam,

“ADM“

,

.t.

)

Die Aufgabe wird an den Server übergeben. Der aktuelle Prozess wartet nun bis eine Antwort vom Server kommt. Erst dann geht die Arbeit am MDE weiter.

Folgende Parameter hat die Funktion

Serverfunktion, die aufgerufen werden soll

Parameter-Liste zur Übergabe

Bei mehreren Job-Verarbeitungen kann die Gruppe für die Jobverarbeitung mitgegeben werden.

Zeit in Millisekunden, wann der Job bei einer eventuellen Nicht-Erreichbarkeit abbricht.

Beispiel

cOutput=SyncJob("PONLINE",cParam,,1000)

Mit diesem Aufruf kann der aktuelle Verbindungsstatus zum Webserver abgefragt werden.

Der Rückgabewert ist wahr, wenn aktuell eine Verbindung zustande kommt.

Veraltet – bitte Online() verwenden

Mit diesem Aufruf kann der aktuelle Verbindungsstatus zum Webserver abgefragt werden.

Der Rückgabewert ist wahr, wenn aktuell eine Verbindung zustande kommt.

Stoppt die Synchronisation. Als Parameter existieren folgende Werte:

.f. oder ohne Parameter = Sync-Abbruch wenn aktueller Sync beendet

.t. oder 1 = Sync-Abbruch nach aktueller Tabelle

2 = Sync-Abbruch sofort

3 = Sync-Abbruch durch Benutzer (kann nur durch SyncStart(.t.) wieder aufgehoben werden. Beendet Sync nach aktueller Tabelle.

Default ist .f.

Startet die Synchronisation wieder, sofern diese nicht mit SyncStop(3) generell gestoppt wurde.

Startet die Synchronisation wieder, sofern diese mit SyncStop(3) generell gestoppt wurde.

Funktion zur Abfrage des aktuellen Sync-Zustandes. Folgende Rückgabewerte wurden definiert:0 = Sync ist angeschaltet1 = Sync wird nach Abschluss des aktuellen Sync-Laufs beendet2 = Sync wird nach Abschluss aktuelle Tabelle beendet3 = Sync wird sofort beendet4 = Sync ist angehalten5 = Sync wurde durch den Benutzer angehalten (StopSync(3))

Korrigiert die interne Zeit der letzten Synchronisation um n Minuten. So können fehlende Sätze neu synchronisiert werden. – Sonderfall

Ist als Alternative zu SyncStart() zu sehen. Währen bei SyncStart() sofort die nächste Synchronisation beginnt, läuft bei SyncResume() der Timer zur nächsten Synchronisation im Hintergrund weiter. Erst wenn dieser 0 wird, beginnt der nächste Sync.

Diese Funktion prüft, ob die Datei, die inklusive Pfad in der Variablen cFile existiert. Der Rückgabewert ist .t. oder .f.

Gibt zu einer übergeben Datei die Zeitattribute je nach Modus zurück

nMode = 1: Erzeugung (wird beim Kopieren verändert)

nMode = 2: Letzter lesender Zugriff

nMode = 3: Letzter schreibender Zugriff

Legt das in cPath angegeben Verzeichnis an. Existiert dies bereits macht das Programm nichts

Löscht das angegeben Verzeichnis

Kopiert die Datei cFile, die inklusive Pfad anzugeben ist, in das Zielverzeichnis.

Als 3. Parameter kann angegeben werden, ob die Datei im Zielverzeichnis einfach überschrieben wird (Default .f.)

Mit dem 4. Parameter kann man sagen, ob die Datei kopiert (.f.) oder aber verschoben (.t.) werden soll. Default ist hier .f.

Die Funktion gibt die Anzahl der Dateien als Rückgabewert zurück.

Parallel erhält man die Dateinamen im angegebenen Array zurück.

Enthält der 2. Parameter einen „.“ (Punkt), so wertet das System diesen Teilstring als Filter auf die Dateien (also auch ‚R*.pdf‘). Wenn nicht, werden alle Dateien im Verzeichnis zurück gegeben.

Der 3. Parameter ist optional und gibt an, ob auch Unterverzeichnisse mit durchsucht werden sollen. Wird dieser nicht angegeben, dann wird nur das angegebene Verzeichnis durchsucht.

cFilePath="C:\temp"

oder

cFilePath="C:\temp

\*.pdf

"

aFiles=““

adim(„aFiles“,0)

n=adir("aFiles",cFilePath)

meld("Anz.

:

"+v2c(n

)+"/

"+v2c(aFiles[1

])+"

/"+v2c(alen("aFiles")))

Löscht die angegebene Datei.

Veraltet – bitte

FDEL

Löscht die angegebene Datei.

Diese Funktion wandelt die Datei in übertragbares Format und trägt automatisch die Werte für den Upload in die Tabelle MDEUPLD ein.

Über einen zweiten Parameter kann angegeben werden, ob die Datei kopiert oder verschoben wird (lMove)???

Als Rückgabewert erhält man dann den Namen, den die Datei später im Upload-Verzeichnis (UPLOADPATH in SWSWEB.ini) auf dem Server haben wird.

Die Realisierung der Umwandlung passiert während der normalen Jobverarbeitung, wenn diese ausgeführt wird.

Wandelt die Datei cFile in einen Hex-String um und speichert diesen in der Variablen z.B.: cImage.

Diese kann dann als Parameter in cParams an den Serverprozess übertragen werden. (ALT – neu siehe addupload)

Wandelt die Datei cFile in einen String um und speichert diesen in der Variablen z.B.: cStr.

nID=setMDEfile()

Mit dieser Server-Funktion wird die Tabelle MDEFILE gefüllt bzw. aktualisiert, wenn die Datei bereits vorhanden war.

Der Rückgabewert der Funktion ist die ID des Satzes in der MDEFILE

1. Wert: Datei inkl. Pfad die synchronisiert werden soll

2. Wert: Referenztabelle – Oberste Ebene des Speicherortes auf den MDE

3. Wert:Referenz-ID – Fasst alle zusammengehörigen Dateien in der Speicherstruktur auf dem MDE zusammen. Die ID wird in Teilstrings zerlegt und ergibt daraus die Speicherstruktur. Siehe dazu die Konfigurationsvariable FILESDIRLENGTH (3)

4. Wert:Dateiname zur Identifikation der Datei in der MDEFILE

5. Wert:Typ der Datei – Eine weitere Möglichkeit Dateien zusammen zu fassen. Siehe hier auch die Anmerkungen zu aDirMDE()

6. Wert:Filterbedingung für Geräte und Gerätegruppen

7. Wert:Info über den Erfolg der Funktion als Referenz<leer> wenn alles OK-3 wenn Datei oder Verzeichnis nicht existieren

Beispiel:

?setmdefile("c:\temp\

art

.txt","

ART

",123,

"DGDAT1","INFO",,@cMessage)

CheckMDEFile()

Future Wish

Diese Funktion sollte auch als Server-Funktion bereit gestellt werden. Die Funktionsweise sollte wie folgt sein:

Die Funktion nimmt alle in der Servertabelle MDEFILE hinterlegten Sätze und prüft

Ist Datei vorhanden und Zeitstempel passt – mache nichts

Ist die Datei vorhanden und Zeitstempel ist falsch (egal wie) – Schreibe Zeitstempel neu in Datei und setze curtimest hoch

Ist die Datei nicht mehr vorhanden – lösche den Satz in MDEFILE und schreibe einen MDEDEL-Satz

Somit wären auch Änderungen am Server einfach wieder den MDE’s mitteilbar

Wenn nicht dann:

cPathF="C:\TEMP\*.*"

dime aFiles(1,5)

adir("aFiles",cPathF)

?aFiles[x,1]Name der Datei

?aFiles[x,2]Größe der Datei in Bytes

?aFiles[x,3]Datum des Zeitstempels

?aFiles[x,4]Uhrzeit des Zeitstempels

?aFiles[x,5]Dateiattribute

Diese Funktion prüft alle Dateien, die in der lokalen Tabelle MDEFILES stehen, ob diese auf dem MDE vorhanden sind und ob der Zeitstempel in der Tabelle mit der Datei zusammenpasst. Ist dies nicht der Fall, so wird die Datei erneut zum Download angefordert. Dies erfolgt über das Feld Status=0.

Diese Funktion gibt den kompletten Pfad inkl. Dateiname zu der gespeicherten Datei als String zurück.

E:\MDEDB_DM\FILES\

ART

\000\000\000\000\123

\ART.TXT

Gibt als String die nächste GUID (Dateiname für Dateiupload) zurück.

Diese Funktion wird nicht mehr benötigt, da dies heute bereits automatisch in der Funktion addUpload() integriert ist.

Analog dem Befehl adir() mit dem man Dateien in einem Verzeichnis auflisten kann.

Dieser Parameter nimmt einem im Prinzip die Aufsplittung der Unterverzeichnisse ab.

1. Wert: Array zur Aufnahme der Dateinamen

2. Wert: Referenztabelle – Oberste Ebene des Speicherortes auf den MDE

3. Wert:Referenz-ID

4. Wert:Hierüber kann man einen Filter definieren, welche Files gewünscht werdenA*.pdf – alle Dateien beginnen mit A und der Endung PDF*.pdf – Alle PDF-DateienINFO – alle Dateien mit MDI_TYPE=INFO

Diese Funktion ist speziell für die Geräte von Motorola (MC55) geschrieben und erlaubt es Fotos mit der Integrierten Kamera aufzunehmen.

Die Funktion hat 11 Parameter

1. Wert: Name der zu erzeugenden Datei

2. Wert: Auflösung des Bildes zB. „R_1024x768“

(R_1024x768, R_800x600, R_640x480, R_1280x1024, R_160x120, R_320x240, R_352x288, R_176x144, R_1280x960, R_1600x1200, R_2048x1536)

3. Wert: JPEG-Komprimierung in % von 0-100

4. Wert: Fenstertitel

5. Wert: Infotext zum Bild

6. Wert: Gibt an, ob das Fotofenster geschlossen werden darf (rotes X)

7. Wert: Text für Button „aufnehmen“

8. Wert: Text für Button „verwerfen“

9. Wert: Text für „speichern und beenden“

10. Wert: Text für „beenden ohne Bild“

11. Wert: Text für „Lampe“

Erzeugt die Datei aus dem Base64-Feld der Tabelle MDEUPLD (füllt AddUpload-Funktion) bzw. kopiert diese aus dem Upload-Verzeichnis an die gegebene Stelle.

1. Wert: Dateiname aus MDEUPLD

2. Wert: Ablagepfad

3. Wert: Soll Datei in der Upload-Tabelle erhalten bleiben

4. Wert: ???

5. Wert: ???

Eventuell wird dies nicht mehr benötigt, da addUpload und die Datensynchronisation heute dafür sorgt, dass die Datei automatisch in einem Zielverzeichnis auf dem Server landet, (siehe Zugriff auf das Dateisystem)

Erweiterung des ASK-Befehles um Bilder auf Masken darzustellen

Weist dem IMG-Objekt z.B. beim Klick ein neues Bild zu

Startet den Reportgenerator mit der angegeben XML-Datei.

Ist diese nicht vorhanden, so wird diese neu angelegt.

Aufruf der PDF-Erzeugung.

Parameter: Cursor für die Daten auf dem Report. Aktuell geht hier nur ein Cursor, der alle Daten pro Satz enthalten muss.

Parameter: XML-Layoutfile für den Report oder der Einsprungspunkt, wenn der Report über die MDE-Verwaltung als Report gepflegt wird.

Parameter. Zielname des fertigen Dokuments

Öffnet das angegeben Dokument auf dem MDE-PC

Der 4. Parameter kann dazu genutzt werden, dass der aufrufende Dialog weiter bearbeitet werden kann (nicht modal). .f. ist der Default-Wert.

Druckt das angegebene PDF-Dokument auf den angegebenen Drucker

Die Funktion RUN startet das Programm, das als erster Parameter übergeben wird.

Der zweite Parameter nimmt eventuell Übergabeparameter für das Programm auf.

LAN_MDE

Numerisch 1

CURTIMEST

Datum / Zeit

Textstrings, die mit „~“ beginnen werden nicht übersetzt.

Bei der Ausgabe wird die Tilde abgeschnitten.

Ermittelt den fremdsprachigen Text für ein Objekt mit dem vorgegebenen deutschen Text.

ScaleFont=1,5

Bringt die Schriftgröße in ein Format, das gut lesbar ist

ScaleX=1,1

Verbreitert die Maske so, dass es füllend auf dem Honeywell angezeigt wird

ScaleY=1,2

Skaliert die Höhe der Felder der Maske so, dass es füllend auf dem Honeywell angezeigt wird

ScaleGrid=1,2

Damit können die Spalten im Grid um einen Faktor vergrößert werden, so dass diese zum PC-Client passen.

MENULOGO=NO

Entfernt auf der Menüebene das Professional-Logo, so dass 4 Menüpunkte auf die Seite des Honeywell passen

PROGLOVE=NO

Hiermit kann der Button „Proglove verbinden“ auf der Login-Maske ausgeblendet werden

LOGFILE=YES

Schafft die Möglichkeit Events auf dem Gerät zum Ablauf zu speichern. Die Datei mit dem Namen LogFile<datum> wird im LOG-Verzeichnis des ProfessionaERP-Ordners abgelegt

LOGVERBOSITY=E

Gibt das Level für das Logging an (E=Error)

Kurzform

Beschreibung

V

Verbose

D

Debug

I

Info

W

Warnung

E

Error

F

Fataler Error

S

Still

<…

>.WResize=.t.

Vergrößert das Objekt in der Breite

<…

>.HResize=.t.

Vergrößert das Objekt in der Höhe

<…

>.HCount=3

Gibt an wie viele größenveränderliche Objekte in der Horizontalen vergrößerbar sind (Achtung nicht Höhe sondern in der Breite) – muss bei jedem Objekt angegeben werden

<…

>.HPos=3

Gibt die Position an, an der wievielten Stelle das Objekt in Bezug auf die horizontalen größenveränderlichen Objekte liegt.

<…

>.VCount=2

Gibt an wie viele größenveränderliche Objekte in der Vertikalnen vergrößerbar sind

<…

>.VHPos=2

Gibt die Position an, an der wievielten Stelle das Objekt in Bezug auf die vertikalen größenveränderlichen Objekte liegt.