|
Functionality
An RFC-enabled function module to determine data for one or morecommission contract.
The return tables always contain a line for each commission contract IDthat is transferred, even if no data was determined for the ID. In thiscase the transferred ID is specified, but the other fields are empty.
After the call, the return table must be evaluated since the functionmodule still attempts to determine more data even if errors haveoccurred (for instance if the contract is not valid on the transferreddate). Any messages from the method calls are likewise logged in thereturn table.
If any basic Customizing is missing, the function module also sends anexception. Notes
This function module is not suitable for mass processing or forperformance-critical usage.
If the module is called remotely, the structure of the database tableCACS_CTRTBU should be the same in all the systems that participate inthe communication. Description
Header data of the commission contract, including the data of ICM periodmanagement and all customer appends for table CACS_CTRTBU.
For each contract, the line for the version that is valid on thetransferred date (effective and technical date) is transferred.
If no valid version exists, the version with the validity date nearestto the effective date is transferred. Description
Table of table type CACS_TT_CTRTBU_INFO that is defined in the DataDictionary. The lines in this table correspond exactly with those oftable IT_CTRTB_IDS, however they also contain the contract ID for easieraccess.
Fields of structure CACS_S_ORGDATA_O_S:
For each line, the position assigned to the contract in field POS_ID isreturned with text (in POS_TEXT), as long as a staff assignment for thecontract exists for the time determined by IV_CLC_TIMESTAMP. In thiscase, field NOT_POSITION is set to value #0#. The organizational unit isalso determined for the position and returned in OE_ID that is assignedto the position; the text description is also returned for the positionin OE_TEXT. If the commission contract is assigned directly to anorganizational unit, only the OU is determined and the field for theposition remains initial in the return structure.
The NOT_POSITION field accepts the values '1', '2' and 'X' as well as'0' already mentioned above; this is explained below.
If no staff assignment exists at the time of access, however one existedat another time or is planned for the future, the assignment with theearliest assignment date (BEGDA) for the commission contract isdetermined and returned as described above. In this case, fieldNOT_POSITION is set to value #X#.
Field OCC_BEGIN is always filled with the start date of theorganizational assignment of the contract that is returned (BEGDA).
If no staff assignment ever existed for this contract and none isplanned for the future, field NOT_POSITION is filled with value '2'.
In the event of an internal error, field NOT_POSITION may contain value'1' . If other fields are filled, their content is consequently invalid.
Additional fields:
Field PARTNER_NAME contains the name of the commission contract partner,and field PARTNER_DESCRIPTION contains the name, postal code and city ofthe standard address for the contract partner.
Field DESCR_LONG contains a description of the information determined bythe BTE PRCACS0002. The default implementation of this BTE returns thedescription of the standard contract for the respective commissioncontract.
Field OCC_AGENT contains an X if the contract is one for agents withouttheir own commission contract.
See also the documentation of Business Transaction Event (BTE)PRCACS0002 and function modules CACS_SAMPLE_PRC_0002 andCACS_CTRST_DESCRIPT_GET. Description
This table contains error messages, confirmations from the method callsand perhaps also further information on the effective, technical andlegal validity of the transferred commission contracts. Description
Tables with ID's of commission contracts for which the function moduleis to determine data. Description
Commission application for which the determination is performed. Theexistence of a commission application is not checked. This parameter ismandatory. Description
Effective access time. When initial, the current time stamp (UTC, usingGET TIME STAMP) is applied. Description
Technical access time. When initial, the current time stamp (UTC, usingGET TIME STAMP) is applied. |