Version 4.2.6
 —  Statements  —

Definition von NaturalX-Objekten

Allgemeine Syntax von DEFINE DATA OBJECT:

../graphics/sbo3.gif

  OBJECT

../graphics/cbo3.gif

USING

../graphics/cbo2.gif

local-data-area

../graphics/cbc2.gif

../graphics/cbc3.gif

../graphics/sbc3.gif

../graphics/dot3.gif

parameter-data-area
data-definition../graphics/dot3.gif

Dieses Dokument behandelt folgende Themen:

Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole.


Funktion

Das DEFINE DATA OBJECT-Statement wird benutzt in einem Subprogramm oder einer Klasse in Zusammenhang mit Natural X. Weitere Informationen, siehe NaturalX-Dokumentation im Leitfaden zur Programmierung.

Seitenanfang

Syntax-Beschreibung

USING local-data-area Eine Local Data Area (LDA) enthält Datenelemente, die in einem einzelnen Natural-Modul benutzt werden sollen. Sie können mehr als eine Data Area referenzieren; in diesem Fall müssen Sie die reservierten Wörter OBJECT und USING wiederholen, zum Beispiel:
DEFINE DATA
  OBJECT USING DATX_L
  OBJECT USING DATX_P

  ...
END-DEFINE ;
Weitere Informationen siehe Felddefinitionen im DEFINE DATA-Statement im Leitfaden zur Programmierung.
USING parameter-data-area Eine mit DEFINE DATA OBJECT definierte Data Area kann eine Parameter Data Area (PDA) sein. Wenn Sie eine PDA als eine Object Data Area benutzen, können Sie sich die zusätzliche Mühe ersparen, eine Object Data Area zu erstellen, die dieselbe Struktur wie die PDA hat.
data-definition Daten können auch direkt mit der im Abschnitt Direkte Datendefinition weiter unten angegebenen Syntax definiert werden.
END-DEFINE

Das für Natural reservierte Wort END-DEFINE muss zum Beenden des DEFINE DATA-Statements benutzt werden.

Direkte Datendefinition

Daten können auch mit der folgenden Syntax direkt definiert werden:

level

group-name [(array-definition)]

variable-definition
view-definition
redefinition
handle-definition

Weitere Informationen siehe Felddefinitionen im DEFINE DATA-Statement im Leitfaden zur Programmierung.

level

Dies ist eine ein- oder zweistellige Zahl im Bereich von 01 bis 99 (die vorangestellte 0 ist nicht erforderlich), die in Verbindung mit der Gruppierung von Feldern verwendet wird. Felder mit einer Level-Nummer von 02 an aufwärts werden als Teil einer unmittelbar vorangehenden Gruppe mit einer jeweils nächstniedrigeren Level-Nummer betrachtet.

Durch die Definition einer Gruppe (die auch nur aus einem Feld bestehen kann) ist es möglich, durch Angabe lediglich des Gruppennamens eine ganze Reihe von aufeinanderfolgenden Feldern gleichzeitig zu referenzieren. Bei manchen Statements (CALL, CALLNAT, RESET, WRITE usw.) können Sie den Gruppennamen als Aufrufnamen angeben, um die in der Gruppe enthaltenen Felder zu referenzieren.

Eine Gruppe kann aus weiteren Gruppen bestehen. Bei der Vergabe von Level-Nummern für eine Gruppe darf kein Level ausgelassen werden. Eine View-Definition muss immer auf Level 1 definiert werden.

group-name

Der Name einer Gruppe. Der Name muss den Regeln zur Definition eines Natural-Variablennamens entsprechen. Siehe auch die folgenden Abschnitte:

array-definition Mit array-definition definieren Sie die Unter- und Obergrenze einer Dimension in einer Array-Definition. Siehe auch Definition einer Array-Dimension.
variable-definition Eine variable-definition wird zur Definition eines einzelnen Feldes (Skalar) oder einer einzelnen Variablen (Array) verwendet. Siehe Variablen-Definition.
view-definition Eine view-definition wird benutzt, um ein View mit Bestandteilen aus einem Datendefinitionsmodul (DDM) zu definieren. Siehe View Definition.
redefinition Eine redefinition kann zur Redefinition einer Gruppe, eines Views, eines DDM-Felds oder eines einzelnen Feldes oder einer einzelnen Variable benutzt werden (d.h. Skalar oder Array). Siehe Redefinition.
handle-definition Eine Handle identifiziert ein Dialog-Element im Code und wird in Handle-Variablen gespeichert. Siehe Handle-Definition.

Seitenanfang