Webformular

Sie können mehrere, unterschiedliche Webformulare generieren, um diese auf einer oder mehreren Ihrer Webseiten zu integrieren.

Über diese Webformulare können Ihre Kunden Störmeldungen, Feedback oder ticketrelevante Informationen direkt an KIX senden. Für jede Nachricht, die über ein Webformular eingeht, erstellt KIX automatisch ein neues Ticket.

Abb.: KIX Webformular

Zu jedem Webformular, welches Sie in KIX anlegen, generiert KIX 2 Codeschnipsel unter Berücksichtigung der von Ihnen festgelegten Parameter.

Binden Sie jeweils beide Codeschnipsel im Quellcode Ihrer Website ein und stellen Sie somit das Formular auf Ihrer Website bereit.

Ein Codeschnipsel für den Button, welcher das Formular aufruft und anzeigt.
Ein Codeschnipsel für die benötigten Scripte, welche das Formular zur Laufzeit generieren.

Abb.: Beide Codeschnipsel zum Einbinden in die Website

Tipp

Sie können eine Ticketbenachrichtigung einrichten, welche die Agenten automatisch informiert, sobald ein Ticket über ein Webformular eingegangen ist (s. Benachrichtigungen)

Konfigurationsparameter

Parameter (Auswahl)	Beschreibung
Name Aufruf-Button	Die hier angegebene Bezeichnung steht auf dem Button, welcher das Formular aufruft, z. B. Feedback oder Nachricht schreiben.
Formulartitel	Der Formulartitel wird im Kopf des Webformulars angezeigt.
Titel im Formular anzeigen	Ist diese Option gewählt, wird der im Feld Formulartitel hinterlegte Text im Kopf des Webformulars angezeigt.
Name Speichern-Button	Die hier angegebene Bezeichnung steht auf dem Absende-Button des Formulars, z. B. "absenden oder Submit.
Hinweistext	Freitext für Hinweise im Formular.
Info nach Absenden	Freitext welcher nach Absenden des Formulars angezeigt wird. Z. B. Vielen Dank für Ihre Anfrage. Wir kontaktieren Sie so schnell wie möglich.
Modalen Dialog starten	Ist diese Option aktiviert, wird das Formular in einer Lightbox (Modal) geöffnet. Die Webseite im Hintergrund des Webformulars ist inaktiv, solange der Dialog geöffnet ist.
KIX CSS verwenden	Ist diese Option aktiviert, wird das Webformular im KIX Design dargestellt. Sie können eigene CSS-Dateien für das Design des Formulars verwenden. Passen Sie dazu im Codeschnipsel die Codezeile `<link href="[…]/kix-form.css" rel="stylesheet">` an, indem Sie auf Ihre CSS-Datei verweisen.
Anlagen zulassen	Wird diese Option aktiviert, können an Tickets, die über das Webformular erstellt werden, Anhänge hinzugefügt werden.
Akzeptierte Domains	Tragen Sie hier eine oder mehrere Domains ein von denen das Formular gesendet wird. Verwenden Sie bspw. `https://www.meinehomepage.de` oder geben Sie die Domains als regulären Ausdruck an (RegEx) an. Beim Speichern prüft und validiert KIX Ihre Eingaben auf eine korrekte RegEx-Syntax. KIX setzt ggf. fehlende Slashs und ändert Ihre Eingaben in einen für das Webformular interpretierbaren regulären Ausdruck. So wird bspw. die Eingabe von `` oder `.` oder `.+` in `/./` geändert. Kommata und Semikola können innerhalb der RegEx-Syntax nicht verwendet werden, da diese von KIX als Domain-Trenner interpretiert werden. Die Eingaben folgender Formate werden ignoriert und nicht gespeichert, auch wenn sie Teil einer mit Komma oder Semikolon getrennten Liste sind: / (Slashs in beliebiger Anzahl) nur Leerzeichen Kombination aus Slash und Leerzeichen (z. B. `///` oder `// /////` oder `/ /// // ///` oder `/ /` ) `` oder `.` oder `.+` als Teil einer Liste Anderenfalls erfolgt die automatische Korrektur des Ausdrucks durch KIX (s. oben) Beispiel: Die Eingabe von `/my\.domain/;/ /;//;` würde geändert zu `/my\.domain/` Beispiele für gültige Eingaben: `meine.domain.com; /test/; /.+\.my\.domain/` `/./` `` `/foo/,/bar/` Beispiele für ungültige Eingaben (invalides RegEx): `meine.domain.com; /test(123/; /.+\.my\.domain/` (fehlende schließende Klammer) `//` Hinweis zu bestehenden Daten Bestehende Werte werden systemintern als RegEx aufbereitet. Eine Prüfung auf Validität erfolgt nicht. Ein bisheriger Wert z. B. "my.domain", "/test.+123/", "foo", "my.second-domain.com" wird zu folgendem RegeEx geändert: "(my.domain\|test.+123\|foo\|my.second-domain.com)". KIX nimmt also alle Werte, entfernt eventuelle Slashs ( / ), verbindet die Werte mit \| und setzt den Ausdruck in Klammern. Dies stellt keine Migration dar. Der Wert wird nur im Code angepasst, aber nicht durch das System gespeichert. Tipp:* Da der angepasste Wert im Bearbeiten-Dialog angezeigt wird, braucht dieser nur mit "Speichern" übernommen zu werden.
Gültigkeit	gültig: Das Webformular ist gültig und kann verwendet werden. (temporär) ungültig: Das Webformular ist ungültig kann (vorübergehend) nicht verwendet werden.
Team	Legen Sie fest, welchem Team die über das Webformular erzeugten Tickets zugeordnet werden.
Priorität	Legen Sie fest, welche Priorität den über das Webformular erzeugten Tickets zugewiesen wird.
Typ	Legen Sie fest, welcher Tickettyp den über das Webformular erzeugten Tickets zugewiesen wird.
Status	Legen Sie fest, welcher Ticket-Status den über das Webformular erzeugten Tickets zugewiesen wird.
Zugeordneter Agent	Damit über das Webformular Tickets im KIX erstellt werden können, muss am Formular ein Agent zugeordnet sein, der mindestens die Rolle "Webform Ticket Creator" hat. Legen Sie hierfür einen separaten Agenten an, der keine natürliche Person (Nutzer) ist.
Passwort	Hinterlegen Sie hier das Passwort des zugeordneten Agenten, um über das Webformular Tickets erstellen zu können. Hinweis Haben Sie das Passwort des Agenten in den Agenteneinstellungen geändert, muss es auch hier geändert werden, damit dieser Agent weiterhin Nachrichten über das Webformular erhalten kann. Da das Agentenpasswort jedoch regelmäßig geändert werden sollte, empfehlen wir, einen separaten, nicht natürlichen Agenten für den Empfang von Nachrichten aus dem Webformular anzuglegen.

