Wiki & Dokumentation
Konfiguration - EMailArchiver
Version: 19.03.29
Im folgenden Abschnitt werden wir Ihnen zeigen, wie der EMailArchiver zu konfigurieren ist. Die Konfigurationsdatei befindet sich im Installationsodner im Unterordner Config. Sie verfügt über mehrere Sektionen, die hier der Reihenfolge nach beschrieben werden. Die hier beschriebe Konfiguration hat die Version 18.11.5.
Standardinstallationsordner
Der Standardinstallationsordner lautet C:\Program Files (x86)\docuvita\dvs.EMailArchiver
Änderung der Konfiguration
Nach der Änderung der Konfigurationsdatei ist ein Neustart des Dienstes dvs.EMailArchiver zwingend notwendig.
Docuvita
Feldname | Typ | Bezeichnung |
---|---|---|
DvServerAddress | String | URL des docuvita-Servers |
DvUseSingleSignOn | Boolean | Wenn true, wird die Windows-Anmeldung verwendet (Der Dienstebenutzer wird für die Anmeldung bei docuvita verwendet.) |
MailObjectType | Numeric | Objekttyp-Id der E-Mail in docuvita |
FolderObjectType | Numeric | Objekttyp-Id des Ordners in docuvita |
UserObjectType | Numeric | Objekttyp-Id des Benutzer in docuvita |
AuthenticationConfigurationId | Numeric | Art der Benutzeranmeldung bzw.der zu verwendender Anmeldeprovider |
GroupObjectType | Numeric | Objekttyp-Id der Benutzergruppe in docuvita |
UserSmtpAddressesField | String | Name des docuvita-Benutzerfeldes, das die zu archivierenden E-Mail-Adressen beinhaltet. Kommagetrennte Liste |
GroupSmtpAddressesField | String | Name des docuvita-Gruppenfeldes, das die zu archivierenden E-Mail-Adressen beinhaltet. z.B. Verteilergruppen. |
AutoCreateUsers | Boolean | Wenn true, dann werden ActiveDiretory-Benutzer in docuvita angelegt (bedingt OperationMode=0 ) sobald eine E-Mail archiviert wird |
UserNameMode | Numeric | Wie soll der Benutzername in docuvita gebildet werden:
|
SearchMailMessageId | Boolean | Wenn true, wird nicht nach dem MailMessageId gesucht und ggf. die E-Mail kein weiteres mal archiviert. |
NewUserGeneratePassword | Boolean | Wenn true, wird ein beliebiges Passwort für neu erstellte Benutzer automatisch generiert |
NewUserPasswordStrength | Numeric | Die Länge des automatisch generierten Passworts für neue Benutzer. |
Verwendung von Singel Sign On
Bei der Verwendung des SSO muss in docuvita ein entsprechender Anmeldeprovider hinterlegt sein.
ActiveDirectory
Feldname | Typ | Beschreibung |
---|---|---|
ActiveDirectoryServer | String | Name oder IP-Adresse des ActiveDirectory-Servers. |
ActiveDirectoryUser | String | Benutzername mit dem die Authentifizeirung beim AD-Server stattfindet. |
ActiveDirectoryPassword | String | Passwort des angegebenen AD-Benutzers |
UseNTLMAuth | Boolean | Wenn true, wird die NTLM-Authentifikation für den AD-Server statt Benutzername und Passwort verwendet. Es wird der Dienstebenutzer verwendet. |
IsDominoServer | Boolean | Wenn true, dann handelt es sich um einen Domino-Server und nicht um einen ActiveDirectory-Server. (Beta-Status) |
SMTP
Feldname | Typ | Beschreibung |
---|---|---|
SmtpHost | String | Host oder IP-Adresse des SMTP-Server |
SmtpPassword | String | SMTP-Passwort |
SmtpUser | String | SMTP-Benutzer |
SmtpPort | Numeric | SMTP-Port |
SmtpSecure | Boolean | Wenn true, wird SSL beim Senden verwendet. |
AcceptAllCertificates | Boolean | Akzeptiert alle SSL-Zertifikate (auch ungültige) |
MailNewUserNotification | Boolean | Wenn true, wird eine Benachrichtigungs E-Mail, bei der Erstellung eines neuen Benutzer, an die Benutzer E-Mail-Adresse gesendet. |
MailNewUserToAdress | Boolean | Zusätzlich kann auch bei der Erstellung eines neuen Benutzers eine Benachrichtigung (Admin) an diese Adresse gesendet werden. |
MailNewUserFromAdress | String | Absender-E-Mail-Adresse für die Benachrichtigungen |
LogImap | Boolean | Wenn true, werden alle Imap-Aktivitäten mitprotokolliert. Das Log finden Sie im Work Ordner unter IMAPLOG |
UserNotificationSubject | String | E-Mail Betreff der Benutzerenachrichtigungs-E-Mail. Folgende Platzhalter können verwendet werden:
|
UserNotificationBodyText | String | Nachricht der Benutzerbenachrichtigungs-E-Mail. Folgende Platzhalter können verwendet werden:
|
AdminNotificationSubject | String | Subjekt der Adminbenachrichtigungs-E-Mail. Folgende Platzhalter können verwendet werden:
|
AdminNotificationBodyText | String | Nachricht der Adminbenachrichtigungs-E-Mail. Folgende Platzhalter können verwendet werden:
|
Settings
Feldname | Typ | Beschreibung |
---|---|---|
WorkingDir | String | Arbeitsverzeichnis. In diese Verzeichnis werden die E-Mails temporär zwischengespeichert. In diesem Ordner werden auch die Blacklist E-Mails gespeichert. |
OperationMode | Numeric | Bertriebsmodus des Archiver
|
RunIntervall | Numeric | Zeit zwischen zwei Archivierungsläufen. Angabe in Minuten. |
MaxBatches | Numeric | Maximale Anzahl der Verarbeitungsdurchgänge pro Archivierungslauf. |
NumMessages | Numeric | Maximale Anzahl der Nachrichten die pro Verarbeitungsdurchgänge verarbeitet werden. |
Monitoring
Feldname | Typ | Beschreibung |
---|---|---|
StartTime | String | Zu dieser Uhrzeit erfolgt die Überprüfung ob E-Mails in den letzten 24 Stunden archiviert worden sind. |
ToAdress | String | E-Mail-Adresse des Empfängers der Benachrichtigungsemail. Komma getrennte Liste möglich. |
UseDocuvitaSmtp | Boolean | Wenn true: Werden die docuvita-SMTP Einstellungen verwenden Wenn false: Die SMTP Einstellungen aus der SMTP-Sektion werden verwendet. |
SendAlwaysNotification | Boolean | Wenn true, sendet der Dienst nach jeder Überprüfung eine Benachrichtigungsemail. |
HeaderError | String | Betreff der Benachrichtigungsemail wenn bei der Überprüfung keine neuen E-Mails gefunden wurden. |
HeaderOk | String | Betreff der Benachrichtigungsemail wenn bei der Überprüfung neuen E-Mails gefunden wurden. |
Postboxes
Postboxes sind die letzte Sektion in der Konfigurationsdatei, die wiederum aus 3 Sektionen besteht:
a) IMAP
Feldname | Typ | Beschreibung |
---|---|---|
ImapServer | String | Hostname oder IP-Adresse des IMAP Servers |
SecureOption | String | Ermöglicht dem MailKit die Entscheidung zu treffen, welche SSL oder TSL Einstellungen zu verwenden. |
ImapPort | Numeric | Port des IMAP Servers |
ImapUsername | String | Benutzername des IMAP Kontos |
ImapPassword | String | Passwort des IMAP Kontos |
AcceptAllCetificates | Boolean | Alle SSL-Zertifikate akzeptieren (auch ungültige) |
DeleteMessage | Boolean | Wenn true, wird die Nachricht nach dem erfolgreichen Download vom IMAP Server gelöscht. |
ImapFolder | String | IMAP Ordner. Standardmäßig heisst der Ordner Posteingang INBOX, eine andere Ordner auch ausgewählt werden. |
IncludeSubfolders | Boolean | Wenn true dann werden auch die Unterverzeichnisse der IMAP Ordners berücksichtigt. |
ExcludeFolders | String | Die auszuschließende Ordner. Mehrere Verzeichnisse können mit Komma getrennt werden. |
UnreadMailsOnly | Boolean | Wenn true, werden nur die als ungelesenen markierten E-Mails heruntergeladen. Die E-Mails werden nach dem erfolgreichen Download als gelesen markiert. |
SharedMailBox | Boolean | Wenn true, dann wird ein freigegebenes Postfach von Office365 verwendet. |
b) docuvita
Feldname | Typ | Beschreibung |
---|---|---|
DvApiUsername | String | Benutzername des docuvita-API-Benutzer, der für die Archivierung verwendet wird |
DvApiPassword | String | Passwort des docuvita-API-Benutzer, der für die Archivierung verwendet wird |
AuthenticationConfigurationId | Numeric | Art der Benutzeranmeldung bzw. der zu verwendender Anmeldeprovider |
ArchiveParentObjectId | Numeric | Objekt-Id des übergeordneten Objekt, in dem die E-Mails archiviert werden. |
UseDateFolders | Boolean | Wenn true, wird folgende Struktur für die Archivierung verwendet: Jahr/Monat/Tag |
MoveExistingMails | Boolean | Ablegen bereits archivierter E-Mails in den von Ihnen gewünschten Ordnerstruktur. Sinnvoll für die Archivierung alter E-Mails mit dem EMailArchiver |
DvSystemId | Numeric | System ID Ihres docuvita-Systems |
DvSystemAlias | String | Systemalias Ihres docuvita-Systems |
UserParentObjectId | Numeric | ParentElement für neue docuvita Benutzer |
AccessRight | Numeric | Mit dieser Option können die Zugriffsrechte für die archivierten E-Mails vergeben werden |
c) Setting
Feldname | Typ | Beschreibung |
---|---|---|
IsActive | Booelan | Wenn true, werden E-Mail aus dem Postfach geholt und archiviert. |
ArchiveMode | Numeric | Archivierungsmodus :
|
BackupFiles | Boolean | Wenn true, werden alle Nachrichten und XML-Dateien in dem Ordner 'backup' gesichert. |
CreateAutoprofilerXml | Boolean | Wenn true, werden XML-Dateien für den Autoprofiler erstellt. Die Ablage erfolgt im Work Verzeichnis im Unterordner Autoprofiler. |
BlacklistFolder | String | Die als Blacklistmails markierte E-Mails werden in diesen Ordner verschoben. Wenn die betreffenhde E-Mails leer ist, wird sie gelöscht. |
BlacklistSender | String | Alle E-Mails, deren Absender dem angegebenen Muster entsprechen, werden in den BlackList Ordner verschoben. Es kann hier mit Wildcards und RegEx gearbeitet werden. |
BlacklistSubject | String | Alle E-Mails, deren Betreff dem angegebenen Muster entsprechen, werden in den BlackList Ordner verschoben. Es kann hier mit Wildcards und RegEx gearbeitet werden. |
BlacklistRecipient | String | Alle E-Mails, deren Empfänger dem angegebenen Muster entsprechen, werden in den BlackList Ordner verschoben. Es kann hier mit Wildcards und RegEx gearbeitet werden. |
Archivierungshinweis
E-Mails im Blacklist Ordner werden nicht archiviert.
Beispielkonfigurationen
Nachfolgend finden Sie Beispielkonfigurationen zur Verdeutlichung verschiedener Anwendungsfälle, die durch die Konfigurationsdatei abgedeckt werden.
Verwandte Seiten
Copyright 2013-2020 docuvita solutions GmbH