#DBUPDATE id = "" content-type = "" url = "" sql-statement = "" merge-into = ""#ENDDBUPDATE

#DBUPDATE id = "[Integer]" content-type = "[Zeichenkette]" url = "[Zeichenkette]" sql-statement = "[Zeichenkette]" merge-into = "[Ordner-ID]"#ENDDBUPDATE — Online Datenbankimport

Zweck

Einbindung fremder Inhalte in die VIO.Matrix CIS Datenbank
Zugriff auf lokale oder entfernte Online-Datenbanken

Parameteraufbau: In einem DBUPDATE-Block wird angegeben, welche Daten, in welchem Format, aus welcher Quelle und in welcher Form permanent in die VIO.Matrix Datenbank einzubinden sind. Die importierten Daten werden in den unter merge-into="[Ordner-ID]" angegebenen Ordner der CIS-Onlinedatenbank importiert. VIO.Matrix Content Manager Clients erhalten die hier importierten Ordner und Elemente im Zuge der Veröffentlichung/Abgleich des Webprojektes. Der DBUPDATE-Block erzeugt zusätzlich einen temporären (d.h. nur während der Erzeugung der aktuellen Ausgabe gültigen) Syndication-Ordner, welcher die importierten Daten enthält. Einzelne Datensätze werden in diesem temporären Ordner als Elemente angelegt.

#DBUPDATE [Parameter des DBUPDATE-Blocks] #ENDDBUPDATE

Parameter Pflichtangaben:

id: Angabe einer projektübergreifend eindeutigen Identifikationsnummer (ID), größer Null. Unter der hier vergebenen ID wird ein temporärer Syndicationordner erzeugt. Existiert dieser Ordner bereits im Cache, bspw. weil er von einer anderen Sitzung bereits erzeugt wurde, wird der Inhalt des temporären Ordners in Abhängigkeit der Angabe in revisit-after aktualisiert, d.h. die bisherigen Inhalt des Ordners werden überschrieben bzw. gelöscht.
content-type: Angabe zum Format, in welchem die zu importierenden Daten vorliegen.
url: Angabe zum Ort, der Zugriffsmethode und wahlweise auch Login und Paßwort der zu importierenden Daten
merge-into: Mergeordner - Ordner-ID, in welchen die zu importiernden Daten permanent eingefügt werden sollen.
primary-key-or: Variablenname des Primärschlüssels für Ordner
primary-key-el: Variablenname des Primärschlüssels für Elemente
foreign-key-or: Variablenname des Fremdschlüssels für Ordner
foreign-key-el: Variablenname des Fremdschlüssels für Elemente
new-el-param: Angabe, was mit Elementen geschehen soll, welche sich noch nicht in der CIS-Onlinedatenbank befinden und damit neu eingefügt werden müssen.
new-or-param: Angabe, was mit Ordnern geschehen soll, welche sich noch nicht in der CIS-Onlinedatenbank befinden und damit neu eingefügt werden müssen.
notfound-el-param: Angabe, was mit Elementen geschehen soll, welche sich unterhalb des Mergeordners ausschließlich in der CIS-Onlinedatenbank befinden und nicht in der Importquelle.
notfound-or-param: Angabe, was mit Ordnern geschehen soll, welche sich unterhalb des Mergeordners ausschließlich in der CIS-Onlinedatenbank befinden und nicht in der Importquelle.
vmdb_login: Login für den Zugriff auf die CIS-Onlinedatenbank (xmlupdate-Login)
vmdb_password: Passwort für den Zugriff auf die CIS-Onlinedatenbank (xmlupdate-Passwort)
Die Systemparameter absimgspfad, xmlupdate_ini und xmlupdate_logfile müssen gesetzt sein!

Optionale Parameter:

login: Angabe zum Login, um auf die zu importierenden Daten zugreifen zu können. Das Login kann wahlweise auch innerhalb des Parameters „url" angegeben werden. Die separate Angabe empfiehlt sich, wenn das Login die Zeichen: : , @ oder / enthält.
password: Angabe zum Passwort, um auf die zu importierenden Daten zugreifen zu können. Das Passwort kann wahlweise auch innerhalb des Parameters „url" angegeben werden. Die separate Angabe empfiehlt sich, wenn das Passwort die Zeichen: @ oder / enthält.
import-or-vartypes: Angabe einer Liste von Importvariablen des Syndicationordners und den ihnen zuzuordnenden Variablentypen in der Form [[Importdatenfeldname], [Variablentyp als Zahlwert];].
import-el-vartypes: Angabe einer Liste von Importvariablen der Elemente des Syndicationordners und den ihnen zuzuordnenden Variablentypen in der Form [[Importdatenfeldname], [Variablentyp als Zahlwert];]

Achtung: Beim Mischen von internen und externen Daten kann es erforderlich werden, Datenfelder der importierten Daten umzubenennen. Ist bspw. der Titel interner Neuigkeiten in der Variable „de_titel" gesichert und die zu importierenden Neuigkeiten werden über einen RDF Newsfeed bereitgestellt, dann muß das importierte Datenfeld „title" in „de_titel" umbenannt werden.

