ServiceRouterUpdateUserLaborLevel Method

Adds a UpdateUserLaborLevelOut response with a result model List<UpdateUserLaborLevelModel>

Namespace: AppOne.Services.V2
Assembly: AppOne.Web.Service (in AppOne.Web.Service.dll) Version: 1.0.141

Syntax

public UpdateUserLaborLevelOut UpdateUserLaborLevel(
	UpdateUserLaborLevelIn input
)

function UpdateUserLaborLevel(input);

Parameters

input UpdateUserLaborLevelIn: A new UpdateUserLaborLevelIn object

Return Value

UpdateUserLaborLevelOut
A UpdateUserLaborLevelOut object

Remarks

Use this method to add a payload of UpdateUserLaborLevelModel which contains the default and assigned labor-level-details for a user.

Note
Business Rules: Labor levels are used to create a structure for labor distribution, job costing and reporting. Labor-level-details track where employees spend their time. Employees are only able punch against specific labor-level-details to which they are assigned. Employees can be assigned to home or default labor-level-details by which they can be automatically assigned when accessing specific interfaces. Labor-levels (GetLaborLevelModel) are merely group containers for labor-level-details (GetLaborLevelDetailModel); basically a GetLaborLevelDetailModel is a child element of GetLaborLevelModel. Setup: Manager > Employees > Labor Levels Configuration > Imports > New Employee Defaults Configuration > Labor Levels > Define (Labor Levels GetLaborLevelModel) Configuration > Labor Levels > Setup (Labor Levels Details GetLaborLevelDetailModel)

Note

Business Rules:
Labor levels are used to create a structure for labor distribution, job costing and reporting. Labor-level-details track where employees spend their time. Employees are only able punch against specific labor-level-details to which they are assigned. Employees can be assigned to home or default labor-level-details by which they can be automatically assigned when accessing specific interfaces. Labor-levels (GetLaborLevelModel) are merely group containers for labor-level-details (GetLaborLevelDetailModel); basically a GetLaborLevelDetailModel is a child element of GetLaborLevelModel.

Setup:
Manager > Employees > Labor Levels
Configuration > Imports > New Employee Defaults
Configuration > Labor Levels > Define (Labor Levels GetLaborLevelModel)
Configuration > Labor Levels > Setup (Labor Levels Details GetLaborLevelDetailModel)

Caution
When "Implied Labor Level Hierarchy" is enabled it will change the way in which labor levels are displayed for a given users. See Configuration > Labor Levels Hierarchy (which is enabled from the General Configuration interface).

Caution
This method will except a maximum of 1 EmpIdentifier items per request. Any more than 1 and an exception will be return.

Example

JSON Request

Copy

//Call currently only supports 1 EmpIdentifier
{
"AuthToken":${#TestSuite#Tests_Global_Token},
"Payload":[
    {
        "EmpIdentifier":"1234",
        "AssignedLaborLevelDetails":[
        {
            "AssignID":5670,
            "ChargeRate":{
                "EndDateTime":"\/Date(1606978800000-0700)\/",
                "StartDateTime":"\/Date(1543734000000-0700)\/",
                "Value":17
            },
            "StartDateTime":"\/Date(1543734000000-0700)\/",
            "EndDateTime":"\/Date(1606978800000-0700)\/",
            "IsHomeLL":true,
            "PayRate":{
                "EndDateTime":"\/Date(1606978800000-0700)\/",
                "StartDateTime":"\/Date(1543734000000-0700)\/",
                "Value":16
            }
        },
        {
            "AssignID":5672,
            "StartDateTime":"\/Date(1543734000000-0700)\/",
            "EndDateTime":"\/Date(1606978800000-0700)\/",
            "IsHomeLL":false,
        }        
        ]
    }
]
}

JSON Response

Copy

{
   "Report":    {
      "APIVersion": "2.0",
      "ProcessTime": "0.2795041",
      "RequestTime": "/Date(1547756325490-0700)/",
      "ResponseTime": "/Date(1547756325769-0700)/",
      "Results": 1
   },
   "Results": [   {
      "EmpIdentifier": "1234",
      "AssignedLaborLevelDetails":       [
                  {
            "ID": 5670,
            "Messages": ["PASS: Labor Level AssignID::'5670' was updated."],
            "Status": 1
         },
                  {
            "ID": 5672,
            "Messages": ["PASS: Labor Level AssignID::'5672' was updated."],
            "Status": 1
         }
      ]
   }]
}

Reference

ServiceRouter Class

AppOne.Services.V2 Namespace

GetUserLaborLevelModel