Applied Dimensionality

TM1 Git integration - why it doesn't work for me

Posted at — Jul 14, 2022
TM1 Git integration - why it doesn't work for me

Thought it’d be interesting to write out the things that stop me from using TM1 Git integration so far. There’s been a few discussions on tm1forums that highlight some of them:

and I wrote a couple a posts about it.

Most of this post is perfectly summed up in the single forum reply by lotsaram, feel free to read that and skip this post, I’m using it as a chance to state document why I stopped trying :)


I like version-control a lot (the blog you’re reading was published via a git push :) ) and use Git for any scripting outside of PA/TM1.

I also know / worked at a few TM1 projects that were large enough that version-control and deployment automation was necessary and it was built with Git, but without Git REST API integration functionality and with scripted copy objects to folder - push to git / pull from git - copy or patch objects to server mechanics instead.

So why people re-invent or ignore the ‘built-in’ git integration?

IBM design approach to Git integration

Gleaning the intended workflow from current Git integration concepts it feels like what IBM envisaged was:

This is very different from the usual TM1 set up of:

The difficulty of selecting a specified set of objects in the current Rest Api calls prevents using them in this workflow. Yes you can craft clever project files to carve the required pieces out (I wrote about it), but it immediately goes into ‘too hard’ basket in practice.

Target audience and Git

The design problem above could be solved by everyone being extra dilligent, cherry-picking objects and creating custom commits with Git, but most TM1 developers are better at balancing a balance sheet than merge conflicts.

The level of Git proficiency required to work around the design limitations greatly exceeds the amount of time people are happy to spend on it. And as a guy who routinely messses every 7th of his git commits I’m fully not ready to try to force this cognitive burden on anyone.

And the problem exacerbated by the fact that none of the current tools includes this integration, so that everyone needs to

and those scripts need to be able to authenticate properly / have a place to be run from / have a good level of error handling and so on and so forth, so by the time you’re writing those it’s actually easier to DIY the whole promotion without touch Git Rest API calls :(

comments powered by Disqus