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

  "Docuvita": [
    {
      "FieldName": "DvServerAddress",
      "FieldTyp": "S",
      "FieldValue": "https://localhost/server/services",
      "FieldDesription": "URL of the docuvita server"
    },
    {
      "FieldName": "DvUseSingleSignOn",
      "FieldTyp": "B",
      "FieldValue": false,
      "FieldDesription": "Use the docuvita ConfigPropertyegrated windows login instead of username/password for API-user"
    },
    {
      "FieldName": "MailObjectType",
      "FieldTyp": "N",
      "FieldValue": 5,
      "FieldDesription": "Objecttype for emails in docuvita"
    },
    {
      "FieldName": "FolderObjectType",
      "FieldTyp": "N",
      "FieldValue": 6,
      "FieldDesription": "Objecttype for mail folders in docuvita"
    },
    {
      "FieldName": "UserObjectType",
      "FieldTyp": "N",
      "FieldValue": 1,
      "FieldDesription": "Objecttype for users in docuvita"
    },
    {
      "FieldName": "AuthenticationConfigurationId",
      "FieldTyp": "N",
      "FieldValue": 1,
      "FieldDesription": "Id of the authentication modul"
    },
    {
      "FieldName": "GroupObjectType",
      "FieldTyp": "N",
      "FieldValue": 2,
      "FieldDesription": "Objecttype for groups in docuvita"
    },
    {
      "FieldName": "UserSmtpAddressesField",
      "FieldTyp": "S",
      "FieldValue": "user_mailaddress",
      "FieldDesription": "Name of the docuvita user field which contains the smtp addresses of the user. Default is \"User.Obj.Mailaddress\"."
    },
    {
      "FieldName": "GroupSmtpAddressesField",
      "FieldTyp": "S",
      "FieldValue": "",
      "FieldDesription": "Name of the docuvita group field which contains the smtp addresses of the user."
    },
    {
      "FieldName": "AutoCreateUsers",
      "FieldTyp": "B",
      "FieldValue": false,
      "FieldDesription": "Create AD users in docuvita (OperationMode=0 only): The docuvita system of the first postbox will be used!!"
    },
    {
      "FieldName": "UserNameMode",
      "FieldTyp": "N",
      "FieldValue": 1,
      "FieldDesription": "Wie soll der Benutzername in docuvita gebildet werden: 0 = ActiveDirectory Name (z.B. mydomain\\user1); 1 = Primäre SMTP-Adresse (damit können auch AD-Mails archiviert werden, wenn docuvita nicht in Domain) (default)"
    },
    {
      "FieldName": "SearchMailMessageId",
      "FieldTyp": "B",
      "FieldValue": true,
      "FieldDesription": "If true, then no search for the mailmessageid in docuvita is performed. Use loctype global and locvalue mailmessageid, mailsenddate "
    },
    {
      "FieldName": "NewUserGeneratePassword",
      "FieldTyp": "B",
      "FieldValue": false,
      "FieldDesription": " If set docuvita will generate a random password for new users. If not the system's standard password will be used."
    },
    {
      "FieldName": "NewUserPasswordStrength",
      "FieldTyp": "N",
      "FieldValue": 8,
      "FieldDesription": "Length of generated passwords for new users"
    }
  ]
FeldnameTypBezeichnung
DvServerAddressStringURL des docuvita-Servers
DvUseSingleSignOnBooleanWenn true, wird die Windows-Anmeldung verwendet (Der Dienstebenutzer wird für die Anmeldung bei docuvita verwendet.)
MailObjectTypeNumericObjekttyp-Id der E-Mail in docuvita
FolderObjectTypeNumericObjekttyp-Id des Ordners in docuvita
UserObjectTypeNumericObjekttyp-Id des Benutzer in docuvita
AuthenticationConfigurationIdNumericArt der Benutzeranmeldung bzw.der zu verwendender Anmeldeprovider
GroupObjectTypeNumericObjekttyp-Id der Benutzergruppe in docuvita
UserSmtpAddressesFieldStringName des docuvita-Benutzerfeldes, das die zu archivierenden E-Mail-Adressen beinhaltet. Kommagetrennte Liste
GroupSmtpAddressesFieldStringName des docuvita-Gruppenfeldes, das die zu archivierenden E-Mail-Adressen beinhaltet. z.B. Verteilergruppen.
AutoCreateUsersBooleanWenn true, dann werden ActiveDiretory-Benutzer in docuvita angelegt (bedingt OperationMode=0 ) sobald eine E-Mail archiviert wird
UserNameModeNumeric

