7.3 Obtaining Company Address Data for User Objects

There are several attributes of the SAP User object that are associated with the Company Address object assigned to the User. These attributes, by default, are never populated in BAPI or IDoc distributions of User data from the SAP application server. These fields also cannot be read from the User object in SAP. Company Address data is maintained in a table of related records of the ADDRESSORG type. The driver can retrieve this data from the ADDRESSORG table if desired.

The driver parameter to publish Company Address data <nsap-use-addressorg> is set to 1 by default. Setting the value to 1 retrieves the data from the ADDRESSORG table if attributes in the table exist in the Publisher filter, or if the attributes are in <read-attr> elements of a query document. Although this data can be retrieved from the SAP system, ADDRESSORG data cannot be added, modified, or removed from the SAP system via the driver. If the value of this parameter is set to 0, the company address fields are retrieved from the User object itself. As previously mentioned, by default, these fields won’t contain any data.

To fully implement the address retrieval functionality, you must configure the driver to receive events when the ADDRESSORG table is modified. By receiving these events, the driver obtains a list of all User objects assigned to the modified ADDRESSORG table and issues modify events with the changed data for each affected user.

To generate ADDRESSORG modify events, you need to modify the ALE distribution model on the SAP application server to include the distribution of the Company Clone (CCLONE) BAPI. Refer to Creating a Distribution Model and Modifying the Port Definition for more information.

The following User object fields might be affected by this functionality.

NAME

HOUSE_NO2

NAME_2

STR_SUPPL1

NAME_3

STR_SUPPL2

NAME_4

STR_SUPPL3

C_O_NAME

BUILDING

CITY

DISTRICT

CITY_NO

FLOOR

DISTRICT

ROOM_NO

DISTRICT_NO

COUNTRY

POSTL_COD1

COUNTRYIOS

POSTL_COD2

LOCATION

POSTL_COD3

LANGU_ISO

PO_BOX

REGION

PO_BOX_CIT

SORT1

PBOXCIT_NO

TIME_ZONE

DELIV_DIS

TAXJURCODE

TRANSPZONE

STR_ABBR

STREET

HOUSE_NO

STREET_NO