Tutorial: Atlas Device Sync para .NET con MAUI

Añade la propiedad de prioridad

1. In the RealmTodo project, expand the Models folder and open the Item class file.

2. Add the following public property:

   [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;.

   Cuando esté completo, 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, configura el InitialItem.Priority en el objeto existente y, para un elemento nuevo, configura la propiedad en la llamada Add(). Su 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 consiste en agregar los elementos de la interfaz de usuario 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. In the EditItemsPage.xaml, we will add two UI elements: a Picker that enables the user to choose which priority level to set on the new Item and a label for the picker. Find the Entry element for setting the Summary and add the following elements below it:

   <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 vuelve a la página de datos de Atlas en tu navegador y actualiza la colección Item. Ahora deberías ver el nuevo ítem con el campo priority añadido y configurado en 1. También notarás que el Item existente ahora también tiene un campo priority, y está configurado en null, como se muestra en la siguiente captura de pantalla:

haga clic para ampliar

Update the subscription

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.

We're going to add a new subscription that shows the current user's items that have a priority of 0 or 1.

1. Al final de la clase RealmService, agregue una entrada al enum 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. Change the name of the new query to "myHighPri". Your code will look like the following:

   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 tres suscripciones, 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

Vuelve a ejecutar la aplicación. Si se le solicita, inicie sesión usando la cuenta que creó anteriormente en este tutorial.

Verá todos los elementos que haya creado con prioridad "Alta" (1) o "Severa" (0). Si activa la opción "Mostrar todas las tareas", aparecerán todas las tareas de todos los usuarios.