Ansicht
Dokumentation

/DSD/BAPI_VL_CHANGEFROMDATA - Change Visit List

BAL Application Log Documentation   CPI1466 during Backup  
This documentation is copyright by SAP AG.

Functionality

You can make the following changes to a visit list using this method:

• You can change general data at header and item level. You cannot change the visit plan type of the visit list in the header data.

• You can add new customers or remove customers from the visit list using the import structure VLP_IN. You can also change other customer data, such as the sequence of visits. You cannot change customer numbers.

• You can assign new texts or remove texts.

• You can assign new reference documents at header and item level, or remove reference documents that have already been assigned.

Changes you make to individual fields are only taken into account by the system if the following prerequisites are fulfilled:

• You have specified in the update indicator for each item in the visit list whether the values entered are new (I) or changed (U), or if you want the existing values to be deleted (D).

• In the relevant change parameter for the parameter, you have flagged all fields that are change-relevant with an 'X'. If you want to change specific fields in the header data (parameter VLH_IN), for example, you must select these fields in parameter VLPX.

You can use the SIMULATION parameter to specify that you only want the changes to be simulated, and that the changed visit list data should not initially be written to the database.

Customer Enhancements

To add customer fields to the tables for the visit list, you can use the following BAPI Table Extensions:

• Structure /DSD/BAPI_VC_TE_VLH for additional fields at header level

• Structure /DSD/BAPI_VC_TE_VLHX to flag the new fields at header level

• Structure /DSD/BAPI_VC_TE_VLH_R for additional fields for reference documents at header level
  If customer fields are added to the reference documents table, these fields must also be added to the structure /DSD/VC_DOC.

• Structure /DSD/BAPI_VC_TE_VLH_RX to flag the new fields for reference documents at header level

• Structure /DSD/BAPI_VC_TE_VLP for additional fields at item level
  If customer fields are added to the item data table, these fields must also be added to the structure /DSD/VC_VL_TREE.

• Structure /DSD/BAPI_VC_TE_VLPX to flag the new fields at item level

• Structure /DSD/BAPI_VC_TE_VLP_R for additional fields for reference documents at item level
  If customer fields are added to the reference documents table, these fields must also be added to the structure /DSD/VC_DOC.

Structure /DSD/BAPI_VC_TE_VLP_RX to flag the new fields for reference documents at item level

You can assign the relevant values to customer fields with the EXTENSIONIN table.

All data transferred to the BAPI is checked for consistency before further processing. By implementing the BAdI method VL_CHECK_CONSISTENCY, you can add your own checks or check the consistency of customer fields in the visit list tables.

Return messages

Messages are returned in the RETURN parameter. See the parameter documentation for the return values and their meanings.

Example

Notes

The following authorization object is checked with the activity 02 (Change): /DSD/VC_VL.

Further information

For more information, see the parameter documentation.

Parameters

EXTENSIONIN
RETURN
SIMULATION
VISITLIST_ID
VLHX
VLH_IN
VLH_OUT
VLH_RX
VLH_R_IN
VLPX
VLP_IN
VLP_RX
VLP_R_IN
VLTEXT_IN

Exceptions

Function Group

/SAPLVC_BAPI_VL

ABAP Short Reference   Fill RESBD Structure from EBP Component Structure  
This documentation is copyright by SAP AG.

Length: 5388 Date: 20240424 Time: 201224     sap01-206 ( 64 ms )