Stammdatenübernahme. XML-Schnittstellenbeschreibung BEMdok. Peter R. Horak IPECO HAMBURG. Überarbeitungen

Transkript

1 BEMdok Stammdatenübernahme XML-Schnittstellenbeschreibung Überarbeitungen : Pflichtfelder markiert : Neues Feld»GdB«hinzugefügt (ab v1.2.5) Peter R. Horak IPECO HAMBURG

2 1 BEMdok-Dokumentation: Stammdatenübernahme Intention Um für alle beteiligten Stellen, dies sind i.d.r. das BEM-Team und die Personalabteilung, einen möglichst reibungslosen WorkFlow zu ermöglichen, stellt BEMdok eine dokumentierte XML-Schnittstelle zur Verfügung. Über diese können die von der Personalabteilung bereitgestellten BEM-relevanten Mitarbeiterdaten eingelesen werden. Damit wird es möglich, eine halbautomatische Übergabeprozedur zu etablieren, innerhalb derer die exportierte XML-Datei nur noch in BEMdok eingelesen werden muss, um die entsprechenden Mitarbeiter-Stammdaten in das System zu übernehmen. Für den gesamten Prozess des Datentransfers sind die geltenden Datenschutzbestimmungen zu beachten. Vorarbeiten Aufgabe der Personalabteilung mit ihren verschiedenen Personal-Softwares ist es, die für das BEM vorgesehenen Mitarbeiterdaten in geeigneter Weise bereitzustellen. Wie diese Daten ermittelt werden können und wie sie zu exportieren sind, ist der jeweiligen Softwarebeschreibung zu entnehmen. IT-Arbeiten In aller Regel wird die IT-Abteilung des Unternehmens dann, wenn die Ausgabeinhalte und -formate nicht unmittelbar durch die Personalabteilung festgelegt werden können, einmalig ein entsprechendes Skript anfertigen, das die XML-Schnittstelle äquivalent bedient. Sind in einem Unternehmen mehrere Fallmanager und/oder Teams für das BEM zuständig, muss darauf geachtet werden, eine eindeutige Zuordnung vorzunehmen. BEMdok stellt hierfür eine entsprechende Identifikationsmöglichkeit zur Verfügung (vgl. Handbuch). Nachfolgend werden die Elemente, die erwarteten und erforderlichen Inhalte der XML-Datei ausführlich dokumentiert. Die XML-Struktur folgt dabei den üblichen Notifikationen. Leere/fehlende Attribute werden durch einen Leerstring ("") gekennzeichnet.

3 2 BEMdok-Dokumentation: Stammdatenübernahme Beschreibung der XML-Elemente (die Elemente sind obligatorisch) Element Beschreibung Bemerkung <?xml version="1.0" encoding="utf- 8"?> <BEMmeldungen> <TeamBezeichnung ID=" /> <Meldedatum Datum="" /> <Meldungen> Einleitendes XML-Statement XML-Identifikation (Start) Eindeutige, identifizierende Bezeichnung des BEM- Teams, an das übergeben wird (obligatorisch!) Erstelldatum der XML-Datei Bereichsbeginn der Meldungen <Meldung> Beginn der Einzelmeldung (Mitarbeiter) Beliebig häufig <Person Titel="" Name= " Vorname="" Geburtsdatum= " Geschlecht= PLZort="" Strasse="" TELpriv="" Handicap="" GdB= /> <Betrieb PersonalNr= " Fehltage="" Funktion="" Unternehmenseintritt= " StandortAbt="" TELbetr="" StellenPlan= " Land="" Status="" /> Personen-Information zum übermittelten Mitarbeiter Betriebliche Informationen zum übermittelten Mitarbeiter </Meldung> Ende der Einzelmeldung (Mitarbeiter) Beliebig häufig </Meldungen> </BEMmeldungen> Bereichsende der Meldungen XML-Identifikation (Ende)

4 3 BEMdok-Dokumentation: Stammdatenübernahme Beschreibung der XML-Attribute Person Attribut Beschreibung Format Beispiel Name Name des Mitarbeiters (obligatorisch) Zeichen (max. 50) Müller Vorname Vorname des Mitarbeiters (obligatorisch) Zeichen (max. 25) Otto Geburtsdatum Geburtsdatum des Mitarbeiters (obligatorisch) TT.MM.JJJJ PLZort Postleitzahl und Wohnort des Mitarbeiters PLZ Ortsname (max. 38 Zeichen) Strasse Straße und Hausnummer des Mitarbeiters Alphanumerisch (max. 30) TELpriv Telefon (privat) des Mitarbeiters Rufnummer mit Vorwahl (max. 25 Zeichen) Nürnberg Aloisstraße Handicap Angaben zum (Schwer-)Behindertenstatus des Mitarbeiters (obligatorisch) Zahl (einstellig) 2 GdB Grad der Behinderung [%] Zahl (max. 3stellig) 50 Geschlecht Geschlecht des Mitarbeiters (obligatorisch) Zahl (einstellig) 1 Titel Titel/Grad des Mitarbeiters Zeichen (max. 15) Dipl.-Ing.