Wie soll der Benutzername in docuvita gebildet werden:

  • 0 = ActiveDirectory Name (z.B. mydomain\\user1);
  • 1 = Primäre SMTPAdresse (damit können auch AD-Mails archiviert werden, wenn docuvita nicht in einer Domain integriert ist.) (default)
SearchMailMessageIdBooleanWenn true, wird nicht nach dem MailMessageId gesucht und ggf. die E-Mail kein weiteres mal archiviert.
NewUserGeneratePasswordBooleanWenn true, wird ein beliebiges Passwort für neu erstellte Benutzer automatisch generiert
NewUserPasswordStrengthNumericDie 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

  "ActiveDirectory": [
    {
      "FieldName": "ActiveDirectoryServer",
      "FieldTyp": "S",
      "FieldValue": "",
      "FieldDesription": " Name of the Active Directory Domain. If set this domain will be used. If not all AD functions will be disabled."
    },
    {
      "FieldName": "ActiveDirectoryUser",
      "FieldTyp": "S",
      "FieldValue": "",
      "FieldDesription": "Username for the active directory server"
    },
    {
      "FieldName": "ActiveDirectoryPassword",
      "FieldTyp": "S",
      "FieldValue": "",
      "FieldDesription": "Password for the active directory server"
    },
    {
      "FieldName": "UseNTLMAuth",
      "FieldTyp": "B",
      "FieldValue": false,
      "FieldDesription": " Use NTLM athentication for the AD-Server instead of username and password"
    },
    {
      "FieldName": "IsDominoServer",
      "FieldTyp": "B",
      "FieldValue": false,
      "FieldDesription": "If you use a dominoserver for ldap set this option true"
    }
  ]
FeldnameTypBeschreibung
ActiveDirectoryServerStringName oder IP-Adresse des ActiveDirectory-Servers.
ActiveDirectoryUserStringBenutzername mit dem die Authentifizeirung beim AD-Server stattfindet.
ActiveDirectoryPassword StringPasswort des angegebenen AD-Benutzers
UseNTLMAuthBooleanWenn true, wird die NTLM-Authentifikation für den AD-Server statt Benutzername und Passwort verwendet. Es wird der Dienstebenutzer verwendet.
IsDominoServerBooleanWenn true, dann handelt es sich um einen Domino-Server und nicht um einen ActiveDirectory-Server. (Beta-Status)

