51
02/2016 ·
MIDRANGE
MAGAZIN
CLICK TO
Der vollständige Artikel steht Abonnenten
des TechKnowLetters online zur Verfügung.
Hohe Komplexität beim Import
XML-Import-Funktionen
in Domino
In einer der vorangegangenen Ausgaben haben wir die Grundlagen und die Export-
Funktionen von XML und Domino erläutert. Ergänzend zu diesem Artikel beschäftigen
wir uns nun mit den Import-Funktionen von XML in Domino.
D
as Gegenstück zur Export-Klasse
stellt die Import-Klasse (NotexDX-
LImporter) dar.
Wie die Export-Funktionen sind
auch die Import-Funktionen von XML
in Domino über eigene Klassen abgebil-
det. Vergleicht man die beiden Klassen,
fällt auf, dass die Import-Klasse gene-
rell wesentlich komplexer ist als die
Export-Klasse. Der Grund dafür liegt
in den zahlreichen unterschiedlichen
Varianten, mit denen Informationen
in Domino importiert werden können.
Alle Domino-relevanten Informationen
– Datenbank, Eigenschaften, ACLs, De-
signelemente und nicht zuletzt Daten
– müssen bei einem Importvorgang
berücksichtigt werden. Einige dieser
Informationen können über Parameter
definiert werden, die für mehrere Be-
reiche genutzt werden können.
Die Import-Klasse verfügt darüber
hinaus über einige Eigenschaften, die
für jeden Importvorgang einzeln be-
trachtet werden sollten. Im Nachfolgen-
den werden diese Eigenschaften kurz
beschrieben. Bevor wir uns die einzel-
nen Eigenschaften aber näher anschau-
en, sehen wir uns zunächst die unter-
schiedlichen Parameterwerte an, die
für eine Vielzahl der Eigenschaften ver-
wendet werden können: siehe Tabelle.
Die Optionen in dieser Tabelle wer-
den in den nachfolgenden Beschreibun-
gen mehrfach verwendet. Achten Sie
bei der Verwendung der Optionsnum-
mern bitte darauf, dass diese bei der
Programmierung nicht als Textstring
und nicht als Zahlen angegeben
werden!
ACLImportOption
Mit XML können bei Bedarf ACL-Infor-
mationen in Domino eingestellt wer-
den. Dies ist allerdings nicht in jedem
Fall sinnvoll, denn mit diesem Verfah-
ren können die Sicherheitseinstellun-
gen von Notes umgangen werden. Des-
halb sollte sehr genau überlegt werden,
ob Aktualisierungen der Daten und
Anwendungen in diesem Bereich durch
XML-Importe wirklich sinnvoll sind.
Für die Verwendung dieser Eigen-
schaften können die in Tabelle 1 ange-
gebenen Parameter 1, 5, 9 und 10 ver-
wendet werden:
ó
DXLIMPORTOPTION_IGNORE (1)
–– Default-Einstellung
–– ACL-Einstellungen von DXL werden
komplett ignoriert und die Einstel-
lungen der Domino-Datenbank ge-
nutzt.
Jörg Zeig
ó
Op.Nr. Option
Beschreibung
1 DXLIMPORTOPTION_
IGNORE
Ignoriert die Informationen und nutzt bereits
vorhandene Einträge in der Datenbank.
2 DXLIMPORTOTION_CREATE Erzeugt neue Informationen im Zielsystem.
Bereits bestehende Informationen bleiben unverändert.
3 nicht verwendet
4 nicht verwendet
5 DXLIMPORTOPTION_
REPLACE_ELSE_IGNORE
Überschreibt vorhandene Informationen.
6 DXLIMPORTOPTION_
REPLACE_ELSE_CREATE
Ersetzt bestehende Informationen und erzeugt
bei Bedarf aus dem XML-Dokument neue Einträge
in der Datenbank.
7 nicht verwendet
8 nicht verwendet
9 DXLIMPORTOPTION_
UPDATE_ELSE_IGNORE
Bestehende Informationen werden aktualisiert.
Existiert kein Eintrag zu den XML-Informationen,
werden diese ignoriert.
10 DXLIMPORTOPTION_
UPDATE_ELSE_CREATE
Bestehende Informationen werden aktualisiert
und bei Bedarf werden neue Einträge mit den
XML-Informationen erstellt.
