Diese Seite zum Buch hinzufügen 
Diese Seite aus Buch entfernen 
Buch anzeigen, ändern (
Hilfe API: Qundis
Mit diesem Importer lädt ERAS2 Ihre Auslesungen aus dem Qundis-Portal Q-SMP als XML-Dateien herunter und liest sie anschließend ein.
Voraussetzungen
- Ein Zugang zum Qundis-Portal Q-SMP (Benutzername und Passwort).
- Ein Verzeichnis, auf das ERAS2 schreiben darf. Dort legt ERAS2 die heruntergeladenen Dateien ab.
Einrichtung
In der Liste der für Sie zur Verfügung stehenden Importer finden Sie den Eintrag API Qundis Abruf. Nach der Auswahl tragen Sie unter Optionen ein:
| Feld | Bedeutung |
|---|---|
Benutzername: | Ihr Benutzername für Q-SMP. |
Passwort: | Ihr Passwort für Q-SMP. |
Importer Verzeichnis: | Arbeitsverzeichnis für die XML-Dateien. Vorbelegt ist C:\QundisAPI. |
Datenabruf ab: | Es werden alle abgeschlossenen Auslesungen ab diesem Datum abgerufen. Die Werte innerhalb einer Auslesung werden nicht zusätzlich nach Datum gefiltert. Vorbelegt ist heute vor einem Monat. |
Ablesungen vor dem Einbaudatum übernehmen | Ohne Haken werden Werte verworfen, die vor dem Einbaudatum des Geräts liegen. |
Ablauf
- Anmeldung bei Q-SMP mit Benutzername und Passwort.
- Download aller abgeschlossenen Auslesungen seit
Datenabruf abals XML-Dateien in das Importer-Verzeichnis. Dateien, die dort schon liegen, werden nicht erneut geladen. - Einlesen jeder Datei, wie beim Import einer Qundis-XML-Datei.
Im Importer-Verzeichnis legt ERAS2 dafür Unterordner an:
| Ordner | Inhalt |
|---|---|
Unverarbeitet | Heruntergeladen, noch nicht eingelesen. Alle Dateien in diesem Ordner werden beim nächsten Lauf eingelesen. |
InBearbeitung | Wird gerade eingelesen. |
Verarbeitet | Erfolgreich eingelesen. |
OhneZuordnung | Für die Datei wurde kein eindeutiges Objekt gefunden. |
Fehlerhaft | Beim Einlesen ist ein Fehler aufgetreten. |
Haben Sie die Ursache behoben, zum Beispiel eine fehlende Gerätenummer in ERAS2 nachgetragen, verschieben Sie die Datei zurück nach Unverarbeitet. Beim nächsten Lauf wird sie eingelesen.
Was übernommen wird
- Stichtagswerte mit der Ableseart
HA. - Aktuelle Werte und Monatswerte mit der Ableseart
MO. - Rauchwarnmelder vom Typ Q smoke 5.5 R erhalten den Status
in OrdnungoderFehler.
Zuordnung zu Ihren Objekten
Jede Datei wird genau einem ERAS2-Objekt zugeordnet. ERAS2 sucht die Geräte der Datei über Fabrikations- und Identnummer in Ihrem Bestand. Das erste Gerät, das eindeutig zu einem Objekt gehört, bestimmt das Objekt für die ganze Datei. Innerhalb des Objekts werden die Geräte über die Identnummer gefunden.
Lässt sich kein eindeutiges Objekt finden, landet die Datei im Ordner OhneZuordnung, und das Protokoll zeigt „Keine eindeutige Objektzuordnung für …“ mit den geprüften Gerätenummern.
Fehlermeldungen
| Meldung | Ursache | Abhilfe |
|---|---|---|
| „Ungültig Anmeldung mit QSMP Nutzer …“ | Benutzername oder Passwort ist falsch. | Zugangsdaten in Q-SMP prüfen und neu eintragen. |
| „API call failed. Status: 401 …“ oder „… 403 …“ | Der Zugang hat keine Berechtigung für die Schnittstelle. | Freischaltung bei Qundis klären. |
| „Rate limit exceeded (HTTP 429)“ | Zu viele Anfragen in kurzer Zeit. | Später erneut starten. |
| „… aus DSGVO-Gründen gelöscht“ | Qundis hat die Daten dieser Auslesungen gelöscht. | Keine Aktion möglich. ERAS2 fragt diese Auslesungen nicht erneut an. |
| „Auf das angegebene Importer Verzeichnis kann nicht zugegriffen werden“ | ERAS2 darf im Verzeichnis nicht schreiben. | Anderes Verzeichnis wählen oder Rechte prüfen. |