Öffentliche Komponente

Im Modul "Servicedesk" ist eine öffentliche Komponente integriert, die es ermöglicht, eine Verbindung zu einer externen Webseite herzustellen. Dies ermöglicht die Kommunikation zwischen den Benutzern einer externen Webseite mit den Benutzern des TeamWox-Systems.

Beachten Sie bitte, dass es bei der Verbindung des Moduls "Servicedesk" mit einer externen Webseite zu einer bedeutenden Verlangsamung der Arbeit der externen Webseite führen kann, insbesondere wenn Sie die Verbindung an mehreren Stellen einrichten.

Die Verbindung des Moduls mit der Webseite erfolgt mittels Datei im "css"-Format und Java-Script. Diese Dateien müssen von einer speziellen HTML-Seite aufgerufen werden, wie im Beispiel unten angeführt:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
  <title></title>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  <link href="http://www.yourwebsite.com/servicedesk/style.css" type="text/css" rel="stylesheet" />
  <script type="text/javascript">
  var tw_servicedesk_params=
  {
   url:'https://team.yourdomain.com',
   sid:'user_id',
   container:'service_desk',
   user_name:'user_name',
   user_email:'user_email',
   user_company:'user_compamy',
   incidents_per_page:3,
   comments_per_page:5,
   filter_groups:[group_id],
   filter_categories:[category_id],
   filter_products:[product_id],
   logo:'logo_html_code'
  }
  </script>
  <script src="http://www.yourwebsite.com/servicedesk/script.js" type="text/javascript"></script>
</head>
<body>
<div id="service_desk"></div>
</body>
</html>

In dieser Seite gibt es eine Reihe von Daten, die unbedingt vorhanden sein müssen:

Links auf CSS- und Java-Script Dateien

Für die Arbeit mit der öffentlichen Komponente des Moduls "Servicedesk" werden die zwei Dateien: "script.js" und "style.css" benötigt. Diese müssen Sie von Ihrem TeamWox-System mit den folgenden Links herunterladen:

https://team.yourdomain.com/public/servicedesk/style.css

https://team.yourdomain.com/public/servicedesk/script.js

Bitte achten Sie darauf an Stelle von "team.yourdomain.com" Ihre TeamWox-Adresse einzugeben. Die heruntergeladenen Dateien müssen Sie nun in der Webseite an der Stelle hochladen, wo Sie den öffentlichen Teil des Moduls integrieren wollen. Dann müssen in der HTML-Datei die entsprechenden Links auf diese angegeben werden, z.B.:

<link href="http://www.yourwebsite.com/servicedesk/style.css" type="text/css" rel="stylesheet" />
<script src="http://www.yourwebsite.com/servicedesk/script.js" type="text/javascript"></script>

Wenn Sie sich mit CSS und Javascript gut auskennen, können Sie die Änderungen im Modul "Servicedesk" vornehmen.

ID des Block-Elements

Der Verweis der öffentlichen Komponente des Moduls erfolgt im Textkörper der HTML-Datei. Der Verweis kann an beliebiger Stelle zwischen den Tags <body> und </body> stehen. Im oben angeführten Beispiel ist es das Tag <div>:

<div id="service_desk"></div>

In diesem Beispiel wird dem Block-Element eine unikale ID (hier: id="service_desk") gegeben, die im folgenden in einem der Parameter unten angegeben werden muss.

Parameter

Parameter werden in der Konstruktion "var tw_servicedesk_params={...}" angegeben. Ein Teil von ihnen ist obligatorisch:

url:'Adresse des Servers TeamWox'

Hier wird in Einzel-Anführungsstrichen die Adresse Ihres TeamWox-Servers eingegeben z.B. 'team.yourdomian.com'.

sid:'Identifikator des Benutzers'

Dies ist ein sehr wichtiger Verweis. Er beeinflusst die Zugriffsberechtigungen zu erstellten Anfragen der Webseitenbenutzer. Mittels eines speziellen Verweises muss ein unikaler Identifikator für jeden Webseitenbesucher erstellt werden.

  • Für registrierte Besucher der Webseite kann als Wert des Feldes MD5 das Schlüsselwort oder die ID des Benutzers der Webseite verwendet werden.
  • Für anonyme Besucher kann MD5 von Cookies verwendet werden.
  • Wenn auf der Webseite eine Unterteilung der Besucher nach Gruppen vorausgesehen ist, können Sie mittels Substitution des Identifikatoren der Gruppe in diesem Feld die gemeinsame Arbeit der Benutzer mit denselben Anfragen organisieren. Bei Installation des fixierten Wertes "sid", kann jeder Benutzer alle erstellten Anfragen durchsehen.

