Aras Office Productivity Connector Installation
Copy
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:
- Download the Aras Office Productivity Connector 27 CD Image from the Aras MFT site.
- Unzip the Aras Office Productivity Connector 27 CD Image on the local machine.
- Navigate to the
\Files\folder of the Aras Office Productivity Connector 27 CD Image. - Copy the contents of the
Innovatorfolder into the\CodeTree\Innovator\folder of theWork.gitrepository. - Copy the contents, except the
imports.mffile, from the..\Imports\..folder into theAML-packagesfolder of theWork.gitrepository.
imports.mffile, as it will overwrite the existing imports.mffile in the Work.git repository.
- Open the
..\Imports\imports.mffile. - 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>
- Paste the
<package>elements into theimports.mffile of theWork.gitrepository. - Copy
PostImportAMLScripts\5000_TemplateDeploy_PostAML.xmlto theAmlDeploymentScripts\2-AfterAmlPackagesImportdirectory. - Stage and review the changes to ensure that no customizations are overwritten.
- Commit the changes.
- Run the continuous-integration Pipeline.
- 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.
- Navigate to Microsoft Office online.
- Create a new document (e.g., New Word document).
- Click on the ellipsis (...), Add-ins, and More Add-ins.
- Click on Admin Managed. This will display the list of add-ins available at an organization level.
- Select the Aras Add-in. Click Add. This will enable Aras Office Productivity Connector for the application.
- 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:
- Open the
ArasOfficeProductivityConnector_Copy.xmlfrom the/CodeTree/Innovator/Client/Solutions/OfficeProductivityConnector/Manifestfolder. - Replace all instances of
{Innovator.URL}with the URL for the Aras Innovator instance being used. - Save and close the
ArasOfficeProductivityConnector_Copy.xmlfile. - Navigate to Microsoft Office online.
- Create a new document (e.g., New Word document).
- Click on the ellipsis, Add-ins, and More Add-ins.
- Click on My Add-Ins, Upload My Add-In, and Browse.
- Select the manifest file from the third step and click Upload.
Installing Aras Office Productivity Connector 27 for Microsoft Desktop Applications
- Copy the
ArasOfficeProductivityConnector_Copy.xmlfrom the/Innovator/Client/Solutions/OfficeProductivityConnector/Manifestfolder of the Aras Office Productivity Connector 27 CD Image to an alternative location.- Open the
ArasOfficeProductivityConnector_Copy.xmlfor editing. - Replace all instances of
{Innovator.URL}with the URL for the Aras Innovator instance being used. - Save and close the
ArasOfficeProductivityConnector_Copy.xmlfile. - Open Microsoft Office desktop application (e.g., Word).
- From the File menu, select Options, Trust Center, and Trust Center Settings.
- Click on Trusted Add-in Catalogs.
- Open the
- Click the Add catalog button.
- Select the folder to which the
ArasOfficeProductivityConnector_Copy.xmlfile was copied. - Select Show in Menu.
- Click OK.
- Click on Add-ins and More Add-ins.
- Click Shared Folder.
- Click Refresh.
- Select the Office Productivity Connector Add-in and click Add.