Ansicht
Dokumentation

MAHDA_READ_MAHD_SINGLE - NOTRANSL: Lesen alternative Bedarfszeitreihe für Werk/Material

PERFORM Short Reference   CPI1466 during Backup  
This documentation is copyright by SAP AG.

Functionality

Der Baustein liefert für ein Werk(I_WERKS), Material (I_MATNR) und Periodenkennzeichen (I_PERKZ) und einen gegebenen Zeitraum Alternative Vergangenheitsdaten (AHD) für die Prognose zurück.

Sie können den Zeitraum über die Angabe eines Von- und eines Bis-Datums (I_S_CONTROL-DATAB bzw. I_S_CONTROL-DATBI) oder über die Angabe einer Anzahl von Perioden (I_S_CONTROL-PERAN) in Verbindung mit einem Von- oder einem Bis-Datum spezifizieren. Im zweiten Fall zählt das System die Anzahl gewünschter Perioden entweder vom Von-Datum in die Zukunft oder vom Bis-Datum in die Vergangenheit. Geben Sie nur ein Von-oder Bis-Datum an (ohne Anzahl Perioden), werden ab bzw. bis zu diesem Datum alle vorhandenen Werte gelesen. Geben Sie weder Von- noch Bis-Datum an, liest das System alle vorhandenen Werte.

Über einen Parameter (I_S_CONTROL-RDPER) können Sie steuern, ob das System nur komplett von Von- und Bis-Datum eingeschlossene Perioden oder auch Randperioden, innerhalb derer das Von- oder Bis-Datum liegt, zurück liefern soll. Eine Periode ist auch dann nicht eingeschlossen, wenn das Von-Datum dem ersten Tag einer Periode und das Bis-Datum dem letzten Tag einer Periode entspricht. Bereits voreingestellt ist das Lesen komplett eingeschlossener Perioden.

Der Baustein verfügt über eine Pufferungs-Logik für einmal gelesene Sätze. Über einen Parameter (I_S_CONTROL-BPBUF) können Sie steuern, daß der Puffer beim Lesen umgangen wird und die Sätze direkt von der Datenbank gelesen werden (bypass buffer). Über einen weiteren Parameter (I_S_CONTROL-RFBUF) können Sie steuern, ob das System das Ergebnis des aktuellen Zugriffs in den Puffer schreiben soll und ein evt. vorhandener Pufferinhalt für die Kombination Werk, Material und Periodenkennzeichen durch den aktuellen Zugriff ersetzen soll (refresh buffer). Der Buffer Refresh ist nur möglich, wenn das System mit Bypassing Buffer liest.

Je nach Anwendung kann ein unterschiedlicher Umfang von Daten benötigt werden:

• Korrigierte Werte (E_T_CONSU).

• nur abweichende Originalwerte (E_T_CONSU_OVAL).

• abgemischte Version aus korrigierten und Originalwerten (E_T_CONSU_ALL).

Über einen Parameter (I_S_CONTROL-RETURN) können Sie steuern, welche Werte das System lesen und zurückliefern soll. In der abgemischten Version ist für jede Periode sowohl ein korrigierter als auch ein Originalwert vorhanden. Es besteht auch die Möglichkeit, die alternativen Vergangenheitsdaten im Ausgabeformat des Bausteins VERBRAUCH_LESEN zurückzugeben (E_T_IVERB). In diesem Fall können Sie über einen weiteren Parameter (I_S_CONTROL-PERFOR) das Rückgabeformat der Periode einstellen.

In der Vergangenheitszeitreihe können Lücken (fehlende Perioden) existieren. Über einen Parameter (I_S_CONTROL-FILNUL) können Sie steuern, ob das System solche Lücken in der Rückgabe durch Null-Werte auffüllen soll. Spezifizieren Sie beim Aufruf des Bausteins Von- und/oder Bis-Datum (oder ist eines der beiden implizit durch Angabe eines Eckdatums und der Anzahl Perioden gegeben), füllt das System auch alle nicht-vorhandenen Perioden am Anfang und/oder Ende der Zeitreihe bis zu den spezifizierten Eckperioden durch Null-Werte auf. In der abgemischten Version der Rückgabetabelle werden fehlende Perioden durch ein Kennzeichen kenntlich gemacht.

