VCOM Cloud
English German
VCOM Cloud
English German
Breadcrumbs

Portalschnittstelle V2

Zuletzt geändert:

Über Portalschnittstelle V2

Die Portalschnittstelle V2 ist eine standardisierte Push-Schnittstelle zur Übertragung von Daten aus externen Systemen an VCOM. Diese wird typischerweise verwendet, wenn ein System nicht durch eine dedizierte Herstellerintegration unterstützt wird oder wenn Daten von einem proprietären Datenlogger, einem internen Überwachungssystem oder einem PPC übertragen werden müssen.

Anstatt dass VCOM Daten von einem Datenlogger oder einer Cloud-Plattform abruft, implementiert ein Hersteller oder ein Drittsystem die Import-Spezifikation von meteocontrol und sendet die Messdaten anschließend regelmäßig direkt an VCOM.

Die Nutzung dieser Datenquelle verursacht keine zusätzlichen Kosten.

📗

Allgemeine Tipps

  • Seriennummer: Halten Sie die Seriennummer der Datenquelle (Datenlogger usw.) bereit. Achten Sie bei der Eingabe der Seriennummer auf Groß- und Kleinbuchstaben und Leerzeichen.

  • Name: Generell kann der Name der Datenquelle frei gewählt werden. Empfehlungen dazu finden Sie in unserer Benennungsrichtlinie.

  • Mehrere Datenquellen: Verwenden Sie nach Möglichkeit Datenquellen, die dasselbe Messintervall unterstützen, oder gleichen Sie die Intervalle an. Andernfalls funktionieren untergeordnete Funktionen möglicherweise nicht ordnungsgemäß. Siehe auch Messintervall.

  • Automatische Geräteerstellung: Dies erstellt automatisch neue Geräte in der Anlage, wie etwa Wechselrichter oder Batterien, sobald deren Daten in einer neuen Importdatei enthalten sind. Sie können diese Geräte nicht manuell erstellen. In seltenen Ausnahmefällen, zum Beispiel wenn die Geräte bereits in einer anderen Anlage enthalten sind, müssen Sie dieses Kontrollkästchen nicht aktivieren.

  • Verbindungstest: Führen Sie wenn möglich einen Verbindungstest durch, sobald die Konfiguration sowohl in VCOM als auch in der Datenquelle abgeschlossen ist.

Nur Datenlogger

  • Bei Datenloggern aktualisieren Sie die Firmware auf die neueste Version vor der Konfiguration.

  • Bei Datenloggern kann jeder Import, der FTP verwendet, auch SFTP verwenden. Die Zugangsdaten, wie die FTP-Serveradresse, der Benutzername und das Passwort, bleiben identisch. Nur der Port ändert sich von Port 21 (FTP) auf Port 2222 (SFTP).

Nur APIs

  • Wenn Sie Importprobleme mit der API haben, wenden Sie sich bitte zuerst an den jeweiligen API-Anbieter.

  • Jeden Tag um Mitternacht überprüft VCOM die vollständigen Daten und fordert Daten der letzten 7 Tage an. Wenn es keine Einschränkungen von der API gibt und die Daten verfügbar sind, werden die Lücken gefüllt.

Konfigurationsdetails

Protokoll

  • FTP Push (Port 21) oder SFTP Push (Port 2222)

    • Die für Ihren Datenlogger spezifischen Anmeldeinformationen werden in VCOM angezeigt

  • oder HTTP Push

Hinweis zur Datenübertragung via FTP/SFTP

Als FTP/SFTP-Client können Sie maximal 10 parallele Verbindungen aufbauen. Bitte berücksichtigen Sie dies, wenn Sie Daten von vielen Datenloggern erfassen und diese gleichzeitig senden möchten.

Datenformat

  • XML (empfohlen)

  • oder CSV

Hinweis

Die maximale Größe einer einzelnen Datei beträgt 5 MB.

Mögliche Messintervalle

  • 60 Sek. (1 Min.). Werden zu einem größeren Intervall aggregiert, sobald der Speicherzeitraum für Minutenwerte abläuft. Siehe auch Datenauflösung und Speicherzeitraum.

  • 300 Sek. (5 Min.)

  • 600 Sek. (10 Min.)

  • 900 Sek. (15 Min.)

  • 1800 Sek. (30 Min.)

  • 3600 Sek. (60 Min.)

Server

Portalschnittstelle V2 als Datenquelle in VCOM hinzufügen

Voraussetzungen

  • Benutzergruppe Technical Customer oder höher

Schritte

  1. Auf der ANLAGENEBENE gehen Sie zu icon-wrench1.png Anlageneinstellungen > icon-database-insert.png Datenquellen > Übersicht.

  2. Wählen Sie + Neue Datenquelle. Ein Fenster erscheint.

  3. Wählen Sie Weitere Datenquellen.

  4. Wählen Sie Portalschnittstelle V2.

  5. Wählen Sie Weiter.

  6. Geben Sie unter Datenloggername einen Namen Ihrer Wahl ein, der den Hersteller Ihres Geräts enthält. Einige individuelle Namen sind im Portal bereits reserviert und können von Ihnen nur in Kombination mit einem Zusatz verwendet werden. Beispielsweise Sie nicht „sunspec“ verwenden, "sunspec", aber Sie können „sunspec logger“ verwenden "sunspec logger".

