Webapi

WebAPI – Monitorizaciones y Valores de Monitorización

36 views 28 April, 2017 28 February, 2018 Valuekeep 0

Este servicio permite obtener y modificar las Monitorizaciones y los Valores de Monitorización en Valuekeep.

A continuación se muestra un análisis de los métodos disponibles en el servicio.

Lista de Monitorizaciones

GET /api/mytenant/myorganization/maintenancemanagementcore/monitorings/GetMonitoringsByVersionAndRecords?version=AAAA&maxRecords=2000

Este método permite obter a lista de controlos de condição. Pode obter a lista filtrada por:

  • Version: Versão
  • MaxRecords: Opcional. Número máximo de registos a devolver (se não for definido, por omissão devolve 2000 registos)

Exemplo:

GET /api/mytenant/myorganization/maintenancemanagementcore/monitorings/GetMonitoringsByVersionAndRecords?version=AAAAAAAAAAA=&maxRecords=200

Obtém no máximo 200 controlos de condição com versão superior a “AAAAAAAAAAA=”.

Obtener Valores de Monitorización

 GET /api/mytenant/myorganization/maintenancemanagementcore/monitoringvalues/GetMonitoringValuesByFilter

Este método permite obtener la lista de valores de monitorización, aplicando diversos filtros. La lista puede filtrarse por:

  • Version: Versión mínima a partir de la que se devuelve la lista
  • MaxRecords: Número máximo de registros (pueden solicitarse un máximo de 200 registros al mismo tiempo)
  • 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)
  • AssignedTo: Login del usuario del trabajador. Se devuelven los valores de las monitorizaciones asociadas a las OT con tareas asignadas a este trabajador.
  • WorkOrderKey: Código de una Orden de Trabajo. Se devuelven los valores de monitorizaciones asociados a esta OT.
  • AssetKey: Código del Activo. Se devuelven los valores de monitorizaciones asociados a este activo.
  • LocationKey: Código de la Localización. Se devuelven los valores de monitorizaciones asociados a esta localización.
  • MonitoringKey: Código del Valor de Monitorización. Se devuelven los valores de esta monitorización.

Todos los filtros son opcionales. La lista de valores que se devuelve está ordenada por versión y por orden creciente.

Ejemplos:

GET /api/mytenant/myorganization/maintenancemanagementcore/monitoringvalues/GetMonitoringValuesByFilter?stateKey=001&stateKey=002&maxRecords=50&assignedTo=myuser&version=AAAAAAAAAAA=

Se obtienen como máximo 50 valores de monitorizaciones para las OT en los estados “Pendiente” y “Pendiente de Aprobación”, registrados para el trabajador con el login “myuser” y con una versión superior a la “AAAAAAAAAAA=”.

GET /api/mytenant/myorganization/maintenancemanagementcore/monitoringvalues/GetMonitoringValuesByFilter?workorderkey=WO001

Se obtienen los valores de monitorizaciones para la OT “WO001”.

Crear Valores de Monitorización

POST /api/mytenant/myorganization/maintenancemanagementcore/monitoringvalues

Este método permite criar valores de controlos de condição para um determinado controlo de condição. O “corpo” da mensagem deve ser preenchido com a estrutura do recurso MonitoringValueResource.

Exemplo:

{
“Date”: “2017-04-05T09:54:12.8997517+01:00”,
“Value”: 100,
“MovingAverage”: null,
“Notes”: “”,
“MonitoringAssetKey”: “”,
“MonitoringLocationKey”: “”,
“Monitoring”: “AC-0001”,
“Issue”: null,
“Notification”: null,
“WorkOrder”: “OT0018”,
“UserFields”: []
}

Modificar Valores de Monitorización

PUT /api/mytenant/myorganization/maintenancemanagementcore/monitoringvalues/{id}

Este método permite alterar registos de valores de controlo de condição. O valor de <id> deve ser o identificador do registo de valores de controlo de condição e o “corpo” da mensagem deve ser preenchido com a estrutura do recurso MonitoringValueResource.

Exemplo:

PUT /api/mytenant/myorganization/maintenancemanagementcore/monitoringvalues/8badd58e-ae1a-e711-9d09-c01885a63e51

{
“ReadingNumber”: 2,
“Date”: “2017-04-06T09:54:12.8997517+01:00”,
“Value”: 120,
“MovingAverage”: null,
“Notes”: “”,
“MonitoringAssetKey”: “”,
“MonitoringLocationKey”: “”,
“Monitoring”: “MN-0003”,
“Notification”: null,
“UserFields”: [],
“Id”: “8badd58e-ae1a-e711-9d09-c01885a63e51”
}

Este pedido serve para atualizar o registo de valores do controlo de condição com o identificador “8badd58e-ae1a-e711-9d09-c01885a63e51”.
Após o pedido, o recurso devolvido tem o valor do campo “Version” atualizado.

Tags:

¿Fue útil?