跳到主要内容
版本：Next

数据tag

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

格式介绍​

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

excel格式​

在记录第一列填写tag。

tag

json格式​

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

lua格式​

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

xml格式​

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

yaml格式​

__tag__ : dev
id : 1
name : xxx

特殊的tag名​

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

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

记录过滤导出​

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

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

通过命令行参数 --includeTag 或 --excludeTag 来包含或者排除指定tag的数据，以下为使用示例。

##varidname
##typeintstring
##iddesc1注释
1item1永远导出
##2item2永远不导出
test4item4--excludeTag test 时不导出
TEST5item5--excludeTag test 时不导出
dev6item6--excludeTag dev 时不导出
7item7永远导出