Comment lire les exportations des données Slack
Lorsque vous aurez exporté les données de votre espace de travail, vous pourrez télécharger un fichier ZIP pour accéder à l’historique des messages et aux liens de fichiers.
Formats d’exportation
Votre format d’exportation dépend du type d’exportation que vous effectuez :
- Canaux publics uniquement : les données seront exportées au format JSON.
- Ensemble des canaux et conversations : les données seront exportées au format JSON.
- Canaux et conversations d’un utilisateur : les données seront exportées soit au format JSON, soit au format TXT.
Ce que contient votre fichier d’exportation
Fichiers JSON
Fichiers TXT
Une fois votre exportation terminée, vous téléchargerez un fichier ZIP contenant les données de votre espace de travail et une série de liens de fichiers renvoyant vers les fichiers de votre espace de travail. En fonction du type d’exportation effectué, voici ce que votre fichier ZIP inclura :
Canaux publics uniquement | Ensemble des canaux et conversations | |
Canaux (channels.json) |
✓ |
✓ |
Messages directs (dms.json) |
✓ |
|
Canaux privés (groups.json) |
✓ |
|
Journaux d’activité des applications (integration_logs.json) |
✓ |
✓ |
Messages directs de groupe (mpims.json) |
✓ |
|
Membres (users.json)* |
✓ |
✓ |
Dossiers pour chaque canal public |
✓ |
✓ |
Dossiers pour chaque canal privé |
|
✓ |
Dossiers pour chaque message direct |
|
✓ |
* Si vous exportez des données à partir d’une organisation Enterprise Grid, ce dossier sera nommé org_users.json.
Conseil : Avec le forfait Enterprise Grid, vous pouvez choisir d’exporter des données pour l’ensemble de votre organisation ou pour un espace de travail spécifique. Les exportations pour un espace de travail spécifique comprennent les canaux publics et privés de l’espace de travail sélectionné, mais pas les canaux sur plusieurs espaces de travail.
Si vous choisissez d’exporter les données des conversations d’un utilisateur au format TXT, vous téléchargerez un fichier ZIP avec tous les messages et fichiers envoyés par l’utilisateur que vous avez sélectionné une fois votre exportation terminée. Votre fichier ZIP contiendra trois dossiers :
- canaux
- messages directs
- fichiers
Chaque dossier contiendra plusieurs fichiers TXT qui contiennent quant à eux l’historique d’une conversation ou des fichiers envoyés par un seul utilisateur dans la plage de dates que vous avez sélectionnée.
Remarque : si vous appliquez une plage de dates à une exportation, Slack renverra toutes les conversations auxquelles l’utilisateur a participé, même si aucun message n’a été envoyé dans cette conversation aux dates indiquées. Auquel cas, le canal n’affichera aucun message dans le fichier d’exportation.
Parcourir votre fichier d’exportation
Fichiers JSON
Fichiers TXT
Lorsque vous ouvrirez votre fichier ZIP d’exportation, chaque canal ou message direct aura son propre dossier. Dans chacun des dossiers, les messages de la conversation apparaîtront dans des fichiers JSON séparés, classés par date.
Des fichiers de référence seront disponibles pour différents types de conversations : des fichiers channels.json pour les canaux publics, des fichiers groups.json pour les canaux privés et des fichiers dms.json pour les messages directs. Ils contiendront les identifiants de l’utilisateur et du canal. Pour rechercher une conversation spécifique, il vous faudra utiliser le canal et les fichiers de référence. Vous pourriez par exemple procéder comme suit :
- Ouvrez le fichier users.json et recherchez les utilisateurs concernés. Prenez note de leurs identifiants.
- Ensuite, ouvrez le fichier channels.json, groups.json ou dms.json et recherchez la conversation incluant ces deux identifiants dans la section members. Prenez note du nom du canal ou de l’identifiant de la conversation en question.
-
Dans le dossier d’exportation principal, recherchez le dossier dont le titre inclut le nom du canal ou l’identifiant de la conversation. Vous trouverez plusieurs fichiers JSON dans ce dossier ; un pour chaque date à laquelle des messages ont été envoyés.
Remarque : un dossier sera inclus dans le fichier d’exportation uniquement si des messages sont disponibles pour la plage de dates que vous avez exportée. Par exemple, si vos règles de conservation sont définies de sorte à supprimer les messages des canaux publics au bout de 30 jours et que vous avez sélectionné une plage de dates remontant à plus de 31 jours, aucun dossier ne sera inclus dans votre exportation pour les canaux publics.
Chaque dossier de votre fichier ZIP contiendra différentes données de votre espace de travail. Le dossier canaux contiendra un fichier TXT pour chaque canal et chaque message direct de groupe auquel a participé un utilisateur unique. Le dossier messages directs contiendra un fichier TXT pour chaque message direct de personne à personne auquel a participé un utilisateur unique.
Les fichiers TXT pour les conversations auront pour titre le nom du canal ou les noms d’utilisateurs des membres participant au message direct. Par exemple, les données de votre canal #général se trouveront dans le fichier general.txt. Les données d’un message direct peuvent se trouver dans un fichier intitulé mcollins-jjordan.txt.
Pour consulter les messages d’une conversation spécifique, vous pouvez procéder comme suit :
- Ouvrez le dossier canaux ou messages directs.
- Ouvrez le fichier TXT du canal ou du message direct que vous souhaitez consulter.
Une fois le fichier TXT ouvert, vous verrez l’historique des messages de la conversation sous l’en-tête Messages. L’historique des messages contiendra les messages envoyés par l’utilisateur unique dans votre exportation et tous les autres utilisateurs ayant participé à la conversation.
Remarque : les messages modifiés et supprimés n’apparaîtront dans votre fichier d’export que si vos règles de conservation sont définies de sorte à les conserver.
Comment lire les messages
Fichiers JSON
Fichiers TXT
Chaque message comprendra les champs suivants :
-
"type" :
indique que les données sont des messages. -
"user" :
identifiant du membre qui a envoyé le message. -
"text" :
indique le contenu du message. -
"ts" :
horodatage de la publication du message. Vous pouvez utiliser n’importe quel convertisseur d’horodatage Unix en ligne pour convertir l’horodatage.
Chaque message sera consigné dans le fichier correspondant à la date à laquelle il a été envoyé. Voici à quoi ressemblera un message très simple :
{
"type": "message",
"user": "U2147483697",
"text": "Bonjour tout le monde",
"ts": "1355517523.000005"
}
Remarque : certains messages peuvent aussi inclure une valeur pour les "attachments" (pièces jointes). Cette valeur contient la liste des objets joints au message.
Conseil : vous pouvez traduire les identifiants alphanumériques pour les champs "channel" et "user" en référençant les fichiers channels.json et users.json.
Sous-types de messages
Outre les messages que les membres publient dans Slack, il existe des sous-types de messages : c’est-à-dire des messages publiés par les applis, les bots ou les intégrations, ou encore des messages que vous voyez lorsqu’un membre rejoint un canal. Veuillez consulter ci-dessous la liste complète des sous-types de messages :
Type | Description |
bot_message | Un message publié par une appli ou par une intégration |
me_message | Un message a été envoyé avec la commande barre oblique /moi |
message_changed | Un message a été modifié |
message_deleted | Un message a été supprimé |
channel_join | Un membre a rejoint un canal |
channel_leave | Un membre a quitté un canal |
channel_topic | Le thème d’un canal a été mis à jour |
channel_purpose | L’objectif d’un canal a été mis à jour |
channel_name | Un canal a été renommé |
channel_archive | Un canal a été archivé |
channel_unarchive | Un canal a été désarchivé |
group_join | Un membre a rejoint un groupe |
group_leave | Un membre a quitté un groupe |
group_topic | Le thème d’un groupe a été mis à jour |
group_purpose | L’objectif d’un groupe a été mis à jour |
group_name | Un groupe a été renommé |
group_archive | Un groupe a été archivé |
group_unarchive | Un groupe a été désarchivé |
file_share | Un fichier a été partagé sur un canal |
file_reply | Une réponse a été ajoutée à un fichier |
file_mention | Un fichier a été mentionné sur un canal |
pinned_item | Un élément a été épinglé sur un canal |
unpinned_item | L’épingle d’un élément a été supprimée d’un canal |
Réactions et éléments enregistrés et épinglés
Les messages peuvent avoir des propriétés supplémentaires pour indiquer si quiconque a interagi avec.
- Si vous voyez "is_starred": true, cela signifie qu’un membre a enregistré le message. Si personne ne l’a enregistré, vous ne verrez pas cette valeur.
- Si un message a été épinglé, vous verrez les emplacements à côté de "pinned_to".
- Si "reactions" s’affiche, vous pouvez parcourir une liste de toutes les réactions émojis ajoutées à un message ("name"), le nombre de membres qui ont réagi ("count"), et une liste des membres qui ont réagi ("users").
{
"type": "message",
"channel": "C2147483705",
"user": "U2147483697",
"text": "Bonjour tout le monde",
"ts": "1355517523.000005",
"is_starred": true,
"pinned_to": ["C024BE7LT", ...],
"reactions": [
{
"name": "astonished",
"count": 3,
"users": [ "U1", "U2", "U3" ]
},
{
"name": "facepalm",
"count": 1034,
"users": [ "U1", "U2", "U3", "U4", "U5" ]
}
Remarque : la valeur "reactions" ne répertorie pas toujours la liste de tous les membres qui ont réagi à un message. Par contre la valeur "count" indiquera toujours le nombre exact de personnes qui ont réagi.
Les messages apparaîtront dans l’ordre dans lequel ils ont été envoyés dans la conversation. Les messages contiendront les éléments qui suivent :
- horodatage (en GMT) de l’envoi du message
- nom d’utilisateur Slack de la personne qui a envoyé le message
- contenu du message.
Voici à quoi peut ressembler un message simple :
[2020-04-20 13:47:27] <jjordan> Bienvenue dans le canal de l’équipe de vente ! Notre équipe s’agrandit plus rapidement que jamais
Votre fichier d’export ne différenciera pas les messages figurant dans un fil de discussion des messages envoyés à un canal. Tous les messages d’un fil de discussion apparaîtront dans le fil de la conversation, mêlés au reste des messages.
Conseil : si une personne est mentionnée dans un message, son nom d’affichage ne sera plus précédé du symbole @.
Comment interpréter un message modifié ?
Fichiers JSON
Fichiers TXT
Les membres peuvent modifier des messages qu’ils ont partagés avec un canal. Si votre option d’exportation vous donne accès aux journaux de modifications, un message modifié affichera la valeur "edited" avec les informations suivantes :
-
"user"
identifiant du membre qui a effectué la modification. -
"ts"
horodatage de la modification du message. Vous pouvez utiliser n’importe quel convertisseur d’horodatage Unix en ligne pour convertir l’horodatage.
Chaque modification sera consignée dans le fichier correspondant à la date à laquelle elle a été effectuée. Voici un exemple :
{ "type": "message", "user": "UTXHL6F8A", "upload": false, "ts": "1590101612.000000", "text": "Bonjour, voici le message une fois modifié.", "previous": { "text": "Bonjour, voici le message d’origine.", "blocks": [ { "type": "rich_text", "block_id": "Bts", "elements": [ { "type": "rich_text_section", "elements": [ { "type": "text", "text": "Bonjour, voici le message d’origine." } ] } ] } ] }, "original_ts": "1590101603.000300", "subtype": "message_changed", "editor_id": "UTXHL6F8A", "blocks": [ { "type": "rich_text", "block_id": "O+PJ", "elements": [ { "type": "rich_text_section", "elements": [ { "type": "text", "text": "Bonjour, voici le message une fois modifié." } ] } ] } ] }
Les messages modifiés apparaîtront à la fin du fichier TXT de la conversation sous l’en-tête Modification des messages. Les messages modifiés contiendront les éléments qui suivent :
- horodatage (en GMT) de la modification du message
- nom d’utilisateur de la personne qui a mis à jour le message
- horodatage de l’envoi du message original
- contenu du message original, avant toute modification. Le message modifié apparaîtra dans la section Messages dans le fil de la conversation.
Voici un exemple :
[2020-04-20 13:47:27] <jjordan> mis à jour [2020-04-20 13:47:09] <jjordan> Bienvenue dans le canal de l’équipe de vente !
Comment lire un message supprimé
Fichiers JSON
Fichiers TXT
Les membres peuvent supprimer des messages qu’ils ont partagés avec un canal. Si vos règles de conservation autorisent la création de journaux de suppression, un message supprimé affichera la valeur "previous" avec les informations suivantes :
-
"text"
texte du message supprimé -
"ts"
horodatage de la suppression du message. Vous pouvez utiliser n’importe quel convertisseur d’horodatage Unix en ligne pour convertir l’horodatage.
Chaque suppression de message sera consignée dans le fichier correspondant à la date à laquelle elle a été effectuée. Voici un exemple :
{
"type": "message",
"user": "UTXHL6F8A",
"upload": false,
"ts": "1590101824.000000",
"text": "",
"previous": {
"text": "Voici un message ayant été supprimé.",
"blocks": [
{
"type": "rich_text",
"block_id": "ABSkQ",
"elements": [
{
"type": "rich_text_section",
"elements": [
{
"type": "text",
"text": "Voici un message ayant été supprimé."
}
]
}
]
}
]
},
"original_ts": "1590101818.000600",
"subtype": "message_deleted",
"editor_id": "UTXHL6F8A"
}
Les messages supprimés apparaîtront à la fin du fichier TXT de la conversation sous l’en-tête Modification des messages. Les messages supprimés contiendront les éléments qui suivent :
- horodatage (en GMT) de la suppression du message
- nom d’utilisateur de la personne qui a supprimé le message
- horodatage de l’envoi du message original
- contenu du message original.
Voici à quoi peut ressembler un message supprimé :
[2020-04-20 13:47:47] <jjordan> supprimé [2020-04-20 13:47:42] <jjordan> La semaine dernière, nous avons réalisé un chiffre d’affaires de X !
Comment consulter des fichiers
Fichiers JSON
Fichiers TXT
Les fichiers d’exportation Slack au format JSON ne contiennent aucun fichier de l’espace de travail. Ils incluent des liens de fichiers, disponibles dans les fichiers JSON d’historique des messages de votre fichier d’exportation, qui redirigent vers les fichiers de l’espace de travail. Copiez ces liens de fichiers à partir du fichier JSON et collez-les dans votre navigateur pour ouvrir les fichiers.
Procédez comme suit pour rechercher un fichier spécifique :
- Ouvrez le dossier correspondant à la conversation dans laquelle le fichier a été partagé.
- Recherchez le fichier JSON correspondant à la date à laquelle le fichier a été partagé.
- Le lien de fichier apparaîtra dans les détails du message dans lequel il a été partagé, dans la section "files:".
Remarque : si vous supprimez un fichier, ou bien le canal ou l’espace de travail dans lequel il a été partagé, celui-ci ne sera plus accessible via le lien de fichier dans votre exportation.
Le dossier fichiers de votre fichier ZIP contient les fichiers envoyés par l’utilisateur unique sélectionné dans votre exportation. Les titres des fichiers apparaîtront dans vos fichiers TXT canaux et messages directs dans le fil d’une conversation, comme suit :
[2020-04-20 13:47:27] jjordan a partagé le(s) fichier(s) F01243S814M
Procédez comme suit pour rechercher un fichier spécifique :
- Ouvrez le fichier TXT correspondant à la conversation dans laquelle le fichier a été partagé.
- Localisez le fichier que vous souhaitez ouvrir dans l’historique des messages et prenez note du titre du fichier correspondant (ex. : F01243S814M).
- Ouvrez le dossier des fichiers et sélectionnez le titre du fichier pour l’ouvrir.