Installations- und Betriebsanleitung umantis Data Manager

Projekt

umantis Data Manager (alle Betriebssysteme)

Version

1.9

Datum

26.10.2015

Dok-Version

1.9

Autor

Oliver Blättler, Michael Bischof

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 1 von 17

INHALT 1.

Informationen zum Dokument 1.1

4

Dokumentenhistorie

4

2.

Management Summary

4

3.

Einleitung

5

3.1 3.2

Zweck des Dokuments Systemrequirements

5 5

4.

Offene Punkte

6

5.

Was ist neu in der Version 1.9

6

6.

Wichtige Informationen zum Upgrade von Versionen bis 1.7 auf 1.9!

6

6.1

Upgrade von Version 1.8 auf 1.9

6

7.

Funktionsumfang

6

8.

Setup und Installation

7

8.1 8.2 8.3 8.4 8.5 8.6 9.

Auslieferung Windows Auslieferung Linux, Unix und Sun Solaris Softwareupdates Lizenzfiles Installation Automatisieren des umantis Datamanagers

7 7 7 7 8 8

Parameter

8

9.1 Informationen zum Aufbau des Kommandos 9.1.1 [global options] 9.2 Dienste und Ausprägungen 9.2.1 Anwendung 10.

8 9 9 9

Dienst IMPORT

10

10.1 Ausprägung import:employee 10.1.1 [values] 10.1.2 [type] 10.1.3 [file] 10.1.4 [zip file] 10.2 Ausprägung import:recruiting 10.2.1 [values] 10.2.2 [type] 10.2.3 [file] 10.2.4 [zip file] 11.

10 10 10 11 11 12 12 12 13 13

Dienst EXPORT

13

11.1 [Values] 11.2 [URL] Installation_and_Users_Guide_1-9.docx

13 13 26.10.2015

Seite 2 von 17

11.3 [FILE] 11.3.1 Filename Standard Patterns 12.

13 13

Anwendungsbeispiele

16

12.1 Standard Beispiel Mitarbeitermanagement OE Daten Import 16 12.2 Standard Beispiel Mitarbeitermanagement OE Daten Import in Deutschland 16 12.3 Standard Beispiel Mitarbeitermanagement Personalstammdaten Import 16 12.4 Standard Beispiel Mitarbeitermanagement Mitarbeiterfotos im Zip File 16 12.5 Standard Beispiel Mitarbeitermanagement Personalstammdaten Import in Deutschland16 12.6 Standard Beispiel Bewerbermanagement Benutzer Import 16 12.7 mit Proxy 16 12.8 Mit Charset-Konvertierung 16 12.9 Mit Charset-Fixierung ohne Konvertierung 17 12.10 Mit Statusmail nach Import 17 12.11 Export 17

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 3 von 17

1. INFORMATIONEN ZUM DOKUMENT

1.1

DOKUMENTENHISTORIE

Version 1.0 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.7

Versionsdatum 30.10.2012 09.12.2012 13.01.2013 20.06.2013 13.09.2013 03.12.2013 01.05.2014 20.06.2014 12.08.2014

1.8 1.9

08.12.2014 26.10.2015

Änderungsgrund Dokument erstellt Neuer Release Neuer Release Neuer Release für de Domains Neuer Release für Inhouse Installationen Neuer Release Wartungsrelease 2014 Weiterentwickelter Wartungsrelease 2014 div. Changes, Beispiele neu aufgebaut, Exportfunktion beschrieben Erweiterungen Rename-Funktion Wartungsrelease 2015

Änderer O. Blättler, O. Blättler, O. Blättler, O. Blättler, O. Blättler, O. Blättler, O. Blättler, O. Blättler, O. Blättler,

M. M. M. M. M. M. M. M. M.

Bischof Bischof Bischof Bischof Bischof Bischof Bischof Bischof Bischof

O. Blättler, M. Bischof O. Blättler, M. Bischof

2. MANAGEMENT SUMMARY Dieses Dokument beschreibt die Funktionsweise und Optionen des umantis Data Managers. Die aktuelle Version des Data Managers ist 1.9. Der umantis Data Manager ist verfügbar für die folgenden Betriebssysteme: • • •

