Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision fc640092

Von Tamino Steinert vor mehr als 1 Jahr hinzugefügt

  • ID fc640092070d2b57c9bd808816f47ea749d624ac
  • Vorgänger 8b1e7896
  • Nachfolger 5d8e7dc9

doc: Dokumentation neu gebaut

Unterschiede anzeigen:

doc/html/ch02s11.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>2.11. E-Mail-Versand aus kivitendo heraus</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.8.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s10.html" title="2.10. Drucker- und Systemverwaltung"><link rel="next" href="ch02s12.html" title="2.12. 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.11. E-Mail-Versand aus kivitendo heraus</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s10.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s12.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.11. E-Mail-Versand aus kivitendo heraus"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="config.sending-email"></a>2.11. E-Mail-Versand aus kivitendo heraus</h2></div></div></div><p>kivitendo kann direkt aus dem Programm heraus E-Mails versenden,
4
      z.B. um ein Angebot direkt an einen Kunden zu verschicken. Damit dies
5
      funktioniert, muss eingestellt werden, über welchen Server die E-Mails
6
      verschickt werden sollen. kivitendo unterstützt dabei zwei Mechanismen:
7
      Versand über einen lokalen E-Mail-Server (z.B. mit
8
      <span class="productname">Postfix</span>™ oder <span class="productname">Exim</span>™,
9
      was auch die standardmäßig aktive Methode ist) sowie Versand über einen
10
      SMTP-Server (z.B. der des eigenen Internet-Providers).</p><p>Welche Methode und welcher Server verwendet werden, wird über die
11
      Konfigurationsdatei <code class="filename">config/kivitendo.conf</code>
12
      festgelegt. Dort befinden sich alle Einstellungen zu diesem Thema im
13
      Abschnitt '<code class="literal">[mail_delivery]</code>'.</p><div class="sect2" title="2.11.1. Versand über lokalen E-Mail-Server"><div class="titlepage"><div><div><h3 class="title"><a name="config.sending-email.sendmail"></a>2.11.1. Versand über lokalen E-Mail-Server</h3></div></div></div><p>Diese Methode bietet sich an, wenn auf dem Server, auf dem
14
        kivitendo läuft, bereits ein funktionsfähiger E-Mail-Server wie z.B.
15
        <span class="productname">Postfix</span>™, <span class="productname">Exim</span>™
16
        oder <span class="productname">Sendmail</span>™ läuft.</p><p>Um diese Methode auszuwählen, muss der Konfigurationsparameter
17
        '<code class="literal">method = sendmail</code>' gesetzt sein. Dies ist
18
        gleichzeitig der Standardwert, falls er nicht verändert wird.</p><p>Um zu kontrollieren, wie das Programm zum Einliefern gestartet
19
        wird, dient der Parameter '<code class="literal">sendmail = ...</code>'. Der
20
        Standardwert verweist auf das Programm
21
        <code class="filename">/usr/bin/sendmail</code>, das bei allen oben genannten
22
        E-Mail-Serverprodukten für diesen Zweck funktionieren sollte.</p><p>Die Konfiguration des E-Mail-Servers selber würde den Rahmen
23
        dieses sprengen. Hierfür sei auf die Dokumentation des E-Mail-Servers
24
        verwiesen.</p></div><div class="sect2" title="2.11.2. Versand über einen SMTP-Server"><div class="titlepage"><div><div><h3 class="title"><a name="config.sending-email.smtp"></a>2.11.2. Versand über einen SMTP-Server</h3></div></div></div><p>Diese Methode bietet sich an, wenn kein lokaler E-Mail-Server
25
        vorhanden oder zwar einer vorhanden, dieser aber nicht konfiguriert
26
        ist.</p><p>Um diese Methode auszuwählen, muss der Konfigurationsparameter
27
        '<code class="literal">method = smtp</code>' gesetzt sein. Die folgenden
28
        Parameter dienen dabei der weiteren Konfiguration:</p><div class="variablelist"><dl><dt><span class="term">
3
   <title>2.11. 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.8.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s10.html" title="2.10. Drucker- und Systemverwaltung"><link rel="next" href="ch02s12.html" title="2.12. 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.11. E-Mail</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s10.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s12.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.11. E-Mail"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Email"></a>2.11. 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.11.1. E-Mail-Versand aus kivitendo heraus"><div class="titlepage"><div><div><h3 class="title"><a name="config.sending-email"></a>2.11.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.11.1.1. Versand über lokalen E-Mail-Server"><div class="titlepage"><div><div><h4 class="title"><a name="config.sending-email.sendmail"></a>2.11.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.11.1.2. Versand über einen SMTP-Server"><div class="titlepage"><div><div><h4 class="title"><a name="config.sending-email.smtp"></a>2.11.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.11.2. Versendete E-Mails über IMAP exportieren"><div class="titlepage"><div><div><h3 class="title"><a name="config.sent_emails_in_imap"></a>2.11.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
          werden 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
69
          ist, versehen wird.
