Composant public

Le module "Servicedesk" est livré avec un composant publique qui permet de l'intégrer avec un site extérieur. Cela permettra aux visiteurs d'une ressource Web de communiquer avec les utilisateurs du système TeamWox via les demandes.

Il faut se rapporter attentivement à l'intégration du module "Servicedesk" avec le site Web. L'installation simultanée d'un composant publique sur plusieurs pages peut provoquer un ralentissement significatif du travail de la ressource Web.

L'intégration du module avec le site se passe à l'aide du fichier css et de script java. Ces fichiers doivent être appelés de la page HTML spéciale, dont un exemple est donné ci-dessous:

<!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>

Cette page contient un certain nombre des structures qui doivent être présents:

Liens aux fichiers CSS et JS

Deux fichiers "script.js" et "style.css" sont nécessaires pour le travail du composant public du module "Servicedesk". Il faut les télécharger à partir de votre système TeamWox par les liens suivants:

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

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

Il faut y indiquer l'adresse de votre système TeamWox au lieu de "team.yourdomain.com". Il faut placer les fichiers téléchargés sur le site, où sera intégré un composant public du module. Puis les liens correspondants vers eux devraient être spécifiés dans le fichier HTML, par exemple:

<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>

Au niveau suffisant des connaissances de CSS et Javascript, l'utilisateur peut faire les changements dans la présentation du composant public du module "Servicedesk".

Identificateur du conteneur

L'enregistrement du composant public du module se passe au conteneur défini à la page HTML. Cela peut être n'importe quel conteneur. Dans l'exemple, donné au-dessus, c'est la balise <div>:

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

Dans ce cas le moment clé c'est l'attribution de l'identificateur unique (id = "service_desk" dans l'exemple) au conteneur, qu'il faudra nécessaire d'indiquer après dans l'un des paramètres plus bas.

Réglages

Les paramètres sont spécifiés dans la construction "tw_servicedesk_params var ={...}". La partie des paramètres est obligatoire:

url: 'adresse du serveur TeamWox'

Ici on indique l'adresse de votre serveur TeamWox dans les apostrophes, par exemple, ' team.yourdomian.com '.

sid:'l'identificateur de l'utilisateur'

Ce champ est l'un des plus importants. Il influence la séparation des droits d'accès des utilisateurs du site aux demandes créées. A l'aide de la structure spéciale l'identificateur unique pour chaque visiteur du site doit être mis dans sa valeur.

Pour les utilisateurs enregistrés du site vous pouvez utiliser MD5 du mot clé et de l'identificateur d'utilisateur sur le site comme une valeur de champ.

Pour les utilisateurs anonymes vous pouvez utiliser MD5 des cookies.

S'il la séparation des utilisateurs selon les groupes est prévu sur le site, en mettant l'identificateur du groupe à ce champ, vous pouvez organiser un travail commun avec des utilisateurs avec les mêmes demandes. Quand on met la valeur fixée "sid", chaque utilisateur pourra examiner toutes les demandes créées.

Dans ce champ doit être spécifié un tel paramètre qui sera impossible de choisir. L'utilisation des identificateurs simples est inacceptable et peut amener à l'accès non sanctionné aux demandes. La visibilité des demandes à tel ou tel utilisateur est définie notamment selon la valeur de ce champ. Les exemples pour chacun des cas indiqués au-dessus sont amenés au paragraphe séparé.

container:'l'identificateur du conteneur'

Dans ce paramètre on spécifie l'identificateur du conteneur, où s'affichera l'interface du composant public du module "Servicedesk".

user_name:'le nom de l'utilisateur'

Ce paramètre doit être recueilli par le site Web, la structure doit être inscrite dans sa valeur, qui met l'information correspondante sur l'utilisateur du site.

Le groupe suivant des paramètres est facultatif:

user_email:'l'adresse e-mail de l'utilisateur'

L'adresse du courrier électronique de l'utilisateur.

Dans le système TeamWox travaille le rattachement automatique des demandes aux organisations par l'adresse du courrier électronique.

user_company:'le nom de la compagnie de l'utilisateur'

Le nom de la compagnie de l'utilisateur.

Les adresses e-mail et les noms des compagnies devraient aussi être recueillis par le site web. Dans leurs valeurs il faut spécifier les structures qui mettent les données correspondantes des visiteurs du site.

incidents_per_page:le nombre des demandes sur une seule page

Ici il faut spécifier le nombre des demandes qui seront affichées sur une page. Si ce paramètre n'est pas spécifié, la valeur implicite est utilisée (10).

comments_per_page:le nombre des commentaires sur une seule page

Dans ce paramètre on spécifie le nombre des commentaires à la demande affichée sur une page. Si ce paramètre n'est pas spécifié, la valeur implicite est utilisée (10).

filter_groups:[la liste des identificateurs des groupes disponibles]

Ici il faut spécifier les identificateurs des groupes entre les crochets, séparés par la virgule qui seront disponibles pour les utilisateurs au choix de la création de la demande. L'identificateur du groupe est indiqué sur l'onglet "Information" de la fenêtre de l'édition de ses paramètres.

Pour que le groupe était disponible publiquement il faut activer l'option correspondante dans les réglages.

filter_categories:[la liste des identificateurs des catégories disponibles]

Dans ce paramètre il faut spécifier les identificateurs des catégories entre les crochets, séparés par la virgule, créés dans les groupes, selon lesquels les utilisateurs pouront créer des demandes. L'identificateur de la catégorie est indiqué sur l'onglet "Catégories" de la fenêtre de l'édition des paramètres du groupe.

filter_products:[la liste des identificateurs des produits disponibles]

Dans ce paramètre il faut spécifier les identificateurs des produits, entre les crochets, séparés par la virgule, créés dans les groupes, selon lesquels les utilisateurs pouront créer des demandes. L'identificateur du produit est indiqué sur l'onglet "Produits" de la fenêtre de l'édition de paramètres du groupe.

logo:'le code HTML de l'en-tête de la fenêtre'

A son aide vous pouvez changer l'en-tête standard de la fenêtre des demandes à votre propre. Pour cela il faut spécifier votre propre code HTML de l'en-tête. Les exemples les plus simples sont les suivants:

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

Les exemples supplémentaires de la réalisation du composant public du module "Servicedesk" sur "PHP" et ". NET" sont présentés dans les paragraphes séparées. L'exemple de la page de travail du composant public du module est amené dans le paragraphe "Demandes extérieures".

Actuellement il y a deux langues de la fenêtre des demandes, russe et anglais, qui sont automatiquement sélectionnés en fonction de la langue de l'utilisateur du système d'exploitation. Les traductions de l'interface sont stockés dans le fichier "script.js". Au niveau suffisant des connaissances, les nouvelles traductions peuvent être y ajoutées.