Fonction SAP BAPI_CATIMESHEETMGR_CHANGE - CATS: Change 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 X Text Format for Import of Long Texts

Paramètre Reférence Long. Facultatif Description
CATSRECORDS_IN BAPICATS3 752 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 change time data recorded in external systemsor applications in the SAP Time Sheet.
The following functions are supported:
Change attendances/absences and wage types for Human Resources (HR)
Change activity allocation for Controlling (CO)
Change confirmations for Project System (PS)
Change confirmations for Plant Maintenance (PM) or Customer Service (CS)
Change external services for Materials Management (MM)
IF &[SWITCH]CATS_PRS_SFWS_1& = 'X'.
Change 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
Changing Data Records
If you change records that have already been approved, the systemcancels the original record and creates a new record. The originalrecord can be identified for this purpose using the internal counter oran external document number.
If you enter an external document number for the original record, theEXTSYSTEM, EXTAPPLICATION, and EXTDOCUMENTNO fields in the CATSDB tableare filled. If you change this record, it is identified via theEXTSYSTEM_OLD, EXTAPPLICATION_OLD, and EXTDOCUMENTNO_OLD fields. The newrecord is assigned a new document number via the EXTSYSTEM,EXTAPPLICATION, and EXTDOCUMENTNO fields.
If the records to be changed have not yet been approved, they are simplyoverwritten.
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.

Default

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 records.

Description
If you defined additional customer fields in your external applicationor external system and in the R/3 System, and you want to transfer datafrom them to the R/3 System, you can use this import table. Theadditional customer fields are reproduced in the customer-specificfields in the CATSDB table using the BAPI_TE_CATSDB structure.
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 the same as theBAPI_TE_CATSDB structure. The first ten characters of the data part arefor the line numbers. The customer fields are linked to thecorresponding data record in the CATSRECORDS_IN table via 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 ten 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. The addi
tional customer fields are reproduced in the customer-specific fields inthe CATSDB table 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 customer fields 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.