Ansicht
Dokumentation

/LIME/QUERY_STOCK - Bottom Up Query für Stock Items

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

Funktionalität

Dieser Funktionsbaustein dient zur Abfrage von Beständen und Serialnummern in LIME. Durch die eingegebenen Parameter kann der Suchbereich der Query spezifiziert werden.

Zur Suchabfrage mit dem Funktionsbaustein /LIME/QUERY_STOCK muss mindestens ein Material angegeben sein. Darüber hinaus muss eine der folgenden Angaben gemacht werden:

• Das Kennzeichen I_TOP_LEVEL ist gesetzt.

In diesem Fall wird nach Beständen des angegebenen Materials/Produkts auf allen Lokationen und HUs gesucht.

• Eine oder mehrere Lokationen und/oder eine oder mehrere Handling Units (HU) sind angegeben.

In diesem Fall wird nach Beständen des angegebenen Materials/Produkts nur in den angegebenen Lokationen und/oder HUs gesucht.

Zu beachten ist, dass bei gleichzeitiger Angabe von mehreren Lokationen oder HUs die Vereinigungsmenge der Bestände gesucht wird, die sich an den angegebenen Lokationen/HUs befinden, und nicht die Schnittmenge.

Als Ergebnis liefert der Funktionsbaustein Bestände für die angegebenen Materialien sowie Informationen zur Hierarchie der Lokationen bzw. HUs, die Bestände enthalten. Die Ergebnismenge kann mit den Parametern I_MAX_HITS, I_CUSTODIAN_ROLE, I_CUSTODIAN_ROLE und I_VSI weiter eingeschränkt werden. Ausserdem kann über die Eingabestruktur IS_USID eine Einschränkung der Bestände auf bestimmte Serialnummern durchgeführt werden.

Falls bei der Abfrage Fehler auftreten (E_RC_SEVERITY <> 'S'), werden diese im Parameter ET_BAPIRET zurückgegeben. Falls die Abfrage kein Ergebnis liefert, wird eine entsprechende Informationsmeldung ausgegeben.

Eingabeparameter
IS_STOCK	Festlegung des Stocks (Material / Produkt)
IS_HU	Einschränkung auf eine oder mehrere Handling Units
IS_LOC	Einschränkung auf eine oder mehrere Lokationen
IS_USID	Einschränkung auf Serialnummern
I_MAX_HITS	Einschränkung der maximalen Anzahl Treffer der Query bzw. Datensätze des Ergebnisses
I_ CUSTODIAN	Einschränkung des Besitzers (Custodian) einer Lokation bzw. HU, z.B. Betreiber eines Lagers
I_CUSTODIAN_ROLE	Einschränkung der Rolle des Besitzers (Partnerrolle, z.B. Kunde oder Geschäftspartner)
I_VSI	Einschränkung der Suche auf Bestände mit vorgegebenem virtuellem Bestandsindikator (Virtual Stock Indicator, VSI)
I_TOP_LEVEL	Suche über alle Lokationen ausgehend von der höchsten Hierarchieebene

Ausgabeparameter
ET_LOC	Tabelle mit den betriebswirtschaftlichen Schlüsseln der gefundenen Lokationen, z.B. Werk und Lagerort
ET_HU	Tabelle mit den betriebswirtschaftlichen Schlüsseln der gefundenen HUs, bspw. z.B. SSCC (Serial Shipping Container Code) (NVE, Nummer Versandeinheit))
ET_STOCK	Tabelle mit den betriebswirtschaftlichen Schlüsseln der gefundenen Stock items, z.B. Materialnummer
ET_QUAN	Tabelle mit den gefundenen Beständen, jeweils mit Menge und Einheit sowie GUID des Materials und der Lokation bzw. HU, in der sich der Bestand befindet (direkter Vaterknoten in der Hierarchie)
ET_RESULT	Informationen zur Hierarchie der Ergebnismenge in Baumstruktur ohne Zwischenknoten (GUID der Knoten und Level/Hierarchiestufe)
ET_TREE	Informationen zur Hierarchie der Ergebnismenge in Baumstruktur ohne Zwischenknoten (GUID der Knoten und Level/Hierarchiestufe)
ET_LIST	Informationen zur Hierarchie der Ergebnismenge in Listenstruktur. Diese Tabelle ist z.B. nützlich bei Bildschirmausgaben
ET_USID	Tabelle mit den gefundenen Serialnummern
ET_SERIAL	Zuordnung der gefundenen Serialnummern zu Beständen
E_RC_SEVERITY	Hat im Erfolgsfall den Wert 'S', sonst die Fehlerschwere / Fehlertyp ('E' Error, 'W' Warning, 'I' Info, 'A' Abort)
ET_BAPIRET	Enthält Fehlermeldungen, die bei der Ausführung der Query aufgetreten sind

Beschreibung der Komponenten der Eingabeparameter

Die Strukturen IS_STOCK, IS_HU, IS_LOC, IS_USID haben jeweils die folgenden Komponenten:

IDX
In diesem Feld muss ein Index angegeben werden, der den Typ der Lokation, der HU, des Materials oder der Seriennummer spezifiziert (z.B. für Lokation IDX = "001", falls Werk und Lagerort als betriebswirtschaftliche Schlüssel verwendet werden).

T_BIZ
In dieser Tabelle können ein oder mehrere betriebswirtschaftliche Schlüssel für Lokationen, HUs und Materialien angegeben werden, nach denen exakt gesucht wird.

