Kontakt

Ansicht
Dokumentation

EXIT_SAPLSADR_001 - Country-specific address format for FM ADDRESS_INTO_PRINTFORM

EXIT_SAPLSADR_001 - Country-specific address format for FM ADDRESS_INTO_PRINTFORM

Fill RESBD Structure from EBP Component Structure   Vendor Master (General Section)  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

This customer function module is called in the SAP function module ADDRESS_INTO_PRINTFORM when the address format key of the recipient country is in the customer name range 900 - 999. The address is then formatted by a customer function module, not by an SAP standard routine.

You can define your own country-specific formatting routines in this function module, e.g.

  • for countries whose address format is not yet covered by the SAP standard

  • for countries whose format does not agree with the SAP standard, e.g. because of changes which have not yet been taken into account in the standard

  • if address data which do not follow the SAP standard are to be entered in the SAP system. This can, e.g. occur if incorrect field assignments were made, or several attributes were combined in one field. You are, however, strongly recommended to use a data set which is free of semantic errors, as data inconsistencies can cause other undesired side effects.

Note the following when writing your program:

  • You can use the FORM routines in the SAP Include LXSADF00. These routines should remain unchanged at SAP Release changes. Corrections and enhancements which are made in the underlying standard routines (function group SADR) are not copied, although the changed routines may be added in the Include LXSADF00 with other names.
  • A line type must be used in each address line when you create the internal address table. The codes must conform to the guidelines in the function module ADDRESS_INTO_PRINTFORM (see doc. of this function module), so that lines in the function module ADDRESS_INTO_PRINTFORM can be correctly omitted, if necessary.

The standard order for the omission of lines can be overruled using the CHANGING parameter LINE_PRIORITY.

For the return value of the export parameter:

  • The formatted address must be returned in the internal table ADDRESS_LINES.
  • The short form SHORT_FORM_LINE can be used. If the parameter is empty, the parameter is constructed from the name fields and the city, as in the standard.
  • The address short form for the data carrier exchange (DCE) is returned in the parameter DATA_CARRIER_LINE.
  • If the value of the parameter DATA_CARRIER_LINE_IS_COMPLETE is 'X', the parameter DATA_CARRIER_LINE is passed unchanged to the program which called ADDRESS_INTO_PRINTFORM; if the value is SPACE, the country name is added for foreign destinations.

Example

The Include LXSADF01 contains example programs.

In contrast to the delivered FORM routines, the example programs can be changed by SAP at Release changes, to keep them compatible with the current environment (e.g. extended interfaces).

Notes

New format keys must initially be defined in the customer name range 900- 999 in the table T005A.

Use the extended table maintenance (transaction SM30, in the menu System -> Services) and enter the table name 'T005A'.
Then enter the new key in the country customizing under 'Address format key'.

The texts for the keys in T005A are in the language-dependent text table T005B. When you use the extended table maintenance, the text is saved in the logon language.
You can add texts for other languages by logging on to the SAP System in the desired language and repeating the table maintenance. The new key values are then already available, but the text field in the new language is empty.
Alternatively, you can translate the texts with the translation transaction SE63 (menu Translation -> Short texts -> Table contents, Table T005B).

A text element must be maintained for the word P.O. box. Enter, in accordance with the coding analogous to SAP function group SADR (module SAPLSADR) in the customer function group XSAD (module SAPLXSAD), the word 'P.O. box' as the text element '001'.

This text element must be translated into the relevant languages using the transaction SE63. The only languages that are relevant are those for the countries for which you want to define a country-specific formatting routine in this extension.

The correct English text is 'P.O. box'.

Further information

Further information, in particular about the meanings of the parameters, can be found in the documentation of the function module ADDRESS_INTO_PRINTFORM.





Parameters

ADDRESS_HANDLE
ADDRESS_LINES
ADDRESS_NUMBER
ADDRESS_TYPE
ADRS1_NAME_FIELDS
ADRS2_NAME_FIELDS
ADRS3_NAME_FIELDS
ADRS_POST_FIELDS
CV_LANGU_CREA
DATA_CARRIER_LINE
DATA_CARRIER_LINE_0
DATA_CARRIER_LINE_IS_COMPLETE
DESTINATION_COUNTRY_FIELDS
DESTINATION_COUNTRY_TEXT
IV_NATION
IV_NATION_SPACE
IV_NATION_USED
IV_PERSON_ABOVE_ORGANIZATION
LINE_PRIORITY
NUMBER_OF_LINES
PERSON_HANDLE
PERSON_NUMBER
RECEIVER_LANGUAGE
SENDER_COUNTRY_FIELDS
SHORT_FORM_LINE
SHORT_FORM_LINE_WO_NAME
SHORT_FORM_S_LINE
STREET_HAS_PRIORITY

Exceptions

Function Group

XSAD

TXBHW - Original Tax Base Amount in Local Currency   Fill RESBD Structure from EBP Component Structure  
This documentation is copyright by SAP AG.

Length: 5743 Date: 20240523 Time: 062614     sap01-206 ( 112 ms )