Changeset 13162 for main/waeup.kofa/trunk/docs/source

Timestamp:

11 Jul 2015, 09:34:26 (9 years ago)

Author:

Henrik Bettermann

Message:

More docs.

File:

• main/waeup.kofa/trunk/docs/source/userdocs/datacenter/export.rst (modified) (1 diff)

main/waeup.kofa/trunk/docs/source/userdocs/datacenter/export.rst

@@ -283 +283 @@
   .. autoattribute:: waeup.kofa.students.export.ComboCardDataExporter.title
   .. automethod:: waeup.kofa.students.export.ComboCardDataExporter.mangle_value()
+
+File Export
+===========
+
+You want to export files (passport images, pdf slips), for instance
+of all students in a department or applicants in an applicants
+container? There is no facility in Kofa which does this job for you,
+but you can batch-download files by means of your operating system
+on your local machine. This works perfectly with the the `wget`
+command on Linux or MacOS computers. Windows does not provide such a
+command.
+
+If ``numbers.txt`` contains the application numbers of applicants in
+the applicants container ``xyz``, the following bash script will
+download all passport images directly onto you computer::
+
+  wget --save-cookies cookies.txt --keep-session-cookies --post-data 'form.login=my-username&form.password=my-password' https://my-kofa-site/login
+
+  for i in $(cat numbers.txt)
+  do
+   wget --load-cookies cookies.txt --output-document=$i.pdf https://my-kofa-site/applicants/xyz/$i/passport.jpg
+  done
+
+If ``numbers.txt`` contains the ids of students in a department, the
+following bash script will download all passport images directly
+onto you computer. The script is a slightly extended, more user
+friendly version of the script above::
+
+  if [ $# -lt 3 ]
+  then
+     echo "usage: $0 username password filename"
+     exit 1
+  fi
+
+  wget --save-cookies cookies.txt --keep-session-cookies --post-data "form.login=$1&form.password=$2" https://my-kofa-site/login
+
+  while read variable
+  do
+     echo https://my-kofa-site/students/$variable/passport.jpg
+     wget --load-cookies cookies.txt --output-document $variable.jpg https://my-kofa-site/students/$variable/passport.jpg
+  done < $3
+
+