Criterios Compartidos¶

Descripción General¶

Se utilizan criterios vinculantes para permitir an App Builder enlace de página para llevar consigo claves que filtren los datos en la página de destino. Por ejemplo, un enlace de 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 otras maneras más allá de la cláusula WHERE.

Cómo Utilizar Valores de Criterios Compartidos¶

Seleccionar Cláusulas¶

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 convierte en datos reales en su objeto de datos y se puede unir a él, utilizarlo en controles, etc.

Por ejemplo: shared('EmployeeID')

Cláusulas WHERE¶

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')

Mierda¶

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

Eventos de Fondo¶

Los eventos que ejecuta el usuario y que se ejecutan en segundo plano pueden incluir Criterios compartidos.

Formato Condicional¶

El formato condicional puede aprovechar los criterios compartidos que se transmiten al panel.

Sustitución Dinámica¶

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

Correr Sin Criterios Compartidos¶

Si utiliza la función Criterios compartidos, el objeto de datos se ejecutará de todos modos si la página o la URL no contienen un criterio coincidente. Sin embargo, deberá asegurarse de que la cláusula WHERE o la cláusula SELECT sigan funcionando 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 las columnas que tengan el mismo nombre.

Valor Predeterminado al Editar¶

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

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

En SQL, se accede a los criterios compartidos mediante la función Shared. 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 que se buscará
• Tipo de datos: si no se encuentra el criterio compartido, el tipo de retorno se puede especificar como UUID o numérico. Si se configura, App Builder 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 Deben Compartirse en un Enlace de Página¶

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

Los criterios compartidos solo están disponibles en los enlaces de página. Se trata de 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íz" (paneles no vinculados a otros paneles). A menos que utilice la función Compartido, los paneles de destino no se filtrarán automáticamente.