Ansicht
Dokumentation

DDIF_SHLP_PUT - DD: Interface to write a search help in the ABAP Dictionary

General Data in Customer Master   PERFORM Short Reference  
This documentation is copyright by SAP AG.

Functionality

The sources of a search help can be written to the ABAP Dictionary with this function module. The new or revised version of the search help is written. If there is an active version of the search help, it is not affected.

Before the search help is written, there is a check whether the action is permitted for the specified object. If this is not the case, for example if the selected name violates the naming convention or if the object collides with the name of another ABAP Dictionary object, the exception PUT_REFUSED is triggered. In this case the system variables contain a message that describes the reason for the rejection more precisely.

If only certain components (e.g. the inclusions) of the search help should be changed, you only have to define the corresponding parameters of the function module. In this case "defining" the IMPORT parameter (DD30V_WA) means that a value other than SPACE is passed in field SHLPNAME. For the TABLES parameters (DD31V_TAB, DD32P_TAB, DD33V_TAB), on the other hand, "defined" means that it is specified at all in the call.
Caution: A TABLES parameter is considered to be defined if it is passed a table without rows. In this case the effect is completely different to that for not defining this parameter in the call.

Example

Notes

1. This function module does not perform any authorization check and does not write any correction entry.

2. If the write operation fails, the exception PUT_FAILURE is activated. In this case, part of the sources might already be written. A ROLLBACK should therefore be performed at a suitable time.

3. The module does not perform any COMMITs or ROLLBACKs. After writing, the caller should therefore perform a COMMIT.

1. If a parameter is defined, but has a value that is different from NAME in a row in the field SHLPNAME, the exception NAME_INCONSISTENT is triggered.
2. If the parameter DD30V_WA is not defined and there is no version of the search help in the ABAP Dictionary, the exception SHLP_NOT_FOUND is triggered.
3. The included search helps in DD31V_TAB are stored in the order defined by SHPOSITION. If a SHPOSITION entry occurs more than once, the exception SHLP_INCONSISTENT is triggered. Only positive entries are allowed in the field SHPOSITION. Accordingly, the fields from DD32P_TAB are stored in the order given by FLPOSITION.
4. The revised (or new) version of the search help that is stored can be activated by calling the function module DDIF_VIEW_ACTIVATE.

Further information

Parameters

DD30V_WA
DD31V_TAB
DD32P_TAB
DD33V_TAB
NAME

Exceptions

NAME_INCONSISTENT
PUT_FAILURE
PUT_REFUSED
SHLP_INCONSISTENT
SHLP_NOT_FOUND

Function Group

SDIF

RFUMSV00 - Advance Return for Tax on Sales/Purchases   CPI1466 during Backup  
This documentation is copyright by SAP AG.

Length: 3355 Date: 20240523 Time: 113249     sap01-206 ( 78 ms )