Windows (Client und Server ab 2000) Solaris ab 8 (Sparc) Linux (x86, x86_64)

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 4 von 17

3. EINLEITUNG

3.1

ZWECK DES DOKUMENTS

Das vorliegende Dokument erklärt die Funktionsweise sowie Anwendungsmöglichkeiten und es beschreibt die Einrichtung und den Betrieb der Software auf Windows Plattformen. Es beschreibt nicht die Importfunktionen auf der umantis Plattform und es enthält auch keine Beschreibungen zum Inhalt der zu transportierenden Files oder deren jeweilige Funktion innerhalb des umantis. 3.2

SYSTEMREQUIREMENTS

Windows Plattformen

Alle Client und Server Versionen ab Windows 2000, 32 und 64 Bit.

Linux

Red Hat Enterprise Linux 5, 6, 7, 32 und 64 Bit Suse Linux Enterprise 10, 11 alle SPs, 32 und 64 Bit

Unix

Solaris 8 - 11, 32 und 64 Bit.

Rahmenbedingung 1:

Der Data Manager muss lesenden Zugriff auf das Verzeichnis besitzen, in welchem die hochzuladenden Files liegen.

Rahmenbedingung 2:

Der Data Manager benötigt Internetzugriff. Dieser kann auch über einen Proxy-Server gewährt werden. Sofern der Server oder die Workstation die https-umantis-Internetseite erreichen kann, sind die Bedingungen erfüllt.

Restriktion 1:

Hardwareanforderungen: Keine Citrixfähigkeit ist gegeben.

Arbeitsspeicher:

Der DataManager verbraucht zur Laufzeit 25 – 50 MB Arbeitsspeicher den er nach Abschluss der Verbindung wieder freigibt. Die Grösse des benötigten Arbeitsspeichers variiert je nach der Grösse der hoch- oder heruntergeladenen XML-Dateien.

Festplattenspeicher:

Der DataManager benötigt zur Installation rund 5 MB an Festplattenspeicher. Werden die hochgeladenen Files archiviert, so wächst der Speicherbedarf im selben Mass an wie die archivierten Files gross sind.

Installation_and_Users_Guide_1-9.docx

26.10.2015

Besonderen,

Virtualisierungs-

Seite 5 von 17

und

4. OFFENE PUNKTE Nr. 1

Beschreibung Aktuell keine offenen Punkte

Zuständig

Klärung bis

Status

5. WAS IST NEU IN DER VERSION 1.9 •

Es können jetzt auch Zip Files hochgeladen werden

•

Neue Importart im Bewerbermanagement „positions-xml“

6. WICHTIGE INFORMATIONEN ZUM UPGRADE VON VERSIONEN BIS 1.7 AUF 1.9! Durch die neu hinzugekommene Export-Funktion sind einige globale Optionen neu lokale Optionen. Globale Optionen können vor dem Kommando (z.B. import:employee), lokale Optionen nur nach dem Kommando angegeben werden. Deswegen müssen in den CMD-Dateien diese Werte neu hinter dem Dienst, zb „import:employee“ geschrieben werden und nicht mehr davor, wie das bisher der Fall war. Betroffene Optionen: -s, --server

Ländercode. Muss für .ch-Domains nicht angegeben werden.

-u, --username

Hier wird die umantis-Kunden ID erwartet

-p, --password

An dieser Stelle wird ein Password (Secretkey Feld aus umantis) erwartet.

--stage

Systemstatus. Entweder Stable oder Beta. Wenn Stable ist der Parameter optional.

Die für Inhouse-Installationen vorgesehenen Parameter bleiben unverändert. --svc-url

Für Inhouse Installationen, Angabe der Service URL.

--app-url

Für Inhouse Installationen, Angabe der Application URL.

6.1

UPGRADE VON VERSION 1.8 AUF 1.9

Es müssen keine besonderen Vorkehrungen getroffen werden. Die Versionen sind vollständig kompatibel. Die neue Programmdatei kann einfach über die vorherige Version extrahiert werden.