or-mapping: Liste umzubenennender Datenfeldnamen in dem Format [[[Importdatenfeldname], [VIO.Matrix Ordnervariablenname]];]
el-mapping: Liste umzubenennender Datenfeldnamen in dem Format [[[Importdatenfeldname], [VIO.Matrix Elementevariablenname]];]Sortieren:
merge-sort-or-var: Angabe eines VIO.Matrix Ordnervariablennamen, nach dem die Sortierung erfolgen soll.
merge-sort-or-type: Angabe der Sortierrichtung: „ascending" für aufsteigende (A-Z) und „descending" für absteigende (Z-A) Sortierung
merge-sort-el-var: Angabe eines VIO.Matrix Elementevariablennamen, nach dem die Sortierung erfolgen soll.
merge-sort-el-type: Angabe der Sortierrichtung: „ascending" für aufsteigende (A-Z) und „descending" für absteigende (Z-A) Sortierung

WICHTIG: Zur Nutzung der DBUPDATE-Funktionalität muss das betreffende Lizenzrecht freigeschaltet werden und der Systemparameter xmlupdate_ini korrekt gesetzt werden.

Beispiel:

Aus einer lokal auf dem Server vorhandenen mySQL-Datenbank "artikel" sollen alle Warengruppen und Artikel in die VIO.Matrix Datenbank importiert. Der Import soll unter den Ordner mit der ID 42 erfolgen. Ordner oder Artikel, die sich zwar in der VIO.Matrix Datenbank befinden aber nicht in der mySQL-Datenbank sollen gelöscht werden. Ordner und Artikel, die sich nicht in der VIO.Matrix Datenbank befinden, sollen vorerst unsichtbar gemacht werden.

Datenbanktabelle (hier als CSV):

DBUPDATE-Block:

Weitere Informationen:

