Cualquier lista de instancias puede convertirse en un archivo, y un archivo puede volver a convertirse en instancias. La misma exportación sirve como copia de seguridad, como forma de mover datos entre entornos y como archivo de semillas que un administrador aplica automáticamente. Este tutorial cubre ambos sentidos.

Exportar

Abre la lista de instancias de un modelo y haz clic en Exportar en la barra de herramientas. El menú ofrece los resultados actuales en dos formatos:

  • Exportar los resultados (JSON) — el resultado completo de la búsqueda actual: se aplican el filtro activo, la ordenación y la marca de incluir eliminadas. Este es el formato que Yellow puede volver a leer.
  • Exportar los resultados (CSV) — las mismas filas como hoja de cálculo. Ábrelo con Excel o impórtalo en otra herramienta. El CSV es para leer, no para volver a importarlo en Yellow.

Elige un formato, escoge dónde guardar el archivo y listo. El nombre sugerido lleva el nombre del modelo.

Exportar una selección

Cuando solo quieres algunas filas, activa la Selección múltiple — el botoncito de lista de verificación a la izquierda de la barra de recuento, justo bajo la barra de herramientas.

  1. Haz clic en el botón de lista de verificación. Aparece una casilla en cada fila.
  2. Marca las filas que quieras. La casilla del extremo izquierdo de la barra de recuento selecciona o vacía todas las filas cargadas de una vez, y una etiqueta muestra cuántas hay seleccionadas.
  3. Vuelve a abrir Exportar — aparecen dos entradas nuevas: Exportar la selección (JSON) y Exportar la selección (CSV), con el recuento.

La selección sobrevive a la paginación y a los cambios de filtro, así que puedes reunir filas de varias búsquedas antes de exportar. Desactivar el modo la vacía.

Qué hay dentro de los archivos

Formato Una fila es… Va bien para…
JSON la instancia completa, con todas las propiedades y su identificador volver a importar, transferir entre entornos, archivos de semillas
CSV una línea, una columna por propiedad hojas de cálculo, informes, compartir con personas

Una exportación JSON pertenece a un solo modelo — el archivo registra cuál. Las instancias conservan sus identificadores, y eso es lo que hace segura la reimportación: Yellow puede distinguir «esta fila ya existe» de «esta fila es nueva».

En el CSV, una propiedad Localized String se convierte en una columna por idioma (Name [ca], Name [en], …), las referencias muestran el texto que ves en pantalla, y las colecciones se unen con ;.

Importar

Importar lee una exportación JSON hacia el mismo modelo. Abre la lista de instancias de ese modelo, haz clic en Exportar → Importar desde un archivo… y elige el archivo.

Si el archivo pertenece a otro modelo, Yellow te lo dice y se detiene — abre la lista del modelo correcto.

Después, elige qué pasa con las instancias que ya existen:

Modo Si la instancia ya existe Si es nueva
Solo crear se deja intacta, contada como omitida se crea
Crear y actualizar recibe una nueva versión con los valores del archivo se crea
Duplicar — todas las instancias se importan como copias con un identificador nuevo se crea

Crear y actualizar es la opción habitual cuando devuelves datos después de editarlos fuera, o cuando refrescas un entorno con una exportación más reciente. Solo crear es la opción segura cuando solo quieres rellenar huecos. Duplicar es para clonar filas a propósito.

Haz clic en Importar. La importación es todo o nada: o bien se aplican todas las instancias del archivo, o bien — si algo falla — no se aplica ninguna, y un diálogo lista qué ha fallado y en qué posición del archivo. Corrige el archivo y vuelve a intentarlo.

Tras una importación correcta la lista se refresca y un mensaje muestra los recuentos: creadas, actualizadas, omitidas.

Cosas que conviene saber

  • Las referencias viajan por identificador. Una referencia dentro del archivo apunta a su instancia de destino. Los destinos que también están en el archivo se resuelven automáticamente, en cualquier orden. Los de fuera del archivo deben existir previamente en el entorno, o la importación informa de un error.
  • Las actualizaciones crean versiones. «Crear y actualizar» nunca sobrescribe en silencio — los valores anteriores quedan en el historial de versiones de la instancia.
  • Los permisos se aplican. Exportar requiere permiso para listar las instancias del modelo; importar requiere permiso para crearlas (y para actualizarlas, en el caso de «Crear y actualizar»).

Relacionado