Skip to content

Grid CRUD

En este tema le mostraremos cómo comenzar a usar operaciones CRUD en la Grid como parte de App Builder.

App Builder ahora proporciona una interfaz de usuario para que los usuarios realicen operaciones CRUD dentro de la grid. Esto es bastante sencillo ya que la Grid proporciona edición de celdas, edición de filas, adición de filas y eliminación de filas en la interfaz de usuario lista para usar. Vamos a utilizar una definición de API CRUD personalizada de Northwind CRUD API swagger e interfaz de usuario (más ejemplos aquí).

Si la Grid está vinculada a una tabla Customers (ruta de Swagger Imagen 1), la sección Data Interactions se cargará con los métodos disponibles para Customers, al agregar tal interacción (Imagen 2).

Imagen 1: Configurar Puntos Finales de Swagger

Imagen 2: Panel de Propiedades -> Interacciones

En el ejemplo a continuación verá cómo utilizamos un servicio Northwind Web API para obtener todos los clientes, seleccionar un cliente específico con CustomerID “BERGS” y actualizar su CompanyName a “Testing the update”. App Builder puede hacer solicitudes de datos reales para modificar los datos remotos si el usuario final lo permite a través de la ventana de solicitud (Activar edición en directo). Tenga en cuenta que hay dos estados de acceso a datos en la vista previa de la aplicación. La parte Editor/usuario autenticado del espacio de trabajo recibirá directamente una solicitud con los estados de cambios en tiempo real (imagen a continuación). El Viewer/usuario no parte del espacio de trabajo será notificado de que no tiene acceso a la Web API real y estará utilizando datos simulados en su lugar.

Activar edición en directo

Una barra de notificación se mostrará en la parte inferior de la página advirtiendo al usuario final que cualquier cambio que se realice actualizaría realmente los datos remotos. Puede desactivar esa característica utilizando el botón de acción Desactivar edición en directo.

Desactivar edición en directo

Demo de Grid CRUD

Este es el proceso completo de CRUD en acción:

Operaciones Grid CRUD

Y cómo se vería el código generado para la aplicación. Esta es la forma en que la aplicación accederá directamente a la capa de datos a través de llamadas a API web que se establecerán para cada una de las operaciones CRUD.

Observe que las operaciones CRUD también se asignan conceptualmente a los métodos HTTP que se utilizan para comunicarse con las API a través de HTTP.

export class SwaggerNWindService {
  constructor(private http: HttpClient) { }

  public postCustomer(data: any): Observable<any> {
    const options = {
      headers: {
        Authorization: 'Bearer <auth_value>',
      },
    };
    const body = data;
    return this.http.post(`${API_ENDPOINT}/Customer`, body, options);
  }
  public putCustomer(data: any): Observable<any> {
    const options = {
      headers: {
        Authorization: 'Bearer <auth_value>',
      },
    };
    const body = data;
    return this.http.put(`${API_ENDPOINT}/Customer`, body, options);
  }
  public deleteCustomer(id: string): Observable<any> {
    const options = {
      headers: {
        Authorization: 'Bearer <auth_value>',
      },
    };
    return this.http.delete(`${API_ENDPOINT}/Customer/${id}`, options);
  }
  public getCustomer(): Observable<any> {
    const options = {
      headers: {
        Authorization: 'Bearer <auth_value>',
      },
    };
    return this.http.get(`${API_ENDPOINT}/Customer`, options);
  }
}

Generamos un servicio que puede ser reutilizado por cualquier componente que necesite realizar operaciones CRUD contra la misma base de datos. Una buena práctica es escribir tal servicio de la forma más genérica posible, por lo que es adecuado para ser reutilizado en muchos componentes y contra diferentes servidores también.

Problemas conocidos y limitaciones

  • Solo funciona con puntos finales Open API.
  • Las data-actions admiten como máximo 1 parámetro.
  • Para el evento RowDeleted, el valor del parámetro será el valor de PrimaryKey de la fila de grid elegida.
  • Para los eventos RowAdded y RowUpdated, el valor del parámetro será el objeto vinculado a la fila de grid elegida.

Recursos Adicionales