How to Install Teamwork Analytics Reports in your Organization

The Teamwork Analytics Power BI apps are pre-made packs of reports, graphs and charts, designed to be populated with data from the Teamwork Analytics backend service. The reports are available for free from Microsoft AppSource. Users in your organization are required to have a Power BI Pro license to view the reports.

Installing the Teamwork Analytics Power BI apps requires entering Teamwork Analytics database credentials. Although users can install the app individually, we recommend that an admin installs the app once and then publishes it within their organization. This ensures that the database credentials remain private, supports automatically installation for end users, and allows for access to be limited to specific groups and individuals (if required). See below for step by step guides.

Installing and publishing Power BI apps

This process involves a PowerBI Pro user performing a one-time installation of the app from AppSource, then publishing the installed app to all the desired users within their organization.

To follow these steps, you must have the Teamwork Analytics database credentials (server name, database name, username and password).

Installing an app from AppSource

  1. Find the desire app on AppSource and click Get in now.
  2. Follow the steps in the Install & distribute template apps article on docs.microsoft.com.
    • At the “Connect your data” stage, enter the Teamwork Analytics database credentials.
    • If you wish for end users to receive the app automatically, see the Enabling automatic installation for end users section below. Otherwise, to distribute the app, copy the installation link after submitting the Update App form, and distribute it to the desired users.
    • We recommend you add more than one administrator to the access list on the template workspace, so that the app can be updated or unpublished in the future.

Updating Power BI apps

The process for updating an app is exactly the same as the initial installation process documented above.

The publisher should be given access to the original template workspace, then, when installing the latest version from AppSource, they will be given the option to “Overwrite an existing version”. Select the original workspace and click Install.

Finally, follow the same

Overwriting an app that is already installed

Enabling automatic installation for end users

During the Update App phase of installation, specify the target users in the Access list or check Entire organization, then check Install this app automatically.

All users with access will receive the app automatically via the My apps section on the homepage of app.powerbi.com and in their list of installed apps.

The Install this app automatically option must be enabled by an admin in the admin portal on app.powerbi.com. Look in Tenant settings then Push apps to end users. The option can be enabled for specific security groups, allowing you to restrict it to trusted publishers, or for all users in the organization.

For more information see the Publish apps from workspace article on docs.microsoft.com.

Updating a PowerBI app

Enabling automatic installation for end users