Criterios Compartidos¶

Descripción General¶

Los criterios vinculantes se utilizan para permitir que un enlace de página de Vinyl lleve consigo claves que filtren los datos en la página de destino. Por ejemplo, un enlace desde una página de categorías a una página de productos mostraría al usuario los productos donde ProductCategoryId = ProductId. Criterios compartidos introduce la capacidad de aprovechar estas variables pasadas de formas adicionales más allá de la cláusula WHERE.

Cómo Utilizar Valores de Criterios Compartidos¶

Cláusulas SELECT¶

La función Criterios compartidos accede a los valores en el contexto actual. Se pueden utilizar como cualquier función SQL. Si incluye una columna en cualquier objeto de datos, el valor se coloca allí como una cadena. Al seleccionar un valor de Criterios compartidos, también se puede utilizar en paneles posteriores. Se convierten en datos reales en su objeto de datos y pueden unirse a ellos, utilizarse mediante controles, etc.

Por ejemplo: shared('EmployeeID')

DÓNDE Cláusulas¶

Las cláusulas WHERE pueden contener esta función de criterios compartidos. Si ejecuta la regla fuera del contexto de su página (al ver los resultados, por ejemplo), espere que la función Compartida devuelva el valor predeterminado "no encontrado" para el tipo de datos especificado.

Por ejemplo: Where E.EmployeeID = shared('EmployeeID')

CRUD¶

Las reglas CRUD se pueden ejecutar utilizando Criterios compartidos. Insertar o actualizar usando este valor en las cláusulas WHERE o SELECT.

Eventos de Fondo¶

Los eventos ejecutados por el usuario que se ejecutan en segundo plano pueden incluir Criterios compartidos.

Formato Condicional¶

El formato condicional puede aprovechar los Criterios compartidos pasados al Panel.

Sustitución Dinámica¶

Los datos de las celdas y las etiquetas de control pueden acceder a Criterios compartidos. Por ejemplo, incluya "Bienvenido a {{NombreEmpresa}}" en una celda de objeto de datos, o lo mismo en una Etiqueta de Control.

Correr Sin Criterios Compartidos¶

Si está utilizando la función Criterios compartidos, el objeto de datos aún se ejecutará si la página o la URL no contienen criterios coincidentes. Sin embargo, deberá asegurarse de que su cláusula WHERE o SELECT aún funcione si la función devuelve una cadena vacía.

Valor Predeterminado al Insertar¶

Cuando enlace a una página con criterios compartidos, cualquier fila que inserte tendrá el valor compartido predeterminado automáticamente en columnas que tengan el mismo nombre.

Valor Predeterminado al Editar¶

Cuando enlace a una página con Criterios compartidos y cambias a un estado de edición, los Criterios compartidos se "predeterminarán" en cualquier columna nula con el mismo nombre.

Función de Tiempo de Ejecución de SQL: Compartida¶

En SQL accede a criterios compartidos a través de la función Compartido. Por ejemplo:

SELECT CustomerId, shared('ActiveEmployeeId') as ActiveEmployeeId FROM Customer WHERE CustomerRegionId <> shared('LastRegion', 'UUID')

La función devuelve el valor compartido como una cadena. La función tiene dos parámetros:

• Nombre: el nombre del criterio a buscar
• Tipo de datos: si no se encuentran los criterios compartidos, el tipo de devolución se puede especificar como UUID o numérico. Si se configura, Vinyl devolverá '00000000-0000-0000-0000-000000000000' para un UUID o '0' para un número. De lo contrario, el SQL resultante fallará al comparar un UUID con una cadena vacía.

Cómo Especificar Qué Valores Se Deben Compartir en un Enlace de Página¶

Los criterios compartidos se pueden especificar a nivel de panel o campo.

Criterios compartidos solo están disponibles en los enlaces de las páginas. Estos son enlaces que cambian la URL y abren una nueva página. La página de destino proporcionará estos valores compartidos a todos los paneles 'raíces' (paneles no vinculados a otros paneles). A menos que utilice la función Compartido, los paneles de destino no se filtrarán automáticamente.