|
Recommendation
From Release 640 upwards the time-dependent address usages solutionprovided by Financial Services will be replaced by the time-dependentaddress usages for the SAP Business Partner. We therefore recommend thatyou no longer use this method.
To change addresses and time-dependent address usages, use the methodChangeAddress for the Business Object BusinessPartnerFS.Functionality
You can use this method to change an address for a business partner andto add, change, and delete time-dependent address usages belonging tothis address.
Within the address data you can change information for the addressselected and you can define that the address to be changed is theaddress for the business partner. You can also change data for theindividual communication types for the business partner.
With the time-dependent address usages you can change the assignment ofthe address to be changed to the address types forthe business partner and the validity period for this assignment. Inaddition you can create new or delete address usages for the address tobe changed. The following order is observed when processingtime-dependent address usages:
All entries to be deleted are processed
All new address usages are created
Records to be changed are processedNotes
Every time you call this method you can create one address for abusiness partner and you can create, change, or delete an infinitenumber of address usages.
A preprocessing run takes place before the data is changed:
- A check is performed to determine whether the business partner is
available for processing.
- A simple exclusive lock is activated.
This prevents other users from changing the business partner that iscurrently being processed until either the method TransactionCommit
or TransactionRollback for the Business ObjectBapiService is executed. The authorized user can access the samebusiness partner repeatedly.
Address data and address usages are not written to the database untilthe method TransactionCommit for the Business ObjectBapiService has been called.Authorizations
You can make settings for business partner authorization objects to bechecked in Customizing for the SAP Business Partner underBusiness Partner-> Basic Settings-> Authorization Management.Buffering
This method works with buffering. Change and read methods for thisbusiness object category can be repeatedly used for this instance. Aftercalling the save method, read and write methods can access the bufferedinstances and supply current attributes in the same Logical Unit of Work(LUW). Interdependencies
If you do not enter an address GUID in this method, then the systemassumes that the standard address for the business partner is to bechanged.
The system checks data to be changed with regards to its consistency andthe Customizing settings available.
In the parameter ACCEPT_ERROR you can define how the system is todeal with errors arising from the regional structure check.
If you have not made the relevant settings, then the system carries outa duplicate check when changing addresses. If the system recognizes thatthe record being created already exists, then it returns those recordsthat are similar to the record in the parameter ADDRESSDUPLICATES.
In the parameter DUPLICATE_MESSAGE_TYPE you can determinewhether the system should continue adding the data with an errormessage, or whether it should terminate processing.
If no error occurs when changing addresses and time-dependent addressusages, then the data is saved and the system returns a unique addressGUID in the parameter ADDRESSGUID.Return messages
Messages are returned in the RETURN parameter. You can find thereturn values and their meaning in the parameter documentation.Description
With this parameter you control whether a message from the regionalstructure check is of the type:
- E (error) or
- W (warning)
In this parameter enter the value X if messages issued are to bewarning messages.Value range
X for the regional structure check will issue a message of type W(warning)
' ' for the regional structure check will issue a message of type E
(error)Default
' ' for the regional structure check will issue a message of type E
(error)Description
This parameter is a required (mandatory) parameter.
It contains the address data for a business partner to be changed.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter ADDRESSDATA.Value range
'X' Change address data
' ' Do not change address data Description
This parameter contains the address GUID to be transferred.
The address GUID identifies an address that is unique across allsystems. It is a technical object identifier that is not shown on theinterface and that is not to be used in interactions between systemusers.
If you do not enter an address GUID in this method, then the systemassumes that the standard address for the business partner is to bechanged. Note
From Release 640 upwards the time-dependent address usages solutionprovided by Financial Services will be replaced by the time-dependentaddress usages for the SAP Business Partner.
The parameter will not have a function in this connection.
We therefore recommend that you no longer use this method.
To change addresses and time-dependent address usages, use the methodChangeAddress for the Business Object BusinessPartnerFS.Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Business Partner Number.Value range
The value range for the parameter corresponds to the value range for thedomain of the data element. Description
You can find information on the meaning of the parameter in thecorresponding documentation for the data element: Output: Severity of error (N/SPACE-normal, E/F/A-error).
With this parameter you can control which kind of message is to beissued during a duplicate check:
- E (error) or
- W (warning)
If the system issues message type E then it terminatesprocessing.Default
If no value is entered then message type E is used as default inthe standard system.Description
In this parameter the system returns addresses that it identified asbeing the same or similar when the current record was entered. The fieldADDRNUMBER contains the address numbers of the addresses that wereidentified as being the same or similar.
If these addresses are personal addresses then the relevant personnumber is entered in the field PERSNUMBER.
If the duplicate check tool supports the option, then the fieldPERCENTAGE contains the percentage showing how likely it is that theaddress record in question is a duplicate. Recommendation
From Release 640 upwards the time-dependent address usages solutionprovided by Financial Services will be replaced by the time-dependentaddress usages for the SAP Business Partner. We therefore recommend thatyou no longer use this method.
To create addresses and time-dependent address usages, use the methodChangeAddress for the Business Object BusinessPartnerFS.Description
This parameter contains the time-dependent address usages for the SAPBusiness Partner for Financial Services
With the time-dependent address usages you can assign an indefinitenumber of address types with fixed validityperiods to an address for a business partner.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.
The system checks the data in this parameter with regards to itsconsistency and the Customizing settings.
You can define address types in Customizing for the SAP BusinessPartner for Financial Services under General Settings -> BusinessPartner -> Basic Settings -> Address Determination-> Define AddressTypes.
The standard address is automatically assigned to the standard addressusage.
The assignment of addresses to the standard address usage cannot haveany gaps from the current date to 31.12.9999.
The indicator standard address set in the addresspool must always agree with the current entry in the standard addressusage and is automatically provided.
No further settings are needed for the indicators standard address
or standard address usage when you transfer the first addressto be added. When you create further addresses, observe the followingprocedure:
- If the indicator standard address is set, then you have to enter
a standard address usage (XXDEFAULT)
- If there is a valid standard address usage available for the
current date, then the indicator standard address isautomatically setValue range
The value range for this parameter corresponds with the value range forthe structure component. Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Relevant User DataField.
You have to transfer values for all fields to be changed in theparameter ADDRESSUSAGEDATES.Value range
'X' Change time-dependent address usages
' ' Do not change time-dependent address usages Description
This parameter contains information about the fax numbers for a businesspartner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in the prameterBAPIADFAX.Value range
'X' Change data for telefax numbers
' ' Do not change data for telefax numbers Description
This parameter contains information about the pager numbers for abusiness partner.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be entered in theparameter BAPIADPAG.Value range
'X' Change data for pager numbers
' ' Do not change data for pager numbers Description
This parameter contains information about the PRT (printer) addressesfor a business partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADPRT.Value range
'X' Change data for PRT addresses
' ' Do not change data for PRT addresses Description
This parameter contains information about the RFC addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADRFC.Value range
'X' Change data for RFC addresses
' ' Do not change data for RFC addresses Description
This parameter contains information about the RML addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADRML.Value range
'X' Change data for RML addresses
' ' Do not change data for RML addresses Description
This parameter contains information about the e-mail addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADSMTP.Value range
'X' Change data for e-mail addresses
' ' Do not change data for e-mail addresses Description
This parameter contains information about the SSF addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADSSF.Value range
'X' Change data for SSF addresses
' ' Do not change data for SSF addresses Description
This parameter contains information about the telephone numbers for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADTEL.Value range
'X' Change data for telephone numbers
' ' Do not change data for telephone numbers Description
This parameter contains information about the telex numbers for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADTLX.Value range
'X' Change data for telex numbers
' ' Do not change data for telex numbers Description
This parameter contains information about the teletex numbers for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADTTX.Value range
'X' Change data for teletex numbers
' ' Do not change data for teletex numbers Description
This parameter contains information about the URI addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADURI.Value range
'X' Change data for URI addresses
' ' Do not change data for URI addresses Description
This parameter contains data for international address versions fororganizations and groups.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.
You can currently add international address versions only to availableaddresses. You can use the change information (Parameter BAPIADVERSORG_XComponent UPDATEFLAG) to insert (I), update (U), or delete (D)international address versions. Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all of the fields to be changed in theparameter BAPIADVERSORG.
You can currently add international address versions only to availableaddresses. You can use the change information (UPDATEFLAG) to insert(I), update (U), or delete (D) address versions.Value range
'X' Change international address versions for organizations and groups
' ' Do not change international address versions for organizations andgroups Description
This parameter contains data for the international address versions forpersons.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary.
You can currently add international address versions only to availableaddresses. You can use change information (Parameter BAPIADVERSPERS_XComponent UPDATEFLAG) to insert (I), update (U), or delete (D)international address versions. Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADVERSPERS.
You can currently add international address versions only to availableaddresses. You can use the change information (Component UPDATEFLAG) toinsert (I), update(U), or delete (D) address versions.Value range
'X' Change international address versions for persons
' ' Do not change international address versions for persons Description
This parameter contains information about the X.400 addresses for abusiness partner in Business Address Services.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIADX400.Value range
'X' Change data for X400 addresses
' ' Do not change data for X400 addresses Description
This paramter contains notes on the addresses for a business partner.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPIAD_REM.Value range
'X' Change notes to addresses
' ' Do not change notes to addresses Description
This parameter contains notes on the communication types for thebusiness partner.
For more information about the individual parameter fields, see therelevant data element documentation in the ABAP Dictionary. Description
This parameter is a required (mandatory) parameter.
You can find information about the meaning of the parameter in thecorresponding documentation for the data element:Change (Updated) Information in Related User DataField.
You have to transfer values for all fields to be changed in theparameter BAPICOMREM.Value range
'X' Change notes on the communication types
' ' Do not change notes on the communication types Description
This table contains return messages from the method call.
|