70
        </p><p>Die folgenden Parameter dienen der Konfiguration:</p><div class="variablelist"><dl><dt><span class="term">
71
                     <code class="varname">enabled</code>
72
                  </span></dt><dd><p>
73
                Falls '<code class="literal">enabled = 0</code>' gesetzt ist, wird der
74
                Export von E-Mails deaktiviert. Dies ist der Standardwert. Falls
75
                '<code class="literal">enabled = 1</code>' gesetzt ist, wird ist der
76
                Export von E-Mails aktiviert.
77
              </p></dd><dt><span class="term">
29 78
                     <code class="varname">hostname</code>
30
                  </span></dt><dd><p>Name oder IP-Adresse des SMTP-Servers. Standardwert:
79
                  </span></dt><dd><p>Name oder IP-Adresse des IMAP-Servers. Standardwert:
31 80
              '<code class="literal">localhost</code>'</p></dd><dt><span class="term">
32 81
                     <code class="varname">port</code>
33
                  </span></dt><dd><p>Portnummer. Der Standardwert hängt von der verwendeten
34
              Verschlüsselungsmethode ab. Gilt '<code class="literal">security =
35
              none</code>' oder '<code class="literal">security = tls</code>', so ist
36
              25 die Standardportnummer. Für '<code class="literal">security =
37
              ssl</code>' ist 465 die Portnummer. Muss normalerweise nicht
38
              geändert werden.</p></dd><dt><span class="term">
39
                     <code class="varname">security</code>
40
                  </span></dt><dd><p>Wahl der zu verwendenden Verschlüsselung der Verbindung
41
              mit dem Server. Standardwert ist '<code class="literal">none</code>',
42
              wodurch keine Verschlüsselung verwendet wird. Mit
43
              '<code class="literal">tls</code>' wird TLS-Verschlüsselung eingeschaltet,
44
              und mit '<code class="literal">ssl</code>' wird Verschlüsselung via SSL
45
              eingeschaltet. Achtung: Für '<code class="literal">tls</code>' und
46
              '<code class="literal">ssl</code>' werden zusätzliche Perl-Module benötigt
47
              (siehe unten).</p></dd><dt><span class="term">
48
                     <code class="varname">login</code> und
82
                  </span></dt><dd><p>
83
                Portnummer. Der Standardwert hängt von der verwendeten
84
                Verschlüsselungsmethode ab. Gilt '<code class="literal">ssl = 0</code>',
85
                so ist 993 die Standardportnummer. Für
86
                '<code class="literal">ssl = 0</code>' ist 143 die Portnummer. Muss
87
                normalerweise nicht geändert werden.
88
              </p></dd><dt><span class="term">
89
                     <code class="varname">ssl</code>
90
                  </span></dt><dd><p>
91
                Wahl ob eine Verschlüsselung bei der Verbindung mit dem Server
92
                verwendendet wird. Standardwert ist '<code class="literal">1</code>',
93
                wodurch eine SSL-Verschlüsselung verwendet wird. Mit
94
                '<code class="literal">0</code>' wird keine Verschlüsselung genutzt.
95
              </p></dd><dt><span class="term">
96
                     <code class="varname">username</code> und
49 97
            <code class="varname">password</code>
50
                  </span></dt><dd><p>Falls der E-Mail-Server eine Authentifizierung verlangt,
51
              so können mit diesen zwei Parametern der Benutzername und das
52
              Passwort angegeben werden. Wird Authentifizierung verwendet, so
53
              sollte aus Sicherheitsgründen auch eine Form von Verschlüsselung
54
              aktiviert werden.</p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s10.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s12.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.10. Drucker- und Systemverwaltung&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.12. Drucken mit kivitendo</td></tr></table></div></body></html>
98
                  </span></dt><dd><p>
99
                Falls der IMAP-Server eine Authentifizierung verlangt, so können
100
                mit diesen zwei Parametern der Nutzername und das Passwort
101
                angegeben werden. Wird Authentifizierung verwendet, so sollte
102
                aus Sicherheitsgründen auch Verschlüsselung aktiviert werden.
103
              </p></dd><dt><span class="term">
104
                     <code class="varname">folder</code>
105
                  </span></dt><dd><p>
106
                Wahl des Ordners, in den kivitendo gesendete E-Mails
107
                gespeichert. Standardwert ist
108
                '<code class="literal">Sent/Kivitendo</code>'. Ordnerhierarchien können
109
                mit einem Slash ('<code class="literal">/</code>') getrennt werden.
110
                Beispiel: '<code class="literal">INBOX/kivitendo</code>'. Dieser Ordner
111
                muss existieren.
112
              </p></dd></dl></div></div><div class="sect2" title="2.11.3. E-Mails in kivitendo importieren"><div class="titlepage"><div><div><h3 class="title"><a name="config.imap_client"></a>2.11.3. E-Mails in kivitendo importieren</h3></div></div></div><p>
113
          Um E-Mails in kivitendo zu importieren, muss der entsprechende