7. FUNKTIONSUMFANG Der umantis Data Manager kann Files in bestimmte Module von umantis hochladen. Es sind dies derzeit umantis Mitarbeitermanagement und umantis Recruiting. Der umantis Data Manager kann auch Files aus dem Umantis herunterladen und ablegen. Der umantis Data Manager funktioniert mit der gehosteten Lösung ebenso wie mit Inhouse-Lösungen.

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 6 von 17

8. SETUP UND INSTALLATION

8.1

AUSLIEFERUNG WINDOWS

Die Auslieferung des umantis Data Managers für Windows erfolgt als Zip-Datei. Die Zip-Datei enthält folgende Dateien: -

8.2

umantis-data-manager.exe umantis-data-manager-[KundenID].lic (Wenn zweischichtige Umgebung, dann zwei Files) Installation_and_Users_Guide.pdf Beispiel.cmd Das Unterverzeichnis DOC enthält EULA und Lizenzbestimmungen für OpenSSL und andere frei nutzbare Software.

AUSLIEFERUNG LINUX, UNIX UND SUN SOLARIS

Die Auslieferung des umantis Data Managers für Unix erfolgt als Zip-Datei. Die Zip-Datei enthält folgende Dateien: -

8.3

umantis-data-manager umantis-data-manager-[KundenID].lic (Wenn zweischichtige Umgebung, dann zwei Files) Installation_and_Users_Guide.pdf Beispiel.sh Das Unterverzeichnis DOC enthält EULA und Lizenzbestimmungen für OpenSSL und andere frei nutzbare Software. SOFTWAREUPDATES

Die aktuelle Version des umantis Data Managers ist für Windows, Solaris und Linux gegenwärtig 1.9. Die Software wird bei Änderungen innerhalb des umantis Webservices sowie auf Kundenwunsch hin aktualisiert und mit neuen Funktionen ausgestattet. Der reguläre Aktualisierungszyklus ist jährlich. Sollten Softwareupdates aufgrund von Fehlern oder dringenden Änderungen notwendig werden, so wird die aktualisierte Version allen Kunden zugestellt, welche über eine gültige Lizenz verfügen und entsprechende Wartungsverträge bestehen. Die Verteilung erfolgt per Email an die Ansprechpartner beim Kunden. Neue Versionen können üblicherweise gefahrlos über die Vorgängerversion extrahiert werden. Die Abwärtskompatibilität ist gewährleistet solange im zugehörigen Readme nichts anderes vermerkt ist. 8.4

LIZENZFILES

Die Lizenzfiles berechtigen den Gebrauch der Software. Sie beziehen sich ausschliesslich auf die Kunden ID in umantis. Das bedeutet, dass die Software mehrfach installiert werden kann und auch die Hardware verändert werden kann. Es wird ausschliesslich dann ein neues Lizenzfile benötigt, wenn sich der Benutzername (Kunden ID) aus irgendeinem Grund verändert. Die Kunden ID wird zu Beginn eines jeden Uploads geprüft. Ist er nicht identisch mit dem Eintrag im Lizenzfile, dann wird der Upload verweigert. In der Konfiguration ist die Kunden ID als Username Parameter –U abgelegt.

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 7 von 17

Kunden mit Mietmodellen erhalten Lizenfiles welche mit einem Ablaufdatum versehen sind. Das Lizenzfile wird den Kunden jährlich neu zugestellt. 8.5

INSTALLATION

Legen Sie ein neues Verzeichnis an und extrahieren Sie den ganzen Inhalt des Zip-Files in dieses Verzeichnis. Das Handbuch sowie die Beispiel.cmd sind optional und müssen nicht zwingend extrahiert werden. Das Lizenzfile sollte in den Root-Ordner der Installation abgelegt werden, dh. ins gleiche Verzeichnis, in dem sich auch das Programm befindet. Findet sich das Lizenzfile an einem anderen Ort, so ist der Pfad im Kommando mit –l c:\umantis-data-manager.lic anzugeben. Sollten Sie den Data Manager innerhalb einer zweischichtigen Umgebung verwenden, so wird empfohlen, dafür je einen Pfad für die Test- und Produktionsumgebung einzurichten, um die Daten auseinanderhalten zu können. 8.6

