Externe Toolbox-Anbindung
Über Toolbox-Makros unter Eigene Daten / Makro-Assistent - Toolbox - (nur, wenn Toolbox lizenziert und für den Benutzer aktiviert ist)
können sowohl externe Programmfunktionen mit den SelectLine-Produkten verbunden als auch interne Programmfunktionen aufgerufen werden. Alle externen Programmfunktionen können mit Parametern versehen und die Datenrichtung (Output, Input, Bidirektional) definiert und genutzt werden. Grundsätzlich ist zu beachten, dass alle internen Programmfunktionen parametisierbar sind.
Die möglichen Parameter der Programmfunktionen können über das Kontextmenü Definierte Parameter einfügen (alle Parameter/Pflichtparameter/optionale Parameter) angelegt werden.
Abbildung 1.1387: Toolbox Makro-Assistent
Folgende Schnittstellentypen stehen zur Verfügung:
Abbildung 1.1388: Toolbox Schnittstellentyp
- 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. In der Tabelle der Parameter sind beim Ausführen von Programmen die Kommandozeilenparameter für den Start des Programms zu definieren. Parametername und Parameterwert werden mit dem doppelten Hochkommazeichen umschlossen, d.h. ein doppeltes Hochkomma wird doppelt in die Parameternamen und Parameterwerte geschrieben.
- DLL-Aufruf - Durch diese Kopplungsart können Dynamic-Link-Librarys (DLL) ausgeführt werden. Die DLL muss sich im Ausführungspfad befinden oder mit dem kompletten Pfad angegeben werden.
- COM-Aufruf - Durch diese Kopplungsart können COM-Objekte ausgeführt werden. Voraussetzung ist jedoch, dass das zu nutzende COM-Objekt von IDispatch abgeleitet ist.
- Programmfunktion - Mit dieser Funktion können Sie verschiedene interne Programmfunktionen ausführen.
Der Programmaufruf erfolgt in folgender Form:
Programmname “Parametername1“=“Parameterwert1“ “Parametername2“=“Parameterwert2“
“Parametername3“
Codebeispiel 1 Programmaufruf
Wenn keine Parameterwerte definiert sind (Stringlänge 0) wird nur der Parametername genutzt (siehe Parametername3).
Parametername und Parameterwert werden mit dem doppelten Hochkommazeichen gequoted, d.h., ein doppeltes Hochkomma wird doppelt in die Parameternamen und Parameterwerte geschrieben.
Achtung: In Delphi7 ist ein Bug in der Funktion „ParamStr“ (alle Hochkommas werden eliminiert!).
Durch die Funktion GetToolBoxInfo kann die komplette Schnittstellenbeschreibung einer externen Toolbox-Dll definiert werden. Damit entfällt die fehleranfällige händische Eingabe der Funktions- und Parameternamen.
Diese Funktion liefert einen Zeiger auf folgende Beschreibungsstruktur (TToolBoxFcts) zurück:
Name |
Typ |
Beschreibung |
Size |
integer |
Grösse der Struktur |
VersionMajor |
word |
Hauptversionsnummer |
VersionMinor |
word |
Unterversionsnummer |
CopyRight |
PChar |
Copyright |
Description |
PChar |
Beschreibung der Toolbox-Dll |
FctsCount |
integer |
Anzahl der integrierten Toolbox-Funktionen |
Fcts |
PToolBoxFctInfo |
Zeiger zu den Beschreibungen jeder einzelnen Toolbox-Funktion |
Die Beschreibungsstruktur für einen einzelne Toolbox-Funktion (TToolBoxFctInfo) hat folgenden Aufbau:
Name |
Typ |
Beschreibung |
Size |
integer |
Grösse der Struktur |
Name |
PChar |
Name der Funktion |
Description |
PChar |
Beschreibung der Toolbox-Funktion |
Kind |
TToolBoxCallKind |
Festlegung des Aufruftyps |
ParamsKind |
TToolBoxParamsKind |
Festlegung der Parameterreihenfolge |
ParamsCount |
integer |
Anzahl der Parameter |
Params |
PToolBoxFctParam |
Zeiger zu den Beschreibungen jedes einzelnen Parameters |
Der Aufzählungstyp TToolBoxCallKind besitzt folgende Elemente:
Name |
Beschreibung |
tbxcNone |
Nicht verwenden |
tbxcCall |
Entspricht dem Aufbau von „Call“ |
tbxcCallMsg |
Entspricht dem Aufbau von „CallMsg“ |
tbxcCallParams |
Entspricht dem Aufbau von „CallParams“ |
tbxcCallDBParams |
Entspricht dem Aufbau von „CallDBParams“ |
Der Aufzählungstyp TToolBoxParamsKind besitzt folgende Elemente:
Name |
Beschreibung |
tbxpsFlex |
Die Parameter können an einer beliebigen Position stehen. Die Dll ist dafür verantwortlich, die Parameterwerte zu suchen. |
tbxpsPosDefined |
Die Parameterreihenfolge wird durch die Toolbox eingehalten. Damit muss nicht den Parameterwerten gesucht werden, sondern die Werte sind direkt indizierbar. |
Die Beschreibungsstruktur eines einzelnen Toolbox-Parameters (TToolBoxFctParam) hat folgenden Aufbau:
Name |
Typ |
Beschreibung |
Size |
integer |
Grösse der Struktur |
Name |
PChar |
Name der Funktion |
Description |
PChar |
Beschreibung der Toolbox-Funktion |
Kind |
TToolBoxParamKind |
Festlegung des Aufruftyps |
Der Aufzählungstyp TToolBoxParamKind besitzt folgende Elemente:
Name |
Beschreibung |
tbxpFlex |
Wird noch nicht genutzt (für die nächste Version). |
tbxpInName |
Wird noch nicht genutzt (für die nächste Version). |
tbxpValue |
Wird noch nicht
genutzt (für die nächste Version). |
Als Delphi-Codebeispiel dient „TestCustDll2.dpr“ im Dokumentationsverzeichnis auf der CD unter „ToolBox\DLLv82“.
Durch das Property Infos in der ISelectLineCall2-Schnittstelle kann die komplette Toolbox-Schnittstellenbeschreibung des COM-Objektes definiert werden. Damit entfällt die starre fehleranfällige händische Eingabe der Funktions- und Parameternamen.
Die ISelectLineCall2-Schnittstelle besitzt folgenden Aufbau:
Name |
Typ |
Beschreibung |
Infos |
IInfo |
Rückgabe des Informations-Interfaces |
Die IInfo-Schnittstelle besitzt folgenden Aufbau:
Name |
Typ |
Beschreibung |
VersionMajor |
SYSINT |
Hauptversionsnummer |
VersionMinor |
SYSINT |
Unterversionsnummer |
CopyRight |
OleVariant |
Copyright |
Description |
OleVariant |
Beschreibung der Toolbox-Dll |
FctsCount |
SYSINT |
Anzahl der integrierten Toolbox-Funktionen |
Fcts[Index: Integer] |
IFunction |
Rückgabe des Funktions-Interfaces |
Die IFunction-Schnittstelle besitzt folgenden Aufbau:
Name |
Typ |
Beschreibung |
Name |
OleVariant |
Name der Funktion |
Description |
OleVariant |
Beschreibung der Toolbox-Funktion |
Kind |
ICallEnum |
Festlegung des Aufruftyps |
ParamsKind |
IParamsEnum |
Festlegung der Parameterreihenfolge |
ParamsCount |
integer |
Anzahl der Parameter |
Params[Index: Integer] |
IParam |
Rückgabe des Parameter-Interfaces |
Der OLE-Aufzählungstyp ICallEnum besitzt folgende Elemente:
Name |
Beschreibung |
Call |
Entspricht dem Aufbau von „Call“ |
CallMsg |
Entspricht dem Aufbau von „CallMsg“ |
CallParams |
Entspricht dem Aufbau von „CallParams“ |
CallDBParams |
Entspricht dem Aufbau von „CallDBParams“ |
Der OLE-Aufzählungstyp IParamsEnum besitzt folgende Elemente:
Name |
Beschreibung |
ParamsFlex |
Die Parameter können an einer beliebigen Position stehen. Die Dll ist dafür verantwortlich, die Parameterwerte zu suchen. |
ParamsPosDefined |
Die Parameterreihenfolge wird durch die Toolbox eingehalten. Damit muss nicht den Parameterwerten gesucht werden, sondern die Werte sind direkt indizierbar. |
Die IParam-Schnittstelle besitzt folgenden Aufbau:
Name |
Typ |
Beschreibung |
Name |
OleVariant |
Name der Funktion |
Description |
OleVariant |
Beschreibung der Toolbox-Funktion |
Kind |
IParamEnum |
Festlegung des Aufruftyps |
Der OLE-Aufzählungstyp IParamEnum besitzt folgende Elemente:
Name |
Beschreibung |
ParamFlex |
Wird noch nicht genutzt (für die nächste Version). |
ParamInName |
Wird noch nicht genutzt (für die nächste Version). |
ParamInValue |
Wird noch nicht
genutzt (für die nächste Version). |
Interne Programmfunktionen
Durch die Kopplung zum Schnittstellentyp Programmfunktion wird die gewählte interne Programmfunktion ausgeführt. Derzeit sind die nachfolgend aufgeführten Funktionen verfügbar:
- 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 Artikel zu löschen (Standard = true)
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)
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össte 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
7. Parameter: [fehlerAnzeige] = optionaler Parameter, um bei Fehlern Fehlerprotokoll zu öffnen (Standard = true)
- 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 hinzufügt 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)
3. Parameter: [Filename] = Dateiname des hinzuzufügenden Bildes
- 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 ausschliesslich der Veranschaulichung der internen Programmfunktionen in Schnittstellen-Makros.
- Eingabemaske aufrufen
Diese interne Programmfunktion ruft einen gewünschten Stammdatendialog in der Detailansicht auf. Diese Funktion basiert auf zwei Parametern.
1. Parameter: [BK] = Geben Sie den BlobKey (z.B. AR) ein.
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 einen Stammdatendialog über den Blobkey suchen und in den Vordergrund holen.
1. Parameter: [BK] = Geben Sie den BlobKey (z.B. AR) ein.
- Eingabemaske nicht modal aufrufen
Mit der Programmfunktion erreichen Sie einen nicht modalen Aufruf eines Stammdatendialoges über Blobkey und Schlüsselwert.
1. Parameter: [BK] = Geben Sie den BlobKey (z.B. AR) ein.
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).
- Eingabemaske schliessen
Mit der Programmfunktion können Sie einen Stammdatendialog über den Blobkey suchen und schliessen.
1. Parameter: [BK] = Geben Sie den BlobKey (z.B. AR) ein.
- 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 EK's durchgeführt (entspricht der Programmfunktion in den Lieferantenstammdaten):
1. Parameter: [lieferantenNummer] = Geben Sie eine Lieferantennummer ein.
2. Parameter: [fehlerAnzeige] = optionaler Parameter, um bei Fehlern Fehlerprotokoll zu ö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 Parameter 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] = [16.04.2013]
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. 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. Auftrag).
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
Diese Toolbox-Programmfunktion verwendet die Programmfunktion Dokument anlegen aus den Stammdaten Kunden / Lieferanten / Interessenten.
1. Parameter: [Filename] = Hier ist der vollständige Pfad zur Dokumentvorlage anzugeben.
2. Parameter: [Beschreibung] = optionaler Parameter für die Bezeichnung des Journaleintrages.
3. Parameter: [DokumentAnzeigen] = optionaler Parameter, um das Dokument für die weitere Bearbeitung zu öffnen (Standard = false).
4. Parameter: [NotizAnlegen] = optionaler Parameter, ob das Dokument als Journaleintrag gespeichert werden soll (Standard = false).
- Preisneuberechnung
Für die Toolbox steht eine interne Programmfunktion ”Preisneuberechnung” zur Verfügung, die dasselbe leistet, 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.
1. Parameter: [belegTyp] = Geben Sie den Belegtyp ein (z.B. F).
2. Parameter: [belegNummerVon] = alphabetisch kleinste Belegnummer
3. Parameter: [belegNummerBis] = alphabetisch grösste Belegnummer
4. Parameter: [hauptArtikel] = optionaler Parameter, Handelsstücklisten erhalten den Preis des Hauptartikels (Standard = true)
5. Parameter: [rabatt100aktualisieren] = optionaler Parameter, um Positionen mit 100% Rabatt von der Aktualisierung auszuschliessen (Standard = true)
6. Parameter: [steuer] = optionaler Parameter, um den Steuerschlüssel zu aktualisieren (Standard = true)
7. Parameter: [fibuKonto] = optionaler Parameter, um das Fibukonto zu aktualisieren (Standard = true)
8. Parameter: [gedruckt] = optionaler Parameter, um gedruckte Beleg auch zu aktualisieren (Standard = false)
9. Parameter: [fehlerAnzeige] = optionaler Parameter, um bei Fehlern Fehlerprotokoll zu öffnen (Standard = true)
- 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.
1. Parameter: [belegTyp] = Geben Sie den Belegtyp ein (z.B. F).
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ässig zusammengefasst werden dürfen. Bleibt dieser Parameter leer, erfolgt die Zusammenfassung nach Kreuzverweise.
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 weitere Ausgabe- und Eingabeparameter zur Verfügung.
Rückschreibfähig
Folgende Datenquellen sind rückschreibfähig :
Artikel, Kunde und Lieferant |
Table |
Beleg |
Table und DsBelegPosition |
Leistungserfassung |
DsLeistungPositionen |
Termin anlegen/bearbeiten |
Termin |
- Währung umrechnen
Diese interne Programmfunktion beinhaltet eine Währungsumrechnung.
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)
- Manuelles Erledigen eines Beleges
Mit der Toolbox-Programmfunktion ”Manuelles Erledigen eines Beleges” lassen sich offene Aus- und Eingangsbelege sowie Werkaufträge manuell erledigen.
1. Parameter: [belegTyp] = Geben Sie den Belegtyp ein (z.B. F).
2. Parameter: [belegNummer] = Geben Sie die Belegnummer ein.
Weitere Informationen zu internen Programmfunktionen, DLL- oder COM-Aufruf können Sie der Online-Hilfe entnehmen, da hier ständig Erweiterungen und Aktualisierungen vorgenommen werden.
Beschreibung - Über diesen Text wird das Toolbox-Makro im Makroassistenten gelistet.
Makroname - Dateiname des Makros.
Ausführen von - (variiert je nach Schnittstellentyp) Pfad des externen Programms, COM-Objekts oder der externen DLL.
Aufruftyp
- Aufruf
- Aufruf mit Nachricht
- Aufruf mit Nachricht und Parameter
- Aufruf mit Nachricht und DB-Parametern
Funktionsname - Definierter Name der Funktion.
Parameter - Hier werden die im Toolbox-Makro enthaltenen Parameter definiert und verwaltet. Über das Kontextmenü (variiert je nach Schnittstellentyp) stehen Optionen zum automatischen Einfügen definierter Parameter und Datenquellenfelder zur Verfügung.
und
öffnet den Dialog ”Makro-Parameter”, hier können Sie eine Wertzuweisung von Parametername und -wert vornehmen.
Name - Vergeben Sie einen Parameternamen oder wählen Sie per Doppelklick einen definierten Parameter aus.
Wert - Definieren Sie hier einen Parameter oder weisen Sie dem Parameterwert ein Datenfeld aus System, Mandant oder Toolbox zu.
Beschreibung - Dieses Feld kann zur genaueren Beschreibung der Parameter genutzt werden
weitere mögliche Optionen:
- Parameter vor der Ausführung anzeigen
- Parameter vom Programm trennen:
wahr (Standard) = zwischen Programm und Parameter ist ein Leerzeichen,
bei unwahr ist zwischen Programm und Parameter kein Leerzeichen - Trenn-Leerzeichen:
wahr (Standard) = zu dem vorhergehenden Parameter wird ein Leerzeichen hinzugefügt,
bei unwahr wird zu dem vorhergehenden Parameter kein Leerzeichen hinzugefügt - Parametername benutzen:
bewirkt, dass die Kommandozeilenparameter zusammengebaut werden aus dem Parameternamen, einem Gleichheitszeichen, gefolgt vom Wert.
wahr (Standard) = es wird ”Name”=”Wert” geschrieben,
bei unwahr lediglich der Wert - Die Einstellung ”Parameter in Hochkomma” kann genutzt werden, wenn die Einstellung ”Parametername benutzen” abgewählt ist. Die aktivierte Einstellung setzt den Inhalt des Parameters in doppelte Hochkommas.
- Für die Toolboxparameter von Dll’s und COM-Schnittstellen können der Datentyp und die Datenrichtung (Output, Input, Bidirektional) definiert und genutzt werden. Weiterhin können Parameter als optional definiert werden. Alle Einstellungen, bis auf ”Wert”, sind von ”Name” abhängig.
(Rückschreibfähige Datenquellen siehe Funktion ”String-Parameter-Umleitung” im Abschnitt (siehe Abschnitt Interne Programmfunktionen)
Hinweis: Das Eingabefeld ”Name” ist nur beim Anlegen eines Parameters editierbar.
Beispiele
Toolbox Programmausführung:
www.google.ch/search?hl=de&q=selectline auftrag
Die Konfiguration hierfür ist wie folgt:
Programm: www.google.ch
Parameter vom Programm trennen: unwahr
1. Parameter:
Name = SelectLine, Wert = ”/search?hl=de&q=selectline ”
(Optionen: kein Trennzeichen, Parametername nicht benutzen)
2. Parameter:
Name = Programm, Wert = {:Programm} oder {System.Programmname}
(Optionen: kein Trennzeichen, Parametername nicht benutzen)
- COM Registrierung vornehmen — Start → Ausführen → cmd, dort in das Verzeichnis der DLL wechseln und diese mit ”regsvr32 DLLName.dll” registrieren
- im Makroassistent ein neues Toolbox-Makro vom Typ COM-Aufruf anlegen
- Auswahl des Servers — über den Schalter
werden die verfügbaren Server eingelesen und können anschliessend über den Auswahlpfeil
ausgewählt werden (bei einem lokalen Pfad immer ”localhost” verwenden)
- im Eingabefeld ”Schnittstelle” erfolgt die Auswahl der DLL, auch hier erst über Schalter
die verfügbaren Schnittstellen einlesen und dann über den Auswahlpfeil
auswählen
- die gewählte Schnittstelle beinhaltet den entsprechenden Aufruftyp
- über den Auswahlpfeil wird der Funktionsname gewählt, dadurch werden die Parameter der Funktion in die Parameterliste eingetragen
- speichern Sie das neue Toolbox-Makro
Abbildung 1.1390: Beispiel COM-Aufruf
Auswahl von Toolbox Programmfunktionen per Auswahldialog
Die Auswahl der Toolbox-Programmfunktionen
Abbildung 1.1391: Programmfunktion
bietet Ihnen dank der Auswahlliste die bekannten Suchfunktionen, wie z.B. Quickfilter und Suchzeile und ermöglicht Ihnen so ein deutlich schnelleres Auffinden der gewünschten Funktion.
Abbildung 1.1392: Programmfunktion per Auswahldialog
Toolbox Programmfunktion zur Anlage neuer Datensätze
Mit der Toolbox-Programmfunktion Stammdatensatz anlegen können Sie Stammdatendialoge und Belege anlegen. Hierfür ist zwingend das „tabellenkürzel“ (z.B. „QR“ für Rechnung) für den Dialog anzugeben, in dem die Neuanlage erfolgen soll.
Abbildung 1.1393: Programmfunktion Anlage neuer Datensätze
Mit Definierte Parameter einfügen.
Wird der Parameter key nicht angegeben, erscheint der Dialog zur Neuanlage eines Datensatzes mit entsprechendem Vorschlagswert für das Schlüsselfeld (identisch zu manueller Neuanlage).
In einem weiteren optionalen Parameter zielfeldliste können Sie durch Zeilenumbruch getrennte Wertepaare, bestehend aus einem Feldnamen, dem Zeichen "|" und dem Feldwert übergeben, um passende Eingabefelder zu füllen. Hierbei werden nur Felder unterstützt, die im entsprechenden Stammdialog ein passendes Eingabefeld besitzen.