In diesem Feld muß der Parameter angegeben werden, den man nicht wählen kann. Die Verwendung von einfachen Identifikatoren ist entbehrlich und kann zum unbefugten Zugriff zu Anfragen führen. Die Sichtbarkeit der Anfragen für den einen oder anderen Benutzer wird nach dem Wert dieses Feldes bestimmt. Beispiele für jeden der oben angegebenen Fälle werden in einem selbstständigen Abschnitt dargestellt.

Block Element:'ID des Block-Elements'

In diesem Parameter wird die ID des Block-Elements angegeben, wo das Interface des öffentlichen Teils des Moduls "Servisedesk" dargestellt wird.

user_name:'Benutzername'

Dieser Parameter muss von der Website erstellt werden, Ihr Wert muss die entsprechende Information über den Webseitenbenutzer enthalten.

 

Die folgende Gruppe von Parametern ist fakultativ:

user_email:'Emailadresse des Benutzers'

Emailadresse des Benutzers.

Im TeamWox-System funktioniert die automatische Bindung der Anfragen an Organisationen nach der Emailadresse.

user_company:'Gesellschaftsname des Benutzers'

Name der Gesellschaft des Benutzers.

Emailadressen und Namen der Gesellschaften müssen auch von der Webseite gespeichert werden. In ihre Werte muss man Angaben einschließen, die die entsprechende Daten der Seitenbenutzer enthalten.

incidents_per_page:Anzahl der Anfragen für eine Seite

Hier wird die Anzahl der Anfragen angegeben, die auf einer Seite dargestellt werden. Beim Fehlen dieses Parameters wird der Default-Wert (10) verwendet.

comments_per_page:Anzahl der Kommentare auf einer Seite

In diesem Parameter wird die Anzahl der Kommentare zu einer Anfrage angegeben, die auf einer Seite dargestellt wird. Beim Fehlen dieses Parameters wird der Default-Wert (10) verwendet.

filter_groups:[Liste der Identifikatoren der zugänglichen Gruppen]

Hier muss man in eckigen Klammern, durch Komma getrennt, die Identifikatoren der Gruppen angeben, die den Benutzern zugänglich werden, wenn sie eine Anfrage erstellen. Die ID der Gruppe wird in der Registerkarte "Information" des Editierfensters ihrer Parameter angegeben.

Damit die Gruppe öffentlich zugänglich ist, muss man die entsprechende Option in Einstellungen wählen.

filter_categories:[Liste der Identifikatoren der zugänglichen Kategorien]

In diesem Parameter muss man in eckigen Klammern, durch Komma getrennt die ID der Kategorien angeben, die in Gruppen erstellt wurden, nach denen Benutzer Anfragen erstellen können. Die ID der Kategorie wird in der Registerkarte "Kategorien" des Editierfensters der Gruppenparameter angegeben.

filter_products:[Liste der Identifikatoren der zugänglichen Produkte]

In diesem Parameter muss man in eckigen Klammern, durch Komma getrennt, die ID der in Gruppen erstellten Produkte angeben, nach denen Benutzer Anfragen erstellen können. Die ID des Produktes wird in der Registerkarte "Produkte" des Editierfensters der Gruppenparameter angegeben.

logo:'HTML Code des Header'

Mittels dieses Parameters kann man den Standard-Header des Fensters den eigenen Wünschen entsprechend ändern. Dafür muß man die Parameter des eigenen Header im HTML-Code angeben. Die einfachsten Beispiele sind:

<img src="yourwebsite.com/res/logo.png" />
<span style="font-size:14px; color: rgb(73, 194, 85);">Service Desk</span>

Zusätzliche Beispiele zur Realisierung des öffentlichen Teils des Moduls  "Servicedesk" auf "PHP" und ".NET" werden in selbstständigen Abschnitten erklärt. Ein Beispiel für eine fertigen Seite der öffentlichen Komponente des Moduls wird im Abschnitt "Äussere Anforderungen" gegeben.

Zur Zeit sind nur zwei Sprachen die Seite der Anfragen vorgesehen: Russisch und Englisch, die automatisch, abhängig von der Sprache des Operationssystems des Benutzers, gewählt werden. Übersetzungen des Interfaces werden in der Datei "script.js" gespeichert. Wenn Sie genug Kenntnisse haben, können Sie Übersetzungen darin selbstständig hinzufügen.