SMTP

 "Smtp": [
    {
      "FieldName": "SmtpHost",
      "FieldTyp": "S",
      "FieldValue": "localhost",
      "FieldDesription": " Hostname or IP address of the SMTP server for sending mails"
    },
    {
      "FieldName": "SmtpPassword",
      "FieldTyp": "S",
      "FieldValue": "",
      "FieldDesription": "SMTP Passwort for sending mails"
    },
    {
      "FieldName": "SmtpUser",
      "FieldTyp": "S",
      "FieldValue": "",
      "FieldDesription": "SMTP username - or what do you think?"
    },
    {
      "FieldName": "SmtpPort",
      "FieldTyp": "N",
      "FieldValue": 465,
      "FieldDesription": "SMTP server port (eg. 465 for SSL SMTP)"
    },
    {
      "FieldName": "SmtpSecure",
      "FieldTyp": "B",
      "FieldValue": true,
      "FieldDesription": "Use SMTP with SSL"
    },
    {
      "FieldName": "AcceptAllCertificates",
      "FieldTyp": "B",
      "FieldValue": true,
      "FieldDesription": "Accept all SSl-certificates"
    },
    {
      "FieldName": "MailNewUserNotification",
      "FieldTyp": "B",
      "FieldValue": false,
      "FieldDesription": "Sent notification with username and password to newly created users? User has to change his password on first logon to docuvita"
    },
    {
      "FieldName": "MailNewUserToAddress",
      "FieldTyp": "S",
      "FieldValue": "",
      "FieldDesription": "If set a notification with username and password is sent to this mail address when a new user has been created."
    },
    {
      "FieldName": "MailNewUserFromAddress",
      "FieldTyp": "S",
      "FieldValue": "",
      "FieldDesription": "the mail address which should be used as sender address"
    },
    {
      "FieldName": "LogImap",
      "FieldTyp": "B",
      "FieldValue": false,
      "FieldDesription": "If true all IMAP activity will be logged to [workingDir]\\ImapLog\\imap.log"
    },
    {
      "FieldName": "UserNotificationSubject",
      "FieldTyp": "S",
      "FieldValue": "Für Sie wurde ein docuvita-Benutzer angelegt",
      "FieldDesription": "Subject text for admin notification mails. Placeholders can be used: @@Username@@, @@Password@@, @@docuvitaURL@@"
    },
    {
      "FieldName": "UserNotificationBodyText",
      "FieldTyp": "S",
      "FieldValue": "Sehr geehrter doucvita Anwender,\r\n\r\n  soeben wurde für Sie ein neuer docuvita - Benutzer angelegt.\r\n  Hier sind Ihre Zugangsdaten:\r\n  Benutzername: @@USERNAME@@\r\n  Passwort: @@Password@@\r\n\r\n  Hier können Sie sich direkt anmelden: @@docuvitaURL@@\r\n  Bei der ersten Anmeldung müssen Sie Ihr Passwort ändern.\r\n\r\n  Mit freundlichen Grüßen\r\n  Ihr docuvita Team\r\n  support@docuvita - online.de",
      "FieldDesription": "Body text for admin notification mails. Placeholders can be used: @@Username@@, @@Password@@, @@docuvitaURL@@"
    },
    {
      "FieldName": "AdminNotificationSubject",
      "FieldTyp": "S",
      "FieldValue": "docuvita-Benutzer @@USERNAME@@ wurde automatisch angelegt",
      "FieldDesription": "Subject text for admin notification mails. Placeholders can be used: @@Username@@, @@Password@@, @@docuvitaURL@@"
    },
    {
      "FieldName": "AdminNotificationBodyText",
      "FieldTyp": "S",
      "FieldValue": "Folgender docuvita-Benutzer wurde soeben neu angelegt: @@USERNAME@@",
      "FieldDesription": "Body text for admin notification mails. Placeholders can be used: @@Username@@, @@Password@@, @@docuvitaURL@@"
    }
  ]
FeldnameTypBeschreibung
SmtpHostStringHost oder IP-Adresse des SMTP-Server
SmtpPasswordStringSMTP-Passwort
SmtpUserStringSMTP-Benutzer
SmtpPortNumericSMTP-Port
SmtpSecureBooleanWenn true, wird SSL beim Senden verwendet.
AcceptAllCertificatesBooleanAkzeptiert alle SSL-Zertifikate (auch ungültige)
MailNewUserNotificationBooleanWenn true, wird eine Benachrichtigungs E-Mail, bei der Erstellung eines neuen Benutzer, an die Benutzer E-Mail-Adresse gesendet.
MailNewUserToAdressBooleanZusätzlich kann auch bei der Erstellung eines neuen Benutzers eine Benachrichtigung (Admin) an diese Adresse gesendet werden.
MailNewUserFromAdressStringAbsender-E-Mail-Adresse für die Benachrichtigungen
LogImapBooleanWenn true, werden alle Imap-Aktivitäten mitprotokolliert. Das Log finden Sie im Work Ordner unter IMAPLOG
UserNotificationSubjectString

E-Mail Betreff der Benutzerenachrichtigungs-E-Mail. Folgende Platzhalter können verwendet werden:

  • @@username@@
  • @@password@@
  • @@docuvitaURL@@
UserNotificationBodyTextString

Nachricht der Benutzerbenachrichtigungs-E-Mail. Folgende Platzhalter können verwendet werden:

  • @@username@@
  • @@password@@
  • @@docuvitaURL@@
AdminNotificationSubjectString

