DC 5.4 Application configuration

There are 3 levels of configuration for the Importer. This section describes the application level configuration which is in effect for all hotfolder configurations. This configuration is done in the app.config which is named Importer.exe.config when running app mode and ImportService.exe.config when running service mode.

  <appSettings>
    <add key="ApiUrl" value="https://dam.company.com/dmm3bwsv3/"/>
    <add key="UserName" value="Super Administrator" />
    <add key="Password" value="f8baef9bef764a58257635d7011b007a" />
    <add key="ParallelCount" value="5"/>
    <add key="JobPollRate" value="15"/>
    <add key="ServicePollRate" value="10"/>
    <add key="RequestTimeout" value="60"/>
    <add key="RequestDelay" value="2"/>
    <add key="RequestRetryCount" value="3"/>
  </appSettings>

Key	Description
ApiUrl	The URL for the DC's API. In almost all cases, this URL is simply composed of the URL to the DC, with "/dmm3bwsv3/" added to the end. Use this unless otherwise specified.
UserName	The username of the user with rights to upload and edit assets. It is a good idea allthough not required to create a separate user for this instead of reusing Super Administrator or System.
Password	An MD5 hash of the password corresponding to UserName.
ParallelCount	How many concurrent running or waiting jobs the Importer will accept as maximum. When this number is reached no new uploads will be initiated and the importer will enter a waiting loop. For metadata only setups this has no effect.
JobPollRate	When the Importer enters a waiting loop as mentioned in the description above it will poll in intervals of this many seconds.
ServicePollRate	When the Importer is running as a service this is the interval in seconds between checking if files are present in the hotfolder.
RequestTimeout	Timeout of web request in seconds. Acceptable values range from 1 to 3600. Default is 60. Added in 5.2.2 (backported to 5.1.x).
RequestDelay	Delay in seconds between retries of failed web requests. Acceptable values range from 1 to 60. Default is 2. Added in 5.2.2 (backported to 5.1.x).
RequestRetryCount	How many times is a failing web request retried. Acceptable values range from 1 to 10. Default is 3. Added in 5.2.2 (backported to 5.1.x).

A note on passwords

It has been common practice to copy-paste passwords directly from DB but that will not work with the new strong encryption type passwords. Here is the proper way to do it:

Create a new user for the Importer purpose or reuse an existing one.
Make a note of the the actual password.
Type in that password in any MD5 tool and generate a hash.
Use the MD5 hash for the Importers application config.

Examples of MD5 tools:

SQL:

How to generate an MD5 hash in SQL

SELECT CONVERT(NVARCHAR(255), HashBytes('MD5', 'password'), 2)

Notepad++