Overview
Realm Studio te permite ver y modificar objetos en tu archivo de reino. Puedes:
Importar datos desde un CSV
Crear nuevos objetos
Modificar y eliminar objetos existentes
Luego puede guardar los datos como JSON o un archivo de reino e importarlos a su aplicación cliente o base de datos de producción.
Importar desde un CSV
Nota
Si desea utilizar una nueva clase al importar datos, debe crear la clase antes de iniciar la importación.
Elige la clase de destino para tus objetos
Verás un selector desplegable con las clases disponibles en tu archivo de dominio. Selecciona la clase donde los datos importados deben convertirse en objetos.
Presiona el botón Import data.
Ahora verá los objetos recién creados a partir de los datos que importó. Las propiedades de cada objeto se asignan a las propiedades de la clase que seleccionó durante la importación.
Crear un objeto
Considere las relaciones entre objetos
Al crear un objeto nuevo, considere las relaciones entre ellos. Por ejemplo, una aplicación de tareas pendientes podría tener categorías y tareas. Las categorías tienen una relación de "mucho a mucho" con las tareas; una categoría puede tener muchas tareas. Las tareas tienen una relación inversa con la categoría.
En Realm, una relación de muchos se representa como una
list Propiedad que vincula los dos objetos. En el ejemplo de una aplicación de tareas pendientes, la clase Category tiene una propiedad list cuyo valor corresponde a todos los objetos Task relacionados.
En la interfaz de usuario de Realm Studio, se debe seleccionar la clase Category. Haz clic en la propiedad [list-of-task] de la categoría donde deseas agregar la tarea, por ejemplo, "Trabajo".
Verás todos los objetos de tarea que tienen una relación inversa con la categoría Work. Cuando creas el nuevo objeto de tarea desde la lista de Work, Realm Studio establece la relación inversa con la categoría principal Work.
Desde aquí, puede crear un nuevo objeto de tarea para «Revisar PR 1013». La nueva tarea se vinculará a la categoría «Trabajo» mediante una relación inversa.
Si selecciona la clase Task directamente, podría crear un nuevo objeto de tarea. Sin embargo, ese objeto de tarea no tendría una relación inversa con ninguna categoría principal. Entonces tendría que Agregue manualmente el objeto de tarea huérfano a la categoría a la que pertenece.
Crear el objeto
Crear el nuevo objeto
Una vez que hayas decidido dónde crear tu nuevo objeto, puedes hacerlo de dos maneras:
Haga clic en el botón Create {Class name} en la esquina superior derecha de la aplicación
Haga clic derecho (o control clic) en cualquier parte de la ventana principal para que aparezca el menú contextual y seleccione Create new {Class name}
Cualquiera de las opciones abrirá un cuadro de diálogo donde podrá configurar las propiedades del objeto. Una vez especificadas las propiedades necesarias, pulse el botón Create.
Si crea un objeto huérfano que no está asociado a un objeto principal mediante una propiedad de enlace, deberá agregarlo manualmente al objeto vinculado. Consulte: Modificar un objeto.
Modificar un objeto
Hay algunas formas de modificar un objeto de reino en Realm Studio:
Cambiar un valor de campo
Cambiar una relación de objeto
Cambiar un valor de campo
Puede cambiar manualmente los valores de campo de un objeto:
Haga clic en el campo de un objeto
Introduzca un valor diferente
Realm Studio ofrece una validación de tipos sencilla, como proporcionar una lista de opciones booleanas aceptables: Use "true", "false", "0", or "1", o convertir automáticamente una fecha en una fecha y hora válida. Sin embargo, esta validación puede provocar un comportamiento inesperado. Por ejemplo, al escribir "123abc" en un campo int, simplemente se descartan los caracteres no numéricos sin proporcionar información al usuario ni errores. Por lo tanto, es su responsabilidad asegurarse de que los datos que introduzca en un valor de campo sean del tipo correcto.
Cambiar las relaciones de un objeto
Puede cambiar la relación de un objeto con otros objetos utilizando Realm Studio.
Para agregar una nueva relación de objeto:
Haga clic en la propiedad que define la relación
Haga clic derecho (o control-clic) en cualquier parte del panel principal y seleccione Add existing {linked class name}
Seleccione el objeto que desea vincular y presione el botón Select
Importante
Añadir una relación de objeto no elimina una relación de objeto existente. Si desea cambiar una relación de objeto (por ejemplo, mover una tarea de una categoría a otra), también debe eliminar la relación que vinculaba la tarea a la categoría anterior.
Para eliminar una relación de objeto:
Haga clic en la propiedad que define la relación.
Haga clic con el botón derecho (o mantenga presionada la tecla Control y haga clic) en el objeto cuya relación desea eliminar y seleccione Remove selected row from the list o Delete selected object según el tipo de relación.
Verás un cuadro de diálogo que te pedirá que confirmes la acción. Pulsa el botón para confirmar si deseas eliminar el objeto.
Eliminar un objeto
Para eliminar un objeto de un reino:
Haga clic derecho (o presione Control y haga clic) en el objeto que desea eliminar y seleccione Delete selected object.
Verás un cuadro de diálogo que te pedirá que confirmes la acción. Pulsa el botón Delete selected object para confirmar.
Tip
Si no ve la opción Delete selected object, es posible que la esté viendo en una vista de lista de relaciones de enlace. Vaya directamente a la clase donde está almacenado el objeto.
Si estás en la clase donde está almacenado el objeto y sigues sin ver la opción Delete selected objects, puede que tengas otro objeto seleccionado. Haz clic para seleccionar el objeto que quieres eliminar y, a continuación, haz clic derecho (o pulsa Control y haz clic) para acceder a la opción de eliminación.
Guardar los datos
Dado que los objetos de realm son objetos activos, puedes realizar cambios en un archivo de realm y verlos reflejados en una aplicación cliente en tiempo real. Realm Studio te ofrece varias opciones de guardado si quieres realizar otras tareas con los datos. Para guardar el archivo, sigue estos pasos:
Vaya a File > Save data y seleccione JSON o Local Realm.
Seleccione el nombre del archivo y el destino donde desea guardar el archivo.
Presiona el botón Save.
Utilice el archivo JSON
Si guardaste los datos como JSON, puedes importarlos de nuevo a tu aplicación. Usa tu método preferido para importar el JSON a tu aplicación.
Importante
Archivos "planificados"
Al exportar a un archivo JSON, Realm Studio utiliza el formato Flattedpaquete. Si desea abrir el archivo en otra aplicación, deberá Flatted.parse() usar.
Utilice el archivo Realm
Si guarda los datos como un archivo de dominio y no ha modificado el esquema, puede usar ese archivo como reemplazo directo del archivo de dominio existente en su aplicación cliente. Simplemente reemplace el archivo de dominio existente en su sistema de archivos por el nuevo.
Como alternativa, podría guardar una copia del dominio, abrirla y modificar el esquema en ella. Esto preservaría intacto el archivo de dominio original, pero le permitiría iterar sobre el esquema. Así, podría seguir usando el archivo de dominio existente en su aplicación cliente sin realizar una migración. Podría probar las migraciones para su nuevo esquema con el segundo archivo de dominio cuando lo desee.