Fonction SAP BAPI_CATIMESHEETMGR_INSERT - CATS: Insert data records

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
AGENT SWHACTOR u 14 X Workflow Recipient
PROFILE BAPICATS6-PROFILE C 8 X Data Entry Profile
RELEASE_DATA BAPICATS6-RELEASE_DATA C 1 X Release Data
TESTRUN BAPICATS6-TESTRUN C 1 X Test Run
TEXT_FORMAT_IMP BAPICATS6-TEXT_FORMAT_IMP C 5 'ITF' X Text Format for Import of Long Texts

Paramètre Reférence Long. Facultatif Description
CATSRECORDS_IN BAPICATS1 705 Data Import
CATSRECORDS_OUT BAPICATS2 839 X Data Export
EXTENSIONIN BAPICATS7 990 X Customer Enhancement Import
EXTENSIONOUT BAPICATS7 990 X Customer Enhancement Export
LONGTEXT BAPICATS8 140 X Long Text Format
RETURN BAPIRET2 548 Confirmations
SA_EXTENSION_IN BAPICATS7 990 X Reference Structure for BAPI Parameters ExtensionIn/ExtensionOut
SA_EXTENSION_OUT BAPICATS7 990 X Reference Structure for BAPI Parameters ExtensionIn/ExtensionOut
WORKFLOW_TEXT SOLISTI1 255 X Workflow Text

Functionality
You can use this method to insert time data recorded in external systemsor applications in the SAP Time Sheet.
The following functions are supported:
Insert records that generate attendances/absences and wage types forHuman Resources (HR)
Insert records that trigger activity allocation for Controlling (CO)
Insert records that generate confirmations for Project System (PS)
Insert records that generate confirmations for Plant Maintenance (PM) orCustomer Service (CS)
Insert records with information on external services for MaterialsManagement (MM)
IF &[SWITCH]CATS_PRS_SFWS_1& = 'X'.
Insert records that generate confirmations for Lean Staffing (LS)(service attributes)
Note
This function is only supported if you use the Professional ServicesOrder Processing and Personnel Planning (PRS_ERP_CPILS_1) businessfunction in your system.
ENDIF.

Notes
Posting Data Records
When you post data using this method, you should note that data recordsare only posted if none of the data records to be posted contain errors.If an error occurs during posting, none of the data, including data thatdoes not contain errors, is posted. Therefore, schedule data to beposted as often as possible and include only a small number of recordsin each posting.
You should also note that, when posting begins, all numeric fields notin use must be set to initial. You do this by filling all characters ofthe relevant fields with '0'.
Confirmations
INCLUDE BAPI_RET

Description
You use this import paramter to enter a recipient for the workflow. Theobjects available for selection are the user, the position, the workcenter, and the organizational unit.

Description
For information on the significance of this import parameter, see thedata element documentation: Data Entry Profile.

Description
If you did not select Release on saving when you maintained yourprofile, a separate release step is necessary. This import parameterexecutes the release step automatically.

Description
For information on the significance of this import parameter, see thedata element documentation: Test Run.

Description
You use this import table to provide the method with the data you wantto post.

Description
You use this export table to return the valuated and completed datarecords.

Description
If you defined additional customer fields in your external applicationor external system as well as in the SAP System and you want totransfer data from them to the SAP System, you can use this importtable. The additional customer fields are reproduced in thecustomer-specific fields in the CATSDB table using the BAPI_TE_CATSDBstructure.
You should enter the name of the structure in the STRUCTURE field. Thecontents of the BAPI_TE_CATSDB structure is contained in the data part.The data part of this table must be structured analogously to theBAPI_TE_CATSDB structure. The first 10 characters of the data part arefor the line numbers. The customer fields are linked to thecorresponding data record in the CATSRECORDS_IN table using the linenumbers.

Description
If you use customer fields in the time sheet, you can use this exporttable to obtain information on the data they contain. The additionalcustomer fields are reproduced in the customer-specific fields in theCATSDB table using the BAPI_TE_CATSDB structure.
The name of the structure is returned in the STRUCTURE field. Thecontents of the BAPI_TE_CATSDB structure is contained in the data part.The data part of this table must be structured analogously to theBAPI_TE_CATSDB structure. The first 10 characters of the data part arefor the line numbers. The customer fields are linked to thecorresponding data record in the CATSRECORDS_OUT table using the linenumbers.

Description
This export table contains the confirmations from the method call.

Description
If you have set up service attributes in your external application orexternal system as well as in the SAP system, and you want to transferdata from the service attributes to the SAP system, then you use thisimport table to do this. The service attributes are reproduced in theservice attributes in the CATSDB table using the BAPI_SA_CATSDBstructure.
You must enter the name of the structure in the STRUCTURE field. Thecontents of the BAPI_SA_CATSDB structure are contained in the data part.The data part of this table must be structured in the same way as theBAPI_SA_CATSDB structure. The first 10 characters of the data part arefor the line numbers. The service attributes are linked to thecorresponding data record in the CATSRECORDS_IN table using the linenumbers.
Note
You can use this parameter only if you use the Commercial ProjectInception and Lean Staffing business function (PRS_ERP_CPILS_1) inyour system. Otherwise, the system outputs an error message.

Description
If you use service attributes in the Time Sheet, you can obtaininformation on the associated data using this export table. These se
rvice attributes are reproduced in the service attributes in the CATSDBtable using the BAPI_SA_CATSDB structure.
The name of the structure is returned in the STRUCTURE field. Thecontents of the BAPI_SA_CATSDB structure are contained in the data part.The data part of this table must be structured in the same way as theBAPI_SA_CATSDB structure. The first 10 characters of the data part arefor the line numbers. The service attributes are linked to thecorresponding data record in the CATSRECORDS_OUT table using the linenumbers.
Note
You can use this parameter only if you use the Commercial ProjectInception and Lean Staffing business function (PRS_ERP_CPILS_1) inyour system. Otherwise, the system outputs an error message.

Description
You use this import table to enter a message for the workflow.