Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision 23bb6a8c

Von Bernd Bleßmann vor 8 Monaten hinzugefügt

  • ID 23bb6a8cd6fe814df3914e325c2cc8f8fe59dfd5
  • Vorgänger a82a7940
  • Nachfolger 9cd3d899

Doku PDF/HTML neu gebaut

Unterschiede anzeigen:

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>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<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>&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="ch02s13.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.11. 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.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>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<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>&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="ch02s13.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.11. Mandanten-, Benutzer- und Gruppenverwaltung&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.13. E-Mail</td></tr></table></div></body></html>

Auch abrufbar als: Unified diff