Subjekt der Adminbenachrichtigungs-E-Mail. Folgende Platzhalter können verwendet werden:

  • @@username@@
  • @@password@@
  • @@docuvitaURL@@
AdminNotificationBodyTextString

Nachricht der Adminbenachrichtigungs-E-Mail. Folgende Platzhalter können verwendet werden:

  • @@username@@
  • @@password@@
  • @@docuvitaURL@@

Settings

"Settings": [
    {
      "FieldName": "WorkingDir",
      "FieldTyp": "S",
      "FieldValue": "c:\\docuvita\\EMailArchiver\\Work",
      "FieldDesription": " working directory for fetching mails"
    },
    {
      "FieldName": "OperationMode",
      "FieldTyp": "N",
      "FieldValue": 1,
      "FieldDesription": "Operation mode of the archiver: 0 = Active Directory, 1 = docuvita"
    },
    {
      "FieldName": "RunIntervall",
      "FieldTyp": "N",
      "FieldValue": 1,
      "FieldDesription": "Time between two batchrun in minutes"
    },
    {
      "FieldName": "MaxBatches",
      "FieldTyp": "N",
      "FieldValue": 99999,
      "FieldDesription": "Maximum batches of fetching mails: EMailArchiver will stop fetching and start archiving afterwards. After last batch EMailArchiver must be started again to fetch remaining mails"
    },
    {
      "FieldName": "NumMessages",
      "FieldTyp": "N",
      "FieldValue": 250,
      "FieldDesription": "Number of messages fetched per batch / Default: 250"
    }
  ]
FeldnameTypBeschreibung
WorkingDirStringArbeitsverzeichnis. In diese Verzeichnis werden die E-Mails temporär zwischengespeichert. In diesem Ordner werden auch die Blacklist E-Mails gespeichert.
OperationModeNumeric

Bertriebsmodus des Archiver

  • 0 = ActiveDirectory → Abfrage der E-Mail-Adressen erfolgt mittels LDAP an den angegebenen AD-Server
  • 1 = docuvita → Die Verwaltung der E-Mail-Adressen erfolgt nur über docuvita.
RunIntervallNumericZeit zwischen zwei Archivierungsläufen. Angabe in Minuten.
MaxBatchesNumericMaximale Anzahl der Verarbeitungsdurchgänge pro Archivierungslauf.
NumMessagesNumericMaximale Anzahl der Nachrichten die pro Verarbeitungsdurchgänge verarbeitet werden.

Monitoring

 "Monitoring": [
    {
      "FieldName": "StartTime",
      "FieldTyp": "S",
      "FieldValue": "23:00",
      "FieldDesription": "At this time monitoring wil be startet"
    },
    {
      "FieldName": "ToAddress",
      "FieldTyp": "S",
      "FieldValue": "admin@yourcompany.de",
      "FieldDesription": "Notification mails will be send to this address"
    },
    {
      "FieldName": "UseDocuvitaSmtp",
      "FieldTyp": "B",
      "FieldValue": true,
      "FieldDesription": "If true SMTP settings from docuvita is used. Otherwise use archiver SMTP settings"
    },
    {
      "FieldName": "SendAlwaysNotification",
      "FieldTyp": "B",
      "FieldValue": true,
      "FieldDesription": "If true,monitoring will send always a notification mail"
    },
    {
      "FieldName": "HeaderError",
      "FieldTyp": "S",
      "FieldValue": "Warnung dvs.EMailArchvier",
      "FieldDesription": "Subject text for notifivation mail at no archived mails in last 24hours."
    },
    {
      "FieldName": "HeaderOk",
      "FieldTyp": "S",
      "FieldValue": "Report dvs.EMailArchiver",
      "FieldDesription": "Subject text for notifivation mail if mails archived in last 24hours."
    }
  ]
FeldnameTypBeschreibung
StartTimeStringZu dieser Uhrzeit erfolgt die Überprüfung ob E-Mails in den letzten 24 Stunden archiviert worden sind.
ToAdressStringE-Mail-Adresse des Empfängers der Benachrichtigungsemail. Komma getrennte Liste möglich.
UseDocuvitaSmtpBoolean

