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.1204: Toolbox Makro-Assistent

Folgende Schnittstellentypen stehen zur Verfügung:

Abbildung 1.1205: Toolbox Schnittstellentyp

Programmausführung 

  • 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!).

 DLL-Aufruf

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).
Bitte als Defaultparameter definieren.

 Als Delphi-Codebeispiel dient „TestCustDll2.dpr“ im Dokumentationsverzeichnis auf der CD unter „ToolBox\DLLv82“.

 COM-Aufruf

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).
Bitte als Defaultparameter definieren.

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)

Abbildung 1.1206: Beispiel Programmausführung

Toolbox COM-Aufruf :

  1. COM Registrierung vornehmen — Start → Ausführen → cmd, dort in das Verzeichnis der DLL wechseln und diese mit ”regsvr32 DLLName.dll” registrieren
  2. im Makroassistent ein neues Toolbox-Makro vom Typ COM-Aufruf anlegen
  3. 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)
  4. 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
  5. die gewählte Schnittstelle beinhaltet den entsprechenden Aufruftyp
  6. über den Auswahlpfeil wird der Funktionsname gewählt, dadurch werden die Parameter der Funktion in die Parameterliste eingetragen
  7. speichern Sie das neue Toolbox-Makro

Abbildung 1.1207: Beispiel COM-Aufruf

Auswahl von Toolbox Programmfunktionen per Auswahldialog

Die Auswahl der Toolbox-Programmfunktionen

Abbildung 1.1208: 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.1209: 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.1210: 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.