Sign in

Aras Import Manager Installation

August 24, 2026 12:17 PM
2 min read

Prerequisites

  1. Both Conversion Server and Agent Service must be installed and configured with the instance of Aras Innovator
  2. Install Aras Import Manager 33.

Retrieve Application package

  1. Download the Aras Import Manager 33 CD Image zipped archive from the Aras File Sharing site, located in the Aras/Product Releases/ folder.
  2. Unzip the Aras Import Manager 33 CD Image on the local machine.

Include application Code Tree Patch into the repository

  1. Navigate to the (unzipped)Aras Import Manager 33 CD Image folder on the local machine.
    1. Copy the ‘Innovator’ folder into the\CodeTree\ folder of the Work.git repository.
    2. Copy the ‘ConversionServer’ folder into the\CodeTree\ folder of the Work.git repository.

Include application package into the repository

  1. Navigate to the (unzipped)Aras Import Manager CD Image folder on the local machine.
    1. Open the ‘imports’ folder and copy the ‘ark’ folder into the\AML-packages\ folder of the Work.git repository.
Note
Do not copy the imports.mf file, as it will overwrite the existing imports.mf file in the Work.git repository.

  1. Open the \imports\imports.mfAras Import Manager CD Image folder file.
  2. Copy the following ＜package＞ elements: 
<imports>
  <package name="com.aras.ark.im.core" path="ark\im\core" />
</imports>

  1. Paste the ＜package＞ elements into the \AML-packages\imports.mf file in the Work.git repository.
  2. Open the \imports\imports.standart.mfAras Import Manager CD Image folder file.
  3. Copy the following ＜package＞ elements: 
<imports>
<package name="com.aras.ark.im.standard" path="ark\im\standard">
<dependson name="com.aras.ark.im.core" />
</package>
</imports>

  1. Paste the ＜package＞ elements into the \AML-packages\imports.mf file in the Work.git repository.
  2. Open the \imports\imports.pe.mfAras Import Manager CD Image folder file.
  3. Copy the following ＜package＞ elements: 
<imports>
<package name="com.aras.ark.im.pe" path="ark\im\pe">
<dependson name="com.aras.innovator.solution.PLM" />
<dependson name="com.aras.ark.im.core" />
</package>
</imports>

  1. Paste the ＜package＞ elements into the \AML-packages\imports.mf file of the Work.git repository.
  2. Save and close \AML-packages\imports.mf file in the Work.git repository.

Include Config Transformations

  1. Add a configuration transformation file for the ConversionServerConfig.xml in the \TransformationsOfConfigFiles\ folder of the Work.git repository with the following content: 
<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
    <configSections xdt:Transform="Replace" xdt:Locator="XPath(/configuration/configSections)">
        <section name="oauth" type="Aras.OAuth.Configuration.OAuthSection, Aras.OAuth.Configuration"/>
        <!-- Common converter service configuration -->
        <section name="ConversionServer" type="Aras.ConversionFramework.ConversionServer.Configuration.ConversionServerConfigurationSection, Conversion.Base"/>
    </configSections>
    <ConversionServer>
        <Converters>
         <Converter name="AIM_Import_GenericConverter" type="Aras.Ark.ImportManager.Conversion.GenericConverter,Aras.Ark.ImportManager.Conversion" xdt:Transform="Insert"/>
         <Converter name="MDV_ConversionType" type="MDVExporter.ConversionServer.DefaultConversionServer, MDVExporter" xdt:Transform="Insert"/>
        </Converters>
    </ConversionServer>
</configuration>

Note
The ConversionServerConfig.xml is available from the Baselines Artifact feed of the SDE for reference when building configuration transformation files.

  1. Add a configuration transformation file for the method-config.xml in the \TransformationsOfConfigFiles\Innovator\Server folder of the Work.git repository with the following content: 
