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.