Octalarm Link: REST API voor netwerk gestuurd alarmeren

Octalarm Link¹ is een aanvullende licentie om grote hoeveelheden alarmen uit te melden via netwerk gestuurd alarmeren. De licentie is geschikt voor de Touch Pro en is standaard opgenomen in ARA-Pro Next.

Goed om te weten: gerealiseerde koppelingen geïntegreerd in betreffende externe procescomputer (op alfabetische volgorde):
- DMP VEC
- Hoogendoorn iSii
- Hoogendoorn IIVO
- Ridder Growing Solutions

Goed om te weten: gerealiseerde koppelingen via extra REST API:
- Priva Office (zie Priva Office voor ARA-Pro Next)

Let op: ondersteuning bij installatie en instellen van Octalarm Link gebeurt in samenwerking met een engineer van Adésys (online via Microsoft Teams|duur: 1 dagdeel). Dit is inclusief het opleiden van operator(s).

De REST API zorgt ervoor dat externe apparaten communiceren met de Octalarm alarmmelder. Deze externe apparaten gebruiken de REST API om alarmmeldingen met een specifieke alarmtekst te starten en om de verbinding met de alarmmelder te monitoren.

In plaats van alle externe alarmen apart aan te maken in de alarmmelder, zijn deze gecombineerd in een aantal categorieën. Elke categorie heeft zijn eigen specifieke alarmafhandeling. Het externe apparaat gebruikt de categorieën om alarmmeldingen te starten met een specifieke alarmtekst.

In te stellen onderdelen

REST API koppeling

Voor elk apparaat dat wil communiceren met de Octalarm alarmmelder stelt u een koppeling in. De communicatie met de REST API wordt bewaakt door periodieke watchdog API aanvragen. Wanneer de watchdog API aanvragen van het externe apparaat met Octalarm Link mislukken, ontvangt de ingestelde oproeplijst/service groep een watchdog systeemstoring. Zie Alarmen|Ingangen configureren: Oproeplijst koppelen of nieuwe maken (rechterzijde) verdere toelichting.

Eén of meerdere locaties

Voor de specifieke alarmafhandeling per locatie of groep.

Categorieën per locatie

Om de alarmen over de verschillende categorieën te verdelen.

Tip: de ingebruikname van de REST API verloopt het beste wanneer u bij het instellen de volgorde van dit hoofdstuk aanhoudt. Aan de hand van een voorbeeld leggen we stap voor stap uit:
1. welke algemene methoden en responsen u gebruikt;
2. hoe u de REST API, de locaties en de categorieën implementeert;
3. hoe alarmmeldingen via de REST API starten;
4. hoe u de melder instellingen controleert.

Situatieschets

In een kas, waar men tomaten en paprika's teelt, gebruikt men een procescomputer voor het regelen van het klimaat, irrigatie en energie. Deze klimaatcomputer communiceert via de REST API met de Octalarm alarmmelder. Om alarmen per locatie anders af te handelen worden verschillende locaties aangemaakt en de alarmen per locatie verdeelt in teeltalarmen (urgent of niet urgent) en technische alarmen (urgent of niet urgent).