As the product manager for TBM Studio and the OOTB applications we have built on top of it, let me clarify a few things about content upgrades and specifically tables.
Platform upgrades (e.g. Server 12.10.1 / Client 1.11) have no impact on the configuration of any applications. These upgrades only change the behavior of the TBM Studio and the underlying calculation model.
Content upgrades (e.g. Template v110) will impact the configured applications (e.g. CT, BoIT). However, it is not an automatic upgrade when a new template is released. To upgrade to a new template, in TBM Studio ribbon > Project Settings > Components Version, you first need to select the latest version, then go to the Components feature to upgrade the individual components.
See "
About upgrading Cost Transparency" for a high-level overview of these concepts (Apptio help).
See "
Cost Transparency to the Latest Template Version" for a detailed description of the steps to follow.
Master Datasets are impacted in two different ways during the upgrade depending upon how you have linked the source files to the master datasets: Mapped Tables step vs Append step.
1.
Mapped Tables were created to avoid having to re-map your source tables/transform tables during the upgrade process. This is the recommended approach.
2.
Append step is the original method for linking your source tables/transform tables to the master data sets. Unfortunately, this step is seen as a customization by the platform during an upgrade. Two approaches can be followed for handling master datasets identified as "Customized" in the Component Upgrade screen.
a) Do not revert the datasets shown under "View Conflicts" and just "Upgrade" the component (yellow panel). The component will proceed and will update reports, metrics, etc. However, it will not change the master dataset so any modification you made will remain intact.
b) Revert the datasets show under "View Conflicts" and then select "Upgrade" (should be a blue panel if no customizations). The component will update all tables, reports, metrics, etc. Once complete, you will need to re-append and re-map your source tables. This can be a fair amount of work. One recommendation is to document and/or take screenshots of your current tables and mappings before doing the update.
My recommendation is to follow step a and NOT revert the datasets. The only issue is that if the OOTB content introduced a new column which is then used in a new / modified report, then the column will not be there. You can review the table changes made to master data set tables during the different template updates and manually add the columns as needed.
Here is the list of
Dataset changes for applications on TBM Studio 12.9 (e.g. Template v109). The previous versions are available on Community. Server 12.10.0 / Client 1.10 introduced the latest Template v110. However, there were no changes to the existing master datasets (as of this point in time).
Original Message:
Sent: 05-19-2022 12:12
From: Michael Enslein
Subject: Mapping Columns to Multiple Master Data sets
β@Mitch Miller @Martyn Dawes @Jenny Franklin this only happens if you revert the OOTB table during the upgrade process. However this seems to be a catch 22, if you do any updates to master table ie appends. if you don't do the revert then when you do the upgrades in the tables. Seems to be counter productive sometimes because everything has to be customized at some point. Just my thoughts.
Original Message:
Sent: 05-19-2022 11:37
From: Mitch Miller
Subject: Mapping Columns to Multiple Master Data sets
Hey @Martyn Dawes and @Jenny Franklin I want to say this has happened on all component upgrades as it wipes out customizations and appends have always been a customization. I don't think this is new for just the latest upgrade. This is why there are some best practices to have a Pre Append File that you append into the master that lines up 100%, so you just append the table and the columns line up perfectly and you just click the save button. If this new for this upgrade then the pre append file could be a quick work around!ββ