AUTOMATISIEREN DES UMANTIS DATAMANAGERS

Um den Data Manager zu automatisieren, muss ein Scheduled Task aufgesetzt werden. Dieser kann mit dem Standard MS Scheduler eingerichtet werden. Dabei kann entweder direkt das Programm mit allen notwendigen Parametern angegeben werden, oder man konzipiert ein CMD- oder BAT-File, welches alle notwendigen Parameter beinhaltet und ruft im Scheduler dieses File auf. Die Verwendung von CMD-Files wird empfohlen. In der Unix Welt wird dieser Task mit Crontab aufgesetzt. Die Funktionsweise des MS Taskschedulers sowie von Crontab sind in den Hilfen der jeweiligen Betriebssysteme beschrieben. Beispiele für CMD-Files finden sich am Ende dieses Handbuchs unter den Anwendungsbeispielen.

9. PARAMETER Über die Parameterwerte kann der Data Manager gesteuert werden. Damit wird festgelegt unter welchen Bedingungen welche Art von File von wo nach wo transportiert werden soll. Wird der Data Manager direkt auf der Kommandozeile aufgerufen, so kann zum Beispiel die Versionsnummer ausgelesen werden, indem man “umantis-data-manager --version” ausführt. Nachfolgend sind alle Parameter beschrieben die mitgegeben werden können. Es wird dabei zwischen Globalen- und Kommando-Parametern unterschieden. 9.1

INFORMATIONEN ZUM AUFBAU DES KOMMANDOS

Generell ist beim Aufbau eines Kommandofiles darauf zu achten, dass zuerst der Programmaufruf angegeben wird, danach folgen die dienstspezifischen globalen Optionen, die Angabe des Dienstes selbst und zum Schluss die ausprägungsrelevanten Werte, die Angabe eines Typs, der Filename und falls vorhanden der Name des Zip Files. Überflüssige Parameter können im Kommando einfach weggelassen werden. Mehrere Optionen vom selben Typ werden durch Leerschlag getrennt hintereinander geschrieben. Daraus folgt:

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 8 von 17

umantis-data-manager [global options] [values] [type] [file] 9.1.1

[GLOBAL OPTIONS]

Für den Dienst „Import“ sind folgende Einstellungsmöglichkeiten vorgesehen: -v, --verbose

Zeigt Systemrückmeldungen an, ohne –v werden diese unterdrückt

-l, --license

Wenn das Lizenzfile nicht umantis-data-manager.lic heisst, muss der Parameter –l gesetzt und der korrekte Name des Lizenzfiles angegeben werden.

--proxy

Hier kann ein ausgehender Proxyserver definiert werden. (host:port)

--proxy-auth

Hinter dem Proxyparameter können allenfalls notwendige Authentifizierungsparameter mitgeliefert werden, das ist abhängig von der jeweiligen Proxy Einstellung. (username:password)

9.2

DIENSTE UND AUSPRÄGUNGEN

Die Version 1.9 des Umantis Data Managers beinhaltet die folgenden Dienste: • help Zeigt eine online Helpfunktion an • version Zeigt die aktuelle Version des umantis Data Managers • import Import Dateien ins umantis • export Exportiert festgelegte Dateien aus einem Exportverzeichnis aus umantis Der Dienst „import“ enthält zwei Ausprägungen. Einerseits die Ausprägung „employee“ und andererseits die Ausprägung „recruiting“. Die so zur Verfügung stehenden Ausprägungen importieren Dateien in unterschiedliche umantis Module. Der Zugang zu den jeweiligen Ausprägungen kann aufgrund der ausgestellten Lizenzen eingeschränkt sein. Der Dienst „export“ enthält keine weiteren Ausprägungen. Es wird über Parameterwerte gesteuert woher er die Datei beziehen soll. 9.2.1 ANWENDUNG import:employee import:recruiting

