Aller au contenu

Graphiques du portail

Les utilisateurs externes, comme le personnel d’un client ou d’un transporteur routier, se connectent au portail. Sa page d’accueil peut afficher des graphiques, par exemple le nombre d’ordres de travail créés chaque mois. La page Portal Charts configure ces graphiques et détermine les rôles du portail qui voient chacun d’eux.

Pour l’ouvrir, sélectionnez Admin > Portal Charts.

Chaque graphique ne compte que les enregistrements des sociétés auxquelles l’utilisateur qui le consulte est lié : le même graphique montre donc à chaque utilisateur ses propres chiffres.

Un utilisateur externe voit un graphique sur la page d’accueil du portail lorsque toutes ces conditions sont remplies :

  • le graphique n’est pas désactivé ;
  • le graphique est attribué au rôle du portail de l’utilisateur sur cette page (voir Attribuer des rôles) ;
  • ce rôle a View Dashboard dans la section Dashboard du groupe Portal, dans Gestion des rôles. Cette page appelle cette autorisation Charts (Read) ;
  • l’utilisateur est lié à au moins une entité de la façon dont le graphique compte : en tant que Customer pour Work Order Volume et Job Volume, en tant que Transporter pour Work Orders Hauled. Voir l’onglet Linked Entities.

Le rôle du portail de l’utilisateur est défini sur sa fiche : voir Roles ou Portal Role.

Sur la page d’accueil du portail, les graphiques apparaissent sous les encadrés du haut, le plus petit numéro Order en premier, deux côte à côte sur un écran large. Chaque graphique affiche son titre, sa description et le graphique lui-même : une courbe, des colonnes, ou un graphique en secteurs dessiné en anneau. Il comporte un point par mois pour les mois définis dans Period (months), jusqu’au mois dernier ; le mois en cours n’est pas inclus.

Les décomptes excluent les ordres de travail annulés. Ils respectent aussi les filtres personnalisés qui limitent les ordres de travail que voit l’utilisateur (voir User Level Filters).

La page liste les graphiques dans l’ordre de leur numéro Order :

Colonne Affiche
Order La position du graphique sur la page d’accueil du portail.
Title Le titre, avec la description en dessous.
Shows Ce que compte le graphique, et la période, par exemple Work Order Volume - last 24 months. Un type de graphique que TrakIT ne sait pas dessiner est affiché en rouge avec (unknown) : un tel graphique n’est jamais affiché.
Type Line, Column ou Pie.
Roles Les rôles du portail auxquels le graphique est attribué, ou None - nobody sees it.
Status Active, Disabled, ou Not shown pour un graphique d’un type que TrakIT ne sait pas dessiner.
Updated Le moment du dernier enregistrement du graphique, en UTC, et l’identifiant utilisateur de la personne qui l’a enregistré.

Les icônes au bout de chaque ligne sont le crayon (Edit), l’icône de personnes (Roles) et la corbeille (Delete). Seuls les administrateurs système voient le crayon, la corbeille et Add Chart : les autres utilisateurs voient Only a SysAdmin can add, change or delete portal charts. en haut de la page.

  1. Sélectionnez Add Chart.
  2. Dans New Portal Chart, saisissez un Title et choisissez ce que le graphique affiche dans Shows.
  3. Remplissez les autres champs du graphique dont vous avez besoin.
  4. Sélectionnez Save.

TrakIT indique Chart saved et ouvre la fenêtre contextuelle Roles du nouveau graphique, car personne ne voit un graphique tant qu’il n’est pas attribué à un rôle. Attribuez les rôles qui doivent le voir.

Un nouveau graphique commence comme une courbe sur 24 mois, avec un numéro Order placé après celui du dernier graphique.

Champ Ce qu’il faut saisir
Title Le titre affiché au-dessus du graphique sur le portail, 60 caractères au maximum. Obligatoire. Deux graphiques ne peuvent pas avoir le même titre.
Shows Ce que compte le graphique : voir Ce qu’un graphique peut afficher. Obligatoire. Sous les champs, une ligne décrit le choix.
Description Facultatif, 200 caractères au maximum : une ligne sous le titre sur le portail.
Period (months) Le nombre de mois passés que couvre le graphique, de 1 à 36. Le mois en cours n’est pas inclus.
Chart Type Line, Column ou Pie.
Order Un nombre de 0 à 9 999. Les graphiques sont affichés par numéro croissant.
Default Size Small, Medium ou Large. La page d’accueil du portail affiche actuellement chaque graphique sur une demi-largeur.
Status Cochez Disabled (hidden from everyone) pour masquer le graphique sans le supprimer.
Chart Options (JSON) Facultatif, 2 000 caractères au maximum : des options d’affichage du graphique, sous forme d’objet JSON, appliquées par-dessus le style propre au portail. Par exemple, {"plugins":{"legend":{"display":true}}} affiche la légende. Laissez ce champ vide pour l’apparence par défaut.