Wenn true: Werden die docuvita-SMTP Einstellungen verwenden

Wenn false: Die SMTP Einstellungen aus der SMTP-Sektion werden verwendet.

SendAlwaysNotificationBooleanWenn true, sendet der Dienst nach jeder Überprüfung eine Benachrichtigungsemail.
HeaderErrorStringBetreff der Benachrichtigungsemail wenn bei der Überprüfung keine neuen E-Mails gefunden wurden.
HeaderOkStringBetreff 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

        "Imap": [
          {
            "FieldName": "ImapServer",
            "FieldTyp": "S",
            "FieldValue": "localhost",
            "FieldDesription": "Hostname or IP address of the IMAP-Server"
          },
          {
            "FieldName": "SecureOption",
            "FieldTyp": "S",
            "FieldValue": "Auto",
            "FieldDesription": "SecureSocketOptions.None \r\n SecureSocketOptions.Auto: Allow the MailKit.IMailService to decide which SSL or TLS options to use (default).\r\n SecureSocketOptions.SslOnConnect: The connection should use SSL or TLS encryption immediately.\r\n SecureSocketOptions.StartTls: Elevates the connection to use TLS encryption immediately after reading the\r\n      greeting and capabilities of the server. If the server does not support the\r\n      STARTTLS extension, then the connection will fail and a System.NotSupportedException\r\n      will be thrown.\r\n SecureSocketOptions.StartTlsWhenAvailable: Elevates the connection to use TLS encryption immediately after reading the\r\n      greeting and capabilities of the server, but only if the server supports\r\n      the STARTTLS extension."
          },
          {
            "FieldName": "ImapPort",
            "FieldTyp": "N",
            "FieldValue": 993,
            "FieldDesription": "Port of the IMAP-server (eg. 993 for SSL)"
          },
          {
            "FieldName": "ImapUserName",
            "FieldTyp": "S",
            "FieldValue": "user@somedomain.com",
            "FieldDesription": "Username for the imap account of the postbox"
          },
          {
            "FieldName": "ImapPassword",
            "FieldTyp": "S",
            "FieldValue": "SomePassword",
            "FieldDesription": "Guess - this is the password for the imap account!"
          },
          {
            "FieldName": "AcceptAllCertificates",
            "FieldTyp": "B",
            "FieldValue": true,
            "FieldDesription": "Accept all SSL-certificates"
          },
          {
            "FieldName": "DeleteMessages",
            "FieldTyp": "B",
            "FieldValue": true,
            "FieldDesription": "Delete messages from the imap server"
          },
          {
            "FieldName": "ImapFolder",
            "FieldTyp": "S",
            "FieldValue": "INBOX",
            "FieldDesription": "You can use a different folder for retrieving mails. Default is \"INBOX\" if not IncludeSubfolders"
          },
          {
            "FieldName": "IncludeSubfolders",
            "FieldTyp": "B",
            "FieldValue": true,
            "FieldDesription": "Recurse all subfolders of ImapFolder"
          },
          {
            "FieldName": "ExcludeFolders",
            "FieldTyp": "S",
            "FieldValue": "TRASH,JUNK,DRAFS,SPAM",
            "FieldDesription": "Exlude content of folders with these names"
          },
          {
            "FieldName": "UnreadMailsOnly",
            "FieldTyp": "B",
            "FieldValue": true,
            "FieldDesription": "Archive only mails marked as unread. Useful for testing with DeleteMessages=false"
          },
          {
            "FieldName": "SharedMailBox",
            "FieldTyp": "B",
            "FieldValue": false,
            "FieldDesription": "If office 365 shared mailbox is used, set to true"
          }
        ]
FeldnameTypBeschreibung
ImapServerStringHostname oder IP-Adresse des IMAP Servers
SecureOptionString

Ermöglicht dem MailKit die Entscheidung zu treffen, welche SSL oder TSL Einstellungen zu verwenden.