Attribut	Wert	Beschreibung
id = "[1]"	[1]: Integer	Eindeutige Syndication-Id.
content-type = "[1]"	[1]: Zeichenkette	Festlegung des Content-Type für den Syndication-Block: sql/mysql, text/html, rss/rdf, text/csv, application/binary.
url = "[1]"	[1]: Zeichenkette	[Protokoll]://[Login[:Passwort]@][URI] Angabe zum Ort, der Zugriffsmethode und wahlweise auch Login und Paßwort der zu importierenden Daten. Bspw.: "file:///home/users/myfile.csv" oder "mysql://master:password@localhost/mydb"
sql-statement = "[1]"	[1]: Zeichenkette	SQL-Statement, welches an die unter url="" definierte Datenbank übermittelt wird.
merge-into = "[1]"	[1]: Ordner-ID	ID des Ordners, in welchen die importierte Inhalte permanent gesichert werden sollen. Dabei werden bereits in dem Ordner befindliche Ordner und Elemente mit zu importierenden Ordnern und Elementen gemischt, nicht in der Importquelle befindliche Ordner und Elemente werden ggf. gelöscht oder verschoben.
primary-key-or = "[1]"	[1]: Variablenname	Variablenname des Primärschlüssels für Ordner (bspw.: "name"). Der Primärschlüssel identifiziert den Ordner (unterhalb des Mergeordners) eindeutig.
primary-key-el = "[1]"	[1]: Variablenname	Variablenname des Primärschlüssels für Elemente (bspw.: "artnr"). Der Primärschlüssel identifiziert das Element (unterhalb des Mergeordners) eindeutig.
foreign-key-or = "[1]"	[1]: Variablenname	Variablenname des Fremdschlüssels für Ordner (bspw.: "parentor"). Entspricht der Inhalt des Fremdschlüssels dem Inhalt des Primärschlüssels eines anderen Ordners, so wird der Ordner mit dem Fremdschlüssel dem Ordner mit dem passenden Primärschlüssel untergeordnet.
foreign-key-el = "[1]"	[1]: Variablenname	Variablenname des Fremdschlüssels für Elemente (bspw.: "name"). Entspricht der Inhalt des Fremdschlüssels dem Inhalt des Primärschlüssels eines Ordners, so wird das Element mit dem Fremdschlüssel dem Ordner mit dem passenden Primärschlüssel untergeordnet.
new-el-param = "[1]"	[1]: Zeichenkette	Kommagetrennte Angabe, was mit Elementen geschehen soll, welche sich noch nicht in der CIS-Onlinedatenbank befinden und damit neu eingefügt werden müssen: delete: Löschen move-to: [source\|Ordner-ID]: im Importordner belassen (Struktur beibehalten) bzw. in angegebenen Ordner verschieben unvisible: Element unsichtbar machen Beispiel: new-el-param="unvisible,move-to=42"
new-or-param = "[1]"	[1]: Zeichenkette	Kommagetrennte Angabe, was mit Ordnern geschehen soll, welche sich noch nicht in der CIS-Onlinedatenbank befinden und damit neu eingefügt werden müssen: delete: Löschen move-to: [Ordner-ID]: in Ordner verschieben unvisible: Ordner unsichtbar machen Beispiel: new-or-param="unvisible,move-to=42"
notfound-el-param = "[1]"	[1]: Zeichenkette	Angabe, was mit Elementen geschehen soll, welche sich unterhalb des Mergeordners ausschließlich in der CIS-Onlinedatenbank befinden und nicht in der Importquelle: delete: Löschen move-to: [Ordner-ID]: in Ordner verschieben unvisible: Element unsichtbar machen Beispiel: notfound-el-param="delete"
notfound-or-param = "[1]"	[1]: Zeichenkette	Angabe, was mit Ordnern geschehen soll, welche sich unterhalb des Mergeordners ausschließlich in der CIS-Onlinedatenbank befinden und nicht in der Importquelle: delete: Löschen move-to: [Ordner-ID]: in Ordner verschieben unvisible: Ordner unsichtbar machen Beispiel: notfound-or-param="delete"
vmdb_login = "[1]"	[1]: Zeichenkette	Login für den Zugriff auf die CIS-Onlinedatenbank (xmlupdate-Login).
vmdb_password = "[1]"	[1]: Zeichenkette	Passwort für den Zugriff auf die CIS-Onlinedatenbank (xmlupdate-Passwort).
login = "[1]"	[1]: Zeichenkette	Angabe zum Login, um auf die zu importierenden Daten zugreifen zu können. Das Login kann wahlweise auch innerhalb des Parameters „url" angegeben werden. Die separate Angabe empfiehlt sich, wenn das Login die Zeichen: : , @ oder / enthält.
password = "[1]"	[1]: Zeichenkette	Angabe zum Passwort, um auf die zu importierenden Daten zugreifen zu können. Das Passwort kann wahlweise auch innerhalb des Parameters „url" angegeben werden. Die separate Angabe empfiehlt sich, wenn das Passwort die Zeichen: @ oder / enthält.
http-header = "[1]"	[1]: Zeichenkette	Enthält optional einen HTTP-Header, welcher - bei Nutzung des Content-Type "text/html" an den angegebenen Server gesendet werden soll. Wird kein http-header angegeben, wird ein Standard-HTTP-Header gesendet.
http-method = "[1]"	[1]: get \| post	Angabe der HTTP-Request-Methode: "get" oder "post", Standardmethode ist "get"
http-post-data = "[1]"	[1]: Zeichenkette	Angabe der an den Server zu sendenden Daten bei Verwendung der HTTP-Methode "post".
import-or-vartypes = "[1]"	[1]: Zeichenkette	Angabe einer Liste von Importvariablen des Syndicationordners und den ihnen zuzuordnenden Variablentypen in der Form [[Importdatenfeldname], [Variablentyp als Zahlwert];]. Beispiel: "bezeichnung,100;name,100"
import-el-vartypes = "[1]"	[1]: Zeichenkette	Angabe einer Liste von Importvariablen der Elemente des Syndicationordners und den ihnen zuzuordnenden Variablentypen in der Form [[Importdatenfeldname], [Variablentyp als Zahlwert];]. Beispiel: "artnr,100;bezeichnung,100;name,100;price,202"
unique-session = "[1]"	[1]: Zeichenkette	Angabe der alphanumerischen Sitzungs-ID - die Resultate der Content-Syndication sind dann nur für diese Sitzung zugänglich.
or-mapping = "[1]"	[1]: Zeichenkette	Liste umzubenennender Datenfeldnamen in dem Format: [[[Importdatenfeldname], [VIO.Matrix Ordnervariablenname]];] Beispiel: "bezeichnung,de_grtitel"
el-mapping = "[1]"	[1]: Zeichenkette	Liste umzubenennender Datenfeldnamen in dem Format: [[[Importdatenfeldname], [VIO.Matrix Elementevariablenname]];] Beispiel: "bezeichnung,de_titel;price,_pe"
merge-sort-or-var = "[1]"	[1]: Variablenname	Angabe eines VIO.Matrix Ordnervariablennamen, nach dem die Sortierung erfolgen soll.
merge-sort-el-var = "[1]"	[1]: Variablenname	Angabe eines VIO.Matrix Elementevariablennamen, nach dem die Sortierung erfolgen soll.
merge-sort-or-type = "[1]"	[1]: ascending \| descending	Angabe der Sortierrichtung: „ascending" für aufsteigende (A-Z) und „descending" für absteigende (Z-A) Sortierung importierter Ordner.
merge-sort-el-type = "[1]"	[1]: ascending \| descending	Angabe der Sortierrichtung: „ascending" für aufsteigende (A-Z) und „descending" für absteigende (Z-A) Sortierung importierter Elemente.
csv_separator = "[1]"	[1]: Trennzeichen	CSV-Trennzeichen: Angabe eines Trennzeichens zur Unterscheidung verschiedener Spalten. Standard: ";" (Semikolon)
csv_itemtype = "[1]"	[1]: element \| ordner	Art der CSV-Zeilen: Die Zeilen der CSV können als Elemente ("element", Standard) oder als Ordner ("ordner") importiert werden.