Einrichtung einer Schnittstelle zu meteocontrol VCOM

Nutzer des Monitoring-Systems VCOM von meteocontrol können über eine API-Schnittstelle eine Verbindung zur CMMS-Software TabTool PV O&M herstellen und Tickets aus VCOM zur Weiterbearbeitung an diese übertragen.

So richten Sie die Schnittstelle zu VCOM ein

Um die VCOM-Schnittstelle nutzen zu können, müssen Sie in TabTool PV O&M zunächst das Modul "PV Meteocontrol API" aktivieren. Wie Sie dabei vorgehen, lesen Sie im Artikel Module aktivieren oder deaktivieren in TabTool. 

Dadurch werden in Ihrem TabTool-Paket Felder aktiviert, die für die Kommunikation mit VCOM gefüllt werden müssen:

In der Projektakte finden Sie im Bereich "Anlagen-Stammdaten" das Feld "VCOM Project ID". In dieses tragen Sie den fünfstelligen Anlagen-Key aus VCOM ein.

Öffnen Sie das System-Menü und dort die Benutzerverwaltung. 

Tragen Sie bei jedem Nutzer, der Tickets bearbeiten soll, im Feld "VCOM User" entweder dessen VCOM-Benutzernamen (sofern vorhanden) oder einen einheitlichen Standardnutzer ein, z.B. TabTool. 

Dieser Standardnutzer sollte entsprechend bei VCOM eingerichtet werden. Auf diese Weise können auch TabTool-Nutzer, die keinen eigenen Nutzer-Account in VCOM haben, mit VCOM kommunizieren und Ticket-Aktualisierungen übermitteln.

Öffnen Sie den Bereich "Einstellungen" im System-Menü.

Klicken Sie im Einstellungs-Menü auf "Schnittstelle Einstellungen" und tragen Sie in der rechten Spalte die geforderten Daten in die Felder ein, die Sie Ihrem VCOM-Account entnehmen können.

Wählen Sie einen Trigger für die Übertragung von Tickets aus VCOM an TabTool aus ("Verantwortlicher zugewiesen" und/oder "Service-Einsatz gesetzt"), indem Sie die entsprechende Checkbox aktivieren. Es muss mindestens einer der Trigger gewählt werden, damit eine Übertragung möglich ist.

Welche Daten werden von VCOM zu TabTool übertragen?

Mit dem Aktivieren des Moduls "PV Meteocontrol API" werden die in VCOM hinterlegten Ticket-Ursachen von VCOM ausgelesen und  als "Ticket-Art" in TabTool übernommen. Die neuen Einträge bekommen das Präfix “VCOM” und können in den TabTool-Stammdaten nicht gelöscht werden. Die Einträge bleiben auch erhalten, falls Sie "PV Meteocontrol API" deaktivieren.

In den TabTool-Tickets finden Sie diese Einträge im Dropdown-Feld für die Ticket-Art.

Aus den in VCOM erstellten Tickets werden die folgenden Daten an TabTool übertragen:

• Bezeichnung
• Ticket-Art
• Beschreibung
• Start-Termin
• erster Kommentar (wird in TabTool als erster Eintrag in "Verlauf" aufgeführt)

Die Ticket-Nummer wird ebenfalls übermittelt, allerdings nicht in TabTool angezeigt. Stattdessen erhalten die Tickets in TabTool eine eigene Ticketnummer. Bei der Rück-Synchronisation der Daten aus TabTool zu VCOM bleibt die VCOM-Ticketnummer aber erhalten und wird nicht von der TabTool-Ticketnummer überschrieben.

Nach der Übertragung zu TabTool sollten die Tickets ausschließlich dort weiterbearbeitet werden, da spätere Einträge in VCOM nicht mehr zu TabTool übermittelt werden. In TabTool eingetragene Daten werden jedoch sofort übermittelt und in VCOM aktualisiert.

Erledigte Tickets können in TabTool geschlossen werden und werden sowohl in der Ticketliste in TabTool als auch in VCOM geschlossen.