Le titre et la description ne peuvent pas commencer par =, + ou @, ni contenir de balises HTML.

Shows Compte Affiché aux utilisateurs liés en tant que
Work Order Volume Les ordres de travail créés chaque mois, sur les dossiers dont les sociétés de l’utilisateur sont le client. Customer
Job Volume Les dossiers créés chaque mois dont les sociétés de l’utilisateur sont le client. Le mois d’un dossier est le mois de création de son premier ordre de travail. Customer
Work Orders Hauled Les ordres de travail créés chaque mois dont les sociétés de l’utilisateur sont le transporteur routier, à l’aller ou au retour. Transporter

Un utilisateur lié des deux façons voit les graphiques des deux types.

Pour modifier un graphique :

  1. Sélectionnez l’icône de crayon (Edit) sur sa ligne.
  2. Dans Edit Portal Chart, modifiez les champs.
  3. Sélectionnez Save. TrakIT indique Chart saved.

Pour masquer un graphique à tous en conservant sa configuration et ses rôles, modifiez-le et cochez Disabled (hidden from everyone).

Pour supprimer un graphique :

  1. Sélectionnez l’icône de corbeille (Delete) sur sa ligne.
  2. Dans Delete Portal Chart, lisez le message. Si le graphique est attribué à des rôles, il indique combien : ces rôles perdent le graphique immédiatement.
  3. Confirmez. TrakIT indique Chart deleted.
Message Que faire
A title is required Saisissez un Title.
Choose what the chart shows Choisissez une option dans Shows.
Another chart is already called suivi du titre Choisissez un autre titre.
The title or description contains characters that are not allowed Retirez la balise HTML, ou le =, le + ou le @ du début.
The chart options must be a JSON object suivi d’un exemple, ou The chart options are not valid JSON Corrigez Chart Options (JSON), ou videz ce champ.
The period must be between 1 and 36 months Corrigez Period (months).
The order must be between 0 and 9999 Corrigez Order.

Sélectionnez l’icône de personnes (Roles) sur la ligne d’un graphique. La fenêtre contextuelle Roles liste les rôles du portail auxquels le graphique est attribué :

Colonne Affiche
Role Le rôle du portail.
Users Le nombre d’utilisateurs qui ont ce rôle.
Can See Charts Yes si le rôle a l’autorisation de voir les graphiques, ou No - needs Charts (Read). Un rôle sans cette autorisation ne voit pas le graphique, même s’il lui est attribué. Donnez au rôle View Dashboard dans la section Dashboard dans Gestion des rôles.

Pour attribuer un rôle :

  1. Choisissez le rôle dans – Select an external role –. La liste propose les rôles du portail que le graphique n’a pas encore, chacun avec son nombre d’utilisateurs.
  2. Sélectionnez Assign.

TrakIT indique que le rôle peut désormais voir le graphique. Si le rôle n’a pas l’autorisation, TrakIT indique aussi que ses utilisateurs ne verront pas les graphiques tant qu’elle n’aura pas été accordée dans la gestion des rôles. Every external role already has this chart. signifie qu’il ne reste aucun rôle à attribuer.

Pour retirer un graphique à un rôle, sélectionnez la croix (Remove) sur la ligne du rôle. Il n’y a pas de confirmation : TrakIT indique que le rôle ne voit plus le graphique. Pour annuler, attribuez de nouveau le rôle.

Seuls les rôles du portail peuvent recevoir un graphique. Seuls les administrateurs système peuvent attribuer et retirer des rôles ; les autres utilisateurs peuvent ouvrir la fenêtre contextuelle pour les voir. Sélectionnez Close pour la fermer.

Pour ouvrir la page, votre rôle doit avoir Create dans la section Charts, du groupe System de la gestion des rôles. Avec cette autorisation, vous voyez les graphiques et leurs rôles. Sans elle, TrakIT indique You do not have the permission to manage portal charts. Les utilisateurs externes ne peuvent pas ouvrir la page.

Seuls les administrateurs système peuvent ajouter, modifier, désactiver et supprimer des graphiques, et attribuer ou retirer des rôles. La page vérifie que vous en êtes un, plutôt qu’une autorisation de vos rôles.