Inserting Addresses

Use

In many applications, addresses are administered using the Business Address Services (BAS). Depending on how the address is used, the application uses a particular address type. The addresses are stored in the database tables of the central address administration and identified by the application via a number.

You use the address node to insert an address into the form. This guarantees that the address is formatted according to the postal regulations of the sender country.

Prerequisites

Your application must administer addresses using the BAS. Otherwise you must use the text node to insert your addresses.

Procedure

  1. Create a node of type Address in the navigation tree of the Form Builder.

    Create the address node as directly inferior node of the page node or use the context menu in the layout of the Form Painter. You can then position the address anywhere on the page.

  2. Enter a unique name for the node and a description (for example, customer address).
  3. Determine the address type on the General Attributes tab.

    For a description of how to determine the address type dynamically and how to use fields instead of fixed values, see Using Parameters in the Form.

  4. For organization addresses you must specify only an address number. For any other address types, you must specify a person number and an address number. To do this, use the search help.
  5. In the box Additional Address Specifications you can maintain other attributes to specify how you want to display the address:

    To format addresses, SAP Smart Forms calls function module ADDRESS_INTO_PRINTFORM and sets the parameters accordingly. For more information refer to the documentation of this function module in the Function Builder (transaction SE37). For more information on address formatting, refer to the general formatting rules of the BAS documentation.

    Additional Specifications for an Address

    Field

    Parameter in Function Module ADDRESS_INTO_PRINTFORM

    Description

    Output Starts With Paragraph

    There is no parameter for this field

    Paragraph format of the current style, which you want to use to display the entire address

    Number of Lines to be Used

    NUMBER_OF_LINES

    If the number of lines you specify here is smaller than the number of lines required to display the address, the BAS suppresses lines of the address. This also happens if the output area for the address if too small.

    Sender Country

    SENDER_COUNTRY

    If you leave this field empty, the BAS specifies either a country short form or the complete country name, depending on the customizing setting. If you enter a sender country, the BAS leaves out the country for domestic letters.

    Use P.O.Box (P)

    STREET_HAS_PRIORITY

    Use Street (S)

    Determine Dynamically (P,S)

    For addresses that have a P.O. box as well as a street address, use the other fields in the box to determine which of these addresses to display.

    Fixed Language for Country Name

    LANGUAGE_FOR_COUNTRY_NAME

    Explicitly specify a fixed language for the country name (for example, always English for customs documents)

    Different Recipient Language

    RECEIVER_LANGUAGE

    Language of the recipient (if different from the language set for the destination country, for example for recipients in Switzerland)

    Country Name in Recipient Language

    COUNTRY_NAME_IN_RECEIVER_LANGUAGE

    Flag indicating that you want to use the recipient language for the country name.

    Uppercase/Lowercase

    NO_UPPER_CASE_FOR_CITY

    Flag indicating that (for foreign addresses) you do not want to print city and country in uppercase letters (as required by the International Postal Regulations), but to keep the spelling as it is (for example, for printing the address line as part of a continuous text).

    Priority of Lines

    LINE_PRIORITY

    Overrules the standard sequence in which lines of an address are suppressed. Each digit of the string specified here represents one line in the address output. The sequence in which the digits appear sets the priority with which the lines are suppressed. For information on the meaning of the individual digits refer to the documentation of function module ADDRESS_INTO_PRINTFORM in the system.

  6. If desired, you can use the Output Options tab to maintain attributes for style, box and shading of the text. In addition, you can set values for position and size of the output area (instead of in the Form Painter).

Result

The system displays the node including name and description in the tree structure. If you insert the address as directly inferior node of a page or by using the Form Painter, the system displays an extra output area for the address. The address itself is inserted only at the moment the form is processed. You cannot view it in the Form Builder.