Integration von KLIB
Aus TimeAndWork
Zusammenstellung der notwendigen Angaben zur Integration in KLIB.
Die Beschreibung der bekannten Probleme bei der Integration in KLIB hilft bei der Lösung von Systemstörungen.
Inhaltsverzeichnis |
[bearbeiten] INI-Eintrag
Section: SYSTEM
Keyword: TIMEANDWORK
Value: JA
[bearbeiten] Parameterisierung der BenutzerInnen
Im OPP wird als Organisation diejenige Einheit erfasst, welche die MitarbeiterInnen umfasst. Wird KLIB z.B. im regionale Sozialamt Muster eingesetzt, dann wird als Organisation "Sozialamt Muster" eröffnet.
Nun werden die BenutzerInnen als Personen bei dieser Organisation eröffnet. Als Verbindung zur ComputerbenutzerIn, wird hierzu im Feld "Windows-Login" der Anmeldename der BenutzerIn erfasst (z.B. Hans Meier oder hm543 je nach Systemumgebung). Es handelt sich dabei um den gleichen Benutzernamen, welcher beim Start von Windows angegeben werden muss.
Zusätzlich müssen die MitarbeiterInnen der Gruppe "MitarbeiterInnen" zugeteilt werden. Dazu die Person speichern und dann im Register Gruppen, diese Person zuordnen. Nun stehen die so eingerichteten BenutzerInnen für die Erfassung zur Verfügung.
[bearbeiten] Parameterisierung für KLIB
1. Konfiguration der Rapporttypen
Bei den in TimeAndWork definierten Rapporttypen wird bei der ExternalsystemID der ComboeintragID des Arbeitscodes in KLIB hinterlegt.
2. Konfiguration der Projektarten
Die Fallart von KLIB wird als Projektart übernommen. Zum Abgleich wird die Bezeichnung des Fachgebietes genommen.
3. Konfiguration der Gemeinden
Die im Fall definierte Gemeinde (Zuständige Gemeinde) wird über die Postleitzahlen ID mit der Organisation in TimeAndWork verknüpft (ExternalSystemID der Organisation).
4. Fälle
Die Fälle werden bei der Übernahme automatisch erzeugt, bzw. aktualisiert und in TimeAndWork als Projekte eröffnet. Im Externalsystem ID des Projektes wird die Fall-ID von KLIB gespeichert.
Zusätzlich werden zum Projekt die Budgetpositionen eröffnet und Projektbeginn/-ende aktualisiert. Für das Projekt werden weitere Daten als "Datenobjekte" hinzugefügt.
Es werden automatisch diejenigen Rapporttypen in das Projektbudget aufgenommen, welche eine positive Externalsystem ID definiert haben.
5. Personen/Klienten
Die Personen werden bei der Übernahme automatisch erzeugt. bzw. aktualisiert. Im der ExternalsystemID wird die Klientenstamm-ID von KLIB gespeichert.
[bearbeiten] Technische Realisierung
Die Kommunikation zwischen KLIB und TAW erfolgt über eine XML-Struktur. Beim Aufruf von TAW aus der Applikation KLIB heraus, erzeugt KLIB diese Struktur nach Vorgabe und legt diese in der Zwischenablage ab. TAW überwacht die Zwischenablage. Wir diese von KLIB mit einer entsprechenden XML-Struktur gefüllt, übernimmt TAW diese Daten und erzeugt, bzw. aktualisiert die entsprechenden Projektdefinition in TAW.
[bearbeiten] Struktur der XML-Daten
<?xml version="1.0" encoding="utf-8"?> <Entry> <OrganisationId Value="4341" /> Interne ID (alphanumerisch) des Quellsystems, welche auf die Organisation in TAW verweist. Diese Organisation muss in TAW bereits bestehen und wird nicht automatisch eröffnet. Im OPP im Feld Externalsystem ID auf der Organisation verfügbar <PersonId Value="432" /> Interne ID der Person (Klient oder ähnliches) des Quellsystem. Auf Grund dieser ID wird der Abgleich vorgenommen. Existiert noch keine Person mit dieser ID auf der Organisation, wird eine Person erzeugt. Feld wird in Externalsystem ID der Person abgelegt. Bestehende Person wird aktualisiert <PersonFirstname Value="Hans" /> Vorname der Person <PersonLastname Value="Muster" /> Name der Person <PersonAddress Value="Musterweg 10" /> Adresse/Strasse der Person <PersonZIP Value="3000" /> <PersonCity Value="Bern" /> PLZ und Ort der Person (nicht ID). Wird mit PLZ-Stamm von TAW abgeglichen. PLZ-Stamm wird erweitert, falls nichts vorhanden ist <ProjectId Value="221" /> Interne ID (alphanumerisch) des Quellsystem, welche das Projekt (Fall) eindeutig indentifizert. Wird auf Projekt in Externalsystem ID abgelegt. Falls noch kein Projekt mit dieser ID besteht, wird das Projekt angelegt. Ansonsten wird ein bestehendes Projekt mit den Daten aktualisert.
<ProjectType Value="Beratung" /> Textuelle Projekttypbezeichnung (Fallart) wird mit Projektartenkatalog von TAW abgeglichen und entsprechende ID gesetzt. <ProjectBegin Value="01.10.2007" /> Projekt (Fall)-Beginndatum. Kann leer sein, oder mit einem Datum im Format TT.MM.JJJJ besetzt sein. Erzeugt Projektstatus-Eintrag von der Art "BEGINN".
<ProjectEnd Value="" /> Projekt (Fall)-Enddatum. Kann leer sein, oder mit einem Datum im Format TT.MM.JJJJ besetzt sein. Erzeugt Projektstatus-Eintrag von der Art "ENDE".
<ProjectTitle Value="Hilfe fuer Familie Muster" /> Textuelle Bezeichnung des Projektes, welche innerhalb von TAW zur Projektidentifikation verwendet wird.
Folgende Daten werden in Projektdaten innerhalb von TAW abgefüllt ("Rechnungsdaten"). Werden nur für Rechnungsdruck verwendet.
<ProjectNumber Value="6343" />
Fallnummer aus Fallregister
<ProjectStatus Value="Aktiv" />
Dossierstatus (Fallstatus) Aktiv/Inaktiv
<Date Value="01.12.2009" /> Datum für den zu erzeugenden Rapporteintrag <WorktypeId Value="5423" /> ID für den Rapporttyp aus dem Quellsystem. Diese ID wird dem Rapporttyp in TAW hinterlegt. <Note Value="Bemerkungstext" /> Bemerkungstext <TopicId Value="" /> Für Schnittstelle zu KLIB (AJB) wird hier Thema-ID übergeben </Entry>
Es kann konfiguriert werden, ob für den Eintrag das übergebene Datum aus KLIB verwendet werden soll, oder ob das Tagesdatum jeweils verwendet werden soll.
Gechieht über die Einstellung "COPYKLIBDATE" (TRUE) pro Benutzer.
[bearbeiten] Übergabe der Daten
Die Übergabe der Daten erfolgt über die Zwischenablage. Dabei muss besonders der Datentyp des Zwischenablage gesetzt werden. Für die Schnittstelle zu KLIB der Type KlibTimeAndWork.
In .NET kann die Zwischenablage einfach wie folgt befüllt werden:
Clipboard.SetData("KlibTimeAndWork", xmlTAW.InnerXml.ToString());