114
          Server, von dem die E-Mails abgeholt werden sollen, konfiguriert
115
          werden. Dies geschieht in der Konfigurationsdatei
116
          <code class="filename">config/kivitendo.conf</code> im Abschnitt
117
          '<code class="literal">[imap_client]</code>'.
118
        </p><p>Die folgenden Parameter dienen der Konfiguration:</p><div class="variablelist"><dl><dt><span class="term">
119
                     <code class="varname">enabled</code>
120
                  </span></dt><dd><p>
121
                Falls '<code class="literal">enabled = 0</code>' gesetzt ist, wird der
122
                Import von E-Mails deaktiviert. Dies ist der Standardwert. Falls
123
                '<code class="literal">enabled = 1</code>' gesetzt ist, wird ist der
124
                Import von E-Mails aktiviert.
125
              </p></dd><dt><span class="term">
126
                     <code class="varname">hostname</code>
127
                  </span></dt><dd><p>Name oder IP-Adresse des IMAP-Servers. Standardwert:
128
              '<code class="literal">localhost</code>'</p></dd><dt><span class="term">
129
                     <code class="varname">port</code>
130
                  </span></dt><dd><p>
131
                Portnummer. Der Standardwert hängt von der verwendeten
132
                Verschlüsselungsmethode ab. Gilt '<code class="literal">ssl = 0</code>',
133
                so ist 993 die Standardportnummer. Für
134
                '<code class="literal">ssl = 0</code>' ist 143 die Portnummer. Muss
135
                normalerweise nicht geändert werden.
136
              </p></dd><dt><span class="term">
137
                     <code class="varname">ssl</code>
138
                  </span></dt><dd><p>
139
                Wahl ob eine Verschlüsselung bei der Verbindung mit dem Server
140
                verwendendet wird. Standardwert ist '<code class="literal">1</code>',
141
                wodurch eine SSL-Verschlüsselung verwendet wird. Mit
142
                '<code class="literal">0</code>' wird keine Verschlüsselung genutzt.
143
              </p></dd><dt><span class="term">
144
                     <code class="varname">username</code> und
145
            <code class="varname">password</code>
146
                  </span></dt><dd><p>
147
                Falls der IMAP-Server eine Authentifizierung verlangt, so können
148
                mit diesen zwei Parametern der Nutzername und das Passwort
149
                angegeben werden. Wird Authentifizierung verwendet, so sollte
150
                aus Sicherheitsgründen auch Verschlüsselung aktiviert werden.
151
              </p></dd><dt><span class="term">
152
                     <code class="varname">base_folder</code>
153
                  </span></dt><dd><p>
154
                Wahl des Ordners, den kivitendo als Basis für das erstellen von
155
                Unterordnern und das abholen von E-Mails verwendet. Standardwert
156
                ist '<code class="literal">INBOX</code>'. Ordnerhierarchien können mit
157
                einem Slash ('<code class="literal">/</code>') getrennt werden. Beispiel:
158
                '<code class="literal">INBOX/kivitendo</code>'. In diesem Ordner dürfen
159
                keine Unterordner existieren und keine manuell angelegt werden.
160
              </p></dd></dl></div><p>
161
          Wenn eingeschaltet, wird beim Anlegen von Verkaufsangeboten und
162
          -aufträgen ein Unterordner im E-Mail-Client für den entsprechenden
163
          Beleg angelegt. E-Mails, in diesen Ordner werden automatisch beim
164
          Öffnen des Belegs in kivitendo importiert. Um die E-Mails übersichtlich
165
          zu halten, kann der Hintergrund-Job
166
          '<code class="literal">CleanUpEmailSubfolders</code>' genutzt werden. Dieser
167
          importiert alle E-Mails und löscht alle Unterordnern, die nicht zu
168
          einem Offenen Beleg gehören. Importierte E-Mails werden werden nicht
169
          gelöscht, erst beim Löschen des Unterordners werden sie gelöscht.
170
        </p><p>
171
          Es können auch E-Mails in kivitendo importiert werden, die nicht zu
172
          einem Beleg gehören. Dafür kann der Hintergrund-Job
173
          '<code class="literal">SyncEmailFolder</code>' verwendet werden. Dieser
174
          synchronisiert standartmäßig den Ordner der in
175
          '<code class="literal">base_folder</code>' angegeben ist. Dies kann mit dem
176
          Job-Parameter '<code class="literal">folder</code>' geändert. Die Importierten
177
          E-Mails werden im E-Mail-Journal gespeichert.
178
        </p><p>
179
          Beim Umzug des E-Mail-Servers kann kivitendo die E-Mails schon
180
          importierten E-Mails nicht mehr erkennen. Dies führt dazu, dass alle
181
          E-Mails erneut importiert werden.
182
        </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s10.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s12.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.10. Drucker- und Systemverwaltung&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.12. Drucken mit kivitendo</td></tr></table></div></body></html>

Auch abrufbar als: Unified diff