Ansicht
Dokumentation

         ...

       />END

• Die Klammerungszeilen dürfen keine führenden Blanks und keinen weiteren Text oder Kommentar haben.
  

• 'END' ist ein reservierter Name und kann nicht als Schemaname verwendet werden.
  

• Die Länge des Schemanamens ist bestimmt durch das Datenelement SCHEMENAME, z.Z. 30-stellig.

Variablen

In einem Schema können globale Variablen vom Typ C oder string (und nur die!) des aufrufenden Programms referenziert werden. Variablen im Schema werden mit '&' begrenzt:

           &varname&

Für eine Variable wird ihr Wert substituiert, wobei trailing blanks abgeschnitten werden, während führende blanks erhalten bleiben (wie bei dem ABAP-Befehl CONCATENATE).

• Wird dem Variablennamen ein '-' vorangestellt, so wird der Wert der Variable mit lower case Konvertierung instantiiert.
  Beispiel:

           data: VAR(4) value ' cD '. "im aufrufenden Programm

          'ab&VAR&ef'  -> 'ab cDef'

          'ab&-VAR&ef' -> 'ab cdef'

Kontrollstrukturen

In Schemata können Bedingungen, Schleifen und Subschema-Aufrufe definiert werden. Eine Kontrollstruktur hat die Form:

         {x$control$ ... $ ....  ....  }

wobei x angibt, um welche Kontrollstruktur es sich handelt und die einzelnen Bestandteile der Kontrollstruktur durch das Separatorzeichen '$' getrennt sind. 'Control' ist der kontrollierende Ausdruck.

Die Anzahl der Bestandteile hängt von der jeweiligen Kontrollstruktur ab - sie muß aber strikt eingehalten werden, auch wenn bestimmte Teile leer sind. Ansonsten ist die Syntax des Schemas fehlerhaft.

• Bei der Instantiierung werden die steuernden Elemente ausgewertet, produzieren aber keinerlei Ausgabe, auch keine Blanks.
  

• Innerhalb von '{x$control$' darf kein Zeilenvorschub erfolgen.

Conditional

Ein Conditional hat die Form:

           {C$condition$then$else}

'Condition' kann eine einfache Variable sein. Dies hat die Bedeutung von 'not(variable is initial)'. Der 'then'-Teil wird instantiiert, wenn die Variable nicht initial ist; ansonsten der 'else'-Teil.

Beispiel:

           {C$sy-subrc$error$ok} -> 'error', falls sy-subrc <> 0
                                 -> 'ok'   , falls sy-subrc = 0

'Condition' kann auch ein einfacher Ausdruck der Form 'a op b' sein, wobei 'a' eine Variable und 'b' eine Variable, ein String oder eine integer ist. 'Op' muß eine höchstens zweistellige ABAP-Operation sein, z.B. =, <, LE, CA, ... . Vor und nach 'op' muß ein Blank stehen.

Beispiel:

           data: a value 'D', b value 'D'.
           {C$a = b   $eq$neq}      -> 'eq'
           {C$a &lt;&gt; 'D'$neq D $eq D} -> 'eq D'

• Mit diesem Konstrukt läßt sich auch 'if ... elseif ...' abbilden:

           {C$sy-subrc = 0$ok${C$sy-subrc = 4$warning$error}}

• Sowohl 'then' als auch 'else'-Teile können leer sein. Es müssen aber auf jeden Fall alle Separatoren angegeben sein:

           {C$condition$then$} bzw. {C$condition$$else}.

Table Loop

Eine Table Loop hat die Form:

          {T$table$pre1$pre$main$post$postn} oder

          {T$table WHERE condexpr$pre1$pre$main$post$postn}

Dabei ist 'table' der Name einer internen Tabelle des aufrufenden Programms. Diese Tabelle muß dort global sein und eine Kopfzeile haben.

'Condexpr' ist ein einfacher Ausdruck der Form 'f op b', wobei f der Name eines Feldes von 'table' ist und 'op' und 'b' wie bei bei Conditional beschrieben sind.

Es wird über diese Tabelle geloopt und folgende Ausgabe produziert:

           'pre1mainpost'  für die 1.Zeile
           'premainpost'   für die 2. - (n-1). Zeile
           'premainpostn'  für die n. Zeile

Beispiel:

          {T$fieldtab$DATA: $
                $fieldtab-fieldname like ... $,$.}
      ->  DATA: field1 like ... ,
                field2 like ... ,
                field3 like ... .

Sollen nur die Schlüsselfelder berücksichtigt werden, so könnte die Table Loop wie folgt aussehen

            {T$fieldtab WHERE key = 'X'$DATA: $ ...  }

• Achtung: Die Nicht-Existenz der Tabelle im aufrufenden Programm führt zu der Ausnahme 'TABLE_NOT_EXISTS'.
  

• Hat die Tabelle keinen (passenden) Eintrag, so ist das Ergebnis des Table Loops leer.
  

• Hat die Tabelle genau einen (passenden) Eintrag, so ist das Ergebnis: 'pre1mainpostn'.
  

• In den Teilen pre1, pre, post, postn können auch Variablen und sogar Kontrollstrukturen benutzt werden. In allen Teilen haben die Variablen die Werte des aktuellen Schleifendurchlaufs. Die Verwendung von Variablen oder Kontrollstrukturen in post kostet allerdings etwa 20% Performance.

Function Loop

Eine Function Loop hat die Form:

          {F$function$pre1$pre$main$post$postn}

Dabei ist 'function' eine im aufrufenden Programm definierte Form mit einem Parameter 'CHANGING TYPE I'. Diese Form setzt in jedem Durchlauf die im Schema verwendeten Variablen neu.

Die Form wird zunächst mit = 1 aufgerufen. Bei jedem weiteren Aufruf wird um 1 erhöht. Die Form selbst kann intern ebenfalls erhöhen und so zurückgeben. Die Schleife wird beendet, wenn die Form = 0 zurückgibt.

• Die Anmerkungen bei table loop gelten analog für function loop.
  

• Function loop kann z.B. benutzt werden, wenn selektiv nur für bestimmte Einträge einer Tabelle Ausgabe produziert werden soll:

       form next_entry changing idx type i.
         loop at tab from idx where .... .   " start search from idx
           idx = sy-tabix.    " set idx to found entry
           exit.              " at next call idx is incremented by 1
         endloop.
         if sy-subrc &lt;&gt; 0.
           idx = 0.           " no entry found, set idx=0 to end loop
         endif.
       endform.

• Ohne Selektion auf der Tabelle ist die Table Loop zu bervorzugen, da nur etwa 60% der Laufzeit der Function Loop benötigt wird.

Subscheme Call

Ein Subscheme Call hat die Form:

          {S$scheme}

Dabei ist 'scheme' der Name eines Schemas im gleichen Schemaprogramm. An der Stelle, an der der Subscheme Call steht, wird das angegebene Schema instantiiert.

Dabei wird das instantiierte Subschema so weit eingerückt, wie der Aufruf selbst. Beginnt eine Zeile des Subschemas mit dem Kommentarzeichen '*', so bleibt dies an erster Zeilenposition.

Beginnt die Zeile des Subschema-Aufrufs mit '*', so beginnen alle Zeilen des instantiierten Subschemas ebenfalls mit '*'.

Beispiele: siehe Schemaprogramm SCHEME_SAMPLE, das mit dem Report SCHEME_TEST zu instantiieren ist.

Weitere Features

Kommentare

Da Schemata geklammert sind, können Zeilen zwischen den Schemata als Kommentar benutzt werden.

Innerhalb eines Schemas können Kommentarzeilen eingestreut werden, die mit '*:' beginnen müssen. Sonstige mit '*' beginnende Zeilen werden normal instantiiert, um auch ABAP-Kommentare ins Ergebnis generieren zu können.

Kommentare am Zeilenende beginnen mit '":'. Der Rest der Zeile wird dann nicht in die Instantiierung übernommen.

Groß-/Kleinschreibung

