VidFönsterTransaktion

Utför ett script och skickar det ett JSON-objekt som en scriptparameter efter att en eller flera poständringar har sparats. JSON-objektet innehåller filnamnet, bastabellens namn, post-ID, åtgärd och innehållet i ett kontextfält för varje utförd poståtgärd.

Åtgärder som aktiverar den här scripttriggern är

  • en post sparas efter det att den har skapats, ändrats eller tagits bort

  • en öppen transaktion verkställs

När scriptet körs 

Efter att händelsen har bearbetats.

De lägen där triggern kan användas 

Bearbetningsläge och Sökläge.

Resultat 

Inga.

Kompatibilitet 

Produkt Stöds

FileMaker Pro

Ja

FileMaker Go

Ja

FileMaker WebDirect

Ja

FileMaker Server

Ja

FileMaker Cloud

Ja

FileMaker Data API

Ja

Anpassad webbpublicering

Ja

Ursprungsversion 

20.1

Beskrivning 

Alla åtgärder som verkställer eller sparar en eller flera poster aktiverar den här scripttriggern, oavsett om det är inom en öppen transaktion (mer information i Scriptsteget Öppna transaktion) eller inte. Den här triggern skickar scriptet ett JSON-objekt som en scriptparameter med information om verkställda ändringar. Du kan använda den här triggern med ett script som loggar alla åtgärder där poster skapas, ändras eller tas bort, till exempel i en granskningslogg med ändringar, vem som gör dem och när.

Använd Funktionen Get ( Scriptparameter ) i det triggade scriptet för att hämta JSON-objektet. JSON-objektet har följande struktur:

Kopiera
{
  "Filnamn" : {
    "Bastabellnamn" : [
      [ "Åtgärd", PostID, Fältinnehåll ],
      ...
    ]
  }
}
  • "Filnamn" är filnamnet för databasen utan filnamnstillägget.

  • "Bastabellnamn" är namnet på bastabellen för de berörda posterna.

  • "Åtgärd" är "Ny", "Modifierad", eller "Borttagen".

  • PostID är postens interna ID-nummer.

  • Fältinnehåll är innehållet i kontextfält för den posten. Du kan använda det här fältet för att skicka ytterligare information till scriptet (till exempel aktuell användare, tidsstämpel och fältvärden). Om fältet innehåller giltig JSON inkluderas det som ett JSON-värde i stället för som en textsträng. Om det inte finns något matchande kontextfält i tabellen används en tom sträng.

När en verkställd ändring påverkar poster i flera bastabeller har varje tabell sin egen matris under nyckeln "Filnamn". När poster i relaterade tabeller från andra filer påverkas har varje fil sin egen nyckel på översta nivån.

Kontextfältet anges i alternativet Fältnamn när den här triggern konfigureras. Om Fältnamn lämnas tomt söker triggern efter ett fält med namnet VidFönsterTransaktion i varje bastabell. Om inget matchande fält hittas i en tabell är Fältinnehåll en tom sträng för poster från den tabellen.

Kommentarer 

  • Den här triggern konfigureras per fil. Om poster ändras i en relaterad tabell i en annan fil inkluderas dessa poster i JSON-parametern även om scripttriggern VidFönsterTransaktion inte har konfigurerats för den andra filen.

  • För borttagna poster hämtas kontextfältsdata innan posten tas bort. För nya och ändrade poster hämtas kontextfältsdata när posterna har bekräftats.

  • Återställda poster eller transaktioner aktiverar inte den här triggern. Mer information finns i scripstegen Återställ post/sökpost och Återställ transaktion.

  • Direkt åtkomst till databasen via FileMaker Data API eller OData API aktiverar inte den här triggern. Script som körs via dessa API:er kan dock aktivera den.

  • Ett exempel på ett script för en revideringslogg som kan användas med VidFönsterTransaktion finns i det här inlägget i Claris Engineering-bloggen.