Umantis Data Manager
====================

Changes
-------

1.9.0 (20150611)
- Updated dependencies
- Fixed hostname resolving

1.8.0 (...)
- ...

1.7 (20140812)
- Added export function

1.6 (20140416)
- Added new document types
- Added support for status mail
- Added file renaming


Usage
-----

Usage: umantis-data-manager [global options] <command> [options]

Commands:

  help                                     Show this help
  version                                  Show version information

  import:employee                          Import employee data
  import:recruiting                        Import recruiting data
  export                                   Export data


Global Options:

  -v, --verbose                            Enable verbose output
  -l, --license          <...>             Specify an alternate license file
                                           (Default is: umantis-data-manager.lic in the program directory)

      --proxy            <...>             Specify the proxy to use
                                           (host:port)
      --proxy-auth       <...>             Specify the username and password to use for proxy authentication
                                           (username:password)



Usage: umantis-data-manager [global options] import:employee [options] <type> <file>

Global Options:

  -v, --verbose                            Enable verbose output
  -l, --license          <...>             Specify an alternate license file
                                           (Default is: umantis-data-manager.lic in the program directory)

      --proxy            <...>             Specify the proxy to use
                                           (host:port)
      --proxy-auth       <...>             Specify the username and password to use for proxy authentication
                                           (username:password)


Options:

  -u, --username         <...>             Specify the username for the operation
  -p, --password         <...>             Specify the password for the operation
  -s, --server           <...>             Specify the server for the operation
                                           
  -t, --title            <...>             Specify the import title
  -c, --comment          <...>             Specify the import comment
                                           
      --status-mail                        Request status mail after processing the import
                                           (The recipient has to be configured in umantis)

  -D, --delete-file                        After a successful operation delete the file
  -C, --copy-file        <...>             After a successful operation copy the file to the directory <...>
  -M, --move-file        <...>             After a successful operation move the file to the directory <...>
  -R, --rename-file      <...>             After a successful operation rename the file to <...>
                                           (Can only be used in combination with --copy-file or --move-file)
  -F, --force                              Overwrite file if it already exists
                                           (Default: exit with an error)

      --charset-fix      <...>             Override the default character set specified in the xml file header
      --charset-conv     <...> <...>       Convert the file contents from the character set <...> to <...>
      --charset-list                       List all supported character sets


Type:
  The type of the file. Valid types are:
    course-extern-excel
    course-extern-xml
    course-participation-excel
    course-participation-xml
    courses-excel
    courses-xml
    dynlists-excel
    dynlists-xml
    dynlists-withouthistorization-excel
    dynlists-withouthistorization-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-xml
    staffing-withouthistorization-excel
    staffing-withouthistorization-xml

File:
    The file to be imported



Usage: umantis-data-manager [global options] import:recruiting [options] <type> <file>

Global Options:

  -v, --verbose                            Enable verbose output
  -l, --license          <...>             Specify an alternate license file
                                           (Default is: umantis-data-manager.lic in the program directory)

      --proxy            <...>             Specify the proxy to use
                                           (host:port)
      --proxy-auth       <...>             Specify the username and password to use for proxy authentication
                                           (username:password)


Options:

  -u, --username         <...>             Specify the username for the operation
  -p, --password         <...>             Specify the password for the operation
  -s, --server           <...>             Specify the server for the operation
                                           
  -t, --title            <...>             Specify the import title
  -c, --comment          <...>             Specify the import comment
                                           
      --status-mail                        Request status mail after processing the import
                                           (The recipient has to be configured in umantis)

  -D, --delete-file                        After a successful operation delete the file
  -C, --copy-file        <...>             After a successful operation copy the file to the directory <...>
  -M, --move-file        <...>             After a successful operation move the file to the directory <...>
  -R, --rename-file      <...>             After a successful operation rename the file to <...>
                                           (Can only be used in combination with --copy-file or --move-file)
  -F, --force                              Overwrite file if it already exists
                                           (Default: exit with an error)

      --charset-fix      <...>             Override the default character set specified in the xml file header
      --charset-conv     <...> <...>       Convert the file contents from the character set <...> to <...>
      --charset-list                       List all supported character sets


Type:
  The type of the file. Valid types are:
    application-excel
    application-xml
    dynlists-excel
    positions-excel
    users-excel
    users-xml
    users-without-historization-excel
    users-without-historization-xml

File:
  The file to be imported



Usage: umantis-data-manager [global options] export [options] <url> <file>

Global Options:

  -v, --verbose                            Enable verbose output
  -l, --license          <...>             Specify an alternate license file
                                           (Default is: umantis-data-manager.lic in the program directory)

      --proxy            <...>             Specify the proxy to use
                                           (host:port)
      --proxy-auth       <...>             Specify the username and password to use for proxy authentication
                                           (username:password)


Options:

  -F, --force                              Overwrite file if it already exists
                                           (Default: exit with an error)

      --charset-conv     <...> <...>       Convert the file contents from the character set <...> to <...>
      --charset-fix      <...>             Override the default character set specified in the xml file header


Url:
  The url of the file to be exported

File:
  The where the export will be saved



Usage Example(s)
---------------

umantis-data-manager -u 80006097 -p secret1 import:employee xml-staff-full test-people.xml

umantis-data-manager -u 80006097 -p secret1 --proxy http://proxy:8080 --proxyauth username:password import:employee xml-staff-full test-people.xml

umantis-data-manager -u 80006097 -p secret1 import:employee --charset-fix utf-8 xml-staff-full test-people.xml

umantis-data-manager -u 80006097 -p secret1 import:employee --charset-conv iso-8859-1 utf-8 xml-staff-full test-people.xml


File Rename Patterns
--------------------

       %f     The original filename (path is stripped)
       
       %a     The abbreviated weekday name according to the current locale.

       %A     The full weekday name according to the current locale.

       %b     The abbreviated month name according to the current locale.

       %B     The full month name according to 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)

       %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).

       %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     The time in 24-hour notation (%H:%M:%S). (SU)

       %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.

       %y     The year as a decimal number without a century (range 00 to 99).

       %Y     The year as a decimal number including the century.

Example(s):

	%f-%Y%m%d	->	test-people.xml-20140416


