LibreOffice 25.8 Hjælp
Tjenesten Base giver et antal metoder og egenskaber, der letter administration og håndtering af LibreOffice Base-dokumenter.
Denne tjeneste er nært relateret til tjenesten Document, som giver generiske metoder til at håndtere LibreOffice-dokumenter, herunder Base-dokumenter. Derfor udvider tjenesten Base tjenesten Document og giver yderligere metoder, der er specifikke for Base-dokumenter og lader brugerne:
Få adgang til databasen, der er indeholdt i et Base-dokument.
Åbne formular-dokumenter, der er gemt i et Base-dokument.
Tjekke om et formulardokument fra et Base-dokument aktuelt er indlæst.
Se tjenesten Document for at få mere at vide om metoder og egenskaber, der kan bruges til at administrere LibreOffice-dokumenter.
Før brug af tjenesten Base skal biblioteket ScriptForge være indlæst eller importeret:
Tjenesten Base kan kaldes på forskellige måder. Kodestumpen herunder bruger metoden CreateBaseDocument i tjenesten UI til at oprette en ny Base-fil.
Bemærk, at i alle eksempler er objektet oDoc en instans af tjenesten Base.
    Dim ui As Object, oDoc As Object
    Set ui = CreateScriptService("UI")
    Set oDoc = ui.CreateBaseDocument("C:\Documents\MyFile.odb")
  TjenestenBase og kan instantieres under åbningen af en eksisterende Base-fil, som vist herunder:
    Set oDoc = ui.OpenBaseDocument("C:\Documents\MyFile.odb")
  Hvis et Base-dokument allerede er åbent, er det muligt at instantiere tjenesten CBase direkte:
    Dim oDoc As Object
    Set oDoc = CreateScriptService("SFDocuments.Document", "MyFile.odb")
  Eksemplerne ovenfor kan oversættes til Python på denne måde:
    from scriptforge import CreateScriptService
    ui = CreateScriptService("UI")
    doc = ui.CreateBaseDocument(r"C:\Documents\MyFile.odb")
  
    doc = ui.OpenBaseDocument(r"C:\Documents\MyFile.odb")
  
    doc = CreateScriptService("SFDocuments.Document", "MyFile.odb")
  Brugen af delstrengen "SFDocuments." i det foregående eksempel er valgfri.
| Liste over metoder i tjenesten Base | ||
|---|---|---|
Lukker det givne formulardokument. Returnerer True (sand), hvis lukningen lykkes.
Metoden CloseFormDocument er udfaset siden LibreOffice 7.6. Selv om den stadig er tilgængelig, kan den bliver fjernet fra Base-tjenesten i en fremtidig udgivelse. Brug i stedet CloseDocument-metoden fra FormDocument-tjenesten.
svc.CloseFormDocument(formdocument: str): bool
formulardokument: Navnet på det FormDocument (formulardokument), der skal lukkes, som en streng med skelnen mellem store og små bogstaver.
Hvis formulardokumenter er organiserede i mapper, er det nødvendigt at medtage mappenavnet for at angive det formulardokument, der skal åbnes, som vist i de følgende eksempler:
    oDoc.CloseFormDocument("Folder1/myFormDocument")
  
    doc.CloseFormDocument('Folder1/myFormDocument')
  Returnerer en matrix med det fulde navn (sti/navn) på alle formulardokumenter i Base-dokumentet som en nul-baseret streng-matrix.
svc.FormDocuments(): str[0..*]
Kodestumpen herunder udskriver navnene på alle formular-dokumenter i det aktuelle Base-dokument.
    Dim oDoc as Object, myForms as Object, formName as String
    Set oDoc = CreateScriptService("Document", ThisDataBaseDocument)
    Set myForms = oDoc.FormDocuments()
    For Each formName In myForms
        MsgBox formName
    Next formName
  
    bas = CreateScriptService("Basic")
    doc = CreateScriptService("Document", bas.ThisDataBaseDocument)
    myForms = doc.FormDocuments()
    for formName in myForms:
        bas.MsgBox(formName)
  For at lære mere om formulardokumenter, se hjælpesiden ScriptForge.FormDocument-tjeneste.
