Importer et exporter

Ajouter ou récupérer des événements en masse.

L'import et l'export servent à travailler vos événements hors de BerlinOne : les récupérer dans un fichier, les retoucher, en ajouter beaucoup d'un coup. Le fichier est au format JSON.

Tout se passe sur la page Événements du Studio, avec le bouton vert Importer/Exporter, en haut, au bout de la barre de recherche.

Qui peut s'en servir

L'import et l'export en masse sont réservés aux plans Premium et Premium+, et au propriétaire de la catégorie. Ils ne portent que sur des événements publiés : choisissez Approuvés dans le filtre Statuts, dans le panneau de gauche, pour que le bouton soit actif.

Un événement à la fois, en revanche, s'exporte et se réimporte sur tous les plans : voir plus bas.

Exporter les événements d'une catégorie

  1. Sur la page Événements, choisissez la catégorie, puis le filtre Approuvés.
  2. Cliquez Importer/Exporter, puis l'onglet Export.
  3. Cochez les événements voulus, ou Sélectionner tout.
  4. Cliquez Exporter … événement(s) : le fichier se télécharge.

Le fichier contient, pour chaque événement, ses dates, sa précision, son importance, sa nature, son image, ses références, et son texte dans les trois langues.

Importer des événements

  1. Sur la page Événements, choisissez la catégorie qui les recevra, puis le filtre Approuvés.
  2. Cliquez Importer/Exporter ; l'onglet Import est ouvert.
  3. Choisissez quoi faire des doublons — un événement qui porte le même identifiant qu'un événement existant :
    • Ignorer les doublons : ils sont laissés de côté ;
    • Mettre à jour les événements existants : le fichier remplace ce qui est en place ;
    • Créer tous les événements : tout est ajouté, doublons compris.
  4. Cliquez Choisir un fichier. BerlinOne le vérifie aussitôt : « 3 événement(s) prêt(s) à importer », ou la liste des erreurs, ligne par ligne.
  5. Cliquez Importer … événement(s).

À la fin, un rapport détaillé se télécharge : ce qui a été créé, mis à jour, ignoré ou refusé. Les traductions manquantes sont faites ensuite, automatiquement.

Le fichier

Le plus simple est de partir d'un fichier exporté. Pour en écrire un à la main, voici la forme la plus courte :

{
  "events": [
    {
      "title": "Premier pas sur la Lune",
      "description": "Neil Armstrong pose le pied sur la Lune.",
      "start_date": "1969-07-21",
      "date_precision": "day",
      "importance": 5,
      "territory": "Lune"
    },
    {
      "title": "Guerre froide",
      "description": "Rivalité entre les États-Unis et l'URSS.",
      "start_date": "1947",
      "end_date": "1991",
      "temporal_type": "continuous",
      "date_precision": "year",
      "importance": 5
    }
  ]
}

Chaque événement demande un titre (title), une description (description) et une date de début (start_date). Le reste est facultatif :

  • end_date : la date de fin d'une période ;
  • temporal_type : punctual pour un événement ponctuel, continuous pour une période ;
  • date_precision : day, month, year, decade, century ou era ;
  • importance : de 1 à 5 ;
  • territory : le lieu ;
  • is_highlighted : true pour un événement vedette ;
  • language : la langue du texte, fr, en ou es.

Les dates s'écrivent AAAA, AAAA-MM ou AAAA-MM-JJ, l'année toujours sur quatre chiffres : 0476 pour l'an 476. Avant Jésus-Christ, ajoutez BC : 0044-03-15 BC pour le 15 mars 44 av. J.-C.

Un seul événement

Sur tous les plans, le menu ⋮ d'un événement, à droite de sa ligne dans la page Événements, propose :

  • Exporter en JSON : l'événement seul, dans un fichier ;
  • Importer mise à jour : le même fichier, une fois retouché.

Si l'événement est à vous, la mise à jour s'applique. S'il appartient à quelqu'un d'autre, elle devient une proposition : BerlinOne vous demande d'expliquer au propriétaire ce que vous avez changé.

Le fichier doit revenir sur le même événement, dans la même catégorie, et dans la langue de l'application : celle dans laquelle vous l'avez exporté.

Si ça ne marche pas

Le bouton Importer/Exporter est grisé — survolez-le pour savoir pourquoi : votre plan est Gratuit, la catégorie n'est pas à vous, ou le filtre Statuts n'est pas sur Approuvés.

« Le JSON doit être un tableau d'objets ou un objet avec une propriété "events" » — le fichier n'a pas la forme attendue. Partez d'un fichier exporté.

« Ligne 2 : format de date invalide » — la date n'est pas AAAA, AAAA-MM ou AAAA-MM-JJ. Vérifiez les quatre chiffres de l'année, et le BC avant Jésus-Christ.

« Ligne 1 : description manquante » — chaque événement doit avoir un titre, une description et une date de début.

« Ce fichier n'est pas dans la langue de l'application » — pour un événement seul : passez l'interface dans la langue du fichier, ou exportez l'événement à nouveau.