Importiert Daten ins umantis Mitarbeitermanagement Importiert Daten ins umantis eRecruiting

export

Exportiert Daten aus Umantis

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 9 von 17

10.

DIENST IMPORT

10.1 AUSPRÄGUNG IMPORT:EMPLOYEE Anwendung: umantis-data-manager [global options] import:employee [values] [type] [file] [zip file] 10.1.1 [VALUES] Beachten Sie die Gross- und Kleinschreibung der Anweisungen. -t, --title -c, --comment

-s, --server -D, --delete-file -C, --copy-file -M, --move-file -R, --rename-file -F, --force

--charset-fix --charset-conv --charset-list --status-mail

Ermöglicht die Angabe eines spezifischen Titels innerhalb des Kommandos Hier kann zusätzlicher Kommentar gespeichert werden. Es ist hier möglich Test und Produktiv-Files zu unterscheiden. Zb: –c umantisimport in Testumgebung Wird aktuell nur für das deutsche Rechnezentrum verwendet. Der Wert ist „de“ Nach einem erfolgreichen Import wird das File gelöscht Nach einem erfolgreichen Import soll das Files irgendwohin kopiert werden Nach einem erfolgreichen Import soll das File an einen anderen Ort verschoben werden Nach einem erfolgreichen Import soll das File Umbenannt werden. Kann nur in Kombination mit –M oder –C verwendet werden. Überschreibe bestehende Files beim Kopieren oder Verschieben (Wenn nicht gesetzt, dann wird standardmässig nicht überschrieben und es folgt ein Abbruch des Jobs mit Fehlermeldung) Überschreibe die Angabe des character set im xml file header durch diesen Wert. Konvertiere das File vor dem Import in umantis vom character set zu character set . Liste alle unterstützen character sets auf. Schickt nach dem Upload eine Email an eine im Umantis vordefinierte Emailadresse

10.1.2 [TYPE] Gültige Filetypen sind derzeit: Data Manager Syntax

Bedeutung im umantis

course-extern-excel

CourseExternExcel – EXCEL Import: Externe Teilnahmen importieren CourseExternXml – XML Import: Externe Teilnahmen importieren CourseParticipationExcel – EXCEL Import: Teilnahmen an Veranstaltungen importieren CourseParticipationXml – XML Import: Teilnahmen an Veranstaltungen importieren CoursesExcel – EXCEL Import: Veranstaltungen importieren CoursesXml – XML Import: Veranstaltungen importieren

course-extern-xml course-participation-excel course-participation-xml courses-excel courses-xml

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 10 von 17

dynlists-excel dynlists-withouthistorization-excel dynlists-withouthistorization-xml dynlists-xml externalpersons-excel externalpersons-xml persons-cv-continuing-education-excel persons-cv-continuing-education-xml persons-cv-education-excel persons-cv-education-xml persons-cv-experience-excel persons-cv-experience-xml persons-cv-further-education-excel persons-cv-further-education-xml persons-cv-language-skill-excel persons-cv-language-skill-xml staffing-excel staffing-withouthistorization-excel staffing-withouthistorization-xml staffing-xml

