Difference between revisions of "NL/Documentation/BASIC Guide/Data Sources"

Revision as of 13:13, 31 December 2019

Programmeursgids voor BASIC

{{{parttitle}}}

[[{{{PrevPart}}}|< Vorige deel ]]

[[{{{NextPart}}}|Volgende deel >]]

• De taal van Apache OpenOffice Basic

• Overzicht van een programma in BASIC
• Werken met variabelen
• Tekenreeksen
• Getallen
• Booleaanse waarden
• Datum en tijd
• Arrays
• Bereik en levensduur van variabelen
• Constanten
• Operatoren
• Aftakken
• Loops
• Procedures en functies
• Foutafhandeling
• Andere instructies

• Runtime-bibliotheek

• Functies voor conversie
• Strings (Tekenreeksen)
• Datum en tijd
• Bestanden en mappen
• Bericht- en invoervakken
• Andere functies

• Introductie voor de API

• Universal Network Objects (UNO)
• Eigenschappen en methoden
• Modules, services en interfaces
• Gereedschap voor werken met UNO
• Overzicht van centrale interfaces

• Werken met documenten

• De StarDesktop
• Opmaakprofielen en sjablonen

• Tekstdocumenten

• De structuur van tekstdocumenten
• Tekstdocumenten bewerken
• Meer dan alleen tekst

• Werkbladdocumenten

• De structuur van werkbladdocumenten
  • Rijen en kolommen
  • Cellen en bereiken
  • Werkbladdocumenten opmaken
• Werkbladdoucmenten bewerken

• Tekeningen en presentaties

• De structuur van tekeningen
• Tekenobjecten bewerken
• Presentaties

• Grafieken (Diagrammen)

• Diagrammen gebruiken in werkbladen
• De structuur van diagrammen
• Typen diagram

• Databases

• SQL: een Query-taal
• Typen toegang tot database
• Gegevensbronnen
• Toegang tot database

• Dialoogvensters

• Werken met dialoogvensters
• Eigenschappen
• Gebeurtenissen
• Elementen voor beheer dialoogvenster

• Formulieren

• Werken met formulieren
• Besturingselementen Formulieren
• Database-formulieren

< Vorige pagina

Volgende pagina >

Een database kan worden opgenomen in Apache OpenOffice door een, waar in het algemeen naar wordt verwezen als een gegevensbron, te maken. De gebruikers-interface verschaft een overeenkomende optie voor het maken van Gegevensbronnen in het menu Extra. U kunt echter ook gegevensbronnen maken en daarmee werken met behulp van Apache OpenOffice BASIC.

Een database context-object dat is gemaakt met behulp van de functie createUnoService dient als het startpunt voor toegang tot een gegevensbron. Dit is gebaseerd op de service com.sun.star.sdb.DatabaseContext en is het basisobject voor alle bewerkingen van de database.

Het volgende voorbeeld toont hoe een databasecontext kan worden gemaakt en dan worden gebruikt om te bepalen of alle gegevensbronnen beschikbaar zijn. Het geeft de namen weer in een berichten-venster.

Dim DatabaseContext As Object
Dim Namen
Dim I As Integer
 
DatabaseContext = createUnoService("com.sun.star.sdb.DatabaseContext")
 
Namen = DatabaseContext.getElementNames()
 
For I = 0 To UBound(Namen())
  MsgBox Namen(I)
Next I

De individuele gegevensbronnen zijn gebaseerd op de service com.sun.star.sdb.DataSource en kunnen worden bepaald vanuit de databasecontext met behulp van de methode getByName:

Dim DatabaseContext As Object
Dim GegevensBron As Object
 
DatabaseContext = createUnoService("com.sun.star.sdb.DatabaseContext")
GegevensBron = DatabaseContext.getByName("Klanten")

Het voorbeeld maakt een object DataSource voor een gegevensbron, genaamd Klanten.

Gegevensbronnen verschaffen een scala aan eigenschappen, welke op hun beurt algemene informatie verschaffen over de oorsprong van de gegevens en informatie over hun methoden van toegangs. De eigenschappen zijn:

Name (String)

naam van de gegevensbron

URL (String)

