持续集成

活字格支持通过命令行直接进行发布网站，不用打开设计器发布。用户可以定时获取文件或者协作开发工程，然后使用此功能将工程自动发布到服务器上。

活字格提供了一个新的可执行文件”ForguncyConsole.exe”，与“Forguncy.exe”位于同一层级。

如果安装活字格设计器时，安装目录为默认目录，则此文件的路径为：C:\Program Files\Forguncy Version\Website\designerBin
如果安装活字格设计器时，安装目录为自定义路径，则此文件的路径为“自定义路径\Forguncy Version\Website\designerBin

使用方法

基本用法如下：

打开命令行程序，输入如下命令：

C:\Program Files\Forguncy 9\Website\designerBin>ForguncyConsole /?

可以使用命令 ForguncyConsole.exe Action=PublishToServer /help 查看更多参数的说明。

发布活字格工程文件

使用指定的发布配置将活字格工程文件发布到服务器。发布的源文件是一个活字格工程文件。

示例代码如下：

ForguncyConsole.exe Action=PublishToServer File=D:\Download\Teams\DocumentKuCun.fgcc PublishConfigName=PublishSetting1 ServerPassword=123456

参数说明：

参数名称	说明
File	必须，活字格工程文件的路径。如果指定的文件不存在，将显示错误。
PublishConfigName	可选，发布配置的名称。
ServerPassword	必须，活字格服务器的密码。发布配置不保存密码设置，必须在参数中指定服务器的密码。

发布活字格工程文件文件夹（推荐）

使用指定的发布配置将活字格协作开发项目发布到服务器。推荐使用这个方式在持续集成中进行发布操作。

在持续管理配置中创建代码源的时候，需要填写活字格协同工程的地址，以及用户名密码等认证信息。持续集成工具将会自动下载、更新协同工程的内容。活字格只负责把工程内容所在的文件夹里的活字格的内容发布到服务器上。可以利用持续集成工具的源代码变更感知的功能，在感知到协同工程有任何变更后，自动执行此命令行工具进行发布操作。

示例代码：

ForguncyConsole.exe Action=PublishToServer Folder=.\ PublishConfigName=PublishSetting1 ServerPassword=123456

参数说明：

参数名称	说明
Folder	必须，活字格工程文件夹，通常由持续集成工具TeamCity 或 Jenkins 等 CI 工具管理。如果指定的文件夹不存在，将显示错误。
PublishConfigName	可选，发布配置的名称。
ServerPassword	必须，活字格服务器的密码。发布配置不保存密码设置，必须在参数中指定服务器的密码。

参数名称

说明

Folder

必须，活字格工程文件夹，通常由持续集成工具TeamCity 或 Jenkins 等 CI 工具管理。

如果指定的文件夹不存在，将显示错误。

PublishConfigName

可选，发布配置的名称。

ServerPassword

必须，活字格服务器的密码。发布配置不保存密码设置，必须在参数中指定服务器的密码。

发布活字格协作开发项目

使用指定的发布配置将活字格协作开发项目发布到服务器。需要提供协同仓库的地址、认证用户名、密码等。

示例代码：

ForguncyConsole.exe Action=PublishToServer RepoUrl=http://xa-dd3-orrin22/Bonobo.Git.Server/OrrinTest.git RepoUserName=admin RepoPassword=admin PublishConfigName=PublishSetting1 ServerPassword=123456 ServerName=xa-dd3-orrin22 OverrideBuiltinDatabase=true

发布活字格协作开发项目到服务器，并且不使用指定的发布配置。

示例代码：

ForguncyConsole.exe Action=PublishToServer RepoUrl=http://xa-dd3-orrin22/Bonobo.Git.Server/OrrinTest.git RepoUserName=admin RepoPassword=admin ServerName=xa-dd3-orrin22 UserName=Administrator ServerPassword=123456 AppName=Test1

参数名称	说明
RepoUrl	必须，活字格协同工程的地址。
RepoBranchName	可选，活字格协同工程的分支名称，默认为 master。
RepoUserName	可选，用来认证活字格协同工程的用户名。如果当前计算机已被授权（之前打开的协作项目），或者存储库具有匿名访问权限（如 GitHub 的公共存储库），则不需要此参数。否则，必须指定用户名和密码来验证存储库。
RepoPassword	可选，用来认证活字格协同工程的密码。
PublishConfigName	可选，发布配置的名称。
ServerPassword	必须，活字格服务器的密码。发布配置不保存密码设置，必须在参数中指定服务器的密码。

其他可用参数

您可以在命令行中查看更多参数和值。支持将更多设置传递给发布流程。这些参数的默认值的行为与发布对话框的默认选项相同。

参数名称	说明	类型	默认值
ServerName	服务器主机名或 IP 地址。	string	null
UserName	用于向服务器进行身份验证的用户名。	string	administrator
SitePort	应用程序的端口。	string	null
AppName	应用程序的名称。	string	null
AppStartPage	应用程序的默认页面。	string	与应用程序设置相同
Https	对应用程序使用 SSL。	bool	false
PublishRolesToServer	将设计器的角色发布到服务器。	bool	true
PublishUsersToServer	将设计器的用户发布到服务器。	bool	false
PublishOrganizationsToServer	将设计器的组织发布到服务器。	bool	false
OverrideBuiltinDatabase	覆盖服务器端内置数据库。	bool	false
OverrideProcessDatabaseToServer	覆盖服务器端进程数据库。	bool	false
OverrideProcessFilesToServer	覆盖服务器端流程设计文件。	bool	false
OverridePageAuthorityToServer	覆盖服务器的权限，包括页面权限和单元格权限。	bool	false
OverrideServerScheduleTask	覆盖服务器端计划任务。	bool	false
OverrideServerGlobalProperty	覆盖全局属性设置。	bool	false
OverrideServerActiveReports	覆盖报表。	bool	false

返回值

如果发布过程中出现错误，将向控制台返回非零值（错误代码）。您可以在控制台输出中找到以下错误代码的详细原因。这里只列出简单的原因以及解决方法。

返回码	意义	如何解决
0	成功
1000	缺少动作参数	请指定操作参数
1001	操作值无效	请指定正确的操作值
1010	文件参数缺失	请指定文件参数
1011	指定的文件不存在	请指定一个已有的文件
1012	缺少文件夹参数	请指定文件夹参数
1013	指定的文件夹不存在	请指定已有的文件夹
1020	活字格文档中不存在 PublishConfig	请指定现有的 PublishConfig
1021	缺少密码参数	请指定密码参数
1030	RepoUrl 参数缺失	请指定RepoUrl参数
2000	打开 RepoUrl 参数指定的项目失败。如果直接用设计器打开它，效果是一样的。	请检查活字格协作项目是否有效。
2001	打开文件夹参数指定的项目失败。如果直接用设计器打开它，效果是一样的。	请检查活字格协作项目或CI配置是否有效。
2002	打开文件参数指定的项目失败。如果直接用设计器打开它，效果是一样的。	请检查活字格文件是否有效。
2010	该文档在生成时存在检查错误。例如活字格项目中有无效的公式引用，或者表格已被删除等。	请解决活字格设计器中的错误。
2011	生成时的其他意外错误	您可以尝试在设计器中发布文档，然后检查会发生什么情况。
2012	检查发布设置失败。比如主机名是不可连接的，或者用户名/密码不正确等。	请更新发布设置。
2013	发布时出现意外错误。比如网络突然断线，服务器关闭。	您可以尝试在设计器中发布文档，然后检查会发生什么情况。