Exports CSV

Ce que fait un export CSV

Un export CSV enregistre une vue du portail dans un fichier. Deux vues ont un export : la liste du parc, et les groupes de tags du tableau de bord. Le fichier porte exactement les lignes de la vue, avec les mêmes filtres.

Utilisez un export pour un inventaire, un rapport client, ou un calcul dans un tableur. Le fichier est une photo de la vue au moment du clic. Il ne se met pas à jour tout seul.

Prérequis

• Le rôle Lecture seule, Technicien, Administrateur ou Administrateur plateforme. Voir Rôles et droits.
• Pour l'export des groupes de tags : au moins une clé de tag dans votre MSP. Voir Tags et actions sur une sélection.

Exporter la liste du parc

1. Dans le menu principal, cliquez Parc.
2. Réduisez la liste : choisissez un nœud de l'arbre, ou posez des filtres. Voir Parc et arborescence.
3. À droite de la barre des filtres, cliquez Exporter en CSV.
4. Attendez. Le bouton écrit Export en cours… pendant la préparation du fichier.
5. Enregistrez le fichier endpoints-<date>.csv que le navigateur propose.

L'export reprend le périmètre de la page, c'est-à-dire le nœud de l'arbre et tous les filtres actifs : le client, le type, le statut, la version, le mode de démarrage, la recherche par nom, la case Problèmes seulement, le filtre Version trop ancienne seulement et les filtres de tag. Les lignes gardent l'ordre de la liste : les endpoints avec un problème d'abord, puis par nom.

Le fichier porte toute la vue, pas seulement les lignes déjà affichées. Vous n'avez pas besoin de cliquer Voir plus avant l'export.

Exporter les groupes de tags du tableau de bord

1. Dans le menu principal, cliquez Tableau de bord.
2. Dans la liste Grouper par, choisissez une clé de tag. Voir Tableau de bord et problèmes.
3. Posez un périmètre si besoin : un nœud de l'arbre, ou un filtre par tag.
4. À droite du titre Par <clé>, cliquez Exporter en CSV.
5. Enregistrez le fichier tag-groups-<date>.csv que le navigateur propose.

Le fichier porte une ligne par valeur de la clé, dans l'ordre du tableau. La dernière ligne porte les endpoints qui n'ont pas la clé. Sa colonne value est vide.

Le bouton Exporter en CSV n'apparaît pas quand l'adresse de la page demande une clé que votre MSP n'a pas. Le portail écrit alors « Votre MSP n'a pas de clé de tag « site ». Choisissez une clé dans « Grouper par ». »

Le fichier

Élément	Valeur
Format	CSV (RFC 4180) : séparateur « , », fin de ligne CRLF, une ligne d'en-tête.
Encodage	UTF-8 avec marque d'ordre des octets (BOM). Un tableur lit ainsi les accents.
Nom du fichier	endpoints-<date UTC>.csv ou tag-groups-<date UTC>.csv.
Noms des colonnes	Les noms des champs de l'API, en anglais. Ils ne changent pas avec la langue du portail.
Dates	ISO 8601, en UTC.
Cellule vide	Pas de valeur.

Une cellule qui contient « " », « , », un retour chariot ou un saut de ligne est entre guillemets doubles.

Une cellule de texte qui commence par =, +, -, @, une tabulation ou un retour chariot reçoit une apostrophe en tête. Un tableur affiche alors le texte, et il ne le calcule pas comme une formule. Les noms d'endpoint et les valeurs de tag sont du texte libre : cette apostrophe les protège.

Colonnes de l'export du parc

