Webapi

WebAPI – Registos de verificação de tarefas

51 views 28 Abril, 2017 8 Fevereiro, 2018 Valuekeep 0

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.

Tags:

Foi útil?