[1744] | 1 | <!-- $Id$ --> |
---|
| 2 | |
---|
| 3 | <chapter> |
---|
| 4 | <title>Export datas to other software with dumppykota</title> |
---|
| 5 | <para>Last modified on $Date$</para> |
---|
| 6 | |
---|
| 7 | <para> |
---|
| 8 | If you want to reuse <application>PyKota</application> datas in another |
---|
| 9 | software, but don't want to modify your existing application to |
---|
| 10 | have it connect to <application>PyKota</application>'s database, your |
---|
| 11 | best option is the new <application>dumpykota</application> command. |
---|
| 12 | </para> |
---|
| 13 | |
---|
| 14 | <para> |
---|
| 15 | <application>dumpykota</application> can export <application>PyKota</application> |
---|
| 16 | datas in a number of formats. As of September 27th 2004, output formats are |
---|
| 17 | comma separated values, semicolon separated values, and tab separated values. |
---|
| 18 | More formats, different, are planned : <acronym>XML</acronym>, <acronym>SQL</acronym>, |
---|
| 19 | and <acronym>LDIF</acronym> are planned, but are currently not implemented. |
---|
| 20 | </para> |
---|
| 21 | |
---|
| 22 | <para> |
---|
| 23 | <application>dumpykota</application> can't dump all datas at once though, you have |
---|
| 24 | to specify which type of datas you want. The possible types are : |
---|
| 25 | <itemizedlist> |
---|
| 26 | <listitem><para>Users</para></listitem> |
---|
| 27 | <listitem><para>Users groups</para></listitem> |
---|
| 28 | <listitem><para>Printers</para></listitem> |
---|
| 29 | <listitem><para>Printers groups membership</para></listitem> |
---|
| 30 | <listitem><para>Users groups membership</para></listitem> |
---|
| 31 | <listitem><para>Users print quota entries</para></listitem> |
---|
| 32 | <listitem><para>Users groups print quota entries</para></listitem> |
---|
| 33 | <listitem><para>History of payments</para></listitem> |
---|
| 34 | <listitem><para>History of print jobs</para></listitem> |
---|
| 35 | </itemizedlist> |
---|
| 36 | </para> |
---|
| 37 | |
---|
| 38 | <para> |
---|
| 39 | You can then import the dumped datas into a spreadsheet for example, |
---|
| 40 | if you want to create complex reports with nice looking graphs and |
---|
| 41 | the like. |
---|
| 42 | </para> |
---|
| 43 | |
---|
| 44 | <para> |
---|
| 45 | This command could also be used if you plan to write your own management |
---|
| 46 | tools : just write wrappers around the <application>pkprinters</application>, |
---|
| 47 | <application>edpykota</application>, and <application>dumpykota</application> |
---|
| 48 | tools, and your own tools will automatically benefit from <application>PyKota</application> |
---|
| 49 | database backend independance layer. |
---|
| 50 | </para> |
---|
| 51 | |
---|
| 52 | <warning> |
---|
| 53 | <title>Warning</title> |
---|
| 54 | <para> |
---|
| 55 | Contrary to the <application>repykota</application> command, <application>dumpykota</application> |
---|
| 56 | doesn't currently limit which datas can be exported by normal users, so please take |
---|
| 57 | care to not allow normal users to read the <filename>/etc/pykota/pykota.conf</filename> |
---|
| 58 | file or to execute the <application>dumpykota</application> command if you don't |
---|
| 59 | want to expose possibly sensitive datas. |
---|
| 60 | </para> |
---|
| 61 | </warning> |
---|
| 62 | |
---|
| 63 | <sect1> |
---|
| 64 | <title>Reference</title> |
---|
| 65 | <para> |
---|
| 66 | <cmdsynopsis> |
---|
| 67 | <command>dumpykota</command> |
---|
| 68 | <group choice="opt"><arg>-v</arg><arg>--version</arg></group> |
---|
| 69 | <group choice="opt"><arg>-h</arg><arg>--help</arg></group> |
---|
| 70 | <group choice="opt"> |
---|
| 71 | <arg>-f <replaceable>outputformat</replaceable></arg> |
---|
| 72 | <arg>--format <replaceable>outputformat</replaceable></arg> |
---|
| 73 | </group> |
---|
| 74 | <group choice="req"> |
---|
| 75 | <arg>-d <replaceable>datatype</replaceable></arg> |
---|
| 76 | <arg>--data <replaceable>datatype</replaceable></arg> |
---|
| 77 | </group> |
---|
| 78 | </cmdsynopsis> |
---|
| 79 | </para> |
---|
| 80 | </sect1> |
---|
| 81 | </chapter> |
---|
| 82 | |
---|
| 83 | <!-- |
---|
| 84 | |
---|
| 85 | $Log$ |
---|
| 86 | Revision 1.1 2004/09/27 08:19:14 jalet |
---|
| 87 | Wrote some doc for dumpykota |
---|
| 88 | |
---|
| 89 | --> |
---|