GitHub Integration with Uniface 10, Uniface 9 and Uniface 8

With the latest release of UD6 we have incldued a sneak peak at our support for tigher integration between Change Management and Uniface, with particular support for Uniface 10 and GitHub.

We've initially focussed on Uniface 10 integration because there is no 'additional menu' in Uniface 10, but it works just as well with Uniface 9.

There are two elements to this integration:

Quick access to working files.

Right click the UD6 chessboard icon and select 'changed files' to open the floating window.

Currently this window shows the 'recently changed' files (from this UD6 session). Future suggestions for expansion include:


The chessboard will automatically display notifications from GitHub while UD6 is running.

Future suggestions for expansion include:


To configure the GitHub integration you need to specify the settings in the ASN file

collaborate github port 443 host bearer d12ae72d99867b3ac08f071664b02b99c5528761 exe "git.exe" install "C:\Program Files\Git\bin" comment "@sales default comment" url /api/v3/notifications force-poll 3 repo origin branch master title Uniface GitHub Demo:

A brief guide to the settings follows.


here is a brief guide to the GitHub integration settings from USYS$UD6_PARAMS.

collaborate github - this is the main setting - all following settings are dependant, eg: collaborate github port 443 and collaborate github exe "git.exe"
port 443 - this is the port that the GitHub server is operating on
host - this is the IP address or hostname that the GitHub server is available at
bearer d12ae72d99867b3ac08f071664b02b99c5528761 - this is your login token. It is available on your GitHub profile page - copy and paste it to your ASN.
exe "git.exe" - the name of the git executable on your PC
install "C:\Program Files\Git\bin" - install location of Git on your PC
comment "@sales default comment" the checkin comment to use if the comment field is blank in the floating panel
url /api/v3/notifications - the notification url on your GitHub server
force-poll 3 - force polling of the GitHub server for notifications every n seconds. Not recommended (by default the GitHub server will supply a recommended polling interval which will be used).
repo origin the default git repository
branch master the default git branch
title Uniface GitHub Demo: - if provided, this must be the last setting

GitHub login token.

You will require a GitHub personal access token:

Credential Manager.

UD6 does not prompt for Git usernames and passwords, so you should use a credential manager:

$Revision: 1.4 $ $Date: 2019/06/22 08:17:09 $[go to top]