This page is also available in

Dokumentation

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

[ << ]

[ >> ]

[Top]

[Contents]

[Index]

[ ? ]

13. Import och Export

För att dela dina poster med andra databaser erbjuder BeeBase ett sätt att importera och exportera poster från och till andra databaser. Import och export görs genom att läsa och skriva textfiler. Textfilerna måste följa ett särskilt format som beskrivs i nästa avsnitt.

13.1 File format		Hur formatet ser ut.
13.2 Sample import file		Ett exempel.
13.3 Importing records		Hur man importerar poster.
13.4 Exporting records		Hur man exporterar poster.

13.1 Filformat

För att importera poster till BeeBase bör alla poster i en tabell vara i en enda textfil. Om poster från flera tabeller ska importeras bör de vara i separata importfiler, en för varje tabell.

En importfil består av rader och kolumner. Rader är separerade av en postavgränsare, kolumner av en fältavgränsare. Avgränsarna kan anges i import- och exportdialogen. Eftersom ett postfält i sig kan innehålla en sådan avgränsare, kan dubbla citattecken användas runt alla fält för att undanta avgränsare.

Importfilen bör ha följande struktur:

Den första raden innehåller fältnamnen. För varje namn måste tabellen där posterna importeras till innehålla ett fält med exakt samma namn. Om inget matchande fält hittas för ett givet namn, misslyckas importen med ett felmeddelande.
De följande raderna innehåller en post var. Eftersom alla fält anges som strängar, konverteras de automatiskt till destinationsfältets typ. För fält av typen boolesk måste fältet vara antingen NIL eller TRUE (skiftlägesokänsligt), annars genereras ett felmeddelande. För fält av typen val måste den exakta etikettsträngen anges (skiftlägeskänsligt). För referensfält måste postnumret som börjar med 1 anges. För alla andra typer används ett värde av NIL om fältet inte kan konverteras till den erforderliga typen.
Om du bestämmer dig för att använda dubbla citattecken måste alla postfält inklusive raden som innehåller fältnamnen omges av dubbla citattecken.

13.2 Exempel på Importfil

Följande exempel på importfil använder \n och \t för post- och fältavgränsare och dubbla citattecken runt alla fält. Filen kan importeras till en tabell med följande fält:

Namn (sträng)
AntalBarn (heltal)
Kvinnlig (boolesk)
Jobb (val)
Anteckningar (memo)


"Namn"	"AntalBarn"	"Kvinnlig"	"Jobb"	"Anteckningar"
"Janet Jackson"	"???"	"TRUE"	"Musiker"	"Senaste CD: The velvet rope"
"Bernt Schiele"	"???"	"NIL"	"Forskare"	"Forskningsintressen:
Robotik, Autonomi och Datorseende"
"Gerhard"	"0"	"NIL"	"Finmekaniker"	""

13.3 Importera Poster

För att importera poster till den aktiva tabellen, välj menyalternativet `Tabell - Importera poster'. Detta öppnar ett fönster som innehåller

ett strängfält för att ange importfilnamnet. Till höger om detta fält hittar du tre knappar. Klicka på den första för att öppna en fildialog för att välja filnamnet. Den andra knappen startar en extern visare med det angivna filnamnet medan den tredje knappen startar en redigerare för att redigera filens innehåll.
två strängfält för att ange post- och fältavgränsare. Du kan ange ett enstaka tecken eller en escape-kod genom att skriva \n, \t, \f, \??? (oktal kod), eller \x?? (hexadecimal kod). Avgränsningstecken måste vara 7-bitars ASCII-tecken (från \x01 till och med \x7F).
ett fält `Dubbla citattecken' som kan markeras för att ange att fälten omges av dubbla citattecken.
ett fält `Skriv över poster' som, om det väljs, skriver över befintliga poster med importerad data. Detta kan vara användbart om du vill behålla de befintliga posterna (t.ex. eftersom det finns referenser till dem) men uppdatera dem med ny information.
två knappar `Importera' och `Avbryt' för att lämna fönstret.

Om du trycker på knappen `Importera' kommer BeeBase att ladda den angivna filen och importera alla hittade poster. Om allt gick bra och nya poster skapades i tabellen, frågar BeeBase efter importprocessen om du verkligen vill lägga till de nyligen importerade posterna till tabellen. Vid denna tidpunkt kan du fortfarande avbryta åtgärden. Överskrivna poster kan dock endast återställas genom att återgå till projektet.

Om ett fel uppstår vid läsning av importfilen visas ett fel- meddelande.

Om du behöver en mer sofistikerad importrutin rekommenderas att skriva din egen importrutin som ett BeeBase-program.

13.4 Exportera Poster

För att exportera poster från den aktiva tabellen, välj menyalternativet `Tabell - Exportera poster'. Detta öppnar ett fönster som innehåller

ett strängfält för att ange exportfilnamnet. Till höger om detta fält hittar du en popup-knapp för att öppna en fildialog för att välja filnamnet.
två strängfält för att ange post- och fältavgränsare. Du kan ange ett enstaka tecken eller en escape-kod genom att skriva \n, \t, \f, \??? (oktal kod), eller \x?? (hexadecimal kod).
ett fält `Dubbla citattecken' som kan markeras för att ange att fälten ska omges av dubbla citattecken.
ett fält `Filter'. Om markerat skrivs endast de poster som matchar det för närvarande installerade postfiltret till exportfilen.
två knappar `Exportera' och `Avbryt' för att lämna fönstret.

Efter att du tryckt på knappen `Exportera' kommer BeeBase att öppna den angivna filen och skriva ut posterna inklusive en rubrikrad som innehåller fältnamnen. Exportfunktionen skriver alltid alla fält i en tabell till exportfilen.

För en mer anpassad exportrutin kan du använda BeeBase frågeredigerare (se Data retrieval) eller så skriver du din egen exportfunktion som ett BeeBase-program.