This section desribes the different ways of configure Link via settings-keys. This can be centralized settings (Link Settings and Dataowner Settings) in the database and it can be de-centralized settings in the web.config and similar.

Link Settings

Key

Description

From version

Obsolete from version

Alert_Default_ContactEmail

Hvis denne værdi er sat, vil den overskrive kontakters email adresse i forbindelse med alert notifikationer. (Findes der en dataowner setting for dette, vil den have prioritet over BizTalk settingen)

1.8

Alert_Default_ContactPhoneNumber

Hvis denne værdi er sat, vil den overskrive kontakters telefonnummer i forbindelse med alert notifikationer. (Findes der en dataowner setting for dette, vil den have prioritet over BizTalk settingen)

1.8

SmsGatewayDomain

Indeholder donæne-delen af den email-adresse vi sender til sms gatewayen. Bruges pt. kun til alarmering.

1.8

UseAdapterTransactionForThisAdapterList

A semicolon separated list of Biztalk Adapter names, which should use the Transaction from the adapter instead of the pipeline. (Check for adapter-names is case insensitive)

1.8

RemoveAlertEventsAtEndOfDay

If true, AlertEvents are cancelled at the end of the day, when alert messages are removed from the queue

1.8

Alert_Default_SmsSubject

Used to set the subject for emails to be sent as Sms.

1.8

PartnerCertificatePrivateKey

This key is used for the new partner-certificate-store to encrypt and decrypt passwords for private certificates. Values for this key can be generated in the Administration Tool in menu Tools >> Generate AES private key. This key requires the application pool to be recycled to take affect.
IMPORTANT! When this key is being used for the first time (when uploading a certficate with a private key) it should NOT be changed. Otherwise the passwords can't be decrypted and the certificate will not be valid.

It's possible to overwrite the value from BizTalk settings in the .config file for the application using it. If a key in the appSettings section is named PartnerCertificatePrivateKey this value will be used instead of the one in BizTalk settings.

2.0

2.5

SSISConnectionString

This connection string points to the database containing the SSIS packages, sql agent jobs, etc. This is necessary for the SSIS functionallity to work in the portal UI.

1.6

ChartColors

Used to define the colors in the Charts. The value must be a comma-separated list of hex color codes. Notice that from 2.0.1 values like #FF9BBB59 (with the first FF) is no longer supported. Only 6 digit values are supported. So #FF9BBB59 should be #9BBB59.

1.5

StakeholderEmailAddressWillOverrideAll

When this key is set with the value of an email (typical: test@EdiPortal.dk) it will override all other stakeholder email addresses in pDocuments_StatusTypes_MailHandling. Use this to prevent sending emails to customers from our test system.

2.0

ReturnToSenderNonProdEmail

When this key is set it will override the return to sender prod email address (note: StakeholderEmailAddressWillOverrideAll will still override this email if it is set)

1.8

LogEnabled

True/False value indicating whether or not logging is enabled

1.6

LogOnDocumentEnabled

True/False value indicating whether or not the log should be attached to the document (David please verify this)

1.6

LogLevel

1 = UnexpectedError
2 = Error
5 = Warning
10 = Info

1.6

LogObject

ALL = All document types (DistributionObject)
Otherwise: [NameOfDistributionObject] eg. Invoice

1.6

PipelineToUseForXmlAssemble

Value for specifying which pipeline to use for XML assemble

Ebex.EdiPortal.Common.Pipelines.XmlAddDeclaration.Snd_AddXmlDeclaration, EdiPortal.Common.Pipelines.XmlAddDeclaration, Version=1.0.0.0, Culture=neutral, PublicKeyToken=7685f304a6e7e148

1.8

FtpRootFolder

The root-folder used for the LocalFTP Adapter - when running in "Fileshare" mode.

1.7

FtpDefaultInFolder

supporting multiple folders for LocalFTP adapter. The FtpDefaultInFolder biztalk settings will contain multiple folders with delimiter. The delimiter is another BizTalk setting EdiPortalRcvPipelinePropertyValueSeperator. The FtpDefaultInFolder folder value can be LinkTo, EdiPortal where comma is used as splitter, assuming the EdiPortalRcvPipelinePropertyValueSeperator has comma as a value. Only for "Fileshare" mode.

1.7

FtpDefaultOutFolder

Name of default out folder name in FTP folder. The FtpDefaultOutFolder biztalk settings may contain multiple folders with delimiter. The delimiter is another BizTalk setting EdiPortalRcvPipelinePropertyValueSeperator. The folder must exist; if multiple folders are specified, at least one must exist. If multiple specified folders exist, the first that exists (in list order) is used.

1.8

SqlCommandTimeout

