New Feature

This is a new feature in Joget DX

这是Joget DX的新功能

Introduction

Joget DX provides an automatic integration with Git behind the scenes. All app definitions and components are stored in the filesystem and version controlled using Git, including plugins and resources. Should you wish to integrate with an external Git, Git Configuration allows users to integrate with an external version control using Git.

Joget DX在后台提供了与Git的自动集成。所有应用程序定义和组件都存储在文件系统中，并使用Git进行版本控制，包括插件和资源。如果您希望与外部Git集成，Git Configuration允许用户使用Git与外部版本控制集成。

To access into the built-in Git, the local repository is in <Joget installation folder>\wflow\app_src\<App ID>\<App ID_version number>

要进接内置的Git，请在本地存储库中寻找<Joget installation folder>\wflow\app_src\<App ID>\<App ID_version number>

Example

C:\Joget-DX8-Enterprise\wflow\app_src\expenseclaim\expenseclaim_1

For more information on the built-in Git repository directory structure, see Built-in Git Project Directory Structure

有关内置Git信息库目录结构的更多信息，请参见内置Git项目目录结构。

Currently, Users will not be able to customize the Git Message during Commit.

当前，用户在提交期间将无法自定义Git消息。

Git Configuration Properties

Figure 1: Git Configuration Properties

Name 名称	Description 描述
Remote Git URL 远程GIT URL	The URL to the remote Git server (e.g. GitHub, BitBucket, GitLab, internal servers, etc) to push commits to 远程Git服务器（例如GitHub，BitBucket，GitLab，内部服务器等）的URL，以将提交推送到
Remote Git Username 远程GIT用户名	The username to authenticate to the remote Git server 用来验证远程Git服务器的用户名
Remote Git Password 远程GIT密码	The password to authenticate to the remote Git server 验证到远程Git服务器的密码
Exclude App Configuration (Environment Variables and Plugin Default Properties) 排除应用程序配置（环境变量和插件默认属性）	Check this to NOT commit environment variables and plugin default properties. This is meant for configuration values (e.g. settings that might differ in development vs testing vs production) 选中此选项可不提交环境变量和插件默认属性。这是用于配置值（例如，在开发，测试和生产中可能会有所不同的设置）
Always Pull from Remote Server 总是从远程服务器拉	Check this to allow pull from the remote Git server on every request. If unchecked, it will only pull before it attempts to push any updates. 选中此选项可允许在每次请求时从远程Git服务器拉出。如果未选中，它将仅在尝试推送任何更新之前拉入。 This greatly slows down the request and should only be used in a development environment. 这会大大减慢了请求的速度，应仅在开发环境中使用。
Auto Sync DB From Git 从Git自动同步数据库	Check this to automatically check for updates in the Git project files and to update the DB definitions accordingly 选中此选项可自动检查Git项目文件中的更新并相应地更新数据库定义

Built-in Git Project Directory Structure

内置的Git项目目录结构

Git app definition files are saved in the following directory structure:

Git应用程序定义文件保存在以下目录结构中：

wflow

|- app_src

|- appId

|- app.properties

|- appId_version

|- appDefinition.xml

|- appConfig.xml

|- package.xpdl

|- forms

| |- form.json

|- lists

| |- list.json

|- userviews

| |- userview.json

|- resources

| |- file.ext

|- plugins

|- plugin.jar

Description of each file / directory

每个文件/目录的描述

File / Directory Name 文件/目录名称	Description 描述
app_src	Directory under wflow containing all the Git projects wflow下的目录，其中包含所有Git项目
appId	Each app has a directory with the app ID as its name e.g. “crm" 每个应用都有一个以应用ID为名称的目录，例如“ crm”
app.properties	Configuration file containing the settings as saved in the app Git Configuration UI. This file applies for all app versions. 包含保存在应用程序Git配置UI中的设置的配置文件。此文件适用于所有应用版本。
appId_version	Under the app directory, each app version has its own directory e.g. version 3 of app ID “crm” would be “crm_3”. This is the directory that contains an entire app version including its dependencies e.g. plugins. 在应用目录下，每个应用版本都有自己的目录，例如应用ID“ crm”的版本3为“ crm_3”。该目录包含完整的应用程序版本，包括其依赖项，例如插件。 Note Within this directory, each app version is a separate Git branch. It might seem then it is being duplicated for each version, but this is required to cater to the possibility of different app versions being worked on concurrently. 在此目录中，每个应用程序版本都是一个单独的Git分支。似乎每个版本都在复制它，但这是必须的，以适应同时处理不同应用程序版本的可能性。
appDefinition.xml	XML containing the main app definition, including the process mappings, message and resource records. 包含主要应用程序定义的XML，包括流程映射，消息和资源记录。
appConfig.xml	XML containing environment variables and plugin default properties. This file is meant to keep configuration values (e.g. settings that might differ in development vs testing vs production), that can be omitted from Git commits if required. 包含环境变量和插件默认属性的XML。该文件用于保留配置值（例如，开发，测试和生产中可能会有所不同的设置），如果需要，可以从Git提交这些配置值。
package.xpdl	XPDL definition for the app processes. 应用程序流程的XPDL定义。
forms 表单	Directory containing form JSON definitions. Each form is saved as 1 JSON file. 包含表单JSON定义的目录。每个表单都保存为1个JSON文件。
lists 数据列表	Directory containing datalist JSON definitions. Each datalist is saved as 1 JSON file. 包含数据列表JSON定义的目录。每个数据列表均保存为1个JSON文件。
userviews 用户视图	Directory containing form JSON definitions. Each userview is saved as 1 JSON file. 包含表单JSON定义的目录。每个用户视图均保存为1个JSON文件。
resources 资源	Directory containing uploaded resource files. 包含上载资源文件的目录。
plugins 插件	Directory containing custom plugins used. 包含使用的自定义插件的目录。

Disabling Git In Joget DX

Beginning from v7.0.6 release, we added a new JAVA_OPT parameter to disable or turn off the Git. This is done by adding -Dgit.disabled=true to your Joget startup script, for example:

set JAVA_OPTS=-Xmx2048M -Dwflow.home=./wflow/ -Dgit.disabled=true -javaagent:./wflow/aspectjweaver-1.8.5.jar -javaagent:./wflow/glowroot/glowroot.jar

If you opt to disable the Git in Joget DX, you can delete the ".\wflow\app_src" folder content to save some hard disk space in your development servers.

Space shortcuts

Page tree