This page is also available in

Dokumentation

Dokumentationen nedan ingår i BeeBase-distributionen och finns även tillgänglig i PDF.

[ << ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

8. Logg

I detta kapitel hittar du:

8.1 Log table		Intern tabell som används för loggning.
8.2 Activate logging		Hur man startar och stoppar loggning.
8.3 Logging mode		Var loggposter hamnar.
8.4 Set log file		Inställning av en extern fil för loggning.
8.5 Set log label		Inställning av en etikett för nya loggposter.
8.6 Import log		Importera loggposter från en fil.
8.7 Export log		Exportera loggposter till en fil.
8.8 Clear log		Ta bort alla loggposter.
8.9 Apply changes		Tillämpa ändringar från en loggfil till projektet.
8.10 View log		Hur man visar alla loggposter.

8.1 Loggtabell

För att logga ändringar i ett projekt använder BeeBase en intern tabell med namnet `_Log'. Observera understrecket som första tecken vilket indikerar att denna tabell är en systemtabell som hanteras av BeeBase och som inte kan ändras. Tabellen innehåller följande fält:


Namn               Beskrivning

`_Label'           Ett fält som kan ställas in med menyalternativet `Logg - Ställ in loggetikett'
                   eller beräknas av en utlösarfunktion med namnet logLabel
                   (se  Set log label).
`_Date'            Datum för loggpost.
`_Time'            Tid för loggpost.
`_Action'          En av `Ny post', `Ta bort post' eller `Ändra värde'.
`_Table'           Namnet på tabellen där åtgärden inträffade.
`_Record'          Numret på posten där åtgärden inträffade vid tidpunkten
                   för åtgärden. Observera att postnumret kan ändras
                   när man lägger till eller tar bort poster, eller när man sorterar om poster
                   i en tabell.
`_Description'     Beskrivning av posten där åtgärden inträffade.
                   Postbeskrivningen kan anges i tabellobjektet
                   (se  Table object editor).
`_Field'           Om åtgärden är `Ändra värde' innehåller detta fält
                   namnet på fältet där ändringen inträffade.
`_OldValue'        Gammalt värde för fältet (för åtgärden `Ändra värde').
`_NewValue'        Nytt värde för fältet (för åtgärden `Ändra värde').

Tabellen `_Log' kan nås som vilken annan tabell som helst i ett projekt. Till exempel kan en select-from-where-fråga

SELECT * from _Log

köras i frågeredigeraren för att få en lista över alla ändringar (se Select-from-where queries och Query editor).

8.2 Aktivera Loggning

Som standard är loggning inte aktiverad i ett projekt. För att börja logga ändringar, välj menyalternativet `Logg - Loggning aktiv'. Tillståndet för detta menyalternativ lagras i projektfilen, så när det väl är aktiverat och sparat kommer ändringar att fortsätta loggas när projektet öppnas igen. Avaktivera menyalternativet för att stoppa loggning av ändringar.

Observera att endast för de tabeller och fält som har egenskapen `Logga ändringar' inställd kommer ändringar att loggas (se Creating tables och Creating fields). De ändringar som loggas är att lägga till en ny post, ta bort en post, eller ändra ett fält i en post. För varje sådan åtgärd skapas en ny loggpost och läggs till i tabellen `_Log' om loggningsläget inkluderar loggning till projektet (se Logging mode). Vid loggning till en fil loggas även loggposter för att starta en transaktion, bekräfta en transaktion eller återställa en transaktion.

8.3 Loggningsläge

Du kan ställa in loggningsläget i menyalternativet `Logg - Loggningsläge' till ett av följande val:

`Till projekt': ändringar loggas till projektets `_Log'-tabell (standard).
`Till fil': ändringar loggas till en extern loggfil.
`Till projekt och fil': ändringar loggas både till projektets `_Log'-tabell och en extern fil.

De lägen som inkluderar loggning till en extern fil är användbara för att hålla reda på ändringar om projektfilen någonsin skulle bli skadad. Se Apply changes för hur detta kan användas för att återställa ett projekt från en säkerhetskopia.

8.4 Ställ in Loggfil

För att ställa in den externa loggfilen, välj menyalternativet `Logg - Ställ in loggfil'. Detta öppnar en standardfilväljare för att ange ett filnamn. Ändringar kommer att läggas till i denna fil om den redan finns.

8.5 Ställ in Loggetikett

Tabellen `_Log' har ett fält med namnet `_Label' som kan fritt ställas in av projektet. Att välja menyalternativet `Logg - Ställ in loggetikett' öppnar en dialog för att ange etikettexten.

Det är också möjligt att tillhandahålla etiketten genom en programfunktion. Funktionen bör ha namnet logLabel och anropas för varje ny loggpost. Funktionen har inga argument och det returnerade uttrycket, konverterat till en sträng, används som etikettext. För mer information om denna utlösarfunktion, se logLabel.

Observera att när funktionen logLabel finns, inaktiveras menyalternativet `Logg - Ställ in loggetikett'.

8.6 Importera Logg

Det är möjligt att importera loggposter från en extern fil. Detta kan vara användbart när äldre loggposter har tagits bort från loggen. Efter att ha valt menyalternativet `Logg - Importera logg' öppnas ett fönster som tillåter import av poster i tabellen `_Log'. Se Importing records, för en beskrivning av alla importalternativ.

8.7 Exportera Logg

När tabellen `_Log' blir stor kan det vara användbart att exportera äldre loggposter till en extern fil. För att göra detta, välj menyalternativet `Logg - Exportera logg'. Detta öppnar ett fönster för att exportera posterna i tabellen `_Log' till en fil. Se Exporting records, för en beskrivning av alla exportalternativ.

8.8 Rensa Logg

För att rensa alla poster i loggen, välj menyalternativet `Logg - Rensa logg'. Ett typiskt fall för att rensa alla loggposter är när tabellen `_Log' blir stor. Se till att exportera alla poster till en extern fil innan du rensar loggen.

8.9 Tillämpa Ändringar

Menyalternativet `Logg - Tillämpa ändringar' tillåter import av ändringar från en extern fil och tillämpa dem på projektet. Se Importing records, för en beskrivning av alla importalternativ. Ändringar som redan finns i projektets `_Log'-tabell hoppas över.

Denna funktion möjliggör återställning av ett möjligen skadat projekt från en säkerhetskopia med hjälp av ändringarna i loggfilen. Idén är att eftersom ändringar loggas till den externa loggfilen, kan dessa ändringar tillämpas på en tidigare skapad säkerhetskopia av projektet om projektet någonsin går förlorat eller skadas.

Det finns två möjliga strategier som kan användas baserat på loggningsläget (se Logging mode):

`Till fil': När du manuellt skapar en säkerhetskopia av ett projekt bör den externa loggfilen rensas eller raderas, så att endast nya ändringar i projektet kommer att finnas i loggfilen. När du tillämpar loggfilen på säkerhetskopian kommer alla ändringar att tillämpas.
`Till projekt och fil': Loggfilen kan växa obegränsat och behöver inte rensas när du manuellt skapar en säkerhetskopia av ett projekt. Ändringar i loggfilen före säkerhetskopian kommer också att finnas i tabellen `_Log' i säkerhetskopian, och därför kommer endast ändringar efter säkerhetskopian att tillämpas.

8.10 Visa Logg

För att visa projektloggen, välj menyalternativet `Logg - Visa logg'.

Om loggningsläget (se Logging mode) är `Till projekt' eller `Till projekt och fil' öppnas frågeredigeraren med en fördefinierad fråga som listar alla loggposter. Du kan modifiera frågan och dess titel, och BeeBase kommer att komma ihåg frågan. För mer information, se Query editor.

Om loggningsläget är `Till fil' visas den externa visaren (se External viewer) med loggfilen.