WebAPI - Obter ordens de trabalho filtradas por data e estado

Este método devolve a lista de ordens de trabalho filtradas segundo os parâmetroS apresentados a seguir.

​

O método a utilizar para a obter a lista de ordens de trabalho filtradas é:

GET /api/mytenant/myorganization/maintenance/workorders/getWorkOrderFilter?version=AAAA&stateKey=002WORKORDER&dateTransition=2021-02-01&maxRecords=100&attachments=true

Os parâmetros do método são opcionais, no entanto, o método a data de criação, data esperada e data transição para filtrar OTs. Se o parâmetro maxRecords não for especificado, devolve no máximo 100 registos. A lógica é a seguinte:

1º filtro

1. datetransition: devolve todas as OTs com data de transição superior à data inserida
   
2. stateKey: devolve todas as OTs com este estado da transição, podendo a OT estar em outro estado no momento. Permite definir a lista de valores separados por “;”
   
3. maxRecords: número de OTs a serem devolvidas, este parâmetro deve ser um valor inteiro igual ou inferior a 200
   
4. version: devolve todas as OTs atribuídas com a versão superior a este parâmetro, este parâmetro deve estar em base64. Se não for especificado será considerado o valor AAAA
   
5. attachments: devolve os anexos com as OTs filtradas
   

2º filtro

1. date: devolve todas as OTs com data de criação igual ou superior à inserida
   
2. expectedDate: devolve todas as OTs com data esperada igual ou superior à inserida
   
3. modifiedOn: devolve todas as OTs com data de alteração igual ou superior à inserida 
   
4. stateKey: devolve todas as OTs com estes estados, podendo a Ot estar em outro estado no momento. Permite definir a lista de valores separados por “;”
   
5. maxRecords: número de OTs a serem devolvidas, este parâmetro deve ser um valor inteiro igual ou inferior a 200
   
6. version: devolve todas as OTs atribuídas com a versão superior a este parâmetro, este parâmetro deve ser estar em base64. Se não for especificado será considerado o valor AAAA
   
7. attachments: devolve os anexos com as OTs filtradas
   

O servidor devolve uma resposta HttpStatusCode.OK, com as OTs filtradas. Se o parâmetro maxRecords for especificado e o valor for igual ou inferior a 200, devolve esse número de registos. Se o valor do parâmetro for superior a 200, devolve uma mensagem de erro.

Se adicionar todos os parâmetros será utilizado por defeito o 1º filtro.

• Related Articles

• WebAPI – Obter ordens de trabalho e técnicos que pertencem às oficinas nas quais o utilizador autenticado é responsável

  Este métoto devolve a lista de ordens de trabalho e técnicos que pertencem ás oficinas nos quais o utilizador autenticado é responsável. O métodos a utilizar para obter a lista são: ...

• WebAPI – Obter Ordens de trabalho atribuídas ao funcionário

  Este métoto devolve a lista de ordens de trabalho atribuidas a cada funcionário de uma determinada empresa. O método a utilizar para a obter a lista de ordens de trabalho atribuídas ao funcionário é: GET ...

• WebAPI – Como criar ordens de trabalho?

  Este método oferece uma forma simplificada de criar uma Ordem de Trabalho para um determinado Ativo, Localização, Ferramenta ou Rota. O método a utilizar para a criação de uma ordem de trabalho é : POST ...

• WebAPI – Alterar estado da ordem de trabalho

  Este método permite efetuar a mudança de estado de uma ordem de trabalho. O método a utilizar para a alteração de estado da ordem de trabalho é: Post {{url}/api/{{tenant}}/{{organization}}/maintenance/workorders/changeSchemaEntityState/{{companyKey}} ...

• WebAPI – Atualizar Registo de Mão de Obra

  Este método permite alterar o registo de mão de obra uma ordem de trabalho. O método a utilizar para a alteração do registo de mão de obra é: POST /api/mytenant/myorganization/maintenance/workorderreportlabors/ ...