Technical details

This guide documents the Windows Registry keys used in connection with DPG COM Addin (Classic Outlook). The registry keys govern various aspects of the COM Addin, and the cause of any issues is often due to wrong setup of these keys.

Please test your setup carefully before applying changes to Windows Registry keys in your production setup.

If you have questions about Windows Registry configuration or settings, please create a support ticket, and we are happy to assist you.

Example file

Below you find an example of the default Windows Registry configuration file. You can copy registry keys from here.

Default Windows Registry configuration file

;
; -= Registry Settings can be placed in any of these four locations =-
; -= Select the appropriate location according to your organization =-
;

; [HKEY_CURRENT_USER\SOFTWARE\Timengo\DPGAddIn]
; [HKEY_CURRENT_USER\SOFTWARE\Policies\Timengo\DPGAddIn]
; [HKEY_LOCAL_MACHINE\SOFTWARE\Timengo\DPGAddIn]
; [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Timengo\DPGAddIn]

;
; -= DPG Service Connection Settings =-
;

; FQDN of the DPG service, e.g. "https://CUSTOMERDETAILS.dpgapi.dk:443/api"
"RESTUrl"=""

; Value of the System Parameter AddInRestApiUsername
"RESTu"=""

; Value of the System Parameter AddInRestApiPassword
"RESTp"=""

;
; -= Logging Settings =-
;

; Optional
;"LoggingUrl"=""

; Additional logging details
"VerboseLogging"="false"

; Advanced logging, read all settings before a mail is handled
"InitializeBeforeEachMail"="false"

; Can add a header before a mail is sent
;"ExtraHeader"=""

;
; -= Sender List Settings =-
;

; Use ";" (Semicolon) as seperator
"FixedMailboxSenders"=""

; Enable that user can send from own mailbox
"IncludeOwnMailboxAsSender"="true"

; User can only send from own mailbox
"OwnMailboxOnlyAsSender"="false"

; Always prompt user to select the sending mailbox
"AlwaysSelectSender"="false"

; Name a specific secure mailbox to always automatically select by default
"DefaultSelectedMailbox"=""

; Always select users own mailbox by default
"DefaultSelectedMailboxIsOwnMailbox"="false"

;
; -= General GUI Settings =-
;

; Show additional DPG button to directly open Add-In
"ExtraOpenButtonVisible"="false"

; Minimal GUI experience
"MinimalGui"="false"

; Set time to display for success for MinimalGui
"MinimalGuiSuccessIndicationDelayInMillisec"="1000"

; Enable toggle button so Outlook Send button is used when sending mail
"ToggleButtonFeatureEnabled"="true"

; Set toggle button to default after sending a mail
"ToggleButtonFeatureChangeToDefaultValueAfterMailProcess"="true"

; Lock toggle to default value so user can not change it
"ToggleButtonFeatureLockButtonToDefaultValue"="false"

; Set default behavior for toggle button - active or inactive
"ToggleButtonFeatureSecureActiveIsDefaultValue"="true"

; Prompt to warn user if toggle button is not active when sending a mail
"ToggleButtonFeatureWarnIfSecureIsNotActive"="true"

;
; -= Eboks GUI Settings =-
;

; Hides the eBoks SignedList button
"CprCvrListCheckVisible"="false"

; Hides the Eboks section
"EboksVisible"="false"

; Hides the Eboks signature checkbox
"RequestEboksSignatureVisible"="false"

;
; -= NgDP GUI settings =-
;

; Hides the NgDP section
"NgDPVisible"="false"

; Enables button that make it easy to copy subject to Case ID
"NgDpMoveSubjectToCaseIdButtonVisible"="false"

; Only for authorities with permission to send legal notifications (FDF)
"NgDPLegalNotificationVisible"="false"

; Set default behavior for "Tillad retursvar" checkbox
"NgDpReplyAllowedSet"="false"

; Controls if a notification window is shown when forwarding NgDP Memo
; messages as an email to internal mail recipients only
"WarnSendingNgDpToInternalRecipients"="false"

;If true checkbox is not shown 
"NgDPHideReplyToOwnMailbox"="false"

;If true case ID is not shown
"NgDPHideCaseId"="false"

;If true sms notification is not shown
"NgDPHideSmsNotification"="false"

;
; -= mit.dk GUI settings =-
;

