Entwicklung > Skript-Dictionary > Skripten > Unterprogramme 

Mit dieser Funktion können die Informationen zu den Unterprogrammen und den mehrfach verwendbaren Funktionen genutzt werden.

Es handelt sich hauptsächlich um eine Wissensdatenbank. Mit dieser Funktion kann bei der Generierung von Webservices ebenfalls ein Unterprogramm zugänglich gemacht werden.

  

Vorbedingungen

SEEREFERTTO Siehe Dokumentation Umsetzung

Maskenverwaltung

Erfassungsmaske

Übersicht

Schließen

 

Felder

In diesem Register befinden sich die folgenden Felder :

Blocknummer 1

  • Datei (Feld PRG)

Code der Verarbeitung. Er muss im Verarbeitungs-Dictionary aktiviert sein. 

  • Unterprogramme (Feld SUBPRG)

Unterprogramm oder Funktion, die als wiederverwendbar angesehen wird und daher im Dictionary aktiviert wird.

  • Bezeichnung (Feld ZINTIT)

 

Eigenschaften

Ein Aktivitätscode ermöglicht folgende Aktionen:

  • Optionalsetzung eines Dictionary-Elements, wenn der dem Aktivitätscode zugeordnete Wert Null ist.
  • Signatur spezifischer Elemente, falls deren Code mit X, Y oder Z beginnt.
  • Vorgabe einer Höchstanzahl von Zeilen, falls der Aktivitätscode sich auf Elemente einer Tabelle bezieht.

Wenn der Aktivitätscode deaktiviert ist:

  • kann das markierte Element nicht verwendet werden,
  • wird der zugehörige Code nicht generiert oder aktiviert.
  • Modul (Feld MODULE)

Unabhängig davon, ob das Modul aktiv oder inaktiv ist, gibt es keine Auswirkungen auf die Ausführung des Unterprogramms.

  • Typ (Feld TYPASU)

Ermöglicht die Klassifizierung der Unterprogramme und Funktionen, um die Suche zu vereinfachen und für eine verbesserte Wiederverwendbarkeit.

Die Funktionen und Unterprogramme müssen entsprechend ihrem Ziel klassifiziert werden:

  • Prüfung
  • Erfassung
  • Auswahl
  • Aktualisierung
  • Xsl (mit der Maske verknüpfte Verarbeitung)
  • Statusrückgabe
  • Informationssuche
  • Berechnung
  • Sonstige

  • Feld WA

 

  • Web Services (Feld WEBS)

Ermöglicht die Angabe, dass dieses Unterprogramm oder diese Funktion für die Webservices erzeugt werden kann. Es wird keine Verarbeitung direkt bearbeitbar für die Webservices geliefert. Eine Funktion Web-Erzeugung wird dagegen für die Objekte und Unterprogramme zur Verfügung gestellt, die als erzeugbar identifiziert wurden.

  • Feld PUBNAM

 

Blocknummer 3

  • Funktion (Feld FONCTION)

Die Option ermöglicht die Unterscheidung der Funktionen (aufgerufen über die Anweisung Func) und der Unterprogramme (aufgerufen über die Anweisung Call.)

  • Argumenttyp (Feld TYPFCT)

Dieses Feld wird für die Funktionen ausgefüllt. Diese werden je nach Art des Rückgabegrunds klassifiziert:

  • Char
  • Integer
  • Dezimal
  • Datum
  • etc.

Bezeichnung

  • Feld TEXTE

Text, mit dem der Paragraph PRE "Präsentation" ausgefüllt wird, in der Dateihilfe. In der Dokumentationsverwaltung wird die Dateihilfe identifiziert nach:

  • Dokumentationstyp = ASU
  • Dokumentationscode = Verarbeitung_Unterprogramm

Tabelle Einstellungen

  • Nr. (Feld NUMLIG2)

 

  • Code (Feld PARAM)

Jeder Parameter wird über einen Code von 10 Großbuchstaben und Ziffern identifiziert. Für diese Parameter gibt es kein Dictionary. 

  • Bezeichnung (Feld ZINTITPAR)

 

  • Typ (Feld TYPPAR)

Parameterart:

  • Char: Zeichenkette
  • Integer: Ganze Zahl
  • Dezimal: Dezimalzahl
  • Datum: Datum
  • Bezeichnung: Lokales Menü
  • Clob: Text
  • Blob: Bild

 

  • Einh. (Feld DIME)

Dimension des Parameters

  • Argumenttyp (Feld ADRVAL)

Gibt an, wie der Parameter angegeben wurde.

          nach Adresse (Eine Variable ist für die Angabe des Parameters erforderlich. Aus den Unterprogrammen kann der Parameterwert wieder in die aufgerufene Bearbeitung zurück).

          nach Wert (Der Parameter wird durch eine Variable oder eine Konstante angegeben. Aus den Unterprogrammen kann der Parameterwert auch wenn er bearbeitet wurde nicht mehr in die aufgerufene Bearbeitung zurück).

Schließen

 

Symbol Aktionen

Parameter

Mit diesem Button kann nach der Analyse des Unterprogramms die Parametertabelle aktualisiert werden. Diese Felder werden automatisch belegt: Parametercode, Typ und Argumenttyp. Anschließend muss die Tabelle mit dem Titel und der Parametereinheit vervollständigt werden.

 

Schließen

 

Reports

Standardmäßig sind der Funktion folgende Reports zugeordnet :

 ASUBPROG : Liste Unterprogramme

Dies kann durch geeignete Parameter geändert werden.

Spezielle Buttons

Mit diesem Button kann die Definition des Unterprogramms in einen anderen Ordner kopiert werden.

Dieser Button ist für die als Webservice zugelassenen Unterprogramme aktiv. Mit dem Button kann das aktuelle Unterprogramm als Webservice veröffentlicht werden.

Menüleiste

Option / Überprüfung

Kohärenzprüfung der Parametertabelle mit dem Unterprogramm. Die Anzahl der fehlerhaften Parameter wird - falls vorhanden - angezeigt.

Option / Gesamtprüfung

Kohärenzprüfung der Parametertabelle in allen Unterprogrammen. Am Ende der Prüfung wird eine Logdatei generiert.

Option / Kontextassistent Formeln

Tunnel zur Funktion "Kontextassistent Formeln".

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: :

Verarbeitung existiert nicht

Verarbeitung existiert im aktuellen Ordner oder einem der übergeordneten Ordner nicht.

Reservierter Code

Der erfasste Verarbeitungscode ist ein für X3 reservierter Code und kann daher nicht verwendet werden.

Verwendete Tabellen

SEEREFERTTO Siehe Dokumentation Umsetzung