From 72c372f51a0c2f29d2247397ed9b8cacdf2ce179 Mon Sep 17 00:00:00 2001
From: Jan Ulrich Hasecke <jan.ulrich@hasecke.com>
Date: Thu, 28 Nov 2019 13:29:36 +0100
Subject: [PATCH] Beispiele ergänzt, neue ToDos

---
 source/referenz/hsadmin/emailaliases.rst |    4 ++
 source/referenz/hsadmin/emailaddress.rst |   65 +++++++++++++++++++++++++++++++-
 source/einstieg/email.rst                |    5 ++
 3 files changed, 71 insertions(+), 3 deletions(-)

diff --git a/source/einstieg/email.rst b/source/einstieg/email.rst
index dadaca8..718f7bc 100644
--- a/source/einstieg/email.rst
+++ b/source/einstieg/email.rst
@@ -154,3 +154,8 @@
 .. raw:: latex 
 
    \clearpage
+
+Mail-Alias einrichten
+=====================
+
+.. todo:: Was ist Sinn und Zweck eines Alias. Wie funktioniert es im Prinzip.
diff --git a/source/referenz/hsadmin/emailaddress.rst b/source/referenz/hsadmin/emailaddress.rst
index b23161b..f0bbd53 100644
--- a/source/referenz/hsadmin/emailaddress.rst
+++ b/source/referenz/hsadmin/emailaddress.rst
@@ -49,12 +49,71 @@
 
    xyz00@hsadmin> emailaddress.search({where:{domain:"hs-example.de"}})
 
+Mit folgendem Befehl lässt sich eine neue E-Mail-Adresse einrichten und einem Postfach zuordnen: 
 
-Der folgende Befehl richtet die E-Mail-Adresse ``info@hs-example.de`` mit einer Weiterleitung an die E-Mail-Adresse ``ihre@emailadresse.de`` ein.
+.. code-block:: console 
+
+   xyz00@hsadmin> emailaddress.add ({set:{domain:'hs-example.de',localpart:'info',target:'xyz00-doms'}})
+
+Das Programm gibt dann folgende Meldung als Quittierung des Befehls zurück:
+
+.. code-block:: console
+   [
+      {
+         admin:'xyz00-doms',
+         domain:'hs-example.de',
+         emailaddress:'info@hs-example.de',
+         fulldomain:'hs-example.de',
+         id:'88747',
+         localpart:'info',
+         pac:'xyz00',
+         target:[
+            'xyz00-doms'
+         ]
+      }
+   ]
+
+Wenn später einmal der Wunsch aufkommt, die eintreffenden E-Mails stattdessen an eine externe E-Mail-Adresse weiterzuleiten, kann man den Eintrag aktualisieren. 
+Das Ziel (``target``) lässt sich entweder ändern:
 
 .. code-block:: console
 
-   xyz00@hsadmin> emailaddress.add ({set:{domain:'hs-example.de',localpart:'info',target:'ihre@emailadresse.de'}})
+   xyz00@hsadmin> emailaddress.update ({where:{domain:'hs-example.de',localpart:'info'}, set:{target:'andere@mail.de'}})
+   [
+      {
+         admin:'xyz00-doms',
+         domain:'hs-example.de',
+         emailaddress:'info@hs-example.de',
+         fulldomain:'hs-example.de',
+         id:'88747',
+         localpart:'info',
+         pac:'xyz00',
+         target:[
+            'andere@mail.de'
+         ]
+      }
+   ]
+
+Oder man ergänzt die neue E-Mail-Adresse, indem man sie zusätzlich einfügt.
+Mehrere Ziele werden mit Kommata abgegrenzt.
+
+.. code-block:: console
+
+   xyz00@hsadmin> emailaddress.update ({where:{domain:'hs-example.de',localpart:'info'}, set:{target:'andere@mail.de,xzy00-doms'}})
+   [
+      {
+         admin:'xyz00-doms',
+         domain:'hs-example.de',
+         emailaddress:'info@hs-example.de',
+         fulldomain:'hs-example.de',
+         id:'88747',
+         localpart:'info',
+         pac:'xyz00',
+         target:[
+            'andere@mail.de',
+            'xzy00-hs-example.de'
+         ]
+      }
+   ]
 
 
-.. todo:: Weitere Beispiele, mindestens noch eins mit where-Kondition
diff --git a/source/referenz/hsadmin/emailaliases.rst b/source/referenz/hsadmin/emailaliases.rst
index 6843268..f7a366c 100644
--- a/source/referenz/hsadmin/emailaliases.rst
+++ b/source/referenz/hsadmin/emailaliases.rst
@@ -4,6 +4,9 @@
 Modul emailalias
 ================
 
+.. todo:: Es muss erklärt werden, wie ein Alias funktioniert.
+
+
 Funktionen
 ==========
 
@@ -45,4 +48,5 @@
     xyz00@hsadmin> emailalias.add ({set:{name:'xyz00',target:'webmaster@hs-example.de'}})
 
 
+
 .. todo:: Weitere Beispiele, mindestens noch eins mit where-Kondition

--
Gitblit v1.9.0-SNAPSHOT