Skip to main content
Mitratech Success Center

Client Support Center

Need help? Click a product group below to select your application and get access to knowledge articles, webinars, training content, and release notes or to contact our support team.

Authorized users - log in to create a ticket, view tickets status and check your success plan details.

 

Installation Guide for TeamConnect Enterprise Add-in Versions 3.0

The guide details the prerequisites, system requirements, and step-by-step installation instructions, and troubleshooting for the TeamConnect Office and Outlook add-ins.

Introduction

The information and instructions on this page apply to version 3.0 of TeamConnect Office Suite.

TeamConnect Office integrates into Microsoft Word, Excel, and PowerPoint.

TeamConnect Outlook integrates with Microsoft Outlook.

You must install each add-in separately

  • First, you have get the TeamConnect add-in installation files,
        Note: You no longer have to install the TeamConnect add-in module. If you need the installation files, please reach out to Mitratech Support.
  • Then, you install the Office add-in,
  • Lastly, you install the Outlook add-in 

Note: The Office Integration License file must be installed, this can be verified by checking the Office Configuration tab, this will show even if license is not installed, but it will say "Office Suite License not found" if there isn't a license installed. If you see this message please reach out to your TeamConnect admin or Mitratech Support. 

 

Performance Note: 

Performance will vary depending on the number of integrated search views and the number of projects returned by those search views. Testing of Office Suite 3.0 indicates the following results

  • An environment with 23 integrated search views can be initialized in 5 seconds.
  • An environment with 54 integrated search views can be initialized in 11 seconds. 

These numbers might be affected by other factors such as PC configuration (RAM, CPU, etc.) as well as the network limitations (speed, latency, etc.).

 

System Requirements

Upgrade Considerations:

TeamConnect Office Suite 3.0 can be upgraded from any 2.X version of TeamConnect Office Suite. 

Users with versions prior to 2.X must first upgrade through the 2.X installer on the Available Updates in TeamConnect.

TeamConnect Office Suite 3.0 does work with Microsoft Word, Excel, PowerPoint, and Outlook 2013.

 

System Requirements for 3.0

  • Must be able to run installer as an administrator
  • TeamConnect Essentials or Enterprise 6.0+
  • For TeamConnect 32 & 64 bit Office: Microsoft Word, Excel, and PowerPoint 2013 & 2016. 
  • For TeamConnect 32 & 64 bit Outlook: Microsoft Outlook 2013 & 2016.
    Note: Please make sure you install the appropriate versions of the add-in with your version of Office/Outlook. Example: 32 bit add-in for 32 bit Office/Outlook. 
  • Prior to moving to Office Suite 3.0, users should be on the following versions of TeamConnect and/or Patches:
Version Patch
TeamConnect Enterprise 6.0+  
TeamConnect Essentials  

Know How to Determine Your Plugin Version.

Installing the TeamConnect Add-ins

  1. Go to Available Updates in TeamConnect, click the Install Now button.
  2. Run the Installer for the Add-in.

Installing the Office Add-in

  1.  Select the appropriate x86 or x64 installer based on your version of Office.
     
    • x86 is used for 32-bit Office
    • x64 is used for 64-bit Office

      Note:  This is not based on your version of the Windows Operating System. Please make sure you install the appropriate versions of the add-in with your version of Office/Outlook. Example: 32 bit add-in for 32 bit Office/Outlook.
      To find what version of Office you have, go to File > Account > About Word. You can check any Microsoft Office system, it doesn't have to be Word (e.g. PowerPoint, Excel, etc.) 
  2. In the \\TeamConnect Office Add-ins\Office\x86 - For 32-bit Office installs, right-click the setup.exe file and select Run as Administrator. The add-in will not install correctly if you do not run as admin.
    • Note: This is the recommended file to run regardless of if you have a 32- or a 64-bit machine
  3. Follow the steps in the Wizard to complete the install.
    • Note: The installer will look for any older versions of the add-in and prompt you to remove them prior to updating to 3.0
  4. Click Next from the Mitratech TeamConnect Outlook Add-in window. 
  5. From the Mitratech Setup window, enter the URL for your instance of TeamConnect.
    Be sure to include http:// at the beginning of the URL, and a / at the end of the URL (e.g. http://testsite:1234/4.0.2/).

    Note: If you need help with any Proxy setup instructions, please see the configuration guide here.

    Note: If you want to preset the login URL for your users, enter "false" in the URL editable entry field. This will ensure that users cannot edit the log-in URL. Entering "false" will not work if there is no log-in URL. Enter "true" if you would like to make the URL editable. All fields left blank will default to "true."
  6. If you want to change the location of where this is stored, click the Browse button. Otherwise click the Next button to use the default folder.
  7.  Click Next to begin the installation.
  8. Click Next from the Mitratech Setup window.
  9. Click Close to exit the installer.

After successful installation, the TeamConnect tab appears in Microsoft Word, Excel, and PowerPoint.

 

 