Overwrites the default SqlTimeout (which is 30 seconds) to the given value. The value should be represented in seconds.

1.6

SqlCommandTimeout_Resend

Overwrites the default SqlTimeout (which is 30 seconds) to the given value when resending documents from the UI. The value should be represented in seconds. This value will overrule the SqlCommandTimeout value if this is set.

2.0.1

AS4IgnoreIngoingFailedMessages

By default a failed document will be created, if something goes wrong when receiving an incoming AS4 message. Setting this key to "True" will ignore this and don't save anything in the database.

2.1

AS4DefaultResponse

If this value is set, it will override the default response text (when accessing the AS4Handler.ashx in the browser via HTTP GET). This value can contain HTML. Eg. <HTML><BODY>Link AS4 Handler - Copyright Bizbrains A/S 2018</BODY></HTML>

2.1

TrackingSearchUrl

The url of the base-site for the installation. Eg. http://link.bizbrains.com. This is used among others when generating mails to stakeholders - the mail body contains a link to the failed documents. It is also used in the Link Administration Tool, when using the "Integritiy Test", to generate url's to the original and resent documents.

1.6

MailHtmlPartner

Template for mail to partner (Return to sender/receiver)

MailSubjectPartner

Template subject for partner email (Return to sender/receiver)

MailHtmlStakeholder

Template mail for stakeholder errror mails

MailSubjectStakeholder

Template subject for error mails to stakeholder

SqlServerEmailProfile

This setting is used for setting database mail user profile, used for sending emails

2.0

ClientIpHeaderFields

Comma separated list of additional http headers used to identify partners in the HttpHandler.ashx.

Used when requests to the receive site (via HttpHandler.ashx) is sent through a proxy server. In these cases the client IP address cannot be used for identifying the sending partner. This field can then be used to provide one or more header fields to look for the IP address. Typically the header X-FORWARDED-FOR is used when behind a proxy.

2.9

Additional Files

LinkPeppol_DoNotSaveAdditionalFiles

Set this value to True, if no additional files should be saved for the LinkPeppol transport type.

2.5

LinkPeppol_TransportProfiles

This value indicates the supported transport-profiles when sending through LinkPeppol (possible values: AS2 and AS4).
The value can be a comma-separated string containing one or more supported profiles.
The order of the the items is dictating the priority of the profiles.
Eg.: "AS4, AS2" - if an endpoint supports both AS2 and AS4 the AS4 endpoint will be chosen in this case.

Default value: "AS2, AS4"

2.5

AS2_DoNotSaveAdditionalFiles

Set this value to True, if no additional files should be saved for the AS2 transmissions (both ingoing and outgoing)

2.5

AS4_DoNotSaveAdditionalFiles

Set this value to True, if no additional files should be saved for the AS4 transmissions (both ingoing and outgoing)

2.5

EdiPortalReceive_DoNotSaveAdditionalFiles

Set this value to True, if no additional files should be saved for the EdiPortalReceive.svc SOAP service, when sending files to the Inbox.

2.5

SMTP Settings

The below smtp settings are used in the Alert module and for the

SmtpHost

The send email will use the smtp host mentioned here

2.5

SmtpPort

The send email will use the smtp port mentioned here

2.5

SmtpSender

The send email will use the smtp sender mentioned here

2.5

SmtpEnableSsl

The send email will use Ssl enabled smtp settings mentioned here

2.5

SmtpUseNetworkCredentials

The send email will use smtp network credentials based on the value mentioned here

2.5

SmtpUsername

The send email will use the smtp user name mentioned here

2.5

SmtpPassword

The send email will use the smtp password mentioned here

2.5

DefaultEmailSubject

Default subject used to send error mails. Default has this value: Document Failed (DocumentType: "{DocumentType}", DataOwner: "{DataOwner}", DocumentNumber: "{DocumentNumber}", EnvironmentType: "{Environment}")

DefaultEmailHtml

Default mail body template used to send error mails. Default has this value:
<html><head><style>td {border: solid black 1px;padding-left:5px;padding-right:5px;padding-top:1px;padding-bottom:1px;font-size:11pt;}</style></head><p><b>Link:</b> {EdiPortalLink}</p><p><b>ApplicationServer:</b> {ApplicationServer}</p><p><b>DocumentsId:</b> {DocumentsId}</p><p><b>Timestamp:</b> {Timestamp}</p><p><b>Comment:</b> {Comment}</p><p><b>Exception Message:</b> {ExceptionMessage}</p><p><b>Fault Description:</b> {FaultDescription}</p><p><b>Possible Cause:</b> {PossibleCause}</p><p><b>Possible Solution:</b> {PossibleSolution}</p><p><b>Link_ErrorCode:</b> {ErrorCode}</p><p><b>Link_ExceptionCategory:</b> {ExceptionCategory}</p><p><b>Link_DocumentType:</b> {DocumentType}</p><p><b>Link_StakeHolder:</b> {StakeHolder}</p><p><b>Link_ReceiverPartnerName:</b> {ReceiverPartnerName}</p><p><b>Link_SenderPartnerName:</b> {SenderPartnerName}</p><p><b>Link_ReceiverPartnerContact:</b> {ReceiverPartnerContact}</p><p><b>Link_SenderPartnerContact:</b> {SenderPartnerContact}</p></html>