Reservierte Namen

  • abb

  • ae-sitelink

  • also-energy

  • archimede

  • aril

  • arteche

  • beckhoff

  • capfile

  • chint

  • contec

  • delos

  • diehl

  • edas

  • emacs

  • enedis

  • enerbird

  • field-logic

  • fronius

  • fudura

  • gantner

  • generic-csv

  • goodwe

  • growatt

  • huawei

  • i-less

  • inaccess

  • ip-gateway

  • joulz

  • kaco

  • kaco-xp100

  • kenter

  • kippzonen

  • kostal

  • laplace

  • lti

  • mako365

  • meteocontrol

  • meteocontrol-weblog

  • mscons

  • obvius

  • pronomic

  • raptech

  • renesys

  • seegma

  • seinon

  • sigenergy

  • skytron

  • sma

  • sol-connect

  • solar-md

  • solar-monitor

  • solaredge

  • solargis

  • solarlog

  • solarmax

  • solis-cloud

  • solon

  • streem

  • sungrow

  • sunspec

  • sunways

  • suryalog

  • tmeic

  • tricera

  • uribe-solar

  • wattline

  • webdyn

  • zebotec

  1. Geben Sie die Hardware-Seriennummer Ihres Geräts ein. Diese ist auch in den Importdateien enthalten und muss hier eingegeben werden, um die Dateien eindeutig Ihrer Anlage zuzuordnen.

  2. Wählen Sie unter Datentransfer über, wie die Daten übertragen werden sollen:

    • FTP (oder SFTP).

    • Oder HTTP.

  3. Wählen Sie unter Messintervall, wie oft die Daten tatsächlich gemessen werden. Dies sind häufig 300 Sek./5 Min. Wenn Ihr Gerät 1-Minuten-Werte unterstützt, wählen Sie das Intervall, auf das die Daten nach Ablauf des Speicherzeitraums für Minutenwerte aggregiert werden sollen. Siehe auch Datenauflösung und Speicherzeitraum.

  4. Aktivieren Sie das Kontrollkästchen Automatische Geräteerstellung. Dadurch werden neue Geräte in der Anlage, wie z.B. Wechselrichter oder Batterien, automatisch erstellt, sobald deren Daten in einer neuen Importdatei enthalten sind. Sie können diese Geräte nicht manuell erstellen.

  5. Wählen Sie Neuen Datenlogger registrieren.

  6. Je nach der von Ihnen gewählten Datenübertragungsmethode erscheinen zusätzliche Felder:

    • FTP Übertragung: Ihre Zugangsdaten werden automatisch generiert und zusammen mit der Serveradresse unter FTP-Zugangsdaten angezeigt. Verwenden Sie die Zugangsdaten, um Ihre Daten an den Server zu senden.

    • HTTP Übertragung: Die Adressen Server (XML) und Server (CSV) werden angezeigt. Wählen Sie den Server aus, der dem Format Ihrer Daten entspricht. Verwenden Sie den von Sales bereitgestellten API-Key, um Datenübertragungen zu authentifizieren.

  7. Einstellungen speichern auswählen.

Ihre Anlage ist nun als Datenquelle in VCOM registriert. Sobald es mit der Import-Spezifikation von meteocontrol und den zuvor bereitgestellten Zugangsdaten konfiguriert ist, kann es automatisch Daten an VCOM übertragen.

Drittanbieter, welche die Portalschnittstelle V2 verwenden

Im Folgenden finden Sie Beispiele für Drittanbieter, die Portalschnittstelle V2 unterstützen. Bitte beachten Sie, dass dies keine vollständige Liste ist.

Vorsicht

meteocontrol kann nicht garantieren, dass Drittanbieter aktuelle Importkonfigurationen aufrechterhalten. Für Details zur Einrichtung und andere Fragen wenden Sie sich direkt an den Hersteller.

Hersteller

Funktion

Importdaten

Protokoll

Weitere Informationen

DeXCon

PPC

check mark Zähler/Netzanalysator

check mark PPC

FTP Push

Datenformat: XML

https://www.dexcon.tech/

Elum

PPC

check mark Wechselrichter

check mark Zähler/Netzanalysator

check mark Wettersensoren

check mark Batterie

FTP Push

Datenformat: XML

https://elum-energy.com/energy-monitoring-software

IntegraSUN

Datenlogger

check mark PPC

FTP Push

Datenformat: XML

IntegraSUN – ServiceZeit

Plexlog

Datenlogger

check mark Wechselrichter

check mark Zähler/Netzanalysator

check mark Wettersensoren

FTP Push

Datenformat: XML

https://www.plexlog.de/web/

SmartDog

Datenlogger

check mark Wechselrichter

check mark Zähler/Netzanalysator

check mark Wettersensoren

FTP Push

Datenformat: XML

https://www.ecodata-sl.de/de/produkte/smartdog

Last updated: