consolut - CL_APL_ECATT_PARAMS - Parameterdefinition für Testdaten

CL_APL_ECATT_PARAMS - Parameterdefinition für Testdaten

PERFORM Short Reference ROGBILLS - Synchronize billing plans
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Allgemeines

Objekte des Objekttyps CL_APL_ECATT_PARAMS enthalten Listen von eCATT-Parametern mit deren Definitionen und Werten.

Die Definition eines eCATT-Parameters bestimmt u.a. seinen Referenztyp. Erlaubt sind Bezüge aufinterne ABAP-Typen sowie auf Strukturen, Datenelemente und Tabellen, die im ABAP-Dictionary eines R/3-Systemsdefiniert. sind. Damit können Parameter auch tief strukturiert sein, d.h. sie können mehrere Teilkomponenten enthalten.

Jeder definierte Parameter hält einen Defaultwert.

Desweiteren können Varianten von Parametern definiert werden. Jeder Parameter enthält in jeder seiner Varianten einen Parameterwert.

Instanzierung

Objekte des Typs CL_APL_ECATT_PARAMS existieren üblicherweise als Teile von anderen eCATT-Objektenund werden mit diesen auf die Datenbank gespeichert bzw. davon gelesen. D.h. wenn ein Objekt vom TypCL_APL_ECATT_MODULE oder CL_APL_ECATT_TEST_DATA existiert, sollte auch dessen Attribut PARAMS instanziert sein. Der Zugriff auf die Methode GET_PARAM_DEF würde dann z.B. wie folgt erfolgen:

,,DATA: my_ecatt TYPE REF TO CL_APL_ECATT_MODULE,

,, tmp_var TYPE REF TO CL_APL_ECATT_OBJECT.

,,...

,,CALL METHOD CL_APL_ECATT_MODULE=>SHOW_OBJECT

,,,,,,,,EXPORTING ...

,,,,,,,,IMPORTING tmp_var.

,,my_ecatt ?= tmp_var.

,,CALL METHOD my_ecatt->params->GET_PARAM_DEF

,,,,,,,,EXPORTING ...

,,,,,,,,IMPORTING ... .

Strukturierte Parameter

Die Ablage strukturierter Parameter erfolgt in XML-Dateien.

Ein Parameter wird in seiner Struktur durch einen Bezug auf ein im ABAP-Dictionary definiertes Objektdefiniert. Diese Struktur wird in einer XML-Schema-Datei abgebildet und bezüglich der eCATT-Parameterdefinitionabgespeichert. Entsprechend werden die Werte der Varianten derartiger Parameter in XML-Daten-Dateien abgelegt.

Ein initiales XML-Template zur Pflege der XML-Daten-Datei kann aus der XML-Schema-Datei erstellt werden.

Das XML-Schema eines Parameters wird bei Aufruf aller SET_PARAM_DEF-Methoden implizit erstellt.

Eine XML-Daten-Datei wird beim ersten GET_PARAM_VALUE-Zugriff erstellt.

Sowohl XML-Schema- als auch XML-Daten-Datei werden in eCATT-Tabellen persistent abgelegt. Diese Vorgehensweisegreift dem späteren Zugriff auf DDIC-Informationen von Remote Systemen vor. In dieser Situationkann später bei Verbindungsausfall zum Remote System die persistente Information anstatt der aktuellen Information aus dem Remote System verwendet werden.

Öffentliche Methoden

CONSTRUCTOR

Parameterbearbeitung

GET_PARAM_DEF	Selektiver Lesezugriff auf eine
EINZELNE Parameterdefinition
GET_PARAM_VALUE	Selektiver Lesezugriff auf einen
EINZELNEN Parameterwert


GET_PARAMS_DEF	Selektiver Lesezugriff auf MEHRERE
Parameterdefinitionen in einem Aufruf
GET_PARAMS_VALUES	Selektiver Lesezugriff auf MEHRERE
Parameterwerte in einem Aufruf


GET_PARAMS	Lesezugriff auf ALLE
Parameter (Definition + DefaultValue) in einem Aufruf


SET_PARAM_DEF	Schreibzugriff für mehrere
Parameterdefinitionen
SET_PARAM_VALUE	Schreibzugriff für mehrere
Parameterinhalte (DefaultValue+Varianten)


SET_PARAMS	Schreibzugriff für mehrere
Parameter(Definition+DefaultValue)


PARAM_EXISTS	Existenzprüfung für Parameter

CHECK_DATA	Prüfen der Parameter, Lesen aller
Referenztypen, Texte, ...

CHECK_PARAM_NAMES	Parameternamen auf Korrektheit prüfen

DELETE_ALL_PARAMETERS	Alle Parameter löschen (nicht auf DB)
DELETE_PARAMETER	Einzelnen Parameter löschen (nicht auf DB)


Variantenpflege

! ! ! Variantenbearbeitung wird noch geändert / erweitert ! ! !


ADD_VARIANT	Variante anlegen
REMOVE_VARIANT	Variante löschen
RENAME_VARIANT	Variante umbenennen
VARIANT_EXISTS	Variantenexistenz prüfen

Objektbearbeitung Parameterobjekt

DELETE	Parameterdefinitionen und Werte auf DB
löschen
READ	Lesen von DB
SAVE	Speichern in DB

Geschützte Methoden


SET_PARAM_XML_DATA	Generiert XML-Datenobjekt,
(von READ_XML_DATA intern verwendet)
SET_PARAM_DEF_INTERNAL	Setzen von Parameterdefinitionen INTERN
SET_PARAM_XML_SCHEME	Instanz von CL_APL_ECATT_XML_SCHEME
aktualisieren

CREATE_VARIANT	Variante anlegen

GET_PARAM_XML_DATA	Get für Werte strukturierter Parameter
GET_PINDEX	Liest Wert des Feldes PINDEX aus
Parameterdefinition

READ_XML_DATA	Lesen der XML-Daten zu strukturierten
Parametern von DB
READ_XML_SCHEMES	Lesen der XML-Schemata zu strukturierten
Parametern von DB
SAVE_PARAM_DEF	Parameterdefinitionen speichern
SAVE_PARAM_VAL	Parameterwerte speichern
PREPARE_XML_SAVING	Bereitet XML-Stream zum Sichern auf

RAISE_CX_ECATT_APL_PARAM	Exception CX_ECATT_APL_PARAM auslösen

UPDATE_PARAM_XML_DATA	Update XML_DATA Reference in ITab PARAM_VAL_TAB
UPDATE_TYPE_REF	Liest Attribute der Typreferenz aus DDIC

Attribute

Öffentliche Attribute

PARAM_TAB	Interne Tabelle der Parameterdefinitionen
PARAM_VAL_TAB	Interne Tabelle der Parameterwerte
RFC_PAR	Ablage bestimmter Parameter zur Laufzeit Type CATFR

Geschützte Attribute

CONTAINER	Referenz auf eCATT Object
das dieses Parameterobjekt enthält
DB_TAB_NAME_PAR	Name der Datenbanktabelle
für Parameterdefinitionen
DB_TAB_NAME_VAL	Name der Datenbanktabelle
für Parameterwerte
DB_TAB_NAME_PAR_XML	Name der Datenbanktabelle der
Parameterwerte für XML-Parameter
PINDEX	Maximaler Parameterindex