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.

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:

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:

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:

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

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.

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.

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

Le nom de la compagnie de l'utilisateur.

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:

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