Creating Customer-specific Documentation

SAP’s enhancement concept allows you to create your own keywords and online help documentation for all data elements stored in the Repository. These documentation exits differ from the other exits described in this document in several ways:

·        SAP application developers do not need to prepare special exits for data elements. You can customize the texts of all standard data elements in your SAP System to the requirements of the customer.

·        You do not need to create an enhancement project to create your own documentation for data elements.

·        Your own documentation texts are not affected when you activate and deactivate enhancement projects.

Creating Your Own Keywords and Short Texts

You can use the enhancement concept to create your own keywords for data elements stored in the ABAP Dictionary. The system uses keywords on screens to identify entry fields. Data elements can have up to three keywords of varying lengths.

The data element BBBNR, for example, identifies the first part of a customer’s international company number. The standard keywords for this data element in the ABAP Dictionary are:

·        Company no. 1

·        Comp. no.1

·        Company number 1

You might want to change these keywords to reflect your company’s own terminology. Instead of ‘Company number 1’, you would like to name the field ‘Company-ID’. If you change the key word using the enhancement concept, then your text is displayed on all SAP-screens with fields that have a direct reference to the data element changed by them. If SAP deliberately modifies a keyword on a standard screen, direct reference to the original data element is dissolved. Any changes you make to a keyword with the enhancement concept will not appear in standard screens that do not retain a direct reference to the modifed data element.

You can identify such screen-specific modifications by looking in the Screen Painter. Display the field’s screen attributes and examine the field Modific. If an ‘x’ appears, the SAP developer modified the data element’s key word. Your own keyword will not appear.

The enhancement concept also allows you to alter a data element’s short description (short text). This brief text appears whenever a user calls up online help for that field with F1. To create your own keyword and short text documentation, proceed as follows:

...

       1.      Enter the Project management transaction by choosing Utilities ® Enhancements ® Project management from the ABAP Workbench menu

       2.      Choose Text enhancements ® Key words ® Change.

The system displays a dialog box.

       3.      Enter the name of data element.

If you want to see a list of all the screens where this data element appears, choose Ref. to screen before proceeding to the next step. The reference list shows you how many standard screens your new documentation will affect.

       4.      Choose Change.

       5.      Edit the data element’s keywords and short text.

       6.      Save your changes.

If you want to list all the data elements in your system that you have created customer-specific key words for, return to the main screen of the Project management transaction and choose Text enhancements ® Key words ® Display. The system displays all altered data elements and shows which changes were made.

Restoring SAP and Customer Versions

At some point you may want to restore all standard SAP keywords and short texts for data elements that you may have altered. You can restore the standard texts from the main screen of the Project management transaction. Choose Text enhancements ® Key words ® Restore SAP version. Specify the SAP release from which the texts are to be restored.

The restoration function is carried out by a special program that runs in the background. This program goes through all data elements in your SAP System and restores the standard texts where required.

Creating Your Own Online Documentation

The enhancement concept allows you to create your own online documentation for all data elements in the ABAP Dictionary. The system displays this documentation whenever a user chooses F1 to get more information about a screen field.

The standard documentation for the data element BBBNR reads: ‘Here, you enter the first 7 digits of the international location number’. You can enhance this documentation with additional information that your users may need. To write your own field documentation, proceed as follows:

...

       1.      Call the Project management transaction by choosing Utilities ® Enhancements ® Project management from the ABAP Workbench menu.

       2.      Choose Text enhancements ® Data elements ® New DE cust. docu.

The system displays a dialog box.

       3.      Specify the data element’s name.

If you want to see a list of all the screens where this data element appears, choose Ref. to screen before proceeding to the next step. The reference list shows you how many standard screens your new documentation will affect.

       4.      Choose Change.

       5.      On the next screen, ensure that the checkbox labelled Make available SAP documentation in the form of an INCL is activated.

       6.      Choose Create.

       7.      Write your own documentation.

       8.      Save your changes.