编辑“ZenTaoPMS/命令行入口”

{{ZenTaoPMS top}}

[[禅道]]项目管理软件1.0rc1版本之后，命令行入口做了一些改变，因为之前一直没有时间整理这方面的文档，很多使用者在问，现在统一跟大家解释一下。

==何谓命令行入口==

*先来介绍一下禅道项目管理软件的入口。

*禅道项目管理软件其实现在有很多个入口，大家平时访问的是[[www]]/index.[[php]]，这是最重要，也是大家平时都在使用的入口。还有就是www/install.php, www/upgrade.php，顾名思义，为安装的入口和升级的入口。这三个入口，index.php是有权限控制的，而install.php和upgrade.php则没有权限限制，只有在特定的情况下面才会起作用。正常安装或者升级之后，再访问install.php或者upgrade.php是无效的。

*禅道的命令行入口位于bin/ztcli。其实它也是一段php代码。它主要是给禅道的系统[[管理员]]使用的。通过这个入口，可以非常方便的访问到禅道系统的每一个页面，从而为各种便利的操作提供了可能。

==命令行入口的基本用法==

*命令行入口有三个文件，分别是ztcli, ztcli.sh和ztcli.bat。其中ztcli是主体的php[[脚本]]。另外两个则是为了使用方便，做的[[封装]]。先来看主体脚本的执行。

*在bin目录下面执行下面的命令(一定要在bin目录下面。)

*语法格式：php ztcli <nowiki>http://xxxx/zentaopms/xxxxx</nowiki>(其中的php，如果找不到，则根据需要换成php可执行文件所在的绝对路径.)

*举例来讲，我的禅道的访问路径是 <nowiki>http://pms.zentao.cn</nowiki>，我想触发燃烧图的更新程序，命令如下：

<pre>php ztcli http://pms.zentao.cn/project-computeburn.html</pre>

*如果你配置的禅道访问方式是通过GET方式，那么命令则变成：

<pre>php ztcli "http://pms.zentao.cn/?m=project&f=computeburn"</pre>

这时后面的[[url地址]]需要用引号引起来。

也就是说你在[[浏览器]]里面看到的是什么，通过ztcli都可以访问。

==封装==

*如果你php可执行文件不在PATH路径中，那么你可以修改ztcli.sh(linux)或者ztcli.bat(windows)，将其中的路径补全。

*比如ztcli.bat中，我可以这样写 d:\zentao\user\local\php\php.exe ztcl  %*

*封装好之后，你就可以直接运行ztclibat [[url]]地址就可以了。

==高级用法==

*在你访问禅道的页面时候，可以将访问的资源变化一下，比如<nowiki>http://pms.zentao.cn/project-task-8.html</nowiki>，返回的网页格式，把后面的.html改成.[[json]]，返回的是什么？对了，返回的是json格式的数据。如果是GET 方式，那么只需要将t参数改成json，<nowiki>http://pms.zentao.cn/?m=project&f=task&t=json.</nowiki>

*通过这个超级的命令行入口，其实可以做很多事情了。具体如何使用，看大家灵活运用了。

==参考来源==
*http://www.zentao.net/help-book-zentaopmshelp.html

[[category:ZenTaoPMS|Z]]

{{ZenTaoPMS}}