Monitoring System: Datenintegration von Maschine zu Maschine (M2M)

Die Datenintegration ist eine der Hauptanforderungen für viele unserer Kunden von Überwachungssystemen.

Die Kernfunktionalität des Rotronic Monitoring Systems (RMS) bietet exzellente grafische Darstellungen, Statik und Berichte. Hier diskutieren wir jedoch die Werkzeuge, die für die Machine-to-Machine (M2M)-Integration verwendet werden.

Die M2M-Integration (Machine-to-Machine) ist von entscheidender Bedeutung, da Daten in Unternehmen immer häufiger für eine Vielzahl von Zwecken genutzt werden. RMS bietet zwar einen sehr sicheren und anpassungsfähigen Rahmen für die Überwachung und Alarmierung, aber es gibt viele seltsame und wunderbare Funktionen, die es nicht bieten kann. In diesem Fall müssen wir die Daten extrahieren und sie anderweitig verwenden.

Daten aus dem Rotronic Monitoring System (RMS) holen

Das RMS ist ein SQL-basiertes System, so dass wir natürlich direkt SQL abfragen könnten, aber dieser Ansatz ist mit vielen Einschränkungen verbunden, insbesondere in Bezug auf die Sicherheit. Auch über unsere RMS-Cloud-Plattform steht den Endnutzern absolut kein direkter SQL-Zugriff zur Verfügung.

Das RMS unterstützt eine RESTful API. Wir nutzen ein einfaches Beispiel, um die Grundschritte durchzugehen.

RMS GET API

Wie zuvor werde ich in diesem Beispiel einige Python-Skripte verwenden, aber wenn Sie es vorziehen, ist POSTMAN ein großartiges Werkzeug zum Testen dieser Art von APIs.

Lassen Sie uns die Schritte aufschlüsseln:

1. API-Token mit Ihrem Benutzernamen und Passwort anfordern
2. Token verwenden, um bestimmte Daten anzufordern
3. Daten wie gewünscht verwenden

Schritt 1 - Anforderung eines Tokens
Aus Sicherheitsgründen können Sie nicht einfach eine Anfrage senden und die gewünschten Daten erhalten. Zuerst müssen Sie ein Token von RMS anfordern. Das Token ist mit einem Benutzerkonto verknüpft und erlaubt nur den Zugriff auf die Daten, die für diesen Benutzer sichtbar sind. Wenn Sie ein Token anfordern, können Sie auch angeben, wie lange es gültig ist. Die maximale Länge beträgt 30 Tage.

import json
import requests

url = ‘https://rms.rotronic.com/RMS/API/RequestToken.ashx’
headers = {‘Content-Type’ : ‘Application/json’, ‘Expect’ : ‘100-continue’, ‘Connnection’ : ‘Close’, ‘Host’ : ‘rms.rotronic.com’}
UsrID = “1”
User= “Jeremy”
PW = “########”
Exp = “30”
get_payload = {‘UserId’:UsrID,’Username’:User,’Password’:PW,’RequestType’:’ DataHistory’,’ExpirationDays’: Exp}
api_get = requests.post(url, headers=headers, data =json.dumps (get_payload))
token = json.loads(api_get.content)
token = token.get(‘Token’)

Die obige Anfrage mit den entsprechenden Anmeldeinformationen wird etwas in dieser Art und Weise zurückgeben.
{‘UserId’: 1, ‘RequestType’: ‘DataHistory’, ‘Token’: ‘jUsTaNeXaMpLe_HRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLXNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySWQiOjM5MzEsIlJlcXVlc3RUeXBlIjoiRGF0YUhpc3RvcnkiLCJFeHBpcmF0aW9uIjoiMjAxOS0wNC0wM1QxNToyMzoyMC44MTgwODM4WiJ9.rtHHKvrE-7jnMNHUGazso_jUsTaNeXaMpLe’, ‘Status’: ‘OK’}

Das API-Token ist das obige Textwirrwarr. Mit dem Token in der Hand können wir mit der Abfrage unserer Daten fortfahren.