Installing the Outlook Add-in

  1.  Select the appropriate x86 or x64 installer based on your version of Office.
     
    • x86 is used for 32-bit Office
    • x64 is used for 64-bit Office

      Note:  This is not based on your version of the Windows Operating System.
      To find what version of Office you have, go to File > Account > About Outlook.
      ​​​​​​
  2. In the  \\TeamConnect Office Add-ins\Outlook\x86 - For 32-bit Outlook installs, right-click the setup.exe file and select Run as Administrator..
  3. Follow the steps in the Wizard to complete the install.
  4. Click Next from the Mitratech TeamConnect Outlook Add-in window. 
  5. From the Mitratech Setup window, enter the URL for your instance of TeamConnect.
    Be sure to include http:// at the beginning of the URL, and a / at the end of the URL (e.g. http://testsite:1234/4.0.2/).

    Note: If you want to preset the login URL for your users, enter "false" in the URL editable entry field. This will ensure that users cannot edit the log-in URL. Entering "false" will not work if there is no log-in URL. Enter "true" if you would like to make the URL editable. All fields left blank will default to "true," with the exception of Browser Enabled.

    Note: If you want to remove the built-in browser from Outlook, enter "false" in the Browser Enabled entry field. Enter "true" to leave the browser in the program.
    clipboard_ea2c11556cee017bf98b810ac7b42359b.png
  6.  Click Next to begin the installation.
  7. Insert any Proxy information needed.
  8. If you want to change the location of where this is stored, click the Browse button. Otherwise click the Next button to use the default folder.
  9. Click Next from the Mitratech Setup window.
  10. Click Close to exit the installer.

After successful installation, the TeamConnect tab appears in Outlook.

If you need to change your TeamConnect login information, click the Settings button from the TeamConnect pane. Entering your login information allows TeamConnect to integrate with the Office programs.

Confirm that the Add-in was installed successfully

Once the add-ins are installed, open Office and/or Outlook and verify you can see the TeamConnect add-in pane. If you cannot see the pane on the right hand side, then you may need to confirm the add-in is enabled:

  1. Under File > Options > Add-ins > click "Go..."
    • next to "Manage: COM Add-ins," verify the check box is checked for "TeamConnectOfficeAddIn"
      Confirm_AddIns.png
  2. Once you have confirmed that the add-in is enabled in Office/Outlook, if the pane is still not showing, then check the .ini file for the user on the machine to verify that the views are enabled.

    • Office: C:\Users\<user name>\AppData\Roaming\Mitratech\Office Settings\OfficeSettings.ini

    • Outlook: C:\Users\<user name>\AppData\Roaming\Mitratech\Outlook Settings\OutlookSettings.ini
      • Note: you may need to set Windows Explorer to show hidden items, in Windows X, this is done by going to View > checking the 'hidden items' box

    • If the boolean is set to "True," then it will be visible within Outlook.
      Office_INI.png
  3. Once you have the TeamConnect pane visible in Office/Outlook, you can configure the connection to your TeamConnect instance. Open the settings by clicking on the Gear icon on the top of the TeamConnect pane. There will be three fields to fill out if you are using a proxy.

    a. Click the Settings button in the TeamConnect Ribbon:
    clipboard_e43fba84c6fede650a2d29fe8e5a77e90.png

    b. From here, you will need to fill out the URL, Username, & Password fields. Only fill out the others if needed per your proxy settings or if no login information was inputted during initial installation.
    clipboard_e0acb5f2e665dfdae31e1785ff0fb7228.png
Command Line Installation  

Version 3.1.0+ offers the ability to install from the command line via Windows Powershell. Below is an example:

#sample commands for windows powershell

$url="" #<instance url everything up to but not including "/login" from the TC login >
$editableUrl=True #[True|False] whether or not the end user can modify the url through the Settings panel in the plugin
$proxyHost="" #<proxy host>
$proxyPort="" #<proxy port>

$outlookInstaller="MitratechOutlookAddInSetup.msi" #<outlook installer msi location>
$officeInstaller="MitratechOfficeAddInSetup.msi" #<office installer msi location>

#run the installers from the command line silently with no interaction
msiexec /i $outlookInstaller URL=$url URLEDIT=$editableUrl PROXYHOST=$proxyHost PROXYPORT=$proxyPort /qn
msiexec /i $officeInstaller URL=$url URLEDIT=$editableUrl PROXYHOST=$proxyHost PROXYPORT=$proxyPort /qn

URL, URLEDIT, PROXYHOST, PROXYPORT are each optional

 

If you need to change your TeamConnect login information, click the Settings button from the TeamConnect pane. Entering your login information allows TeamConnect to integrate with the Office programs.

Having an issue with .NET? Click Here.

Note: If you are upgrading from the add-in version 2.2 to version 3.X and you have changed the column orders in your document display, when you first start Outlook or Office, the columns will show up in the default order instead of the customized order. To resolve this, open Settings and hit OK, the columns will then change to the customized order.