Disclaimer: Please note that, while the ThingWorx Git Backup Extension is a very useful tool, it is not a PTC product, nor is it supported by PTC.
Hi ThingWorx users,
Trying to manage your ThingWorx application artifacts in a CI process? Wondering who changed that line of code in your Thing Service? Trying to see what your Mashup looked like last release? Time to Git excited! Introducing the Git Backup Extension, an open-source tool available here to offer a stronger integration with the Git source repository. This Git feature can push or pull code and artifacts (like entities, data exports or extension dependencies) to your Git repository.
Here are some highlights of how this works within ThingWorx:
First, configure your Git repo to work with ThingWorx by creating a Git Backup Thing. Then, simply open your new Thing, navigate to the Configuration editor and enter information like your Git URL, your Git username and password, your repo and branch names, etc. See example below.
With this configuration in place, you can now use the Home Mashup of this new Git thing to browse the repository and pull down contents to your local ThingWorx instance. For new projects, you can also push new entities to the repo as you work on your application.
As you and your team are working, you’ll want to see the differences of the files you are editing and working on collaboratively. The Git extension feature makes this easy. Just like you can see diffs clearly delineated for a file with your Git client, you can see the same with this Git integration in ThingWorx. Similar to the git status command, the Git ThingWorx extension will show you the list of files you have changed that are available to push, as well as their diffs. See an example below.
While working, if you want to switch branches or pull down a new project, you can check out a specific version and see all commits available on that branch (see below).
P.S. What do you think? Comment your thoughts below!
Do you know if an equivalent extension exists, providing configuration management integration with SVN (Apache Subversion)?
SVN is still often the default configuration management system on a lot of projects.
Thanks for reaching out. Currently, we do not have plans for SVN for the Extension. Although, as you may already know, SVN can be used with ThingWorx through the "Export to Source Control" feature of our entities/application constructs.
Hey users, anyone else want SVN? Comment here!
The export entities for Source Control does not provide an easy "thing by thing" handling (checkout/commit) like the Git extension.
I have installed this extension and configured.
I am not able to see any repository on mashup page .
I am able to use all git commands from repository created into storage, but only tis it is not getting displayed in mashup. Find attached screen shot for reference.
Let me know if anyone has faced this issue.
Thanks in advance,
Vishwas, can you share the values from the Configuration page from that Git thing that was created?
Also, can you share if the Thing has a ThingShape attached in the General Information page?
Can you first check if the bitbucket url link is in the format https://bitbucket.org/[user/team]/[repositoryname] ?
<Vishwas> Yes Bitbucket URL is this format
Second, are you using absolute or relative paths in your platform-settings.json file?
<Vishwas> Its absolute path
Third, have you tried doing a Pull and post the results of the Application Log?
<Vishwas> I was getting error in application logs
[context: com.thingworx.webservices.context.HttpExecutionContext@2eb0da7b][message: File Repository Must Be Specified]
but after some time that error also gone.
Now not getting any error.
I can do all operations by going to that repository into file system but not able to see in mashup.
It was really quick.
I think this extension is must have for any project and should be included in out of the box ThingWorx product.
Is the Git backup extension still available? I can't find it on the Marketplace. And is it compatible with Thingworx 8.5?
Version 3.0.0 was released:
-it was tested against ThingWorx version 8.5.x
-removes the lastModifiedDate to allow easier to understand commits
-allows developers to commit using their own Commit Name and Email (persistence per user, via UserExtensions ThingShape)
GitBackup version 3.0.1 was released:
-tested to allow compatibility from 8.2.0 (Community enhancement - Petrisor Lacatus)
I am using ThingWorx 8.3.13-b41 version of thingworx and I am not able to load the GitBackupExtension. It is showing me one error.
Thanks, I found <preview> in 7 mashups and when I tried to import it again, I faced below issues which I resolved by removing the attributes ( 'aspect.bindingDirection', 'aspect.isMandatory' and 'aspect.isFlex' ) from the properties. Not sure about the impact of these changes which I made to resolve this issue.
Error parsing C:\ThingworxStorage\extensions\temp\GitBackupExtension_500ad6c5-cd57-4368-93ec-79fecab9eabc\GitBackupExtension\Entities\Mashups_GitBackup.NewRepo.Mashup.xml: (47, 30): cvc-complex-type.3.2.2: Attribute 'aspect.bindingDirection' is not allowed to appear in element 'FieldDefinition'.
Error parsing C:\ThingworxStorage\extensions\temp\GitBackupExtension_bdf1f3ba-bf3e-42b3-810f-a933d1079211\GitBackupExtension\Entities\Mashups_GitBackup.NewRepo.Mashup.xml: (46, 30): cvc-complex-type.3.2.2: Attribute 'aspect.isMandatory' is not allowed to appear in element 'FieldDefinition'.
Error parsing C:\ThingworxStorage\extensions\temp\GitBackupExtension_ae9c5436-ea48-4898-babd-540e0ea8806e\GitBackupExtension\Entities\Mashups_GitBackup.PushSettings.Mashup.xml: (25, 18): cvc-complex-type.3.2.2: Attribute 'aspect.isFlex' is not allowed to appear in element 'Mashup'.