Ein neues Webformular anlegen

Navigieren Sie im Explorer zu Kommunikation > Webformular.
Im Contentbereich wird eine Tabelle geöffnet, welche alle im System angelegten Webformulare auflistet.
Klicken Sie in der Tabelle auf Neues Formular.
Es wird ein Formular-Dialog geöffnet, in dem Sie das neue Webformular anlegen können.
Füllen Sie das Formular aus (siehe Konfigurationsparameter).
Setzen Sie die Gültigkeit auf "gültig".
Speichern Sie Ihre Eingaben abschließend mit Speichern.

Mit dem Speichern generiert KIX 2 Codeschnipsel zum Einbinden in Ihre Webseite. Diese finden Sie in Detailansicht des Webformulars (Lane "Code“).

Ein Webformular bearbeiten

Navigieren Sie im Explorer zu Kommunikation > Webformular
Im Contentbereich wird eine Tabelle geöffnet, welche alle im System angelegten Webformulare auflistet.
Klicken Sie in der Tabelle auf das zu bearbeitende Webformular.
Es wird ein Formular-Dialog geöffnet, in welchem Sie die Angaben ändern können.
Ändern Sie die Angaben nach Erfordernis.
Speichern Sie Ihre Änderungen mit Speichern.

Ihre Änderungen sind sofort wirksam. Gegebenenfalls müssen Sie die geänderten Codeschnipsel auf Ihrer Website ebenfalls korrigieren bzw. neu einfügen.

Ein Webformular in eine Webseite einbinden

Navigieren Sie im Explorer zu Kommunikation > Webformular.
Im Contentbereich wird eine Tabelle geöffnet, die alle im System angelegten Webformulare auflistet.
Klicken Sie in der Tabelle auf das gewünschte Webformular.
Die Detailansicht des Webformulars wird geöffnet.
Die Codeschnipsel zum Einbinden in Ihre Webseite befinden sich in der Lane Code.
Binden Sie den Codeschnipsel für die Scripte in Ihre Webseite ein:
Der Codeschnipsel muss einmal auf allen Seiten eingebunden werden, auf denen sich der Button befindet.
1. Kopieren Sie den mit <script> beginnenden Codeschnipsel vollständig in die Zwischenablage.
2. Fügen Sie den Codeschnipsel aus der Zwischenablage in den Quellcode Ihrer Website ein.
  Platzieren Sie ihn in den Bereich zwischen <head> und </head>.
3. Ersetzen Sie den Platzhalter <YOUR_FRONTEND_HOST> durch die URL Ihrer KIX-Frontend- Domain.
  Der Code enthält bereits die URL der KIX Frontend-Domain, wenn diese im Setup Assistent oder im SysConfig-Schlüssel FQDN hinterlegt ist.
4. Optional: Ersetzen Sie die Zeile <link href="[…]kix-form.css" rel="stylesheet"> durch den Dateipfad zu Ihrer eigenen CSS-Datei, wenn Sie ein eigenes Formular-Design verwenden möchten.
5. Speichern Sie die Änderung an der Website.
Binden Sie den Codeschnipsel für den Button in Ihre Webseite ein:
Der Codeschnipsel erzeugt einen Button auf der Website, in die er eingebunden wird. Durch Klick auf den Button wird das Webformular geöffnet.
Jeder Button kann mehrfach und auf mehreren Seiten integriert werden.
Über die ID des Buttons wird auf das jeweilige Formular referenziert (Störmeldung oder Feedback). Da jeder Button eine eigene ID besitzt, können verschiedene Buttons auf einer Website eingebunden und somit mehrere Formulare auf einer Website bereitgestellt werden.
1. Kopieren Sie den mit <button> beginnenden Codeschnipsel vollständig in die Zwischenablage.
2. Fügen Sie den Codeschipsel aus der Zwischenablage an die Stellen im HTML-Quellcode Ihrer Website ein, wo sich der Button zum Öffnen des Formulars befinden soll.
3. Speichern Sie die Änderung an der Webseite.
Laden Sie die geänderte/n Webseite/n auf Ihren Website-Host. Das Formular kann nun auf der Website genutzt werden.
Speichern Sie abschließend Ihrer Eingaben mit Speichern.

Abb.: HTML-Code einer Website mit integriertem Formular

In diesem Abschnitt: