La aplicación

Importar desde YAZIO

Cómo migrar un diario de YAZIO a openplate con la herramienta de código abierto yazio-exporter, y qué datos se transfieren y cuáles no

Esta página es una traducción automática de la documentación en inglés.

Si llevabas un diario de alimentos en YAZIO y quieres pasarlo a openplate, sigue estos pasos. Instala una herramienta de exportación, ejecuta cuatro comandos y selecciona los archivos exportados en la pantalla Datos y copia de seguridad de openplate. No necesitas experiencia como desarrollador, basta con saber escribir comandos en una terminal.

Cada alimento que registraste en YAZIO se guardará en openplate en el día y en la comida en que lo anotaste, con sus macronutrientes calculados según la cantidad que comiste. Tus registros de peso también se pueden transferir. Lee la sección "Qué datos se transfieren y cuáles no" más abajo antes de importar, ya que algunos valores se interpretan de forma distinta que en YAZIO.

Qué necesitas

Tu correo y contraseña de YAZIO.
Un ordenador en el que puedas abrir una terminal e instalar Python. Un teléfono no sirve para el paso de exportación. Luego puedes pasar los archivos al teléfono si usas openplate allí.
Python 3.11 o posterior.
openplate abierto en un navegador, en el mismo dispositivo o en uno al que puedas copiar los archivos.

Exportar tu diario de YAZIO

openplate no se comunica directamente con YAZIO. Debes ejecutar una herramienta de línea de comandos independiente y de código abierto llamada yazio-exporter. Esta herramienta lee tu diario de YAZIO y lo guarda en archivos en tu ordenador.

yazio-exporter es una herramienta de terceros. Ni openplate ni YAZIO la crearon, y nadie vinculado a openplate la mantiene. Puede dejar de funcionar si YAZIO modifica su aplicación. El proyecto está en github.com/aleksandr-bogdanov/yazio-exporter.

Instala Python 3.11 o posterior, si aún no lo tienes. La página de descargas de python.org incluye instaladores para Windows, macOS y Linux.
02
Abre una terminal e instala la herramienta de exportación:
bash
```
pip install yazio-exporter
```

01
Inicia sesión y luego exporta tus días, productos y peso:
bash
```
yazio-exporter login you@example.com your-password
yazio-exporter days
yazio-exporter products
yazio-exporter weight
```
Sustituye you@example.com y your-password por tus credenciales de acceso a YAZIO. Este comando solo se conecta al servidor de YAZIO, yzapi.yazio.com. Nada se envía a openplate durante este paso.
El comando login guarda un token en un archivo llamado token.txt en tu carpeta actual. Los demás comandos usan este archivo para no volver a pedirte la contraseña. Tu sistema crea este archivo con permisos de lectura únicamente para tu cuenta de usuario, pero no está cifrado. Elimina token.txt una vez que termines la exportación.
Tu contraseña permanece en el historial de comandos de tu terminal, porque yazio-exporter la recibe como texto plano en la línea de comandos y no en una solicitud oculta. En macOS y Linux, tienes dos formas de evitar que se guarde: escribe un espacio antes del comando si tu shell ignora las líneas que empiezan con un espacio, o ejecuta history -c justo después para borrar el historial de tu sesión. En Windows, cerrar PowerShell no lo elimina. El módulo PSReadLine de PowerShell mantiene un archivo de historial persistente en %APPDATA%\Microsoft\Windows\PowerShell\PSReadLine\ConsoleHost_history.txt. Abre ese archivo después y borra la línea que contiene tu contraseña.

Localiza los archivos. yazio-exporter days genera days.json. yazio-exporter products genera products.json. yazio-exporter weight genera weight.json. Los archivos se guardan en la carpeta donde ejecutaste los comandos. Necesitas days.json y products.json. weight.json es opcional e incluye tus registros de peso.

Importar a openplate

Abre openplate y ve a Ajustes, luego a Datos y copia de seguridad.
En Importar desde YAZIO, selecciona Elige los archivos de YAZIO.
En el selector de archivos, selecciona a la vez days.json y products.json, y también weight.json si quieres tus pesajes, luego confirma la selección.
openplate lee los archivos en tu dispositivo y muestra una vista previa. Muestra la cantidad de entradas que añadirá, la cantidad de días que cubren, el primer y el último día, y cualquier elemento omitido junto con el motivo. Si algunos de estos días ya tienen entradas en tu diario de openplate, la vista previa muestra cuántas. Tras la importación, esos días muestran tanto tus entradas propias como las importadas. Con weight.json, la vista previa también muestra cuántos pesajes añadirá y el primer y último peso, en kilogramos. Todavía no se escribe nada en tu diario.
Revisa la vista previa y luego selecciona Añadir a mi diario. Selecciona Cancelar para detenerte sin cambiar nada.
openplate confirma cuántas entradas y pesajes ha importado. Abre tu diario y comprueba un día que recuerdes.

