Hilfe zum Webzugriff

Bitte aktivieren Sie JavaScript! Um diese Seite nutzen zu können, müssen Sie JavaScript für alle Quellen dieser Seite aktivieren.
Falls Sie NoScript verwenden, bitte für die Datei "bundle.js" eine Ausnahme hinzufügen. Diese Datei ist vertrauenswürdig.

zu " Dr.DOC Web "

Systemvoraussetzungen, Ausführung und Betrieb

Betrieb des Web Servers: Command Line Interface (CLI) / Befehlszeile, Dienst/Service, Logs

Mehr erfahren

E-Mail-Archivierung (IMAP)

Hinweis:

> Mit Dr.DOC gibt es drei E-Mail-Archivierungs-Möglichkeiten.
> In dieser Doku geht es um die E-Mail-Archivierung via Dr.DOC Web.
>
> | Produkt | Modul | Besonderheiten |
> | ------- | ----- | -------------- |
> | [Dr.DOC Netzwerk (C/S)](https://drdoc.com/node/de/products/n) | Dr.DOC Outlook Plugin | Vorgangsbezogene (oder automatische) Archivierung in MS **Outlook**/Plugin via Dr.DOC Netzwerk **Client** |
> | [Dr.DOC Netzwerk (C/S)](https://drdoc.com/node/de/products/n) | Dr.DOC Server Import | Automatisierte Archivierung am Dr.DOC Netzwerk Server via **Dateiimport** |
> | [Dr.DOC Web](https://drdoc.com/node/de/products/web) | Dr.DOC Web E-Mail-Archivierung (IMAP) | Automatisierte, regelbasierte Archivierung am Dr.DOC Web Server via **IMAP** |

Ziel der E-Mail-Archivierung via IMAP ist es, E-Mails automatisiert (unbeaufsichtigt) und regelbasiert zu archivieren.
Um die E-Mail-Archivierung regelbasiert zu steuern, werden folgende Einstellungen im Dr.DOC Web Konfigurationsarchiv &#8222;node&#8220; ausgelesen:

Type: `EmailAccountConfigWebNode`
Name: `config/email-account/<E-Mail-Account-Name>`

Beispel:
Name: `config/email-account`

Die Einstellungen werden nur beim Start des Dr.DOC Web Servers neu geladen. Damit eine Änderung wirksam wird, muss der Dienst neu gestartet werden.
Aus Sicherheitsgründen sollte der Datensatz nur für den Server und berechtigte Administratoren zugreifbar sein, indem der User auf "System-Group" gesetzt wird.

Eine Vererbung über den Prototype-Namen ist möglich; z.B. auf `config/email-account`, um bestimmte Einstellungen für alle Konten anzuwenden. Wenn Property Values aus dem Prototype geladen werden sollen, muss das &#8222;Inherit&#8220; Flag in der Property gesetzt sein.
Damit ist es möglich, die Einstellungen, die für alle User gültig sind, in den Node "config/email-account" abszuspeichern und in den Konten-Nodes (z.B. "config/email-account/test") den Prototype Name auf "config/email-account" setzen und nur die Properties zu setzen, die überschrieben werden sollen (z.B. "Email", "Password", "Archive\_SourceImapFolders", "Archive\_Target\_FieldPreselectionName").

Alle Properties haben den Type "`ConfigWebNode`".

| **Property Type** | **Property Name** | **Beschreibung** | **Mögliche Werte** |
| ------------- | ------------- | ------------ | -------------- |
| ConfigWebNode | **Enabled** | Gibt an, ob die Konfiguration aktiv ist | true, false |
| ConfigWebNode | **Email** | E-Mail-Adresse (z.B. test@mail.de) | |
| ConfigWebNode | **Password** | Passwort für SMTP/IMAP. Nach dem erstmaligen Eintragen wird das Passwort verschlüsselt. | |
| ConfigWebNode | **CheckSslCert** | Gibt an, ob das TLS/SSL Zertifikat des E-Mail-Servers geprüft werden soll | true, false |
| ConfigWebNode | **ImapHost** | Hostname des IMAP Servers (z.B. mail.de) | |
| ConfigWebNode | **ImapSSL** | Gibt an, ob eine verschlüsselte TLS/SSL Verbindung zum IMAP Server hergestellt werden soll | true, false |
| ConfigWebNode | **ImapPort** | IMAP Portnummer (z.B. 993) | |
| ConfigWebNode | **SmtpHost** | Hostname des SMTP Servers (z.B. mail.de) | |
| ConfigWebNode | **SmtpSSL** | Gibt an, ob eine verschlüsselte TLS/SSL Verbindung zum SMTP Server hergestellt werden soll | |
| ConfigWebNode | **SmtpPort** | SMTP Portnummer (z.B. 587) | |
| ConfigWebNode | **Archive\_Action** | <ul><li>"Tag":<ul><li>Markiert die E-Mail bei erfolgreicher Archivierung mit dem Tag/Keyword, welches in der Property "Archive\_SuccessTag" angegeben wurde;</li><li>Dubletten werden mit dem Wert markiert, der in der Property "Archive\_DuplicateTag" angegeben wurde.</li></ul></li><li>"Move":<ul><li>Verschiebt die E-Mail in ein Unterverzeichnis mit gleichem Namen wie das Quell-Verzeichnis.Die IMAP-Verzeichnisse werden automatisch erstellt und dürfen keinen "." oder "/" im Pfad-Segment enthalten. Der Verzeichnisname "`Dr. Doc`" wäre also ungültig.</li><li>Bei erfolgreicher Archivierung in das IMAP Verzeichnis, welches in der Property "Archive\_SuccessImapFolder" angegeben wurde. Beispiel: `<Archive_SuccessImapFolder>/<Source-Folder>`</li><li>Dubletten werden in das IMAP Verzeichnis verschoben, welches in der Property "Archive\_DuplicateImapFolder" angegeben wurde. Beispiel: `<Archive_DuplicateImapFolder>/<Source-Folder>`</li><li>Bei einem Fehler in das Verzeichnis, welches in der Property "Archive\_ErrorImapFolder" angegeben wurde. Beispiel: `<Archive_ErrorImapFolder>/<Source-Folder>`</li></ul></li><li>"Delete":<ul><li>Löscht erfolgreich archivierte E-Mails</li></ul></li></ul> | Tag, Move, Delete |
| ConfigWebNode | **Archive\_SuccessTag** | Tag/Keyword für Property "Archive\_Action" mit dem Wert "Tag"; bei erfolgreicher Archivierung; Der Wert darf bei vielen IMAP Servern keine Leerzeichen oder Punkte enthalten | |
| ConfigWebNode | **Archive\_DuplicateTag** | Tag/Keyword für Property "Archive\_Action" mit dem Wert "Tag"; bei fehlgeschlagener Archivierung wegen Eingabedublettenprüfung (Schlüsselfeld "DS" mit Feldauswahl für Dublettenprüfung); Der Wert darf bei vielen IMAP Servern keine Leerzeichen oder Punkte enthalten | |
| ConfigWebNode | **Archive\_SuccessImapFolder** | Basis IMAP Verzeichnis für Property "Archive\_Action" mit dem Wert "Move"; bei erfolgreicher Archivierung | |
| ConfigWebNode | **Archive\_DuplicateImapFolder** | Basis IMAP Verzeichnis für Property "Archive\_Action" mit dem Wert "Move"; bei fehlgeschlagener Archivierung wegen Eingabedublettenprüfung (Schlüsselfeld "DS" mit Feldauswahl für Dublettenprüfung) | |
| ConfigWebNode | **Archive\_ErrorImapFolder** | Basis IMAP Verzeichnis für Property "Archive\_Action" mit dem Wert "Move"; bei fehlgeschlagener Archivierung wegen eines Fehlers | |
| ConfigWebNode | **Archive\_SourceImapFolders** | Quell IMAP Verzeichnis(se), in dem die E-Mails archiviert werden sollen. Pro Zeile ein Wert und darf nicht mit `/` beginnen. Es können auch Wildcards mit "`*`" angegeben und UND-Bedingungen mit "`&`" angegeben werden. z.B. "`INBOX`" oder "Eingangsrechnung" | |
| ConfigWebNode | **Archive\_Target\_UsermanagerName** | Ziel-Benutzerverwaltung Pfad zur Usermanager \*.BVD Datei | |
| ConfigWebNode | **Archive\_Target\_ArchiveName** | Ziel-Archiv Archiv-Name oder vollständiger Pfad zur KOMM\\SERVER\\\*.da Datei | |
| ConfigWebNode | **Archive\_Target\_FieldPreselectionName** | Anzuwendende Feldvorbelegung beim Erstellen des Datensatzes im Archiv "Archive\_Target\_ArchiveName". Über die gesetzten Feldwerte aus der Feldvorbelegung und den übernommenen E-Mail Feldern (z.B. ASCII Import-Definition "DD\_EMAIL") kann eine rekursive Archivierung getriggert werden. | |
| ConfigWebNode | **Archive\_Target\_Duplicate** | Gibt an, wie Dubletten beim Erstellen eines Dokuments behandelt werden sollen:<ul><li>"Drop": Dubletten verwerfen</li><li>"Replace": Dubletten ersetzen (Feldwerte können gelöscht werden)</li><li>"Change": Dublette ändern (nur gesetzte Feldwerte werden übertragen)</li></ul> | Drop, Replace, Change |
| ConfigWebNode | **OAuth2\_ClientId** | MS 365 / AAD: "Overview" -> "Aplication (client) ID" | |
| ConfigWebNode | **OAuth2\_Authority** | MS 365 / AAD: "Overview" -> "Directory (tenant) ID" z.B. `https://login.microsoftonline.com/{tenantId}/v2.0` | |
| ConfigWebNode | **OAuth2\_Scopes** | MS 365 / AAD: "API permissions" -> "+Add a permission": Mehrere Einträge möglich (zeilenweise), z.B.: `https://outlook.office365.com/.default` Oder `openid` `email` `offline_access` `https://outlook.office.com/IMAP.AccessAsUser.All` Oder in älteren Konfigurationen: `https://ps.outlook.com/.default` | |
| ConfigWebNode | **OAuth2\_Secret** | MS 365 / AAD: "Certificates & secrets" -> "Client secrets" -> "+ New client secret": Text in Spalte "Value" abspeichern | |

### Microsoft Office 365

Microsoft 365 benötigt einen OAuth2 Login. Das ist leider unnötig kompliziert.

1. Microsoft Azure Active Directory IAM (AAD IAM starten und App hinzufügen mit IMAP Rechten)
 Siehe dazu:
 https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app
 1. https://portal.azure.com/#view/Microsoft\_AAD\_IAM/ActiveDirectoryMenuBlade/\~/Overview
 1. Register new App (+): https://portal.azure.com/#view/Microsoft\_AAD\_RegisteredApps/CreateApplicationBlade/isMSAApp\~/false
 2. "Authentication"
 1. "Platform configuration", "+ Add a platform" -> "Mobile and desktop applications"
 Redirect URIs: "`http://localhost`"
 2. "Advanced settings" -> "Allow public client flows": `Yes`
 3. "Certificates & secrets" -> "Client secrets" -> "+ New client secret": Text in Spalte "Value" abspeichern
 4. "API permissions" -> "+Add a permission" (mit "\*" sind optional, wenn E-Mails auch versendet werden sollen)
 1. API "Microsoft Graph" -> "Delegated permission"
 1. OpenId permissions
 1. `email`
 2. `offline_access`
 3. `openid`
 2. SMTP
 1. \* `SMTP.Send`
 3. User
 1. `User.Read`
 4. IMAP
 1. `IMAP.AccessAsUser.All`
 2. API "Office 365 Exchange Online" -> "APIs my organization uses" -> search "Office 365 Exchange Online" -> "Application permissions"
 1. IMAP
 1. `IMAP.AccessAsApp`
 2. Mail
 1. \* `Mail.Read`
 2. \* `Mail.Send`
 3. SMTP
 1. \* `SMTP.SendAsApp`
 3. Check "Grant admin consent for \<Tenant-Name>"
 5. Besitzer der App festlegen via Menü "Owners"
 6. Evtl.: Benutzer der App hinzufügen:
 1. https://portal.azure.com/?feature.msaljs=true#view/Microsoft\_AAD\_UsersAndTenants/UserManagementMenuBlade/\~/AllUsers
 2. Benutzer wählen
 3. "Authentication methods" ->
 7. "Overview" Access Points abspeichern (siehe 2. unten)
 1. Application (client) ID
 2. Directory (tenant) ID
2. In den Einstellungen für E-Mail-Archivierung folgenden Eigenschaften setzen:
 * OAuth2\_ClientId = siehe "Overview" -> "Aplication (client) ID"
 * OAuth2\_Authority = siehe "Overview" -> "Directory (tenant) ID": `https://login.microsoftonline.com/<Dierctory (tenant) ID>/oauth2/v2.0/authorize`
 * OAuth2\_Scopes = siehe "API Permissions":
 * `openid`
 `email`
 `offline_access`
 `https://outlook.office.com/IMAP.AccessAsUser.All`
 * OAuth2\_Secret = siehe "Certificates & secrets" -> "Client secrets"

#### Variante A: Als Desktop App starten

1. Die App `DrDoc.WebServerService.exe` als normale Anwendung starten und nicht als Dienst
2. Es öffnet sich ein Web Browser Fenster. Bitte mit entsprechendem Konto anmelden, um der E-Mail-Archivierung die nötige Berechtigung zu erteilen.
3. Wenn die Anmeldung erfolgreich war, kann Dr.DOC Web wieder als Dienst verwendet werden.

#### Variante B: PowerShell Script als Admin:

```ps
$AppId = "32d78307-96a6-4d33-k871-7d65d7ae345d"
$TenantId = "485ed665-e9ea-4569-xc67-4152462107fe"
$Email = "mail@drdoc.onmicrosoft.com"
$DisplayName = "Some principal name for IMAP/POP3"

Install-Module -Name ExchangeOnlineManagement
Import-module ExchangeOnlineManagement
Connect-ExchangeOnline -Organization $TenantId

# Install-Module -Name AzureAD
# Import-module AzureAD
# Connect-AzureAd -Tenant $TenantId

($Principal = Get-AzureADServicePrincipal -filter "AppId eq '$AppId'")
$PrincipalId = $Principal.ObjectId

# New-ServicePrincipal -AppId $AppId -ObjectId <OBJECT_ID>
New-ServicePrincipal -AppId $AppId -ServiceId $PrincipalId -DisplayName $DisplayName
 
Get-ServicePrincipal | fl

Add-MailboxPermission -Identity $Email -User $PrincipalId -AccessRights FullAccess
```

Verzeichnisse und Dateien

Übersicht aller Dateien und Verzeichnisse für den Web Server

Mehr erfahren

Installation und Update

Anleitung zur Installation von Dr.DOC Web.

Mehr erfahren

Regex Autofelder

Regex Autofelder benötigen das tools Verzeichnis. Die Funktionalität ist mit dem erweiterten Update docSysExt.exe (mit dem Suffix Ext ) enthalten.
Es können z.B. Ticket-IDs, Rechnungsnummern, Firmennamen und E-Mail-Adressen automatisch aus einem OCR-Text-Feld ausgelesen werden.

Test auf: https://regexr.com/

### Format

`RX <Overwrite:1|0> <Source-Field> match <Regex> <Match-Nr>`

`RX <Overwrite:1|0> <Source-Field> replace <Regex> <Replace-Value>`

### Escape-Zeichen

Escape Chars: "/" (Slash) und " " (Space) MÜSSEN in der Regex Expression durch entsprechende escape Chars ersetzt werden:

| Zeichen | Escape-Zeichen |
| ------- | -------------- |
| " " (Space) | `\x20` |
| "/" (Slash) | `\x2F` |

### Beispiele

:: Beispiel für: 1. Match Ergebnis aus ocr\_text
`RX 0 ocr_text match <Regex> 1`

:: Zeile nach Match "Rechnungsnr.":
`(?<=\sRechnungsnr\.:.*\r?\n\x20*)(.*)(?=[\r\n]*)`

:: Letzte Änderung (Regex): 20.06.2023 17:17 Uhr

:: Rechnungs-Nummer
`RX 0 ocr_text match (?<=(?:Rechnung|Beleg|Invoice|Inv|Re\.)s?[\.\x20\-]{0,5}(?:nr|nummer|Number|reference|ref|ID|No)+?[\.\:\x20]{0,5}[\x20]{0,20})(([0-9A-Za-z_]{1,40}(?=\s(vom|v\.|\x2F)\x20([0-9]{1,2}\.[0-9]{1,2}\.[0-9]{2,4})))|([0-9A-Za-z_]{1,40}(?=\s\s+))|([0-9A-Za-z_]{1,40}([0-9A-Za-z]{0,30}[_\-\x20\x2F]?){0,4})) 1`

:. Rechnungsnummer aus einer Bank-Transaktion:
`(?<=^|\s|\n(RG|Invoice|Inv|Rechnung|RE)?((\.|\-)(No|Nr|Num))?\.?\:?\x20?)(RE|INV|RG)?[0-9]{3,20}((\/|\-)[0-9]{2,20}((\/|\-)[0-9]{2,20})?)?(?=$|\s|\n|\/)`

:: Normales Datum
`RX 0 ocr_text match [0-9]{1,2}\.[0-9]{1,2}\.[0-9]{2,4}|[0-9]{1,2}\.?\x20\w{3,10}\.\x20[0-9]{2,4}|[0-9]{1,2}\x2F[0-9]{1,2}\x2F[0-9]{2,4} 1`

:: Rechnungsdatum
`RX 0 ocr_text match (?<=(?:Rechnung|Rechnungs|Beleg|Invoice|Credit\x20Note|)*?[\x20\-]{0,5}(?:Datum|Date|([0-9]{3,20}\x20?\x2F))[\.\:\x20]{0,20})([0-9]{1,2}\.[0-9]{1,2}\.[0-9]{2,4}|[0-9]{4,4}\-[0-9]{2,2}\-[0-9]{2,2}|[0-9]{1,2}\.?\x20\w{3,10}\.?\x20[0-9]{2,4}|[0-9]{1,2}\x2F[0-9]{1,2}\x2F[0-9]{2,4}) 1`

:: Lieferdatum
`RX 0 ocr_text match (?<=(?:Leistung|Service|Liefer)s?[\x20\-]{0,5}(?:Datum|Date|([0-9]{3,20}\x20?\x2F))[\.\:\x20]{0,20})([0-9]{1,2}\.[0-9]{1,2}\.[0-9]{2,4}|[0-9]{4,4}\-[0-9]{2,2}\-[0-9]{2,2}|[0-9]{1,2}\.?\x20\w{3,10}\.?\x20[0-9]{2,4}|[0-9]{1,2}\x2F[0-9]{1,2}\x2F[0-9]{2,4}) 1`

:: Leistungsdatum
`(?<=(?:Leistungs|Service)[\x20\-]{0,5}(?:Zeitraum|Zeitpunkt|Datum|Date)[\.\:\x20]{0,20})([0-9]{1,2}\.[0-9]{1,2}\.[0-9]{2,4}|[0-9]{4,4}\-[0-9]{2,2}\-[0-9]{2,2}|[0-9]{1,2}\.?\x20\w{3,10}\.?\x20[0-9]{2,4}|[0-9]{1,2}\x2F[0-9]{1,2}\x2F[0-9]{2,4})(?=\s)`

:: Anfrage Ticket [#DRDOC#1234]
`RX 0 ocr_text match (?<=[#DRDOC#)[0-9][^]]+ 1`

:: USt-Id DE12345678
`RX 0 ocr_text match (?<=(\x20))[A-Z]{2}\x20?[0-9]{8,10} 1`

:: IBAN
`RX 0 ocr_text match (?<=IBAN:?\x20)[A-Z]{2}(?:[\x20]?[0-9]){18,20} 1`

:: Firma/Kunde/Lieferanten-Name
`RX 0 ocr_text match (?<=\s)([A-Za-z]{1,30}([\+\&\.\-\x20]{0,3}[A-Za-z0-9äöüß]*){0,4}\x20(Inc\.?|PLC|GmbH\x20?\&\x20Co\.?\x20?KG|GmbH|UG|KG|SE|e\.?v\.?|e\.?G\.?|Gesellschaft\x20?mbH|AG|Aktiengesellschaft|Ltd\.?))(?<!Dr\.\x20?Doc\x20?(GmbH)?)(?=\s|\,|\·|\|) 1`

:: Kundennummer
`RX 0 ocr_text match (?<=(Kunden|Kdn|Kd|Customer)[\.\-\x20]{0,5}(Nr|nummer|ID|No)[\.\:\x20]{0,5})([0-9\-]+) 1`

:: E-Mail
`RX 0 ocr_text match (?<=\s)[a-z-\.]{1,20}@[a-z-\.]{1,20}\.[a-z]{1,5}(?=\s) 1`

:: E-Mail (ohne ..@drdoc.com)
`RX 0 note match (?<=\s)[a-z-\.]{1,20}@[a-z-\.]{1,20}\.[a-z]{1,5}(?=\s)(?<!@drdoc\.com) 1`

:: PLZ
`RX 0 note match (?<=\s([a-z]{1,3}[-\x20]?)?)[0-9]{4,5}(?=\x20([a-zöäü]{2,30}[-\x20]?){1,3}\s) 1`

:: PLZ (ohne 80807)
`RX 0 note match (?<=\s([a-z]{1,3}[-\x20]?)?)[0-9]{4,5}(?=\x20([a-zöäü]{2,30}[-\x20]?){1,3}\s)(?<!80807) 1`

:: Ort
`RX 0 note match (?<=\s([a-z]{1,3}[-\x20]?)?[0-9]{4,5}\x20)([a-zöäü]{2,30}[-\x20]?){1,3}(?=\s) 1`

:: Ort (ohne 80807 München)
`RX 0 note match (?<!80807\x20)(?<=\s([a-z]{1,3}[-\x20]?)?[0-9]{4,5}\x20)([a-zöäü]{2,30}[-\x20]?){1,3}(?=\s) 1`

:: Straße
`RX 0 note match ([a-zöäüß]+\.?[\x20\-]?){1,4}(Str\.|Str|Straße|Platz|Street|Plaza)\x20[0-9]{1,3}(\-[0-9]{1,3})?[a-z]? 1`

:: Straße (ohne Heinrich-Kley-Str. 2)
`RX 0 note match ([a-zöäüß]+\.?[\x20\-]?){1,4}(Str\.|Str|Straße|Platz|Street|Plaza)\x20[0-9]{1,3}(\-[0-9]{1,3})?[a-z]?(?<!Heinrich-Kley-Str(\.?|aße)\x202)(?=\s) 1`

:: Telephon/Phone
`RX 0 note match (?<=\s)[\+$0]([0-9\x20\-$\&#8211;\+\x2F$\.]){3,7}$?[0-9\x20\-\)\&#8211;\+\x2F\(]{1,20}(?=\s)`

Rekursive Archivierung (Document Encoder/Decder)

Document Decoder:
Der Zweck der rekursiven Archivierung ist das strukturierte Auslesen (Dokument zu Metadaten) mit deren Inhalten (z.B. E-Mail-Anhänge) durch regelbasierte Archivierung.
Diese Funktion ist sinnvoll für "zusammengesetzte" und &#8222;verschachtelte&#8220; Dateiformate (z.B. E-Mails).
Beispiel: archiviere nur die PDFs aus einer E-Mail, wobei die Anhänge nicht mit &#8222;AGB&#8220; beginnen dürfen und falls darin eine ZugFerd XML enthalten ist, übertrage die Rechnungsinformationen in die Metainfo.

Document Encoder:
Für einige Dateiformate ist es möglich, diesen Vorgang umzukehren (Metadaten zu Dokument) und aus den Metadaten wieder ein Dokument zu generieren (derzeit nur Termine, Aufgaben, Kontakte, CSV). Das findet Verwendung bei der Nutzung von CalDAV und CardDAV sowie dem Export.
 
Die Funktionen der rekursiven Archivierung kann mit der E-Mail-Archivierung kombiniert werden.
 
Jedes Dateiformat hat bestimmte Felder die über eine Dr.DOC Feldauswahl &#8222;gemappt&#8220; werden. Der Name der Standard-Feldauswahl fängt in der Regel mit &#8222;DD\_&#8220; an.
Über die rekursiven Archivierungs Regeln können spezielle Definitionen erstellt werden.
Beispiel: Aus einer E-Mail wird eine eine ZIP-Datei gelesen, daraus soll ein PDF Dokument archiviert werden, aber die Metadaten sollen aus der Embedded XML aus der PDF-Datei geholt werden.

| **Dokumenten-Format** | **Extensions** | **Mapping** | **Rekursiv?** | |
| ----------------- | ---------- | ------- | --------- | --- |
| **PDF Dokument** | \*.pdf, \*.tiff, \*.tif | OCR Text über Archivspezifische INI im FORM-Verzeichnis: [PDF\_TEXT] Fieldname=\<OCR-Feldname> | Embedded Files archivieren; z.B. Xrechnung.xml oder zugferd xml rekursiv archivieren | |
| **E-Mail** | \*.eml, \*.msg | Default Feldauswahl ASCII-Import-Definition &#8222;DD\_EMAIL&#8220;:<ul><li>FROM</li><li>FROM\_NAME</li><li>FROM\_ADDRESS</li><li>TO</li><li>TO\_NAME</li><li>TO\_ADDRESS</li><li>BCC</li><li>BCC\_NAME</li><li>BCC\_ADDRESS</li><li>CC</li><li>CC\_NAME</li><li>CC\_ADDRESS</li><li>SUBJECT</li><li>DATETIME</li><li>DATE</li><li>TIME</li><li>ID</li><li>BODY</li><li>BODY\_TEXT</li><li>BODY\_HTML</li></ul> | Anhänge und Termine | |
| **XML** | \*.xml | Default Feldauswahl ASCII-Import-Definition &#8222;DD\_XML&#8220;: | | |
| **CSV** | \*.csv | Default Feldauswahl ASCII-Import-Definition &#8222;DD\_CSV&#8220;: | Zeilen als neuen Datensatz | |
| **JPEG** | \*.jpg, \*.jpeg | Feldauswahl ASCII-Import-Definition &#8222;DD\_JPG&#8220;:<ul><li>LOCATION (GPS Location)</li><li>DATE (Aufnahme-Datum auslesen)</li><li>TIME (Aufnahme-Zeit auslesen)</li><li>DATETIME (Aufnahme-Datum/Zeit auslesen)</li></ul> | | |
| **ZIP** | \*.zip | | Alle Dateien / Entries | |
| **Termine iCal** **Ausgabe, Notiz, Journal, Termin** | \*.ics | Feldauswahl "Kalender-Terminfelder"-Definition &#8222;DD\_EVENT&#8220; für Termine, Feldauswahl "Kalender-Aufgabenfelder"-Definition &#8222;DD\_TASK&#8220; für Aufgaben, Feldauswahl "Kalender-Terminfelder"-Definition &#8222;DD\_NOTE&#8220; für Notizen/Journal:<ul><li>ID</li><li>Location</li><li>CalStartDateTime</li><li>CalStartDate</li><li>CalStartTime</li><li>CalEndDateTime</li><li>CalEndDate</li><li>CalEndTime</li><li>CalCompleted</li><li>Priority</li><li>CalSubject</li><li>CalUser</li><li>CalText</li><li>Categories</li><li>CalDuration</li><li>CalSeriesPeriod</li><li>CalRemDeadline</li></ul> | | |
| **Kontakte V-Card** | \*.vcf | Feldauswahl ASCII-Import-Definition &#8222;DD\_CONTACT&#8220;:<ul><li>NAME</li><li>PRENAME</li><li>LASTNAME</li><li>TITLE</li><li>ORG</li><li>BIRTHDAY</li><li>EMAIL</li><li>EMAIL<1-5></li><li>PHONE</li><li>PHONE<1-5></li><li>FAX</li><li>FAX<1-5></li><li>STREET</li><li>CITY</li><li>REGION</li><li>ZIP</li><li>COUNTRY</li><li>NOTE</li><li>WEB</li></ul> | | |

REST API

Die REST API für Dr.DOC Web ist eine Daten-Schnittstelle. Hier finden Sie die Dokumentation.

Mehr erfahren

OCR-Texterkennung und automatische Belegtrennung via Barcode am Dr.DOC Netzwerk Server

> **Wichtiger Hinweis**: bitte beachten Sie beim Import am Server, bei (wenn alle Kriterien zutreffen):
>
> * Verwendung des Dubletten-Schlüsselfelds "DS"
> * Feldauswahl für Eingabedubletten
> * Feldvorbelegung "%F%" oder Autofeld "F"
>
> Grund: Bei der Belegtrennung bekommen **beide** Dateien (bei Belegtrennung) den selben Dateinamen. Das kann zu unerwünschten Dubletten-Fehlern beim Import führen (Duplicate entry: DS wird verworfen oder ersetzt).

## Option 1: Keine Scan-Jobs (PDF oder TIFF)

Diese Option bietet sich an, wenn PDFs archiviert werden sollen und/oder noch keine Scan-Jobs konfiguriert wurden.

Am Server in INI-Datei "`KOMM\DOCUIMP.INI`" bzw. der Verzeichnis-Import INI folgende Konfiguration vornehmen:

```ini
[DEFAULT_ASCII]
; oder Extension-spezifisch: [pdf]
Feldvorbelegung=<Name-Feldvorbelegung>
DateiTypDokumente=*
LinkNr=AutoLink
DokumenteImportieren=1

; Option 1: Barcode-Trennung + KEINE OCR + Extern-Link
BarcodeTrennung=1
; Option 2: Barcode-Trennung + OCR + Extern-Link
BarcodeTrennung=2
```

Am Server in INI-Datei, Archivspezifische INI im Formverzeichnis ("`FORM\<Archiv-Name>.ini`"): Feldname für OCR-Feld eintragen

```ini
[BARCODE_TEXT]
Fieldname=<Barcode-Feldname>
```

Am Server in INI-Datei, "`%appdata%\ARCHIV.INI`" und "`%programdata%\ARCHIV.INI`":

```ini
[OCR_SCANNEN]
BARCODE=1
OCR=1
SCHWELLWERT=0.00
; Für Intern-Link
EXTENDED=1
; Timeout erhöhen, da die OCR Sequentiell und nicht parallel ausgeführt wird.
[SERVICE]
TIMEOUT=10
[BARCODESETTINGS]
; Key "Types" nicht definieren, um alle Barcode-Type zuzulassen, ansonsten
; QR-Code: 65536
; Code-128: 4
; EAN-8: 8
; EAN-13: 16
; Codebar: 32
; UPCA: 1024
; UPCE: 2048
; PDF417: 8192
; Data-Matrix: 16384
; Data-Bar: 121072
Types=65536
```

## Option 2: Scan-Jobs (Intern-Link)

Diese Option bietet sich an, wenn TIFFs archiviert werden sollen oder/und bereits Scan-Jobs konfiguriert wurden.
Scan-Jobs sind über den Dr.DOC Client zu konfigurieren (Einstellungen -> Dokument-Quelle -> OCR-Scanner). Anschließend kann ein neues Dokument gescannt werden und die Einstellungen am Scan-Job vorgenommen werden (siehe Handbuch).
Folgende Dateien sind aus dem TMP-Verzeichnis an den Dr.DOC Server-Service TMP-Verzeichnis zu übertragen:

* \*.tcf
* \*.rlt
* scanjobjs.job

Am Server in INI-Datei "`KOMM\DOCUIMP.INI`" bzw. der Verzeichnis-Import INI folgende Konfiguration vornehmen:

```ini
[DEFAULT_ASCII]
; oder Extension-spezifisch: [pdf]
Feldvorbelegung=<Name-Feldvorbelegung>
LinkNr=BilddateiIntern
DateiTypDokumente=*

; Option 1: Barcode-Trennung + OCR + Scan-Job + Intern-Link
DokumenteImportieren=2
BarcodeTrennung=1
; Nummer des Scan-Jobs
ScanJob=1

; Option 2: KEINE Barcode-Trennung + OCR + Scan-Job + Intern-Link
DokumenteImportieren=2
BarcodeTrennung=0
; Nummer des Scan-Jobs
ScanJob=1

; Option 3: Nur für TIFF Dokumente: KEINE Barcode-Trennung + OCR + Scan-Job + Intern-Link
[tif]
LinkNr=BilddateiIntern
DokumenteImportieren=1
BarcodeTrennung=0
; Nummer des Scan-Jobs
ScanJob=1
```

Am Server in INI-Datei, "`%appdata%\ARCHIV.INI`" und "`%programdata%\ARCHIV.INI`":

```ini
[OCR_SCANNEN]
BARCODE=1
OCR=1
SCHWELLWERT=0.00
EXTENDED=1
[PDF]
; OCR wird immer ausgeführt, auch bei durchsuchbaren PDFs
RENDERING=1
```

Dr.DOC Standard

# Archive administrieren

## Archivumgebung initialisieren und Pfade anpassen

`Dr.Doc.Standard.exe init:<API-KEY> ip:<IP-Adresse> port:<Port> env-init:<Archivumgebung-Basis-Verzeichnis>`
Beispiel:
`Dr.Doc.Standard.exe init:00001fjkdh ip:192.178.178.2 port:9995 env-init:D:\ARCHIV`

## Archiv umbenennen

`Dr.Doc.Standard.exe init:<API-KEY> bvd:<BVD-Pfad> "signin:<Username>:<Password>" rename-archive:<Old-Archive-Name>,<New-Archive-Name>`
Beispiel:
`Dr.Doc.Standard.exe init:00001fjkdh "bvd:%TARGET_DIR%\USER\user.bvd" "signin:PUBLIC:Gast" rename-archive:docs,doc`

## Archiv reorganisieren

### Ein Archiv reorganisieren

`Dr.Doc.Standard.exe init:<API-KEY> bvd:<BVD-Pfad> "signin:<Username>:<Password>" reo-archive:<Archive-Name>`
Beispiel:
`Dr.Doc.Standard.exe init:00001fjkdh "bvd:%TARGET_DIR%\USER\user.bvd" "signin:PUBLIC:Gast" reo-archive:doc`

### Alle Archive reorganisieren

`Dr.Doc.Standard.exe init:<API-KEY> bvd:<BVD-Pfad> "signin:<Username>:<Password>" reo-archive:*`
Beispiel:
`Dr.Doc.Standard.exe init:00001fjkdh "bvd:%TARGET_DIR%\USER\user.bvd" "signin:PUBLIC:Gast" reo-archive:*`

## Archiv zurücksetzen/Reset

### Ein Archiv zurücksetzen/Reset

Dabei werden alle Daten und Dokumente gelöscht!
`Dr.Doc.Standard.exe init:<API-KEY> bvd:<BVD-Pfad> "signin:<Username>:<Password>" reset-archive:<Archive-Name>`
Beispiel:
`Dr.Doc.Standard.exe init:00001fjkdh "bvd:%TARGET_DIR%\USER\user.bvd" "signin:PUBLIC:Gast" reset-archive:doc`

### Alle Archive zurücksetzen/Reset

Dabei werden alle Daten und Dokumente gelöscht!
`Dr.Doc.Standard.exe init:<API-KEY> bvd:<BVD-Pfad> "signin:<Username>:<Password>" reset-archive:*`
Beispiel:
`Dr.Doc.Standard.exe init:00001fjkdh "bvd:%TARGET_DIR%\USER\user.bvd" "signin:PUBLIC:Gast" reset-archive:*`

# Benutzerverwaltung

## Benutzer erstellen oder Passwort ändern

`Dr.Doc.Standard.exe init:<API-KEY> bvd:<BVD-Pfad> "signin:<Username>:<Password>" set-user-password:<Username>:<Password>`
Beispiel:
`Dr.Doc.Standard.exe init:00001fjkdh "bvd:%TARGET_DIR%\USER\user.bvd" "signin:PUBLIC:Gast" set-user-password:hans.mueller:1234`

## Benutzer löschen

`Dr.Doc.Standard.exe init:<API-KEY> bvd:<BVD-Pfad> "signin:<Username>:<Password>" delete-user:<Username>`
Beispiel:
`Dr.Doc.Standard.exe init:00001fjkdh "bvd:%TARGET_DIR%\USER\user.bvd" "signin:PUBLIC:Gast" delete-user:hans.mueller`

## Gruppe löschen

`Dr.Doc.Standard.exe init:<API-KEY> bvd:<BVD-Pfad> "signin:<Username>:<Password>" delete-group:<Username>`
Beispiel:
`Dr.Doc.Standard.exe init:00001fjkdh "bvd:%TARGET_DIR%\USER\user.bvd" "signin:PUBLIC:Gast" delete-group:hans.mueller`

TLS/SSL x509 Zertifikat installieren

Es gibt grundsätzlich zwei Möglichkeiten, für Dr.DOC Web ein TLS x509 Zertifikat für die Verbindungsverschlüsselung zu installieren.

* A: Automatisch mit LetsEncrypt / Certbot
    * Weitgehend automatisierte Aktualisierung
    * Kostenlos, aber eine kleine Spende wäre nett: [https://letsencrypt.org/donate/](https://letsencrypt.org/donate/)
    * Port `443` MUSS am Server für Dr.DOC Web verfügbar sein
    * Port Forwarding MUSS am Router für TCP Port `443` und TCP Port `80`, mit Verweis auf den Server, aktiv sein
        * Bei Fritz Box: "Internet -> Freigaben -> Portfreigaben -> "Gerät für Freigaben hinzufügen" -> "Neue Freigabe" ->
            * Anwendung "HTTP-Server"
            * Anwendung "HTTPS-Server"
                oder
            * Anwendung "Andere Anwendung", Protokoll "TCP", Port "80"
            * Anwendung "Andere Anwendung", Protokoll "TCP", Port "443"
    * Sicherheitsfeatures nicht anpassbar
* B: Manuelle Installation mit eigenem Zertifikat
    * Zu bevorzugen, wenn man eine PKI in der Organisation hat
    * Etwas komplizierter in der Einrichtung aber dafür mehr Anpassungsmöglichkeiten (Port, Schlüssellänge, Laufzeiten etc.)
    * Theoretisch sicherer, aber in der Praxis läuft bei den allermeisten CAs/TSPs der Signierungsprozess unsicher ab, da die CA den private Key erzeugt. Sicher(er) wäre, wenn die Organisation einen Private Key erzeugt, sowie einen Signing Request an die CA sendet und die CA den Signing Request bzw. das Zert signiert.

### A: Automatisch mit LetsEncrypt / Certbot

#### 1\. Schritt

Dr.DOC Web Server Dienst beenden
`sc.exe stop "Dr.DOC Web Server"`

#### 2\. Schritt

Öffnen Sie in Ihrem Dr.DOC Web Basisverzeichnis im Unterverzeichnis "confisgs" die Datei "server.ini"
Pfad: `<Web-Basisverzeichnis>\configs\server.ini`
z.B. `C:\DrDOC\WEB\configs\server.ini`

Bitte passen Sie folgende Einträge an:

```
[SERVER]
HOSTNAME=<Ihr Hostname>
```

#### 3\. Schritt

Als Administrator ausführen:
Pfad: `<Web-Basisverzeichnis>\cert.bat`
z.B. `C:\DrDOC\WEB\cert.bat`

Die LetsEncrypt Zertifikate laufen ca. alle drei Monate ab und müssen erneuert werden. Der Certbot aktualisiert die Zertifikat automatisch.

Folgende Aktionen werden ausgeführt:

* CertBot (LetsEncrypt) installieren
* Port setzen
* PEM Datei Pfad setzen (SSL\_CERT\_FILE\_PRIVATE, SSL\_CERT\_FILE\_PUBLIC)
* Server starten
* Zertifikat für Web Server setzen

### B: Manuelle Installation mit eigenem Zertifikat

#### 1\. Schritt

Dr.DOC Web Server Dienst beenden
`sc.exe stop "Dr.DOC Web Server"`

#### 2\. Schritt

Öffnen Sie in Ihrem Dr.DOC Web Basisverzeichnis im Unterverzeichnis "`configs`" die Datei "`server.ini`"
Pfad: `<Web-Basisverzeichnis>\configs\server.ini`
z.B. `C:\DrDOC\WEB\configs\server.ini`

Bitte passen Sie folgende Einträge an:

```
[SERVER]
HOSTNAME=<Ihr Hostname>
PORT=443
Access-Control-Allow-Origin=<Sichere Quellen>
SSL_ACTIVE=true
SSL_CERT_FILE=<Pfad zur *.pfx Datei ODER Fingerprint des Zertifikats im Windows Zertifikate Store>
; oder PEM Zertifikat mit je einer Datei für Private- und Public Key
SSL_CERT_FILE_PRIVATE=<Pfad zur private key Datei>
SSL_CERT_FILE_PUBLIC=<Pfad zur PEM Cert Datei>
SSL_CERT_PASSWORD=<Passwort zur *.pfx Datei>
```

#### 3\. Schritt

Dr.DOC Web Server Dienst starten
`sc.exe start "Dr.DOC Web Server"`

Web Node

Dr.DOC Web Node

Web Nodes sind Inhaltstypen für Dr.DOC Web.

Mehr erfahren

WebDAV, CalDAV, CardDAV

## WebDAV

Protokoll zur Verwaltung von Dokumenten. Das ermöglicht den direkten Zugriff auf Dr.DOC Dokumente via Windows Explorer und andere WebDAV Clients.
Es werden pro Dr.DOC Archiv Feldauswahlen erstellt, um die Zuweisung einer WebDAV Eigenschaft mit einem Dr.DOC Feld und deren Werten zu verknüpfen.
Dadurch kann man Dokumente mit entsprechenden Feldvorbelegungen erstellen oder danach suchen.

### ASCII-Importdefinition "WEB\_DAV"

Erstellen Sie eine Feldauswahl vom Typ ASCII-Importdefinition mit dem Namen "WEB\_DAV" und folgenden Eigenschaften:

| Feldwert in Feldauswahl | Pflichtfeld | Beschreibung | Beispiel Feldname | Beispiel Autofeld |
| ----------------------- | ----------- | ------------ | ----------------- | ----------------- |
| DATE | | Änderungsdatum | geaendert\_am | D |
| TIME | | Änderungszeit | geaendert\_um | T |
| DATETIME | | Änderungsdatum/Zeit | | DT |
| DNAME`<Level>` | | Beschreibt den Verzeichnisnamen. `<Level>` kann Werte zwischen 1 bis 5 haben. Jede Verzeichnis-Ebene entspricht einem `DNAME<Level>`-Eintrag wird einem Dr.DOC Feld zugeordnet bzw. im Client als Verzeichnis dargestellt. Aus der Kombination bildet sich der Verzeichnisname. | Firma | FF\<Level> |
| FNAME`<Level>` | x | Beschreibt den Dateinamen. `<Level>` kann Werte zwischen 1 bis 4 haben. Jede Ebene wird einem Dr.DOC Feld zugeordnet und im Dateinamen mit `__-__` aneinandergefügt. Aus der Kombination bildet sich der Dateiname. Die Kombination der zugewiesenen Felder MUSS eindeutig sein. | Name | F |
| ID | x | Eindeutige ID/GUID. CalDAV Client Apps setzen beim Erstellen teils eindeutige IDs und erwarten, dass die ID nicht geändert wird. Wenn ein Dokument in Dr.DOC erstellt wurde, sollte ebenfalls eine eindeutige ID erstellt werden. Es empfiehlt sich ein veränderbares ID-Feld mit eindeutigem Schlüssel. Siehe Autofeld. | uid | V DrDocGUID |

### WebDAV Pfad

Der WebDAV Pfad baut sich wie folgt zusammen:
`https://<domain>.<tld>:<Port>/webdav/<Archiv-Name>/<Suchvorlage>/<DNAME1>/<DNAME..>/<FNAME1>__-__<FNAME..>.<Extension>`

| Parameter | Beschreibung |
| --------- | ------------ |
| `<domain>.<tld>:<Port>` | Server HTTP(S) Adresse |
| `<Archiv-Name>` | Name des Archivs |
| `<Suchvorlage>` | Name der Suchvorlage. Der Wert `_` gibt an, dass alle Dokumente/Datensätze des Archivs angezeigt werden sollen. |

z.B.:
`https://drdoc.com/webdav/doc/Firma 1/Eingangsrechnung/Lieferant Maier GmbH__-__12345.pdf`

### Netzlaufwerk am Windows Client einbinden

##### Windows über CMD

Ggf. WebDAV Web Client installieren:
`powershell -command "& {&Install-WindowsFeature WebDav-Redirector}"`

Wenn Sie kein TLS/SSL Zertifikat im Dr.DOC Web installiert haben (TLS x509 Cert. wird dringend empfohlen!), muss folgendes ausgeführt werden, um unverschlüsselte Verbindungen zu erlauben.
`reg add "HKLM\SYSTEM\CurrentControlSet\Services\WebClient\Parameters" /v BasicAuthLevel /t REG_DWORD /d "1" /f`

WebClient Dienst starten:
`sc start "WebClient`"

Als Dr.DOC WebDAV als Netzlaufwerk einbinden (`<drdoc.com>` anpassen):
`ping drdoc.com -n 2`
`net use N: https://<drdoc.com>/webdav/`

##### Windows über GUI

So binden Sie ein Netzlaufwerk mittels WebDAV unter Windows 8 bzw. Windows 10 ein:

1. Der Dienst `WebClient` muss laufen (automatisch). Das ist i.d.R. der Fall.
2. Öffnen Sie den Windows-Explorer.
3. **Windows 8:** Klicken Sie oben in der Menüleiste im Reiter Computer auf Netzwerkadresse hinzufügen.
    **Windows 10:** Klicken Sie in der Menüleiste links mit der rechten Maustaste auf Netzwerk. Klicken Sie anschließend auf Netzlaufwerk verbinden... .
4. Wählen Sie das gewünschte Laufwerk.
5. Klicken Sie auf den Link Verbindung mit einer Website herstellen, auf der Sie Dokumente und Bilder speichern können.
    Das Fenster **Eine Netzwerkadresse hinzufügen** öffnet sich.
6. Klicken Sie auf Weiter.
7. Klicken Sie auf Eine benutzerdefinierte Netzwerkadresse auswählen.
8. Klicken Sie auf Weiter.
    Das Fenster **Eine Netzwerkadresse hinzufügen**  öffnet sich.
9. Geben Sie im Feld Internet- oder Netzwerkadresse: Ihre Domain im folgenden Format ein: https://ihre-domain.de:443/webdav/

##### Mac OS

[https://support.apple.com/de-de/guide/mac-help/mchlp1546/mac](https://support.apple.com/de-de/guide/mac-help/mchlp1546/mac)

##### Android

App Davx5, siehe: [https://www.davx5.com/](https://www.davx5.com/)
Es können auch Aufgaben, Termine und Journals synchronisiert werden!
Für Organisationen gibt es die App "Managed DAVx&#8309;" mit der die Einstellungen auf alle Geräte der Organisation ausgerollt werden können.

### Netzlaufwerk am Client entfernen

`net N: /DELETE`

## CalDAV

Protokoll zur Verwaltung von Terminen.

### Feldauswahl

Das Mapping der Termineigenschaften erfolgt über die Feldauswahlen wie [hier beschriebeen für Extension *.ics](https://drdoc.com/node/de/products/web/doku/rekursive-archivierung).

### CalDAV Pfad

Der CalDAV Pfad baut sich wie folgt zusammen:
`https://<domain>.<tld>/caldav/<Archiv-Name>/<Suchvorlage>/<ID>.ics`
z.B.:
`https://drdoc.com/caldav/termine/_/123456.ics`

## CardDAV

Protokoll zur Verwaltung von Kontakten.

### Feldauswahl

Das Mapping der Termineigenschaften erfolgt über die Feldauswahlen wie [hier beschriebeen für Extension *.vcf](https://drdoc.com/node/de/products/web/doku/rekursive-archivierung).

### CardDAV Pfad

Der CardDAV Pfad baut sich wie der WebDAV Pfad zusammen, hat keine Verzeichnisse mit `DNAME1` etc.
`https://<domain>.<tld>/carddav/<Archiv-Name>/<Suchvorlage>/<ID>.vcf`
z.B.:
`https://drdoc.com/carddav/kontakte/_/123456.vcf`

Hilfe zum Web Access

Systemvoraussetzungen, Ausführung und Betrieb

Systemvoraussetzungen, Ausführung und Betrieb

E-Mail-Archivierung (IMAP)

E-Mail-Archivierung (IMAP)

Verzeichnisse und Dateien

Verzeichnisse und Dateien

Installation und Update

Installation und Update

Regex Autofelder

Regex Autofelder

Rekursive Archivierung (Document Encoder/Decder)

REST API

REST API

OCR-Texterkennung und automatische Belegtrennung via Barcode am Dr.DOC Netzwerk Server

OCR-Texterkennung und automatische Belegtrennung via Barcode am Dr.DOC Netzwerk Server

Dr.DOC Standard

Dr.DOC Standard

TLS/SSL x509 Zertifikat installieren

TLS/SSL x509 Zertifikat installieren

Web Node

Dr.DOC Web Node

WebDAV, CalDAV, CardDAV

WebDAV, CalDAV, CardDAV