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/emailaddress.rst |   65 +++++++++++++++++++++++++++++++-
 1 files changed, 62 insertions(+), 3 deletions(-)

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

--
Gitblit v1.9.0-SNAPSHOT