tag 介绍

关于Tag

luban支持记录级别的tag标记，每个数据可以有0到多个tag。 tag可用标识记录为注释，或者过滤导出，或者指示检验器不检查此记录。

tag格式介绍

不同文件格式下，记录tag的填写方式如下，也可以参考 luban_examples/DataTables/Data/tag_datas目录下的示例。

• excel格式。 在记录第一列填写tag。

##var	id	name
##type	int	string
	1	xxx
dev	2	xxx
debug	3	yyy
unchecked	4	zzz
dev,main	5	aaa
dev,unchecked	6	bbb

• 其它格式，在字段 __tag__中填写tag。

:::: tabs cache-lifetime="5" :options="{ useUrlFragment: false }" ::: tab JSON

{
  "__tag__": "dev",
  "id":1,
  "name":"xxx"
}

::: ::: tab lua格式

return {
  __tag__ = "dev",
  id = 1,
  name = "xxx",
}

::: ::: tab xml格式

<data>
  <__tag__>dev</__tag__>
  <id>1</id>
  <name>xxx</name>
</data>

::: ::: tab yaml格式

__tag__ : dev
id : 1
name : xxx

:::

::::

特殊的tag名

有一些特殊的tag名被用于特殊意义。

• ##。 表示此记录被注释，永远不会导出
• unchecked。 表示校验器不检查此记录

记录过滤导出

有几种场合会用到过滤导出

• 有些记录仅用于内部测试，不希望对外正式发布时导出
• 有些记录希望测试和发布有不同版本
• 一些简单多版本管理，比如某个记录只在某个版本或者分支才导出

通过luban.client的命令行选项 -—output:exclude_tags tag1,tag2,... ，包含参数中指定的任意一个tag的记录都不会导出，以下为使用示例。

##var	id	name
##type	int	string
##	id	desc1	注释
	1	item1	永远导出
##	2	item2	永远不导出
test	4	item4	-—output:exclude_tags test 时不导出
TEST	5	item5	-—output:exclude_tags test 时不导出
dev	6	item6	-—output:exclude_tags dev 时不导出
	7	item7	永远导出