Maske erstellen — Funktion 'Initialize New Map'

#### Search Results

Search

# Maske erstellen — Funktion 'Initialize New Map'

Dieser Abschnitt beschreibt, wie Sie die Einstellungen (Profil) für eine neue Maske oder Hilfe-Maske definieren.

Wenn Sie die Funktion Initialize New Map oder Initialize a New Help Map aufrufen, erscheint als erster Bildschirm der Define Map Settings-Bildschirm, der in mehrere Bereiche unterteilt ist (Beispiel):

    10:41:16               Define Map Settings for MAP                   2007-08-13

     Delimiters           Format                         Context
     -----------------    ---------------------------    --------------------------
     Cls Att CD  Del      Page Size ...... 23            Device Check .... ________
      T   D      BLANK    Line Size ...... 79            WRITE Statement   _
      T   I      ?        Column Shift ... 0 (0/1)       INPUT Statement   X
      A   D      _        Layout ......... ________      Help  ____________________
      A   I      )         dynamic ....... N (Y/N)        as field default N (Y/N)
      A   N      ¬        Zero Print ..... N (Y/N)
      M   D      &        Case Default ... UC (UC/LC)
      M   I      :        Manual Skip .... N (Y/N)       Automatic Rule Rank  1
      O   D      +        Decimal Char ... .             Profile Name .... SYSPROF
      O   I      (        Standard Keys .. N (Y/N)
      D   D      $        Justification .. L (L/R)       Filler Characters
      D   I      /        Print Mode ..... __            ------------------------
                                                         Optional, Partial ....
                          Control Var .... ________      Required, Partial ....
                                                         Optional, Complete ...
                                                         Required, Complete ...

    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit                                                  Let

Anmerkung
Die Trennzeichen-(Delimiter-)Klasse `D` wird nur dann angezeigt, wenn Ihr Terminal bzw. Ihrer Terminal-Emulation die Darstellung von Feldumrahmungen (Box) unterstützt.

Die einzelnen Bereiche des Define Map Settings-Bildschirms werden in den folgenden Abschnitten beschrieben.

- Trennzeichen — "Delimiters"

- Masken-Format-Einstellungen — "Format"

- Kontext-Einstellungen — "Context"

- Füllzeichen — "Filler Characters"

## Trennzeichen — "Delimiters"

Unter der Überschrift Delimiters im Bildschirm Define Map Settings werden die Standard-Trennzeichen angezeigt, die für die aktuelle Maske gelten.

     Delimiters
     -----------------
     Cls Att CD  Del
      T   D      BLANK
      T   I      ?
      A   D      _
      A   I      )
      A   N      ¬
      M   D      &
      M   I      :
      O   D      +
      O   I      (
      D   D      $
      D   I      /

Ein Trennzeichen wird hier verwendet, um einem Feld bestimmte Eigenschaften zuzuweisen: Klasse (Cls, z.B. Ein-/Ausgabefeld), Attribut (Att, z.B. Schriftart) und Farbdefinitionen (CD).

Anmerkung
Die Verwendung von Feldattributen, Feldfarben und Feld-Druck- oder Anzeige-Modi setzt entsprechende Hardware-Merkmale voraus. Sie werden zur Laufzeit ignoriert, wenn diese Merkmale nicht vorhanden sind. Siehe auch die entsprechenden Session-Parameter `AD`, `CD` und `PM` in der Parameter-Referenz-Dokumentation.

Jede Einstellung für eine Feldklasse, ein Attribut oder eine Farbe besteht aus einem ein- oder zweistelligen Buchstabencode. So kennzeichnet zum Beispiel der Buchstabe `A` ein Eingabefeld, der Buchstabe `I` bedeutet "intensiviert" (hell leuchtend). Klasse, Attribut und Farbe können zu einem Trennzeichen (Delimiter) kombiniert werden. Ein Trennzeichen gibt zum Beispiel an, dass ein Feld ein Eingabefeld (Buchstabencode `A`) ist und "intensiviert" (Buchstabencode `I`) dargestellt wird. Im oben abgebildeten Beispiel-Bildschirm ist das Trennzeichen für diese Kombination (Buchstabencodes `A` und `I`) die rechte, runde Klammer `)`.

Ein Trennzeichen ist ein nicht-alphabetisches Zeichen, das dem Feld im Masken-Editierbereich vorangestellt wird. Beispiele für die Verwendung von Trennzeichen siehe Maskenfelder definieren. Um die Klassen-, das Attribut- und Farbeinstellungen, die einem Feld über ein Trennzeichen zugewiesen wurden, anzuzeigen oder zu ändern, müssen Sie die Funktion zur erweiterten Feldbearbeitung benutzen (siehe entsprechenden Abschnitt). Als Trennzeichen kann jedes beliebige nicht-alphabetisches Zeichen verwendet werden. Ausnahmen: das Steuerzeichen für Terminal-Kommandos, das Steuerzeichen für Masken-Kommandos und das Dezimalstellenzeichen.

Buchstabencodes und Trennzeichen können Sie in den SCls (Klasse), Att (Attribut), CD (Farbdefinition) und Del (Delimiter) oder im Editierbereich palten Funktion zur erweiterten Feldbearbeitung eingegeben werden.

Um die Standard-Trennzeichen-Einstellungen für die aktuelle Maske zu ändern:

- Überschreiben Sie im Bereich Delimiters in den Spalten Cls, Att, CD und/oder Del den/die zu ändernde(n) Werte mit dem benötigten Wert bzw. geben Sie in einer leeren Spalte einen Wert ein.

Um die Standard-Trennzeichen-Einstellungen für die aktuelle Editor-Sitzung zu ändern:

- Bevor Sie mit dem Anlegen einer Maske beginnen, ersetzen Sie im Bildschirm Edit Map im Feld Profiles das Standard-Masken-Profil `SYSPROF` durch den Namen des Profils, das Sie zuvor mit der Funktion Maintenance of Profiles & Devices (siehe Profile und Geräte pflegen— Funktion "Maintenance of Profiles & Devices") erstellt haben.

  Anmerkung
  Das Profil `SYSPROF` kann nur der Natural-System-Administrator ändern.

#### Gültige Buchstabencodes für Klassen, Attribute und Farben:

Die folgende Tabelle erläutert die gültigen Buchstabencodes, die in den Spalten Cls (Class), Att (Attribute) und CD oder in den Feldern der Funktion zur erweiterten Feldbearbeitung eingegeben werden können.

Trennzeichen-Klasse (Cls) | Attribut-Definition (Att) | Farbdefinition (CD)
--- | --- | ---
A | Eingabefeld
M | Änderbares Feld
O | Ausgabefeld, geschützt
T | Text-Feld
D | Erweitertes Text-Feld Siehe auch Trennzeichen-Klasse D.
B | blinkend
C | kursiv
D | Standardwert (z.B. nicht intensiviert, blinkend)
I | intensiviert
N | nicht sichtbar
U | unterstrichen
V | invers
Y | dynamisch (Attribute sollen durch ein Programm dynamisch zugewiesen werden)
BL | blau
GR | grün
NE | neutral
PI | rosa
RE | rot
TU | türkis
YE | gelb

### Trennzeichen-Klasse D

Anmerkung
Die Trennzeichen-Klasse `D` gilt nur, wenn Ihr Terminal bzw. Ihre Terminal-Emulation das Anzeigen von Feldumrahmungen gestattet.

Die Trennzeichen-Klasse `D` muss in den Masken-Einstellungen definiert werden, um mit dem Outline Editor Feldumrahmungen für Maskenfelder zu erstellen. Die Trennzeichen-Klasse `D` gestattet die Definition von Umrahmungen bei Text-Feldern und leeren Text-Feldern in einer Maske.

Bei einer bereits existierenden, mit Natural erstellten Maske können Sie die Trennzeichen-Klasse `D` wie im Abschnitt Trennzeichen-Klasse D definieren beschrieben hinzufügen.

#### Erweiterte Text-Felder

Ein Text-Feld, für das Sie eine Umrahmung erstellen möchten, muss mit dem Trennzeichen beginnen, das Sie der Trennzeichen-Klasse D zugewiesen haben. Ein Feld, dem dieses Trennzeichen vorangestellt ist, wird dann als erweitertes Text-Feld behandelt, das mit der Funktion zur erweiterten Feldbearbeitung des Masken-Editors bearbeitet werden kann.

Ein erweitertes Text-Feld, das als natives DBCS-Feld (DBCS = Double Byte Character Set) definiert worden ist, wird durch eine Reihe von Ks im Masken-Editierbereich repräsentiert. Sie auch Beschreibung des PM-Feldes im Abschnitt Felder im erweiterten Text-Feld-Bearbeitungsbereich.

#### Leere Text-Felder

Leerzeichen, bei denen Sie eine Umrahmung (Box) definieren, werden als leeres Text-Feld behandelt. Wenn Sie die Funktionen des Outline Editor benutzen, wird ein leeres Text-Feld automatisch zu der Maske mit dem Trennzeichen, das die Klasse `D` repräsentiert, hinzugefügt. Im Masken-Editierbereich folgt, abhängig von der Länge des Feldes, auf das Trennzeichen ein oder mehrere Punkte (.), wobei jeder Punkt für ein Leerzeichen steht. Ein leeres Feld mit einer Länge größer als Null (0) wird als erweitertes Text-Feld betrachtet, das mit der Funktion zur erweiterten Feldbearbeitung bearbeitet (oder erstellt) werden kann. Siehe entsprechenden Abschnitt.

## Masken-Format-Einstellungen — "Format"

Unter der Überschrift Format im Bildschirm Define Map Settings werden die Masken-Format-Einstellungen angezeigt, die für die aktuelle Maske gelten.

      Format
      ---------------------------
      Page Size ...... 23
      Line Size ...... 79
      Column Shift ... 0 (0/1)
      Layout ......... ________
       dynamic ....... N (Y/N)
      Zero Print ..... N (Y/N)
      Case Default ... UC (UC/LC)
      Manual Skip .... N (Y/N)
      Decimal Char ... .
      Standard Keys .. N (Y/N)
      Justification .. L (L/R)
      Print Mode ..... __

      Control Var .... ________

Folgende Maskenformat-Einstellungen stehen zur Verfügung:

Feld | Erläuterung
--- | ---
Page Size | Die Anzahl der zu bearbeitenden Maskenzeilen (1 - 250); wenn Standard Keys (siehe weiter unten) auf `Y` gesetzt ist, dann ist die Anzahl der Zeilen auf 3 - 250 eingeschränkt. Bei einer Maske, die mit einem `WRITE`-Statement ausgegeben wird, geben Sie die Anzahl der Zeilen für die logische Seitenausgabe beim `WRITE`-Statement an, d.h., nicht die Maskengröße. Auf diese Weise kann die Maske mehrmals auf einer Seite ausgegeben werden.
Line Size | Die Anzahl der zu bearbeitenden Maskenspalten (5 - 249).
Column Shift | Spaltenverschiebung (0 oder 1), die bei der Maske angewendet werden soll. Dieses Merkmal kann benutzt werden, um auf einem Bildschirm mit 80 Spalten alle 80 Spalten anzusprechen (Column Shift = 1, Line Size = 80). Um alle Maskenpositionen zu bearbeiten, müssen Sie Kommandos zum Positionieren (PF10, PF11) benutzen. Das längste Feld, das Sie auf einem Bildschirm der Größe 24 x 80 anzeigen können, darf nicht länger als 79 Zeichen sein. Wenn Sie ein Feld mit 80 Zeichen oder mehr anzeigen möchten, müssen Sie die Zeilenlänge (Line Size) entsprechend anpassen. Beispiel: Um ein Feld mit Format/Länge A80 anzuzeigen, müssen Sie Line Size = 81 setzen.
Layout | Der Name einer Masken-Quellcode-Definition, die ein vordefiniertes Layout enthält.
dynamic |
`Y` | Gibt an, dass das Layout dynamisch sein soll. Das dynamisch verwendete Layout wird nicht bei der Kompilierung zu einem festen Bestandteil der Maske, sondern wird erst zur Laufzeit ausgeführt. Auf diese Weise wird ermöglicht, dass nachträgliche Änderungen am Layout einer Maske bei allen Masken wirksam werden, bei denen die Layout-Maske benutzt wird. Falls die Layout-Maske Benutzervariablen enthält, müssen Sie diese Parameter in der Maske, bei der die Layout-Maske benutzt wird, definieren. Eingabefelder und änderbare Felder in der Layout-Maske sind zur Laufzeit nicht eingabefähig. Zum Hinzufügen von Parametern muss PF9 in der Funktion Field and Variable Definitions gedrückt werden.
`N` | Gibt an, dass das Layout statisch sein soll. Das statische Layout wird in den Quellcode-Bereich kopiert, wenn eine Maske initialisiert wird. Füllzeichen werden nicht mit übertragen. `N` ist die Standard-Einstellung.
Zero Print |
`Y` | Ein Feldwert, der nur aus Nullen besteht, wird nur als eine einzige Null angezeigt.
`N` | Ein Nullwert wird als Leerzeichen angezeigt. `N` ist die Standard-Einstellung.
Dieser Wert wird in die Feld-Definition kopiert, wenn ein neues Feld angelegt wird. Er kann bei einzelnen Feldern mit der Funktion zur erweiterten Feldbearbeitung bearbeitet werden.
Case Default |
`UC` | Gibt an, dass alle bei Feldern zur Ausführungszeit gemachten Eingaben in Großbuchstaben umgesetzt werden sollen, d.h. der Session-Parameter `AD=T` wird als Feld-Standardeinstellung verwendet. Siehe auch AD - Attribut-Definition in der Parameter-Referenz-Dokumentation.
`LC` | Gibt an, dass keine Umsetzung von Klein- in Großbuchstaben erfolgen soll, d.h., der Session-Parameter `AD=W` wird als Feld-Standardeinstellung verwendet. Um den `LC`-Wert wirksam zu machen, müssen Sie den Natural-Profilparameter `LC` auf `ON` setzen. Siehe auch AD - Attribut-Definition und LC - Umsetzung von Klein- in Großbuchstaben in der Parameter-Referenz-Dokumentation.
Wenn ein neues Feld angelegt wird, wird dieser Wert in die Feld-Definition kopiert. Er bei einzelnen Feldern mit der Funktion zur erweiterten Feldbearbeitung geändert werden.
Manual Skip |
`Y` | Der Cursor wird zur Ausführungszeit nicht automatisch in das nächste Feld in der Maske verschoben, und zwar selbst dann nicht, wenn das aktuelle Feld vollständig ausgefüllt ist.
`N` | Der Cursor wird zur Ausführungszeit automatisch in das nächste Feld in der Maske verschoben, wenn das aktuelle Feld vollständig ausgefüllt ist. `N` ist die Standard-Einstellung.
Decimal Char | Das Zeichen, das als Dezimalstellenzeichen verwendet werden soll. Dieses Zeichen kann nur mit dem Kommando `GLOBALS DC='c'` geändert werden, wobei `c` das als Dezimalstellenzeichen zu benutzende Zeichen (Dezimalkomma bzw. Dezimalpunkt) darstellt. Siehe DC - Dezimalstellenzeichen in der Parameter-Referenz-Dokumentation.
Standard Keys |
`Y` | Die letzten beiden Zeilen der Maske werden leer gelassen, damit zur Ausführungszeit Funktionstastenangaben eingegeben werden können.
`N` | Bewirkt, dass alle Zeilen für die Maske genutzt werden können. `N` ist die Standard-Einstellung.
Justification |
Die Art der Ausrichtung, die bei numerischen und alphanumerischen Feldern verwendet werden soll, wenn diese aus den Datendefinitionen in einem anderen Natural-Objekt übernommen werden sollen.
`L` | Linksbündig.
`R` | Rechtsbündig.
Dieser Wert wird beim Anlegen eines neuen Feldes in die Felddefinition kopiert.
Print Mode |
Der Standard-Druck-/Anzeige-Modus für Variablen:
`C` | Gibt an, dass ein alternativer Zeichensatz verwendet werden soll (spezielle, vom Natural-Administrator angelegte Zeichentabelle).
`D` | Gibt an, dass der DBCS-Modus (DBCS = Double Byte Character Set) verwendet werden soll.
`I` | Gibt an, dass invertierte Richtung verwendet werden soll.
`N` | Gibt an, dass keine Hardcopy gemacht werden kann.
Dieser Wert wird beim Anlegen eines neuen Feldes in die Felddefinition kopiert.
Control Var | Der Name einer Attribut-Kontrollvariablen, deren Inhalt die Attribut-Eigenschaften von Feldern und Texten festlegt, die die Attribut-Definition `AD=Y` oder `Y` haben. Die in der Maske referenzierte Attribut-Kontrollvariable muss in dem Programm definiert werden, das diese Maske verwendet. Wenn eine Attribut-Kontrollvariable aus der Format-Masken-Einstellung entfernt wird, hat das zur Folge, dass die Attribut-Kontrollvariable auch aus der Maske entfernt wird, falls sie nicht mit einem anderen Maskenfeld verbunden ist.

## Kontext-Einstellungen — "Context"

Unter der Überschrift Context sind im Bildschirm folgende Kontext-Einstellmöglichkeiten vorhanden:

    Context
    --------------------------
    Device Check .... ________
    WRITE Statement   _
    INPUT Statement   X
    Help  ____________________
     as field default N (Y/N)

    Automatic Rule Rank  1
    Profile Name .... SYSPROF

Folgende Kontext-Einstellmöglichkeiten stehen zur Verfügung:

Feld | Erläuterung
--- | ---
Device Check | Wird in dieses Feld ein Gerätename eingegeben, dann werden die Maskeneinstellungen auf Kompatibilität mit dem Geräte-Profil des angegebenen Geräts geprüft. Falls eine Einstellung nicht kompatibel ist, wird eine Warnmeldung ausgegeben (siehe auch Profile und Geräte pflegen— Funktion "Maintenance of Profiles & Devices" im Abschnitt Funktionen im Menü "Edit Map".
WRITE Statement | Wird dieses Feld mit einem beliebigen Wert (kein Leerzeichen) markiert, dann wird am Ende des Masken-Definitionsvorgangs ein `WRITE`-Statement erzeugt. Die resultierende Maske kann dann mit einem `WRITE USING MAP`-Statement aus einem Natural-Programm heraus aufgerufen werden. Leerzeilen am Ende der Maske werden automatisch gelöscht, damit die Maske auf einer Seite mehrmals ausgegeben werden kann.
INPUT Statement | Wird dieses Feld mit einem beliebigen Wert (kein Leerzeichen) markiert, dann wird am Ende des Masken-Definitionsvorgangs ein `INPUT`-Statement erzeugt. Die resultierende Maske kann dann mit einem `INPUT USING MAP`-Statement aus einem Natural-Programm heraus aufgerufen werden.
Help | Der Name einer Helproutine oder Hilfe-Maske, die zur Ausführungszeit aufgerufen wird, wenn die Masken-Hilfe-Funktion (nicht die Feld-Hilfe) zu dieser Maske aufgerufen wird. Die gültige Syntax für die Eingabe von Werten in das Help-Feld entspricht der Syntax, die beim Session-Parameter `HE` gilt. Weitere Informationen siehe HE-Parameter-Syntax in der Parameter-Referenz-Dokumentation.
as field default |
`Y` | Gibt an, dass die im Help-Feld eingegebene Helproutine oder Hilfe-Maske als Standard-Einstellung bei jedem einzelnen Feld auf der Maske gelten soll, was bedeutet, das der Name eines jeden Feldes individuell an die Helproutine übergeben wird.
`N` | Gibt an, dass der Name der Maske an die Helproutine oder Hilfe-Maske übergeben werden soll. Dies ist die Standard-Einstellung.
Anmerkung Wenn Sie im Bildschirm Define Map Settings die Masken-Einstellungen für eine Hilfe-Maske definieren, werden die Felder Help und as field default durch das Feld Position Line Col ersetzt.
Position Line Col | Die Position, an der die Hilfe-Maske zur Ausführungszeit auf dem Bildschirm erscheinen soll. Dieses Feld erscheint nur dann, wenn Sie Masken-Einstellungen für eine Hilfe-Maske definieren, die mit der Funktion Initialize a new Help Map erstellt wurde. Dieses Feld ersetzt die Felder Help und as field default im Bildschirm Define Map Settings for HELPMAP.
Automatic Rule Rank | Der Rang (Priorität), der automatischen Predict-Regel zugewiesen wird, wenn sie während der Maskenfeld-Definition mit der Maske verknüpft werden. Der Standardwert ist `1`.
Profile Name | Der Name des Profils, das bei der Initialisierung der Maske aktiv war. Falls `ENFORCED` angezeigt wird, dann sind die folgenden Masken-Einstellungen geschützt: Alle Masken-Trennzeichen (Delimiters) Statisches und dynamisches Layout Geräte-Prüfung `WRITE` und `INPUT`-Statements Alle Füllzeichen Automatische Regel-Rangordnung Positionierung von Hilfe-Masken Der Name des Profils, das bei der Initialisierung der Maske aktiv ist, wird im Map-Objekt gespeichert. Wenn ein anderes Profil aktiv ist, wenn die Maske später bearbeitet wird, wird eine Warnmeldung ausgegeben, es wird jedoch eine Bearbeitung gestattet.

## Füllzeichen — "Filler Characters"

Füllzeichen können zugewiesen werden, um anzuzeigen, ob die Informationen bei einem Feld erforderlich sind (Pflichtfeld) und ob das Feld vollständig ausgefüllt werden muss:

    Filler Characters
    ------------------------
    Optional, Partial ....
    Required, Partial ....
    Optional, Complete ...
    Required, Complete ...

Folgende Optionen stehen zur Verfügung:

Feldtyp | Erläuterung
--- | ---
Optional, Partial | Kein Pflichtfeld, Feld braucht nicht vollständig ausgefüllt zu werden.
Required, Partial | Pflichtfeld, Feld braucht nicht vollständig ausgefüllt zu werden. (`AD=E`).
Optional, Complete | Kein Pflichtfeld; falls das Feld ausgefüllt wird, muss es vollständig ausgefüllt werden (`AD=G`).
Required, Complete | Pflichtfeld, Feld muss vollständig ausgefüllt werden (`AD=EG`).

Mit der Funktion zur erweiterten Feldbearbeitung können außerdem Füllzeichen für einzelne Felder definiert werden. Zur Definition von Feldtypen siehe auch Session-Parameter `AD` in der Parameter-Referenz-Dokumentation.

### On this page

- Trennzeichen — "Delimiters"
- Masken-Format-Einstellungen — "Format"
- Kontext-Einstellungen — "Context"
- Füllzeichen — "Filler Characters"