Revision 0cd4fff0
Von Max Wessendorf vor 10 Monaten hinzugefügt
doc/html/ch02s12.html | ||
---|---|---|
1 | 1 |
<html><head> |
2 | 2 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
3 |
<title>2.12. 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="ch02s11.html" title="2.11. Drucker- und Systemverwaltung"><link rel="next" href="ch02s13.html" title="2.13. 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.12. E-Mail</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s11.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="ch02s13.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.12. E-Mail"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Email"></a>2.12. 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.12.1. E-Mail-Versand aus kivitendo heraus"><div class="titlepage"><div><div><h3 class="title"><a name="config.sending-email"></a>2.12.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.12.1.1. Versand über lokalen E-Mail-Server"><div class="titlepage"><div><div><h4 class="title"><a name="config.sending-email.sendmail"></a>2.12.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.12.1.2. Versand über einen SMTP-Server"><div class="titlepage"><div><div><h4 class="title"><a name="config.sending-email.smtp"></a>2.12.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.12.2. Versendete E-Mails über IMAP exportieren"><div class="titlepage"><div><div><h3 class="title"><a name="config.sent_emails_in_imap"></a>2.12.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 |
|
69 |
ist, versehen wird. |
|
70 |
</p><p> |
|
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> |
|
77 |
</span></dt><dd><p> |
|
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> |
|
87 |
</span></dt><dd><p> |
|
88 |
Portnummer. Der Standardwert hängt von der verwendeten |
|
89 |
Verschlüsselungsmethode ab. Gilt '<code class="literal">ssl = 0</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> |
|
95 |
</span></dt><dd><p> |
|
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> |
|
103 |
</span></dt><dd><p> |
|
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> |
|
110 |
</span></dt><dd><p> |
|
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 |
|
122 |
einzuschränken. |
|
123 |
</p></div><div class="sect2" title="2.12.3. E-Mails in kivitendo importieren"><div class="titlepage"><div><div><h3 class="title"><a name="config.imap_client"></a>2.12.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> |
|
131 |
</span></dt><dd><p> |
|
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> |
|
141 |
</span></dt><dd><p> |
|
142 |
Portnummer. Der Standardwert hängt von der verwendeten |
|
143 |
Verschlüsselungsmethode ab. Gilt '<code class="literal">ssl = 0</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> |
|
149 |
</span></dt><dd><p> |
|
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> |
|
157 |
</span></dt><dd><p> |
|
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> |
|
164 |
</span></dt><dd><p> |
|
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 werden nicht |
|
180 |
gelöscht, erst beim Löschen des Unterordners werden sie gelöscht. |
|
181 |
</p><p> |
|
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. |
|
189 |
</p><p> |
|
190 |
Beim Umzug des E-Mail-Servers kann kivitendo die E-Mails schon |
|
191 |
importierten 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="ch02s11.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="ch02s13.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.11. 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.13. Drucken mit kivitendo</td></tr></table></div></body></html> |
|
3 |
<title>2.12. Drucker- und Systemverwaltung</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="ch02s11.html" title="2.11. Mandanten-, Benutzer- und Gruppenverwaltung"><link rel="next" href="ch02s13.html" title="2.13. E-Mail"></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.12. Drucker- und Systemverwaltung</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s11.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="ch02s13.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.12. Drucker- und Systemverwaltung"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Drucker--Systemverwaltung"></a>2.12. Drucker- und Systemverwaltung</h2></div></div></div><p>Im Administrationsmenü gibt es ferner noch die beiden Menüpunkte |
|
4 |
Druckeradministration und System.</p><div class="sect2" title="2.12.1. Druckeradministration"><div class="titlepage"><div><div><h3 class="title"><a name="Druckeradministration"></a>2.12.1. Druckeradministration</h3></div></div></div><p>Unter dem Menüpunkt Druckeradministration lassen sich beliebig |
|
5 |
viele "Druckbefehle" im System verwalten. Diese Befehle werden |
|
6 |
mandantenweise zugeordnet. Unter Druckerbeschreibung wird der Namen |
|
7 |
des Druckbefehls festgelegt, der dann in der Druckerauswahl des Belegs |
|
8 |
angezeigt wird.</p><p>Unter Druckbefehl definiert man den eigentlichen Druckbefehl, |
|
9 |
der direkt auf dem Webserver ausgeführt wird, bspw. 'lpr -P |
|
10 |
meinDrucker' oder ein kompletter Pfad zu einem Skript |
|
11 |
(/usr/local/src/kivitendo/scripts/pdf_druck_in_verzeichnis.sh). Wird |
|
12 |
ferner noch ein optionales Vorlagenkürzel verwendet, wird dieses |
|
13 |
Kürzel bei der Auswahl der Druckvorlagendatei mit einem Unterstrich |
|
14 |
ergänzt, ist bspw. das Kürzel 'epson_drucker' definiert, so wird beim |
|
15 |
Ausdruck eines Angebots folgende Vorlage geparst: |
|
16 |
sales_quotation_epson_drucker.tex.</p></div><div class="sect2" title="2.12.2. System sperren / entsperren"><div class="titlepage"><div><div><h3 class="title"><a name="System"></a>2.12.2. System sperren / entsperren</h3></div></div></div><p>Unter dem Menüpunkt System gibt es den Eintrag 'Installation |
|
17 |
sperren/entsperren'. Setzt man diese Sperre so ist der Zugang zu der |
|
18 |
gesamten kivitendo Installation gesperrt.</p><p>Falls die Sperre gesetzt ist, erscheint anstelle der |
|
19 |
Anmeldemaske die Information: 'kivitendo ist momentan zwecks |
|
20 |
Wartungsarbeiten nicht zugänglich.'.</p><p>Wichtig zu erwähnen ist hierbei noch, dass sich kivitendo |
|
21 |
automatisch 'sperrt', falls es bei einem Versionsupdate zu einem |
|
22 |
Datenbankfehler kam. Somit kann hier nicht aus Versehen mit einem |
|
23 |
inkonsistenten Datenbestand weitergearbeitet werden.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s11.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="ch02s13.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.11. Mandanten-, Benutzer- und Gruppenverwaltung </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.13. E-Mail</td></tr></table></div></body></html> |
Auch abrufbar als: Unified diff
Html und PDF Doku updated