Los archivos se quedan en tu dispositivo. openplate los lee de forma local en tu navegador y no los sube a ningún servidor.

Qué se transfiere y qué no

Cada alimento pasa a ser una entrada propia, en el día y en la comida en que lo registraste en YAZIO.
Un nutriente que YAZIO no incluye se muestra como desconocido en openplate, nunca como cero. YAZIO no tiene valores de fibra para muchos alimentos. Cuando ocurre esto, openplate marca la fibra como desconocida en vez de como cero.
openplate trata la cifra de carbohidratos de YAZIO como si ya excluyera la fibra, el estilo de la UE, y no vuelve a restar la fibra. Nadie sabe con certeza qué estilo utiliza YAZIO. Si la cifra de YAZIO incluye en realidad la fibra, el estilo estadounidense, tus carbohidratos netos en openplate se verán más altos de lo que realmente son, nunca más bajos. Ese es el error más seguro para una app de seguimiento baja en carbohidratos.
Una cantidad en mililitros cuenta como la misma cantidad de gramos. openplate solo guarda el peso en gramos.
Las entradas rápidas se omiten. Cuando introduces calorías en YAZIO sin elegir un alimento, la entrada no contiene datos de macronutrientes para que openplate los lea.
Una entrada se omite si su alimento falta en products.json. Por lo general, esto ocurre cuando la base de datos de YAZIO ya no tiene el alimento, por lo que la exportación lista la entrada del diario sin sus nutrientes. Si eliminaste un alimento de tu diario de YAZIO, no se omite, ya que ni siquiera aparece en la exportación.
El peso de una receta se obtiene sumando sus ingredientes. Si una receta no incluye la lista de ingredientes en el archivo de exportación, se omite. Los datos de las recetas son la parte menos fiable de esta importación, así que compara alguna receta importada con YAZIO.
Cada pesaje pasa a ser una entrada en tu registro de peso. La exportación repite tu último peso en cada día hasta tu siguiente pesaje. openplate solo conserva un día si su peso difiere del día anterior. Por tanto, dos pesajes consecutivos con exactamente el mismo peso se importan como una sola entrada.
openplate lee los valores de weight.json como kilogramos. La exportación no indica qué unidad utiliza. Si te pesas en libras en YAZIO, revisa el primer y el último peso en la vista previa antes de confirmar. openplate omite y cuenta cualquier valor inferior a 20 o superior a 350.
Si un día ya tiene un pesaje en openplate, se conserva. La importación nunca sustituye un peso que hayas registrado en openplate. La vista previa muestra el recuento de esos días.
Importar los mismos archivos otra vez actualiza las entradas existentes en lugar de crear duplicados. Esta acción sobrescribe cualquier edición manual que hayas hecho en una entrada importada o en un pesaje.

Eliminar una importación

Para deshacer una importación, abre Datos y copia de seguridad. Si existen entradas importadas, la parte inferior de la página muestra Entradas importadas de YAZIO con el número de entradas del diario y de pesajes de YAZIO. Selecciona Eliminar entradas de YAZIO y confirma. openplate elimina todas las entradas y pesajes de la importación, incluidos los que hayas editado después. Conserva todo lo que hayas registrado tú en openplate. Si registras un pesaje en un día que ya tenía uno importado, lo sustituye y cuenta como propio. Si usas la sincronización, tus otros dispositivos también eliminan las entradas importadas.

Si algo sale mal

openplate verifica los archivos antes de mostrar una vista previa. Esto es lo que significa cada mensaje:

"Uno de esos archivos no es un JSON válido. Elige los archivos days.json y products.json generados por el exportador." Uno de los archivos no es un JSON válido. Selecciona los archivos exactamente como los creó yazio-exporter, sin ediciones.
"Uno de esos archivos no es una exportación de YAZIO. Elige solo days.json, products.json y, si quieres tus pesajes, weight.json." Uno de los archivos es un JSON válido pero no contiene datos de exportación de YAZIO. Comprueba que hayas seleccionado los archivos correctos.
"Has elegido dos archivos del mismo tipo. Elige un days.json y un products.json." Has seleccionado archivos duplicados, como dos copias de days.json o de weight.json. Selecciona una copia de cada uno.
"Falta days.json. Elígelo junto con products.json." Solo has seleccionado products.json. Selecciona ambos archivos juntos.
"Falta products.json. Elígelo junto con days.json." Solo has seleccionado days.json. Selecciona ambos archivos juntos.

Si la vista previa indica entradas omitidas, consulta los detalles en "Qué se transfiere y qué no" más arriba.