应用表格列及单元格值结构

概述

应用表格有21种列，不同的列的列结构以及对应单元格的值都不相同(除个别，例如日期列/首次填写时间/最后填写时间列的单元格值时相同的)，下面是各种列的结构以及单元格值的 JSON结构

列属性

列结构为

type ColumnItem struct {
      Name        string      `json:"name"`    // 列名称
      Type        string      `json:"type"`    // 列类型
      TypeOptions interface{} `json:"props"`   // 列属性
      GUID        string      `json:"guid"`    // 列GUID
}

单行文本

Type: SingleLineText

Prop：无

多行文本

Type: LongText

Prop：

type LongTextOptions struct {
      EnableRichText bool `json:"enableRichText"`    //是否开启富文本
}

单选

Type: SingleChoice

Prop：

type ChoiceOptions struct {
      ChoiceOrder    []string               `json:"choiceOrder" mapstructure:"choiceOrder"`          //选项guid列表
      Choices        map[string]*ChoiceMeta `json:"choices" mapstructure:"choices"`                  //选项信息
      DisableColors  bool                   `json:"disableColors" mapstructure:"disableColors"`      //是否开启颜色标签
      AllowAutoAdd   bool                   `json:"allowAutoAdd" mapstructure:"allowAutoAdd"`        //允许填写时新增选项
      DefaultChoices []string               `json:"defaultChoices" mapstructure:"defaultChoices"`    //默认选项
}
type ChoiceMeta struct {
      ID         string             `json:"guid" mapstructure:"guid"`   //选项guid
      Style      *ChoiceStyle       `json:"style"`                       //选项样式
      Name       string             `json:"name"`                        //选项名称
      Hidden     bool               `json:"hidden"`                      //是否隐藏
      StatusType tablepb.StatusType `json:"statusType"`                  //状态类型
      Locked     bool               `json:"locked"`                      //是否锁定
}
type ChoiceStyle struct {
      Color      string `json:"color"`       //颜色
      Background string `json:"background"`  //背景
}

枚举：
color ：whiteColor | blackColor

其中：

whiteColor = cssVars.gray.gray0

blackColor = cssVars.transparency.transparency120

background ：

#F9D7D7 | #F9DDCD | #FAEDBF | #DDF1C7 | #D3EDE3 | #CBE8F6 | #D1E2FD | #E1D9F6 | #F7D9E9 | #E7E7E7
#F3AEAE | #F4BB9C | #F6DB80 | #BBE290 | #A8DAC8 | #98D2ED | #A2C5FB | #C3B3EC | #EEB4D4 | #CFCFCF
#E85E5E | #E97839 | #EDB800 | #77C621 | #51B691 | #31A5DB | #468CF8 | #8767DA | #DE69A9 | #A0A0A0
#A80000 | #C76000 | #BF9500 | #549717 | #1B928A | #1085BC | #0065CF | #6614BD | #A60D75 | #666666

多选

Type: MultipleChoice

Prop：同单选

多级下拉

Type: Cascade

Prop：

type MultiDropdownOptions struct {
      Levels        []string        `json:"levels" mapstructure:"levels"`              //层级列表
      Display       string          `json:"display" mapstructure:"display"`            //展示方式
      DisableColors bool            `json:"disableColors" mapstructure:"disableColors"`//是否禁用颜色
      DropdownList  []*DropdownList `json:"dropdownList" mapstructure:"dropdownList"`  //下拉选项树
}
type DropdownList struct {
      Guid     string          `json:"guid" mapstructure:"guid"`          //选项guid
      Name     string          `json:"name" mapstructure:"name"`          //选项名称
      Style    *ChoiceStyle    `json:"style" mapstructure:"style"`        //选项样式
      Children []*DropdownList `json:"children" mapstructure:"children"`  //子选项
}

数值

Type: Number

Prop：

type NumberOptions struct {
      Precision            int32 `json:"precision"`              //精度
      HasThousandSeparator *bool `json:"hasThousandSeparator"`   //是否开启千分位
}

百分比

Type: Percent

Prop：

type PercentOptions struct {
      Precision       int32 `json:"precision"`       //精度
      ShowProgressBar bool  `json:"showProgressBar"` //是否显示进度条
}

评分

Type: Rate

Prop：

type Rating struct {
      Count int32    `json:"count"` //评分总数
      Icon  string   `json:"icon"`  //评分图标
      Color []string `json:"color"` //评分颜色(前端未使用字段)
}

枚举：
icon ：'star' | 'flame' | 'heart' | 'honor' | 'stone'

复选框

Type: CheckBox

Prop：

