设置关系组集合

FieldDescriptor.AutoLinkGroups(属性)

说明

可读写

设置或读取 关联字段的关系组集合，如果有多个关系组，则这些关系组是或的关系

返回值

AutoLinkGroups

浏览器环境示例

// 设置数据表的关联字段的匹配条件
// 匹配到数据表2：数据表2的状态字段 = 数据表的文本字段，如下设置：
async function example() {
  await instance.ready();
  const Application = instance.Application;
  // 数据表
  const sheet = Application.Sheets(1)
  // 数据表的字段
  const fieldId = await sheet.FieldId("文本")
  // 数据表的关联字段
  const linkField = await sheet.FieldDescriptors("@关联")
  const prop = linkField.Link
  const linkGroups = await Application.AutoLinkGroups()
  const group = linkGroups.Add()
  const conditions = group.Conditions
  // 关联的数据表2
  const linkSheet = await Application.Sheets(2)
  // 关联数据表2的字段
  const linkSheet_fieldId = await linkSheet.FieldId("状态")
  // 生成匹配条件
  conditions.Add(linkSheet_fieldId, [fieldId], "Field", "Equals")
  // 设置关联字段的匹配条件
  prop.AutoLinkGroups = linkGroups
  // 设置自动关联
  prop.IsAutoLink = true
  linkField.Apply()
}

脚本编辑器 示例

function main(){
  const sheet = Application.Sheets(1)
  const fieldId = sheet.FieldId("状态")
  // 获取关联字段
  const linkField = sheet.FieldDescriptors("@关联")
  const prop = linkField.Link
  const linkGroups = Application.AutoLinkGroups()
  const conditions = linkGroups.Conditions
  // 关联的数据表2
  const linkSheet = Application.Sheets(2)
  // 关联数据表2的字段
  const linkSheet_fieldId = linkSheet.FieldId("状态")
  // 生成匹配条件
  conditions.Add(linkSheet_fieldId, [fieldId], "Field", "Equals")
  // 设置关联字段的匹配条件
  prop.AutoLinkGroups = linkGroups
  // 设置自动关联
  prop.IsAutoLink = true
  linkField.Apply()
}
main()