How to Set Up Docentric AX Parameters

The Docentric AX parameters form can be open from the Docentric AX workspace, or from the Organization administration module menu.

The Docentric AX workspace is located in the default dashboard among other workspaces.

Also, the Docentric AX workspace can be open from the Organization administration module menu. You can also directly arrive to the form by clicking the Docentric AX parameters menu item from the Docentric AX menu, which is the last menu within Organization administration module menu.

The Docentric AX workspace looks like the following.

Open the Docentric AX parameters form and take a look on each of the tab pages.

For Docentric AX Free Edition only the following sections of the Docentric AX parameters form applies:

Product

In the Product tab page you can find Version and Release date of the product likewise online tutorials URL.

Licensing

In the Licensing tab page you can unlock the product or update the license, e.g. to renew the subscription, by clicking the Load license file button.

You don’t need any license (and unlocking the product) to use Docentric AX Free Edition.

Templates

In the Templates tab page you can specify the default template storage on SharePoint and Azure blob storage.
This info will be used when customizing system templates, which are stored as AOT Resources, as default values for template storage settings. Also, the same info will be used with custom templates, which are usually created by end users in a production environment.

Emailing

In the Emailing tab Email parameters and SMTP client settings can be set up.

Email parameters

AX email display name is used as the email sender display name when emailing reports, e.g. Docentric Services. This is applied for all Docentric reports except those, which have this value set differently in the report setup. It is even possible to set different values for different companies for a single report.

AX email display name can be set to use Current User Email. This is actually a built-in behavior of emailing built-in SSRS reports. This field can also be leaved empty; then the corresponding display name of the From email account field from the report print destination settings is used, and usually this is the current user email.

SMTP client settings

In the built-in email parameters, which can be open by clicking the button with the same name, you can set up SMTP settings such as Outgoing email server, SMTP port, if SSL is turned on, etc. In the Emailing tab you can set up additional SMTP settings such as SMTP client timeout, Body and subject encoding, Delivery format, etc.

Security

In the Security tab some security settings can be set up. For example, you can make the Generate DS print destination invisible on the Print destination settings form for all reports, by turning off the Is Generate DS visible checkbox.

Use of Docentric print destinations

You can decide whether to hide the Docentric print destinations on the Print destination settings form and show only the built-in SSRS print destinations, like Docentric AX is not installed at all. This way Docentric AX is basically deactivated.
You can also choose to show both Docentric and SSRS print destinations on the Print destination settings form, so user can switch between them, or you can choose to show only the Docentric print destinations.
This third option is actually the recommended choice. Since the Docentric print destinations only add additional possibilities to the built-in SSRS print destinations you are safe to go with this option.

Temporary files expiration time

When sending a file from the application to an end-user, e.g. as in case when printing a report to the File print destination, this file is actually saved as a blob on Azure storage and a temporary link for downloading the file is created and send to end user. Not only that the download link is temporary but also the file itself is – this is how the implementation of temporary files are done in D365 for Operations. You can set Temporary files expiration time, a value that applies to both temporary files and their download links used by the Docentric AX framework. The default value is 30 minutes.

SharePoint Access

D365 for Operations connects to SharePoint using current user Azure AD (Active Directory) credentials. Docentric AX may need to connect to SharePoint in order to fetch a report template, or to save a report output file to a SharePoint location. However, the default behavior of using current user credentials to access SharePoint can be changed for the Docentric AX framework, by selecting a particular user for SharePoint reader and/or writer. Then Azure AD credentials of the selected users will be used when accessing SharePoint.

Diagnostics

Error logging to Exception log is supported, but it’s basically obsolete. As you use Docentric AX, we would like to collect diagnostics and usage information which helps us find and fix problems, and improve our product and services.

See also

How to Set Up Reports >>
How to Set Up Report Templates >>
How to Use Deployment Tools >>