Install Outlook Web Add-in for End Users

This article describes how to install the Archibus Outlook Web add-in for end users.

After all OIDC configuration steps described in the following:

Also, the add-in is hosted on a server next to Archibus Web Central, and then the add-in can be installed in Outlook.

  • Multi-user installation occurs via the Microsoft Office 365 admin portal.

  • Single users can install the add-in by themselves in their own Outlook Online.

To complete these steps you need the add-in manifest.xml file populated with the correct endpoint URL and client id, as described in Integrate Outlook web add-in with Azure AD for SSO | Archibus Outlook Web add in configuration .

Note: Only changes in the manifest.xml file require re-installation of the add-in for end users. Changes in the application code or assets can simply be deployed to the server hosting those files.

End user system requirements

The add-in works with

  • Outlook 2019 for Windows

  • Outlook for Office 365 on Windows

  • Outlook on the web

  • new Outlook for Windows and Mac OS

Multi-user installation via Office 365 admin portal

Deployment via the Office 365 admin portal ensures the add-in becomes available in all supported versions of Outlook. Propagation of the installation can take up to 6 hours according to Microsoft.

  1. Navigate to https://admin.microsoft.com and sign in as an Office 365 tenant administrator.

  2. Select Settings > Integrated Apps > Upload custom apps.

install_outlook_addin_end_user1.png

  1. Change the app type to Office Add-in.

install_outlook_addin_end_user2.png

  1. Select Upload manifest file from device.

  2. Select Choose file and select the add-in's manifest.xml file from your computer.

install_outlook_addin_end_user3.png

  1. If the file is valid, a message “Manifest file validated” will appear in green below the file name.

  2. Click Next.

  3. Choose whether to deploy to just yourself, to the entire organization or to specific users/groups.

install_outlook_addin_end_user4.png

  1. Click Next.

  2. On the Accept permission requests page, select the Accept permissions button.

install_outlook_addin_end_user5.png

  1. A popup will open where you need to confirm granting the required permissions.

install_outlook_addin_end_user6.png

  1. Select Accept. The popup will close and the message ‘Permissions accepted’ appears in place of the ‘Accept permissions’ button.

install_outlook_addin_end_user7.png

  1. Click Next.

  2. Click Finish deployment.

install_outlook_addin_end_user8.png

  1. Microsoft will now start the initial deployment. Wait for this to complete.

install_outlook_addin_end_user9.png

  1. When this is completed, the confirmation page indicates that it can take up to 6 hours for the add-in to appear in Outlook.

install_outlook_addin_end_user10.png

  1. Click Done. The add-in is now listed under Integrated apps.

install_outlook_addin_end_user11.png

  1. Allow time for the add-in to propagate, then check if it appears in the Appointment Organizer ribbon for the users it was assigned to.

Single user installation in Outlook Online

  1. Sign in to Outlook.

  2. Browse to https://aka.ms/olksideload . This link opens a popup over your Outlook mailbox, titled Add-Ins for Outlook.

install_outlook_addin_end_user12.png

  1. Select My add-ins.

  2. Scroll down to Custom Addins.

install_outlook_addin_end_user13.png

  1. Select Add a custom add-in > Add from File...

install_outlook_addin_end_user14.png

  1. Select the add-in's manifest.xml file from your computer.

Accept any prompts that follow.

install_outlook_addin_end_user15.png

  1. When the installation is completed, the add-in is listed under Custom Addins.

install_outlook_addin_end_user16.png

Test that the add-in loads correctly.

  1. Open a new appointment window: select the drop down menu next to New mail and select Event.

install_outlook_addin_end_user17.png

  1. To activate the add-in, click the Archibus Room Finder button on the ribbon (possibly in the ribbon's overflow menu).

install_outlook_addin_end_user18.png

  1. If the add-in doesn’t appear on the ribbon, try closing and reopening your browser.

View installed manifest version

Users can check which version of the manifest is deployed to their account via Outlook.

Note: The manifest version can be different from the version displayed on the add-in task pane because add-in updates don’t necessarily require installing a new version of the manifest file.

  1. Select the More Apps icon on left.

install_outlook_addin_end_user19.png

  1. Select the Add apps button on the bottom.

install_outlook_addin_end_user20.png

  1. Select Manage your apps on the bottom.

install_outlook_addin_end_user21.png

  1. Select the Archibus Room Finder from the list.

install_outlook_addin_end_user22.png

  1. Check the version number displayed under App Features.

install_outlook_addin_end_user23.png