DynlistsExcel – EXCEL Import: Auswahlliste importieren (Komplettimport) Bsp.OrgEinheiten DynlistsWithoutHistorizationExcel – EXCEL Import: Auswahlliste importieren (Teilimport) Bsp.OrgEinheiten DynlistsWithoutHistorizationXML – XML Import: Auswahlliste importieren (Teilimport) Bsp.OrgEinheiten DynlistsXML – XML Import: Auswahlliste importieren (Komplettimport) Bsp.OrgEinheiten ExternalPersonsExcel – EXCEL Import: Externe Personen importieren ExternalPersonsXml – XML Import: Externe Personen importieren PersonsCVContinuingEducation – EXCEL Import: Weiterbildung importieren PersonsCVContinuingEducationXml – XML Import: Weiterbildung importieren PersonsCVEducation – EXCEL Import: Ausbildung importieren PersonsCVEducationXml – XML Import: Ausbildung importieren PersonsCVExperience – EXCEL Import: Berufserfahrung importieren PersonsCVExperienceXml – XML Import: Berufserfahrung importieren PersonsCVFurtherEducation – EXCEL Import: Weiterbildung importieren PersonsCVFurtherEducationXml – XML Import: Weiterbildung importieren PersonsCVLanguageSkill – EXCEL Import: Sprachkenntnisse importieren PersonsCVLanguageSkillXm – XML Import: Sprachkenntnisse importieren StaffingExcel – EXCEL Import: MitarbeiterInnen importieren (Komplettimport) StaffingWithoutHistorizationExcel – EXCEL Import: MitarbeiterInnen importieren (Teilimport) StaffingWithoutHistorizationXML – XML Import: MitarbeiterInnen importieren (Teilimport) StaffingXML – XML Import: MitarbeiterInnen importieren (Komplettimport)

10.1.3 [FILE] Hier wird der Filename des zu importierenden Files angegeben. Dieses kann nur mit Namen benannt sein, dann muss es aber im Ausführungsverzeichnis des umantis-Data-Managers liegen. Falls es woanders liegt, so muss der Pfad dahin dem Filenamen mitgegeben werden. Es können auch IP Adressen oder Standard UNC Pfade angegeben werden 10.1.4 [ZIP FILE] Einige Importarten lassen einen Zip File Upload zu. Damit ein Zip File in umantis verarbeitet wird, muss ein Excel File erstellt werden, welches den Inhalt des Zip Files zu Mitarbeitern zuordnet. Wie Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 11 von 17

diese zwei Files genau aussehen müssen damit sie vom Import akzeptiert werden, kann in der umantis online help nachgelesen werden. Die online help kann unter dieser URL gefunden werden: https://de.onlinehelp.umantis.com/index.php/Importe#Importieren_von_Dokumenten_und_Fotos. 10.2 AUSPRÄGUNG IMPORT:RECRUITING Anwendung: umantis-data-manager [global options] import:recruiting [values] [type] [file] [zip file] 10.2.1 [VALUES] Beachten Sie die Gross- und Kleinschreibung der Anweisungen. -t, --title -c, --comment

-s, --server -D, --delete-file -C, --copy-file -M, --move-file -R, --rename-file -F, --force

--charset-fix --charset-conv --charset-list --status-mail

Ermöglicht die Angabe eines spezifischen Titels innerhalb des Kommandos Hier kann zusätzlicher Kommentar gespeichert werden. Es ist hier möglich Test und Produktiv-Files zu unterscheiden. Zb: –c umantisimport in Testumgebung Wird aktuell nur für das deutsche Rechnezentrum verwendet. Der Wert ist „de“ Nach einem erfolgreichen Import wird das File gelöscht Nach einem erfolgreichen Import soll das Files irgendwohin kopiert werden Nach einem erfolgreichen Import soll das File an einen anderen Ort verschoben werden Nach einem erfolgreichen Import soll das File Umbenannt werden. Kann nur in Kombination mit –M oder –C verwendet werden. Überschreibe bestehende Files beim Kopieren oder Verschieben (Wenn nicht gesetzt, dann wird standardmässig nicht überschrieben und es folgt ein Abbruch des Jobs mit Fehlermeldung) Überschreibe die Angabe des character set im xml file header durch diesen Wert. Konvertiere das File vor dem Import in umantis vom character set zu character set . Liste alle unterstützen character sets auf. Schickt nach dem Upload eine Email an eine im Umantis vordefinierte Emailadresse

10.2.2 [TYPE] Gültige Filetypen sind derzeit: Data Manager Syntax

Bedeutung im umantis

application-excel

ApplicationExcel – EXCEL Import: Bewerbungen importieren

application-xml

ApplicationXML – XML Import: Bewerbungen importieren

dynlists-excel

DynlistsExcel – EXCEL Import: Auswahllisten importieren

positions-excel

PositionsExcel – EXCEL Import: Stellen importieren

users-excel

