2 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3 <title>2.13. E-Mail</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.9.2: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s12.html" title="2.12. Drucker- und Systemverwaltung"><link rel="next" href="ch02s14.html" title="2.14. Drucken mit kivitendo"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.13. E-Mail</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s12.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s14.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.13. E-Mail"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Email"></a>2.13. E-Mail</h2></div></div></div><p>
4 kivitendo kann sowohl E-Mails direkt aus dem Programm heraus E-Mails
5 versenden, als auch in das Programm importiern. Damit dies
6 funktioniert, müssen die E-Mail-Parameter korrekt konfiguriert sein.
7 Dazu mehr in den folgenden Abschnitten.
8 </p><div class="sect2" title="2.13.1. E-Mail-Versand aus kivitendo heraus"><div class="titlepage"><div><div><h3 class="title"><a name="config.sending-email"></a>2.13.1. E-Mail-Versand aus kivitendo heraus</h3></div></div></div><p>Das Versenden von E-Mails kann zum Verschicken von Belegen genutzt
9 werden, z.B. um ein Angebot direkt an einen Kunden zu verschicken. Damit
10 dies funktioniert, muss eingestellt werden, über welchen Server die
11 E-Mails verschickt werden sollen. kivitendo unterstützt dabei zwei
12 Mechanismen: Versand über einen lokalen E-Mail-Server (z.B. mit
13 <span class="productname">Postfix</span>™ oder <span class="productname">Exim</span>™,
14 was auch die standardmäßig aktive Methode ist) sowie Versand über einen
15 SMTP-Server (z.B. der des eigenen Internet-Providers).</p><p>Welche Methode und welcher Server verwendet werden, wird über die
16 Konfigurationsdatei <code class="filename">config/kivitendo.conf</code>
17 festgelegt. Dort befinden sich alle Einstellungen zu diesem Thema im
18 Abschnitt '<code class="literal">[mail_delivery]</code>'.</p><div class="sect3" title="2.13.1.1. Versand über lokalen E-Mail-Server"><div class="titlepage"><div><div><h4 class="title"><a name="config.sending-email.sendmail"></a>2.13.1.1. Versand über lokalen E-Mail-Server</h4></div></div></div><p>Diese Methode bietet sich an, wenn auf dem Server, auf dem
19 kivitendo läuft, bereits ein funktionsfähiger E-Mail-Server wie z.B.
20 <span class="productname">Postfix</span>™, <span class="productname">Exim</span>™
21 oder <span class="productname">Sendmail</span>™ läuft.</p><p>Um diese Methode auszuwählen, muss der Konfigurationsparameter
22 '<code class="literal">method = sendmail</code>' gesetzt sein. Dies ist
23 gleichzeitig der Standardwert, falls er nicht verändert wird.</p><p>Um zu kontrollieren, wie das Programm zum Einliefern gestartet
24 wird, dient der Parameter '<code class="literal">sendmail = ...</code>'. Der
25 Standardwert verweist auf das Programm
26 <code class="filename">/usr/bin/sendmail</code>, das bei allen oben genannten
27 E-Mail-Serverprodukten für diesen Zweck funktionieren sollte.</p><p>Die Konfiguration des E-Mail-Servers selber würde den Rahmen
28 dieses sprengen. Hierfür sei auf die Dokumentation des E-Mail-Servers
29 verwiesen.</p></div><div class="sect3" title="2.13.1.2. Versand über einen SMTP-Server"><div class="titlepage"><div><div><h4 class="title"><a name="config.sending-email.smtp"></a>2.13.1.2. Versand über einen SMTP-Server</h4></div></div></div><p>Diese Methode bietet sich an, wenn kein lokaler E-Mail-Server
30 vorhanden ist oder einer vorhanden, dieser aber nicht konfiguriert
31 ist.</p><p>Um diese Methode auszuwählen, muss der Konfigurationsparameter
32 '<code class="literal">method = smtp</code>' gesetzt sein. Die folgenden
33 Parameter dienen dabei der weiteren Konfiguration:</p><div class="variablelist"><dl><dt><span class="term">
34 <code class="varname">hostname</code>
35 </span></dt><dd><p>Name oder IP-Adresse des SMTP-Servers. Standardwert:
36 '<code class="literal">localhost</code>'</p></dd><dt><span class="term">
37 <code class="varname">port</code>
38 </span></dt><dd><p>Portnummer. Der Standardwert hängt von der verwendeten
39 Verschlüsselungsmethode ab. Gilt '<code class="literal">security =
40 none</code>' oder '<code class="literal">security = tls</code>', so ist
41 25 die Standardportnummer. Für '<code class="literal">security =
42 ssl</code>' ist 465 die Portnummer. Muss normalerweise nicht
43 geändert werden.</p></dd><dt><span class="term">
44 <code class="varname">security</code>
45 </span></dt><dd><p>Wahl der zu verwendenden Verschlüsselung der Verbindung
46 mit dem Server. Standardwert ist '<code class="literal">none</code>',
47 wodurch keine Verschlüsselung verwendet wird. Mit
48 '<code class="literal">tls</code>' wird TLS-Verschlüsselung eingeschaltet,
49 und mit '<code class="literal">ssl</code>' wird Verschlüsselung via SSL
50 eingeschaltet. Achtung: Für '<code class="literal">tls</code>' und
51 '<code class="literal">ssl</code>' werden zusätzliche Perl-Module benötigt
52 (siehe unten).</p></dd><dt><span class="term">
53 <code class="varname">login</code> und
54 <code class="varname">password</code>
55 </span></dt><dd><p>Falls der E-Mail-Server eine Authentifizierung verlangt,
56 so können mit diesen zwei Parametern der Benutzername und das
57 Passwort angegeben werden. Wird Authentifizierung verwendet, so
58 sollte aus Sicherheitsgründen auch eine Form von Verschlüsselung
59 aktiviert werden.</p></dd></dl></div></div></div><div class="sect2" title="2.13.2. Versendete E-Mails über IMAP exportieren"><div class="titlepage"><div><div><h3 class="title"><a name="config.sent_emails_in_imap"></a>2.13.2. Versendete E-Mails über IMAP exportieren</h3></div></div></div><p>
60 Es können versendete E-Mails über IMAP exportiert werden. Dazu muss
61 der entsprechende Server, auf dem die E-Mails abgelegt werden
62 sollen, konfiguriert werden. Dies geschieht in der Konfigurationsdatei
63 <code class="filename">config/kivitendo.conf</code> im Abschnitt
64 '<code class="literal">[sent_emails_in_imap]</code>'. Es können auch Server für
65 spezifische E-Mail-Adressen konfiguriert werden, indem der Abschnitt
66 kopiert wird und mit dem Namen
67 '<code class="literal">[sent_emails_in_imap/email/EMAILADDRESS]</code>', wobei
68 '<code class="literal">EMAILADDRESS</code>' die entsprechenden E-Mail-Adresse
71 Die Reihenfolge für die Auswahl der Konfiguration ist wie folgt:
72 </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p> Falls es für die Absender-Adresse eine Konfiguration gibt nimm
73 diese. </p></li><li class="listitem"><p> Falls es es für die benutzerbezogene E-Mail-Adresse eine
74 Konfiguration gibt dann nimm diese. </p></li><li class="listitem"><p> Falls es eine generelle Konfiguration gibt dann nimm diese.
75 </p></li></ol></div><p>Die folgenden Parameter dienen der Konfiguration:</p><div class="variablelist"><dl><dt><span class="term">
76 <code class="varname">enabled</code>
78 Falls '<code class="literal">enabled = 0</code>' gesetzt ist, wird der
79 Export von E-Mails deaktiviert. Dies ist der Standardwert. Falls
80 '<code class="literal">enabled = 1</code>' gesetzt ist, wird ist der
81 Export von E-Mails aktiviert.
82 </p></dd><dt><span class="term">
83 <code class="varname">hostname</code>
84 </span></dt><dd><p>Name oder IP-Adresse des IMAP-Servers. Standardwert:
85 '<code class="literal">localhost</code>'</p></dd><dt><span class="term">
86 <code class="varname">port</code>
88 Portnummer. Der Standardwert hängt von der verwendeten
89 Verschlüsselungsmethode ab. Gilt '<code class="literal">ssl = 1</code>',
90 so ist 993 die Standardportnummer. Für
91 '<code class="literal">ssl = 0</code>' ist 143 die Portnummer. Muss
92 normalerweise nicht geändert werden.
93 </p></dd><dt><span class="term">
94 <code class="varname">ssl</code>
96 Wahl ob eine Verschlüsselung bei der Verbindung mit dem Server
97 verwendet wird. Standardwert ist '<code class="literal">1</code>',
98 wodurch eine SSL-Verschlüsselung verwendet wird. Mit
99 '<code class="literal">0</code>' wird keine Verschlüsselung genutzt.
100 </p></dd><dt><span class="term">
101 <code class="varname">username</code> und
102 <code class="varname">password</code>
104 Falls der IMAP-Server eine Authentifizierung verlangt, so können
105 mit diesen zwei Parametern der Nutzername und das Passwort
106 angegeben werden. Wird Authentifizierung verwendet, so sollte
107 aus Sicherheitsgründen auch Verschlüsselung aktiviert werden.
108 </p></dd><dt><span class="term">
109 <code class="varname">folder</code>
111 Wahl des Ordners, in den kivitendo gesendete E-Mails
112 gespeichert. Standardwert ist
113 '<code class="literal">Sent/Kivitendo</code>'. Ordnerhierarchien können
114 mit einem Slash ('<code class="literal">/</code>') getrennt werden.
115 Der gewählte Ordner muss existieren.
116 </p></dd></dl></div><p>
117 Bei einem Fehler bricht die Funktion ab und der Anwender bekommt die
118 Fehlermeldung, dass die E-Mail prinzipiell nicht verschickt werden
119 konnte. An dieser Stelle muss der kivitendo-Admin etwas genauer
120 prüfen, ob der Mail-Versand und/oder die Synchronisation den Fehler
121 verursacht hat. Ein Blick ins Email-Journal kann helfen den Fehler
123 </p></div><div class="sect2" title="2.13.3. E-Mails in kivitendo importieren"><div class="titlepage"><div><div><h3 class="title"><a name="config.imap_client"></a>2.13.3. E-Mails in kivitendo importieren</h3></div></div></div><p>
124 Um E-Mails in kivitendo zu importieren, muss der entsprechende
125 Server, von dem die E-Mails abgeholt werden sollen, konfiguriert
126 werden. Dies geschieht in der Konfigurationsdatei
127 <code class="filename">config/kivitendo.conf</code> im Abschnitt
128 '<code class="literal">[imap_client]</code>'.
129 </p><p>Die folgenden Parameter dienen der Konfiguration:</p><div class="variablelist"><dl><dt><span class="term">
130 <code class="varname">enabled</code>
132 Falls '<code class="literal">enabled = 0</code>' gesetzt ist, wird der
133 Import von E-Mails deaktiviert. Dies ist der Standardwert. Falls
134 '<code class="literal">enabled = 1</code>' gesetzt ist, wird ist der
135 Import von E-Mails aktiviert.
136 </p></dd><dt><span class="term">
137 <code class="varname">hostname</code>
138 </span></dt><dd><p>Name oder IP-Adresse des IMAP-Servers. Standardwert:
139 '<code class="literal">localhost</code>'</p></dd><dt><span class="term">
140 <code class="varname">port</code>
142 Portnummer. Der Standardwert hängt von der verwendeten
143 Verschlüsselungsmethode ab. Gilt '<code class="literal">ssl = 1</code>',
144 so ist 993 die Standardportnummer. Für
145 '<code class="literal">ssl = 0</code>' ist 143 die Portnummer. Muss
146 normalerweise nicht geändert werden.
147 </p></dd><dt><span class="term">
148 <code class="varname">ssl</code>
150 Wahl, ob eine Verschlüsselung bei der Verbindung mit dem Server
151 verwendendet wird. Standardwert ist '<code class="literal">1</code>',
152 wodurch eine SSL-Verschlüsselung verwendet wird. Mit
153 '<code class="literal">0</code>' wird keine Verschlüsselung genutzt.
154 </p></dd><dt><span class="term">
155 <code class="varname">username</code> und
156 <code class="varname">password</code>
158 Falls der IMAP-Server eine Authentifizierung verlangt, so können
159 mit diesen zwei Parametern der Nutzername und das Passwort
160 angegeben werden. Wird Authentifizierung verwendet, so sollte
161 aus Sicherheitsgründen auch Verschlüsselung aktiviert werden.
162 </p></dd><dt><span class="term">
163 <code class="varname">base_folder</code>
165 Wahl des Ordners, den kivitendo als Basis für das Erstellen von
166 Unterordnern und das Abholen von E-Mails verwendet. Standardwert
167 ist '<code class="literal">INBOX</code>'. Ordnerhierarchien können mit
168 einem Slash ('<code class="literal">/</code>') getrennt werden. Beispiel:
169 '<code class="literal">INBOX/kivitendo</code>'. In diesem Ordner dürfen
170 keine Unterordner existieren und keine manuell angelegt werden.
171 </p></dd></dl></div><p>
172 Wenn eingeschaltet, wird beim Anlegen von Verkaufsangeboten und
173 -aufträgen ein Unterordner im E-Mail-Client für den entsprechenden
174 Beleg angelegt. E-Mails, in diesen Ordner werden automatisch beim
175 Öffnen des Belegs in kivitendo importiert. Um die E-Mails übersichtlich
176 zu halten, kann der Hintergrund-Job
177 '<code class="literal">CleanUpEmailSubfolders</code>' genutzt werden. Dieser
178 importiert alle E-Mails und löscht alle Unterordnern, die nicht zu
179 einem offenen Beleg gehören. Importierte E-Mails werden nicht
180 gelöscht; erst beim Löschen des Unterordners werden sie gelöscht.
182 Es können auch E-Mails in kivitendo importiert werden, die nicht zu
183 einem Beleg gehören. Dafür kann der Hintergrund-Job
184 '<code class="literal">SyncEmailFolder</code>' verwendet werden. Dieser
185 synchronisiert standartmäßig den Ordner der in
186 '<code class="literal">base_folder</code>' angegeben ist. Dies kann mit dem
187 Job-Parameter '<code class="literal">folder</code>' geändert. Die Importierten
188 E-Mails werden im E-Mail-Journal gespeichert.
190 Beim Umzug des E-Mail-Servers kann kivitendo schon
191 importierte E-Mails nicht mehr erkennen. Dies führt dazu, dass alle
192 E-Mails erneut importiert werden.
193 </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s12.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s14.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.12. Drucker- und Systemverwaltung </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.14. Drucken mit kivitendo</td></tr></table></div></body></html>
projects / mfinanz.git / blob