Tutorial: Sincronización de dispositivos Atlas para .NET con MAUI

Agregar la propiedad de prioridad

1. En el proyecto RealmTodo, expanda la carpeta Models y abra el archivo de clase Item.

2. Agregue la siguiente propiedad pública:

   [MapTo("priority")]
   public int? Priority { get; set; }

   Tenga en cuenta que hemos establecido esta propiedad como nula, lo que garantizará que los elementos existentes en nuestra base de datos (que no tienen una propiedad de Prioridad) seguirán estando disponibles.

Establecer la prioridad al crear o modificar un elemento

1. El modelo de vista EditItemViewModel se utiliza tanto para crear nuevos elementos como para modificar los existentes. Al crear o modificar un elemento, el usuario necesita que la interfaz de usuario (y el código) establezcan su prioridad.

2. Agregue una ObservableProperty para contener la prioridad:

   [ObservableProperty]
   private int? priority;

   Nota

   Atributo [ObservableProperty]

   El [ObservableProperty] atributo es una característica proporcionada por el kit de herramientas MVVM para simplificar la vinculación de datos.

3. El método ApplyQueryAttributes actúa como un constructor para este modelo de vista, comprobando si se pasa un elemento existente a esta vista para su edición. Aquí, capturamos los valores existentes para mostrarlos en la vista.

   Si estamos editando un elemento existente, queremos establecer la Prioridad del elemento existente: Priority = InitialItem.Priority;.

   Del mismo modo, si estamos creando un nuevo elemento, establezca la prioridad predeterminada en "Media": Priority = 2;.

   Una vez completado, este método debería verse así:

   public void ApplyQueryAttributes(IDictionary<string, object> query)
   {
         if (query.Count > 0 && query["item"] != null) // we're editing an Item
         {
            InitialItem = query["item"] as Item;
            Summary = InitialItem.Summary;
            Priority = InitialItem.Priority;
            PageHeader = $"Modify Item {InitialItem.Id}";
         }
         else // we're creating a new item
         {
            Summary = "";
            Priority = 2;
            PageHeader = "Create a New Item";
         }
   }

4. Finalmente, en el método SaveItem(), queremos persistir el valor de Prioridad. Dado que estamos creando o modificando un objeto gestionado, los cambios se envuelven en una llamada a realm.WriteAsync.

   Para el elemento existente, configure el InitialItem.Priority en el objeto existente y, para un elemento nuevo, configure la propiedad en la llamada Add(). El bloque WriteAsync completado debería verse así:

   await realm.WriteAsync(() =>
   {
      if (InitialItem != null) // editing an item
      {
         InitialItem.Summary = Summary;
         InitialItem.Priority = Priority;
      }
      else // creating a new item
      {
         realm.Add(new Item()
         {
               OwnerId = RealmService.CurrentUser.Id,
               Summary = summary,
               Priority = Priority
         });
      }
   });

Actualizar los elementos de la Interfaz de Usuario

1. La tarea final es agregar los elementos de UI necesarios para establecer y mostrar la prioridad.

   Primero, en ItemsPage.xaml, agregaremos una etiqueta a ListView que muestra la prioridad. Dentro de ViewCell, agreguemos una etiqueta para mostrar la prioridad del elemento:

   <Label Text="{Binding Priority}"
      HorizontalOptions="Center"
      VerticalOptions="Center"/>

2. En EditItemsPage.xaml, agregaremos dos elementos de la interfaz de usuario: un selector que permite al usuario elegir el nivel de prioridad del nuevo elemento y una etiqueta para el selector. Busque el elemento Entry para configurar el resumen y agregue los siguientes elementos debajo:

   <Label Text="Priority:"/>
   <Picker x:Name="newItemPriority" SelectedIndex="{Binding Priority}">
      <Picker.Items>
            <x:String>Severe</x:String>
            <x:String>High</x:String>
            <x:String>Medium</x:String>
            <x:String>Low</x:String>
      </Picker.Items>
   </Picker>

Ejecutar y probar

En este punto, puede volver a ejecutar la aplicación. Inicie sesión con la cuenta que creó anteriormente en este tutorial. Verá el elemento que creó anteriormente. Añada un nuevo elemento y verá que ahora puede establecer la prioridad. Seleccione High como prioridad y guarde el elemento.

Ahora, regrese a la página de datos del Atlas en su navegador y actualice la Item colección. Debería ver el nuevo elemento con el priority campo agregado y configurado como. También observará que el elemento existente ahora también tiene 1 un priority campo y está configurado como nulo, como se muestra en la siguiente captura de pantalla:

haga clic para ampliar

Actualizar la suscripción

En el archivo RealmService.cs, definimos dos suscripciones de Flexible Sync. Una muestra solo los elementos creados por el usuario actual, mientras que la otra muestra todos los elementos de todos los usuarios.

Vamos a agregar una nueva suscripción que muestra los elementos del usuario actual que tienen una prioridad de 0 o 1.

1. En la parte inferior de la clase RealmService, agregue una entrada a la enumeración SubscriptionType llamada "MyHighPriority":

   public enum SubscriptionType
   {
      Mine,
      MyHighPriority,
      All,
   }

2. Desplácese hacia arriba para encontrar el método GetQueryForSubscriptionType. Aquí definimos las suscripciones.

   1. Copie el primero, donde subType == SubscriptionType.Mine, y péguelo en un bloque else if inmediatamente debajo.

   2. Establezca la nueva condición en subType == SubscriptionType.MyHighPriority.

   3. Modifique esta nueva consulta de suscripción para insertar una consulta LINQ que aún filtre por OwnerId y también por valores de prioridad menores a 2.

   4. Cambie el nombre de la nueva consulta a "myHighPri". Su código se verá así:

   if (subType == SubscriptionType.Mine)
   {
         query = realm.All<Item>()
            .Where(i => i.OwnerId == CurrentUser.Id)
            .Where(i => i.Priority < 2);
         queryName = "mine";
   }
   else if (subType == SubscriptionType.MyHighPriority)
   {
         query = realm.All<Item>()
           .Where(i => i.OwnerId == CurrentUser.Id &&
                  i.Priority < 2);
         queryName = "myHighPri";
   }
   else if (subType == SubscriptionType.All)
   {
         query = realm.All<Item>();
         queryName = "all";
   }

3. En el método GetCurrentSubscriptionType inmediatamente anterior, agregue el nuevo nombre de suscripción a la declaración switch, para que se vea así:

   return activeSubscription.Name switch
   {
       "all" => SubscriptionType.All,
       "mine" => SubscriptionType.Mine,
       "myHighPri" => SubscriptionType.MyHighPriority,
       _ => throw new InvalidOperationException("Unknown subscription type")
   };

4. Finalmente, abra la clase ItemsViewModel y busque el método OnIsShowAllTasksChanged. En lugar de cambiar la interfaz de usuario para habilitar las suscripciones 3, simplemente reemplazaremos la suscripción "mine" existente por la nueva. Modifique el método SetSubscription para que se vea como sigue:

   await RealmService.SetSubscription(realm, value
      ? SubscriptionType.All
      : SubscriptionType.MyHighPriority);

Ejecutar y probar

Ejecute la aplicación de nuevo. Si se le solicita, inicie sesión con la cuenta que creó anteriormente en este tutorial.

Deberías esperar ver cualquier elemento que hayas creado con prioridad "Alta" (1) o "Grave" (0). Si activas la opción "Mostrar todas las tareas", deberían aparecer todas las tareas de todos los usuarios.