Kurzbeschreibung Toolbox - SelectLine Software GmbH · Seite 6 von 29 Kurzbeschreibung Toolbox Wenn...

Kurzbeschreibung Toolbox

Seite 1 von 29


Inhaltsverzeichnis

Kurzbeschreibung Toolbox ........................................................................................................................ 0

1 Toolbox Grundlagen ................................................................................................................... 3

1.1 Toolbox-Modus .......................................................................................................................... 3

2 Maskenanpassungen mit dem Toolboxeditor ........................................................................... 4

3 Pflichtfelder ................................................................................................................................ 5

3.1 Einrichtung ................................................................................................................................. 5

4 Benutzerdefinierte Tabellen ...................................................................................................... 6

4.1 Erstellung und Verwendung ...................................................................................................... 6

4.2 Tabellenfelder anlegen / einfügen ............................................................................................. 8

5 Auslösen von Aktionen durch Bedienelemente ....................................................................... 8

5.1 Eigene Schaltflächen.................................................................................................................. 9

5.2 Eingabefelder ............................................................................................................................. 9

5.3 Optionsfelder ............................................................................................................................. 10

5.4 Weitere Konfigurationsmöglichkeiten ....................................................................................... 11

6 Datenquellen .............................................................................................................................. 11

6.1 Bidirektionale Datenquellen ...................................................................................................... 12

6.2 Konfiguration der TBX-Parameter ............................................................................................. 13

6.3 Automatische Zuordnung von Toolboxparametern .................................................................. 13

6.4 Makroanbindung am Beispiel .................................................................................................... 14

6.4.1 Termin an Outlook übertragen .................................................................................................. 14

6.4.2 Zeitgesteuerter Aufruf von Toolboxmakros .............................................................................. 14

6.5 Verknüpfung zu beliebigen Dialogen......................................................................................... 15

7 Toolbox-Makros ......................................................................................................................... 16

7.1 Externe Programmausführung .................................................................................................. 16

7.2 Toolbox-Makroparameter .......................................................................................................... 16

7.3 DLL-Aufruf .................................................................................................................................. 16

7.4 COM-Aufruf ................................................................................................................................ 17

7.5 Interne Programmfunktion ........................................................................................................ 17

8 Toolbox Gold Funktionen ........................................................................................................... 24

8.1 Berechnete Spalten ................................................................................................................... 24

8.1.1 Erstellen von berechneten Spalten ........................................................................................... 24

8.2 Berechnete Felder ..................................................................................................................... 26

8.3 Ändern von Spaltennamen ........................................................................................................ 26

Seite 2 von 29


8.4 Permanente Datenfilterung ....................................................................................................... 27

8.5 Speicherorte ............................................................................................................................... 27

9 Globale Toolboxevents .............................................................................................................. 27

10 Toolbox Auswertung .................................................................................................................. 27

11 Toolbox Import / Export ............................................................................................................. 28

11.1 Import ......................................................................................................................................... 28

11.2 Export ......................................................................................................................................... 29

Seite 3 von 29


1 Toolbox Grundlagen

Die Toolbox bietet die Möglichkeit, die SelectLine Anwendung an spezielle Kundenanforderungen

anzupassen. Die Anpassungen umfassen Änderungen an der Benutzeroberfläche ebenso wie

Erweiterungen der Programmlogik. Die Toolboxfunktionalität steht nicht in allen Dialogen/Masken zur

Verfügung. Grundsätzlich erreicht man den Toolboxeditor über den Schalter "Einstellungen und

Zusatzfunktion“ [F12] als Untereintrag "Toolboxeditor“.

Hinweis:

Die Toolbox steht erst ab Programmversion PLATIN zur Verfügung.

1.1 Toolbox-Modus

Die Toolboxeinstellungen werden benutzer“Kürzel“bezogen abgelegt. Der Toolbox-Modus bestimmt den

Nutzungsumfang der Toolbox für jeden Benutzer separat und wird in der Passwortverwaltung

zugewiesen. Zur Auswahl stehen drei Modi:

Deaktiviert Default-Wert, die Toolboxfunktionalität ist für diesen Nutzer gesperrt.

Laufzeitmodus Der Nutzer darf zugewiesene Toolboxfunktionalitäten ausführen.

Der Toolboxeditor steht nicht zur Verfügung.

Editmodus Der Nutzer darf zugewiesene Toolboxfunktionalitäten ausführen und selbst

Funktionalität erstellen. Der Toolboxeditor kann verwendet werden.

Mit der „Runtime“-Lizenz können die Modi Laufzeitmodus oder Deaktiviert einem Benutzer zugewiesen

werden. Alle drei Modi können mit der „Edit“-Lizenz verwendet werden.

Nahezu alle Änderungen in der Passwortverwaltung, also auch die Einstellung des Toolbox-Modus,

erfordern einen Neustart des Programms.

Seite 4 von 29


2 Maskenanpassungen mit dem Toolboxeditor

Folgende Elemente einer Eingabemaske können mit dem Editor angepasst werden:

Eingabefelder

Bezeichnungen

Optionsfelder

Panels (Anzeige für Eingabefelder/Flächen, auf denen weitere Elemente angeordnet sind)

Schalter

Die jeweilige Maske wechselt daraufhin in den Bearbeitungsmodus. Jedes Element kann einzeln

selektiert und anschließend mit der Maus oder der Tastatur verschoben oder in der Größe geändert

werden.

Folgende Einstellungen oder Aktionen sind über ein Kontextmenü zu ändern oder auszuführen:

Änderung der Sichtbarkeit

Aktivieren und Deaktivieren von Elementen

Überspringen von Eingabeelementen

Ändern der Eingabereihenfolge

Änderung von Bezeichnungen und Schaltertexten

Wiederherstellen des Originalzustandes

Zusätzlich können in eventuell vorhandenen Baumstrukturen einzelne Zweige unsichtbar gemacht

oder die Bezeichnungen geändert werden.

Handling am Beispiel der Kunden-Maske:

Vorheriges Element

Nächstes Element

Rückgängig

Standard wiederherstellen

Übernehmen & Beenden

Abbrechen

Seite 5 von 29


3 Pflichtfelder