UsersExcel – EXCEL Import: Benutzer importieren (Komplettimport) UsersWithoutHistorizationExcel – EXCEL Import: Benutzer importieren (Teilimport) UsersWithoutHistorizationXML – XML Import: Benutzer importieren (Teilimport)

users-without-historization-excel users-without-historization-xml

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 12 von 17

users-xml

UsersXML – XML Import: Benutzer (Komplettimport) PositionsXML – XML Import: Stellen importieren

positions-xml

importieren

10.2.3 [FILE] Hier wird der Filename des zu importierenden Files angegeben. Dieses kann nur mit Namen benannt sein, dann muss es aber im Ausführungsverzeichnis des umantis-Data-Managers liegen. Falls es woanders liegt, so muss der Pfad dahin dem Filenamen mitgegeben werden. Es können auch IP Adressen oder Standard UNC Pfade angegeben werden 10.2.4 [ZIP FILE] Einige Importarten lassen einen Zip File Upload zu. Damit ein Zip File in umantis verarbeitet wird, muss ein Excel File erstellt werden, welches den Inhalt des Zip Files zu Mitarbeitern zuordnet. Wie diese zwei Files genau aussehen müssen damit sie vom Import akzeptiert werden, kann in der umantis online help nachgelesen werden. Die online help kann unter dieser URL gefunden werden: https://de.onlinehelp.umantis.com/index.php/Importe#Importieren_von_Dokumenten_und_Fotos.

11.

DIENST EXPORT

Anwendung: umantis-data-manager [global options] export [values] [url] [file] 11.1 [VALUES] Beachten Sie die Gross- und Kleinschreibung der Anweisungen. -F, --force

Bestehende Dateien werden überschrieben (Standard: Kein Überschreiben, Abbruch mit Fehlermeldung)

--charset-fix

Überschreibe die Angabe des character set im xml file header durch diesen Wert.

--charset-conv

Konvertiere das File vor dem Import in umantis vom character set zu character set .

11.2 [URL] Die URL wo die Datei abgeholt werden soll. Zum Beispiel: https://employeeapp-123.umantis.com/XMLExport/91?Key=TEST 11.3 [FILE] Pfad und Dateiname wo die Datei gespeichert werden soll. Zum Beispiel: c:\program files(x86)\umantisdatamanager\export\filename-%Y%m%d-%H%M%S.xml 11.3.1 FILENAME STANDARD PATTERNS %a The abbreviated weekday name according to the current locale. %A The full weekday name according to the current locale.

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 13 von 17

