Creating Git repository and commits in Qlik Sense

Learn how to start controlling the version of your application in Qlik Sense with Gitoqlok and make partial commits.

You can see the video alternative at the end of this page.

To create a repository for a Qlik application, open the Qlik Sense application and click on Gitoqlok icon on the top eight corner where your extensions are exhibited:

Gitoqlok pop-up window: Create Repository

You can also connect to existing repository as a branch if you are not located in a duplicated of a master application. If you are, Gitoqlok will detect that the master application that the current app was copied from already has a repository and propose you to connect to it as a branch.

There are two types of repositories: 1. Private - the repository will be visible only to you by default. 2. Public - the repository will be visible to everyone by default.

You can set the repository visibility on the settings page.

Besides, you can select your organization on the settings page. Your organization will own every repository by default.

Make your first commit

Specify the repository name and make the first commit by clicking on "Save Changes". Each commit must have a comment (a short description of your part of the work that you are going to save in the repository).

Gitoqlok links the repository with the application in Qlik Sense by application ID. You could see that in the description of a repository.

Please, don't change the description of your repository.

You can select what to commit to the Git repository from the current application: Load Script, App Objects, Bookmarks, Static Files, and Reload Tasks and Data Connections:

Commit includes: Gitoqlok

Gitlab provider: repositories grouping and subgrouping

If you are using GitLab provider, you are able to select the group and subgroup to store your repositories in:

Gitoqlok: grouping and subgrouping repositories in Gitlab

Once you have clicked on "Create Repository" can choose either to use the Personal Workspace or select an organization group (and a subgroup) to store your repository there.

Partial commit

As an app owner, Gitoqlok allows you to choose what to commit to the git repository.

Suppose you have created a repository for your app on a git server. Your application is connected to the Git repository, and up to that point, the latter includes only the README.md file:

REAMDE.md file

After you click on “Save Changes” to make commits, there are several options Gitoqlok allows you to commit: Load Script, App Objects, Bookmarks, and Attached Files. Reload Data Connections is an optional choice that lets your data connections stay updated.

Commit includes: Gitoqlok

Use the Local Changes tab to select the objects you want to include in the commit.

Select specific objects to commit

Suppose you are selecting to commit the "Load Script"

Commiting Load Script into Git repo: Gitoqlok

Proceeding to check your connected GitHub repository yields the following results: apart from the default REAMDE.md file, "data load script" and "loadScript.qvs" files, containing your committed load script are now uploaded.

GitHub repository contains load script now

If, on top of this, you tick "App Objects", several additional files are also uploaded to your GitHub repo:

The GitHub repository contains load script and app objects

If you have a Custom Theme set up for your Qlik app, it will be stored in your Git repository. You can follow the Git repository link to check that the Theme file was successfully stored:

Gitoqlok Custom Theme Serialization

Alternative: video tutorial

GitLab: Creating a repository. Grouping and subgrouping