Aller au contenu

Widget de suivi

Le widget de suivi est une petite page publique qui permet de suivre un dossier sans se connecter. Vous tapez la référence du dossier, par exemple un numéro de connaissement, et la page liste les ordres de travail du dossier, chacun avec son conteneur, sa taille, son poids, sa marchandise et son dernier événement. Un dossier est une expédition ou une mission prise en charge par la société, et chacun de ses conteneurs ou chargements est un ordre de travail.

L’adresse de la page est l’adresse TrakIT de la société suivie de /ext/external.aspx, par exemple https://trakit.example.com/ext/external.aspx. La société peut créer un lien vers cette page, ou l’afficher dans son propre site web ou dans celui d’un client : voir Intégrer le widget dans un site web.

  1. Ouvrez la page.
  2. Dans la case, tapez la référence du dossier. Le libellé de la case est le nom que la société donne à la référence du dossier, par défaut Transport Document:.
  3. Appuyez sur Entrée, ou sélectionnez Search.

Please wait… s’affiche pendant la recherche, puis les résultats apparaissent.

  • Tapez la référence du dossier en entier, telle que la société l’a écrite. Les majuscules n’ont pas d’importance, mais une partie de la référence ne trouve rien.
  • Seule la référence du dossier est recherchée : un numéro de conteneur ne trouve rien.
  • Tapez la référence sans espaces. Elle doit comporter de 4 à 40 caractères, uniquement des lettres, des chiffres, /, - et _ ; pour toute autre recherche, la page indique ce qui ne va pas (voir les messages).

La liste affiche les ordres de travail du dossier, dans l’ordre de leurs ID, quel que soit leur statut : les ordres de travail clôturés et annulés sont inclus. Elle affiche au plus 100 ordres de travail.

Colonne Affiche
Work Order ID Le numéro de l’ordre de travail dans TrakIT.
Workflow Le workflow du dossier : le type de service, tel que la société le nomme.
Container/Manifest Le numéro du conteneur ou, pour un chargement sans conteneur, son ID de chargement.
Size La longueur du conteneur en pieds, par exemple 20 ou 40. - s’il n’y en a pas.
Weight Le poids, en kilogrammes. - s’il n’y en a pas.
Commodity La marchandise.
Last Event Le dernier événement de l’ordre de travail que la société montre à ses clients, sous le nom qu’elle leur donne, avec son heure et sa date en dessous, par exemple 14:20, 19 Oct. L’heure est en UTC. Vide s’il n’y a pas encore de tel événement.

Sur un téléphone, Workflow, Size, Weight et Commodity sont masquées ; sur une tablette, Workflow et Commodity.

Message Signification
Please specify search text La case est vide. Tapez la référence du dossier.
Enter at least 4 characters La référence a moins de 4 caractères. Tapez la référence en entier.
Number is too long La référence a plus de 40 caractères.
Invalid number specified La référence contient un caractère autre que des lettres, des chiffres, /, - et _, comme une espace.
Too many requests. Please wait a moment and try again. Trop de recherches sont venues de votre adresse réseau : voir Limites. Attendez une minute, puis recherchez de nouveau.
— No Jobs Found — Aucun dossier n’a cette référence. Vérifiez-la, et voyez Rechercher un dossier pour savoir ce que la page peut trouver.
— An error occurred — La page n’a pas pu joindre TrakIT, ou TrakIT n’a pas pu répondre. Réessayez plus tard.

Ajoutez ?q= et une référence du dossier à l’adresse pour ouvrir la page sur ce dossier :

https://trakit.example.com/ext/external.aspx?q=EXL-2610-0042

La page remplit la case et lance la recherche immédiatement. Utilisez un tel lien dans un e-mail, sur le propre portail d’un client ou dans un code QR.

Cette page peut être affichée à l’intérieur d’une page d’un autre site web, dans un cadre, ce que le portail ne permet pas. Par exemple :

<iframe src="https://trakit.example.com/ext/external.aspx"
title="Track your shipment" width="100%" height="400"></iframe>

Ajoutez ?q= et une référence du dossier à l’adresse de src pour afficher un seul dossier, comme dans Ouvrir le widget sur un dossier. Remplacez trakit.example.com par l’adresse TrakIT de la société.

Le widget a sa propre présentation simple, qui ne peut pas être modifiée. Pour une page de suivi avec votre propre présentation, le serveur de votre site web peut obtenir les mêmes détails avec l’API GetShipment, au moyen d’une clé d’API configurée par le support TrakIT. Appelez-la depuis le serveur, jamais depuis le navigateur du visiteur, où n’importe qui pourrait lire la clé.

  • Tout le monde peut rechercher un dossier. La page ne demande aucune connexion : toute personne qui a une référence du dossier peut voir les ordres de travail de ce dossier, avec leurs conteneurs, leurs poids, leurs marchandises et leurs derniers événements. Pour ne montrer à un client que ses propres enregistrements, utilisez le portail externe, ou un lien de partage Entity Tracking.
  • Les recherches sont limitées. Pour que la page ne puisse pas servir à rechercher des références de dossiers en masse, TrakIT répond au plus à 20 recherches par minute depuis une même adresse réseau, comptées avec les pages des liens de partage. Au-delà de la limite, la page affiche Too many requests. Please wait a moment and try again. L’adresse peut de nouveau rechercher au plus une minute après la première de ces 20 recherches.
  • Un dossier à la fois, par sa référence complète, avec jusqu’à 100 ordres de travail.

Tout le monde, sans connexion. Rien n’est à configurer : la page fait partie de chaque installation TrakIT. Le libellé de la case de recherche est le nom que la société donne à la référence du dossier, défini par le support TrakIT.