Este servicio permite obtener y modificar los Registros de Mano de Obra de las OT en Valuekeep.
A continuación, se muestra un análisis de los métodos disponibles en el servicio.
Obtener Registro de Mano de Obra
GET /api/mytenant/myorganization/maintenancemanagementcore/laborreports/GetWorkOrdersLaborReportsByFilter
Este método permite obtener la lista de registros de mano de obra, aplicando diversos filtros. La lista puede filtrarse por:
- StateKey: Lista de estados (comprobar valores en Crear una Orden de Trabajo en la sección Estados, solo la parte numérica de la clave natural)
- MaxRecords: Número máximo de registros (puede solicitarse un máximo de 200 registros al mismo tiempo)
- WorkOrder: Por el código de una Orden de Trabajo
- AssignedTo: Login del usuario del trabajador asignado en el registro de la mano de obra
- Version: Versión
- WOResponsible: Responsable por la OT
- WCResponsible: Responsable por el Centro de Trabajo
- WOOrWCResponsible: Responsable por la OT o por el Centro de Trabajo
Todos los filtros son opcionales. La lista de registros de mano de obra que se devuelve está ordenada por versión y por orden creciente. Si se define el filtro por usuario, solo se devuelven los registros de mano de obra asignados al trabajador de ese usuario.
Ejemplo:
GET /api/mytenant/myorganization/maintenancemanagementcore/laborreports/GetWorkOrdersLaborReportsByFilter?stateKey=001&stateKey=002&maxRecords=50&workorder=WO001&assignedTo=myuser&version=AAAAAAAAAAA=
Se obtienen como máximo 50 registros de mano de obra en los estados “Pendiente” y “Pendiente de Aprobación”, asignados al trabajador con el login “myuser” y con una versión superior a la “AAAAAAAAAAA=”.
Crear Registro de Mano de Obra
POST /api/mytenant/myorganization/maintenancemanagementcore/laborreports
Este método permite crear registros de mano de obra para tareas de la orden de trabajo. En el cuerpo del mensaje debe introducirse la estructura del recurso LaborReport.
Ejemplo:
{
“Date” : “2017-03-08”,
“IsDone” : “true”,
“Hours” : “4”,
“AppName” : “”,
“StartDate” : “2017-03-08T10:00:00+00:00”,
“EndDate” : “2017-03-08T14:00:00+00:00”,
“Remarks” : “observaciones sobre este registro”,
“Employee” : “0002”,
“Expertise” : “”,
“Skill” : “”,
“WorkOrder” : “OT0009”,
“Asset” : “CHLL 001”,
“Location” : “”,
“MaintenancePlan” : “PM-000001.1”,
“Task” : “T-000002”,
“UnderContract” : “false”
}
El método devuelve la lista de registros creados, incluido el reparto del registro por las tareas de la OT. El campo WorkOrderReportLabor devuelve la clave del documento de registro y el campo TaskReportId el identificador de la línea del registro.
Modificar Registro de Mano de Obra
PUT /api/mytenant/myorganization/maintenancemanagementcore/laborreports/<id>
Este método permite modificar registros de mano de obra para tareas de la orden de trabajo. El valor de <id> debe ser el identificador del registro y en el cuerpo del mensaje debe introducirse la estructura del recurso LaborReport.
Ejemplo:
PUT /api/mytenant/myorganization/maintenancemanagementcore/laborreports/4b1c176f-1308-e711-9cee-3ca9f42265f4
{
“TaskReportId”: “4b1c176f-1308-e711-9cee-3ca9f42265f4”,
“Date”: “2017-02-27T00:00:00”,
“IsDone”: true,
“Hours”: 1,
“AppName”: “”,
“StartDate”: null,
“EndDate”: null,
“Remarks”: “observaciones del registro”,
“Employee”: “0007”,
“WorkOrder”: “OT0008”,
“Asset”: “”,
“Location”: “PISO 0”,
“MaintenancePlan”: “MP-000001.1”,
“Task”: “T-000002”,
“WorkOrderReportLabor”: “L00019”,
“Expertise”: “”,
“Skill”: “”,
“Id”: “4b1c176f-1308-e711-9cee-3ca9f42265f4”,
“IsActive”: true,
“IsDeleted”: false,
“Version”: “AAAAAAAAw1g=”
}
Después de la solicitud, el recurso que se devuelve tiene el valor del campo “Version” actualizado.