Colonne	Ce qu'elle donne
client	Le nom du client de l'endpoint.
client_id	L'identifiant du client.
endpoint_id	L'identifiant de l'endpoint.
name	Le nom de la machine à son enrôlement, ou le domaine du tenant Microsoft 365. Il ne change jamais.
type	agent pour une machine, m365 pour un tenant Microsoft 365.
agent_status	online ou offline.
hostname	Le nom d'hôte que l'agent annonce.
os	Le système de la machine.
version	La version de l'agent.
last_backup_status	L'état de la dernière sauvegarde de fichiers.
last_backup_ended_at	La fin de cette sauvegarde.
last_baremetal_backup_status	L'état de la dernière sauvegarde d'image.
last_baremetal_backup_ended_at	La fin de cette sauvegarde d'image.
created_at	La date d'entrée de l'endpoint dans la plateforme.
display_name	Le nom donné par un opérateur. Vide quand l'endpoint n'en a pas.
tag:<clé>	Une colonne par clé de tag de votre MSP, dans l'ordre des clés. La cellule porte la valeur de l'endpoint, ou rien.

Les colonnes agent_status, hostname, os, version, last_backup_status, last_backup_ended_at, last_baremetal_backup_status et last_baremetal_backup_ended_at ne valent que pour une machine avec un agent. Elles sont vides pour un tenant Microsoft 365.

Les colonnes de tag portent toutes les clés de votre MSP, même les clés absentes de la vue. Un fichier a donc toujours les mêmes colonnes pour un même MSP.

Colonnes de l'export des groupes de tags

Colonne	Ce qu'elle donne
key	La clé de tag du groupe.
value	La valeur de la clé. Vide sur la dernière ligne : les endpoints sans la clé.
endpoints	Le nombre d'endpoints du groupe.
agent_online	Les agents en ligne.
agent_offline	Les agents hors ligne.
m365	Les tenants Microsoft 365.
problem_endpoints_7d	Les endpoints qui ont au moins un problème en cours sur 7 jours.
problem_jobs_7d	Les tâches en problème en cours sur 7 jours.
jobs_30d	Les tâches sur 30 jours.
succeeded_30d	Les tâches réussies sur 30 jours.
partial_30d	Les tâches partielles sur 30 jours.
failed_30d	Les tâches en échec sur 30 jours.
interrupted_30d	Les tâches interrompues sur 30 jours.
missed_30d	Les tâches manquées sur 30 jours.
success_rate_30d	Le taux de réussite sur 30 jours, de 0 à 1, avec 4 décimales. Vide sans aucune tâche.
stale_endpoints_7d	Les agents sans sauvegarde réussie depuis 7 jours.
stored_bytes	Les octets stockés du groupe.

Les chiffres sont les mêmes que ceux du tableau de bord avec le même périmètre. Voir Tableau de bord et problèmes.

Limites et précautions

• Un export du parc porte 10 000 lignes au plus. Au-delà, le portail écrit « L'export a trop de lignes. Ajoutez un filtre. » sous le bouton. Réduisez alors la vue : choisissez un nœud de l'arbre, ou ajoutez un filtre.
• Le message d'erreur reste sous le bouton jusqu'au prochain essai. Aucun fichier n'arrive dans vos téléchargements quand l'export échoue.
• Seules ces deux vues ont un export CSV. La liste des tâches, le journal d'audit et les alertes n'en ont pas.
• Un export ne porte jamais les données d'un autre MSP : ni ses endpoints, ni ses tags, ni ses clés de tag.
• Un export ne porte aucun nom de fichier sauvegardé et aucun contenu de sauvegarde. Il décrit le parc, pas les données protégées.
• Le fichier porte des noms de client, des noms de machine et des noms d'hôte. Traitez-le comme une donnée interne de votre MSP.
• Les noms des colonnes restent en anglais. Un tableur ou un script qui lit le fichier n'a donc pas à suivre la langue du portail.
• Un export est une photo. Deux exports faits à deux moments ne donnent pas les mêmes chiffres.
• Un endpoint dont la suppression est demandée reste dans la liste, et donc dans l'export, jusqu'à la fin du délai. Voir Supprimer un endpoint ou un client.
• Aucun outil MCP ne produit un export CSV. Un assistant IA lit la liste et les chiffres, mais il ne crée pas de fichier.

Référence

• API : Export endpoints, route GET /endpoints/export, avec les mêmes paramètres que GET /endpoints.
• API : Export dashboard tag groups, route GET /dashboard/tag-groups/export.
• Les deux routes acceptent une clé API de MSP avec la portée read. Un script peut donc récupérer le même fichier.