DC 5.3.0 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>
KeyDescription
ApiUrlThe 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.
UserNameThe 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.

ParallelCountHow 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.
JobPollRateWhen the Importer enters a waiting loop as mentioned in the description above it will poll in intervals of this many seconds.
ServicePollRateWhen the Importer is running as a service this is the interval in seconds between checking if files are present in the hotfolder.
RequestTimeoutTimeout 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).
RequestDelayDelay 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).
RequestRetryCountHow 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:

  1. Create a new user for the Importer purpose or reuse an existing one.
  2. Either way make a note of the the actual password.
  3. Type in that password in any MD5 tool and generate a hash.
  4. Use the MD5 hash for the Importers application config.

Examples of MD5 tools:

  1. SQL:

    How to generate an MD5 hash in SQL
    SELECT CONVERT(NVARCHAR(255), HashBytes('MD5', 'password'), 2)
  2. Notepad++