This article will demonstrate how to update reports from our Power BI template app. If newer reports are available you will see an indicator in your workspace. Only follow this path if you have customized the tyGraph report and you want retain your changes. Otherwise, click "Get it now" to update the app.
Keep in mind: You will require a Power BI Pro License to follow this guide. Be sure to back up any custom layouts you love. How do I tell if I have Power BI Pro?
If you have a Power BI free License, you will need to load our reports from a Power BI desktop model file (pbix) file. Please see this article: Updating Reports with a PBIX File
We will be doing most of our work in the Power BI service. Please open your browser and log in to https://powerbi.microsoft.com
Steps
Here are the general steps we will follow:
Step 1: Backup Old Reports
As much as it's tempting to hit the "Get it now" button. If you have edited report layouts, you will want to rename them so the update does not replace them. Anything with the default name will essentially be dropped and replaced. At the very least I usually screenshot the old report layouts that I care about.
Note: If you're constantly scared of losing your precious custom layouts. Check out our article on "Editing Unleashed with Live Connected Reports"
Also keep in mind that any attribute names that were changed from the old version will cause those old visuals to break. For example we recently clarified the "Location" attribute to say "User Location." After the update you will need to go in and update any visuals that used that attribute and add in the newly named attribute. For details skip to the
Be sure to re-name old reports that you would like to keep by prefixing them with the term - OLD. Essentially make sure there's nothing with the new default name that could be replaced ie. "tyGraph for Teams" etc.
Step 2: Load New App
Once you are sure you have any customized report layouts recorded/saved off. We can proceed to update.
If you have a notification in the Notification Centre, you can proceed to click the "Get it" link for the desired application.
Or, if you have a banner at the top of your workspace with the "Get it now" button, you can click it now.
Otherwise, follow these steps:
- Click "Get data" in the bottom left corner of your screen.
- Services "Get".
- Search for tyGraph.
- Select the appropriate App.
- Click "Get it now" and fill out the contact form. (We are working with Microsoft to bypass the contact form if you already have the app installed. We apologize for the inconvenience.)
- Select "Update the workspace and the app" (unless you want to install entirely new & separate workspace)
- Choose correct workspace, if prompted with a dropdown under the option above.
- Press Install
Step 3: Refresh & Cleanup
Observe the Refresh
From here you can watch the template app update the default content in the workspace. The template app will then automatically initiate a refresh for the dataset to fill the new dataset/report with your own data. We recommend you go and grab lunch or a coffee while it does this automatically. It usually takes 2 minutes to update the workspace, then it refreshes the dataset which depending on the size of your company, could take 5-20 minutes.
If you notice your own data isn't loaded, check the parameters set by the update:
If you make any changes to these parameters, remember to go back to the workspace and initiate a refresh in the moment to force it to pull in the changes you just applied.
Sort out any Dead Visuals
If you kept old report that had visuals on attributes that were renamed then you will see this message as the old visuals can't find that element in the new dataset. There is no need to worry simply edit the visual and add in the newly named visual.
For example recently "Location" was changed to become "User Location" which you will need to re-associate in visuals. For a full guide see this article: Re-Pointing Visuals After Update : Support (tygraph.com)
This is also a good time to clear out old visuals and delete reports that clutter your workspace and are no longer used.
Couldn't overwrite the app
If you get this error while updating your workspace, please follow the steps below.
- Unpublish your app
- Get the latest update by clicking the "Get it now" button in the workspace.
- Ensure your dataset is connected and refreshed with your data.
- Re-publish your app by clicking on the Create App button.