Die Integration von pcvisit in Ihr Ticketsystem
Die Integration von pcvisit in Ihr Ticketsystem
Sie können mit Hilfe von pcv-Dateien Daten aus Ihrem Ticket oder Kundenverwaltungssystem mit der Protokollierung der pcvisit Fernwartung verbinden. Die Einrichtung der Integration lässt sich in 3 Teile zerlegen:
Die Konfiguration der Fernwartung bzw. die Übergabe Ihrer Daten in die Fernwartung mit Hilfe der pcv-Dateien
Die Fernwartung selbst
Versenden der gewünschten Daten der Fernwartung via E-Mail
Um die Integration in Drittsysteme nutzen zu können, müssen Sie die Kommentar-Funktion in den Einstellungen aktiviert.
Erstellen der pcv-Datei
Sie können die Datei auf 3 mögliche Arten erzeugen:
Manuell eine Datei in Ihrem Dateisystem erstellen und deren Endung in pcv ändern
In Ihrem pcvisit Supporter-Modul mit der rechten Maustaste auf einen Remote-Host in der Liste klicken und “Desktop-Verknüpfung erstellen” anwählen (vgl. Abbildung rechts)
Über den Aufruf einer URL im Browser (dazu später mehr)
Die pcv-Datei können Sie mit Ihrem Texteditor bearbeiten. Der inhaltliche Aufbau entspricht dem Standard einer ini-Datei:
[Gruppename]
Optionsname=Wert
Optionsname=Wert
Abbildung: Desktop-Verknüpfung aus Remote-Host erstellen
Folgende Gruppennamen sind derzeit definiert:
Gruppenname | MacroToken für die E-Mail-Dokumentation | Standard-Abfragezeitpunkt in einer Fernwartung |
General | – | – |
Comment0 | ${comment0} | Beim Anlegen der Fernwartung |
Comment1 | ${clientid} oder ${comment1} | Beim erstmaligen Beitritt eines Teilnehmers (nicht des Fernwartung-Erstellers) |
Comment2 | ${servicedescription} oder | Beim Beenden der Fernwartung |
Comment3 | ${comment3} | – |
Comment4 | ${comment4} | – |
Comment5 | ${comment5} | – |
Comment6 | ${comment6} | – |
Comment7 | ${comment7} | – |
Comment8 | ${comment8} | – |
Comment9 | ${comment9} | – |
Die Reihenfolge der Gruppen in der pcv-Datei spielt keine Rolle.
Die Gruppe „General“ kann derzeit nur den Wert „Computer“ enthalten, welcher die Remote-Host-Kennung eines Remote-Hosts aufnimmt. Beim Start des Supporter-Moduls mittels solch einer pcv-Datei wird sich direkt zu diesem Remote-Host verbunden (wenn Remote-Host online) bzw. dieser in die Remote-Host-Liste übernommen.
Mit Hilfe folgender Optionen kann das Standard-Verhalten der jeweiligen Comment-Gruppe überschrieben werden. Fehlt eine Option bei einer Comment-Gruppe, so wird stets deren Standard-Verhalten genutzt.
Optionsname | Optionswert | Bedeutung | Standard, wenn leer |
VisibilityInGUI | visible | Kommentar ist im Modul sicht- und änderbar | visible |
Timing | AtStart | Wann soll der Kommentar in das Fernwartungs-Protokoll übernommen werden: | nie (siehe Tabelle oben) |
DescriptionInGUI | beliebiger Text | Bezeichnung der sichtbaren Kommentare im Supporter-Modul | Bei den Gruppen Comment0, Comment1 und Comment2 erscheint der normale Text dieser Kommentare im Modul. Bei den anderen erscheint nichts. |
DefaultValue | beliebiger Text | Sichtbare Kommentare zeigen diesen änderbaren Text im Supporter-Modul an | kein Inhalt |
CommentAlias | beliebiger Text | im XML-Fernwartungs-Protokoll erhält der Eintrag des Kommentars diesen Wert als “name”-Parameter. Diese Option ist nur wichtig, wenn Sie das XML-Ferwartungs-Protokoll automatisiert auswerten und einen eindeutigen Namen für einen Kommentar vergeben möchten | kein Inhalt |
Beispiel zur Veranschaulichung
Ziel der pcv-Datei ist das automatisierte Aufbauen einer Fernwartung zu einem Remote-Host mit der Kennung Druckerserver#2. Dabei soll der Standard- Fernwartung-Startkommentar NICHT angezeigt werden und auch keinen Wert enthalten.
Ein weiterer Kommentar soll mit dem aus einem Ticketsystem kommenden Firmen-Namen des Kunden belegt werden und dabei NICHT in der Fernwartung selbst änderbar und sichtbar sein. Ein dritter Kommentar soll beim Beitritt des Kunden im Supporter-Modul erscheinen, in dem der Supporter den Namen des Ansprechpartners am Kundenrechner eintragen kann.
Am Ende der FW soll der Supporter die Möglichkeit haben, eine Zusammenfassung der Fernwartung einzutragen. Die beiden letzten Kommentare sollen im Modul jeweils “Name des Ansprechpartners” bzw. “Zusammenfassung” heißen.
Ein weiterer Kommentar soll mit dem aus einem Ticketsystem kommenden Firmen-Namen des Kunden belegt werden und dabei NICHT in der Fernwartung selbst änderbar und sichtbar sein. Ein dritter Kommentar soll beim Beitritt des Kunden im Supporter-Modul erscheinen, in dem der Supporter den Namen des Ansprechpartners am Kundenrechner eintragen kann.
Am Ende der FW soll der Supporter die Möglichkeit haben, eine Zusammenfassung der Fernwartung einzutragen. Die beiden letzten Kommentare sollen im Modul jeweils “Name des Ansprechpartners” bzw. “Zusammenfassung” heißen.
[General]
Computer=Druckerserver#2
[Comment0]
VisibilityInGUI=hidden
[Comment1]
DefaultValue=Firma Müller
VisibilityInGUI=hidden
[Comment3]
Timing=AtEnter
DescriptionInGUI=Name des Ansprechpartners
[Comment2]
DescriptionInGUI=Zusammenfassung
Soll ein Kommentar unsichtbar und ohne Wert bleiben, so reicht es die Sichtbarkeit zu definieren; und zwar auf unsichtbar (hidden).
Mit Hilfe der URL https://integration.pcvisit.de/sm_with_params können Sie die pcv-Datei automatisiert erstellen und herunterladen. Der Aufruf gestaltet sich dabei wie folgt:
Um also das Beispiel weiter oben automatisiert erstellen zu lassen, muss die URL folgendermaßen aussehen:
Hinweis: der Wert %23 im Wert “Druckerserver#2” entspricht dem Zeichen #, welches oftmals in der pcvisit Remote-Host-Kennung vorkommt.