Entwicklung > Skript-Dictionary > Funktionen 

Mit dieser Funktion können alle aus dem Menü aufrufbaren Datenbankfunktionen erfasst werden. Eine Funktion kann entweder einem Menüpunkt oder einer Verarbeitung entsprechen.

Vorbedingungen

SEEREFERTTO Siehe Dokumentation Umsetzung

Maskenverwaltung

Die Definition einer Funktion wird in zwei Registern vorgenommen: Im ersten werden die allgemeinen Daten, im zweiten die Aktion erfasst.

Kopfzeile

Übersicht

Der Kopfzeile ist die Funktions-Id zu entnehmen.

Schließen

 

Felder

In diesem Register befinden sich die folgenden Felder :

Geben Sie hier den Funktionscode ein.
Die Codes, die mit "GES" beginnen, werden automatisch vom Supervisor für die Objektverwaltung erzeugt.

  • Bezeichnung (Feld ZNOM)

 

Schließen

 

Register Allgemeine Angaben

Übersicht

In diesem Register werden die Eigenschaften der Funktion definiert.

Schließen

 

Felder

In diesem Register befinden sich die folgenden Felder :

Eigenschaften

  • ADMIN-Menü (Feld MENU)

Bei der Erstellung einer Funktion ist es unerlässlich, diese auf ein Menü zu beziehen, damit diese Funktion aufgerufen werden kann. Die Menüs sind durch den Benutzer parametrisierbar. Es gibt einen Referenzbenutzer, hier ADMIN genannt, dessen Name jedoch im Parameter ADMUSR geändert werden kann. Die Menüs enthalten alle Funktionen und können bei der Erstellung eines Menüs als Vorlage dienen. Man definiert hier also ein Referenzmenü, in dem man die Funktion wiederfindet.

Das Startmenü der Standard-Baumstruktur heißt GENE; alle Funktionen müssen einen Bezug haben, entweder im Menü GENE oder im Menü selbst, das über das Menü GENE erreichbar ist. Hierbei gelten folgende Einschränkungen:

  Es kann nicht mehr als 30 Auswahlmöglichkeiten in einem Menü geben.

  Es kann nicht mehr als 4 Untermenüebenen geben.

Der Menütitel ist der (übersetzbare) Text, der im Benutzermenü erscheint und die Funktion beschreibt.

  • Rang (Feld RANG)

Den Rang angeben, auf dem die Funktion im Menü oben erscheint.
In einem Menü sind die Funktionen in aufsteigender Reihenfolge der Ränge sortiert.

  • Menütitel (Feld ZLIBMENU)

 

Blocknummer 2

  • Modul (Feld MODULE)

Angabe des Moduls, über das diese Funktion verwendet wird. Wird diese Funktion von mehreren Modulen verwendet, "Supervisor" angeben.


Ist dieser Bereich nicht angegeben, ist die Funktion immer aktiv und erzeugt eine Menüzeile für den ADMIN-Benutzer.
Entspricht dieser Bereich einem inaktiven Aktivitätscode, ist die Funktion nicht aktiv.
Beginnt dieser Bereich mit X Y oder Z, aktualisiert die Ordnervalidierung nicht die Funktion.

  • Funktionsart (Feld TYPTRAIT)

Gibt den Funktionstyp an: Verarbeitung oder Untermenü.

  • Menü/Programm (Feld TRAIT)

Wird die Verarbeitung abgefragt, entspricht sie:

  • entweder dem Namen der auszuführenden Verarbeitung, wenn diese kein Fenster öffnet,
  • oder dem Menünamen.

Für eine Funktion vom Typ Verarbeitung ist die empfohlene Vorgehensweise die Erfassung der Aktion, wenn sie nicht vom Typ "Sonstige Verarbeitung" ist, anstatt die Verarbeitung direkt aufzurufen. 

Berechtigungen

  • Zugriffsart Objekt (Feld TYP)

Ist die Funktion mit einem Objekt verknüpft, wird das Feld "Zugriffsart Objekt" automatisch positioniert. Für die Verwaltung der Funktionsberechtigungen werden die 3 folgenden Codes vorgeschlagen: C (Création/Erstellung, M (Modification/Änderung), S (Suppression/Löschen).
Es ist für jedes Objekt möglich, die Funktionsberechtigungsrechte einzuschränken, indem Erstellung, Änderung bzw. Löschen nicht erlaubt werden.

  • Standortberechtigung (Feld FCYAUZ)

Wird das Feld "Standortberechtigung" positioniert, kann man die Funktionsberechtigungen nach Standort oder nach Standortgruppierung genauer angeben.

Sonstiges

  • Mono-Ausführung (Feld MONO)

Mit dieser Option ist es möglich, die Funktion ausführbar zu machen, auch wenn der Ordner als "Mono-Modul" eingestellt wurde; d.h. wenn er keine Funktion für das Modul zulässt. Ein Ordner ist über eine exklusive Funktion als Mono-Modul positioniert.

  • Erfassungshilfe (Feld ZAIDE)

 

  • Druck (Feld RPT1)

Diese zwei Rubriken ermöglichen die Definition der Namen der zwei über die Funktionen Dateidruck und Dateiliste aufrufbaren Berichtscodes. Diese Berichtscodes sind in den folgenden Variablen gespeichert: GREPORT1 und GREPORT2. Die Funktion Druck ist standardisiert und relativ zur aktuellen Datei (die Funktion ist nicht verfügbar, wenn es keine aktuelle Datei gibt), wohingegen die Funktion Liste in allen Fällen verfügbar ist. Wenn eine Funktion mit einem Objekt verknüpft ist, erzeugt der Supervisor diese Buttons ( (De)Aktivierung, Ausführung des Buttons). Für alle anderen Funktionen muss der Entwickler der Funktion den Aufruf der beiden Berichte sowie die Aktivierung erzeugen.

  • Liste (Feld RPT2)

 

  • Navigation (Feld NAVIG)

Einstellung der Berechtigungen um diese Funktion, für das Menü "Navigation/Gehe zur Funktion":

 Berechtigt: Diese Funktion ist über die Navigation zugänglich.

 Zu dieser Funktion nicht erlaubt: Diese Funktion kann nicht über die Navigation erreicht werden, wenn z.B. ein Kontextaufruf notwendig ist.

 Aus der Funktion nicht erlaubt: Aus dieser Funktion ist die Navigation nicht erlaubt, wenn es z.B. notwendig ist, den aktuellen Kontext zu schützen.

 Nie erlaubt: Der Zugriff auf diese Funktion über die Navigation und der Zugriff auf die Navigation über diese Funktion werden nicht erlaubt.

Tabelle Optionen

  • Nr. (Feld NUMLIG1)

 

  • Option (Feld FLAG)

Diese Tabelle ermöglicht die Definition der Optionscodes (bis maximal 19) unter der Form eines Briefes und eines zugeordneten Kommentars. Die Kleinbuchstaben sind der spezifischen Entwicklung vorbehalten. Für jede Funktionsberechtigung kann dieser Buchstabe ausgewählt werden oder nicht, um der Funktion Optionen hinzuzufügen. Bei der Ausführung einer Funktion füllt der Supervisor die globale Variable GUSRAUZ(n) über die autorisierten Optionscodes. n ist das Indiz, das die Aufsplittung der Berechtigungen nach Standort angibt. Der Entwickler kann einen Teil seiner Verarbeitung vom Vorhandensein oder Nicht-Vorhandensein eines Optionscodes in dieser Variablen abhängig machen.  

  • Bezeichnung (Feld ZOPTION)

 

  • Funktion (Feld FNCOPT)

Dieses Feld ermöglicht die Definition einer Funktion, die den Zugriff auf diesen Parameter beschreibt.

Dadurch können Zugriffsberechtigungsfehler vermieden werden.

Beispiel: Der Button 'Freigabe' der Funktion GESBIC 'Kundenrechnungen' entspricht der Funktion BPCVAL. Nach den in der Funktion BPCVAL definierten Berechtigungen wird der Zugriff auf den Button daher geprüft.

Dieser Aktivitätscode steuert das Vorhandensein oder Nicht-Vorhandensein der Option in der Funktion.

Tabelle Variablen

  • Nr. (Feld NUMLIG2)

 

  • Variable (Feld VARIA)

Diese Tabelle ermöglicht die Definition einer Liste mit globalen Variablen, die zugewiesen werden müssen, damit sie der aufrufenden Verarbeitung einen genaueren Kontext geben. Diese Variablen werden über die Funktion initialisiert, wenn die Verarbeitung über das Menü aufgerufen wird.  

  • Wert (Feld VALEUR)

Angabe des der Variable der gleichen Zeile zuzuweisenden Wertes. Achtung: Dieser Typ muss berücksichtigt werden (es wird keine Prüfung durchgeführt).

Dieser Aktivitätscode ermöglicht vor allem den Schutz der Variablen eines aktualisierten Ordners.

Schließen

 

Register Aktion

Übersicht

In diesem Register wird die auszuführende Aktion definiert.

Schließen

 

Felder

In diesem Register befinden sich die folgenden Felder :

Blocknummer 1

Man definiert die Aktion, die beim Start der Funktion ausgeführt wird. Die Aktion muss im Dictionary vorhanden sein und darf nicht vom Typ "Sonstige Verarbeitungen" sein. War dies der Fall, darf die Funktion nicht die Funktion sondern direkt die Verarbeitung aufrufen. Hierzu erfasst man den Namen der Verarbeitung im ersten Register.

Tabelle

 

  • Parameterwert (Feld VALPAR)

Möglichkeit, die Werte der Aktionsparameter zu erfassen.

Schließen

 

Berichte

Standardmäßig sind der Funktion folgende Reports zugeordnet :

 AFONCTION : Funktionen

Dies kann durch geeignete Parameter geändert werden.

Spezielle Buttons

Mit diesem Button kann die Funktionsdefinition in einen anderen Ordner kopiert werden.

Menüleiste

Option / Kontextassistent Formeln

Tunnel zur Funktion "Kontextassistent Formeln".

Option / Freigabe Funktionen

Dokumentation / Absätze

Mit dieser Funktion kann auf die Dokumentationsverwaltung und auf den ersten Absatz der Dokumentation (sofern vorhanden) zum aktuellen Datenblatt zugegriffen werden.

Dokumentation / Verknüpfungen

Mit dieser Funktion kann auf die Linkverwaltung zugegriffen werden. Die Funktion definiert Links zwischen dem aktuellen Datenblatt und anderen Datenblättern (z. B. Links zwischen Funktionen und Parametern). Diese Links dienen lediglich Dokumentationszwecken: Aus ihnen wird der Generierungsprozess der Dokumentationsgliederungen gespeist.

Dokumentation / Generierung

Über dieses Menü wird die Dokumentationsgenerierung angestoßen. Die Generierung kann auch per Klick auf den Button [Generieren] im unteren Fensterbereich gestartet werden.

Es gibt drei Generierungstypen, die einzeln oder gleichzeitig verwendet werden können:

  • Generierung der Dokumentationsgliederung aus dem Dictionary (Tabellen ADOCUMENT, ADOCBLB, ADOCCLB)
  • Generierung der Dokumentation aus obigen Tabellen
  • Generierung der Felddokumentation

In den standardmäßig vorgeschlagenen Bereichen ist das aktuelle Datenblatt berücksichtigt. Die Bereiche können jedoch beim Aufruf der Funktion geändert werden.

Fehlermeldungen

Während der Erfassung können außer den generischen Meldungen folgende Fehlermeldungen auftreten: :

Funktionscodeformat nicht korrekt (max. fünf Zeichen)

Zu einer Funktion vom Typ Menü darf der Funktionscode fünf Zeichen nicht überschreiten.

Wert nicht korrekt

Eine Funktion vom Typ Verarbeitung darf nicht dem allgemeinen Menü GENE zugeordnet werden.

Eine Funktion vom Typ Menü darf nicht sich selbst zugeordnet werden.

Obligatorischer Bereich

Zu einer Funktion vom Typ Verarbeitung muss ein Aktionscode (bzw. ein Verarbeitungsname) erfasst werden.

Änderung nicht möglich

Ist ein Standard-Aktivitätscode vorhanden, so kann dieser nicht gelöscht werden.

Option nicht korrekt / Option nicht korrekt Zeile Nr. xxx

Bei einer mit dem Objekt verbundenen Funktion sind die Optionscodes C, M und S für den Supervisor reserviert.

Daten existieren nicht

Eine in der Optionstabelle erfasste Funktion muss im Dictionary vorhanden sein.

Verwendete Tabellen

SEEREFERTTO Siehe Dokumentation Umsetzung