Kontakt

Ansicht
Dokumentation

RSDSO_WRITE_API - Write API for DataStore objects (advanced)

RSDSO_WRITE_API - Write API for DataStore objects (advanced)

BAL_S_LOG - Application Log: Log header data   PERFORM Short Reference  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

This API is used to load data from an internal table into the inbound queue of a DataStore object (advanced) and then to activate it. Each API call results in a new request. All data is stored in one single data package. The corresponding database transaction will be committed automatically.

Importing Parameters

I_ADSONM

  • Enter the technical name of the DataStore object (advanced)

I_ALLOW_NEW_SIDS

  • In some use cases, the referential integrity of the loaded characteristic values has to be checked. This parameter determines whether new SIDs can be created.
  • If this parameter is set to "False", the load or activation will abort if a SID is missing for a particular characteristic value.
  • If it is set to "True", new entries will be inserted into the corresponding SID table.

I_ACTIVATE_DATA

  • Set this parameter to "True" if the request needs to be activated.
  • Please note that all successfully loaded requests stored in the inbound queue will be activated in one single activation request.

IT_AGGREGATION

  • Fill this table to determine which fields have to be filled during activation of the request, and how the key figures are aggregated. For details, see the section below.
  • If this parameter is left blank, the default aggregation is used.

IT_DATA

  • Internal table storing the data to be loaded into the inbound queue. The structure is not important, since it will be mapped to the structure of the activation queue.
  • The technical key (Request TSN, data package, record) will be filled automatically.

Exporting Parameters

E_LINES_INSERTED

  • The number of records stored in the inbound queue

ET_MSG

  • Log of the load/activation process

E_UPD_REQ_TSN

  • Newly created request TSN for the inbound data

ET_ACT_REQ_TSN

  • Newly created activation request TSN(s)

Exceptions

WRITE_FAILED

  • Load to the inbound queue failed

ACTIVATION_FAILED

  • Activation of the loaded data failed. This exception is also raised if the DataStore object does not allow activation of requests.

DATASTORE_NOT_FOUND

  • Active version of DataStore object does not exist

Example

CALL FUNCTION 'RSDSO_WRITE_API'

  EXPORTING

    i_adsonm            = 'SAMPLE'

    i_allow_new_sids    = rs_c_false

    i_activate_data     = rs_c_true

    it_data             =

  IMPORTING

    e_lines_inserted    = l_lines_inserted

    et_msg              = lt_msg

    e_upd_req_tsn       = l_upd_req

    et_act_req_tsn      = lt_act_req

  EXCEPTIONS

    write_failed        = 1

    activation_failed   = 2

    datastore_not_found = 3

    OTHERS              = 4.

Notes

Further information

IT_AGGREGATION

The entries in this table determine how field values of the active data table are updated in the activation process.

  • Characteristics
  • Characteristics that are part of the semantic key do not have to be inserted into this table (they will always be filled automatically).

  • Non-key fields that have to be ignored during the activation process have to be left out as well.

  • All other characteristics have to be inserted with aggregation type "MOV".

  • Key Figures
  • Key figures that have to be ignored have to be inserted with initial aggregation type ' ' (space). If the key figure uses "summation" as standard aggregation, the "invert_sign" flag has to be set to "True". Otherwise it has to be set to "False".

  • All other key figures have to be inserted with the corresponding aggregation type. The sign flag has to be set as described above.

Element specification

IOBJNM

  • If the field corresponds to an InfoObject, enter the technical name.

FIELDNM

  • Name of the field

AGGREGATION

  • Determines how values of the active data table are updated during the activation process.
  • BLANK (space): Only used for key figures (see above). Value will not be changed.

  • MOV: Value will be overwritten with the loaded value.

  • SUM: Only used for key figures. Aggregation type "Summation".

  • MIN: Only used for key figures. Aggregation type "Minimum".

  • MAX: Only used for key figures. Aggregation type "Maximum".

INVERT_SIGN

  • Determines how before and reverse images are calculated for the change log.
  • For characteristics, set the flag to "False".
  • For key figures with standard aggregation "Summation", set the flag to "True". This will result in an inverted before and reverse image.
  • For key figures with a different standard aggregation, set the flag to "False".





Parameters

ET_ACT_REQ_TSN
ET_MSG
E_LINES_INSERTED
E_UPD_REQ_TSN
IT_AGGREGATION
IT_DATA
I_ACTIVATE_DATA
I_ADSONM
I_ALLOW_NEW_SIDS
I_DEBUG
I_PROCESS_TYPE

Exceptions

ACTIVATION_FAILED
DATASTORE_NOT_FOUND
WRITE_FAILED

Function Group

RSDSO_UPDATE

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

Length: 7775 Date: 20240523 Time: 125245     sap01-206 ( 78 ms )