Importer des données JSON dans une investigation

Osintracker permet d'importer des entités et des relations dans une investigation existante à partir de fichiers CSV ou JSON. Cette fonction est accessible depuis le panneau d'information de l'investigation.

Accéder à l'import

1. Ouvrez votre investigation
2. Assurez-vous qu'aucun élément n'est sélectionné pour afficher le panneau d'information
3. Ouvrez le menu ⋮ du panneau → section Entités et relations, puis choisissez Importer .json ou Importer .csv

Le menu ⋮ se trouve en haut du panneau d'information de l'investigation (panneau latéral droit, rien de sélectionné). JSON et CSV sont deux entrées Importer distinctes — chacune marquée par son format.

Format JSON

Le format JSON permet d'importer entités et relations en un seul fichier.

Structure du fichier

{
  "entities": [ ... ],
  "relations": [ ... ]
}

Structure d'une entité

{
  "id": "identifiant-unique",
  "typeId": "id-du-type-d-entite",
  "value": "valeur principale de l'entité",
  "colorNum": "2",
  "comments": "Notes sur cette entité",
  "countryCode": "FR",
  "critical": false,
  "creationDate": 1700000000000,
  "nodeSize": "M",
  "progress": "question",
  "rating": "2"
}

Champ	Type	Obligatoire	Description
id	string	Oui	Identifiant unique
typeId	string	Oui	ID du type d'entité (depuis le Sélecteur de types / Types d'entités)
value	string	Oui	Valeur principale affichée
colorNum	string	Non	Numéro de couleur (1–8)
comments	string	Non	Notes libres
countryCode	string	Non	Code pays ISO 2 lettres
critical	boolean	Non	Marque comme critique
creationDate	number	Non	Timestamp ms depuis epoch
nodeSize	string	Non	"S", "M" ou "L"
progress	string	Non	Badge : "done", "exclamation", "false-positive", "question", "stop", "wait"
rating	string	Non	"0" à "3"
editionDate	number	Non	Timestamp ms de la dernière modification
position	object	Non	{ "x": number, "y": number } — position du nœud sur le graphe
url	string	Non	URL associée
image	string	Non	URL de l'image affichée sur le nœud
imageDisplay	boolean	Non	Affiche ou non l'image sur le nœud
customIcon	string	Non	Identifiant d'icône personnalisée

Structure d'une relation

{
  "id": "identifiant-unique-relation",
  "originId": "id-entite-source",
  "targetId": "id-entite-cible",
  "label": "Texte de la relation",
  "critical": false,
  "bidirectional": false,
  "creationDate": 1700000000000,
  "rating": 2,
  "source": "Source de l'information",
  "comments": "Notes sur cette relation"
}

Champ	Type	Obligatoire	Description
id	string	Oui	Identifiant unique
originId	string	Oui	ID de l'entité source
targetId	string	Oui	ID de l'entité cible
label	string	Non	Étiquette affichée sur l'arête
critical	boolean	Non	Relation critique (rouge)
bidirectional	boolean	Non	Double sens
creationDate	number	Non	Timestamp ms
rating	number	Non	0 à 3
source	string	Non	Origine de l'information
resource	string	Non	Ressource / référence
colorNum	string	Non	Numéro de couleur (1–8)
editionDate	number	Non	Timestamp ms de la dernière modification
comments	string	Non	Notes libres

Les champs temporels startDate, endDate, startTime et endTime (timestamps numériques) sont également acceptés.

Identifiants en doublon

L'id de chaque entité et relation importée doit être unique et absent de l'investigation.

• Si un id importé existe déjà dans l'investigation, ou apparaît deux fois dans le même fichier, l'import est bloqué et l'assistant affiche une erreur pour chaque conflit — rien n'est importé tant que ce n'est pas résolu.
• Utilisez des identifiants neufs et uniques (par exemple des UUID) pour les nouveaux éléments.

Réimporter une investigation entière est différent : l'import d'investigation .osintracker gère automatiquement les conflits d'identifiants en important une copie indépendante avec des IDs réattribués. Voir Import & Export.

Format CSV

Le CSV permet d'importer entités et relations séparément (deux fichiers distincts).

La délimitation par virgules (,) est recommandée. Le délimiteur est détecté automatiquement, donc les fichiers séparés par des points-virgules ou des tabulations fonctionnent généralement aussi.

Les colonnes booléennes (critical, bidirectional) acceptent true / false (ainsi que yes / 1).

Colonnes pour les entités

Colonne	Obligatoire	Description
id	Oui	Identifiant unique
value	Oui	Valeur principale
typeId	Oui	ID du type (via le sélecteur de types)
colorNum	Non	Numéro de couleur
creationDate	Non	Timestamp ms
critical	Non	true / false
editionDate	Non	Timestamp ms
rating	Non	0 à 3
countryCode	Non	Code pays ISO 2 lettres
nodeSize	Non	S, M ou L
progress	Non	Badge (voir les valeurs progress JSON)
comments	Non	Notes

Colonnes pour les relations

Colonne	Obligatoire	Description
id	Oui	Identifiant unique
originId	Oui	ID entité source
targetId	Oui	ID entité cible
creationDate	Non	Timestamp ms
editionDate	Non	Timestamp ms
label	Non	Étiquette
critical	Non	true / false
bidirectional	Non	true / false
colorNum	Non	Numéro de couleur
rating	Non	0 à 3
startDate	Non	Date de début
endDate	Non	Date de fin
source	Non	Source
resource	Non	Ressource / référence
comments	Non	Notes

Les lignes auxquelles il manque une colonne obligatoire (id, value/typeId pour les entités, originId/targetId pour les relations) sont ignorées, et l'assistant indique combien ont été écartées.

Trouver les IDs de types

Pour connaître le typeId d'un type d'entité, utilisez le sélecteur de types accessible depuis :

Menu principal → Sélecteur de types

Sélectionnez le ou les types souhaités (Ctrl+Clic pour sélectionner plusieurs), puis copiez le texte généré pour l'utiliser dans vos fichiers CSV ou JSON.