User Account Settings

AccountLockoutThreshold

This security setting determines the number of failed logon attempts that causes a user account to be locked out. A locked-out account cannot be used until it is reset by an administrator. The default value is 10 attempts.

2.5

AccountLogoutResetDuration

This security setting determines the number of minutes that must elapse after a failed logon attempt before the failed logon attempt counter is reset to 0 bad logon attempts. the default value is 30 minutes. Set to zero to disable lockout feature.

2.5

Cache Settings

CommonCacheTimeoutInMinutes

Use this key to overwrite the default cache-timeout in the common-library (used when loading distributions, partners, etc.). Default value (if this key is not present) is 1 minute.

The value must be a number representing cache-time in minutes.

2.5

DataOwner Settings

Is documented here: Dataowner Settings

Web.config (only used in the frontend controller-site):

Key	Description	From version	Obsolete from version
AuthenticationMode	A value indicating what type of authentication the site is running: Token/Windows. See also: [[Setup site with Windows Authentication]]	2.0
SmtpHost	The host address for the SMTP server used when sending mails from the frontend. Currently the Alert module is using this - and the built in bug-report/feature-request is also using this.	2.0
SmtpPort	Port for the SMTP server	2.0
SmtpSender	Mail-address for the sender of e-mails. Eg: noreply@bizbrains.dk	2.0
SmtpEnableSsl	True/False	2.0
SmtpUseNetworkCredentials	True/False	2.0
SmtpUsername	If SmtpUseNetworkCredentials is set to True - this is the username for the network credentials used for authentication.	2.0
SmtpPassword	If SmtpUseNetworkCredentials is set to True - this is the password for the network credentials used for authentication.	2.0

SupportMail_BugReport	Mail address to receive bug-reports from the frontend.	2.0.1
SupportMail_FeatureRequest	Mail address to receive feature-requests from the frontend.	2.0.1
useConnectionStringsFromConfigFile	See the description for this in the section below (settings for the receive site).	1.7
ActiveDirectoryDomain	When running windows authentication use this property for setting the AD domain to lookup the users. This value is the name of the domain e.g ebex.local. NB! This should only be set, if the users accessing the Link site is on a different domain than the server.	1.7
ftpProviderType	Fully qualified name of FTP plugin. Setting is now (from 2.9) defined in database, in table [partner].[tFtpPlugins].	2.0	2.9

Web.config as appSettings <add key="[keyName]" value="[value"] /> (for the receive site "EdiPortalReceive.svc, AS2Handler.ashx, NemHandel.svc, etc."):

Key	Description	From version
SaveAS2Log	True/False - Saves the debug/info log for the incoming AS2 message to the Interchange In Log File.	1.7
SaveAS2Message	True/False value indicating whether or not to save the raw incoming request, headers and decrypted content to the path given in the SaveAS2MessagePath configuration key	1.7
SaveAS2MessagePath	The absolute path where the incoming request should be saved. NB!! Remember to give the right folder permissions (read/write) to the app-pool service-account.	1.7
NemHandelPortName	Port name for the NemHandel	1.8
log4Net4RaspConfigurationFile	Path to the Log4Net log-file used by NemHandel	1.7
RaspConfigurationFile	Path to the Rasp Configuration File used by NemHandel	1.7
SaveToPath	NemHandel specific - saves the incoming NemHandel message to the given path *instead* of saving it directly in the EdiPortal.	1.7
useConnectionStringsFromConfigFile	If this key is set to true, the connection strings is taken from the web.config file and NOT from the biztalk-settings-table in the db. If this is not set, the connection-string in the web.config is only used to access the connection-string-values in the biztalk-settings.	1.7
AS4IncomingFilesDebugFolderPath	A folder path where the raw incoming data should be stored. The folder must exist and the service-account must have the right folder permissions - otherwise no debug log data is stored.	2.1
AS4XmlIdentificationSettingsPath	A path to the XML file which contains the mapping between ISO standard identifications and the Link identification types. See [[How to setup AS4 in Link]] for more information about this file.	2.1

Content on this page: