This page is also available in

Dokumentation

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

6. Hantera Projekt

I detta kapitel hittar du:

6.1 Filformat

Ett BeeBase-projekt lagras som en SQLite3-databas. Om du är nyfiken kan du använda en visare eller redigerare för SQLite3-filer, såsom `DB Browser for SQLite', och inspektera en BeeBase-projektfil. Innehållet i SQLite3-databasen är någorlunda självförklarande eftersom all information hålls i ett läsbart format, men det finns några saker att känna till som inte är uppenbara.

• Alla SQLite-tabeller och kolumner som börjar med ett understreck `_' används av BeeBase för bokföring och för att lagra strukturen och den grafiska layouten av projektet.

• Alla andra tabeller är de som definieras av användaren i BeeBase-projektet.

• Datumvärden lagras som ett heltal som representerar antalet dagar sedan `1.1.0000' med användning av `Gregorianska kalendern'.

• Tidsvärden lagras som ett heltal som representerar antalet sekunder sedan `00:00:00'.

• Referenser till poster i tabeller lagras som ett heltal som motsvarar `_ID'-kolumnen i den refererade raden.

• Alla post-ID:n (lagrade i `_ID') numreras om när ett projekt omorganiseras.

Det är bäst att inte göra några ändringar i en projektfil, men om du känner att du vill experimentera, här är reglerna.

• Alla ändringar i en projektfil görs bäst som en enda transaktion. Till exempel, `DB Browser for SQLite' tillåter redigering av en SQLite-fil och sedan skriva tillbaka alla ändringar i en transaktion.

• Du kan lägga till nya rader, ändra rader eller ta bort rader i en användartabell. När du lägger till en ny rad bör `_ID'-kolumnen vara ett oanvänt ID, helst större än något befintligt `_ID' i samma tabell. När du ändrar en rad, ändra också `_Version'-kolumnen i samma rad, t.ex. genom att öka den med 1. För att BeeBase ska märka någon förändring i projektet måste `Version'- kolumnen i tabellen `_Project' också ökas. BeeBase kommer då att ladda om projektet och uppdatera sig baserat på de ändrade posterna.

• Kolumnen `SavedWith' i tabellen `_Project' bör uppdateras med en meningsfull text (t.ex. namnet på programmet som senast uppdaterade projektet).

• Att ändra andra BeeBase-tabeller (som börjar med ett understreck `_') är förmodligen en dålig idé. Men om du gör det måste du också öka `StructureVersion' förutom `Version' i tabellen `_Project'.

SQLite tillåter att ansluta flera instanser av BeeBase till samma projekt. Flera BeeBase-instanser kan öppna projektet för läsning, men endast en instans får göra ändringar. Observera att för att denna låsningsmekanism ska fungera måste filsystemet uppfylla vissa garantier. Det är bäst att först testa delning av ett projekt mellan olika BeeBase-instanser på ett visst filsystem innan du förlitar dig på denna funktion.

6.2 Info

BeeBase behåller viss information om varje projekt. Välj menyalternativet `Projekt - Info' för att få information om det aktuella projektet. Informationen du får består av projektets namn, antalet tabeller, det totala antalet poster i alla tabeller, och ett värde som visar hur många byte en omorganisation av detta projekt skulle tjäna. Vinsten är dock endast en grov uppskattning och bör inte behandlas som ett exakt tal. Särskilt om du har gjort många ändringar i projektets struktur (lagt till eller tagit bort fält) är detta värde långt ifrån korrekt.

6.3 Nytt Projekt

BeeBase kan hantera valfritt antal projekt åt gången. Du begränsas endast av tillgängligt minne. För att starta ett annat projekt, välj menyalternativet `Projekt - Nytt'. Detta öppnar ett nytt fönster med ett tomt projekt. Du kan nu definiera strukturen för detta projekt (se Structure editor) eller ladda ett befintligt projekt från disk (se Open project).

6.4 Rensa Projekt

För att återställa ett projekt välj menyalternativet `Projekt - Rensa - Projekt'. Detta stänger det aktuella projektet och ersätter det med ett tomt projekt. Efter att ha startat BeeBase utan projekt hamnar du automatiskt i detta tillstånd.

Genom att välja menyalternativet `Projekt - Rensa - Poster' startar du ett nytt projekt med det aktuella projektets struktur. Detta innebär att allt utom postdata från det aktuella projektet används för det nya projektet.

Om det aktuella projektet vid tidpunkten då du valde något av ovanstående menyalternativ inte har sparats till disk visas en dialogruta som ber om bekräftelse av åtgärden.

6.5 Öppna Projekt

För att ladda ett projekt välj menyalternativet `Projekt - Öppna - Projekt'. Detta öppnar en fildialog där du kan välja ett projekt att öppna. Det finns också flera demoprojekt som illustrerar funktionerna i BeeBase. För att ladda ett av dem, välj menyalternativet `Projekt - Öppna - Demo'.

Om det laddade projektet har sin programkälla inställd som extern, skapas den externa källfilen efter att projektet öppnats (se External program source).

Om du redigerade ett projekt när du valde något av ovanstående menyalternativ och projektet inte har sparats, visas en dialogruta som ber om bekräftelse.

Du kan också ladda om en ny version av det aktuella projektet från disk genom att välja menyalternativet `Projekt - Ladda om'.

6.6 Spara Projekt

Alla ändringar du gör i ett projekt görs endast i minnet eller lagras tillfälligt vid växling av poster (se Swap records). Om du vill göra dem permanenta måste du spara projektet till disk. Detta görs genom att välja menyalternativet `Projekt - Spara'. Om ditt projekt ännu inte har ett namn visas först en fildialog som ber om ett filnamn.

Anledningen till att BeeBase inte automatiskt sparar ett projekt när det ändras är att du på detta sätt bestämmer när ett projekt ska sparas! Du kan alltid gå tillbaka till den senast sparade versionen av ditt projekt genom att välja menyalternativet `Projekt - Återgå till sparad'. Denna mekanism liknar kommandona `COMMIT' och `ROLLBACK' i SQL-databassystem.

Om du sparar ett projekt skrivs alla modifierade poster till disk och filen `Structure.bbs' återskapas. Innan den nya filen `Structure.bbs' skapas, döper BeeBase först om en eventuellt befintlig `Structure.bbs'-fil till `Structure.old' för att ha en säkerhetskopia ifall sparoperationen misslyckas.

Denna mekanism garanterar snabba laddnings- och sparoperationer men den är inte fri från omorganisation. Om du har modifierat många poster kan den fysiska platsen där posterna ligger och den resulterande fragmenteringen bli ofördelaktig. Därför finns ett menyalternativ `Projekt - Spara & omorganisera' som gör en spara & omorganisera-operation. Denna operation kan ta tid beroende på antalet och storleken på posterna. Spara & omorganisera-operationen skapar en ny katalog och skriver om alla projektrelaterade filer. Den gamla katalogen raderas vid framgång.

En annan bra tidpunkt att planera en omorganisation är när du har gjort ändringar i datastrukturen för ett projekt, t.ex. efter att du har installerat ett nytt fält i en tabell. Dessa ändringar tillämpas inte omedelbart på alla poster eftersom det skulle ta för mycket tid att ladda varje post, modifiera den och spara den tillbaka till disk. Därför läggs dessa ändringar på en intern `att göra'- lista som tillämpas efter att en post laddats. Att tillämpa denna lista på en post tar endast lite tid. Ju längre listan blir, desto mer tid krävs dock. Att omorganisera ett projekt gör att `att göra'-listan tillämpas på alla poster, så om du har gjort många förändringar i projektstrukturen förkortar omorganisering av ett projekt tiden för att ladda poster.

Du kan också spara & omorganisera ett projekt till ett nytt filnamn och behålla det gamla projektet orört. För att göra detta välj menyalternativet `Projekt - Spara & omorganisera som' som uppmanar dig att ange ett nytt namn för projektet.

6.7 Exportera som SQLite3-databas

BeeBase använder ett anpassat binärt format för att lagra ett projekt (se File format). Om du vill visa ditt projekt i ett annat databassystem, kan du exportera det till det populära SQLite3-formatet genom att välja menyalternativet `Projekt - Exportera som SQLite3-databas'. Detta lagrar all projektdata inklusive projektstrukturen i en SQLite3-fil. Det finns många verktyg och visare som kan läsa och skriva SQLite3-filer. För närvarande är det dock inte möjligt att läsa in en SQLite3-fil i BeeBase.

6.8 Admin- och Användarläge

BeeBase fungerar antingen i adminläge (standard) eller i användarläge. Du kan växla mellan dessa lägen genom att välja menyalternativet `Projekt - Byt till adminläge' och `Projekt - Byt till användarläge'. I användarläge är flera menyalternativ inaktiverade och struktur-, program- och frågeredigerare är inte tillgängliga. Därför är endast grundläggande postredigering möjlig. I adminläge är alla operationer tillåtna.

Ett adminlösenord kan ställas in för ett projekt genom att välja menyalternativet `Projekt - Ändra adminlösenord'. När det väl är inställt måste lösenordet anges vid byte till adminläge, annars nekas behörighet och projektet förblir i användarläge.

När ett projekt öppnas som har ett adminlösenord inställt, startas projektet i användarläge, annars (inget adminlösenord har ställts in) startas det i adminläge.

6.9 Växla Poster

BeeBase behöver inte hålla alla poster i ett projekt i minnet. Detta gör laddning och sparande av projekt mycket snabbare. När ett projekt laddas allokeras en posthuvud för varje post. Själva datan laddas bara när den behövs, t.ex. när den visas på skärmen. Det totala antalet poster är fortfarande begränsat av tillgängligt minne eftersom varje posthuvud kräver några få byte minne.

Du kan ange hur mycket minne BeeBase ska använda för posterna i ett projekt. Välj ett av de fördefinierade värdena som finns i menyalternativet `Inställningar - Postminne' (se Record memory). BeeBase förallokerar inte ett block av den angivna minnesstorleken, den kontrollerar bara då och då om den aktuella storleken av allokerat minne är större än det angivna värdet.

Om BeeBase får slut på minne eller om den övre gränsen för postminnesstorleken har nåtts försöker BeeBase frigöra så mycket postminne som möjligt. I detta fall kan BeeBase skriva modifierade poster till disk för att få maximalt tillgängligt minne möjligt. Du kan också tvinga BeeBase att göra detta genom att välja menyalternativet `Projekt - Växla poster'.

BeeBase underhåller en frilista för varje postfil. Om du tar bort en post läggs postens filutrymme till i frilistan. Även om du ändrar en post och posten behöver skrivas till disk läggs det gamla fil- utrymmet till frilistan. BeeBase ser dock till att du genom omladdning alltid kan gå tillbaka till punkten för den senaste sparoperationen. BeeBase kommer inte att skriva i områden som är fria men där det fortfarande finns en post som skulle kunna nås genom att öppna projektet på nytt.

6.10 Stänga Projekt

När du är klar med redigeringen av ett projekt kan du stänga det genom att välja menyalternativet `Projekt - Stäng'. Detta frigör minnet och alla resurser som tillhör projektet. Om projektet innehåller ändringar som inte har sparats än visas först en dialogruta som erbjuder att spara, fortsätta eller avbryta operationen.

För att stänga ett projekt kan du också välja menyalternativet `Projekt - Spara & stäng' som sparar projektet först om det fanns några ändringar och sedan stänger det.

This document was generated on September, 6 2025 using texi2html