Kontakt

Ansicht
Dokumentation

RSD_CHAVL_READ_ALL - Verify Master Data & Hierarchy Nodes and Read Texts & Attributes

RSD_CHAVL_READ_ALL - Verify Master Data & Hierarchy Nodes and Read Texts & Attributes

General Data in Customer Master   BAL Application Log Documentation  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

New documentation created on February 10, 2004 by Nikhil Sharma and Bernhard Neubueser

This function module reads BW master data, that is, attribute values and texts, as well as node texts from a hierarchy.

The parameters are as follows:

I_IOBJNM ,,Name of characteristic; although parameter is called I_IOBJNM, key figures are not allowed

I_LANGU,,,,Language for texts; evaluated only if texts of the characteristic are language-dependent

I_OBJVERS,,Object version of record in P/Q-table (usually 'A' = rs_c_objvers-active)          

I_DATETO,,,,Key date for time-dependent attributes and time-dependent texts (also in hierarchies), see comment below

I_CHECK_VALUE,,Check that the characteristic values exist in master data tables (P/Q) supplied in c_t_chavl_info  

I_SID_IN,,,,'X' = rs_c_true:The values to be read are specified as SIDs in c_t_chavl_info,

,,,,,,' ' = rs_c_false: Values are specified as characteristic values in c_t_chavl_info

I_READ_CHAVL,,'X' = rs_c_true: Characteristic value is requested

I_READ_TEXT,,'X' = rs_c_true: (All) text fields are requested

I_READ_ATTRIBUTES,,,,'N' = RSDM_C_ATR_REQ-NO:No attributes are requested

,,,,,,,,,,'A' = RSDM_C_ATR_REQ-ALL: All attributes are requested

,,,,,,,,,,'S' = RSDM_C_ATR_REQ-SPECIFIED: i_t_requested_attributes Hold list of requested attributes.

I_T_REQUESTED_ATTRIBUTES ,,See i_read_attributes

I_HIESID,,,,If <> 0: HIESID of the hierarchy to read from; c_chavl and c_niobjnm have to be filled (see comment below)

I_HIEID,,,,if <> '': HIEID of the hierarchy to read from; c_chavl and c_niobjnm have to be filled (see comment below)

I_MOSTRECENT,,'X' = rs_c_true: most recent read (that is, 'M'-object version if exists, 'A' otherwise)

I_PROGNAME,,This is for wizards only

C_T_CHAVLINFO,,is of type RSDM_S_CHAVLINFO. This has the following components:

  • I_SID,,,,SID of master data record to be read (if I_SID_IN = 'X' = rs_c_true)
  • C_CHAVL,,,,C_CHAVL: characteristic value (concatenated if characteristic is compounded). If I_SID_IN = ' ' = rs_c_false) this has to be filled by the caller; I_SID_IN = 'X' = rs_c_true and I_READ_CHAVL = 'X' = rs_c_true this field is filled by the function modulue. I_SID and C_CHAVL cannotboth be filled. However, this is not currently checked but we reserve the right to raise exceptions without further notice.
  • C_NIOBJNM,,Node InfoObject in case I_HIEID or I_HIESID are specified for reading the hierarchy nodes
  • C_HIEID,,,,HIEID of hierarchy
  • I_TABIX ,,Unknown
  • E_EXIST,,,,Do texts exist (or are the replacement texts being used)?
  • E_CHATEXTS ,,A structure with the followng components
  • TXTSH Short text field
  • TXTMD,,Medium text field
  • TXTLG,,Long text field
  • C_RC,,,,A record was not found in SID/P or Q -table (=> data inconsistency or incorrect input)
  • I_READ_MODE,,For internal use only

E_TX_ATTRIBUTES,,Exporting parameter contains the values of attributes (if requested);
data type: RSDM_SX_ATR with the following components

  • CHAVL ,,(Concatenated) characteristic value
  • SID,,,,SID (only if incoming)
  • T_ATR,,Name-value-pair table containing the values of the requested attributes

Comment:

a) For reading from a hierarchy, exactly one of the (equivalent) parameters I_HIESID and IHIEID has to be specified.

b) When reading from a hierarchy, the key date of the hierarchy is not specified since this function module does not return the structure of the hierarchy but only the texts for the nodes.





Parameters

C_T_CHAVLINFO
E_TX_ATTRIBUTES
I_CHECK_VALUE
I_DATETO
I_HIEID
I_HIESID
I_IOBJNM
I_LANGU
I_MOSTRECENT
I_OBJVERS
I_PROGNAME
I_READ_ATTRIBUTES
I_READ_CHAVL
I_READ_TEXT
I_SID_IN
I_T_REQUESTED_ATTRIBUTES

Exceptions

CHECK_TABLE_NOT_EXISTING
INFO_OBJECT_NOT_FOUND
INHERITED_ERROR
ROUTINES_GENERATION_ERROR
TEXT_TABLE_NOT_EXISTING

Function Group

RSDM

Vendor Master (General Section)   CL_GUI_FRONTEND_SERVICES - Frontend Services  
This documentation is copyright by SAP AG.

Length: 5323 Date: 20240523 Time: 141222     sap01-206 ( 101 ms )