| Description | Query External Time Recording Setup Information |
| Name | TimeAndLabourManagementRecordingSetupInformationRequestingIn |
| Namespace | http://sap.com/xi/AP/TimeAndLabourManagement/Global |
| Process Component Description | Time and Labour Management |
| Process Component Name | TimeAndLabourManagement |
| Process Component Namespace | http://sap.com/xi/AP/TimeAndLabourManagement/Global |
| Deployment Unit Description | Human Capital Management |
| Endpoint Activation | By Communication Arrangement | Operations |
| Release Status | Released |
An interface to provide information to setup an external time recording system.
This message is sent from the SAP ByDesign system to the External Time Recording System (ETRS) as synchronous response to a query triggered by the ETRS. The response contains the Employee Time Recording Card ID, the name of the employee as well as the information on whether the employee participates in external time recording. The message contains all employees requested via the query that have an Employee Time Recording Card ID maintained in the SAP ByDesign system, not depending on whether the employee participates in time recording via terminals.
The scheduling of the query is in the responsibility of ETRS.
Example
<n0:EmployeeTimeAgreementTimeRecordingSystemSetupByElementsQuery_sync xmlns:n0="http://sap.com/xi/AP/TimeAndLabourManagement/Global"> <MessageHeader> <ID>00300571D06B1DED92A0C57978891967</ID> <CreationDateTime>2012-07-20T06:42:37.789+01:00</CreationDateTime> <SenderParty> <InternalID schemeID="CommunicationSystemID" schemeAgencyID="310">ETRS</InternalID> </SenderParty> <BusinessScope> <TypeCode listID="25201" listAgencyID="310">2</TypeCode> <ID schemeID="10555" schemeAgencyID="310">29</ID> </BusinessScope> <BusinessScope> <TypeCode listID="25201" listAgencyID="310">3</TypeCode> <ID schemeID="10555" schemeAgencyID="310">251</ID> </BusinessScope> </MessageHeader> <EmployeeTimeAgreementTimeRecordingSystemSetupSelectionByElements> <CompanyID>MC1000</CompanyID> </EmployeeTimeAgreementTimeRecordingSystemSetupSelectionByElements> </n0:EmployeeTimeAgreementTimeRecordingSystemSetupByElementsQuery_sync>
You can find general information about Web services, their structure and consumption in the Web Services documentation.
| Description | Find external time recording setup information |
| Name | Provide |
| Synchronous | yes |
| Release Status | Released |
To provide information for the setup of an external time recording system.
This service is offered to retrieve employee master data information from the ByDesign system that are required for the operation of the External Time Recording System. The communication is organized as a query response messages with message types
Employee Time Agreement Time Recording System Setup By Elements Query_sync
EmployeeTimeAgreementTimeRecordingSystemSetupByElementsResponse_sync
Employee Time Agreement Time Recording System Setup By Elements Query_sync
A query of an External Time Recording System about relevant information in an employee time agreement.
EmployeeTimeAgreementTimeRecordingSystemSetupByElementsResponse_sync
A response to a query of an External Time Recording System about relevant information in an employee time agreement
| Structure Element | Description |
|---|---|
| ID | Unique GUID generated for each message, such as 00300571D06B1DDCA08F250379A2417B |
| CreationDateTime | Creation time stamp of the message, such as 2008-12-31T23:59:59.1234Z |
| EmployeeUUID | Unique GUID generated for each employee, such as 4829 |
| EmployeeID | Employee ID, such as MC1572 |
| EmployeeTimeRecordingCardID | Time recording card ID, such as 4809 |
| EmployeeTimeEventUsageCode | A usage code for employee master data for external time recoding system, such as 1. The values are: <1> - Time events are used for working time determination in the SAP ByDesign system, that is, the employee is participating in time recording via terminals. <No code value> or <value other than 1> - The employee is not participating in time recording via terminals. The employee information is contained in the message as the employee has been assigned an Employee Time Recording Card ID in the SAP ByDesign system (Example, for access control usage) |
| StartDate | Start Date of Employee Time Agreement, such as 2012-01-01 |
| EndDate | End Date of Employee Time Agreement, such as 2018-12-31 |
| GivenName | Employee given name, such as Pete |
| FamilyName | Employee family name, such as Graham |
| FormattedName | Employee formatted name, for example, for display at the terminal, such as Pete Graham |
| NonVerbalCommunicationLanguageCode | EN |
Sample Query
<n0:EmployeeTimeAgreementTimeRecordingSystemSetupByElementsQuery_sync xmlns:n0="http://sap.com/xi/AP/TimeAndLabourManagement/Global"> <MessageHeader> <ID>00300571D06B1DED92A0C57978891967</ID> <CreationDateTime>2012-07-20T06:42:37.789+01:00</CreationDateTime> <SenderParty> <InternalID schemeID="CommunicationSystemID" schemeAgencyID="310">ETRS</InternalID> </SenderParty> <BusinessScope> <TypeCode listID="25201" listAgencyID="310">2</TypeCode> <ID schemeID="10555" schemeAgencyID="310">29</ID> </BusinessScope> <BusinessScope> <TypeCode listID="25201" listAgencyID="310">3</TypeCode> <ID schemeID="10555" schemeAgencyID="310">251</ID> </BusinessScope> </MessageHeader> <EmployeeTimeAgreementTimeRecordingSystemSetupSelectionByElements> <CompanyID>MC1000</CompanyID> </EmployeeTimeAgreementTimeRecordingSystemSetupSelectionByElements> </n0:EmployeeTimeAgreementTimeRecordingSystemSetupByElementsQuery_sync>
Sample Response
<nm:EmployeeTimeAgreementTimeRecordingSystemSetupByElementsResponse_sync xmlns:nm="http://sap.com/xi/AP/TimeAndLabourManagement/Global" xmlns:prx="urn:sap.com:proxy:HGE:/1SAI/TAS0B289CE66336FE4924A5:804"> <MessageHeader> <ID>00163E0344211ED287B6588C99961EB3</ID> <CreationDateTime>2012-10-24T08:14:01.681775Z</CreationDateTime> </MessageHeader> <EmployeeTimeAgreementTimeRecordingSystemSetup> <EmployeeUUID>00145ef5-88e6-02db-bcdf-489a915c84ec</EmployeeUUID> <EmployeeID>MC1572</EmployeeID> <EmployeeTimeRecordingCardID>7353</EmployeeTimeRecordingCardID> <EmployeeTimeEventUsageCode>1</EmployeeTimeEventUsageCode> <EmployeeCommon> <ValidityPeriod> <StartDate>0001-01-01</StartDate> <EndDate>9999-12-31</EndDate> </ValidityPeriod> <GivenName>Pete</GivenName> <FamilyName>Graham</FamilyName> <FormattedName>Pete Graham</FormattedName> <NonVerbalCommunicationLanguageCode>DE</NonVerbalCommunicationLanguageCode> </EmployeeCommon> </EmployeeTimeAgreementTimeRecordingSystemSetup> </nm:EmployeeTimeAgreementTimeRecordingSystemSetupByElementsResponse_sync>
Show full documentation
Show full documentation