Ansicht
Dokumentation

SERIALNUMBER_SELECT - Allgemeine Selektion von Serialnummern

ABAP Short Reference   Vendor Master (General Section)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Dieser Funktionsbaustein liefert eine Liste von Serialnummern.

Die Schnittstelle des Bausteins besteht aus drei internen Tabellen:
1) ITAB_TARGET: Zieltabelle für die Selektion (mit Struktur RIHEQUI),
2) ITAB_MRANGE: Bedingungen für die Selektion (=> WHERE-Klausel),
3) ITAB_ROWS: Gewünschte Spalten aus der(n) zu lesenden DB-Tabelle(n).

In der ITAB_ROWS gibt man an, welche Felder (ITAB_ROWS-FNAME) aus der
RIHEQUI selektiert werden sollen; es werden also nur diejenigen Felder
selektiert, die auch benötigt werden.
Die ITAB_MRANGE kann man als feldübergreifende RANGE-Tabelle auffassen
sie ist also nichts anderes als eine Aneinanderreihung einzelner RANGE
Tabellen, wobei jeder Satz die zusetzliche Information enthält, auf
welches Feld sich die jeweilige Bedingung bezieht.
Die ITAB_TARGET schliesslich ist die Zieltabelle; sie enthält das
Ergebnis der Selektion.

In der ITAB_ROWS werden drei Arten von Feldern unterschieden:
a) Stammdatenfelder, die in der Tabelle EQUI vorhanden sind; diese sind
(in ITAB_ROWS-TNAME) mit 'EQUI' zu kennzeichnen,
b) Sonstige Felder, die in der Equipment-View (V_EQUI) vorhanden sind;
diese sind mit 'V_EQUI' zu kennzeichnen,
c) Felder, die aus anderen Tabellen nachgelesen werden; diese Felder
sind mit 'RIHEQUI' zu kennzeichnen.

Nicht gekennzeichnete Felder werden der ersten Gruppe zugeordnet.
Während die Felder der Gruppe a) für alle Serialnummern relevant sind,
sind diejenigen der Gruppe b) nur für Serialnummern relevant, die als
volles Equipment vorliegen.
Gibt man kein Feld der ersten Gruppe an, werden ALLE Felder der Tabelle
EQUI selektiert.
Gibt man kein Feld der zweiten Gruppe an, werden ALLE weiteren Felder
der Equipment-View selektiert.
Gibt man kein Feld der dritten Gruppe an, wird KEINE zusätzliche
Selektion auf andere Tabellen durchgeführt.
Insbesondere gilt, daß bei leerer ITAB_ROWS eine ganz normale Selektion
der Equipment-View (ohne zusätzliche Selektion) erfolgt.

Im Fehlerfall generiert der Baustein die Ausnahmebedingung ERR_SELECT;
folgende Ursachen koennen vorliegen (Nachrichtenklasse IS):
500 Konvertierungsfehler: Feld & ist unbekannt
501 Konvertierungsfehler bei Feld &: Inhalt & ist ungültig
502 Konvertierungsfehler bei Feld &: & ist kein gültiges Datum
503 Zur angegebenen Partnernummer existieren keine Objekte
504 Zu den angegebenen Kriterien wurden keine Objekte selektiert
505 Für keines der selektierten Objekte ist eine Berechtigung vorhanden

Beispiel

report sn-sel.

data: begin of itab_target occurs 5.
include structure rihequi.
data: end of itab_target.
data: begin of itab_mrange occurs 5.
include structure multirange.
data: end of itab_mrange.
data: begin of itab_rows occurs 5.
include structure tablefield.
data: end of itab_rows.

* Selektionsbedingungen: Zeige alle Serialnummern zum Partner 971, die
* zwischen dem 23.07. und 31.08.1996 angelegt wurden.
itab_mrange-sign = 'I'.

itab_mrange-option = 'EQ'.
itab_mrange-fname = 'PARNR'.
itab_mrange-low = '00000971'.
append itab_mrange.

itab_mrange-option = 'BT'.
itab_mrange-fname = 'ERDAT'.
itab_mrange-low = '19960723'.
itab_mrange-high = '19960831'.
append itab_mrange.

* Zu selektierende Spalten (alle aus der EQUI)
itab_rows-tname = 'EQUI'.

itab_rows-fname = 'EQUNR'.
append itab_rows.
itab_rows-fname = 'ERNAM'.
append itab_rows.
itab_rows-fname = 'MATNR'.
append itab_rows.
itab_rows-fname = 'SERNR'.
append itab_rows.

* Aufruf des Selektions-Bausteins:
call function 'SERIALNUMBER_SELECT'
tables
itab_target = itab_target
itab_mrange = itab_mrange
itab_rows = itab_rows
exceptions
others = 1.

* Auswertung des Selektionsergebnisses...

Hinweise

Analog aufgebaute Funktionsbausteine sind z.B.:
1) EQUIPMENT_SELECT : Selektion von (vollen) Equipments,
2) NOTIFICATION_SELECT: Selektion von (IH-, Service-)Meldungen,
3) FUNCLOC_SELECT : Selektion von Technischen Plätzen.

Parameter

ITAB_MRANGE
ITAB_ROWS
ITAB_TARGET

Ausnahmen

ERR_SELECT

Funktionsgruppe

IBEQ

CL_GUI_FRONTEND_SERVICES - Frontend Services   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4867 Date: 20240523 Time: 113501     sap01-206 ( 30 ms )