type CheckBoxOptions struct {
      ShowLineThrough bool                  `json:"showLineThrough"`    //是否开启勾选后改记录显示中划线
      Shape           *CheckBoxShapeOptions `json:"shape"`              //复选框样式
}
type CheckBoxShapeOptions struct {
      Type  string `json:"type"`      //类型
      Color string `json:"color"`     //颜色
}

枚举：
type ：'check' | 'star' | 'close'

color ：无固定枚举，前端类型为 string；默认值来自 cssVars.colors?.text?.secondary || cssVars.text.secondary。

链接

Type: Link

Prop：无

附件

Type: Attachment

Prop：无

公式

Type: Formula

Prop：

type FormulaOptions struct {
      FormulaText     string  `json:"formula" mapstructure:"formula"`       //公式内容
      Format          *string `json:"format,omitempty" mapstructure:"format"`//展示格式
      Error           *string `json:"error,omitempty"`                       //错误信息
      ShowProgressBar bool    `json:"showProgressBar"`                      //是否显示进度条
}

枚举：
format生成方法 ：

数值格式：#,##0.00_

日期格式：DateFormats

百分比格式：0.00%

文本格式：@

其中 DateFormats 可选值为：

yyyy/M/d HH:mm:ss
yyyy/M/d
yyyy/MM/dd
yyyy-M-d
y年M月d日 EEEE
M-d
M月d日
yyyy年M月
M月
EEEE
EEE
M-d-yyyy
M/d/yyyy
H:mm
HH:mm
H:mm:ss
HH:mm:ss
H:mm bbb
H:mm:ss bbb
MMM d
MMM d, yyyy

自动编号

Type: AutoNumber

Prop：

type AutoNumberOptions struct {
      AutoType AutoType `json:"type" mapstructure:"type"`   //自动编号类型：increment/custom
      Rules    []*Rules `json:"rules" mapstructure:"rules"` //自定义编号规则
}
type Rules struct {
      RuleType RuleType `json:"type" mapstructure:"type"`     //规则类型：auto/date/text
      Digit    int64    `json:"digit" mapstructure:"digit"`   //自增位数
      Format   string   `json:"format" mapstructure:"format"` //日期格式
      Text     string   `json:"text" mapstructure:"text"`     //固定文本
}

关联引用

Type: ReferenceRecord

Prop：

type ReferenceRecordOptions struct {
      ForeignTableGUID       string  `json:"tableGuid" mapstructure:"tableGuid"`                              //引用的表guid
      ForeignBaseGUID        string  `json:"baseGuid,omitempty" mapstructure:"baseGuid"`                      //引用的文件guid，空表示同文件
      ForeignTableColumnGUID string  `json:"foreignTableColumnGuid,omitempty" mapstructure:"foreignTableColumnGuid"` //引用表的双向关联列guid
      ForeignViewGUID        string  `json:"refViewGuid,omitempty" mapstructure:"refViewGuid"`                //引用表视图guid
      ReferenceView          bool    `json:"isRefToView" mapstructure:"isRefToView"`                          //是否关联引用表视图
      IsMultiple             bool    `json:"isMultiple" mapstructure:"isMultiple"`                            //是否允许引用多行
      Error                  *string `json:"error,omitempty" mapstructure:"error"`                            //错误信息
}

关联公式

Type: RefRecordRollUp

Prop：

type RefRecordRollUpOptions struct {
      ForeignTableColumnGUID string  `json:"foreignRefFieldGuid" mapstructure:"foreignRefFieldGuid"` //引用表中参与公式计算的列guid
      RelationColumnGUID     string  `json:"refFieldGuid" mapstructure:"refFieldGuid"`               //本表关联引用列guid
      FormulaText            string  `json:"formula" mapstructure:"formula"`                         //公式内容
      Format                 *string `json:"format,omitempty" mapstructure:"format"`                  //展示格式
      Error                  *string `json:"error,omitempty" mapstructure:"error"`                    //错误信息
      ShowProgressBar        bool    `json:"showProgressBar"`                                        //是否显示进度条
}

联系人

Type: Collaborator

Prop：

type CollaboratorOptions struct {
      IsMultiple   bool `json:"isMultiple"`   //是否允许多选
      IsNotify     bool `json:"isNotify"`     //是否通知联系人
      AssignedToMe bool `json:"assignedToMe"` //是否分配给我(已废弃字段)
}

首次填写人

Type: FirstModifiedBy

Prop：无

最后修改人

Type: LastModifiedBy

Prop：无

日期时间

Type: Date

Prop：