Afhængig af de givne parametere returnerer denne metode:
En nul-baseret matrix med navnene på alle formularer i et formulardokument (hvis argumentet Form mangler)
Et SFDocuments.Form-objekt, der repræsenterer den formular, der er angivet i argumentet Form.
Metoden Forms er udfaset siden LibreOffice 7.6. Selv om den stadig er tilgængelig, kan den blive fjernet fra Base-tjenesten i en fremtidig udgivelse. Brug i stedet Forms-metoden fra FormDocument-tjenesten.
svc.Forms(formdocument: str): str[0..*]
svc.Forms(formdocument: str, form: str = ''): svc
svc.Forms(formdocument: str, form: int): svc
formulardokument: Navnet på et gyldigt formulardokument som en streng med skelnen mellem store og små bogstaver.
formular: Navnet eller indeksnummeret på formularen, der er gemt i formulardokumentet. Hvis dette argument mangler, returnerer metoden en liste med navne på alle formularer, der er tilgængelige i formulardokumentet.
Selv om det er muligt at bruge indekstal til at henvise til formularer, anbefales dette kun, når der kun er en formular i formulardokumentet. Hvis der er to eller flere formularer, må det foretrækkes at bruge formularnavnet i stedet.
Den første linje i eksemplet herunder returnerer en liste over alle formularer i formulardokumentet "myFormDocument". Den anden linje returnerer et eksemplar af tjenesten Formular, der repræsenterer formularen "myForm".
    Dim formsList as Object : formsList = oDoc.Forms("myFormDocument")
    Dim oForm as Object : oForm = oDoc.Forms("myFormDocument", "myForm")
  
    formsList = doc.Forms("myFormDocument")
    form = doc.Forms("myFormDocument", "myForm")
  Returnerer en forekomdt af tjenesten Database, der på databasen tillader udførelsen af SQL-kommandoer, der er defineret og/eller gemt i det aktuelle Base-dokument
svc.GetDatabase(user: str = '', password: str = ''): svc
bruger, adgangskode: Valgfrie adgangsparametre som strenge. Standardværdien for begge parametre er en tom streng "".
    Dim myDoc As Object, myDatabase As Object, ui As Object
    Set ui = CreateScriptService("UI")
    Set myDoc = ui.OpenBaseDocument("C:\Documents\myDb.odb")
    ' Bruger og adgangskode anføres herunder, om nødvendigt
    Set myDatabase = myDoc.GetDatabase()
    '   ... Kør forespørgsler, SQL-sætninger, ...
    myDatabase.CloseDatabase()
    myDoc.CloseDocument()
  
    ui = CreateScriptService("UI")
    myDoc = ui.OpenBaseDocument(r"C:\Documents\myDb.odb")
    myDatabase = myDoc.GetDatabase()
    #   ... Udfør forespørgsler, SQL-udtryk, ...
    myDatabase.CloseDatabase()
    myDoc.CloseDocument()
  Returner True (sand), hvis det angivne FormDocument aktuelt er åbent.
svc.IsLoaded(formdocument: str): bool
formulardokument: Navnet på et Formulardokument, der skal tjekkes, som en en streng med skelnen mellem store og små bogstaver.
    If Not oDoc.IsLoaded("myFormDocument") Then
        oDoc.OpenFormDocument("myFormDocument")
    End If
  
    if not doc.IsLoaded("myFormDocument"):
        doc.OpenFormDocument("myFormDocument")
  Åbner det angivne FormDocument i enten normaltilstand eller designtilstand. Denne metode returnerer en FormDocument-tjenesteinstans, som svarer til den angivne formulardokument.