ImapPortNumericPort des IMAP Servers
ImapUsernameStringBenutzername des IMAP Kontos
ImapPasswordStringPasswort des IMAP Kontos
AcceptAllCetificatesBooleanAlle SSL-Zertifikate akzeptieren (auch ungültige)
DeleteMessageBooleanWenn true, wird die Nachricht nach dem erfolgreichen Download vom IMAP Server gelöscht.
ImapFolderStringIMAP Ordner. Standardmäßig heisst der Ordner Posteingang INBOX, eine andere Ordner auch ausgewählt werden.
IncludeSubfoldersBooleanWenn true dann werden auch die Unterverzeichnisse der IMAP Ordners berücksichtigt.
ExcludeFoldersStringDie auszuschließende Ordner. Mehrere Verzeichnisse können mit Komma getrennt werden.
UnreadMailsOnlyBooleanWenn true, werden nur die als ungelesenen markierten E-Mails heruntergeladen. Die E-Mails werden nach dem erfolgreichen Download als gelesen markiert.
SharedMailBoxBooleanWenn true, dann wird ein freigegebenes Postfach von Office365 verwendet.

b) docuvita

"Docuvita": [
          {
            "FieldName": "DvApiUsername",
            "FieldTyp": "S",
            "FieldValue": "EMailArchiver",
            "FieldDesription": "Username of the docuvita API user to be used for archiving"
          },
          {
            "FieldName": "DvApiPassword",
            "FieldTyp": "S",
            "FieldValue": "geheim",
            "FieldDesription": "Password for the API user"
          },
          {
            "FieldName": "AuthenticationConfigurationId",
            "FieldTyp": "N",
            "FieldValue": 1,
            "FieldDesription": "ID of the Authentication module responsible for newly created Users"
          },
          {
            "FieldName": "ArchiveParentObjectId",
            "FieldTyp": "N",
            "FieldValue": 6,
            "FieldDesription": "ObjectId of the parent object under which mails will be archived. -1 is used to archive mails hidden"
          },
          {
            "FieldName": "UseDateFolders",
            "FieldTyp": "B",
            "FieldValue": true,
            "FieldDesription": "Use folder structure Year/Month/Day for archiving"
          },
          {
            "FieldName": "MoveExistingMails",
            "FieldTyp": "B",
            "FieldValue": false,
            "FieldDesription": "Move already archived mails to the target folder. This can be helpful if you want to rearrange your mail archive by archiving old mails once again with the EmailArchiver (MailMessageId must be set to do so!)"
          },
          {
            "FieldName": "DvSystemId",
            "FieldTyp": "N",
            "FieldValue": 1,
            "FieldDesription": "ID if the docuvita system"
          },
          {
            "FieldName": "DvSystemAlias",
            "FieldTyp": "S",
            "FieldValue": "default",
            "FieldDesription": "System alias of the docuvita system"
          },
          {
            "FieldName": "UserParentObjectId",
            "FieldTyp": "N",
            "FieldValue": 0,
            "FieldDesription": "ID of the parent object for new users."
          },
          {
            "FieldName": "AccessRight",
            "FieldTyp": "N",
            "FieldValue": 15,
            "FieldDesription": "With this option, you can set the users access rights for archived mail. Default:15 Standard access right configurations: Approve = 65535, FullAccess = 63999, FullWithOutDelete = 63871, Read = 63503, ReadWithLimits = 15"
          }
        ]
FeldnameTypBeschreibung
DvApiUsernameStringBenutzername des docuvita-API-Benutzer, der für die Archivierung verwendet wird
DvApiPasswordStringPasswort des docuvita-API-Benutzer, der für die Archivierung verwendet wird
AuthenticationConfigurationIdNumericArt der Benutzeranmeldung bzw. der zu verwendender Anmeldeprovider
ArchiveParentObjectIdNumericObjekt-Id des übergeordneten Objekt, in dem die E-Mails archiviert werden.
UseDateFoldersBooleanWenn true, wird folgende Struktur für die Archivierung verwendet: Jahr/Monat/Tag
MoveExistingMailsBooleanAblegen bereits archivierter E-Mails in den von Ihnen gewünschten Ordnerstruktur. Sinnvoll für die Archivierung alter E-Mails mit dem EMailArchiver
DvSystemIdNumericSystem ID Ihres docuvita-Systems
DvSystemAliasStringSystemalias Ihres docuvita-Systems
UserParentObjectIdNumericParentElement für neue docuvita Benutzer
AccessRightNumericMit dieser Option können  die Zugriffsrechte für die archivierten E-Mails vergeben werden 

