Documentation Center

Configuring import

Users can use the Content Manager Explorer GUI or the API to import CSV files containing Contacts or Keywords. GUI uploads end up in the standard upload location specified in the Content Manager Explorer configuration. API uploads end up in a target location that you specify in the <Import> section of the Audience Manager configuration file, OutboundEmail.xml. You can set this location to the same location as the standard GUI location. If your users use Content Manager Explorer to upload a lot of Contacts or large files, also configure the upload limit of the Content Manager Explorer Web site.

About this task

Importing through the API
When you import Contacts or Keywords through the API, the import mechanism uploads the CSV file to the location specified in OutboundEmail.xml. Set this location to the Content Manager Explorer upload directory to ensure that the folder exists and that temporary unique file names are created for the uploaded files.
Importing through Content Manager Explorer
When you import Contacts or Keywords through Content Manager Explorer, Audience Manager uploads the CSV file to the location specified in the Content Manager Explorer configuration file, %TRIDION_HOME%\web\WebUI\WebRoot\Configuration\System.config, as the value of the <Tridion.UploadDirectory> element. This location defaults to C:\ProgramData\SDL\Upload\.

Procedure

  1. To set an API upload location, open %TRIDION_HOME%\config\OutboundEmail.xml for editing.
  2. In the <Import> section, add a <Folder> child element set to your preferred upload location. This can be the same location as the one specified in %TRIDION_HOME%\web\WebUI\WebRoot\Configuration\System.config, but you can also set your own. For example:
    <Import>
    	<Folder>TRIDION_HOME\OutboundEmail\Bin\Import files</Folder>
    </Import>

    where TRIDION_HOME is the value of the %TRIDION_HOME% environment variable.

  3. Save and close OutboundEmail.xml.
  4. If you believe that the current maximum size for uploads to IIS is insufficient to accommodate the size of the Contacts or Keywords that your users will be uploading through Content Manager Explorer, open %TRIDION_HOME%\web\WebUI\WebRoot\web.config for editing.
  5. In the <system.webServer> section, set the maximum allowed content length in bytes:
    <system.webServer>
    	<security>
    		<requestFiltering>
    			<requestLimits maxAllowedContentLength="MAXSIZE" />
    		</requestFiltering>
    	</security>
    </system.webServer>

    where MAXSIZE is the maximum GUI upload size in bytes.

  6. In the <system.web> section, set the maximum request length in bytes:
    <httpRuntime maxRequestLength="MAXSIZE"/>

    where MAXSIZE is the maximum GUI upload size in bytes.

What to do next

You can configure the <ImportTimeout> in the <Database> section of the OutboundEmail.xml file.