Sapass

 Simplify SAP R/3 development with Excel VBA/VB RFC  
Home> Bapi>BusPartnerContact



Index

BusPartnerContact

BusPartnerContact


The business object Business partner contact is a documentation
on communication with a customer, sales partner or competitor.

Structure

A sales activity can be created on the basis of other sales activities.

Integration

A partner sales activity is always assigned to a sales organization.
This sales organization can also be limited to a distribution chain or a sales area.

Example

Sales calls, telephone calls, sales letters


11-Dec-2005


Methods

Available Methods


  • AddToAssigned : Add Object Links of Category Assigned [ BAPI_BPCONTACT_ADD_TO_ASGN ]
  • ChangeMultiple : Flag for Change [ BAPI_BPCONTACT_CHANGE ]
  • CreateFromDataMultiple : Flag for Immediate Creation [ BAPI_BPCONTACT_CREATEFROMDATA ]
  • CreateFromDataWithDialog : Create Data Container with Dialog [ BAPI_BPCONTACT_CREATEWITHDIA ]
  • DeleteMultiple : Flag for Deletion [ BAPI_BPCONTACT_DELETE ]
  • GetDetail : Details on Partner Sales Activities [ BAPI_BPCONTACT_GETDETAIL ]
  • GetList : Lists with Selection Criteria [ BAPI_BPCONTACT_GETLIST ]
  • RemoveFromAssigned : Delete Object Links of Category Assigned [ BAPI_BPCONTACT_REMOVEFROM_ASGN ]
  • Replicate : Send Partner Sales Activities as IDoc [ BAPI_BPCONTACT_REPLICATE ]
  • ReplicateChanged : Send Changed Partner Sales Activities as IDoc [ BAPI_BPCONTACT_REPLICATECHANGE ]
  • SaveFromMemory : Save Flagged Objects from Global Memory [ BAPI_BPCONTACT_SAVEFROMMEMORY ]
  • SetSimulatedToActive : Simulated Objects are Flagged for Saving [ BAPI_BPCONTACT_SETTOACTIVE ]

11-Dec-2005


AddToAssigned

AddToAssigned


This BAPI function module is used to create object references for apartner sales activity in order to assign objects to a partner sales activity subsequently.

The data base change will only be initiated by the method BapiService.TransactionCommit.


The relevant method has been implemented as a class method. The returnparameter contains the processing log. It contains all messages (error, warning, information) from the consistency check.

Notes

The update is ist encapsulated in a PERFORM ... ON COMMIT.



11-Dec-2005


ChangeMultiple

ChangeMultiple


You can use this BAPI function module to change partner salesactivities. In order to change the database, the following methods have to be called:

  1. BusPartnerContact.Save
  2. BapiService.TransactionCommit

The relevant method has been implemented as a class method. The Return
parameter contains the processing log. It includes all messages (error, warning, information) from the consistency check.

Further Information

SFA Interface (Specification and Design)


11-Dec-2005


CreateFromDataMultiple

CreateFromDataMultiple


You can use this BAPI function module to create partner salesactivities. In order to change the database, the following methods have to be called:

  1. BusPartnerContact.Save
  2. BapiService.TransactionCommit

The relevant method has been implemented as a class method. The Return
parameter contains the processing log. The log includes all messages (error, warning, information) from the consistency check.

