Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- benno-client [2018/10/15 12:44] – [Export-Script] lwsystems
+++ benno-client [2025/03/26 14:34] (aktuell) – [Suchanfragen] lwsystems
@@ Zeile 1: / Zeile 1: @@
+====== benno-client ======
+Benno-client ist ein Kommandozeilen-Client für das [[rest_api|REST API]] von Benno MailArchiv. Dieses Perl-Script kann als Basis für eigene Implementierungen genutzt werden.
+Daneben bietet es auch die Möglichkeit, größere Mengen von E-Mails anhand von Suchkritereien zu ermitteln und diese z.B. aus dem System zu exportieren.
+====== Suchanfragen ======
+Benno Client ruft stellt Suchanfragen per [[rest_api|REST-API]] an Benno MailArchiv. Die Anfragen können mit Hilfe der [[https://lucene.apache.org/core/3_6_0/queryparsersyntax.html|Lucene Query-Syntax]] formuliert werden.
+Eine Suche gibt die Anzahl der gefundenen E-Mails anhand der Benno E-Mail Ids zurück. Die Anzahl der Rückgabewerte wird durch den Parameter //%%--limit 20%%// festgelegt. Falls er nicht angegeben wird, ist die Voreinstellung 20.
+<code>
+# benno-client  -q 'From:m.hendriks@hansen-und-meyer.de'
+:446E2DD35A73880A569992D2CAC77EE78ACDA94383EA42247869D81CA5AD850800
+:3B582513165E3BCEEF113F44F200FA9A4534EB3BFAE37264867745CE4EB4424500
+:3B582513165E3BCEEF113F44F200FA9A4534EB3BFAE37264867745CE4EB4424500
+mails found (first: 1, last: 20, limit: 20)
+</code>
+Die letzte (Status-)Zeile wird auf STDERR ausgegeben und kann mit ''2>/dev/null'' entfernt werden. Damit kann die Liste als Eingabe zum Herunterladen der E-Mails dienen.
+===== Export mittels Id =====
+<code>
+# benno-client -i 2012:E51F8A601C08E09004C02833347EFC2D7AD92E757FE4CEC5B10AD869E0D5BB2800
+</code>
+===== Export-Script =====
+Im unten aufgeführten Beispiel sollen alle E-Mails des Benutzers "m.hendriks@hansen-und-meyer.de" vom Jahre 2017 exportiert werden.
+Falls für den Benutzer mehr als 10.000 E-Mails archiviert wurden, sollte das Limit entsprechend höher gesetzt werden.
+<file bash>
+#!/bin/bash
+#
+#
+EXPORTDIR=/tmp/export
+mkdir $EXPORTDIR
+benno-client --limit 10000 -q '(Sender:m.hendriks@hansen-und-meyer.de OR Recipient:m.hendriks@hansen-und-meyer.de)  AND Date:[201701010000 TO 201808271605]' 2>/dev/null | \
+while read bennoId; do
+  [ "$bennoId" = "No results found." ] && exit
+  benno-client --export $EXPORTDIR --id $bennoId
+done
+</file>
+====== Aufrufparameter ======
+<code bash>
+Usage: /usr/sbin/benno-client [-h] [-s <secret>] [-r <rest host>] [-c <container>]
+  [-p <port>] <-q <query>|-i <mailid>>
+    -c '<container>'    archive container
+    -u|--scid <scid>'   subcontainer id (if configured)
+    --filter '<filter>' lucene filter string or file with filter
+    --first '<num>'     first email in response list
+    -l|--limit '<num>'  limit response list to <num> mails
+    -i|--id '<id>'      fetch mail with id
+    -j                  dump raw JSON response
+    -p <port>           REST port (21080)
+    -q '<query>'        lucene query string or file with filter
+                        (search header as "HEADER-<HEADER-NAME>")
+    -r <resthost>       (localhost)
+    -s <secret>         shared secret
+    -v                  verbose
+    -h                  print this help
+                        (search header as "HEADER-<HEADER-NAME>")
+    --export <dir>      write emlfile to directory <dir>
+    --xheader <string>  prepend output file with header string
+    --instance-id       print Benno MailArchive Instance ID
+    --license           print license data
+</code>

Das Benno MailArchiv Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge