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.

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:

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:

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:

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

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.

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.

user_company:'nombre de empresa del usuario'

Nombre de la empresa del 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:

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