Este serviço permite a obtenção e manipulação de registos de verificação de tarefas no Valuekeep.
De seguida é apresentada uma análise dos métodos disponibilizados pelo serviço.
Obter Registos de Verificação de Tarefas
GET /api/mytenant/myorganization/maintenancemanagementcore/workordertaskverifications/GetWorkOrderTaskVerificationsByFilter
Este método permite obter a lista de registos de verificação de tarefas, aplicando vários filtros. Pode obter a lista filtrada por:
- StateKey: Lista de estados (verificar valores em Criar uma Ordem de Trabalho na secção Estados, apenas a parte numérica da chave natural)
- AssignedTo: Login do utilizador do funcionário que verificou a tarefa
- WorkOrderKey: Código de uma Ordem de Trabalho
- MaxRecords: Número máximo de registos (pode pedir no máximo 200 registos de cada vez)
- Version: Versão
Todos os filtros são opcionais. A lista de registos de verificação de tarefas devolvida está ordenada por versão em ordem crescente.
Exemplos:
GET /api/mytenant/myorganization/maintenancemanagementcore/workordertaskverifications/GetWorkOrderTaskVerificationsByFilter?stateKey=001&stateKey=002&maxRecords=50&assignedTo=myuser&version=AAAAAAAAAAA=
Obtém no máximo 50 registos de verificação de tarefas das ordens de trabalho nos estados “Pendente” e “Aguarda Aprovação”, verificados pelo funcionário com o login “myuser” e com versão superior a “AAAAAAAAAAA=”.
GET /api/mytenant/myorganization/maintenancemanagementcore/workordertaskverifications/GetWorkOrderTaskVerificationsByFilter?workorderkey=WO001
Obtém os registos de verificação de tarefas para a OT “WO001”.
Criar Registo de Verificação de Tarefas
POST /api/mytenant/myorganization/maintenancemanagementcore/workordertaskverifications
Este método permite criar um Registo de Verificação de Tarefas para uma determinada Ordem de Trabalho. O “corpo” da mensagem deve ser preenchido com a estrutura do recurso WorkOrderTaskVerificationResource.
Exemplo:
{
“WorkOrderTaskVerificationKey”: “c51293b6-7a69-4e7c-9bd8-faf41c48b00f”,
“Remarks”: “”,
“WorkOrder”: “OT0017”,
“MaintenancePlan”: “PMV-000007.1”,
“Task”: “T-000009”,
“Location”: null,
“Asset”: “CALD001”,
“Employee”: “0002”,
“ValidationType”: “V1”,
“ValidationTypeDetail”: “V1.BBB”,
“Id”: “c51293b6-7a69-4e7c-9bd8-faf41c48b00f”,
“IsActive”: true,
“IsDeleted”: false,
“Version”: “AAAAAAAAlPs=”
}
Alterar Registo de Verificação de Tarefas
PUT /api/mytenant/myorganization/maintenancemanagementcore/workordertaskverifications?workOrderTaskVerificationKey=<workOrderTaskVerificationKey>
Este método permite alterar registos de verificação de tarefas da ordem de trabalho. O valor <workOrderTaskVerificationKey> deve ser a chave do registo de verificação de tarefas, e o “corpo” da mensagem deve ser preenchido com a estrutura do recurso WorkOrderTaskVerification.
Exemplo:
PUT /api/mytenant/myorganization/maintenancemanagementcore/workordertaskverifications?workOrderTaskVerificationKey=c51293b6-7a69-4e7c-9bd8-faf41c48b00f
Este pedido serve para atualizar o registo de consumo com a chave “c51293b6-7a69-4e7c-9bd8-faf41c48b00f”.
Após o pedido, o recurso devolvido tem o valor do campo “Version” atualizado.