Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 13 Next »

The Importer is located with the DAM installation files in a separate zip file.

  1. Create a folder where you want the app to be. It's recommended to use an "non-program-files" location to avoid windows rights management issues or at least to set path configurations to a unc path outside. It's required to have write access to all configured directory paths.
  2. Unzip the contents to the folder.
  3. Optional: Run DamImporterMatchSearchByAssetid.sql if or when you need a match search that matches assetId. This can also be done at a later time. The default DamImporterMatchSearch matches against a string metafield containing filenames.
  4. Set application level configuration in Importer.exe.config (app mode) and/or ImportService.exe.config (service mode). See "DC5.0.0 Application configuration".
  5. Set import level configuration in xml files in the subfolder ImportConfigs. See "DC5.0.0 Import configuration".
  6. Set metadata level configuration if needed.
  7. Install as a service if you need. See section below. Set the service to start automatically.

Install as a Windows service

To install the Importer service, please do the following steps:

First of all, enter a command prompt or PowerShell prompt, and navigate to your import service folder.

Run these two lines. The first to change to the correct hard drive - and secondly to navigate to the root of the importer

Firstly:

Windows command prompt
[driveLetter]:

e.g.

Windows command prompt
D:                                                                                           .


Secondly:

Windows command prompt
"[driveLetter]:\[pathToImporter]"

e.g.

Windows command prompt
"D:\Importer"


Now that you're in the correct folder within your chosen command prompt, you can now run the service installation one-liner:

Windows command prompt
sc create [ImportServiceCustomName] binPath= "[driveLetter]:\[pathToImporter]\ImportService.exe" DisplayName= "[importServiceNameWithSpaces]"

e.g.

Windows command prompt
sc create ImportService binPath= "D:\Importer\ImportService.exe" DisplayName= "Import Service"


App mode vs. service mode

Running the Importer as service works essentially the same as in app mode. The differences are highlighted in the following table:

FeatureApp modeService mode
Continous monitoringNoYes
Halt on fatal exception 1)YesNo 2)

1) A fatal exception in this context means an error the Importer does not know how to safely proceed with. Specifically with data errors or data parse errors the Importer will take a safe approach and not do anything rather than set wrong metadata.

2) As a service if FailureDirectory is set the involved files will be moved and not retried. If not moved they will be retried.


  • No labels