Nastavení času posledního resetu Measuring Pointu (API)

Measuring Pointy mohou být využívány jako počítadla, která postupně navyšují své hodnoty (např. počet odpracovaných hodin nebo počet cyklů stroje). Na tyto Measuring Pointy lze definovat breakpointy – limity, jejichž překročení spouští předem definované akce v systému (např. notifikace nebo údržbové zásahy).

Aby breakpointy pracovaly správně, je nezbytné zaznamenat čas posledního resetu Measuring Pointu. Reset znamená, že hodnota Measuring Pointu se vynuluje a začne znovu narůstat od nuly. Pokud by čas posledního resetu nebyl aktualizován, mohly by breakpointy nesprávně vyhodnocovat i historická data před resetem a spustit nežádoucí akce.

Nastavení času posledního resetu Measuring Pointu lze provést přímo v aplikaci, v případě integrace s externím systémem je však možné nastavit čas posledního resetu i prostřednictvím API.

Identifikace potřebných ID

Pro volání API je třeba znát:

Equipment ID (ID zařízení) – je uvedeno v URL při editaci zařízení.
Příklad: .../equipments/1666 → equipment_id je 1666.
KPI Definition ID (ID Measuring Pointu) – je uvedeno v URL při editaci konkrétního Measuring Pointu v aplikaci. Příklad: .../measuring-point/341 → idKpiDefinition je 341.

API volání

Metoda: POST
Endpoint:

CODE

{{host}}/equipment/{equipment_id}/actions/set-kpi-definition

Příklad těla požadavku

CODE

{
  "kpiDefinitions": [
    {
      "idKpiDefinition": 341,
      "timeLastMPReset": "2025-09-01T05:51:49+00:00"
    }
  ]
}

Popis parametrů

idKpiDefinition – ID Measuring Pointu, u kterého se nastavuje čas resetu.
timeLastMPReset – čas posledního resetu ve formátu UTC (YYYY-MM-DDTHH:mm:ss+00:00).

Praktický příklad

Pro zařízení s Equipment ID 1666 a Measuring Pointem TV-MP lze nastavit čas posledního resetu na 1. září 2025, 05:51:49 UTC pomocí výše uvedeného requestu v Postmanu.

Doporučení

Čas resetu Measuring Pointu je nutné vždy zadávat ve formátu UTC, aby se předešlo nesrovnalostem mezi systémy.
Po provedení resetu je doporučeno ověřit v aplikaci, že hodnota Measuring Pointu byla vynulována.
V případě, že zařízení obsahuje více Measuring Pointů, je třeba provést volání API pro každý Measuring Point samostatně.

Tento návod doplňuje dokumentaci Napojení na Measuring pointy pro Maintenance z externí aplikace a umožňuje správu časů resetu Measuring Pointů při integraci s externími systémy.