Sapass

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



Index

EmployeePrivateAdrHK

EmployeePrivateAdrHK


The business object Employee Address - HK contains the details about the personal addresses of the employee.


You can assign more than one type of address to an employee.


Use


Information about addresses are stored in the Addresses infotype
(0006). The details provided in this infotype can be used to create employee lists, address labels, or forms.


Structure


This structure contains the following details:


  • type of address (for example, permanent residence, temporary residence and emergency address)

  • the address itself.

  • 11-Dec-2005


    Methods

    Available Methods


    • Approve : Unlock Employee Address [ BAPI_ADDRESSEMP_APPROVE ]
    • Change : Change employee address [ BAPI_ADDREMPHK_CHANGE ]
    • Create : Create employee address [ BAPI_ADDREMPHK_CREATE ]
    • CreateSuccessor : Create subs.employee address record [ BAPI_ADDREMPHK_CREATESUCCESSOR ]
    • Delete : Delete Employee Address [ BAPI_ADDRESSEMP_DELETE ]
    • Delimit : Delimit Employee Address Validity Period [ BAPI_ADDRESSEMP_DELIMIT ]
    • GetDetail : Read employee address [ BAPI_ADDREMPHK_GETDETAIL ]
    • GetDetailedList : GetDetailedList [ BAPI_ADDREMPHK_GETDETAILEDLIST ]
    • Getlist : Read Instances [ BAPI_ADDRESSEMP_GETLIST ]
    • Request : Create locked employee address record [ BAPI_ADDREMPHK_REQUEST ]
    • SimulateCreation : Simulation: Create employee address [ BAPI_ADDREMPHK_SIMULATECREATE ]

    11-Dec-2005


    Approve

    Approve


    You can use this method to unlock an Addresses record (0006).

    It enables you to implement the "double verification principle" inconjunction with the REQUEST method. According to this principle, atleast two users must take part in writing an active record to the
    database. One user creates a locked record using the REQUEST method.The other user unlocks or 'activates' this record using the APPROVE method.

    Notes

    Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.


    The key fields used by the method are described in the parameter documentation.

    You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.


    For more information on the REQUEST method, read the documentation on the function module BAPI_ADDRESSEMP_REQUEST.


    11-Dec-2005


    Change

    Change


    You can use this method to change an Addresses record (0006).

    Notes

    Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

    The key fields used by the method are described in the parameter documentation.


    You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.


    11-Dec-2005


    Create

    Create


    You can use this method to create an Addresses record (0006).

    Notes

    Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

    The key fields used by the method are described in the parameter documentation.


    You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.


    11-Dec-2005


    CreateSuccessor

    CreateSuccessor


    You can use this method to create a subsequent Addresses record (0006).

    Example

    An employee lives in street 'A' and city 'A'. This data is stored in the Addressess infotype (0006) for the validity period from 01/01/1990 - 12/31/1999.


    The employee moves on 01/01/1997. The new address is street 'B' in city 'A'.

    You can use the CREATESUCCESSOR method to create a subsequent Addresses record (0006). The subsequent record contains the data of the previous record, only the Street/house number
    field has to be changed.

    The previous record is delimited on 12/31/1996.

    Notes

    Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

    The key fields used by the method are described in the parameter documentation.


    You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.


    11-Dec-2005


    Delete

    Delete


    You can use this method to delete an Addresses record (0006).

    Notes

    Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

    The key fields used by the method are described in the parameter documentation.


    You can use this method only if you have called the ENQUEUE method of the business object EMPLOYEE beforehand. For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.


    11-Dec-2005


    Delimit

    Delimit


    You can use this method to chronologically delimit a data record for the Adresses infotype (0006).

    Notes

    Messages are returned in the RETURN parameter. The return codes and their meanings can be found in this parameter documentation.

    The key fields used by the methods are described under the parameters.

    This method can only be used if the ENQUEUE method of the EMPLOYEE business object has been called up first. You can find more information about the ENQUEUE method in the documentation of the
    BAPI_EMPLOYEE_ENQUEUE function module.


    11-Dec-2005


    GetDetail

    GetDetail


    You can use this method to read an Addresses record (0006).

    Notes

    Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

    The key fields used by the method are described in the parameter documentation.



    11-Dec-2005


    GetDetailedList

    GetDetailedList


    You can use this method to read an Addresses infotype record(0006) for an employee in Hong Kong that exist within the specified time interval.

    Notes

    Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.


    The key fields used by the method are described in the parameter documentation.


    11-Dec-2005


    Getlist

    Getlist


    You can use this method to read the keys (instances) of Addresses records (0006) which are within the specified time interval.

    Notes

    Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.


    The key fields used by the method are described in the parameter documentation.


    11-Dec-2005


    Request

    Request


    You can use this method to create a locked Addresses infotype record (0006) for an employee in Hong Kong.

    It enables you to implement the "double verification principle" inconjunction with the APPROVE method. According to this principle, at
    least two users must take part in writing an active record to thedatabase. One user creates a locked record using the REQUEST method.The other user unlocks or 'activates' this record using the APPROVE method.

    Notes

    Messages are transferred to the RETURN parameter. The relevant
    parameter documentation contains the return values and their meanings.

    The key fields used by the method are described in the parameter documentation.

    You can only use this method if you have called the ENQUEUE method of the business object EMPLOYEE
    beforehand. For more information on the ENQUEUE method, see the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.

    Further Information

    For more information on the ENQUEUE method, read the documentation on the function module BAPI_EMPLOYEE_ENQUEUE.


    For more information on the APPROVE method, read the documentation on the function module BAPI_ADDRESSEMP_APPROVE.


    11-Dec-2005


    SimulateCreation

    SimulateCreation


    You can use this method to simulate creation of an Addresses infotype record (0006) for an employee in Hong Kong.

    During simulation, the system performs all the required consistency checks without writing the record to the database.

    Notes


    Messages are transferred to the RETURN parameter. The relevantparameter documentation contains the return values and their meanings.

    The key fields used by the method are described in the parameter documentation.


    11-Dec-2005