c) Setting

"Settings": [
          {
            "FieldName": "IsActive",
            "FieldTyp": "B",
            "FieldValue": true,
            "FieldDesription": "Fetch and archive this postbox"
          },
          {
            "FieldName": "ArchiveMode",
            "FieldTyp": "N",
            "FieldValue": 0,
            "FieldDesription": " 0 = As received, 1 = MS Exchange Journal (archive attached mail), 2 = Only attached mails (do not use envelope mail), 3 = Amtangee"
          },
          {
            "FieldName": "BackupFiles",
            "FieldTyp": "B",
            "FieldValue": false,
            "FieldDesription": "If true all messages and XML-files will be backed up in the working directory's subfolder 'backup'"
          },
          {
            "FieldName": "CreateAutoprofilerXml",
            "FieldTyp": "B",
            "FieldValue": false,
            "FieldDesription": "Create a XML file for autoprofiler (in subfolder autoprofiler of postbox's working directory)"
          },
          {
            "FieldName": "BlacklistFolder",
            "FieldTyp": "S",
            "FieldValue": "Blacklist",
            "FieldDesription": "Blacklisted mails will be moved to this folder.If empty, blacklisted mails will be deleted."
          }
        ],
        "BlacklistSender": [
          {
            "FieldName": "BlacklistSender",
            "FieldTyp": "S",
            "FieldValue": "healthmailbox*",
            "FieldDesription": "All mails from exchange healthmailbox"
          },
          {
            "FieldName": "BlacklistSender",
            "FieldTyp": "S",
            "FieldValue": "*@*.ru",
            "FieldDesription": "All mails with russian domain"
          }
        ],
        "BlacklistSubject": [
          {
            "FieldName": "BlacklistSubject",
            "FieldTyp": "S",
            "FieldValue": "{\\wv[il1][a@]gr[a@]}\\w",
            "FieldDesription": "All mails with subject viagra"
          }
        ],
        "BlacklistRecipient": [
          {
            "FieldName": "BlacklistRecipient",
            "FieldTyp": "S",
            "FieldValue": "blacklist.recipient@domain.gov",
            "FieldDesription": "If a recipient contains this emailaddres, mail is blacklist"
          }
        ]
FeldnameTypBeschreibung
IsActiveBooelanWenn true, werden E-Mail aus dem Postfach geholt und archiviert.
ArchiveModeNumeric

Archivierungsmodus :

  • 0 = As received
  • 1 = MS Exchange Journal (archive attached mail)
  • 2 = Only attached mails (do not use envelope mail)
  • 3 = Amtangee
BackupFilesBooleanWenn true, werden alle Nachrichten und XML-Dateien in dem Ordner 'backup' gesichert.
CreateAutoprofilerXmlBooleanWenn true, werden XML-Dateien für den Autoprofiler erstellt. Die Ablage erfolgt im Work Verzeichnis im Unterordner Autoprofiler.
BlacklistFolderStringDie als Blacklistmails markierte E-Mails werden in diesen Ordner verschoben. Wenn die betreffenhde E-Mails leer ist, wird sie gelöscht.
BlacklistSenderStringAlle E-Mails, deren Absender dem angegebenen Muster entsprechen, werden in den BlackList Ordner verschoben. Es kann hier mit Wildcards und RegEx gearbeitet werden.
BlacklistSubjectStringAlle E-Mails, deren Betreff dem angegebenen Muster entsprechen, werden in den BlackList Ordner verschoben. Es kann hier mit Wildcards und RegEx gearbeitet werden.
BlacklistRecipientStringAlle 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.

  File Modified

File dvs.EMailArchiver.config

16.01.2019 by Alexander Berndt

File beispiel_zwei_postboxen.config

16.01.2019 by Alexander Berndt

File beispiel_mehrere_Blacklisteinträge.config

16.01.2019 by Alexander Berndt

Verwandte Seiten


Copyright 2013-2020 docuvita solutions GmbH