Remote Function Adapter

The Remote Function Adapter function provides automated communication capabilities to other applications and systems so that they can be included in calculations and processes.

Key Features

Header

The following Remote Function Adapter types are available:

  • Finance Account Payable

    This function type enables you to post an accounts payable entry to SAP ERP or SAP S/4HANA. Each record is mapped to one posting, a GL account on one side and a vendor account on the other. If an RFC destination is defined at the environment level, the entries are posted in that system.

    For FI-GL integration scenarios with SAP ERP or SAP S/4HANA, this functionality will enable posting of general ledger documents from SAP Profitability and Performance Management. It makes use of the BAPI BAPI_ACC_DOCUMENT_POST. For further documentation refer to the function module documentation.

  • Finance Accounts Receivable

    This function type enables you to post an accounts receivable entry to SAP ERP or SAP S/4HANA. Each record is mapped to one posting, a customer account on one side and a GL account on the other. If an RFC destination is defined at the environment level, the entries are posted in that system.

    For FI-GL integration scenarios with SAP ERP or SAP S/4HANA, this functionality will enable posting of general ledger documents from SAP Profitability and Performance Management. It makes use of the BAPI BAPI_ACC_DOCUMENT_POST. For further information refer to the function module documentation.

  • Finance Extended

    This is a combination of the function types “Finance General Ledger” and “Finance Accounts Payable/Receivable”. If an RFC destination is defined at the environment level, the entries are posted in that system.

    The posting is only completed when one of the following GL accounts is mapped:

    • accountgl[1]

      In this case, the system creates a receivable document.

    • accountgl[[2]

      In this case, the system posts a payable document.

    For FI-GL integration scenarios with SAP ERP or SAP S/4HANA, this functionality will enable posting of general ledger documents from SAP Profitability and Performance Management. It makes use of the BAPI BAPI_ACC_DOCUMENT_POST. For further information refer to the function module documentation.

  • Finance General Ledger

    This function type enables you to post a general ledger entry to SAP ERP or SAP S/4HANA. Each record is mapped to one posting, a debit and a credit on each side. If an RFC destination is defined at the environment level, the entries are posted in that system.

    For FI-GL integration scenarios with SAP ERP or SAP S/4HANA, this functionality will enable posting of general ledger documents from SAP Profitability and Performance Management. It makes use of the BAPI BAPI_ACC_DOCUMENT_POST. For further information refer to the function module documentation.

    For more information about this function type, see RFA Type: Finance General Ledger.

  • Finance General Ledger Items

    This function type enables you to post a general ledger entry to SAP ERP or SAP S/4HANA, with multiple lines per document. A grouping field determines which lines are to be grouped into one document. Debit amounts (positive) and credit amounts (negative) should add up to zero.

    For the Remote Function Adapter types “Finance General Ledger” and “Finance General Ledger Items”, you can maintain the following values and perform the respective postings using the Document Status field:
    • header-docu_status = “2”: The system only simulates the document posting without posting the document in the target system.
    • header-docu_status = <blank>: The system posts a normal document.
    • header-docu_status = “V”: The system posts a parked document.

    The function type uses the BAPI BAPI_ACC_DOCUMENT_POST. For more information, see the function module documentation.

  • HANA R Script

    An external R script procedure is called. The expected interface of the external R script is displayed on the Rules tab. The R script can be entered directly on the Rules tab.

  • HANA Stored Procedure

    An external SAP HANA stored procedure is called. The expected interface of the external SAP HANA stored procedure is displayed on the Rules tab. You need to define the authoring schema that the system uses to store the procedure together with the procedure name.

    For more information about this function type, see Example of a SAP HANA Stored Procedure.

  • External Function

    The specified (remote) function module is called during the run. If the RFC destination specifies the local system, the function module can be either a regular function module or a remote-enabled module. If the RFC destination specifies a system other than the local system, the assigned function module has to be a remote-enabled module. The expected local interface of the external function is displayed on the Rules tab.

  • Replicate CO Master Data

    Replicates master data and hierarchies for specific and main controlling module fields like Cost Center, Cost Element, Profit Center etc. from an integrated SAP S/4HANA or SAP ERP system into SAP Profitability and Performance Management environment fields.

  • Sales and Distribution

    For integration scenarios with SAP ERP or SAP S/4HANA, this functionality enables creation of sales order, inquiry or quotation in SAP ERP or SAP S/4HANA Sales and Distribution module from SAP Profitability and Performance Management.

    It is mass processing enabled. Multiple and different documents can be created at once. It makes use of the Sales and Distribution BAPIs BAPI_SALESORDER_CREATEFROMDAT2, BAPI_INQUIRY_CREATEFROMDATA2 and BAPI_QUOTATION_CREATEFROMDATA2.

  • Financial Statement Items

    For FI-GL integration scenarios with SAP S/4HANA, this functionality enables retrieving of one or multiple (trial) balances from FI into SAP Profitability and Performance Management. This adapter leverages the FAC_FINANCIAL_STATEMENT_SRV SAP OData Service on the FI side.

    The following header fields are available only for Remote Function Adapter type “Financial Statement Items”:
    • Decimal Separator: Defines the separator to be used within the function.
    • HTTP RFC Destination: Here you can specify the RFC destination type “H” of the remote system, where input data is stored.

  • Purchase Order

    For integration scenarios with SAP ERP or SAP S/4HANA, this new Remote Function Adapter type allows you to create a purchase order in Material Management from SAP Profitability and Performance Management. It uses the BAPI BAPI_PO_CREATE1. For more information, see the function application help and function module documentation.

  • Secondary Cost Elements Posting

    For integration scenarios with SAP ERP or SAP S/4HANA, this new Remote Function Adapter type allows you to post manual cost allocation with secondary cost elements posting in Controlling from SAP Profitability and Performance Management. It uses the BAPI BAPI_ACC_MANUAL_ALLOC_POST. For more information, see the function application help and function module documentation.

  • Primary Cost Reposting

    For integration scenarios with SAP ERP or SAP S/4HANA, this Remote Function Adapter type allows you to repost primary cost posting in Controlling from SAP Profitability and Performance Management. It uses the BAPI BAPI_ACC_PRIMARY_COSTS_POST.

  • Replicate InfoObject Master Data

    This functionality enables to replicate the master data of info objects from remote systems (for example SAP ERP or SAP S/4HANA) into corresponding environment fields within SAP Profitability and Performance Management.

    For more information about this function type, see RFA Type: Replicate InfoObject Master Data.

  • Post Journal Entries for Group Reporting

    This Remote Function Adapter type enables you to post and simulate journal entries in group reporting in SAP S/4HANA using the synchronous inbound service API_CNSLDTNGRPJRNLENTR.

    For more information about this function type, see RFA Type: Post Journal Entries for Group Reporting.

Depending on the selected Remote Function Adapter type, a subset of the following fields is available:

  • RFC Destination

    The RFC destination of type “ABAP Connection” specified in this field is used to post documents, call external reports, get master data and hierarchies. The RFC destination must exist in SM59 before use. If no value is entered in this field, the local client and system is used.

  • HTTP RFC Destination

    The RFC destination of type “HTTP Connection” specified in this field is used if you need to execute SAP OData services (for example, for the Remote Function Adapter type “Financial Statements Items”).

  • Field Length Extension Mode

    This read-only field indicates the data type of the amount fields that the remote system specified in the RFC destination uses:
    • Not extended, compatibility mode – amount values of type DECIMAL(23,4)
    • Target mode – amount values of type DECIMAL(31,8)

  • Authoring Schema

    This is mapped in the physical schema into transported or stored objects using the SAP HANA database.

  • Stored Procedure

    This is the name of the stored procedure to be executed.

  • Decimal Separator

    Defines the separator to be used within the function.

  • Function Name

    Specifies the name of a remote NetWeaver Function or a web service which is called to display the expected interface on the Rules tab.

All other header options, such as Include Original Input Data, Result Handling, Suppress Initial Results and Result Model Table are referred to as “Functional Building Blocks” and are not specific to the Remote Function Adaper function. For more information about these options, see Header.

Input

For more information about modeling input, see Input.

Rules

  • Rule format: Table Form

    This is available for the following remote function types: Finance, Replicate CO Master Data and Sales Distribution

    • Component

      Corresponding component item relevant for the specific Remote Function Adapter

    • Name

      Component description

    • Declaration Type

      Input: Entered field or value that is sent to the corresponding component in the target system defined in the RFC destination. If the RFC destination is not defined, the input will be posted or updated within the source system.

      Output: The field specified here receives the corresponding component value from the target system defined in the RFC destination, and is included in the run result.

    • Is Mandatory

      Green: Is Mandatory field is set to “Yes”. This indicates that an entry has to be made for this component.

      Orange: Is Mandatory field is set to “Yes”. This indicates that an entry has not been made for this component.

      Grey: Is Mandatory field is set to “No”. This indicates that an entry is not required for this component.

    • Field

      Fields that you can use with this function based on the input function.

    • Description

      Field description

  • Rule format: Template and Statement

    This is available for the following remote function types: HANA Stored Procedure and External Function

    • Template

      Is used as the template guide for creating the procedure that is called in the Remote Function Adapter – HANA Stored Procedure and External Function.

    • Statement

      The system displays the expected interface, provided you have defined the procedure in the header of the function.

    This is available for remote function type: HANA R Script

    • Template

      Is used as the template guide for creating scripts that are executed by the Remote Function Adapter – HANA R Script.

    • Statement

      You can enter script directly on the user interface of the Remote Function Adapter.

RFC Destination

For FI-GL and FI-GLI types, there are two ways of adding the RFC destination:

  • Environment level

  • Function level

If the RFC destination is maintained on both an environment level and function level, the RFC destination to be followed gets maintained on the function level.

For SAP Profitability and Performance Management 3.0 SP07 or below, you cannot maintain an RFC destination inside these function types, but you can for SP08 and above. See SAP Note 2902513 Information published on SAP site for further details.

Procedure

Function Access

Follow the steps below to access the Remote Function Adapter function:

  1. In the client where SAP Profitability and Performance Management is installed, choose Start of the navigation pathSAP Menu Next navigation step Profitability and Performance Management Next navigation step Modeling Next navigation step Start My EnvironmentsEnd of the navigation path.

  2. The Environment screen appears in a separate browser window. Choose an existing environment and continue. Within the environment, you can set up the newly added function.

Function Configuration

Follow the steps below to configure the Remote Function Adapter function:

  1. In edit mode, configure the following required fields in the header. For more information about the header, see the Key Features section above.

    • Remote Function Adapter Type
    • RFC Destination
    • Function Name
    • Field Length Extensions Made
    • HTTP RFC Destination
    • Decimal Separator
    • Suppress Initial Results
    • Result Model Table
    • Include Original Input Data
    • Result Handling
    • Authoring Schema
    • Stored Procedure

  2. Define the input function to be used on the Input tab.

  3. Define the fields to be used on the Signature tab.

  4. Define rules on the Rules tab.

  5. Define the checks to be used on the Checks tab, if needed.

  6. Choose Save and then choose Activate.

Related Information

  • For more information about common aspects of SAP Profitability and Performance Management functions, see Concepts for Key Users.

  • For more information on how to add and remove functions in SAP Profitability and Performance Management environments, see Function Hierarchy.