; Hides the mit.dk section
"MitdkVisible"="false"

;Enables button that make it easy to copy subject to Case ID
"MitdkMoveSubjectToCaseIdButtonVisible"="false"

; Set default behavior for "Tillad retursvar" checkbox
"MitdkReplyAllowedSet"="false"

; Controls if a notification window is shown when forwarding mit.dk Memo 
; messages as an email to internal mail recipients only
"WarnSendingMitdkToInternalRecipients"="false"

;If true checkbox is not shown
"MitdkHideReplyToOwnMailbox"="false"

;If true case ID is not shown
"MitdkHideCaseId"="false"

; It is possible to specify a time deadline for when the signature request must be signed. Make the time selection visible in the DPG com add-in.
"MitdkSignatureDisableDueDateHoursOfDayAndUseEndOfDay"="false"

; When requesting a signature, a date for the latest possible signing time is specified. The default setting is set to 8 days ahead.
"MitdkSignatureDueDateDefaultAddDays"="8"

; Select the time deadline for when the signature request must be signed. (default is 0 if not specified).
"MitdkSignatureDueDateDefaultHoursOfDay"="23"

;
; -= Mail Guard =-
;

;If true then external recipients must manually be approved before a mail can be sent
"ExternalRecipientsRequireApproval"="false"

;If true then all external recipients can be approved with one click (only has effect if ExternalRecipientsRequireApproval is true)
"ExternalRecipientsAllowApprovalOfAll"="false"

;If true then all external TLS recipients are marked with a yellow checkmark instead of a green
"ExternalRecipientsTlsDisplayInYellow"="false"

;If true then a button for removing all external TLS recipients is enabled (only has effect if ExternalRecipientsTlsDisplayInYellow is true)
"ExternalRecipientsTlsRemoveAll"="false"

;
; -= Deprecated settings. Retained for historical reference =-
;

; Centralised rest api for the dpg
;"AddressbookUrl"="https://rest.dpgapi.dk/api"

; Show or hide addressbook button
;"AddressbookVisible"="false"

; Requires Legacy and deprecated domain based tunnelmail transport rules!
; "itemSendEventActive"="false"

; Sends part of messages from user's own mailbox. Legacy Option.
;"SendToOmeRecipientsAsSeperateMail"="false"

; Sends part of messages from user's own mailbox. Legacy Option.
;"SendToTlsRecipientsAsSeperateMail"="false"

; Deprecated since DPGAddIn version 2.0.0
; "ReplyButtonVisible"="false"

; Deprecated since DPGAddIn version 2.0.0
; "DefaultReplyAllowed"="false"

; Update sender details in original mail if returning to mail
;"UpdateSenderWhenReturnToMailIsClicked"="false"

If you need help using the Windows Registry, see for instance this Microsoft page.

Registry paths

Registry settings can be installed into any of these four paths:

[HKEY_CURRENT_USER\SOFTWARE\Timengo\DPGAddIn]
[HKEY_CURRENT_USER\SOFTWARE\Policies\Timengo\DPGAddIn]
[HKEY_LOCAL_MACHINE\SOFTWARE\Timengo\DPGAddIn]
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Timengo\DPGAddIn]

The following tables describe each registry key, divided into functionality areas.

DPG Service connection

Key	Function
RESTUrl	FQDN of the DPG service, e.g. https://<CUSTOMERDETAILS>.dpgapi.dk:443/api
RESTu	AddIn username
RESTp	AddIn password

Logging

Key	Function
LoggingUrl	Optional and not required, default blank
VerboseLogging	Additional logging details, default false
InitializeBeforeEachMail	Advanced logging – read all settings before a mail is handled, default false
ExtraHeader	Can add a header before a mail is sent, default blank

Sender list

Key	Function
FixedMailboxSenders	Use ";" (Semicolon) as separator, default blank
IncludeOwnMailboxAsSender	Enable user to send from own mailbox, default true
OwnMailboxOnlyAsSender	User can only send from own mailbox, default false
AlwaysSelectSender	Always prompt user to select the sending mailbox, default false
DefaultSelectedMailbox	Name a specific secure mailbox to always automatically select by default, default blank
DefaultSelectedMailboxIsOwnMailbox	Always select users own mailbox by default, default false

General GUI