type DateOptions struct {
      DateFormat string `json:"dateFormat,omitempty"` //日期格式
      TimeFormat string `json:"timeFormat,omitempty"` //时间格式
      AutoFill   bool   `json:"isAutoFill"`           //是否自动填充
}

首次填写时间

Type: FirstModifiedAt

Prop：

type ModifiedOptions struct {
      DateFormat string   `json:"dateFormat" mapstructure:"dateFormat"`      //日期格式
      TimeFormat string   `json:"timeFormat,omitempty" mapstructure:"timeFormat"` //时间格式
      RefGuids   []string `json:"fieldGuids" mapstructure:"fieldGuids"`      //跟踪字段guid列表
      Error      string   `json:"error,omitempty" mapstructure:"error"`      //错误信息
}

最后修改时间

Type: LastModifiedAt

Prop：同首次填写时间

单元格值

单行文本

string

多行文本

兼容普通文本字符串，也支持富文本结构：

string
type RichText struct {
      Text  string `json:"text"`  //纯文本
      Slate string `json:"slate"` //前端展示数据
}

单选

string //选项guid

多选

[]string //选项guid列表

多级下拉

[]string //各层级选项guid列表

数值

float64

百分比

float64

评分

int64

复选框

bool

链接

type LinkValue struct {
      Text string `json:"text"` //展示文本
      URL  string `json:"url"`  //链接地址
      Logo string `json:"logo"` //图标
}

附件

type Attachments []*AttachmentValue

type AttachmentValue struct {
      GUID     string  `json:"guid"`     //附件guid
      URL      string  `json:"url"`      //附件地址
      Name     string  `json:"name"`     //附件名称
      MimeType string  `json:"mimeType"` //MIME类型
      Size     float64 `json:"size"`     //文件大小
      Width    float64 `json:"width"`    //图片宽度
      Height   float64 `json:"height"`   //图片高度
      FileType string  `json:"fileType"` //文件类型，云文件有该字段
}

公式

公式值按计算结果保存，可能是布尔、数值、字符串、日期、数组或错误。

type Value struct {
      Type   ValueType   //Boolean/Number/String/Date/Empty/Unknown/Error/Array
      holder interface{} //实际值：bool/float64/string/[]interface{}等
}

JSON 序列化时通常表现为具体结果值：

bool | float64 | string | []interface{}

自动编号

type AutonumberValue struct {
      Num  int64  `json:"num,omitempty"`  //自增序号
      Text string `json:"text,omitempty"` //展示文本
}

关联引用

type ReferenceRecordValue []*ReferenceRecord

type ReferenceRecord struct {
      ReferenceRecordID    string `json:"refRecordGuid" mapstructure:"refRecordGuid"` //被引用记录guid
      ReferenceDisplayName string `json:"refDisplayName" mapstructure:"refDisplayName"` //被引用记录展示名
}

关联公式

同公式

联系人

[]*User

type User struct {
      ID     int64  `json:"id"`     //用户id
      Name   string `json:"name"`   //用户名称
      Avatar string `json:"avatar"` //头像
      Email  string `json:"email"`  //邮箱
}

首次填写人

type User struct {
      ID     int64  `json:"id"`     //用户id
      Name   string `json:"name"`   //用户名称
      Avatar string `json:"avatar"` //头像
      Email  string `json:"email"`  //邮箱
}

最后修改人

同首次填写人

日期时间

float64 //日期时间数值

首次填写时间

同公式结果，通常为日期类型的 float64

最后修改时间

同首次填写时间

概述#

列属性#

单行文本#

多行文本#

单选#

多选#

多级下拉#

数值#

百分比#

评分#

复选框#

链接#

附件#

公式#

自动编号#

关联引用#

关联公式#

联系人#

首次填写人#

最后修改人#

日期时间#

首次填写时间#

最后修改时间#

单元格值#

单行文本#

多行文本#

单选#

多选#

多级下拉#

数值#

百分比#

评分#

复选框#

链接#

附件#

公式#

自动编号#

关联引用#

关联公式#

联系人#

首次填写人#

最后修改人#

日期时间#

首次填写时间#

最后修改时间#

概述

列属性

单行文本

多行文本

单选

多选

多级下拉

数值

百分比

评分

复选框

链接

附件

公式

自动编号

关联引用

关联公式

联系人

首次填写人

最后修改人

日期时间

首次填写时间

最后修改时间

单元格值

单行文本

多行文本

单选

多选

多级下拉

数值

百分比

评分

复选框

链接

附件

公式

自动编号

关联引用

关联公式

联系人

首次填写人

最后修改人

日期时间

首次填写时间

最后修改时间