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:

1. Speichern Sie alle zu konvertierenden Akten in einem Ordner ab. 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
     • Hinweis: Es kann sein, dass die Dateiendung (.xml) bei Ihnen nicht angezeigt werden, was aber kein Problem ist.
2. Bitte machen Sie sich eine Sicherungskopie der "alten" Fallakte(n) in einem extra Ordner z.B. "Archiv".

3. Laden Sie folgende drei Werkzeuge herunter und speichern diese im gleichen Verzeichnis/Ordner, wo auch Ihre Fallakten liegen. Nach dem Öffnen der Seite, mit Rechtsklick auf "Runterladen", dann "Ziel speichern unter".

   • Konvertierungswerkzeug: jmd-convert-1.0.3-1.1.xsl | Stand 03.08.2011 | Dateigröße: 3kb

   • Werkzeug zur Stapelverarbeitung: stapelverarbeitung-jmd-1.0.3-1.1.bat | Stand 03.08.2011 | Dateigröße: <1kb

   • Werkzeug zur Durchführung der Transformation: msxsl.exe

4. Durchführung der Konvertierung: Klicken Sie mit Doppelklick auf das Werkzeug zur Stapelverarbeitung "stapelverarbeitung-jmd". Es wird automatisch ein neuer Ordner mit den konvertierten Akten angelegt.
5. Es entstehen für die impuls-JMD Online-Version 1.1 konforme Import-Dateien, die nun über die XML-Importschnittstelle einzeln auf den Zentralen Server hochgeladen werden können.

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.