Schritt 2 - Daten anfordern
Um Daten anzufordern, benötigen wir die Messstellen-ID für die benötigten Daten, die wir über die RMS-Schnittstelle erhalten können (jeder gemessene Parameter hat eine eindeutige ID innerhalb von RMS, die sich nicht ändert und nicht wiederverwendet werden kann). Außerdem legen wir den Von und Bis Bereich fest, sowie die Anzahl der Werte, die wir abfragen wollen (Count).

import json
import requests
url = ‘https://rms.rotronic.com/RMS/API/DataHistory.ashx’
headers = {‘Content-Type’ : ‘Application/json’, ‘Expect’ : ‘100-continue’, ‘Connnection’ : ‘Close’, ‘Host’ : ‘rms.rotronic.com’}
MPTID = “20”
From = “2019-03-04T08:00:00”
To = “2019-03-04T09:00:00”
Count = “10”
Token = “token from step 1”
post_payload = {‘ID’: MPTID,’From’: From,’To’:To,’Count’:Count,’Order’:’Asc’,’Token’: Token}
api_get = requests.post(url, headers=headers, data =json.dumps (post_payload))
data = json.loads(api_get.content)
print (data)


Die obige Anfrage mit den entsprechenden Anmeldeinformationen wird etwas in dieser Art und Weise zurückgeben.
{‘Status’: ‘OK’, ‘ID’: 20, ‘Name’: ‘Humidity-18071604′, ‘Parameter’: ‘Humidity‘, ‘Unit’: ‘%rh‘, ‘Data’: [{‘Time’: ‘2019-03-04T08:00:14+01:00′, ‘Value’: ‘29.45%rh‘}, {‘Time’: ‘2019-03-04T08:05:14+01:00’, ‘Value’: ‘29.80%rh’}, {‘Time’: ‘2019-03-04T08:10:14+01:00’, ‘Value’: ‘29.61%rh’}, {‘Time’: ‘2019-03-04T08:15:14+01:00’, ‘Value’: ‘29.29%rh’}, {‘Time’: ‘2019-03-04T08:20:14+01:00’, ‘Value’: ‘29.80%rh’}]}

Schritt 3 - Nutzung der Daten
So haben wir unsere Daten im JSON-Format. Von hier aus ist es ein einfacher Schritt, die spezifischen Werte herauszuschneiden und sie an einen anderen Code oder eine Maschine zu übergeben oder sie einfach für sich selbst darzustellen.

Die Flexibilität von RMS ist eine wichtige Voraussetzung für unsere Kunden, insbesondere für diejenigen mit bestehenden Systemen. Die Verwendung von RMS als zentrale Plattform gewährleistet präzise Messungen, eine sichere und zuverlässige Datenerfassung und einen einfachen Zugriff auf die Daten. Die Verwendung unserer APIs ermöglicht es dann, diese Daten in weiteren Geschäftsabläufen zu nutzen.

Kundenbeispiele für die Nutzung der API sind

• Einbindung von Temperaturdaten in Verpackungsetiketten
• Automatisierte Erstellung von Kalibrierungszertifikaten mit Referenzwerten von RMS
• Visualisierung von RMS-Daten in Software von Drittanbietern für Gebäudeeffizienzanzeigen

Abschluss
Dieser Beitrag konzentriert sich auf unsere RESTful API, obwohl wir eine Vielzahl von alternativen Datenintegrationsmöglichkeiten haben, wie z.B. Relais-Ausgangsmodule, analoge Ausgangsmodule und direkte SQL-Verbindungen. Außerdem unterstützt unsere RMS-Integrator-Hardware die direkte Gerätekommunikation mit Geräten über MODBUS, SNMP und MySQL.

Die Botschaft ist also einfach; wenn Sie Anforderungen haben, kann das Rotronic Monitoring System RMS diese in der Regel erfüllen. Nehmen Sie Kontakt mit uns auf und wir besprechen gerne Ihr Projekt. Egal wie gross oder klein es ist.

Erfahren Sie mehr über RMS

Autor:
Jeremy Wingate
Sales Manager Abteilung Environmental Monitoring System