S_OPTION_BIZ
Die Komponenten dieser Struktur können für Lokationen, HUs und Materialien in Kombination mit einem oder mehreren betriebswirtschaftlichen Schlüsseln in T_BIZ als OPTION-Parameter angegeben werden (Werte "EQ" = Gleichheit (equal), "GT" = Größer als (greater than) etc.). Die Parameter beziehen sich jeweils auf ein Feld des betriebswirtschaftlichen Schlüssels in T_BIZ.
Falls kein OPTION-Parameter angegeben wird, wird exakt nach den in T_BIZ angegebenen Schlüsseln gesucht. Ist mindestens ein Parameter gesetzt, werden für die entsprechenden Spalten die jeweiligen Vergleichsoperationen durchgeführt, nicht angegebene Spalten dürfen beliebige Werte haben.
Beispiel:
Wird für ein Material in T_BIZ im Feld MATNR "S1" und in S_OPTION_BIZ der Wert für OP_MATNR "EQ" angegeben, wird die Suche für alle Materialien durchgeführt, die den Wert "S1" als Materialnummer und beliebige andere Werte z.B. für die Charge haben.

S_RANGE
Mit dieser Struktur können für Lokationen, HUs und Materialien Bereiche angegeben werden, in denen gesucht wird.
Falls z.B. nach Beständen gesucht werden soll, die im Werk "Loc1" entweder am Lagerort "0001" oder "0002" liegen, kann man die Query aufrufen, indem man in IS_LOC-R_WERKS die Werte SIGN = "I", OPTION = "EQ", LOW = "Loc1" eingibt und in IS_LOC-R_LGORT die Werte SIGN = "I", OPTION = "BT", LOW = "0001", HIGH = "0002".

T_GUID
In dieser Tabelle können für Lokationen, HUs und Materialien interne Schlüssel (GUIDs) angegeben werden, falls diese z.B. aus früheren Abfragen bekannt sind.

Beispiel

Gegeben sei eine Lokation "Loc1" und eine Handling Unit "HU1" in der Lokation "Loc1". Ein Bestand von Material "S1" befindet sich direkt in der Lokation "Loc1" (4 Stück) und ein Bestand in "HU1" (1 Stück).
Bei einem Aufruf der Query mit IS_STOCK "S1", IS_LOC "Loc1" erhält man folgendes Ergebnis:

• ET_LOC enthält eine Zeile mit dem betriebswirtschaftlichen Schlüssel "Loc1" und der internen GUID der Lokation.

• ET_HU enthält eine Zeile mit dem betriebswirtschaftlichen Schlüssel "HU1" und der internen GUID der HU.

• ET_STOCK enthält eine Zeile mit dem betriebswirtschaftlichen Schlüssel "S1" und der internen GUID des Materials.

• ET_QUAN enthält zwei Zeilen, Bestand 4 Stück in "Loc1" und 1 Stück in "HU1". In dieser Tabelle werden die internen GUIDs als Schlüssel für Lokation, HU und Material verwendet.
  Daraus können mit Hilfe der Tabellen ET_LOC, ET_HU und ET_STOCK die betriebswirtschaftlichen Schlüssel ermittelt werden. Zu jedem Bestand wird der direkte Vaterknoten (HU oder Lokation) angegeben, in der sich der Bestand befindet.

• ET_TREE enthält drei Zeilen. Für jeden Bestand wird pro Vaterknoten in der Hierarchie bis zur obersten Ebene jeweils eine Zeile eingefügt. Jede Zeile hat die Form "Bestand", "Vaterknoten", "Hierarchiestufe" (level). In diesem Beispiel enthält ET_TREE die Zeilen S1 - H1 - lvl = 1; S1 - Loc1 - lvl = 2 und S1 - Loc1 - lvl = 1. Dabei werden ebenfalls die internen GUIDs für Bestand und Vaterknoten verwendet.

• ET_RESULT enthält zwei Zeilen. Die Tabelle ist gleich wie ET_TREE, nur der Eintrag S1 - H1 lvl = 1 fehlt. Dabei werden ebenfalls die internen GUIDs für Bestand und Vaterknoten verwendet.

• ET_LIST enthält Informationen zur Hierarchie der Ergebnismenge in Listenform. In diesem Beispiel enthält ET_LIST die vier Zeilen Loc1 - lvl = 1; S1 - lvl = 2; HU1 - lvl = 2 und S1 - lvl = 3. Dabei werden die internen GUIDs der Einträge verwendet.

Alle anderen Variablen sind bei diesem Aufruf der Query leer.

Hinweise

Weiterführende Informationen

Parameter

ET_BAPIRET
ET_HU
ET_LIST
ET_LOC
ET_QUAN
ET_RESULT
ET_SERIAL
ET_STOCK
ET_TREE
ET_USID
E_RC_SEVERITY
IS_HU
IS_LOC
IS_STOCK
IS_USID
I_CUSTODIAN
I_CUSTODIAN_ROLE
I_FLAT_HIERARCHY_WITHOUT_HU
I_MAX_HITS
I_TOP_LEVEL
I_VSI

Ausnahmen

Funktionsgruppe

E/SAPLRFC_QUERY

CPI1466 during Backup   General Data in Customer Master  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 12110 Date: 20240425 Time: 111740     sap01-206 ( 171 ms )