Pour créer rapidement et facilement un grand nombre d'itinéraires pour votre flotte, vous pouvez télécharger un fichier de valeurs séparées par des virgules (CSV). Pour obtenir des exemples de modèles, consultez les deux fichiers suivants : modèle pour les itinéraires utilisant le carnet d'adresses ou modèle pour les itinéraires utilisant des adresses brutes.
À un niveau élevé, chaque ligne du fichier représente un arrêt sur un itinéraire, plusieurs lignes représentant collectivement un itinéraire entier. Chaque itinéraire doit avoir au moins deux arrêts. Par conséquent, chaque itinéraire du fichier CSV doit comporter au moins deux lignes. La première ligne d'un itinéraire donné représente le lieu et l'heure de départ.
Pour plus d'informations sur l'ajout de routes en masse, consultez les rubriques suivantes :
-
Créez le fichier CSV dans le tableur de votre choix. Voir Règles de formatage CSV pour les itinéraires pour les exigences de formatage détaillées.
-
Dans le Samsara dashboard, sélectionner Expéditions (
) > Itinéraires.
-
Sélectionner Plus d'actions > Télécharger le fichier CSV.
-
Cliquez sur le lien pour Télécharger un fichier ou faites-le glisser et déposez-le dans la boîte de dialogue.
-
Cliquez sur Télécharger pour lancer le téléchargement du fichier.
Pour importer des itinéraires par lot, vous devez créer un fichier CSV qui respecte les consignes suivantes :
-
Le fichier peut contenir au maximum 1 000 lignes de données.
-
Tous les en-têtes de champ de la ligne 1 doivent rester intacts, même si vous choisissez de laisser cette entrée vide.
-
Chaque entrée doit avoir un nom d'itinéraire et un nom d'arrêt. Regroupez tous les arrêts d'un itinéraire en utilisant le même nom d'itinéraire pour chaque entrée.
-
Chaque itinéraire à Samsara doit avoir un lieu de départ et d'arrivée, ce qui signifie que deux arrêts sont nécessaires.
-
Samsara recommande d'utiliser un tableur pour modifier votre fichier CSV. Google Sheets et Excel sont deux excellentes options. Si vous utilisez un éditeur de texte, vous devez formater toutes les entrées qui contiennent des virgules entre guillemets (par exemple une adresse complète).
-
Les itinéraires peuvent être attribués à un véhicule ou à un conducteur, ou ils peuvent être laissés non attribués.
Pour les itinéraires attribués, saisissez le destinataire dans les champs Nom d'utilisateur du conducteur attribué et Nom du véhicule attribué. Les itinéraires ne peuvent pas être affectés aux deux, vous ne pouvez donc utiliser qu'une seule méthode d'affectation par itinéraire. Les cessionnaires doivent également correspondre aux noms dans le tableau de bord Samsara.
Pour les itinéraires non attribués, laissez les deux champs vides.
-
Toutes les valeurs de date et d'heure d'un fichier CSV doivent être au même format et basées sur le fuseau horaire défini dans Paramètres généraux pour le Samsara dashboard. Les paramètres de fuseau horaire local associés à l'utilisateur ne sont pas respectés. Par exemple, si le fuseau horaire du tableau de bord est défini sur l'heure de l'Est, que l'utilisateur est à l'heure normale du Pacifique et que l'heure d'un arrêt est définie sur 14 h 00 dans le fichier CSV, l'arrêt sera programmé à 14 h 00, heure de l'Est.
-
Vous pouvez télécharger des itinéraires planifiés loin dans le futur, mais le Samsara dashboard n'affichera que les 30 prochains jours d'itinéraires programmés. Si un fichier est téléchargé avec succès, cela signifie que votre itinéraire a été créé. Lorsque la date prévue est dans les 30 jours, vous pourrez la visualiser sur le tableau de bord.
Le tableau suivant décrit les champs CSV que vous pouvez utiliser pour définir des routes :
|
Champ |
Description |
Exemple |
|---|---|---|
|
Route Name (Nom de la route) |
Nom descriptif pour identifier l'itinéraire. Regroupez les entrées d'arrêt associées dans un itinéraire à l'aide d'un nom d'itinéraire cohérent. |
Livraisons de crème glacée |
|
Assigned Driver Username (Nom d'utilisateur attribué au conducteur) (Facultatif) |
Pour affecter un conducteur à un itinéraire, le nom d'utilisateur du conducteur doit déjà être défini dans Samsara et vous devez copier le nom d'utilisateur exactement. Laissez ce champ vide si vous souhaitez plutôt utiliser un Nom du véhicule attribué ou pour importer l'itinéraire comme non attribué. |
conducteur_a |
|
Assigned Vehicle Name (Nom du véhicule attribué) (Facultatif) |
Pour affecter un véhicule à un itinéraire, le nom du véhicule doit déjà être défini dans Samsara et vous devez copier le nom exactement. Laissez ce champ vide si vous souhaitez plutôt utiliser un Nom du conducteur attribué ou pour importer l'itinéraire comme non attribué. |
Semi1 |
|
Stop Name (Nom de l’arrêt) (Requis) |
Nom descriptif pour identifier l’arrêt. Ce champ doit être rempli pour chaque emplacement de l'itinéraire, y compris l'emplacement de départ. Tous les itinéraires doivent avoir un minimum de deux arrêts. Par conséquent, vous devez avoir au moins deux noms d'arrêt. Pour chaque arrêt supplémentaire sur l'itinéraire, un autre nom d'arrêt est requis. |
Bi-rite |
|
Stop Arrival Time (Heure d'arrivée à l'arrêt) (Facultatif pour le premier arrêt ; obligatoire pour plus de 2 arrêts) |
Ce champ représente l'heure d'arrivée prévue pour que le conducteur arrive à un arrêt ou à une destination. Les fuseaux horaires sont relatifs au fuseau horaire défini dans Paramètres généraux de le Samsara dashboard. Si vous pensez que le conducteur se trouve déjà au premier emplacement lorsque l'itinéraire commence, vous pouvez laisser l'heure d'arrivée de l'arrêt vide pour la première ligne. Si vous prévoyez de suivre l'heure d'arrivée au premier arrêt, vous pouvez compléter l'heure d'arrivée à l'arrêt. Ce champ doit être rempli pour tous les autres arrêts. |
|
|
Stop Departure Time (Heure de départ de l'arrêt) (Requis pour le premier arrêt si Heure d'arrivée à l'arrêt est vide ; Facultatif pour 2+ arrêts) |
Ce champ représente l'heure de départ prévue ou l'heure prévue pour que le conducteur quitte le point de départ. Les fuseaux horaires sont relatifs au fuseau horaire défini dans Paramètres généraux de le Samsara dashboard. Ce champ est facultatif pour tous les autres arrêts. |
|
|
Stop Notes (Notes d'arrêt) (Facultatif) |
Identifie toutes les notes que vous souhaitez inclure à propos de l'arrêt. Les notes ajoutées aux arrêts de l'itinéraire sont visibles pour les conducteurs dans le Samsara Application du conducteur sous l'arrêt respectif. La vue d'itinéraire pour les administrateurs de flotte n'inclut pas les notes du conducteur. |
Livrer 5 caisses |
|
Nom de l'adresse (Obligatoire si Latitude, Longitude, et Adresse complète ne sont pas spécifiés) |
Nom de l'emplacement de l'adresse dans le carnet d'adresses. Si un Nom de l'adresse est spécifié, l'arrêt de l'itinéraire sera créé à l'aide de le périmètre de géorepérage de l'entrée du carnet d'adresses portant le même nom. Le nom doit être une correspondance exacte. Les noms sont également sensibles à la casse et à l'espace. Inclure tous les espaces s'ils sont présents au début ou à la fin d'un nom. Si vous ne spécifiez pas de l'entrée Carnet d'adresses avec le champ Nom de l'adresse, vous pouvez laisser ce champ vide et spécifier à la place la Latitude, Longitude, et Adresse complète. |
Bi-Rite |
|
Latitude (Obligatoire si Nom de l'adresse n'est pas spécifié) |
Les champs Latitude, Longitude, et Adresse complète peuvent être utilisés ensemble pour créer un arrêt d'itinéraire au lieu d'utiliser une entrée Carnet d'adresses. |
36.24491 |
|
Longitude (Obligatoire si Nom de l'adresse n'est pas spécifié) |
Les champs Latitude, Longitude, et Adresse complète peuvent être utilisés ensemble pour créer un arrêt d'itinéraire au lieu d'utiliser une entrée Carnet d'adresses. |
-79.98793 |
|
Adresse complète (Obligatoire si Nom de l'adresse n'est pas spécifié) |
Les champs Latitude, Longitude, et Adresse complète peuvent être utilisés ensemble pour créer un arrêt d'itinéraire au lieu d'utiliser une entrée Carnet d'adresses. |
8632 US Highway 158, Stokesdale, Caroline du Nord 27357 |
Pour vous aider à démarrer, vous pouvez afficher deux exemples de modèles. Le premier modèle représente la création des itinéraires à l'aide du carnet d'adresses. Le deuxième modèle représente la création des itinéraires utilisant des adresses brutes (Latitude, Longitude, Adresse complète). Il est également possible de mélanger et de faire correspondre ces deux méthodes dans un seul fichier (certaines lignes utilisant le carnet d'adresses et d'autres lignes utilisant des adresses brutes).
Reportez-vous au tableau suivant pour les problèmes courants que vous pouvez rencontrer lorsque vous essayez de télécharger des itinéraires en masse.
|
Problème |
Description |
|---|---|
|
Le nom de l'itinéraire ne correspond pas |
Chaque itinéraire doit avoir au moins deux arrêts (début et fin) avec le même nom d'itinéraire. Assurez-vous que chaque arrêt a un nom d'itinéraire qui correspond à au moins une entrée avant ou après lui. |
|
Le nom d'utilisateur du conducteur ou le nom du véhicule ne correspondent pas |
Pour les affectations de conducteur et de véhicule, vous devez entrer une correspondance exacte avec le nom spécifié dans le Samsara dashboard. Pour éviter les fautes de frappe, pensez à télécharger votre liste de conducteurs ou de véhicules pour copier et coller les noms exacts dans votre fichier d'itinéraires. |
|
Plusieurs conducteurs ou véhicules répertoriés dans un même itinéraire |
Vous pouvez attribuer un itinéraire à un conducteur ou à un seul véhicule. Tenter d'attribuer des portions d'un itinéraire à plusieurs conducteurs entraînera un échec du téléchargement. |
|
Les heures d'arrivée et de départ des arrêts ne sont pas dans l'ordre chronologique |
Assurez-vous que les arrêts de votre itinéraire sont programmés dans l'ordre chronologique. Tenter de programmer tous les arrêts à la même heure ou programmer un arrêt pour qu'il parte après l'arrivée prévue du prochain arrêt entraînera un échec du téléchargement. |
|
Le nom de l'adresse ne correspond pas à une entrée du carnet d'adresses |
Assurez-vous que votre nom d'adresse correspond exactement à une entrée dans le Samsara dashboard. Les adresses sont sensibles à la casse et à l'espace. Envisagez de télécharger votre carnet d'adresses pour copier et coller le nom d'adresse exact dans votre fichier d'itinéraires. |
|
Mélanger le nom de l'adresse avec la latitude, la longitude ou l'adresse complète |
Assurez-vous de ne choisir qu'une seule méthode pour spécifier une adresse :
La méthode que vous ne choisissez pas doit être laissée vide. Étant donné qu'il s'agit de deux méthodes distinctes pour spécifier les informations d'adresse pour votre arrêt d'itinéraire, elles ne sont jamais destinées à être mélangées et peuvent entraîner un échec du téléchargement. |
|
En-têtes supprimés ou modifiés |
La première ligne du fichier CSV identifie les en-têtes correspondant aux champs du Samsara dashboard. Ces entrées sont obligatoires et doivent être incluses exactement comme indiqué. La modification ou la suppression de l'une des valeurs de la première ligne entraînera une erreur. |
|
Données masquées dans des champs ou des entrées supplémentaires |
Dans certains cas, si vous réutilisez un ancien modèle avec des lignes supplémentaires en bas et que vous ne supprimez pas correctement les anciennes informations, vous pouvez accidentellement télécharger des informations d'itinéraire incomplètes. Pour éviter ce type d'erreur, commencez toujours par un nouveau fichier CSV ou copiez uniquement exactement les colonnes A à K de la ligne 1 dans un nouveau fichier CSV. Si vous avez déjà formaté votre itinéraire et pensez que vous n'avez commis aucune autre des erreurs ci-dessus, copiez et collez simplement les colonnes A à K de toutes les lignes que vous souhaitez conserver et collez-les dans un nouveau CSV. S'il y avait des entrées cachées dans l'ancien fichier, cela les supprimerait. |
Pour isoler un problème de création de route, utilisez le workflow suivant :
-
Commencez avec une seule route dans un fichier.
Si votre fichier échoue pour des raisons inconnues, essayez de télécharger uniquement le premier itinéraire pour voir s'il sera téléchargé. Il est plus facile de diagnostiquer d'abord un problème dans une route et de déterminer si ce même problème peut exister pour toutes les autres routes.
-
Divisez vos itinéraires en segments plus petits pour les tests.
Si la première route est téléchargée avec succès, essayez de diviser le CSV à peu près en deux pour voir si une moitié des routes se télécharge avec succès et l'autre moitié échoue. Cela peut vous aider à déterminer si vous avez commis des erreurs à plusieurs endroits ou s'il est plus probable qu'un ou deux itinéraires seulement soient à l'origine du problème. Diviser à nouveau. Si la moitié de vos routes échoue, divisez à nouveau ce fichier en deux ou en plus petits morceaux pour voir si vous pouvez réduire le problème à une ou deux routes seulement.
-
Passez en revue toutes les erreurs mentionnées dans le message d'erreur.
Le téléchargement d'un seul itinéraire est plus susceptible d'identifier un message d'erreur clair, car le fait d'avoir plusieurs itinéraires peut entraîner plus d'un type d'erreur.
Les noms de ligne fournis dans le message d'erreur n'incluent pas la ligne d'en-tête, de sorte que le numéro de ligne sera décalé de un. Par exemple, si le message d'erreur indique la ligne 5, examinez la ligne 6 de votre fichier CSV.
-
Laissez les champs optionnels vides.
Lorsque vous testez votre premier itinéraire, supprimez toutes les valeurs facultatives de votre itinéraire et laissez-les vides pour vérifier que le fichier peut être téléchargé sans les informations facultatives. Cela peut être un test rapide pour affiner les champs les plus susceptibles d'avoir des erreurs.
-
Vérifiez les fautes de frappe ou les données manquantes.
Étant donné que vous devez spécifier des correspondances exactes pour les noms d'utilisateur du conducteur, les noms de véhicule et les noms d'adresse, vous pouvez télécharger les fichiers CSV pour chacun d'entre eux, puis copier les deux colonnes correspondantes dans une nouvelle feuille et utiliser Excel pour rechercher les doublons dans les deux colonnes. Pour un téléchargement réussi, chaque nom d'utilisateur de conducteur, nom de véhicule et nom d'adresse de votre itinéraire doit être marqué comme un doublon. Si certains ne sont pas marqués comme doublons, vous pouvez déterminer si cela est dû à des informations manquantes sur le tableau de bord ou à une faute de frappe.
-
Si vous avez encore besoin d'aide, Contactez le support et fournissez votre fichier CSV.
