XIP Importer

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
Import-Quellen

Die Dokumentation bezieht sich auf Version 2.2, für vorherige Versionen kann es Abweichungen geben.

Um externe Daten in den IES zu übernehmen wird der XIP Importer verwendet. Die zu importierenden Daten müssen immer im [XIP Format] vorliegen. Der XIP Importer stellt aber Funktionen bereit um unterschiedliche Datenquellen zunächst in XIP umzuwandeln, bevor sie importiert werden. Für die Umwandlung wird immer XSLT. Da mit XSLT nur XML-Quell-Daten transformiert werden können werden Beispielsweise für den Import aus einer Datenbank das Ergebnis einer SQL-Abfrage vom XIP-Import in ein XML-Format umgewandelt, das anschließen über XSLT in ein beliebiges XIP Format transformiert werden kann.

Folgende Werkzeuge stehen für den XIP Importer zur Verfügung


Synchronisierter Import

Der XIP Importer kann auch dazu verwendet werden regelmäßig Daten zu importieren um z.B. einen Datenabgleich vorzunehmen. Damit bei einem Datenabgleich nicht mehr vorhandene Daten auch gelöscht werde können, kann dem XIP Importer eine Synchronisations-Datei mitgegeben werden. In dieser Datei werden nach jedem Import die Anchor der importierten Elemente gespeichert. Bei jedem Import werden die importierten Daten mit der Anchor-Liste der Synchronisations-Datei abgeglichen und in dem Import nicht vor vorhandene Daten durch den XIP Importer im IES gelöscht.

Import-Quellen

XIP Datei/Verzeichnis Import

Im einfachsten Fall kann ein Verzeichnis oder eine XIP-Datei (gezipptes Verzeichnis mit XIP-Daten) angegeben werden. Die darin enthaltenen Daten im XIP-Format werden dann importiert.

Für den XIP-Import stehen Steuerungs-Parameter zur Verfügung mit denen Einfluss auf den Import genommen werden kann.

CSV Datei Import (in Planung)

Der Import von CSV Daten ist in Planung und steht noch nicht zur Verfügung

Import über HTTP

Der Import von Daten über HTTP erfolgt über die Angabe einer URL und optionalen GET/POST Parametern, bzw frei definiertbaren HTTP-Body-Daten (Die Angabe von HTTP-Headern ist auch möglich). Der HTP-Response muss XML-Daten zurück liefern. Sind diese Daten noch nicht im XIP-Format müssen sie mit Hilfe einer entsprechenden XSLT in dieses Format umgewandelt werden. Mit diesen Daten wird dann der Import durchgeführt.

Bei Angabe der entsprechenden HTTP-Header und Body-Daten ist so auch ein SOAP Request möglich, um Web-Service Schnittstellen anzusprechen.

Der Import von Daten per HTTP ist z.Z. nur über das Kommandozeilen-Werkzeug iesxip möglich, das auf jedem IES-Server ab Version 2.2 zur Verfügung steht. Der Import wird über eine XML-Konfiguration definiert die unter iesxip HTTP beschrieben ist.

Import über Datenbank

Der Import von Daten aus einer Datenbank erfolgt über ein SQL-Statement. Der XIP-Import führt das SQL-Statement aus und wandelt das Ergebnis ein eine einfache XML-Struktur um.

Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<rowset>
   <row>
      <colname1>colvalue1</colname1>
      <colname2>colvalue2</colname2>
      <colname3>colvalue3</colname3>
   </row>
   <row>
      <colname1>colvalue1</colname1>
      <colname2>colvalue2</colname2>
      <colname3>colvalue3</colname3>
   </row>
   ...
</rowset>

Die Tagnamen colname1, colname2 und colname3 entsprechen dem Spaltennamen des SQL Ergebnisses und können z.B. mit dem SQL Schlüsselwort ALIAS in dem SQL-Statement frei definiert werden.

Diese XML-Daten müssen durch XSLT Definitionen in das gewünschte XIP-Format umgewandelt werden. Diese Daten werden dann importiert.

Der Import von Daten per Datenbank ist z.Z. nur über das Kommandozeilen-Werkzeug iesxip möglich, das auf jedem IES-Server ab Version 2.2 zur Verfügung steht. Der Import wird über eine XML-Konfiguration definiert die unter iesxip Datenbank beschrieben ist.

Import über LDAP

Die Verbindung zum LDAP-Server ist in IES-Admin unter dem Bereich LDAP konfiguriert. Diese Verbindung wird zur Abfragen der Nutzerdaten für den Import und für die Authentifizierung der Nutzer verwendet.

Der Import von Daten aus einem LDAP-System Erfolg über eine LDAP-Suche. Da in LDAP-Suchen keine Einschränkung durch LDAP-Gruppen angegeben werden kann bietet der XIP Import zusätzlich diese Möglichkeit. Gruppen-Suchen und LDAP-Suche können dann mit UND und ODER Verknüpfungen kombiniert werden um das gewünschte Ergebnis zu erhalten. Der XIP Import stellt die Suche an das LDAP-System (bzw mehrere Suchen, wenn eine Kombination angegeben wurde) und wandelt das Ergebnis in XML um.

Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<rowset>
   <row>
      <dn>dn 1</dn>
      <fieldname1>fieldvalue1</fieldname1>
      <fieldname2>fieldvalue2</fieldname2>
      <fieldname3>fieldvalue3</fieldname3>
      <group>dn group1</group>
      <group>dn group2</group>
   </row>
   <row>
      <dn>dn 2</dn>
      <fieldname1>fieldvalue1</fieldname1>
      <fieldname2>fieldvalue2</fieldname2>
      <fieldname3>fieldvalue3</fieldname3>
      <group>dn group3</group>
   </row>
   ...
</rowset>

Diese XML-Daten müssen durch XSLT Definitionen in das gewünschte XIP-Format umgewandelt werden. Diese Daten werden dann importiert.

Der Import von Daten per LDAP ist z.Z. nur über das Kommandozeilen-Werkzeug iesxip möglich, das auf jedem IES-Server ab Version 2.2 zur Verfügung steht. Der Import wird über eine XML-Konfiguration definiert die unter iesxip LDAP beschrieben ist.