%b The abbreviated month name according to the current locale. %B The full month name according to the current locale. %c The preferred date and time representation for the current locale. %C The century number (year/100) as a 2-digit integer. (SU) %d The day of the month as a decimal number (range 01 to 31). %D Equivalent to %m/%d/%y. (Yecch -- for Americans only. Americans should note that in other countries %d/%m/%y is rather common. This means that in international context this format is ambiguous and should not be used.) (SU) %e Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space. (SU) %E Modifier: use alternative format, see below. (SU) %F Equivalent to %Y-%m-%d (the ISO 8601 date format). (C99) %G The ISO 8601 year with century as a decimal number. The 4-digit year corresponding to the ISO week number (see %V). This has the same format and value as %y, except that if the ISO week number belongs to the previous or next year, that year is used instead. (TZ) %g Like %G, but without century, i.e., with a 2-digit year (00-99). (TZ) %h Equivalent to %b. (SU) %H The hour as a decimal number using a 24-hour clock (range 00 to 23). %I The hour as a decimal number using a 12-hour clock (range 01 to 12). %j The day of the year as a decimal number (range 001 to 366). %k The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank. (See also %H.) (TZ) %l The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded by a blank. (See also %I.) (TZ) %m The month as a decimal number (range 01 to 12). %M The minute as a decimal number (range 00 to 59). %n A newline character. (SU) %O Modifier: use alternative format, see below. (SU) %p Either `AM' or `PM' according to the given time value, or the corresponding strings for the current locale. Noon is treated as `pm' and midnight as `am'. %P Like %p but in lowercase: `am' or `pm' or a corresponding string for the current locale. (GNU) %r The time in a.m. or p.m. notation. In the POSIX locale this is equivalent to `%I:%M:%S %p'. (SU) %R The time in 24-hour notation (%H:%M). (SU) For a version including the seconds, see %T below. %s The number of seconds since the Epoch, i.e., since 1970-01-01 00:00:00 UTC. (TZ) %S The second as a decimal number (range 00 to 60). (The range is up to 60 to allow for occasional leap seconds.) %t A tab character. (SU) %T The time in 24-hour notation (%H:%M:%S). (SU) Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 14 von 17

%u The day of the week as a decimal, range 1 to 7, Monday being 1. See also %w. (SU) %U The week number of the current year as a decimal number, range 00 to 53, starting with the first Sunday as the first day of week 01. See also %V and %W. %V The ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week. See also %U and %W. (SU) %w The day of the week as a decimal, range 0 to 6, Sunday being 0. See also %u. %W The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01. %x The preferred date representation for the current locale without the time. %X The preferred time representation for the current locale without the date. %y The year as a decimal number without a century (range 00 to 99). %Y The year as a decimal number including the century. %z The time-zone as hour offset from GMT. Required to emit RFC 822-conformant dates (using "%a, %d %b %Y %H:%M:%S %z"). (GNU) %Z The time zone or name or abbreviation. %+The date and time in date(1) format. (TZ) (Not supported in glibc2.) %% A literal ‚%' character.

d.h. Ein Dateiname wie \tmp\test.txt-%Y%m%d-%H%M%S würde so aufgelöst: \tmp\test.txt20140528-210132. Vollständiges Beispiel, siehe in den Anwendungsbeispielen.

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 15 von 17

12.

ANWENDUNGSBEISPIELE

12.1 STANDARD BEISPIEL MITARBEITERMANAGEMENT OE DATEN IMPORT umantis-data-manager -l umantis-data-manager.lic import:employee -u -p dynlists-xml

12.2 STANDARD BEISPIEL MITARBEITERMANAGEMENT OE DATEN IMPORT IN DEUTSCHLAND umantis-data-manager -l umantis-data-manager.lic import:employee -u -p –s de dynlists-xml

12.3 STANDARD BEISPIEL MITARBEITERMANAGEMENT PERSONALSTAMMDATEN IMPORT umantis-data-manager -l umantis-data-manager.lic import:employee -u -p staffing-xml

12.4 STANDARD BEISPIEL MITARBEITERMANAGEMENT MITARBEITERFOTOS IM ZIP FILE umantis-data-manager -l umantis-data-manager.lic import:employee -u -p staffing-xml

12.5 STANDARD BEISPIEL MITARBEITERMANAGEMENT PERSONALSTAMMDATEN IMPORT IN DEUTSCHLAND umantis-data-manager -l umantis-data-manager.lic import:employee -u -p –s de staffing-xml

12.6 STANDARD BEISPIEL BEWERBERMANAGEMENT BENUTZER IMPORT umantis-data-manager -l umantis-data-manager.lic import:recruiting -u -p users-xml

12.7 MIT PROXY umantis-data-manager --proxy : --proxyauth : import:employee -u -p staffingxml

12.8 MIT CHARSET-KONVERTIERUNG ../import:employee -u -p --charset-conv iso-8859-1 utf-8 staffing-xml

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 16 von 17

12.9 MIT CHARSET-FIXIERUNG OHNE KONVERTIERUNG ../import:employee -u -p --charset-fix utf-8 staffing-xml

12.10

MIT STATUSMAIL NACH IMPORT

../import:employee -u -p --status-mail staffing-xml

12.11

EXPORT

umantis-data-manager –v -l umantis-data-manager.lic export https://employeeapp123.umantis.com/XMLExport/91?Key=TEST -F c:\program files(x86)\umantisdatamanager\export\filename-%Y%m%d-%H%M%S.xml

Installation_and_Users_Guide_1-9.docx

26.10.2015

Seite 17 von 17