Da der ABAP-Editor eine upper case Konvertierung vornimmt, ist die Möglichkeit vorgesehen, dies zu umgehen. Dazu muß die Zeile mit '"%' beginnen. Für den ABAP-Editor ist dies Kommentar und die Kleinschreibung bleibt erhalten. Der Schema-Instantiierer überliest diese Zeichen.

Wird ein Editor ohne Konvertierung benutzt (ab 4.6A), so ist diese Kennzeichnung nicht mehr notwendig.

Fortsetzungszeile und Einrückung

Um mehrere Zeilen eines Schemas auf eine Instantiierungszeile abzubilden, sind die Schemazeilen mit dem Zeichen '\' abzuschließen. Damit entfällt der folgende Zeilenvorschub in der Instantiierung der Schemazeile.

• Dies wird benötigt, wenn durch Kontrollstrukturen oder lange Variablennamen das Schema für eine instantiierte Zeile nicht auf eine Schemazeile paßt.

Um das Schema leserlicher zu gestalten, gibt es auch die Möglichkeit, Zeilen einzurücken, ohne daß die Einrückung in das Ergebnis übernommen wird. Dazu beginnt man die Zeile nach der Einrückung mit '\'.

• Dies ist insbesondere nützlich um Fortsetzungszeilen einzurücken.

Beispiel:

          "%       This is a long text over several \
          "%       \lines which is idented in the scheme.

Fluchtsymbol

Das Zeichen '#' dient als Fluchtsymbol und maskiert die Bedeutung der Zeichen '{}$&#&'

Beispiel:

          control: #{x#$...#}. Variable: #&var#&'. Escape: ##.'

       -> 'control: {x$...}. Variable: &var&. Escape: #.'

• Ansonsten wird '#' in Schemazeilen einfach überlesen.
  

• Die Bedeutung anderer Zeichen wird nicht maskiert. Insbesondere dürfen Zeichen, die am Zeilenanfang stehen müssen, nicht durch das Fluchtsymbol von dieser Position verdrängt werden.

Kommentarzeichen der Zielsprache

Dieses einstellbare Zeichen, mit Default '*' für die Generierung von ABAP-Programmen, wird sonderbehandelt bei der Einrückung von Subschemata und beim automatischen Zeilenumbruch.

Falls eine Subschema-Zeile mit diesem Zeichen beginnt, bleibt es auch bei Einrückung an 1. Stelle stehen - die Einrückung findet hinter diesem Zeichen statt.

Muß eine instantiierte Zeile umgebrochen werden und hat diese Zeile das Kommentarzeichen an 1. Position, so haben auch die Folgezeilen dieses Zeichen an 1. Stelle.

Automatischer Zeilenumbruch

Wird eine instantiierte Zeile zu lang, so wird ein automatischer Zeilenumbruch gemacht, so daß die Zeilen in RESULT_TAB passen.

Ein Umbruch findet statt bei space oder, wenn dies nicht möglich ist, vor '({[' oder nach ',.)]}'. Dabei wird space durch linefeed ersetzt, bei den anderen Zeichen wird linefeed davor bzw. danach eingefügt.

Beispiel:

          {t$fieldtab$DATA:$$ fieldtab-fieldname like ... $,$.}

       -> DATA: field1 like ... , field2 like ... , ... ,

          field5 like ... , ...

• Alle Folgezeilen werden so weit eingerückt wie die Originalzeile.
  

• Ist die Originalzeile eine Kommentarzeile, so sind auch alle Folgezeilen Kommentarzeilen.
  

• Fehlerfall: Kann die Zeile nicht an den angegebenen Zeichen umgebrochen werden und ist die Zeile keine Kommentarzeile, so wird die Ausnahme FORCED_LINESPLIT gesetzt. Die Instantiierung wird aber auf jeden Fall vollständig durchgeführt und in RESULT_TAB zurückgegeben.
  

• Eine instantiierte Zeile darf vor dem Umbruch bis zu 8000 Zeichen lang werden (Feld SCINSTLINE-TEXT).

Steuerzeichen

Hier der Überblick über die Default-Steuerzeichen für Schemata

   Zeichen   Bedeutung                          Länge   Anmerkung

      #    Fluchtsymbol                           1        3

      />   Schemadefinition-Anfang                2        1