<MethodConfig xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
<ReferencedAssemblies>
<name xdt:Transform="Insert">$(binpath)/Aras.Ark.ImportManager.dll</name>
<name xdt:Transform="Insert">$(binpath)/Aras.Ark.ImportManager.CustomReader.dll</name>
</ReferencedAssemblies>
        <Template 
        line_number_offset="34" 
        name="CSharp:Aras.Ark.ImportManager.ValidationRule.Validator" 
        xdt:Transform="Insert"><![CDATA[
using System;
using System.IO;
using System.Xml;
using System.Text;
using System.Collections;
using System.Collections.Generic;
using System.Data;
using System.Linq;
using System.Net;
using System.Globalization;
using Aras.IOM;
using Aras.Server.Core;
using Aras.I18NUtils;
using Aras.Ark.ImportManager;
using Aras.Ark.ImportManager.Model;
using Aras.Ark.ImportManager.Validation;
namespace $(pkgname)
{
    public class $(clsname)
    {
        private readonly Aras.Server.Core.CallContext CCO;
        private readonly Innovator Innovator;
        public $(clsname)(IServerConnection serverConnection)
        {
            this.Innovator = new Innovator(serverConnection);
            this.CCO = ((Aras.Server.Core.IOMConnection) serverConnection).CCO;
        }
        public Item Validate(Item context, Import import, MappedRow row)
        {
            $(MethodCode)
        }
    }
}
]]>
        </Template>
        <Template 
        line_number_offset="34" 
        name="CSharp:Aras.Ark.ImportManager.Doer" xdt:Transform="Insert"><![CDATA[
using System;
using System.IO;
using System.Xml;
using System.Text;
using System.Collections;
using System.Collections.Generic;
using System.Data;
using System.Linq;
using System.Net;
using System.Globalization;
using Aras.IOM;
using Aras.Server.Core;
using Aras.I18NUtils;
using Aras.Ark.ImportManager;
using Aras.Ark.ImportManager.Model;
using Aras.Ark.ImportManager.Validation;
namespace $(pkgname)
{
    public class $(clsname)
    {
        private readonly Aras.Server.Core.CallContext CCO;
        private readonly Innovator Innovator;
        public $(clsname)(IServerConnection serverConnection)
        {
            this.Innovator = new Innovator(serverConnection);
            this.CCO = ((Aras.Server.Core.IOMConnection) serverConnection).CCO;
        }
        public Item Do(Item context, Import import, MappedRow row)
        {
            $(MethodCode)
        }
    }
}
]]>
        </Template>
</MethodConfig>

  1. Add a configuration transformation file for the conversion.configin the \TransformationsOfConfigFiles\AgentService\ folder of the Work.git repository with the following content: 
<?xml version="1.0" encoding="utf-8"?>
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
  <Innovator>
    <Conversion>
    <ProcessingCycles>
      <cycle xdt:Transform="Insert" ConversionRuleName="AIM_Import_GenericConversionRule" DB="${DBName}" Interval="10000" MaxBatch="20" User="admin" />
    </ProcessingCycles>
     </Conversion>
  </Innovator>
</configuration>

Configure environment variables

  1. Navigate to your Implementation Project > Pipelines > Library and select + Variable group.
  2. Enter a value in the Variable group name field.
  3. To add a variable, click + Add and specify the following:

Name: DBName

Value: ${ARAS_DB_NAME}

  1. Click Save to create the new variable group.

Test and deploy your changes

  1. Stage and review the changes to ensure that no customizations are overwritten.
    1. Commit the changes.
    2. Run the “continuous-integration” pipeline.
    3. Run the “deploy-innovator” specifying “Custom config variable group name” parameter in the pipeline with the name of Variable created in step 2 of “Configure environmental variables” section to complete the installation.

Confirming the Solution Installation

Use the following procedure to check if the database has correctly applied the Aras Import Manager changes to Aras Innovator:

  1. Log in to Aras Innovator as an administrator.
    1. From the TOC, select Administration --> Variables.
    2. Confirm that the following Application Domain are listed:

Aras Import Manager

14.0.1

If at any time the installation fails, revert to your backups, and contact Aras Support at support@aras.com.