Saltar al contenido

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.

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.