Componente público

El módulo "Service Desk" se entrega con el componente público que permite integrarlo con los sitios web externos. Esta opción va a permitir a los visitantes de la página web comunicarse con los usuarios del sistema TeamWox mediante las incidencias.

Hay que tener cuidado con la integración del módulo "Service Desk" con un sitio web. La instalación simultánea del componente público en muchas páginas del sitio puede provocar la ralentización del funcionamiento del recurso web.

La integración del módulo con el sitio web se efectúa usando el archivo de estilos css y Java Script. Estos archivos han de ser llamados desde una página HTML especial cuyo ejemplo se muestra abajo:

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

Esta página contiene una serie de construcciones que hay que usar obligatoriamente:

Enlaces a los archivos CSS y JS

Para que el componente público del módulo "Service Desk" funcione, se necesitan dos archivos: "script.js" y "style.css". Tiene que descargarlos, utilizando los enlaces del siguiente tipo:

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

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

En vez de "team.yourdomain.com" tiene que poner la dirección de sus sistema TeamWox. Hay que colocar los archivos descargados en el sitio web al que va a integrarse el componente público del módulo. Luego es necesario indicar los enlaces correspondientes a ellos en el archivo HTML, por ejemplo:

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

Teniendo suficientes conocimientos de CSS y Javascript, el usuario puede modificar la apariencia del componente público del módulo "Service Desk".

Identificador de contenedor

El componente público del módulo se inserta en un determinado contenedor en la página HTML. Puede ser cualquier contenedor. En el ejemplo de arriba es la etiqueta <div>:

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

En este caso el momento clave es el hecho de asignar al contenedor su identificador único (en el ejemplo es id="service_desk") que más adelante habrá que especificar en uno de los parámetros de abajo.

Parámetros

Los parámetros se especifican en la construcción "var tw_servicedesk_params={...}". Algunos de ellos hay que usar obligatoriamente:

url:'dirección del servidor TeamWox'

Aquí entre comillas se indica la dirección de sus servidor TeamWox, por ejemplo, 'team.yourdomian.com'.

sid:'identificador de usuario'

Se trata de uno de los campos más importantes. Influye en la delimitación de derechos de acceso de los usuarios del sitio a las incidencias creadas. Mediante una construcción especial en el valor de este campo se pone el identificador único para cada visitante del sitio web.

Para los usuarios registrados en el sitio web, como valor del campo se puede usar el MD5 de la palabra clave y del identificador de usuario en la página web.

Para los visitantes anónimos se puede usar el MD5 de cookies.

Si en el sitio web está prevista la división de usuarios por grupos, mediante la inserción del identificador del grupo en este campo Usted podrá organizar el trabajo común de los usuarios con las mismas incidencias. Si se establece el valor fijo de "sid", cualquier usuario verá todas las incidencias creadas.

En este campo habrá que poner el parámetro que es imposible averiguar. El uso de los identificadores simples es inadmisible y puede provocar el acceso no autorizado a las incidencias. Precisamente el valor de este campo determina la posibilidad de ver las incidencias para uno u otro usuario. Los ejemplos para cada uno de los casos arriba mencionados vienen en la sección especial.

container:'identificador del contenedor'

En este parámetro se indica el identificador del contenedor en el que va a mostrarse la interfaz de la parte pública del módulo "Service Desk".

user_name:'nombre del usuario'

Este parámetro debería ajustarse por el sitio web. Como su valor hay que especificar la construcción que coloca la información correspondiente sobre el usuario.

Los siguientes parámetros no son obligatorios:

user_email:'dirección de correo electrónico del usuario'

Correo electrónico del usuario.

En el sistema TeamWox funciona la vinculación automática de las incidencias a las organizaciones a través del correo electrónico.

user_company:'nombre de empresa del usuario'

Nombre de la empresa del usuario.

Las direcciones de correo electrónico y los nombres de las empresas también deben ser puestos por el sitio web. En sus valores tiene que escribir las construcciones que colocan la información correspondiente sobre el usuario.

incidents_per_page:número de incidencias en una página

Aquí se indica el número de incidencias a mostrar en una página. En caso de que falte este parámetro, va a utilizarse el valor predeterminado (10).

comments_per_page:número de comentarios en una página

En este parámetro se indica el número de comentarios sobre la incidencia que se muestran en una página. En caso de que falte este parámetro, va a utilizarse el valor predeterminado (10)

filter_groups:[lista de identificadores de grupos disponibles]

Aquí hay que especificar los identificadores de grupos (entre corchetes y separados por coma) que van a estar disponibles para la selección a la hora de crear incidencias por los usuarios. El identificador del grupo se especifica en la pestaña "Información" de la ventana de edición de sus parámetros.

Para que el grupo sea de acceso público, hay que activar la opción correspondiente en sus ajustes.

filter_categories:[lista de identificadores de categorías disponibles]

Aquí hay que especificar los identificadores de categorías (entre corchetes y separados por coma) creadas dentro de los grupos las que los usuarios van a utilizar para crear sus incidencias. El identificador del grupo se especifica en la pestaña "Categorías" de la ventana de edición de los parámetros del grupo.

filter_products:[lista de identificadores de productos disponibles]

Aquí hay que especificar los identificadores de productos (entre corchetes y separados por coma) creadas dentro de los grupos las que los usuarios van a utilizar para crear sus incidencias. El identificador del grupo se especifica en la pestaña "Productos" de la ventana de edición de los parámetros del grupo.

logo:'HTML código de la cabecera de la ventana'

Utilice este parámetro para cambiar la cabecera estándar de la ventana de incidencias por su cabecera personalizada. Para eso tiene que indicar su propio código HTML de cabecera en los parámetros. Los ejemplos más sencillos son:

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

Los ejemplos adicionales de realización del componente público del módulo "Service Desk" en "PHP" y ".NET" vienen en los apartados especiales. El ejemplo de la ventana en funcionamiento del componente público del módulo puede encontrar en la sección "Incidencias públicas".

En este momento la ventana de incidencias está disponible en dos idiomas (ruso e inglés) que se eligen de forma automática, dependiendo del idioma del sistema operativo del usuario. Las traducciones de la interfaz se guardan en el archivo "script.js". Si dispone de suficiente nivel de formación en este aspecto, puede añadir nuevas traducciones por su propia cuenta.