Mit dem Toolbox-Editor besteht in den toolboxfähigen Dialogen die Möglichkeit der Pflichtfelddefinition.

Pflichtfelder müssen bei der Neuanlage eines Datensatzes den eingestellten Kriterien entsprechen, bei

bestehenden Datensätzen erfolgt die Prüfung erst mit der nächsten Modifikation des Datensatzes. Die

Pflichtfeldfunktion steht analog der anderen Toolbox-Funktionalitäten nur den Benutzern mit den

Lizenzen für den Laufzeit- bzw. Editiermodus zur Verfügung.

Hinweis:

Die Markierung von Pflichtfeldern (blaue Ecke oben rechts) wird entfernt, wenn bspw. Text in das

Eingabefeld eingetragen wurde.

3.1 Einrichtung

Über das Kontextmenü der rechten Maustaste erreicht man den Bearbeitungsdialog des gewählten

Feldes ("Bearbeiten“ [Enter]). Mit aktiver Option "Aktiviert" wird das Eingabefeld zum Pflichtfeld.

Außerdem kann eine beliebige Bezeichnung vergeben werden, die dann in entsprechenden Meldungen

im weiteren Programmablauf verwendet wird.

Datentyp und Bereichsprüfung

Unabhängig vom Format des Eingabefeldes können die Form

der Eingabe und die zugelassenen Zeichen geprüft werden.

Seite 6 von 29


Wenn die Eigenschaft "Darf leer sein" gesetzt ist, wird eine Validierung erst ausgeführt, wenn

das zu überprüfende Eingabeelement nicht den Datenbankwert "Null" besitzt. Bei

Texteingabeelementen muss der zu überprüfende Text wenigstens ein Zeichen besitzen.

Die Eigenschaft "Fehlermeldung" ermöglicht die Definition eines eigenen Fehlertextes.

Es können auch Pflichtfelder geändert werden, die bereits vom Programm als solche definiert

sind. Dabei ist zu beachten, dass die Systemeinstellungen nicht außer Kraft gesetzt werden

können. Möglich sind weitere Einschränkungen, ein Überscheiben der Fehlermeldung und der

Bezeichnung.

Hinweis:

Die Bereichsprüfung über Pflichtfelder ist nur für Felder geeignet, die nicht Index des Dialoges sind

(bspw. nicht für Artikelnummer im Artikelstammdatendialog!) Für Indizes gilt weiter die Bereichs-

eingrenzung der Vorgabewerte.

4 Benutzerdefinierte Tabellen

Mit Hilfe der Toolbox-Lizenz können zurzeit maximal 26 benutzerdefinierte Tabellen, sogenannte

Extradialoge, erzeugt und genutzt werden. Die Tabellen haben einen Maskendialog zum Anlegen,

Ändern, Löschen von Datensätzen. Die Tabelleninhalte können im Makroassistenten und im

Formulareditor angesprochen werden. Extrafelder können diese Tabellen ebenso wie SelectLine

Standardtabellen als Auswahlfeld nutzen. Um Extradialoge anlegen zu können, muss in der

Passwortverwaltung der Toolboxmodus für den jeweiligen Benutzer auf "Editiermodus“ eingestellt sein.

Zur Nutzung der Extradialoge ist der Laufzeitmodus ausreichend.

4.1 Erstellung und Verwendung

Die Definition eines neuen Extradialoges sowie die Bearbeitung von bestehenden Extradialogen erfolgt

mit Hilfe des Dialogmanagers. Diesen erreichen Sie über den Menüpunkt Eigene Daten / Extradialoge /

Konfigurationsschalter.

Hinweis:

Sie benötigen Administratorrechte zur Ausführung dieser

Funktion!

Kürzel

Aus einer Liste wählen Sie ein mögliches Tabellenkürzel.

Seite 7 von 29


Tabelle

Zur Auswahl werden Ihnen mit X -beginnende Tabellen aus dem Mandanten angeboten.

Beschreibung

Als Beschreibung wird Ihnen die Tabellenbezeichnung ohne X vorgeschlagen.

Indexfeld

Pflichtfeld! Vergeben Sie hier den Namen für das Indexfeld der Extratabelle.

Bspw. ID oder Nummer.

Indextyp

Nachfolgende Datentypen stehen für den Index zur Verfügung:

Datentyp "Integer" mit der Option für das automatische zählen

Datentyp "String" mit einem Optionsfeld für die Schlüssellänge (maximal 18 Stellen)

weitere Optionen

Erweitern Sie Ihre Tabelle um die angelegt/bearbeitet Felder. Diese werden beim Anlegen/Bearbeiten

der Datensätze Ihrer Tabelle vom Programm gefüllt bzw. geändert. Über die Option "Sichtbar in

Tabellenliste" haben Sie die Möglichkeit Extratabellen mit in der Tabellenliste aufzuführen. Ist diese

Option aktiv können Sie über Mandant / Überblick / Liste auf die Datensätze der Tabelle zugreifen. Diese

Einstellung kann pro Tabelle im Dialog für Extratabellen gesetzt werden.

Icon

Laden oder entfernen Sie über die entsprechenden Schalter eine Bilddatei zur Anzeige als Symbol in der

Menüleiste. Die Größe der verwendeten Bilder beträgt 32*32 Pixel (die der kleinen Schalterbilder 16*16

Pixel). Wird ein größeres/kleineres Bild verwendet wird skaliert, das Seitenverhältnis wird dabei

beibehalten.

Hinweis:

Nach dem Speichern der erfassten Einstellungen wird die Tabelle mit Hilfe einer

Mandantenreorganisation erzeugt. Nach dem Erstellen der Tabelle, im Beispiel XFWAGEN, findet man in

den Extradialogen den neuen Menüpunkt Firmenwagen, über den die angelegte Tabelle angezeigt und

bearbeitet werden kann.

Seite 8 von 29


4.2 Tabellenfelder anlegen / einfügen

Das Anlegen der Tabellenfelder erfolgt wie das Anlegen von Extrafeldern bei Standardtabellen über das

Menü Mandant / Einstellungen / Vorgabewerte / Tabellenname.

In der Vorgabentabelle muss nur die vorher angelegte Extradialogtabelle (diese sind rot markiert)

ausgewählt werden, um dann dort Extrafelder hinzuzufügen. Die Kennzeichnung der

Extradialogtabellenfelder mit einem Unterstrich (_) erfolgt automatisch.

Zum Einfügen der Extrafelder muss der entsprechende Extradialog geöffnet und per Kontextmenü des

Dialogs die Felder eingefügt werden.

5 Auslösen von Aktionen durch Bedienelemente

Unabhängig von der Art des Bedienelements können allgemeine Einstellungen getroffen werden. So

kann der anzuzeigende Text für Schalter, Bezeichnungs- und Optionsfelder entsprechend den

individuellen Anforderungen verändert werden. Diese Möglichkeit steht für Eingabefelder nicht zur

Verfügung. Außerdem können die Werte für die Position und die Ausdehnung der Bedienelemente in der

Maskenansicht eingestellt werden. Je nach Art des Bedienelements, ob Schalter, Eingabefeld,

Optionsfeld oder Datenquelle, variieren die festzulegenden Eigenschaften.

Seite 9 von 29


5.1 Eigene Schaltflächen

Im Edit-Modus der Toolbox-Funktionalität (Toolboxeditor) können in den Dialogen über das Kontextmenü

der rechten Maustaste im freien Bereich vielen Masken Schalter eingefügt werden.

Im Bearbeitungsdialog (siehe Abbildung unten) können diesen Schaltern im

System verfügbare Makros zugeordnet werden. Im Makro verwendete

Parameter können mit Tabelleninhalten verknüpft werden.

5.2 Eingabefelder

Analog zu der Makrofunktionalität der Schalter besteht die Möglichkeit einer solchen Zuordnung zu

Eingabefeldern in Abhängigkeit einer Aktion. Für die Eingabefelder stehen das "Betreten“ und das

"Verlassen“ eines Feldes als Optionen zur Verfügung.

Seite 10 von 29


5.3 Optionsfelder

Für Optionsfelder steht zusätzlich zur "Betreten“/ "Verlassen“-Funktionalität das "Klicken“-Makro zur

Verfügung, d.h. jedes Mal wenn ein Optionsfeld bedient wird, erfolgt der Aufruf des Makros.

Seite 11 von 29


5.4 Weitere Konfigurationsmöglichkeiten

Für alle Bedienelemente steht eine Auswahl der folgenden Konfigurationsmöglichkeiten zur Verfügung:

"Aktiviert“: Nur wenn diese Checkbox markiert ist, wird das Toolboxmakro auch zur Laufzeit

ausgeführt.

"Nicht auf Beendigung des Prozesses warten“: Diese Checkbox ist nur relevant, wenn das

Toolboxmakro ein Programm ausführt. Ist diese Checkbox markiert, wird das Programm

gestartet und unmittelbar mit der aufrufenden Operation fortgefahren, ansonsten wartet das

Hauptprogramm so lange, bis sich das gestartete Programm beendet hat.

"Vor der Ausführung die Hauptdatenquelle speichern“: Wenn diese Checkbox markiert ist, wird

die Hauptdatenquelle und damit alle Unterdatenquellen vor der Makroausführung gespeichert.

Dadurch ist die Möglichkeit gegeben, per SQL-Makro auf die aktuellen Daten zuzugreifen und

direkt zu ändern.

"Nach der Ausführung die Hauptdatenquelle speichern“: Wenn diese Checkbox markiert ist,

wird die Hauptdatenquelle und damit alle Unterdatenquellen nach der Makroausführung

gespeichert. Eine gespeicherte Hauptdatenquelle ist z.B. Voraussetzung für die Ausführung von

„Nach der Ausführung die Ansicht aktualisieren“.

"Nach der Ausführung die Ansicht aktualisieren“: Wenn diese Checkbox markiert ist, werden

nach der Makroausführung die Daten des Fensters aktualisiert. Voraussetzung hierfür ist, dass

sich die Hauptdatenquelle nicht im Editiermodus befindet.

6 Datenquellen

Im Edit-Modus der Toolbox-Funktionalität kann in den Dialogen über das Kontextmenü der rechten

Maustaste über den Eintrag Toolbox-Datenquellen ein Auswahldialog aktiviert werden, der alle

verfügbaren Datenquellen des jeweiligen Dialogs auflistet. Dies bietet die Möglichkeit, bei bestimmten

Tabellenaktionen wie Neuanlegen, Speichern und/oder Löschen eines Datensatzes, ein

Makro/Toolboxmakro aufzurufen.

Die Hauptdatenquelle heißt hierbei immer „Table“ (im Artikeldialog der WaWi entspricht also „Table“ der

Tabelle „Art“). Die Bezeichnung der anderen Datenquellen, welche zumeist Detaildatenquellen von

„Table“ sind, erklärt meist deren Bedeutung (z.B.: quLagBew ... Lagerbewegungen eines Artikels).

Hinweis:

Seite 12 von 29


Die Werte der Belegposition im Editiermodus inklusive Belegnummer und Belegtyp stehen als Pseudo-

Datenquelle „DsBelegPos“ zur Verfügung.

6.1 Bidirektionale Datenquellen

Mit Hilfe bidirektionaler Datenquellen ist es möglich, Werte in die ausführende Datenmenge

zurückzuschreiben. Diese Rückschreibfähigkeit findet immer dann Anwendung, wenn Werte aus einer

Datenquelle gelesen und wieder in diese zugeschrieben werden sollen. Um diese Funktionalität zu

nutzen, ist für Makros der Ausführungsmodus „Toolboxrückgabe“ vorgesehen. Alle vom verwendeten

Makro berührten Datenfelder stehen später als potentielle Parameter zur Verfügung. Zu beachten ist

außerdem, dass nur maximal ein Datensatz verarbeitet werden kann.

Optisch werden Rückschreibparameter, die nicht rückschreibfähig sind, mit einem Stoppschild

hervorgehoben. Beim Beenden des Konfigurationsdialoges wird bei nichtrückschreibbaren Parametern

mit einer Fehlermeldung auf diesen Zustand hingewiesen.

Abweisung des Zurückschreibens

Das zu beschreibende Feld darf nicht kalkuliert und muss modifizierbar sein.

Das Zurückschreiben ist für das Toolbox-Datenquellen-Ereignis "Nach dem Speichern“

deaktiviert.

Für das Zurückschreiben ist nur eine 1 zu 1 Zuordnung möglich (keine Formeln!).

Folgende Datenquellen sind rückschreibfähig:

Artikel

Kunde

Lieferant

Table

Seite 13 von 29


Beleg Table

DsBelegPosition

Leistungserfassung DsLeistungPositionen

Termin anlegen/bearbeiten Termin

6.2 Konfiguration der TBX-Parameter

Für jeden Parameter kann ein Datentyp festgelegt werden.

Jeder Parameter besitzt einen Richtungstyp.

Ein Parameter kann optional sein. Dadurch kann die zu konfigurierende Parameteranzahl

reduziert werden und es besteht die Möglichkeit diese Parameter nachträglich zu konfigurieren.

Jeder optionale Parameter kann einen Standardwert besitzen. Hierbei ist zu beachten, dass die

Standardwerte nicht von der Toolbox-Runtime gesetzt werden.

Über diesen Konfigurationsdialog werden automatisch Datentyp, Richtung, Optionalität, der

Standardwert sowie die Beschreibung festgelegt.

Alle Einstellungen bis auf „Wert“ sind von „Name“ abhängig. Das Eingabefeld „Name“ ist nur beim

Anlegen eines Parameters editierbar.

Sollte im gekoppelten Toolboxmakro der Parametername, der sich im Eingabefeld „Name“ befindet,

nicht existieren, so werden alle Werte bis auf „Name“ und „Wert“ auf ihre Standardeinstellung

zurückgesetzt.

Wenn der Wert im Eingabefeld „Name“ mit einem definierten Parameter übereinstimmt, so werden

automatisch die restlichen Eingabefelder angepasst.

6.3 Automatische Zuordnung von Toolboxparametern

Innerhalb des Parameterdialogs eines Schalters können zwei Funktionen zum automatischen Einfügen

von Parametern genutzt werden.

Seite 14 von 29


Zum einen gibt es die Möglichkeit,

Parameter, die das dem Schalter

hinterlegte Makro zur Ausführung

benötigt, automatisch einzulesen. Dabei

können wahlweise die Pflichtparameter,

die optionalen Parameter oder alle

Parameter hinzugefügt werden.

Die zweite Möglichkeit ist das Einlesen der

Datenfelder der zugrundeliegenden

Datenquelle.

Es können wahlweise nur die lesbaren

und/oder die schreibbaren

Datenquellenfelder hinzugefügt werden.

6.4 Makroanbindung am Beispiel

6.4.1 Termin an Outlook übertragen

Bei der Neuanlage eines Termins wird automatisch und ohne dass der Benutzer selbst eingreifen

müsste, in Outlook ein Termin mit den Daten des SelectLine Termins angelegt. Dazu ruft die

Warenwirtschaft das Makro “Termin2Outlook“ auf und übergibt diesem die Daten des Termins. Das

Makro reicht die Daten weiter an Outlook, so dass der in der Warenwirtschaft erfasste Termin

automatisch auch in Outlook abgelegt wird.

6.4.2 Zeitgesteuerter Aufruf von Toolboxmakros

Mit Hilfe der Terminfunktion und der Toolbox ist es möglich, bestimmte Makros und Funktionen

zeitgesteuert ausführen zu lassen. Folgendes Beispiel zeigt den Termin „Statistikaufbau und

Programmende“, der wöchentlich um 16:30 fällig ist. Diesen Termin kann man mit einer

Toolboxmakrofolge koppeln, welche zum angegebenen Zeitpunkt die Statistik neu aufbaut und danach

die Warenwirtschaft automatisch beendet.

Hinweis: Für die zeitgesteuerte Nutzung des Termins ist der Wecker zu aktivieren!

Seite 15 von 29


6.5 Verknüpfung zu beliebigen Dialogen

Im Extrafeldmodus eines Tabellen-Dialogs können Verknüpfungen zu beliebigen Tabellen erstellt

werden. Dabei können sowohl SelectLine Standard-Tabellen als auch eigene Fremdtabellen verwendet

werden und Informationen daraus im gewünschten Dialog zur Anzeige gebracht werden.

Beispiel

Ein Extrafeld in der Mitarbeitertabelle soll über einen Tabellenverweis auf die Tabelle Firmenwagen den

Namen, das Kennzeichens und den Kilometerstand anzeigen.

1. Extrafeld anlegen, Einrichten als Schalter mit Tabellenverweis auf die Firmenwagen-Tabelle.

2. Für jede gewünschte Zusatzinformation ein Bezeichnungsextrafeld einrichten und so benennen

(im Bsp. Kennzeichen und Kilometerstand)

3. Unter Vorgabewerte Tabelle auswählen mit [F12] in den manuellen Feldeditor wechseln und

im Absatz des Eingabefeldes (object TXDBEdit) am Ende einfügen:

ConnectFields.Strings = (

'LaExtraBezeichnung|_Bezeichnung'

Seite 16 von 29


'LaExtraKilometerstand|_Kilometerstand'

'LaExtraKennzeichen|_Kennzeichen')

(Bezeichnung ist die Feldbezeichnung in der Quelltabelle, LaExtraBezeichnung ist der

zugewiesene Name des Bezeichnungsfeldes)

Für jede anzuzeigende Information muss eine separate Zeile erzeugt werden.

4. Alles speichern und im Stammdatendialog prüfen.

7 Toolbox-Makros

Durch die Toolbox können externe Programmfunktionen mit den SelectLine Produkten verbunden

werden. Alle externen Programmfunktionen können mit Parametern versehen werden.

7.1 Externe Programmausführung

Durch diese Kopplungsart können externe Programme ausgeführt werden. Das externe Programm muss

sich im Ausführungspfad befinden oder mit dem kompletten Programmnamen (inklusive Pfadangaben)

angegeben werden. Dafür können auch Umgebungsvariablen benutzt werden.

Bsp.: %TEMP%\TBX\test.exe

Der Programmaufruf erfolgt in folgender Form:

Programmname “Parametername1“=“Parameterwert1“ “Parametername2“=“Parameterwert2“ “Parametername3“

7.2 Toolbox-Makroparameter

Damit besitzen Sie die Möglichkeit,

programminterne Informationen, wie zum

Beispiel den aktuellen Mandanten oder

das derzeitige Benutzerkürzel als

Makroparameter zu verwenden.

7.3 DLL-Aufruf

Durch diese Kopplungsart können

Seite 17 von 29


Dynamic-Link-Librarys (DLL) ausgeführt werden. Die DLL muss sich im Ausführungspfad befinden oder

mit dem kompletten (absoluten) Pfad angegeben werden.

7.4 COM-Aufruf

Durch diese Kopplungsart können COM-Objekte ausgeführt werden. Weiterführende Informationen

hierzu sind auf der SelectLine Auslieferungs-DVD verfügbar.

7.5 Interne Programmfunktion

Durch die Kopplung zum Schnittstellentyp "Programmfunktion“ wird die gewählte interne

Programmfunktion ausgeführt. Derzeit sind die nachfolgend aufgeführten Funktionen implementiert:

Artikel inaktiv setzen

Mit dieser programminternen Toolboxfunktion kann ein Artikel inaktiv gesetzt werden. Folgende

Parameter können verwendet werden:

1. Parameter: [artikelNummer] = Geben Sie den Schlüssel ein (Artikelnummer)

2. Parameter: [stuecklisten] = optionaler Parameter, um den Artikel aus Stücklisten zu

entfernen (Standard = true)

3. Parameter: [alternativen] = optionaler Parameter, um den Artikel als Alternativartikel zu

entfernen (Standard = true)

4. Parameter: [zubehoer] = optionaler Parameter, um den Artikel als Zubehör zu entfernen

(Standard = true)

5. Parameter: [zuschlag] = optionaler Parameter, um den Artikel als Zuschlag zu entfernen

(Standard = true)

6. Parameter: [referenzen] = optionaler Parameter, um die Referenzen des Artikels zu löschen

(Standard = true)

Seite 18 von 29


7. Parameter: [immer] = optionaler Parameter, der Artikel wird inaktiv gesetzt, obwohl es

Warnungen und Hinweise gibt (Standard = true)

8. Parameter: [fehlerAnzeige] = optionaler Parameter, um bei Fehlern Fehlerprotokoll zu

öffnen (Standard = true)

Hinweis: Diese Toolboxfunktion setzt bei Variantenartikel die Varianten NICHT automatisch mit inaktiv!

Belegpreisaktualisierung

Mit dieser internen Toolboxfunktion erfolgt eine Neuberechnung des Belegpreises aus vorhandenen

Positionen. Wird der Parameter [ausEinzelpreis] auf true gesetzt, berechnet die Toolboxfunktion auch die

Gesamtpreise der Belegpositionen neu, ausgehend vom Einzelpreis und den beiden Rabatten. Folgende

Parameter werden erwartet:

1. Parameter: [belegTyp] = Geben Sie den Belegtyp ein (z.B. F).

2. Parameter: [belegNummerVon] = alphabetisch kleinste Belegnummer

3. Parameter: [belegNummerBis] = alphabetisch größte Belegnummer

4. Parameter: [gedruckt] = optionaler Parameter, um gedruckte Belege auch zu aktualisieren

(Standard = false)

5. Parameter: [ausEinzelpreis] = optionaler Parameter, Gesamtpreise der Belegpositionen neu

aus Einzelpreisen und Rabatten berechnen (Standard = false)

6. Parameter: [filterFeldName] = optionaler Parameter, wird dieser Parameter mit dem

Feldnamen eines logischen Feldes gefüllt, werden nur Belege aktualisiert, bei denen dieses

Feld gesetzt ist



Bild anzeigen

Mit dieser internen Toolboxfunktion kann die Maske „Bilder“ zu einem Datensatz aufgerufen werden.

Folgende Parameter werden erwartet:

1. Parameter: [BK] = Geben Sie den BlobKey (z.B. AR) ein.

2. Parameter: [ID] = Geben Sie den Schlüssel ein (z.B. Artikelnummer)

Bild hinzufügen

Mit dieser internen Toolboxfunktion kann ein Bild der Bildtabelle hinzugefügt werden. Folgende

Parameter werden erwartet:


2. Parameter: [ID] = Geben Sie den Schlüssel ein (z.B. Artikelnummer)

3. Parameter: [Filename] = Dateiname des hinzuzufügenden Bildes

Seite 19 von 29


Bildertest

Diese Funktion testet die Datenintegrität der Bilder in der Bildtabelle. Folgende Parameter können

modifiziert werden:

1. Parameter: [BK] = der zu filternde Blobkey (z.B. AR%). Dabei entspricht „%“ der Syntax vom

SQL-Like-Operator.

2. Parameter: [AutoStart] = automatischer Start der Überprüfung (0/1).

3. Parameter: [AutoClose] = automatisches Ende der Überprüfung (0/1)

Demonstration interner Programmfunktionen (TBX)

Diese Funktion dient ausschließlich der Veranschaulichung der internen Programmfunktionen in

Schnittstellen-Makros.

Eingabemaske aufrufen

Diese interne Programmfunktion ruft eine gewünschte Eingabemaske in der Detailansicht auf. Diese

Funktion basiert auf zwei Parametern.


2. Parameter: [Key] = Geben Sie den Schlüssel ein (z.B. Artikelnummer)

Der erste Parameter „BK“ ist zwingend notwendig, da er die Information des Blobkeys des

aufzurufenden Dialoges beinhaltet. Der zweite Parameter bestimmt den Datensatz, der zur Anzeige

kommt.

Dementsprechend muss diesem Parameter der Primärindex des gewünschten Datensatzes zugeordnet

werden. Bleibt der zweite Parameter ungenutzt, wird ein neuer Datensatz mit dem nächsten freien

Schlüsselwert angelegt.

Eingabemaske nach vorn holen

Mit der Programmfunktion können Sie eine Eingabemaske über den Blobkey suchen und nach vorn

holen.


Eingabemaske nicht modal aufrufen

Mit der Programmfunktion erreichen Sie einen nicht modalen Aufruf einer Eingabemaske über Blobkey

und Schlüsselwert.


2. Parameter: [Key] = Geben Sie den Schlüssel ein (z.B. Artikelnummer)

3. Parameter: [MultiOpen] = Ob das Formular mehrfach geöffnet werden kann (0/1).

Seite 20 von 29


Eingabemaske schließen

Mit der Programmfunktion können Sie einen Stammdatendialog über den Blobkey suchen und

schließen.


EK- und VK-Aktualisierung aus Einkaufskonditionen

Mit der Toolboxfunktion „EK- und VK-Aktualisierung aus Einkaufskonditionen“ werden für alle

Einkaufskonditionen eines Lieferanten die Preiskalkulation der Artikel bzw. die Korrektur des mittleren

EKs durchgeführt:

1. Parameter: [lieferantenNummer] = Geben Sie eine Lieferantennummer ein.


öffnen (Standard = true).

EK-Ermittlungslauf

Dieser Typ entspricht der Programmfunktion in den Artikelstammdaten im Bereich „Einkauf“. Es sind 5

Parameter für die EK-Ermittlung verfügbar:

Der erste ist der Belegtyp. Man kann hier einen Eingangsbeleg mit der Lageraktion „Zugang“ wählen, z.B.

„S“ (Wareneingang) oder „E“ (Eingangsrechnung). Der zweite ist vom Typ Datum, es können dafür feste

Datumswerte und Formeln z.B. date - 30 hinterlegt werden. Die letzten drei sind logisch, und legen fest,

ob manuelle Lagerungen, Inventuren und Einlagerungen aus Werkaufträgen berücksichtigt werden

sollen.

1. Parameter: [Belegtyp] = [E]

2. Parameter: [Datum] = [15.06.2012]

3. Parameter: [MitManuell] = [true]

4. Parameter: [MitInventur] = [false]

5. Parameter: [MitWerkauf] = [false]

Es ist wichtig, dass die Reihenfolge der Parameter eingehalten wird.

Ermittlungslauf Produktionsstücklisten-Kalkulationspreise

Diese Funktionalität ermittelt den Kalkulationspreis aller Produktionsstücklisten der Artikelstammdaten,

bei denen die Bestimmung des Kalkulationspreises auf „Ermittlungslauf“ eingestellt ist, neu. Sie

entspricht der gleichnamigen Funktion im Artikelstammdaten-Dialog.

Mandantendatensicherung

Mit dieser Funktion können die Mandantendaten, auch nicht aktiver Mandanten, gesichert werden.

Verwendet wird die Programmfunktion Applikationsmenü / Wartung / Datensicherung /

Mandantendaten sichern.

Seite 21 von 29


Der Dateiname wird vorgegeben (Mandantennummer + "_ " + aktuelle Datum (JJJJMMTT) + "_ " +

aktuelle Uhrzeit (HH24MMSS)), bereits existierende Dateien werden ohne Nachfrage überschrieben.

1. Parameter: [Mandantennummer] = Legen Sie hier den zu sichernden Mandanten fest (z.B.

WAWI).

2. Parameter: [Ablagepfad] = Geben Sie hier das Zielverzeichnis für die Datensicherung ein.

3. Parameter: [InklusiveLoggingdatenbank] = optionaler Parameter, ist auf "true" zu setzen,

wenn die Loggingdatenbank mit gesichert werden soll. Der Standardwert ist "false".

Neuaufbau Statistik

Dahinter verbirgt sich die Programmfunktion „Applikationsmenü / Reorganisation / Statistik / Neu

aufbauen“. Das Verhalten der Toolboxfunktion „Neuaufbau Statistik“ kann über drei Parameter gesteuert

werden.

1. Parameter: [MitFrage] = ist auf "true" zu setzen, wenn vor der Ausführung eine Abfrage

erfolgen soll.

2. Parameter: [MitMeldung] = ist auf "true" zu setzen, wenn nach der Ausführung eine

Meldung erfolgen soll.

3. Parameter: [Komplett] = ist auf "true" zu setzen, wenn die Statistik neu aufgebaut werden

soll, bei "false" erfolgt ein Aktualisieren der Statistik.

Fehlen die Parameter erfolgt ein Neuaufbau der Statistik mit vorheriger Abfrage und Meldung nach der

Ausführung.

Office-Dokument erzeugen

Entspricht der Funktion aus dem Zusatzmenü „Neues Dokument“. Folgende Parameter werden

erwartet:

1. Parameter: [Filename]= Name der Vorlagedatei

2. Parameter: [Beschreibung]=Notiz-Text

3. Parameter: [NotizAnlegen] = als Notiz speichern

4. Parameter: [DokumentAnzeigen]= Dokument öffnen und anzeigen

Preisneuberechnung

Die interne Programmfunktion „Preisneuberechnung“ leistet dasselbe, wie die Belegfunktion „Preise neu

bestimmen / von Beleg - bis Beleg“.

Die interne Programmfunktion „Belegpreisaktualisierung“ berechnet die Belegpreise aus den

vorhandenen Positionen (d.h. ohne Aktualisierung der Positionspreise aus den Stammdaten) neu.


Seite 22 von 29


2. Parameter: [belegNummerVon] = alphabetisch kleinste Belegnummer

3. Parameter: [belegNummerBis] = alphabetisch größte Belegnummer

4. Parameter: [hauptArtikel] = optionaler Parameter, Handelsstücklisten erhalten den Preis des

Hauptartikels (Standard = true)

5. Parameter: [steuer] = optionaler Parameter, um den Steuerschlüssel zu aktualisieren

(Standard = true)

6. Parameter: [fibuKonto] = optionaler Parameter, um das Fibukonto zu aktualisieren (Standard

= true)

7. Parameter: [gedruckt] = optionaler Parameter, um gedruckte Beleg auch zu aktualisieren

(Standard = false)



Programm beenden

Hiermit wird die Applikation definitiv ohne Nachfrage geschlossen.

Programmdatensicherung

Mit dieser Funktion können die Programmdaten, analog der Programmfunktion Applikationsmenü /

Wartung / Datensicherung / Programmdaten sichern, gesichert werden.

Der Dateiname wird vorgegeben ("Prog_" + aktuelle Datum (JJJJMMTT) + "_ " + aktuelle Uhrzeit

(HH24MMSS)), bereits existierende Dateien werden ohne Nachfrage überschrieben.

1. Parameter: [Ablagepfad] = Geben Sie hier das Zielverzeichnis für die Datensicherung ein.

2. Parameter: [InklusiveLoggingdatenbank] = optionaler Parameter, ist auf "true" zu setzen,

wenn die Loggingdatenbank mit gesichert werden soll. Der Standardwert ist "false".

Sammelpreis und -Rabatt prüfen

Diese programminterne Toolboxfunktion hat die gleiche Funktion wie der gleichnamige Menüpunkt aus

dem Funktionsmenü der Belege.


2. Parameter: [belegNummer] = Geben Sie die Belegnummer ein.

3. Parameter: [feldName] = Name eines Feldes aus der Artikeltabelle.

4. Parameter: [erfolgsMeldung] = optionaler Parameter, ob nach Ausführung der Funktion eine

Meldung erfolgen soll.

Der Parameter für den Feldnamen bestimmt, wann Positionen zur Preisbestimmung mengenmäßig

zusammengefasst werden dürfen. Bleibt dieser Parameter leer, erfolgt die Zusammenfassung nach

Preisverweisen.

Seite 23 von 29


Achtung: Die Toolboxfunktion aktualisiert nach Abschluss nicht die Belegsummen!

String-Parameter-Umleitung

Diese Programmfunktion ist eine Hilfsfunktion um Ausgabe = Eingabe zu setzen (Loopback).

1. Parameter: [AusgabeParameter] = Ausgabestring

2. Parameter: [EingabeParameter] = Eingabestring

Als Parameter stehen 19 weitere Ausgabe- und Eingabeparameter zur Verfügung.

Währung umrechnen

Die interne Programmfunktion beinhaltet eine Währungsumrechnungsfunktion

1. Parameter: [Betrag] = Geben Sie den umzurechnenden Betrag an.

2. Parameter: [VonWaehrung] = Geben Sie die Quellwährung an

3. Parameter: [InWaehrung] = Geben Sie die Ziel-Währung an.

4. Parameter: [NeuerBetrag] = gibt den neuen Betrag aus.

5. Parameter: [TagesKurs] = optionaler Parameter, ob der Tageskurs berücksichtigt werden soll

(Standard = true)

6. Parameter: [Datum] = optionaler Parameter, um das Umrechnungsdatum anzugeben

(Standard = aktuelles Tagesdatum)

7. Parameter: [Runden] = optionaler Parameter, ob gerundet werden soll (Standard = false)

String-Parameter-Umleitung

Diese Programmfunktion ist eine Hilfsfunktion um Ausgabe = Eingabe zu setzen (Loopback).

1. Parameter: [AusgabeParameter] = Ausgabestring

2. Parameter: [EingabeParameter] = Eingabestring

Als Parameter stehen 19 weitere Ausgabe- und Eingabeparameter zur Verfügung.

Währung umrechnen

Die interne Programmfunktion beinhaltet eine Währungsumrechnungsfunktion

1. Parameter: [Betrag] = Geben Sie den umzurechnenden Betrag an.

2. Parameter: [VonWaehrung] = Geben Sie die Quellwährung an

3. Parameter: [InWaehrung] = Geben Sie die Ziel-Währung an.

4. Parameter: [NeuerBetrag] = gibt den neuen Betrag aus.

Seite 24 von 29


5. Parameter: [TagesKurs] = optionaler Parameter, ob der Tageskurs berücksichtigt werden

soll (Standard = true)

6. Parameter: [Datum] = optionaler Parameter, um das Umrechnungsdatum anzugeben

(Standard = aktuelles Tagesdatum)

7. Parameter: [Runden] = optionaler Parameter, ob gerundet werden soll (Standard = false)

8 Toolbox Gold Funktionen

8.1 Berechnete Spalten Mit dem Erschaffen berechneter Spalten steht eine Möglichkeit zur Verfügung, die wichtigsten Tabellen

des Programms, mit weiterführenden Informationen zu ergänzen. Alle uns bisher bekannten

Anforderungen zur Darstellung von Zusatzinformationen lassen sich somit abbilden.

Generell stehen die berechneten Spalten für:

Alle Such-, Filter- und Sortierfunktionen der SelectLine Warenwirtschaft

Den Office Export

Die Druckvorlagenanpassungen per Formulareditor

Und Toolbox-Makro-Parameter der entsprechenden Datenquellen

zur Verfügung.

8.1.1 Erstellen von berechneten Spalten

Im Dialog der Vorgabewerte können berechneten Spalten, sofern die ausgewählte

Tabelle diese Funktion unterstützt, angelegt werden.

Wird die Funktionalität, an der jeweils gewählten Tabelle, nicht unterstützt, ist der

Baumeintrag „Berechnete Spalten“ ausgegraut

Seite 25 von 29


Alle berechneten Spalten werden pro Nutzer (Passwortanmeldung) definiert. Dadurch ist sichergestellt,

dass die Feldinhalte nur „zuständigen“ Benutzern zur Verfügung stehen und andere Benutzer nicht

durch evtl. auftretende Performanceeinbußen beeinflusst werden. Eine Ableitung für weitere Nutzer ist

natürlich möglich.

Über das Deaktivieren der Option „Aktiv“ kann die Anzeige und Berechnung abgeschaltet werden, ohne

die bereits eingegebenen Statements zu verlieren (bspw. für Tests).

Berechnete Spalten (SQL Syntax)

Hierrüber können Berechnungen mit allen in der Quelltabelle verfügbaren Feldern durchgeführt und

deren Ergebnismenge verfügbar gemacht werden.

Bsp.. die Darstellung der „E-Rechnung E-Mailadresse“ über eine Funktion unter Verwendung der Kundennummer als Parameter.

Verknüpfte Tabellen (SQL Syntax)

Werden Daten aus einer weiteren Tabelle benötigt, kann optional die Haupttabelle mit Weiteren

verknüpft werden. Eine Ergebnismenge größer eins, für die verknüpften Tabellen, muss hierbei

vermieden werden.

Anschließend können die Spalten der verbundenen Tabelle, wiederum für die berechneten Spalten

verwendet werden.

Bsp. ein „JOIN“ auf die Tabelle „STATISUM“, welche die Monatsumsätze zu einem Kunden enthält.

Seite 26 von 29


8.2 Berechnete Felder Die berechneten Felder ermöglichen, eine erweiterte Verfügbarkeit von Informationen in der

Maskendarstellung.

Über die berechneten Felder lassen

sich nicht nur die berechneten

Spalten einer Tabelle auf einer

Maske darstellen, sondern es

können auch beliebige

Informationen über eine Formel

(Kalkulator Syntax) berechnet und

angezeigt werden.

Hierfür muss im Toolboxmodus, über

die rechte Maustaste in der Maske,

der Punkt „Berechnetes Feld

einfügen…“ gewählt werden.

8.3 Ändern von Spaltennamen Über den Spalteneditor ist nun eine Möglichkeit der einfachen Umbenennung von Spalten geschaffen.

Es dürfen sowohl SelectLine- als auch Extrafelder umbenannt werden.

Zum Ändern kann per Doppelklick auf ein Feld die Spalteneinstellung geöffnet werden oder mit zwei

Klicks direkt bearbeitet werden.

Für SQL-Abfragen, Toolboxmakros oder COM-

Anwendungen muss weiterhin der physische

Feldname der Datenbank verwendet werden.

Um den Feldnamen herauszufinden, kann man

sich den Hints bedienen.

Seite 27 von 29


8.4 Permanente Datenfilterung Über diese neue Filtermöglichkeit können Einschränkungen für die wichtigsten Daten der

Warenwirtschaft, dauerhaft und für einzelne Benutzer, angelegt werden. Der Benutzer kann diesen Filter

nicht, wie bisher bei Trichterfiltern oder Quickfiltern gewohnt, deaktivieren.

8.5 Speicherorte Die neuen Funktionen werden weitestgehend auch in neue Tabellen gespeichert.

Somit sind die Permanentfilter in der Tabelle [PERMANENTFILTER] abgespeichert.

Die berechneten Spalten in der Tabelle [BERECHNETESPALTEN].

Die Umbenennung der Spalten wird mit in die bestehende Tabelle [SPALTENEINSTELLUNGEN]

geschrieben.

9 Globale Toolboxevents

Globale Toolboxevents können über den Menüpunkt Eigene Daten / Toolbox / Globale Ereignisse

angelegt werden.

In dieser Maske haben Sie die Möglichkeit, vorhandene

Toolbox-Makros an den Start bzw. an das Ende des

Programms zu koppeln. Diese werden dann automatisch

aufgerufen und ausgeführt.

Markieren Sie das gewünschte Ereignis und wählen Sie ein

auszuführendes Makro für die Kopplung aus

10 Toolbox Auswertung

Über den Menüpunkt Eigene Daten / Toolbox / Auswertung erhalten Sie einen Überblick über

Maskenanpassungen und Ereignisse.

Die Auswertung kann getrennt nach Maskeneditor bzw. Toolbox oder zusammengefasst erfolgen. Die

Toolbox-Auswertung kann optional die Toolbox-Termine sowie die Toolbox-Ereignisse beinhalten.

Seite 28 von 29


11 Toolbox Import / Export

Die Toolboxkonfiguration kann per Export und Import auf andere Systeme übertragen werden

Für den Import bzw. Export von Toolboxkonfigurationen steht für berechtigte Toolbox-Benutzer,

Laufzeit- oder Editiermodus, jeweils eine separate Schnittstelle zur Verfügung.

11.1 Import

Archivname

Pfad der zu importierenden Archiv-Datei (*.lzx).

Import für Nutzer

Aus der Liste der in der Sicherung enthaltenen Nutzer wird das Kürzel markiert und dem Nutzer, für den

die Toolbox-Konfiguration zu importieren ist, über die Pfeiltasten zugeordnet. Der Import kann für

mehrere Nutzer gleichzeitig ausgeführt werden. Ein Kürzel der Sicherung kann dabei mehreren Nutzern

zugeordnet werden.

Einzelne Nutzer markieren Sie durch Mausklick mit gedrückter [Strg] - Taste oder bei Auswahl durch

Cursor mit der Leertaste. Ganze Bereiche (von-bis) erreichen Sie, indem Sie den ersten Datensatz mit

[Strg] + linker Maustaste und den letzten mit [Umschalt] + linker Maustaste markieren.

Import-Aktualisierungs-Optionen

Es ist möglich für den Import einzelne Kategorien aus- und abzuwählen:

Formulare

Makros

Toolboxnotizen

Extrafelder

Extradialoge

Nutzerdefinierte Belege

als Aktualisierungsoption stehen zur Verfügung:

nur neue Daten anlegen

Hinweis: Notizen werden immer importiert (ggf. doppelte Einträge löschen!)

anlegen und überschreiben

Seite 29 von 29


11.2 Export

Archivname

Pfad inkl. Dateiname der Archiv-Datei (*.lzx).

zu exportierende Nutzer

Aus der Liste der Toolbox-Nutzer werden der oder die Nutzer markiert, dessen Einstellungen exportiert

werden sollen.

Einzelne Nutzer markieren Sie durch Mausklick mit gedrückter [Strg]-Taste oder bei Auswahl durch

Cursor mit der Leertaste. Ganze Bereiche (von-bis) erreichen Sie, indem Sie den ersten Datensatz mit

[Strg] + linker Maustaste und den letzten mit [Umschalt] + linker Maustaste markieren.

Export-Optionen

Der Export kann aktiviert werden für

Extrafelder

Extradialoge

Toolbox-Notizen

Nutzerdefinierte Belege

Kurzbeschreibung Toolbox - SelectLine Software GmbH · Seite 6 von 29 Kurzbeschreibung Toolbox Wenn...

Documents

Transcript of Kurzbeschreibung Toolbox - SelectLine Software GmbH · Seite 6 von 29 Kurzbeschreibung Toolbox Wenn...