OnWindowTransaction

Ejecuta un guión y le pasa un objeto JSON como parámetro de guión después de que uno o más cambios de registro se hayan confirmado con éxito. El objeto JSON incluye el nombre del archivo, el nombre de la tabla base, el ID de registro, la operación y el contenido de un campo contextual para cada operación de registro consignada.

Las acciones que activan este activador de guión son las siguientes:

  • un registro se consigna tras su creación, modificación o eliminación

  • una transacción abierta se consigna con éxito

Cuándo se ejecuta el guión 

Después de que se haya procesado el evento.

Modos en los que se puede usar el activador 

Modos Visualizar y Buscar.

Resultado 

Sin opciones.

Compatibilidad 

Producto Format

FileMaker Pro

Sí

FileMaker Go

Sí

FileMaker WebDirect

Sí

FileMaker Server

Sí

FileMaker Cloud

Sí

FileMaker Data API

Sí

Publicación en la Web personalizada

Sí

Se origina en 

20.1

Descripción 

Cualquier acción que consigne uno o varios registros activa este activador de guión, ya sea dentro de una transacción abierta (consulte el paso de guión Abrir transacción) o no. Este activador pasa al guión un objeto JSON como un parámetro de guión que contiene información sobre las consignaciones. Puede usar este activador con un guión que registra cada creación, modificación y eliminación de registros, por ejemplo, en un registro de auditoría de cambios, quién las realiza y cuándo.

Utilice la función Get ( ScriptParameter ) en el guión activado para recuperar el objeto JSON. El objeto JSON tiene la siguiente estructura:

Copiar 
{
  "FileName" : {
    "BaseTableName" : [
      [ "Operation", RecordID, FieldContent ],
      ...
    ]
  }
}

  • "FileName" es el nombre de archivo de la base de datos sin la extensión del archivo.

  • "BaseTableName" es el nombre de la tabla base para los registros afectados.

  • "Operación" es "Nuevo", "Modificado" o "Eliminado".

  • RecordID es el número de identificación interno del registro.

  • FieldContent es el contenido del campo contextual para ese registro. Puede usar este campo para pasar información adicional al guión (por ejemplo, el usuario actual, la fecha y hora y los valores del campo). Si el campo contiene un JSON válido, se incluye como un valor JSON en lugar de como una cadena de texto. Si no existe un campo contextual coincidente en la tabla, se utiliza una cadena vacía.

Cuando una consignación afecta a los registros en varias tablas base, cada tabla tiene su propia matriz bajo la clave "FileName". Cuando los registros en tablas relacionadas de otros archivos se ven afectados, cada archivo tiene su propia clave de nivel superior.

El campo contextual se especifica en la opción Nombre de campo al configurar este activador. Si Nombre de campo se deja en blanco, el activador busca un campo llamado OnWindowTransaction en cada tabla base. Si no se encuentra ningún campo coincidente en una tabla, FieldContent es una cadena vacía para los registros de esa tabla.

Notas 

  • Este activador se configura por archivo. Si los registros se modifican en una tabla relacionada en otro archivo, esas entradas de registro se incluyen en el parámetro JSON incluso aunque ese otro archivo no tenga configurado el activador de guión OnWindowTransaction.

  • Para los registros eliminados, los datos del campo contextual se capturan antes de que se elimine el registro. Para registros nuevos y modificados, los datos del campo contextual se capturan después de que se consignen los registros.

  • Los registros o transacciones revertidos no activan este activador. Consulte los pasos de guión Restablecer registro/petición y Revertir transacción.

  • El acceso directo a la base de datos a través de FileMaker Data API u OData API no activa este activador. Sin embargo, los guiones que se ejecutan a través de esas API pueden activarlo.

  • Por ejemplo, para que un guión de registro de auditoría se utilice con OnWindowTransaction, consulte esta publicación del blog de Claris Engineering.

Temas relacionados