Kaufmännische Software für Handel, Handwerk und Produktionsbetriebe
{ActionsNamen} (SQL-Registry)
\ROOT\OBJECTS\DATAOBJECTS\{DataobjectsNamen}
\Actions\{ActionsNamen}\
Der Bezeichner {ActionsNamen} ist ein frei eingebbarer Name, unter dem der neue Menüpunkt in der SQL-Registry eingefügt werden soll. Dieser Name ist nicht der Anzeigename.
Für jeden Menüeintrag wird ein eigener Ordner unterhalb von „Actions“ angelegt. Diese Einträge werden im Extras-Menü der dazugehörenden Bildschirmmaske angezeigt.
In diesem Beispiel wird das Notepad in das Adressmenü integriert. Der Inhalt des Feldes „Match“ wird als Parameter inkl. der Dateierweiterung „.TXT“ an das Notepad übergeben. Auf diese Weise kann eine Textinformation zur angezeigten Adresse eingesehen bzw. gespeichert werden. Im Netzwerk sollte dann ein UNC-Pfad vor den Dateinamen gestellt werden, damit die Textdaten zentral von allen Arbeitsstationen erreichbar sind. Also zum Beispiel: \\Servername\Freigabe\&match%.txt.
Es gibt derzeit zwei unterschiedliche Typen der Action. Ein Typ ist der zum Aufruf von externen Programme mit dem Wert „ShellExecute“ und der andere zur Erzeugung einer CSV-Datei mit dem Wert „CsvExport“.
| Type= { Zeichenfolge } |
EULANDA® unterstützt für die Eigenschaft „Type“ zwei Werte:
|
Folgende Eigenschaften werden für den Type ShellExecute unterstützt:
| CommandText= {Zeichenfolge} |
Hier wird das zu startende
Fremdprogramm mit UNC-Pfadangabe eingetragen.
Benutzen Sie auf keinen Fall
Laufwerksbuchstaben, da die SQL-Registry für das
gesamte Netzwerk gültig ist und die Laufwerke
auf den Arbeitsstationen unterschiedlich
gemapt sein können. Beispiel: |
||||
| Context= { Integer } |
Gibt an, ob der Aufruf eines Fremdprogramms
davon abhängt, ob ein Datensatz selektiert sein
muss oder nicht.
|
||||
| Parameters= { Zeichenfolge } |
Enthält die Parameter, die an das Fremdprogramm übergeben werden können. Neben festen Parametern ist auch die Übergabe von Feldern des aktuell angezeigten Datensatzes möglich. In diesem Fall werden die zu übergebenden Feldnamen in Prozentzeichen eingefügt. Beispiel: Hier wird ein fester Parameter -a mit den beiden Feldinhalten ID-Nummer und Matchcode der aktuellen Adresse übergeben. |
||||
| Title= { Zeichenfolge } |
Ist der Name des Menüeintrags. Der Kurzeintrag wird durch Voranstellen eines kaufmännischen UND-Zeichens markiert. Soll ein Menüname „Müller & Co“ benutzt werden, so müssen zwei kaufmännische UND-Zeichen eingetragen werden. Beispiel: Der Menüeintrag „Mein Notepad“ wird nun in das Extramenü von beispielsweise „Adressen“ eingefügt. Der Menüpunkt ist immer dann aktiv, wenn eine Adresse selektiert ist. |
Folgende Eigenschaften werden für den Type CsvExport unterstützt:
Kleine Einführung
Die Möglichkeiten des CSV-Exports sind sehr leistungsfähig und vielseitig. Zur Bereitstellung der Daten ist es möglich, komplexe SQL-Befehle zu verwenden, um so neben Feldberechnungen auch Verweise aus anderen Tabellen heranziehen zu können. Zusätzlich lassen sich über Aliase Feldnamen ändern.
Einbindung in das Extramenü
Der CSV-Export wird in das Extramenü eingebunden. Hierbei wird zur Anzeige im
Menü der Wert aus „Title“ verwendet. Über die Einstellung in „Context“ kann
eingestellt werden, ob ein Datensatz am Bildschirm angeigt werden muss und
erst dadurch der Menüpunkt freigegeben wird, oder ob der Export unabhängig
vom angezeigten Datensatz ist. Ist die Ausgabe vom angezeigten Datensatz
abhängig, so kann über eine Variable auf die „ID“ des Datensatzes
zugegriffen werden.
Datenbereitstellung
Die Daten, die exportiert werden sollen, werden über einen SQL-Befehl (CommandText)
ermittelt. Hierdurch kann im SQL-Befehl gerechnet werden, Feldnamen können
neu benannt oder kombiniert werden, und es lassen sich Daten aus
verschiedenen Tabellen mixen.
Bedingungen über Dialoge
Es können Eingabedialoge eingeblendet werden. Hierzu wird „DlgBox“ auf den
Namen eines gültigen Dialogtyps gesetzt. Die Ergebnisse können als Variablen
im SQL-CommandText verwendet werden. Neben Datums-, Zahlen- und Textdialogen
können für die Artikel- und Adressen-Bereiche auch Merkmaldialoge
eingeblendet werden. Diese erlauben die Auswahl der Daten über
Merkmalskombinationen. Die Bedingungen werden als Variablen zur Verfügung
gestellt, die ebenfalls in den SQL-Commandtext eingefügt werden können.
Datenformat
Das CSV-Format selbst kann über Feldtrenner „ColDelimiter“ und Zeilentrenner
„RowDelimiter“ eingestellt werden. Zusätzlich kann eine Zeichenfolge
definiert werden, um Felder mit SQL-Null darzustellen. Bei Texten lassen
sich die Zeichen über „Charset“ in ANSI, OEM und in einer 7-Bit-Darstellung
ausgeben.
Bildausgabe
Da im CSV-Format keine Bilder abgelegt werden können, gibt es über die
Einstellungen der Picture-Felder die Möglichkeit, neben den Daten auch darin
enthaltene Bilder zu exportieren. Das Speicherformat wird über die PictureExtension festgelegt. Hier werden dieselben Formate unterstützt, wie
beim Speichern von Bildern im Bild-Designer. Über den Wert
PictureBinaryField wird der Datenbankfeldname angegeben, der das Bild
enthält. Der Speichername wird über den Wert PictureFilenameField angegeben.
Bei Artikeln würde man hier „ArtNummer“ angeben.
Export-Datei
Die Exportdatei wird über „Filename“ angegeben. Über den „Filemode“ kann
eingestellt werden, ob die Zieldatei ggf. überschrieben werden darf, ob die
Daten angehängt werden sollen usw.
FTP-Übertragung
Werden die Werte für den FTP-Server gesetzt, so sie werden im Anschluss an den
Datenexport automatisch auf einen FTP-Server übertragen. Neben
anonymen FTP-Servern lassen sich auch Provider-Server mit Benutzername und
Passwort ansteuern. Über RemoteDir kann ein Ziel-Ordner auf dem FTP-Server
angegeben werden; dies kann auch ein unsichtbarer Ordner (HiddenFolder) sein. Proxy
werden zur Zeit nicht unterstützt, ebenso muss der PC bereits Online sein.
| Charset= {integer} |
Der Standardwert für Charset ist 0 Beispiel: |
||||||||||
| ColDelimiter= {Zeichenfolge} |
Enthält das Feldtrennzeichen. Ein Feldtrennzeichen
kann aus mehreren Zeichen bestehen. Der Standardwert
ist TAB (Binär 9). Beispiel: |
||||||||||
| CommandText= {Zeichenfolge} |
CommandText enthält den SQL-Befehl, der eine beliebige Feldmenge selektieren kann. Der SQL-Befehl kann als Variablen-Parameter $$ID$$ enthalten. Die Variable $$ID$$ wird während der Laufzeit durch die echte ID des angezeigten Datensatzes ausgetauscht. Alle Felder werden im Delimiter-Format (CSV) in eine ASCII-Datei geschrieben. Über diesen Menübefehl lassen sich beispielsweise Postversand-Daten zum angezeigten Lieferschein in eine Übergabedatei für die Weiterverarbeitung von Paketsystemen wie Easylog® übergeben. Zusätzlich zur Variable $$ID$$ können auch die Variablen $$DLGVALUE1$$ bis $$DLGVALUE6$$ benutzt werden, sofern die Dialogbox mit in die Abfrage eingebaut wird (s.u.). Hinweis Beispiel1: Im ersten Beispiel werden alle Felder zum aktuell am Bildschirm angezeigten Lieferschein ausgegeben. Beispiel2: Im zweiten Beispiel werden die Felder Kopfnummer, Datum und Match aus der Sicht (=View) von Print-Rechnung exportiert, die im entsprechenden Datumsbereich der Variablen liegen. Die Variablen müssen in Großbuchstaben angegeben werden. Ferner müssen die Werte für die Datumsdialogbox gesetzt sein. Hinweis |
||||||||||
| Context= { Integer } |
Gibt an, ob zum Export in eine CSV-Datei
ein Datensatz selektiert, also in der Anzeige sein muss.
|
||||||||||
| DlgBox= {Zeichenfolge} |
Hiermit ist es möglich, vor Ausführung eines
SQL-Befehls eine Dialogbox anzuzeigen. Es werden
verschiedene Dialogboxen angeboten (Datum, String,
Optionen). Die Ergebnisse der Eingabe können als
Variablen in den SQL-Befehl des Select-Befehls
eingefügt werden. Der SQL-Befehl wird in CommandText
übergeben. Unabhängig vom Typ der Dialogbox (Datum, String usw.) sind die Ergebnisse als direkt verwendbare SQL-Variablen nutzbar. Diese lauten $$DLGVALUE1$$ bis $$DLGVALUE5$$. Durch eine Datumsdialogbox lässt sich beispielsweise eine FIBU-Ausgabe für einen bestimmten Zeitraum, z.B. eine bestimmte Woche erzeugen. Hinweis
|
||||||||||
| DlgCaption= {Zeichenfolge} |
Hiermit kann ein Fenstertitel für den Datumsdialog angegeben werden. Beispiel: Die Dialogbox erhält den Fenstertitel „Datumsbereich für Fibuexport“. |
||||||||||
| DlgInfo= {Zeichenfolge} |
Über DlgInfo lässt sich ein Informationstext
im Dialog-Fenster ausgeben, der dem Benutzer eine
bessere Orientierung zu den zu machenden Angaben
geben soll. Beispiel: |
||||||||||
| DlgLabel1= {Zeichenfolge} bis DlgLabel6= |
Je nach Art der in DlgBox verwendeten Dialogbox kann
es ein bis 6 Feldnamen geben. Diese
Feldbezeichnungen werden in der Dialogbox vor das
einzugebende Feld gesetzt. Wird als DlgBox die GetDateDlg benutzt, so kann durch Angabe des DlgLabel2 bestimmt werden, ob die Datumsbox mit zwei Datumsfeldern ausgegeben wird. Beispiel: Erzeugt eine Dialogbox mit den beiden Feldwerten „von“ und „bis“. |
||||||||||
| DlgValue1= {Zeichenfolge} bis DlgValue2= |
Hiermit kann der Vorgabewert der Dialogbox
initialisiert werden.
Die Angabe dieser Felder ist optional. Wird hier nichts angegeben, so werden Boolean-Felder mit FALSE bzw. 0 initialisiert, Textfelder als leeres Feld und Datumsfelder mit dem Tagesdatum. Wird GetOptionsDlg verwendet, so sind die Ergebnisvariablen mit '0' für False und mit '1' für True initialisiert. Sonderfälle für GetDateDlg Beispiel1: In Beispiel 1 wird vorausgesetzt, dass es sich um eine GetDateDlg handelt. Das Feld der Dialogbox wird mit dem 01. Januar 2002 initialisiert. Beispiel2: In Beispiel 2 wird vorausgesetzt, dass es sich um GetOptionsDlg handelt. Der erste Boolean-Wert wird auf True (entspricht '1') gesetzt |
||||||||||
| ExportFieldnames= {Integer} |
Der Standardwert ist 0. Beispiel: |
||||||||||
| Filemode= {Integer} |
Der Standardwert ist 0. Beispiel: |
||||||||||
| FtpServer= {Zeichenfolge} |
Die exportierte CSV-Datei kann anschließend auf
einen FTP-Server upgeloaded werden. Es darf kein
Protokoll und kein Pfad angegeben werden. Werden über „Picture...“ auch Bilder ausgegeben, so werden diese ebenfalls per FTP-Protokoll übertragen. Nach der Übertragung wird eine Protokolldateien mit Statusmeldungen gespeichert, sofern dies mit „FtpWriteLog=1“ angegeben wurde. Wurde „ShowFinish=1“ gesetzt, so wird eine Abschlussmeldung angezeigt, die neben der Anzahl übertragener Dateien auch den Dateinamen des Journals mit Pfadangaben anzeigt. Beispiel: |
||||||||||
| FtpRemoteDir= {Zeichenfolge} |
Wenn die Daten nicht in das Rootverzeichnis des
FTP-Servers kopiert werden sollen, so kann hier der
Pfad angegeben werden. Pfadangaben beginnen immer
mit einem Slash („/“). Beispiel: |
||||||||||
| FtpUsername= {Zeichenfolge} |
Wenn der FTP-Server zur Autorisierung einen
Benutzernamen benötigt, so tragen Sie diesen hier
ein. Beispiel: |
||||||||||
| FtpPassword= {Zeichenfolge} |
Wenn der FTP-Server zur Autorisierung ein Passwort
benötigt, so tragen Sie dieses hier ein. Beispiel: |
||||||||||
| FtpWriteLog= {Integer} |
Hierüber kann bestimmt werden, ob ein Logjournal mit
dem Dateinamen FtpLog.txt im Ordner des
Hauptprogramms nach einer FTP-Übertragung
gespeichert werden soll.
Beispiel: Der Standardwert ist 0, es wird kein Log geschrieben. |
||||||||||
| Filename= {Zeichenfolge} |
Enthält den Dateinamen einer CSV-Datei, die erzeugt
werden soll. Beispiel: |
||||||||||
| NullValue= {Zeichenfolge} |
Enthält eine Zeichenkette, die als Feldinhalt
ausgegeben werden soll, wenn das Datenbankfeld den
SQL-Wert NULL enthält. Standardmäßig werden diese
Felder als Leerfeld ausgegeben. Beispiel: |
||||||||||
| PictureBinaryField= {Zeichenfolge} |
Kombinierter Bilder-Export über die CSV-Dateiausgabe. Die Registryeinträge mit „Picture...“ bestimmen, ob bei einer CSV-Ausgabe auch Bilder exportiert werden. Es werden alle Dateiformate unterstützt, die auch im Bild-Desiger gespeichert werden können. Werden alle Registryeinträge mit „Picture“ initialisiert, so werden zur CSV-Datei in denselben Ordner die entsprechenden Bilddateien mitgespeichert. Für den Export von Bilden enthält diese Variable den Tabellen-Feldnamen des Bildfeldes. In der Regel wird dies der Name „Bild“ sein. Das Vorschaubild heißt in der Regel „BildPreview“. |
||||||||||
| PictureFilenameField= {Zeichenfolge} |
Für den Export von Bildern enthält diese Variable den Wert für den Dateinamen des zu exportierenden Bildes. Bei Artikeln wird dies in der Regel „ArtNummer“ und bei Adressen „Match“ sein. | ||||||||||
| PictureDropFile nameField= {Integer} |
Bestimmt, ob beim Export der CSV-Datei und der
Bilder, das Feld, das für die Dateinamen der Bilder
benutzt wird, in die CSV-Datei exportiert werden
soll oder nicht. In der Regel wird man das Feld
exportieren.
Der Standardwert ist 0 und somit wird dieses Feld auch exportiert. |
||||||||||
| PictureExtension= {Zeichenfolge} |
Bestimmt, welcher Bilddateityp erzeugt werden soll. Die Extension wird mit führendem Punkt angegeben, also zum Beispiel „.JPG“. Anhand der Extension wird das zu speichernde Bild entsprechend kodiert. | ||||||||||
| Postfix= {Zeichenfolge} |
Enthält eine beliebige Zeichenfolge, die am Ende der CSV-Datei ausgegeben werden soll. Hier könnten zum Beispiel Informationen stehen, um die CSV-Daten als Webseite darzustellen. | ||||||||||
| Prefix= {Zeichenfolge} |
Enthält eine beliebige Zeichenfolge, die am Anfang der CSV-Datei ausgegeben werden soll. Hier könnten zum Beispiel Informationen stehen, um die CSV-Daten als Webseite darzustellen. | ||||||||||
| Retrys= {Integer} |
Enthält die Anzahl Wiederholversuche, eine CSV-Datei
zu erstellen. Zwischen jedem Versuch, die Exportdatei
zu erzeugen, wird eine Pause von einer Sekunde
eingehalten. Der Standardwert für die Anzahl der
Versuche beträgt 3. Beispiel: |
||||||||||
| RowDelimiter= {Zeichenfolge} |
Enthält das Feldtrennzeichen. Ein Feldtrennzeichen
kann aus mehreren Zeichen bestehen. Der Standardwert
ist CRLF (Binär 13,10). Beispiel: |
||||||||||
| ShowFinish= {Integer} |
Zeigt nach Abschluss des Exports eine Meldung mit
der Anzahl der exportierten Datensätze an.
Der Standardwert ist 0. |
||||||||||
| StartMessage= { Zeichenfolge } |
Diese Meldung wird als Frage ausgegeben und vor dem Export angezeigt. Der Benutzer hat die Möglichkeit, den Export zu bestätigen oder die Aktion abzubrechen. Beispiel: Standardmäßig wird keine Frage vor dem Export angezeigt. |
||||||||||
| Title= { Zeichenfolge } |
Ist der Name des Menüeintrags. Der Kurzeintrag wird durch Voranstellen eines kaufmännischen UND-Zeichens markiert. Soll ein Menüname „Müller & Co“ benutzt werden, so müssen zwei kaufmännische UND-Zeichen eingetragen werden. Beispiel: Der Menüeintrag „Easylog“ wird nun in das Extramenü von beispielsweise „Rechnungen“ eingefügt. |
Folgende Eigenschaften werden für den Type StoredProc unterstützt:
Die meisten Parameter dieses Action-Typs werden über den Registrywert „Data“. Hierbei handelt es sich um eine INI-Datei. Folgende Einträge werden unterstützt
| ProcName= {Zeichenfolge} |
Der Name der aufzurufenden SQL-Prozedur Beispiel: |
| InParams= {Zeichenfolge} |
Eine Semikolongetrennte Liste aller
Eingabeparameter. Als Parameterwerte sind einfache
SQL-Konstanten und Feldnamen des aktuellen
Datensatzes erlaubt. Den Feldnamen muss dabei ein
Fragezeichen vorangestellt werden. Es kann auf alle Felder des aktuellen Datensatzes zugegriffen werden. Daneben sind noch folgende drei Variablen zulässig:
Beispiel: |
| Hint= {Zeichenfolge} |
Ein kurzer Hilfetext, der beschreibt, was die
Prozedur macht. Dieser Text wird momentan noch
nicht ausgewertet Beispiel: |
|
PreWarning= {Zeichenfolge} |
Eine hier angegebene Warnungstext wird vor der
Ausführung der Prozedur angezeigt. Der Anwender
erhält hierdurch die Möglichkeit den Vorgang noch
abzubrechen. Über Platzhalter der Form %feldname%
kann dabei auf Felder des aktuellen Datensatzes
zurückgegriffen werden. Beispiel: |
| OkayMsg= {Zeichenfolge} |
Meldung, die bei Erfolgreicher Ausführung angezeigt
wird. Hierbei können auch Platzhalter für
Prozedurausgabeparameter verwendet werden. Beispiel: |
| ErrorMsg= {Zeichenfolge} |
Meldung, die bei einem Fehler angezeigt wird. In der
nachfolgenden Zeile wird außerdem noch ein
relevanter SQL-Fehlertext angezeigt. Die Prozedur
könnte beispielsweise einen Fehler wie folgt
auslösen:RAISERROR('Der Auftrag wurde bereits gebucht',16,1)
Beispiel: |
|
ReturnValueError= {Zeichenfolge} |
Standardmäßig wird ein Prozedurrückgabewert ungleich
Null als Fehler angesehen. Falls die aufzurufende
Prozedur ein anderes Fehlerschema implementiert kann
man dies hier hinterlegen. NOERROR heißt, dass der
Rückgabewert nicht geprüft wird. NEGATIVEERROR
bedeutet, dass nur negative Werte als Fehler
interpretiert werden. Beispiel: |
| SqlErrors= {Zeichenfolge} |
wird nicht mehr verwendet |
|
ReturnValues= {Zeichenfolge} |
Für einen speziellen Rückgabewert kann hier ein
gesonderter Fehlertext hinterlegt werden. Wenn
mehrere Rückgabewerte überprüft werden sollen, so
können Sie beispielsweise die Prozedur in eine
weitere Prozedur gekapselt und dort mit RAISERROR
arbeiten. Beispiel: |
|
RefreshCurrent= {Boolean} |
Hierdurch wird der aktuelle Datensatz nach Ausführen
der Prozedur aktualisiert.
Beispiel: |
|
RefreshLookup= {Zeichenfolge} |
EULANDA© puffert sogenannte Lookup-Datenmengen im
Arbeitsspeicher. Diese werden zum Anzeigen in
Auswahlfeldern benötigt; beispielsweise die
Rabattgruppen im Artikelstamm. Falls die
Prozedur eine Tabelle modifiziert, die von einer
Lookup-Datenmenge benötigt wird, so kann über
diesen Parameter ein Aktualisieren des Puffers
erzwingen. Beispiel: |
|
SelectObject={Zeichenfolge} SelectId= {Integer} |
Nach erfolgreicher Ausführung der Prozedur wird auf
den angegebenen Datensatz verzweigt. Es müssen stets
beide Werte angegeben werden. Diese Technik wird
beispielsweise beim Umwandeln eines Auftrags in
Lieferschein wie folgt angewandt: Beispiel: |