Assignment of key fields:

  • Create with reference to an external reference object
  • REFOBJECTTYPE Object type of reference object, here "PROXY0001" or subtype
    REFOBJECTKY
    Key of reference object type
    DOC_NUMBER not relevant
    REFDOCTYPE not relevant
    REFRELTYPE Binary relationship type, here 'VORL'

    The generated object reference can be displayed in the sales activity.

  • Create with reference to an internal reference object

  • REFOBJECTTYPE Object type of reference object
    REFOBJECTKY Key of reference object
    DOC_NUMBER not relevant
    REFDOCTYPE Sales activity type of reference object (only ifreference = sales activity)
    REFRELTYPE Binary relationship type


    The generated object reference can be displayed in the sales activity.

  • Create without reference to a reference object
  • REFOBJECTTYPE blank
    REFOBJECTKY blank
    DOC_NUMBER Handle
    REFDOCTYPE not relevant

    REFRELTYPE blank

    The fields REFOBJECTTYPE, REFOBJECTKY and DOC_NUMBER are internally identifying for an instance!

    Further Information

    SFA Interface (Specification and Design)


    11-Dec-2005


    CreateFromDataWithDialog

    CreateFromDataWithDialog


    You can use this BAPI function module to create partner salesactivities. In order to change the database, the following methods have to be called:

    1. BusPartnerContact.Save
    2. BapiService.TransactionCommit

    The relevant method has been implemented as a class method. The Return
    parameter contains the processing log. It includes all messages (error, warning, information) from the consistency check.

    Further Information

    SFA Interface (Specification and Design)


    11-Dec-2005


    DeleteMultiple

    DeleteMultiple


    You can use this BAPI function module to delete partner salesactivities. In order to change the database, the following methods have to be called:

    1. BusPartnerContact.Save
    2. BapiService.TransactionCommit

    The relevant method has been implemented as a class method. The Return
    parameter contains the processing log. It includes all messages (error, warning, information) from the consistency check.

    Further Information

    SFA Interface (Specification and Design)


    11-Dec-2005


    GetDetail

    GetDetail


    The system uses this BAPI function module to read partner salesactivities. The identification of the partner sales activities should be used as input parameter.

    Further Information

    SFA interface (Specification+Design)


    11-Dec-2005


    GetList

    GetList


    You can use one of the intervals of the organizational units or the SDOrganizationalUnits parameter to select data.

    Priority rule:

    1. SDOrganizationalUnits
    2. Multiple selection

    If all selection parameters are filled, the resulting quantity is the cross product of the organizational units.


    For example, you have defined the following selection criteria:

  • Sales organization: 0001
  • Distribution channel: 01 - 04
  • The system takes all possible combinations of these criteria into account:

    Sales organization 0001 Distribution channel 01


    Sales organization 0001 Distribution channel 02

    Sales organization 0001 Distribution channel 03

    Sales organization 0001 Distribution channel 04

    Further Information

    SFA Interface (Specification and Design)


    11-Dec-2005


    RemoveFromAssigned

    RemoveFromAssigned


    This BAPI function module is used to delete relationships of businessobjects with the type "Assigned". This method can be used to remove object references from a partner sales activity.

    The data base change will only be initiated by the method BapiService.TransactionCommit .


    The relevant method has been implemented as a class mehtod. The returnparameter contains the processing log. It contains all messages (error, warning, information) from the consistency check.

    Notes

    The update is encapsulated in a PERFORM ... ON COMMIT.



    11-Dec-2005


    Replicate

    Replicate


    This function module selects sales activities and sends them asynchronously via ALE. The receiving system calls the

  • SaveReplicaMultiple method.
  • The InitialDownload parameter has priority over the SalesActivityID parameter.


    11-Dec-2005


    ReplicateChanged

    ReplicateChanged


    The system uses the transmitted ALE message type (MessageTypeparameter) to read and evaluate all ALE change pointers. The output ispacked in IDocs and transmitted asynchronously to the ALE service. This service calls the SaveReplicaMultiple
    method in the target system.

    Further Information

    SFA Interface documentation (Specification and Design)


    11-Dec-2005


    SaveFromMemory

    SaveFromMemory


    This BAPI function module saves partner sales activities which have been placed in the global memory with the following methods:

  • CreateFromDataMultiple
  • ChangeMultiple
  • DeleteMultiple
  • The relevant method has been implemented as a class method. The system returns the keys of the created objects in the
    SalesActivityBOID
    parameter. Note that follow-up activities are also created. The Return parameter contains the processing log. The log contains all messages (error, warning, information) from the consistency check.

    Further Information


    SFA Interface (Specification and Design)


    11-Dec-2005


    SetSimulatedToActive

    SetSimulatedToActive


    Abstract method.
    The implementation takes place in the subtypes.

    If a method is called with the Simulate indicator, the systemonly tests the objects and does not flag them for saving. The Return parameter transmits a processing log. You can use this method to flag consistent objects for saving. To do this, the handle
    must be transmitted in the SalesActivityID parameter.


    11-Dec-2005