Criterios compartidos en Jitterbit App Builder
Descripción general
Los criterios de vinculación se utilizan para permitir que un enlace a una página del App Builder contenga 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 permite aprovechar las variables pasadas de otras maneras, más allá de la cláusula WHERE.
Cómo utilizar valores de criterios compartidos
Cláusulas selectas
La función Criterios Compartidos accede a los valores en el contexto actual. Se puede usar como cualquier función SQL. Si se 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 usar en paneles posteriores. Se convierte en datos reales en el objeto de datos y se puede combinar con controles, usarlos, 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 (por ejemplo, al ver los resultados), la función compartida devolverá el valor predeterminado "no encontrado" para el tipo de dato especificado.
Por ejemplo: Where E.EmployeeID = shared('EmployeeID')
CRUD
Las reglas CRUD se pueden ejecutar usando Criterios Compartidos. Se insertan o actualizan usando este valor en las cláusulas WHERE o SELECT.
Eventos de fondo
Los eventos ejecutados por el usuario en segundo plano pueden incluir Criterios Compartidos.
Formato condicional
El formato condicional puede aprovechar los Criterios Compartidos transmitidos al Panel.
Sustitución dinámica
Los datos de celda y las etiquetas de control pueden acceder a Criterios compartidos. Por ejemplo, incluya "Bienvenido a {{NombreDeLaEmpresa}}
" en una celda de objeto de datos, o lo mismo en una etiqueta de control.
Nota
Si está usando datos de celda, asegúrese de marcar Sustitución de soporte en el Control del App Builder.
Corriendo sin criterios compartidos
Si utiliza la función Criterios Compartidos, el objeto de datos se ejecutará si la página o la URL no contiene ningún criterio coincidente. Sin embargo, deberá asegurarse de que las cláusulas WHERE o SELECT sigan funcionando si la función devuelve una cadena vacía.
Valor predeterminado al insertar
Cuando se 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 se 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 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. Tiene dos parámetros:
- Nombre: el nombre del criterio a buscar
- Tipo de dato: si no se encuentran los criterios compartidos, el tipo de retorno puede especificarse 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. Estos enlaces 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.