5 4 BEMdok-Dokumentation: Stammdatenübernahme Beschreibung der XML-Attribute Betrieb Attribut Beschreibung Format Beispiele PersonalNr Personalnummer Alphanumerisch (max. 15) ABC99-k Fehltage Anzahl krankheitsbedingter Fehltage zum Meldezeitpunkt Zahl (max. 3stellig) 55 Funktion Aktuelle Funktion im Unternehmen Alphanumerisch (max. 60) Unternehmenseintritt Datum des Eintritts in das Unternehmen Datum (TT.MM.JJJJ) Auslieferungsfahrer StandortAbt Bezeichnung des Standorts, der Filiale und/oder der Abteilung, in der Mitarbeiter aktuell/hauptsächlich tätig ist Alphanumerisch (max. 60) Zentrale Zentrale.Versand Zentrale.Versand.IT StellenPlan Position im Stellenplan, die der Mitarbeiter aktuell einnimmt Alphanumerisch (max. 25 Zeichen) ZGI-12 a Land Angabe des Bundeslandes bzw. des Staates, in welchem sich der Hauptbeschäftigungsort des Mitarbeiters befindet Zahl (ein- oder zweistellig) 3 Status Aktueller betrieblicher Status des Mitarbeiters Zeichen (mehrstellig) TELbetr Telefon (betrieblich) des Mitarbeiters Rufnummer mit Vor- und Durchwahl (max. 25 Zeichen) 2,5,

6 5 BEMdok-Dokumentation: Stammdatenübernahme Wertetabelle zum Attribut Person Attribut Ausprägung Wert Beispiel Handicap nicht behindert schwerbehindert gleichgestellt GdB Grad der Behinderung 0 bis 100 (in 10er-Schritten) Geschlecht weiblich männlich keine Angabe 1 0 leer 1 0 Wertetabelle zum Attribut Betrieb Attribut Ausprägung Wert Beispiel Land Baden-Württemberg Bayern Berlin Brandenburg Bremen Hamburg Hessen Mecklenburg-Vorpommern Niedersachsen Nordrhein-Westfalen Rheinland-Pfalz Saarland Sachsen Sachsen-Anhalt Schleswig-Holstein Thüringen Dänemark Niederlande Österreich Polen Schweiz anderes EU-Land Nicht EU-Land usw.

7 6 BEMdok-Dokumentation: Stammdatenübernahme Status Auszubildende/Auszubildender Gewerblich Kaufmännisch Technisch teilzeitbeschäftigt vollbeschäftigt Schichtarbeit wechselnde Arbeitsort Mehrere Status-Ausprägungen werden durch Kommata getrennt 1,6,10

8 7 BEMdok-Dokumentation: Stammdatenübernahme XML-Struktur <?xml version="1.0" encoding="utf-8"?> <BEMmeldungen> <TeamBezeichnung ID=" /> <Meldedatum Datum="" /> <Meldungen> <Meldung> <Person Titel="" Name="" Vorname="" Geschlecht= Geburtsdatum="" PLZort="" Strasse="" TELpriv="" Handicap="" GdB= /> <Betrieb PersonalNr= Fehltage= Funktion= Unternehmenseintritt= StandortAbt= TELbetr= StellenPlan= Land= Status= /> </Meldung> <Meldung> <Person Titel="" Name="" Vorname="" Geschlecht= Geburtsdatum="" PLZort="" Strasse="" TELpriv="" Handicap="" /> <Betrieb PersonalNr= Fehltage= Funktion= Unternehmenseintritt= StandortAbt= TELbetr= StellenPlan= Land= Status= /> </Meldung> <Meldung> </Meldung> </Meldungen> </BEMmeldungen>

9 8 BEMdok-Dokumentation: Stammdatenübernahme IMPRESSUM BEMdok wird herausgegeben vom Institut für Personalentwicklung und Coaching ipeco Hamburg Schwarzenberg 26A Neu Wulmstorf bei Hamburg