Aras Office Productivity Connector Installation

Aras Office Productivity Connector is a platform component installed after Aras Innovator. Before installing Aras Office Productivity Connector, it is important to notify users that Aras Innovator will experience downtime. Additionally, it is important to create backups for the Aras Innovator code tree and database. Store these backup files securely, as they will be necessary for restoring the system to its pre-installation state if installation fails.

The following steps outline the process of installing Aras Office Productivity Connector:

Note
Aras Office Productivity Connector leverages Aras Office Connector components in Aras Innovator. Confirm Aras Office Connector components are applied before installing Aras Office Productivity Connector.

  1. Download the Aras Office Productivity Connector 27 CD Image from the Aras MFT site.
  2. Unzip the Aras Office Productivity Connector 27 CD Image on the local machine.
  3. Navigate to the \Files\ folder of the Aras Office Productivity Connector 27 CD Image.
  4. Copy the contents of the Innovator folder into the \CodeTree\Innovator\ folder of the Work.git repository.
  5. Copy the contents, except the imports.mf file, from the ..\Imports\.. folder into the AML-packages folder of the Work.git repository.
Note
Do not copy the imports.mffile, as it will overwrite the existing imports.mffile in the Work.git repository.

  1. Open the ..\Imports\imports.mf file.
  2. Copy the following <package> elements:
<imports>
<package name="MSO_StandardOnline" path="MSO_StandardOnline\Import">
<dependson name="MSO_Standard" />
<dependson name="MSO_References" />
<dependson name="MSO_Defaults" />
</package>
<package name="MSO_StandardOnlineDiscussion" path="MSO_StandardOnlineDiscussion\Import">
<dependson name="MSO_StandardOnline" />
</package>
<package name="appstudio" path="appstudio\Import" />
<package name="backgroundcronjobframework" path="backgroundcronjobframework\Import" />
<package name="appstudiotemplates" path="appstudiotemplates\Import">
<dependson name="appstudio" />
</package>
<package name="integrationframework" path="integrationframework\Import">
<dependson name="backgroundcronjobframework" />
</package>
<package name="productivitysuite.ps_basic" path="productivitysuite\ps_basic\Import" />
<package name="productivitysuite.ps_integrationframework" path="productivitysuite\ps_integrationframework\Import">
<dependson name="integrationframework" />
<dependson name="productivitysuite.ps_basic" />
</package>
<package name="productivitysuite.ps_backgroundcronjobframework" path="productivitysuite\ps_backgroundcronjobframework\Import">
<dependson name="backgroundcronjobframework" />
<dependson name="productivitysuite.ps_basic" />
</package>
<package name="sharepointintegration" path="sharepointintegration\Import" />
</imports>

  1. Paste the <package> elements into the imports.mf file of the Work.git repository.
  2. Copy PostImportAMLScripts\5000_TemplateDeploy_PostAML.xml to the AmlDeploymentScripts\2-AfterAmlPackagesImport directory.
  3. Stage and review the changes to ensure that no customizations are overwritten.
  4. Commit the changes.
  5. Run the continuous-integration Pipeline.
  6. Run the deploy-innovator Pipeline to complete the installation.

Install Aras Office Productivity Connector 27 for Organization

Aras Office Productivity Connector 27 can be deployed for use by an organization through the Microsoft 365 Admin Center. For more information, please refer to the following Microsoft documentation: Deploy add-ins in the Microsoft 365 admin center.

Select the Upload custom apps option when prompted and upload the Aras Office Productivity Connector 27 manifest files.

Client Installation

Enable the Aras Office Productivity Connector 27 add-in.

  1. Navigate to Microsoft Office online.
  2. Create a new document (e.g., New Word document).
  3. Click on the ellipsis (...), Add-ins, and More Add-ins.

  1. Click on Admin Managed. This will display the list of add-ins available at an organization level.

  1. Select the Aras Add-in. Click Add. This will enable Aras Office Productivity Connector for the application.
  2. Repeat steps one through five for each application that is to use Aras Office Productivity Connector.

Install Aras Office Productivity Connector 27 for Microsoft Online Applications Single User

To install Aras Office Productivity Connector 27 for a single user profile:

  1. Open the ArasOfficeProductivityConnector_Copy.xml from the /CodeTree/Innovator/Client/Solutions/OfficeProductivityConnector/Manifest folder.
  2. Replace all instances of {Innovator.URL} with the URL for the Aras Innovator instance being used.
  3. Save and close the ArasOfficeProductivityConnector_Copy.xml file.
  4. Navigate to Microsoft Office online.
  5. Create a new document (e.g., New Word document).
  6. Click on the ellipsis, Add-ins, and More Add-ins.

  1. Click on My Add-Ins, Upload My Add-In, and Browse.

  1. Select the manifest file from the third step and click Upload.
Note
For single-user manual installations, if automatic browser cache clearing is enabled, the add-in must be re-uploaded each time the browser cache is cleared.

Installing Aras Office Productivity Connector 27 for Microsoft Desktop Applications

  1. Copy the ArasOfficeProductivityConnector_Copy.xml from the /Innovator/Client/Solutions/OfficeProductivityConnector/Manifest folder of the Aras Office Productivity Connector 27 CD Image to an alternative location.
    1. Open the ArasOfficeProductivityConnector_Copy.xml for editing.
    2. Replace all instances of {Innovator.URL} with the URL for the Aras Innovator instance being used.
    3. Save and close the ArasOfficeProductivityConnector_Copy.xml file.
    4. Open Microsoft Office desktop application (e.g., Word).
    5. From the File menu, select Options, Trust Center, and Trust Center Settings.
    6. Click on Trusted Add-in Catalogs.

  1. Click the Add catalog button.
  2. Select the folder to which the ArasOfficeProductivityConnector_Copy.xml file was copied.
  3. Select Show in Menu.
  4. Click OK.
  5. Click on Add-ins and More Add-ins.

  1. Click Shared Folder.
  2. Click Refresh.
  3. Select the Office Productivity Connector Add-in and click Add.