Importar y exportar

Añadir o recuperar eventos de forma masiva.

La importación y la exportación sirven para trabajar sus eventos fuera de BerlinOne: recuperarlos en un archivo, retocarlos, añadir muchos de una vez. El archivo está en formato JSON.

Todo ocurre en la página Eventos del Studio, con el botón verde Importar/Exportar, arriba, al final de la barra de búsqueda.

Quién puede usarlo

La importación y la exportación masivas están reservadas a los planes Premium y Premium+, y al propietario de la categoría. Solo afectan a eventos publicados: elija Aprobados en el filtro Estados, en el panel de la izquierda, para que el botón esté activo.

En cambio, un evento a la vez se exporta y se vuelve a importar en todos los planes: vea más abajo.

Exportar los eventos de una categoría

1. En la página Eventos, elija la categoría y luego el filtro Aprobados.
2. Haga clic en Importar/Exportar y luego en la pestaña Exportar.
3. Marque los eventos que quiere, o Seleccionar todo.
4. Haga clic en Exportar … evento(s): el archivo se descarga.

El archivo contiene, para cada evento, sus fechas, su precisión, su importancia, su naturaleza, su imagen, sus referencias y su texto en los tres idiomas.

Importar eventos

1. En la página Eventos, elija la categoría que los recibirá y luego el filtro Aprobados.
2. Haga clic en Importar/Exportar; la pestaña Importar está abierta.
3. Elija qué hacer con los duplicados — un evento que lleva el mismo identificador que un evento existente:
   • Ignorar duplicados: se dejan de lado;
   • Actualizar eventos existentes: el archivo sustituye lo que hay;
   • Crear todos los eventos: se añade todo, duplicados incluidos.
4. Haga clic en Elegir un archivo. BerlinOne lo comprueba en el acto: «3 evento(s) listo(s) para importar», o la lista de errores, línea por línea.
5. Haga clic en Importar … evento(s).

Al final se descarga un informe detallado: lo que se creó, actualizó, ignoró o rechazó. Las traducciones que faltan se hacen después, automáticamente.

El archivo

Lo más sencillo es partir de un archivo exportado. Para escribir uno a mano, esta es la forma más corta:

{
  "events": [
    {
      "title": "Primer paso en la Luna",
      "description": "Neil Armstrong pisa la Luna.",
      "start_date": "1969-07-21",
      "date_precision": "day",
      "importance": 5,
      "territory": "Luna"
    },
    {
      "title": "Guerra Fría",
      "description": "Rivalidad entre Estados Unidos y la URSS.",
      "start_date": "1947",
      "end_date": "1991",
      "temporal_type": "continuous",
      "date_precision": "year",
      "importance": 5
    }
  ]
}

Cada evento necesita un título (title), una descripción (description) y una fecha de inicio (start_date). Lo demás es opcional:

• end_date: la fecha de fin de un período;
• temporal_type: punctual para un evento puntual, continuous para un período;
• date_precision: day, month, year, decade, century o era;
• importance: de 1 a 5;
• territory: el lugar;
• is_highlighted: true para un evento destacado;
• language: el idioma del texto, fr, en o es.

Las fechas se escriben AAAA, AAAA-MM o AAAA-MM-DD, con el año siempre en cuatro cifras: 0476 para el año 476. Antes de Cristo, añada BC: 0044-03-15 BC para el 15 de marzo del 44 a. C.

Un solo evento

En todos los planes, el menú ⋮ de un evento, a la derecha de su línea en la página Eventos, ofrece:

• Exportar como JSON: el evento solo, en un archivo;
• Importar actualización: el mismo archivo, una vez retocado.

Si el evento es suyo, la actualización se aplica. Si pertenece a otra persona, se convierte en una propuesta: BerlinOne le pide que explique al propietario lo que ha cambiado.

El archivo debe volver al mismo evento, en la misma categoría, y en el idioma de la aplicación: aquel en el que lo exportó.

Si algo no funciona

El botón Importar/Exportar aparece en gris — pase el ratón por encima para saber por qué: su plan es Gratuito, la categoría no es suya, o el filtro Estados no está en Aprobados.

«El JSON debe ser un array de objetos o un objeto con una propiedad "events"» — el archivo no tiene la forma esperada. Parta de un archivo exportado.

«Línea 2: formato de fecha inválido» — la fecha no está en AAAA, AAAA-MM o AAAA-MM-DD. Compruebe las cuatro cifras del año, y el BC antes de Cristo.

«Línea 1: falta la descripción» — cada evento necesita un título, una descripción y una fecha de inicio.

«Este archivo no está en el idioma de la aplicación» — para un evento solo: cambie la interfaz al idioma del archivo, o exporte de nuevo el evento.