XML-Schnittstelle

Schema

i-mpuls JMD bietet eine XML-Schnittstelle für den Datenimport und -export. Diese ist durch ein XML-Schema definiert: Die aktuelle Version des XML-Schemas im XSD-Format finden Sie in bei den Dokumenten (XSD = XML-Schema-Definition).

Export

In der Fallaktenübersicht können einzelne und auch Bündel von Akten markiert und dann exportiert werden.

In Vorbereitung: Eine Maske, die in einem Zwischenschritt die Bereiche der Fallakte auswählen läßt, die exportiert werden sollen, z.B. die Kontaktdaten.

Import

Über den Menüpunkt Import können Fallakten importiert werden. Es ist möglich, Bündel von XML-Akten zu importieren.

Jede XML-Fallakte besitzt eine eindeutige Kennung (UUID), über die Bezug zu bereits existenten Akten genommen wird. Wird eine Akte mit dieser Kennung gefunden, wird die Bestandsakte mit den Feldern aus der importierten Akte aktualisiert. Ansonsten wird sie neu angelegt.

Schnittstelle zu externen Systemen

Für i-mpuls JMD selbst dienen die XML-Dokumente der nachvollziehbaren Abbildung der Felder der Web-Oberfläche hin zu den Feldern in die Datenbank.

Allgemein: Die Strukturen und Schnittstellen anderer Systeme sind für i-mpuls JMD nicht vorhersehbar.

Konkret: Der Unterstützung des Mitarbeiter/Mitarbeiterinnen wird von unterschiedlichen Programmen unterschiedlich umgesetzt:

Der Workflow sieht anders aus.
Datenfelder sind anders modelliert (z.B. Adressfelder)
Es gibt in einem System Felder, die im anderen fehlen und umgekehrt.

Konsequenz: Die Daten müssen transformiert werden.

Daten-Transformation

Von externer Quelle zu i-mpuls JMD:

i-mpuls JMD definiert seine Schnittstelle mithilfe von XML-Schema im XSD-Format (siehe Dokumente, weitere Infos hier Schema)
Ein XML-Schema ist eine Grammatik, in der festgelegt wird, welche Konstrukte lexikalisch und syntaktisch erkannt werden.
Die Semantik der Konstrukte wird über Schema-Annotationen definiert.
- Hier ist festgelegt, welcher Punkt in der Web-Oberfläche mit welchem Feld in der XML-Datei korrespondiert.

Beispiel: Das Konstrukt <vorname>Christa</vorname> wird als Textfeld erkannt. Gemeint ist der Vorname der Case-Managerin bzw. des Case-Managers in der Sektion "Zuständigkeiten, Eingangsdaten".

Von i-mpuls JMD zu einem externen Format:

i-mpuls JMD schreibt die Daten entsprechend des Schemas.
Den externen Programmen wird die Interpretation überlassen.

Transformation zwischen den Versionen 1.0.3 und 1.1.

Wir bieten eine XSL-Transformation an, mit der Sie ihre bisher generierten XML-Daten der i-mpuls JMD - Offline Version in das neue Format der Version 1.1 überführen können. Abhängig von Ihrer Prozesskette können Sie die Transformation ggf. übernehmen oder als letzten Schritt vor dem Import manuell durchführen:

Laden Sie das Konvertierungswerkzeug herunter, und speichern es im gleichen Verzeichnis/Ordner, wo auch Ihre Fallakten liegen.
- Konvertierung 1.0.3. zu 1.1.: jmd-convert-1.0.3-1.1.xsl | Stand 20.06.2011 | Dateigröße: 3kb
Laden Sie das Werkzeug zur Durchführung der Transformation herunter und speichern es im ebenfalls gleichen Verzeichnis/Ordner, wo Ihre Fallakten liegen.
- msxsl.exe
Bitte machen Sie sich eine Sicherungskopie der "alten" Fallakte(n) in einem eigenen Ordner z.B. "Archiv".
Bitte achten Sie darauf, dass die Dateinamen Ihrer Akten folgende Kriterien erfüllen:
- Keine Leerzeichen im Dateinamen, besser z.B. mit Unterstrich verbinden
- Keine Umlaute im Dateinamen, besser ohne Umlaute (nur sog. ''ASCII-Zeichen'' benutzen)
  - Schlechte Beispiele: Maria Muster.xml oder Heinz Rühmann.xml
  - Bessere Beispiele: maria_muster.xml oder heinz_ruehmann.xml
Öffnen Sie die Kommandozeile (> Start > Ausführen > cmd) und wechseln in das Verzeichnis, in dem Sie den Fallaktenordner gespeichert haben.
- Dazu geben Sie bitte folgenden Befehl in die Kommandozeile ein:
```
cd \Verzeichnis_xy
```
- Bsp. für einen Ordner "JMD-Fallakten" auf dem Desktop (der Pfad wird Ihnen auch z.B. im Windows-Explorer angezeigt)
```
cd C:\Dokumente und Einstellungen\Musterbenutzer\Desktop\JMD-Fallakten
```
Geben Sie anschließend folgenden Befehl ein:
- Achtung: Annahme, alle Dateien und die Konvertierungswerkzeuge liegen im gleichen Verzeichnis/Ordner):
```
msxsl dateiname_alt.xml jmd-convert-1.0.3-1.1.xsl -o dateiname_neu.xml
```
- Bsp. für Ihre Offline-Akte mit dem Dateinamen "maria_muster.xml"
```
msxsl maria_muster.xml jmd-convert-1.0.3-1.1.xsl -o maria_muster_neu.xml
```
Es entsteht eine für die Online-Version 1.1. konforme Import-Datei, die über die XML-Importschnittstelle auf den Zentralen Server hochgeladen werden kann.
Bitte wiederholen Sie die Eingabe des Befehls in der Kommandozeile für jede Fallakte.

Individuelle Transformationen

Aufgrund der Unvorhersagbarkeit externer Systeme ist der jeweils nötige Transformationsprozeß individuell:

Die externen Systeme können ggf. direkt veranlasst werden, die Daten im i-mpuls JMD-kompatiblen XML-Format zu schreiben.
Die externen Systeme sind ggf. in der Lage, ihre Daten in einem eigenen XML-basierten Format abzuspeichern.
- Diese könnten dann mit Werkzeugen die z.B. auf XSLT (xslt) beruhen in das i-mpuls JMD-Format überführt werden.
Die Semantik der Konstrukte wird über Schema-Annotationen definiert. Hier ist festgelegt, welcher Punkt in der
- Web-Oberfläche mit welchem Feld in der XML-Datei korrespondiert.

Die Leistung, die hierbei erbracht werden muss, ist die wechselseitige Identifikation der Datenfelder in i-mpuls JMD und im jeweiligen externen System.

Dies kann ggf. durch grafische Werkzeuge unterstützt werden.