URL van de gegevensbron in de vorm van jdbc: subprotocol : subnaam of sdbc: subprotocol : subnaam

Settings (Array)

array die paren van PropertyValue bevat met parameters voor de verbinding (gewoonlijk ten minste gebruikersnaam en wachtwoord)

User (String)

gebruikersnaam

Password (String)

wachtwoord van gebruiker (wordt niet opgeslagen)

IsPasswordRequired (Boolean)

het wachtwoord is nodig en wordt interactief vereist van de gebruiker

IsReadOnly (Boolean)

staat alleen-lezen toegang tot de database toe

NumberFormatsSupplier (Object)

object dat de getalopmaak, beschikbaar voor de database, bevat (ondersteunt de interface com.sun.star.util.XNumberFormatsSupplier)

TableFilter (Array)

lijst van tabelnamen die moet worden weergegeven

TableTypeFilter (Array)

lijst van tabeltypen die moet worden weergegeven. Beschikbare waarden zijn TABLE, VIEW en SYSTEM TABLE

SuppressVersionColumns (Boolean)

onderdrukt de weergave van kolommen die worden gebruikt voor versiebeheer

De gegevensbronnen van Apache OpenOffice zijn niet 1:1 te vergelijken met gegevensbronnen in ODBC. Waar een gegevensbron in ODBC alleen informatie behandelt over de origine van de gegevens, bevat een gegevensbron in Apache OpenOffice ook een scala aan informatie over hoe de gegevens worden weergegeven binnen de vensters van de database van Apache OpenOffice.

Query's

Vooraf gedefinieerde bevragingen (query's) kunnen worden toegewezen aan gegevensbronnen. Apache OpenOffice noteert de opdrachten in SQL van query's zodat zij altijd beschikbaar zijn. Query's worden gebruikt om het werken met gegevensbronnen te vereenvoudigen omdat zij kunnen worden geopend met één simpele muisklik en verschaffen gebruikers zonder enige kennis van SQL de optie van het gebruik van opdrachten.

Een object dat de service com.sun.star.sdb.QueryDefinition ondersteunt is verborgen achter een query. De query's worden toegankelijk gemaakt door middel van de methode QueryDefinitions van de gegevensbron.

Het volgende voorbeeld somt de namen van de query's van de gegevensbron, die kunnen worden vastgesteld, op in een berichtenvenster.

Dim DatabaseContext As Object
Dim GegevensBron As Object
Dim QueryDefinities As Object
Dim QueryDefinitie As Object
Dim I As Integer
 
DatabaseContext = createUnoService("com.sun.star.sdb.DatabaseContext")
GegevensBron = DatabaseContext.getByName("Klanten")
QueryDefinities = GegevensBron.getQueryDefinitions()
 
For I = 0 To QueryDefinities.Count() - 1
  QueryDefinitie = QueryDefinities(I)
  MsgBox QueryDefinitie.Name
Next I

In aanvulling op de eigenschap Name, gebruikt in het voorbeeld, verschaft de com.sun.star.sdb.QueryDefinition een heel scala aan andere eigenschappen. Deze zijn:

Name (String)

naam van de query

Command (String)

opdracht in SQL (meestal een opdracht SELECT)

Het volgende voorbeeld toont hoe een object query kan worden gemaakt op een programma-gecontroleerde manier en kan worden toegewezen aan een gegevensbron.

Dim DatabaseContext As Object
Dim GegevensBron As Object
Dim QueryDefinities As Object
Dim QueryDefinitie As Object
Dim I As Integer
 
DatabaseContext = createUnoService("com.sun.star.sdb.DatabaseContext")
GegevensBron = DatabaseContext.getByName("Klanten")
QueryDefinities = GegevensBron.getQueryDefinitions()
QueryDefinitie = createUnoService("com.sun.star.sdb.QueryDefinition")
QueryDefinitie.Command = "SELECT * FROM Klanten"
QueryDefinities.insertByName("NieuweQuery", QueryDefinitie)

Het object query wordt eerst gemaakt met behulp van de aanroep createUnoService, dan geïnitialiseerd, en dan ingevoegd in het object QueryDefinities door middel van insertByName.