ticket¶
简介¶
票证管理。
vb ticket SUBCOMMAND...
示例¶
查看票证的所有字段：
$ vb ticket ls fields
comment
foundin
icomment
login
mimetype
...
说明¶
ticket 票证是一种跟踪与项目相关的问题、任务、错误或其他可操作项目的方法。该命令允许您管理这些票证，包括创建、查看和更新。可用于维护工作项目列表并确保跟踪和处理重要任务。
在使用 VisionByte 版本控制系统进行团队协作时，开发人员可以创建这些 ticket 来记录和追踪软件开发过程中的问题、功能请求或其他任务。
每个 ticket 包含有关问题的详细信息，例如标题、描述、指派人、状态（如打开、关闭）、优先级等。
子命令¶
show¶
vb ticket show {REPORTTITLE|REPORTNR} [TICKETFILTER] [OPTIONS]
显示票证信息，由 GUI 中使用的报告格式标题标识。数据以文件形式写入标准输入，默认使用 TAB 作为分隔符，可以使用 -l|--limit 选项更改分隔符。
该命令允许设置多行文本或带有特殊字符的文本。
REPORTTITLE|REPORTNR 参数指定票证报告的标题或票证编号，这将决定查看指定票证详细信息。特殊报告编号 0 列出票证表中定义的所有列。
TICKETFILTER 参数是票务过滤器，使用过滤器来缩小搜索结果。
备注
过滤器可以使用 status!='open' ，仅显示打开状态的票证。
--quote 选项通过引用特殊字符对票证进行编码,否则将使用 GUI 中显示报告原始页面上的简化编码。这在 JSON 模式下无效。
特殊字符：
空格 : \s
制表符 : \t
换行符 : \n
cr : \r
换页符 : \f
vtab : \v
nul : \0
\ : \\
选项¶
|
更改分隔符。 |
|
引用特殊字符对票证进行编码。 |
|
指定仓库。 |
list|ls¶
vb ticket list|ls fields
列出仓库中票证的所有字段。
vb ticket list|ls reports
列出仓库中定义的所有工单报告。
set|change¶
vb ticketset|change TICKETUUID (FIELD VALUE)+ [-q|--quote]
修改仓库现有票证信息，可以使用新值更新票据字段。set 用于将特定字段设置为新值，而 change 用于不同或额外的更新。
为指定票证的指定字段设置值：
TICKETUUID 为要修改的票证的唯一标识符，这通常是一个数字或 UUID。
(FIELD VALUE)+ 指定要更新的字段及其新值。可以提供多个字段值对。
FIELD：要更新的字段的名称（例如: type, status, subsystem, priority, severity, foundin, resolution, title, comment ),也可以在自定义安装中添加或替换其他字段名称。
VALUE：指定字段的新值。
-q|--quote：通过引用来处理值中的特殊字符或空格。
add¶
vb ticket add FIELD VALUE [FIELD VALUE..] [-q|--quote]
类似于 set|change ,但是使用给定的值创建一个新票证。
history¶
vb ticket history TICKETUUID
显示票证的完整更改历史记录。
备注
set|change 中的值不会根据 “Ticket Common Script” 中给出的定义进行验证。