Hvis formulardokumentet allerede er åbent, bliver det aktiveret uden at dets tilstand ændres.
Hvis det angivne formulardokument ikke eksisterer, bliver Nothing returneret.
svc.OpenFormDocument(formdocument: str, designmode: bool = False): svc
Formulardokument: Navnet på det Formulardokument, der skal åbnes, som en streng med skelnen mellem store og små bogstaver.
designtilstand: Hvis dette argument er True (sand) åbnes FormDocument i designtilstand.
De fleste formulardokumenter gemmes i roden af Base-dokumentet og de kan åbnes ved simpelthen at bruges deres navne, som i eksemplet herunder:
    Dim oFormDoc As Object
    oFormDoc = oDoc.OpenFormDocument("myFormDocument")
  Hvis formulardokumenter er organiseret i mapper, bliver det nødvendigt at medtage mappenavnet til at angive det formulardokument, der skal åbnes, som illustreret i det følgende eksempel:
    oFormDoc = oDoc.OpenFormDocument("myFolder/myFormDocument")
  
    formDoc = doc.OpenFormDocument("myFormDocument")
  
    formDoc = doc.OpenFormDocument("myFolder/myFormDocument")
  Åbner datavisnings-vinduet for den angivne forespørgsel, og returnerer en instans af Datasheet-tjenesten.
Forespørgslen kan åbnes i enten normaltilstand eller designtilstand.
Hvis forespørgslen allerede er åben, bliver dens datavisnings-vindue gjort aktivt.
Lukning af Base-dokumentet gør, at datavisnings-vinduet også lukkes.
svc.OpenQuery(queryname: str, designmode: bool = False): obj
queryname: Navnet på en eksisterende forespørgsel som en streng, hvor der skelnes mellem store og små bogstaver.
designmode: Hvis dette argument er sat til True, bliver forespørgslen åbnet i designtilstand. Ellers åbnes den i normaltilstand (standard = False).
      oDoc.OpenQuery("MyQuery", DesignMode := True)
    
      doc.OpenQuery("MyQuery", designmode=True)
    Åbner datavisnings-vinduet for den angivne tabel og returnerer en instans af Datasheet-tjenesten.
Tabellen kan åbnes i normaltilstand eller designtilstand.
Hvis tabellen allerede er åben, vil dens datavisnings-vindue blive gjort aktivt.
Lukning af Base-dokumentet gør, at datavisnings-vinduet også lukkes.
svc.OpenTable(tablename: str, designmode: bool = False): obj
tablename: Navnet på en eksisterende tabel som en streng, med forskel på store og små bogstaver.
designmode: Hvis dette argument er sat til True, bliver tabellen åbnet i designtilstand. Ellers bliver den åbnet i normaltilstand (standard = False).
      oDoc.OpenTable("MyTable", DesignMode = False)
    
      doc.OpenTable("MyTable", designmode=False)
    Denne metoder sender indholdet af det givne formulardokument til en standardprinter eller en printer, der er defineret med metoden SetPrinter() (sæt_printer).
Returnerer True (sand), hvis dokumentet blev printet med succes.
Metoden PrintOut er udfaset siden LibreOffice 7.6. Selv om den stadig er tilgængelig, kan den blive fjernet fra Base-tjenesten i en fremtidig udgivelse. Brug PrintOut-metoden fra FormDocument-tjenesten i stedet.
svc.PrintOut(opt formdocument: str, pages: str = "", copies: num = 1): bool
formulardokument: Et gyldigt dokumentformularnavn som en streng med forskel på store og små bogstaver. Formulardokumentet skal være åbent. Det aktiveres af metoden.
sider: De sider, der skal printes, som en streng, ligesom i brugerfladen, Eksempel: "1-4;10;15-18". Standard er alle sider.
kopier: Antallet af kopier. Standard er 1.
    If oDoc.PrintOut("myForm", "1-4;10;15-18", Copies := 2) Then
        ' ...
    End If
  
    if doc.PrintOut('myForm', copies=3, pages='45-88'):
        # ...
  Definér printerindstillingerne for et formulardokument. Formulardokumentet skal være åbent.
Returnerer True (sand), når den lykkes.
Metoden SetPrinter er udfaset siden LibreOffice 7.6. Selv om den stadig er tilgængelig, kan den blive fjernet fra Base-tjenesten i en fremtidig udgivelse. Brug SetPrinter-metoden fra Document-tjenesten i stedet.
svc.SetPrinter(opt formdocument: str, opt printer: str, opt orientation: str, paperformat: str): bool
formulardokument: Et gyldigt dokumentformularnavn som en streng med forskel på store og små bogstaver.
    oDoc.SetPrinter("myForm", Orientation := "PORTRAIT")
  
    doc.SetPrinter('myForm', paperformat='TABLOID')