Sprich mit mir

Fütterungszeit

Applikationen per Skript zu bedienen, erweist sich vor allem beim Import von Daten nützlich. Im Beispiel aus Listing 1 erstellt ein Skript aus Daten eine Rechnung in KSpread. Der Einfachheit halber kommen die Daten hier aus einem Array. In der Praxis dienen eher Datenbanken, Text-Dateien oder sogar Geräte-Dateien als Quellen.

#!/usr/bin/python
import pcop
import pydcop
import sys
products= [
("Server", 3000, 1 ),
("Workstation", 2000, 3 ),
("Flachbildschirme", 240, 4 )
]
app = pydcop.anyAppCalled("kspread")
if not app:
  print "KSpread läuft nicht!"
  sys.exit(-1)
table = app.default.getViews()[0].table()
curRow = 1;
table.cell(1, curRow).setText("Bezeichnung")
table.cell(2, curRow).setText("Preis")
table.cell(3, curRow).setText("Anzahl")
table.cell(4, curRow).setText("Ges. Preis")
for i in range(5):
  table.cell(i, curRow).setTextFontBold(True)
for product in products:
  curRow = curRow+1
  table.cell(1, curRow).setText(product[0])
  table.cell(2, curRow).setValue(product[1])
  table.cell(3, curRow).setValue(product[2])
  totalCell = table.cell(4, curRow)
  totalCell.setText("=C%i*B%i"%(curRow,curRow))
curRow = curRow+1
table.cell(1, curRow).setText("Gesamt")
table.cell(4, curRow).setText("=SUM(D2:D%s)"%(curRow-1))
for i in range(5):
  table.cell(i, curRow).setTextFontBold(True)

Das Skript definiert zunächst den Array products. Er enthält die Artikel sowie deren Preis und die Stückzahlen. Dann beginnt die Suche nach einer aktiven KSpread-Instanz. Zeile 19 holt sich im Erfolgsfall die Tabelle der ersten Ansicht.

Die Zeilen 23 bis 26 füllen die erste Zeile mit Spaltenüberschriften, Zeile 29 formatiert den Text fett. Damit KSpread die übergebenen Werte als Zahlen akzeptiert, müssen sie per setValue() gesetzt sein. Formeln, wie die zum Berechnen der Gesamtpreise, werden jedoch per setText() übergeben.

Über die View-Schnittstelle von KSpread wählt der Programmierer bestimmte Bereiche eines Tabellendokuments aus. Listing 2 zeigt ein Beispiel, in dem mehrere Zellen ausgewählt werden und per setSelectionBgColor einen blauen Hintergrund erhalten.

#!/usr/bin/python
import pcop
import pydcop
app = pydcop.anyAppCalled("kspread")
view = app.default.getViews()[0]
view.setSelection(( 2, 2, 4, 6 ))
view.setSelectionBgColor((100, 100, 240))

KWord

In der Textverarbeitung KWord lassen sich Dokumente per Skript komplett formatieren. KWord arbeitet grundsätzlich mit Rahmen und ähnelt somit eher einem Layout-Programm. Daraus folgt auch, dass es nicht direkt möglich ist, in ein Dokument zu schreiben. Vielmehr muss der Programmierer einen Rahmen angeben, in den er sein Skript hineinschreiben lässt.

Listing 3 zeigt, wie dabei vorzugehen ist. Zunächst holt das Programm ein gültiges Dokument von der ersten gefundenen KWord-Instanz (Zeile 6). Das Skript geht davon aus, dass es in der ausgewählten Vorlage mindestens einen Rahmen gibt. Diesen wäht es aus allen vorhandenen Rahmen aus (Zeile 8).

#!/usr/bin/python
import pcop
import pydcop
res = pydcop.anyAppCalled("kword").default.getDocuments()
document = res[0]
document.textFrameSet(0).startEditing()
edit.insertText("Linux")
edit.setBold(True)
edit.insertText("User")
edit.setBold(False)
edit.newParagraph()
edit.insertText("Hallo Welt!");
edit.moveCursorUp(False);
document.saveAs("/home/danimo/documents/mydocument.kwd")

Die Funktion startEditing() erlaubt den Zugriff auf die eigentliche Textschnittstelle. Textformatierungen lassen sich beliebig ein- und ausschalten, neue Absätze hinzufügen (Zeile 15) und vieles mehr. Mit den Cursormethoden bewegt sich der Programmierer im Text hin und her. Diese Methoden erwarten einen Wahrheitswert als Argument. Ist er True, wählt KWord bei der Bewegung den Bereich aus, äquivalent zum Drücken der Shift-Taste bei der Navigation mit der Tastatur. Der Aufruf document.saveAs() in Zeile 18 speichert die Datei am gewünschten Ort ab.

Auf diese Weise lassen sich Serienbriefe aus allen möglichen Datenqellen erstellen. Der Programmierer ist dann nicht mehr auf die von KWord zur Verfügung gestellten Quellen beschränkt.

Alle KOffice-Programme speichern die Daten des Dokumentenerstellers als Meta-Informationen im Dokument mit ab. Um diese Meta-Informationen zu ändern, gibt es mehrere DCOP-Methoden innerhalb der Dokumentenschnittstelle. Mit ihnen lässt sich ganz einfach etwa ein Anonymisierskript schreiben:

import pcop
import pydcop
document = pydcop.anyAppCalled("kword").default.getDocuments()[0]
document.setDocumentInfoAuthorName("")
document.setDocumentInfoEmail("")
document.setDocumentInfoCompanyName("")