Es besteht auch die Möglichkeit, daß Sie sich lediglich eine Tabelle der im spezifizierten Zeitraum nicht-vorhandenen Perioden zurückgeben lassen. Dies können Sie über einen Steuerungs-Parameter (I_S_CONTROL-MISPER) einstellen. Allerdings ist dies nur bei Rückgabe der korrigierten Werte (E_T_CONSU) möglich.

Standardmäßig sind die Rückgabetabellen absteigend nach Anfangsdatum der Periode sortiert. Über einen Steuerungs-Parameter (I_S_CONTROL-SRTASC) können Sie einstellen, daß das System die Tabellen aufsteigend nach Anfangsdatum der Periode sortiert.

Example

Notes

Der Baustein prüft die Eingabeparameter Werk und Material nicht. Das Periodenkennzeichen (I_PERKZ) zu Material und Werk, die Geschäftsjahresvariante (I_PERIV) im Fall von Perioden nach Geschäftsjahresvariante und der Fabrikkalender (I_FABKL) zum Werk werden vom Baustein nachgelesen, falls sie nicht in der Schnittstelle übergeben wurden. Andernfalls werden sie ungeprüft übernommen. Falls Ihnen Periodenkennzeichen, Geschäftsjahresvariante und/oder Fabrikkalender bekannt sind, sollten sie aus Performancegründen übergeben werden.

Den schnellsten Lesezugriff erzielen Sie durch die Angabe von Von-Datum und Bis-Datum und Einlesen der Bis-Periode bei Überlappung.

Aus Performancegründen sollten immer nur die Daten angefordert werden, die in der Anwendung tatsächlich benötigt werden (korrigierte Werte, Originalwerte oder abgemischte Version).

Falls innerhalb eines Prozesses für eine Vielzahl von Kombinationen (Werk, Material, Periodenkennzeichen) Daten gelesen werden, sollten diese zunächst über den Baustein WAHDA_SELECT_WAHD_INTO_BUFFER in den Puffer geladen werden (Prefetch). Anschließend können Sie mit dem Baustein WAHDA_READ_WAHD_SINGLE die Daten aus dem Puffer auslesen. Das System merkt sich bei der Pufferung das Von-Datum und das Bis-Datum, mit denen bereits von der Datenbank gelesen wurde. Fordert ein späterer Zugriff über den Baustein WAHDA_READ_WAHD_SINGLE Perioden an, die noch nicht in den Puffer gelesen wurden, liest das System sämtliche angeforderte Perioden von der Datenbank. Über einen Parameter können Sie steuern, ob der bisherige Puffer durch diesen neuen Zugriff ersetzt werden soll.

Further information

DE-EN-LANG-SWITCH-NO-TRANSLATION

Parameters

CH_T_CONSU
CH_T_CONSU_ALL
CH_T_CONSU_OVAL
CH_T_IVERB
I_BERID
I_FABKL
I_MATNR
I_PERIV
I_PERKZ
I_S_CONTROL

Exceptions

INVALID_PERIOD
MISSING_FACTORY_CALENDAR
MISSING_FISCAL_YEAR_VARIANT
MISSING_PERIOD_INDICATOR
NO_HISTORICAL_VALUES
WRONG_BERTY
WRONG_CONTROL_PARAMETER

Function Group

MAHDA

CL_GUI_FRONTEND_SERVICES - Frontend Services   CL_GUI_FRONTEND_SERVICES - Frontend Services  
This documentation is copyright by SAP AG.

Length: 7295 Date: 20240523 Time: 073148     sap01-206 ( 172 ms )