Como obter uma lista de ordens de trabalho por OData?

É possível realizar pedidos OData em todas as entidades.

Nos pedidos OData é necessário ter atenção à seguinte sintaxe:

1. $select: expressão que determina quais os campos do pedido que são incluídos no resultado;
   
2. $filter: expressão utilizada para restringir a informação enviada no pedido;
   
3. $orderby: expressão utilizada para ordenar a informação enviada;
   
4. $skip: expressão que ignora os primeiros registos, por exemplo: $skip = 100. Neste caso, ignora os 100 primeiros registos;
5. $Top: expressão que retorna os primeiros N registos do pedido;
   
6. $expand: expressão que permite relacionar entidades, por exemplo obter a lista de consumos e as respetivas peças consumidas.

Quando se realizam pedidos OData, existem duas expressões que devem ser utilizadas:

1. $select: expressão obrigatória. Deve indicar quais os campos que pretende obter;
   
2. $filter: como limitamos a 100 registos por pedido, recomendamos que indique o filtro pelo campo ModifiedOn para obter apenas os registos novos ou alterados.

Exemplos

De seguida, estão descritos exemplos de pedidos Odata para as ordens de trabalho:

Pedido OData para obter informação da ordem de trabalho

1. https://cloud.valuekeep.com/api/{Tenant}/{Organization}/maintenance/workOrders/odata?$select=Id,Description,WorkOrderType,Equipment,EquipmentId,Customer,CustomerId,Responsible,Workshop,WorkshopDescription,PriorityLevel,Date,WorkOrderKey,AssetType,Location

Pedido OData para obter informação da ordem de trabalho, ignorando os 100 primeiros registos

1. https://cloud.valuekeep.com/api/{Tenant}/{Organization}/maintenance/workOrders/odata?$select=Id,Description,WorkOrderType,Equipment,EquipmentId,Customer,CustomerId,Responsible,Workshop,WorkshopDescription,PriorityLevel,Date,WorkOrderKey,AssetType,Location&$filter=WorkOrderType eq 'CR'

Pedido OData para obter informação da ordem de trabalho, ignorando os 100 primeiros registos e filtrando por estado da OT

1. https://cloud.valuekeep.com/api/{Tenant}/{Organization}/maintenance/workOrders/odata?$select=Id,Description,WorkOrderType,Equipment,EquipmentId,Customer,CustomerId,Responsible,Workshop,WorkshopDescription,PriorityLevel,Date,WorkOrderKey,AssetType,Location&$filter=WorkOrderType eq 'CR'&$skip=100&$orderby=ModifiedOn

Os campos inseridos no Select devem iniciar por maiúsculas.

 Consulte o artigo de apoio para saber quais os campos a utilizar na expressão Select.

• Related Articles

• 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 ...

• Como obter o registo de consumos por OData?

  É possível realizar pedidos OData em todas as entidades. Nos pedidos OData, é necessário ter atenção à seguinte sintaxe: $select: expressão que determina quais os campos do pedido que são incluídos no resultado; $filter: expressão utilizada para ...

• 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 – 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 - 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 é: ...