Formatting Addresses: ADDRESS
The ADDRESS - ENDADDRESS control command formats an address according to the postal convention of the recipient country defined in the COUNTRY parameter. The reference fields are described in the structures ADRS1, ADRS2, or ADRS3, depending upon the type of address. Either direct values or symbols may be assigned to the parameters.
Syntax:
/: ADDRESS [DELIVERY] [TYPE t] [PARAGRAPH a] [PRIORITY p] [LINES l]
/: TITLE title
/: NAME name1[,name2[,name3[,name4]]]
/: PERSON name of natural person [TITLE form of address]
/: DEPARTMENT department
/: STREET street name
/: LOCATION additional location information
/: POBOX po box [CODE post code / zip code] [CITY city]
/: POSTCODE post code / zip_code
/: CITY city1[,city2]
/: REGION county / state
/: COUNTRY recipient country [LANGUAGE language code]
/: FROMCOUNTRY sender country
/: ADDRESSNUMBER address number
/: ENDADDRESS
The parameter values contain both formatting and address information. The address data are formatted for output according to the data in the following parameters:
• TYPE
• FROMCOUNTRY
• COUNTRY
• LANGUAGE
• PRIORITY
• DELIVERY; and
• LINES
For more information, please also see the on-line documentation for the SAP function module ADDRESS_INTO_PRINTFORM (transaction SE37).
If DELIVERY is not specified and if a POBOX is specified, then it is used in an address instead of a STREET.
Parameters
• DELIVERY
Means that the address should be formatted as a complete delivery address, i.e. using the street name and number rather than the P. O. Box.
• TYPE
Specifies the type of address. The following types are possible:
- 1 normal address (ADRS1). This is the address of a company or organization. It corresponds to the address structure that is expected in most SAP applications.
- 2 private or personal address (ADRS2). This is the address of a natural person, a private or home address.
- 3 company address (ADRS3) with contact person. This is the address of a colleague or contact within a company or organization. The company name should be specified in the TITLE and NAME fields; the ATTN: contact person should be named in PERSON and TITLE.
Should you enter another address type or leave the field blank, then type 1 is used for formatting.
• PARAGRAPH
Specifies the paragraph format to be used for outputting the address. If this parameter is not given, the address will be output using the default paragraph format.
• PRIORITY
Specifies which of the address lines may be omitted should this be necessary. Any combination of the following codes may be specified. The order in which you list the codes determines the order in which address lines are left out.
The codes are as follows:
- A title
- P mandatory empty line
- 4 name4
- 3 name3
- R region
- T neighborhood, administrative section of a city (CITY2)
- D department
- L country name
- C post code or zip code
- 2 name2
- B P.O. Box (Japan only)
- S street name and number or P.O. Box, depending upon DELIVERY parameter
- N name and form of address of natural person (PERSON and TITLE)
- I Location information in LOCATION
- O city
• LINES
This specifies how many lines may be used for formatting the address. If there are too few lines available to allow all the address data to be formatted, then the data specified in the PRIORITY parameter are omitted. If there is no LINES parameter and if this command is in a layout set window of a type other than MAIN, then the number of lines available for formatting the address are automatically calculated based on the current output position and the size of the window.
• TITLE
Title or form of address. Used only with addresses of types 1 and 3.
• NAME
Up to four names may be given, separated by commas. Used only with addresses of types 1 and 3.
• PERSON
Name of the addressee. Used only for addresses of type 2 (private or personal address) or type 3 (company contact address). In type 3 addresses, use PERSON for the name of your contact person: 'Attn: Mr. Jeffries'. The name fields should be used for the company address.
• TITLE (with PERSON)
Title of the addressee. Used only for addresses of type 2 or type 3 (private or personal address).
• DEPARTMENT
Department of the addressee. Used only for addresses of type 3 (company address).
• STREET
Street name, including the street number(s).
• LOCATION
Additional location information, such as the building, "Upstairs Apartment" and so on. Appears on its own line in the address.
• POBOX
P. O. Box.
• CODE
The post code / zip code of the P. O. Box if this is different than the post code / zip code of the recipient.
• CITY
The city in which the destination P.O. Box is located if this is different than the city of the recipient.
• POSTCODE
Post code / zip code of the recipient.
• CITY
Addressee's city. city1 is expected to be the city; city2 is the neighborhood or administrative section, if required.
• REGION
This allows an administrative region, county, province, or state etc. to be specified.
• COUNTRY
Specifies the recipient country, i.e. the country according to whose postal conventions the address is to be formatted.
• LANGUAGE
Language code of the language of the recipient country, if different than that of the recipient COUNTRY. Example: addresses in Switzerland. Standard SAP language codes are used; you can display these in the initial SAPscript text processing screen or in table T002.
• FROMCOUNTRY
Specifies the language to be used for formatting the name of the recipient country. For most European countries, the recipient country is specified by placing the international car registration letters in front of the post code and separating them from the post code with a hyphen.
• ADDRESSNUMBER
An address number for use in special cases, such as addressing in Japan. The number is used to index a central address file, from which the desired address is read. You can find more information on this facility in the documentation for the function module ADDRESS_INTO_PRINTFORM (transaction SE37).
/: ADDRESS
/: TITLE 'Firma'
/: NAME 'Schneider & Co', 'Finanzberatung'
/: STREET 'Kapitalgasse 33'
/: POBOX '12345' CODE '68499'
/: POSTCODE '68309'
/: CITY 'Mannheim'
/: COUNTRY 'DE'
/: FROMCOUNTRY 'DE'
/: ENDADDRESS
SAPscript makes an internal call to the ADDRESS_INTO_PRINTFORM function module for formatting the address. If the result is not as expected, you should check the settings for this function module (see the function module documentation (transaction SE37)).
RELATED POSTS
SAP SCRIPT CONTROLS 6
SAP SCRIPT CONTROLS 5
The ADDRESS - ENDADDRESS control command formats an address according to the postal convention of the recipient country defined in the COUNTRY parameter. The reference fields are described in the structures ADRS1, ADRS2, or ADRS3, depending upon the type of address. Either direct values or symbols may be assigned to the parameters.
Syntax:
/: ADDRESS [DELIVERY] [TYPE t] [PARAGRAPH a] [PRIORITY p] [LINES l]
/: TITLE title
/: NAME name1[,name2[,name3[,name4]]]
/: PERSON name of natural person [TITLE form of address]
/: DEPARTMENT department
/: STREET street name
/: LOCATION additional location information
/: POBOX po box [CODE post code / zip code] [CITY city]
/: POSTCODE post code / zip_code
/: CITY city1[,city2]
/: REGION county / state
/: COUNTRY recipient country [LANGUAGE language code]
/: FROMCOUNTRY sender country
/: ADDRESSNUMBER address number
/: ENDADDRESS
The parameter values contain both formatting and address information. The address data are formatted for output according to the data in the following parameters:
• TYPE
• FROMCOUNTRY
• COUNTRY
• LANGUAGE
• PRIORITY
• DELIVERY; and
• LINES
For more information, please also see the on-line documentation for the SAP function module ADDRESS_INTO_PRINTFORM (transaction SE37).
If DELIVERY is not specified and if a POBOX is specified, then it is used in an address instead of a STREET.
Parameters
• DELIVERY
Means that the address should be formatted as a complete delivery address, i.e. using the street name and number rather than the P. O. Box.
• TYPE
Specifies the type of address. The following types are possible:
- 1 normal address (ADRS1). This is the address of a company or organization. It corresponds to the address structure that is expected in most SAP applications.
- 2 private or personal address (ADRS2). This is the address of a natural person, a private or home address.
- 3 company address (ADRS3) with contact person. This is the address of a colleague or contact within a company or organization. The company name should be specified in the TITLE and NAME fields; the ATTN: contact person should be named in PERSON and TITLE.
Should you enter another address type or leave the field blank, then type 1 is used for formatting.
• PARAGRAPH
Specifies the paragraph format to be used for outputting the address. If this parameter is not given, the address will be output using the default paragraph format.
• PRIORITY
Specifies which of the address lines may be omitted should this be necessary. Any combination of the following codes may be specified. The order in which you list the codes determines the order in which address lines are left out.
The codes are as follows:
- A title
- P mandatory empty line
- 4 name4
- 3 name3
- R region
- T neighborhood, administrative section of a city (CITY2)
- D department
- L country name
- C post code or zip code
- 2 name2
- B P.O. Box (Japan only)
- S street name and number or P.O. Box, depending upon DELIVERY parameter
- N name and form of address of natural person (PERSON and TITLE)
- I Location information in LOCATION
- O city
• LINES
This specifies how many lines may be used for formatting the address. If there are too few lines available to allow all the address data to be formatted, then the data specified in the PRIORITY parameter are omitted. If there is no LINES parameter and if this command is in a layout set window of a type other than MAIN, then the number of lines available for formatting the address are automatically calculated based on the current output position and the size of the window.
• TITLE
Title or form of address. Used only with addresses of types 1 and 3.
• NAME
Up to four names may be given, separated by commas. Used only with addresses of types 1 and 3.
• PERSON
Name of the addressee. Used only for addresses of type 2 (private or personal address) or type 3 (company contact address). In type 3 addresses, use PERSON for the name of your contact person: 'Attn: Mr. Jeffries'. The name fields should be used for the company address.
• TITLE (with PERSON)
Title of the addressee. Used only for addresses of type 2 or type 3 (private or personal address).
• DEPARTMENT
Department of the addressee. Used only for addresses of type 3 (company address).
• STREET
Street name, including the street number(s).
• LOCATION
Additional location information, such as the building, "Upstairs Apartment" and so on. Appears on its own line in the address.
• POBOX
P. O. Box.
• CODE
The post code / zip code of the P. O. Box if this is different than the post code / zip code of the recipient.
• CITY
The city in which the destination P.O. Box is located if this is different than the city of the recipient.
• POSTCODE
Post code / zip code of the recipient.
• CITY
Addressee's city. city1 is expected to be the city; city2 is the neighborhood or administrative section, if required.
• REGION
This allows an administrative region, county, province, or state etc. to be specified.
• COUNTRY
Specifies the recipient country, i.e. the country according to whose postal conventions the address is to be formatted.
• LANGUAGE
Language code of the language of the recipient country, if different than that of the recipient COUNTRY. Example: addresses in Switzerland. Standard SAP language codes are used; you can display these in the initial SAPscript text processing screen or in table T002.
• FROMCOUNTRY
Specifies the language to be used for formatting the name of the recipient country. For most European countries, the recipient country is specified by placing the international car registration letters in front of the post code and separating them from the post code with a hyphen.
• ADDRESSNUMBER
An address number for use in special cases, such as addressing in Japan. The number is used to index a central address file, from which the desired address is read. You can find more information on this facility in the documentation for the function module ADDRESS_INTO_PRINTFORM (transaction SE37).
/: ADDRESS
/: TITLE 'Firma'
/: NAME 'Schneider & Co', 'Finanzberatung'
/: STREET 'Kapitalgasse 33'
/: POBOX '12345' CODE '68499'
/: POSTCODE '68309'
/: CITY 'Mannheim'
/: COUNTRY 'DE'
/: FROMCOUNTRY 'DE'
/: ENDADDRESS
SAPscript makes an internal call to the ADDRESS_INTO_PRINTFORM function module for formatting the address. If the result is not as expected, you should check the settings for this function module (see the function module documentation (transaction SE37)).
RELATED POSTS
SAP SCRIPT CONTROLS 6
SAP SCRIPT CONTROLS 5
No comments :
Post a Comment