Key	Function
ExtraOpenButtonVisible	Show additional DPG button to directly open Add-In, default false
MinimalGui	Minimal GUI experience, default false
MinimalGuiSuccessIndicationDelayInMillisec	Set time to display for success for MinimalGui, default 1000
ToggleButtonFeatureEnabled	Enable toggle button so Outlook Send button is used when sending mail, default true
ToggleButtonFeatureChangeToDefaultValueAfterMailProcess	Set toggle button to default after sending a mail, default true
ToggleButtonFeatureLockButtonToDefaultValue	Lock toggle to default value so user can not change it, default false
ToggleButtonFeatureSecureActiveIsDefaultValue	Set default behavior for toggle button – active or inactive, default true
ToggleButtonFeatureWarnIfSecureIsNotActive	Prompt to warn user if toggle button is not active when sending a mail, default true

E-Boks GUI

Key	Function
CprCvrListCheckVisible	Hides the eBoks SignedList button, default false
EboksVisible	Hides the eBoks section, default false
RequestEboksSignatureVisible	Hides the eBoks signature checkbox, default false

NgDP GUI

Key	Function
NgDPVisible	Hides the NgDP section, default false
NgDpMoveSubjectToCaseIdButtonVisible	Enables button that make it easy to copy subject to Case ID, default false
NgDPLegalNotificationVisible	Only for authorities with permission to send legal notifications (FDF), default false
NgDpReplyAllowedSet	Set default behavior for "Tillad retursvar" checkbox, default false
WarnSendingNgDpToInternalRecipients	Controls if a notification window is shown when forwarding NgDP Memo messages as an email to internal mail recipient, default false
NgDPHideReplyToOwnMailbox	Is checkbox shown, default false
NgDPHideCaseId	Is case ID hidden, default false
NgDPHideSmsNotification	Is sms notification hidden, default false

mit.dk GUI

Key	Function
MitdkVisible	Hides the mit.dk section, default false
MitdkMoveSubjectToCaseIdButtonVisible	Enables button that make it easy to copy subject to Case ID, default false
MitdkReplyAllowedSet	Set default behavior for "Tillad retursvar" checkbox, default false
WarnSendingMitdkToInternalRecipients	Controls if a notification window is shown when forwarding mit.dk Memo messages as an email to internal mail recipient, default false
MitdkHideReplyToOwnMailbox	Is checkbox shown, default false
MitdkHideCaseId	Is case ID hidden, default false
MitdkSignatureDisableDueDateHoursOfDayAndUseEndOfDay	It is possible to specify a time deadline for when the signature request must be signed. Make the time selection visible in the DPG com add-in. Default false
MitdkSignatureDueDateDefaultAddDays	When requesting a signature, a date for the latest possible signing time is specified. The default setting is set to 8 days ahead.
MitdkSignatureDueDateDefaultHoursOfDay	Select the time deadline for when the signature request must be signed. Default 23 - 0 if not specified.

Mail Guard

Key	Function
ExternalRecipientsRequireApproval	Must external recipients be manually approved before a mail can be sent, default false
ExternalRecipientsAllowApprovalOfAll	Can all external recipients be approved with one click (only has effect if ExternalRecipientsRequireApproval is true), default false
ExternalRecipientsTlsDisplayInYellow	If true then all external TLS recipients are marked with a yellow checkmark instead of a green, default false
ExternalRecipientsTlsRemoveAll	If true then a button for removing all external TLS recipients is enabled (only has effect if ExternalRecipientsTlsDisplayInYellow is true), default false

Deprecated settings

The following deprecated settings are retained for historical reference.

Key	Function
AddressbookUrl	Centralised rest api for the dpg, default https://rest.dpgapi.dk/api
AddressbookVisible	Show or hide addressbook button, default false
itemSendEventActive	Requires Legacy and deprecated domain based tunnelmail transport rules, default false
SendToOmeRecipientsAsSeperateMail	Sends part of messages from user’s own mailbox. Legacy Option, default false
SendToTlsRecipientsAsSeperateMail	Sends part of messages from user’s own mailbox. Legacy Option, default false
ReplyButtonVisible	Deprecated since DPGAddIn version 2.0.0, default false
DefaultReplyAllowed	Deprecated since DPGAddIn version 2.0.0, default false
UpdateSenderWhenReturnToMailIsClicked	Update sender details in original mail if returning to mail, default false