Ansicht
Dokumentation

ABAPAT_EXTRACT - AT EXTRACT

ABAPAT_EXTRACT - AT EXTRACT

Addresses (Business Address Services)   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

AT, Extrakt

Kurzreferenz



LOOP.
  $[AT FIRST.
     ...
   ENDAT.$]
  $[AT field_groupi $[WITH field_groupj$]
     ...
   ENDAT.$]
    $[AT NEW field1.
       ...
     ENDAT.
      $[AT NEW field2.
         ...
       ENDAT.
         $[...$]$]$]
           $[ ... $]
        $[$[$[...$]
        AT END OF field2.
         ...
       ENDAT.$]
     AT END OF field1.
       ...
     ENDAT.$]
  $[AT LAST.
     ...
  ENDAT.$]
ENDLOOP.

Zusätze:

1. ... FIRST

2. ... field_groupi $[WITH field_groupj$]

3. ... ${NEW$}$|${END OF$} fieldi

4. ... LAST

Wirkung

Der Anweisungsblock einer LOOP -Schleife für Extrakte kann Kontrollstrukturen für eine Gruppenstufenverarbeitung enthalten. Die entsprechende Kontrollanweisung lautet AT. Die Anweisungen AT und ENDAT definieren Anweisungsblöcke, die bei Gruppenwechseln ausgeführt werden. Gruppenwechsel zwischen Gruppenstufen ergeben sich aus der Zeilenstruktur und der Verarbeitungsreihenfolge, in der die LOOP-Schleife die Zeilen des Extraktdatenbestands einliest. Innerhalb einiger der Anweisungsblöcke kann auf automatisch erzeugte Datenobjekte sum(field) und cnt(field) zugegriffen werden.

Abgesehen von den speziellen Varianten AT FIRST, AT field_group und AT LAST werden Gruppenstufen mit der Variante AT NEW durch die aufeinanderfolgenden Zeilen des Extrakts definiert, die in einem durch ein Anfangsstück der Zeilen definierten Gruppenschlüssel den gleichen Inhalt haben. Obwohl es syntaktisch möglich ist, AT-Kontrollstrukturen beliebig anzuordnen und auch zu schachteln, wird eine sinnvolle Gruppenstufenverarbeitung in aller Regel nur durch die oben gezeigte Anordnung gezeigt, bei der die Kontrollstrukturen entsprechend der Anordnung der Komponenten im Gruppenschlüssel hintereinander und nicht geschachtelt aufgeführt sind.

Die Anweisungsblöcke innerhalb der AT-ENDAT-Kontrollstrukturen werden ausgeführt, wenn bei der aktuellen Zeile ein entsprechender Gruppenwechsel stattfindet. Anweisungen der LOOP-ENDLOOP-Kontrollstruktur, die nicht innerhalb einer AT-ENDAT-Kontrollstruktur aufgeführt sind, werden bei jedem Schleifendurchgang ausgeführt.

Hinweise

  • In einem häufigen Anwendungsfall ist der Extraktdatenbestand genau nach dem Gruppenschlüssel sortiert.

Zusatz 1

...  FIRST

Wirkung

Die Gruppenstufe wird durch die erste Zeile des Extraktdatenbestands definiert.

Zusatz 2

... field_groupi $[WITH field_groupj$]

Wirkung

Eine Zeile, die mit der Anweisung EXTRACT field_groupi an den Extraktdatenbestand angehängt wurde. Wenn der Zusatz WITH angegeben ist, muss die nächste Zeile durch die Feldgruppe field_groupj definiert sein.

Zusatz 3

... ${NEW$}$|${END OF$} fieldi

Wirkung

Die Gruppenstufe wird durch Anfang bzw. Ende einer Gruppe von Zeilen mit dem gleichen Inhalt in der Komponente fieldi und in den Komponenten links von fieldi definiert. Der Inhalt dieser Komponenten bestimmt den Gruppenschlüssel. Die Komponente field muss Teil der Feldgruppe header sein. Komponenten, deren Inhalt hexadezimal 0 ist, werden nicht als Gruppenwechselkriterium berücksichtigt.

Für fieldi kann auch ein Feldsymbol angegeben werden. Falls dem Feldsymbol bei Ausführung der Anweisung eine Komponente der Feldgruppe header zugewiesen ist, wirkt es wie die Angabe der entsprechenden Komponente. Falls dem Feldsymbol kein Datenobjekt zugewiesen ist, wird die Angabe ignoriert. Ist dem Feldsymbol ein anderes Datenobjekt zugewiesen, kommt es zu einer unbehandelbaren Ausnahme.

Zusatz 4

... LAST

Wirkung

Die Gruppenstufe wird durch die letzte Zeile des Extraktdatenbestands definiert.

Extrakte, Verarbeitung






Fill RESBD Structure from EBP Component Structure   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 7060 Date: 20240425 Time: 150009     sap01-206 ( 62 ms )