aitable-workflow-cli 0.1.15 → 0.1.16-beta.1786022310508

package/templates/aitable-handoff/wiki/faq-support/18-/345/274/200/345/217/221/350/200/205/346/214/207/345/215/227/AI/350/241/250/346/240/274/345/257/271/350/261/241/346/250/241/345/236/213API/345/217/202/350/200/203/346/226/207/346/241/243/Field /346/250/241/345/235/227/MultiSelectField /345/244/232/351/200/211/345/255/227/346/256/265.md"

@@ -1,349 +0,0 @@
-# MultiSelectField 多选字段
-
-MultiSelectField 继承自基础 [`Field`](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)类，专门用于处理多选字段类型数据，用于从预设选项中选择多个值。
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定记录在该多选字段中选择的选项。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<SelectOption[] | null>
-
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-
-**返回值**
-
-*   [`Promise<SelectOption[] | null>`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=ELhg2x3IP0&sheetId=hERWDMS&viewId=qvGDAH2) - 选中的选项数组，包含id和name属性，如果未选择则返回null
-    
-
-**示例**
-
-```typescript
-// 获取记录的多选选项值
-const tagsField = sheet.getField<MultipleSelectField>('标签');
-if (tagsField) {
-  const selectedTags = await tagsField.getValueAsync('rec123456');
-  if (selectedTags.length > 0) {
-    console.log(`选中的标签: ${selectedTags.map(tag => tag.name).join(', ')}`);
-  } else {
-    console.log('未选择任何标签');
-  }
-}
-```
-```typescript
-// 获取记录的多选选项值
-const tagsField = sheet.getField('标签');
-if (Base.isFieldOfType(tagsField, 'multipleSelect')) {
-  const selectedTags = await tagsField.getValueAsync('rec123456');
-  if (selectedTags.length > 0) {
-    Output.log(`选中的标签: ${selectedTags.map(tag => tag.name).join(', ')}`);
-  } else {
-    Output.log('未选择任何标签');
-  }
-}
-```
-
-### setValueAsync
-
-设置指定记录在该多选字段中的选项。
-
-```typescript
-setValueAsync: (recordId: string, optionId: string | string[]) => Promise<boolean>
-
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-*   `optionId`: `string | string[]` - 选项ID 数组
-    
-
-**返回值**
-
-*   `Promise<boolean>`\- 操作是否成功
-    
-
-**示例**
-
-```typescript
-// 设置记录的多选选项值
-const tagsField = sheet.getField<MultipleSelectField>('标签');
-if (tagsField) {
-  // 获取所有选项
-  const options = tagsField.getOptions();
-  
-  // 找到需要的选项ID
-  const urgentTag = options.find(opt => opt.name === '紧急');
-  const importantTag = options.find(opt => opt.name === '重要');
-  
-  if (urgentTag && importantTag) {
-    // 设置多个标签
-    const success = await tagsField.setValueAsync('rec123456', [urgentTag.id, importantTag.id]);
-    if (success) {
-      console.log('已将记录标记为"紧急"和"重要"');
-    }
-  }
-  
-  // 也可以设置单个标签
-  const followupTag = options.find(opt => opt.name === '需跟进');
-  if (followupTag) {
-    await tagsField.setValueAsync('rec234567', followupTag.id);
-    console.log('已将记录标记为"需跟进"');
-  }
-}
-```
-```typescript
-// 设置记录的多选选项值
-const tagsField = sheet.getField<MultipleSelectField>('标签');
-if (Base.isFieldOfType(tagsField, 'multipleSelect')) {
-  // 获取所有选项
-  const options = tagsField.getOptions();
-  
-  // 找到需要的选项ID
-  const urgentTag = options.find(opt => opt.name === '紧急');
-  const importantTag = options.find(opt => opt.name === '重要');
-  
-  if (urgentTag && importantTag) {
-    // 设置多个标签
-    const success = await tagsField.setValueAsync('rec123456', [urgentTag.id, importantTag.id]);
-    if (success) {
-      Output.log('已将记录标记为"紧急"和"重要"');
-    }
-  }
-  
-  // 也可以设置单个标签
-  const followupTag = options.find(opt => opt.name === '需跟进');
-  if (followupTag) {
-    await tagsField.setValueAsync('rec234567', followupTag.id);
-    Output.log('已将记录标记为"需跟进"');
-  }
-}
-```
-
-### addOption
-
-添加一个新的选项到多选字段中。
-
-```typescript
-addOption: (name: string) => string
-
-```
-
-**参数**
-
-*   `name`: `string` - 选项名称
-    
-
-**返回值**
-
-*   `string` - 字段ID
-    
-
-**示例**
-
-```typescript
-// 添加一个新选项「待审核」
-const statusField = sheet.getField<MultiSelectField>('状态');
-if (statusField) {
-  statusField.addOption('待审核');
-}
-
-```
-```typescript
-// 添加一个新选项「待审核」
-const statusField = sheet.getField('状态');
-if (Base.isFieldOfType(statusField, 'multipleSelect')) {
-  statusField.addOption('待审核');
-}
-
-```
-
-### addOptions
-
-批量添加多个选项到多选字段中。
-
-```typescript
-addOptions: (optionList: { name: string }[]) => string
-```
-
-**参数**
-
-*   `optionList`: `{ name: string }[]` - 选项列表，每个选项包含名称
-    
-
-**返回值**
-
-*   `string` - 字段ID
-    
-
-**示例**
-
-```typescript
-// 批量添加多个选项
-const priorityField = sheet.getField<MultiSelectField>('优先级');
-if (priorityField) {
-  priorityField.addOptions([
-    { name: '低' },
-    { name: '中' },
-    { name: '高' },
-    { name: '紧急' }
-  ]);
-}
-
-```
-```typescript
-// 批量添加多个选项
-const priorityField = sheet.getField('优先级');
-if (Base.isFieldOfType(priorityField, 'multipleSelect')) {
-  priorityField.addOptions([
-    { name: '低' },
-    { name: '中' },
-    { name: '高' },
-    { name: '紧急' }
-  ]);
-}
-
-```
-
-### getOptions
-
-获取多选字段的所有选项。
-
-```typescript
-getOptions: () => ISelectFieldOption[]
-
-```
-
-**返回值**
-
-*   [`ISelectFieldOption[]`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=j4GPbzUY3c&sheetId=hERWDMS&viewId=qvGDAH2) - 选项列表，每个选项包含id、name和color属性
-    
-
-**示例**
-
-```typescript
-// 获取所有选项
-const statusField = sheet.getField<MultiSelectField>('状态');
-if (statusField) {
-  const options = statusField.getOptions();
-  console.log(`共有 ${options.length} 个选项:`);
-  options.forEach(option => {
-    console.log(`- ${option.name} (ID: ${option.id}, 颜色: ${option.color})`);
-  });
-}
-
-```
-```typescript
-// 获取所有选项
-const statusField = sheet.getField('状态');
-if (Base.isFieldOfType(statusField, 'multipleSelect')) {
-  const options = statusField.getOptions();
-  Output.log(`共有 ${options.length} 个选项:`);
-  options.forEach(option => {
-    Output.log(`- ${option.name} (ID: ${option.id}, 颜色: ${option.color})`);
-  });
-}
-
-```
-
-### deleteOptionAsync
-
-删除多选字段中的指定选项，由于删除选项会间接影响字段值，所以此方法为异步方法。
-
-```typescript
-deleteOptionAsync: (idOrName: string) => Promise<string>
-```
-
-**参数**
-
-*   `idOrName`: `string` - 选项ID或选项名称
-    
-
-**返回值**
-
-*   `Promise<string>`\- 字段ID
-    
-
-**示例**
-
-```typescript
-// 删除指定选项
-const statusField = sheet.getField<MultiSelectField>('状态');
-if (statusField) {
-  // 通过选项ID删除
-  await statusField.deleteOptionAsync('opt123456');
-  
-  // 或通过选项名称删除
-  await statusField.deleteOptionAsync('已取消');
-}
-
-```
-```typescript
-// 删除指定选项
-const statusField = sheet.getField<MultiSelectField>('状态');
-if (Base.isFieldOfType(statusField, 'multipleSelect')) {
-  // 通过选项ID删除
-  await statusField.deleteOptionAsync('opt123456');
-  
-  // 或通过选项名称删除
-  await statusField.deleteOptionAsync('已取消');
-}
-Base.isFieldOfType(statusField, 'multipleSelect')
-
-```
-
-### setOptionAsync
-
-修改多选字段中指定选项的配置。
-
-```typescript
-setOptionAsync: (nameOrId: string, config: IOptionConfig) => Promise<string>
-
-```
-
-**参数**
-
-*   `nameOrId`: `string` - 选项ID或选项名称
-    
-*   `config`: [`IOptionConfig`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=LOSeiToBo3&sheetId=hERWDMS&viewId=qvGDAH2) - 选项配置，目前支持修改name属性
-    
-
-**返回值**
-
-*   `Promise<string>`\- 字段ID
-    
-
-**示例**
-
-```typescript
-// 修改选项名称
-const statusField = sheet.getField<MultiSelectField>('状态');
-if (statusField) {
-  // 通过选项ID修改
-  await statusField.setOptionAsync('opt123456', { name: '已完成' });
-  
-  // 或通过选项名称修改
-  await statusField.setOptionAsync('进行中', { name: '处理中' });
-}
-
-```
-```typescript
-// 修改选项名称
-const statusField = sheet.getField('状态');
-if (Base.isFieldOfType(statusField, 'multipleSelect')) {
-  // 通过选项ID修改
-  await statusField.setOptionAsync('opt123456', { name: '已完成' });
-  
-  // 或通过选项名称修改
-  await statusField.setOptionAsync('进行中', { name: '处理中' });
-}
-
-```

package/templates/aitable-handoff/wiki/faq-support/18-/345/274/200/345/217/221/350/200/205/346/214/207/345/215/227/AI/350/241/250/346/240/274/345/257/271/350/261/241/346/250/241/345/236/213API/345/217/202/350/200/203/346/226/207/346/241/243/Field /346/250/241/345/235/227/NumberField /346/225/260/345/255/227/345/255/227/346/256/265.md"

@@ -1,175 +0,0 @@
-# NumberField 数字字段
-
-`NumberField`，继承自基础 [Field](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space) 类，专门用于处理数字字段数据。支持整数、小数，并提供多种数字格式化选项，如百分比、货币等。
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定记录在该文本字段的值。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<number | null>
-```
-
-**参数**
-
-*   `recordId` : `string` - 记录ID
-    
-
-**返回值**
-
-*   `Promise<string | null>`\- 数字值，如果记录不存在或值为空则返回null
-    
-
-**示例**
-
-```typescript
-// 获取数字字段值
-const priceField = sheet.getField<NumberField>('价格');
-if (priceField) {
-  const price = await priceField.getValueAsync('rec123456');
-  console.log(`价格: ${price !== null ? price : '无'}`);
-}
-```
-```typescript
-// 获取数字字段值
-const priceField = sheet.getField<NumberField>('价格');
-if (Base.isFieldOfType(priceField, 'number')) {
-  const price = await priceField.getValueAsync('rec123456');
-  Output.log(`价格: ${price !== null ? price : '无'}`);
-}
-```
-
-### setValueAsync
-
-设置指定记录在该数字字段的值。
-
-```typescript
-setValueAsync: (recordId: string, num: number) => Promise<boolean>
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-*   `num`: `string` - 要设置的数字值
-    
-
-**返回值**
-
-*   `Promise<boolean>`\- 设置是否成功
-    
-
-**示例**
-
-```typescript
-// 设置数字字段值
-const priceField = sheet.getField<NumberField>('价格');
-if (priceField) {
-  const success = await priceField.setValueAsync('rec123456', 199.99);
-  if (success) {
-    console.log('价格更新成功');
-  } else {
-    console.log('价格更新失败');
-  }
-}
-```
-```typescript
-// 设置数字字段值
-const priceField = sheet.getField<NumberField>('价格');
-if (Base.isFieldOfType(priceField, 'number')) {
-  const success = await priceField.setValueAsync('rec123456', 199.99);
-  if (success) {
-    Output.log('价格更新成功');
-  } else {
-    Output.log('价格更新失败');
-  }
-}
-```
-
-### getFormatter
-
-获取数字字段的格式。
-
-```typescript
-getFormatter(): NumericalFormatter
-
-```
-
-**返回值**
-
-*   [`NumericalFormatter`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=bmhb9tm5gl&sheetId=hERWDMS&viewId=qvGDAH2) - 数字格式类型
-    
-
-**示例**
-
-```typescript
-// 获取数字格式
-const priceField = sheet.getField<NumberField>('价格');
-if (priceField) {
-  const formatter = priceField.getFormatter();
-}
-
-```
-```typescript
-// 获取数字格式
-const priceField = sheet.getField('价格');
-if (Base.isFieldOfType(priceField, 'number')) {
-  const formatter = priceField.getFormatter();
-}
-
-```
-
-### setFormatter
-
-设置数字字段的格式
-
-```typescript
-setFormatter: (formatter: NumericalFormatter) => string
-```
-
-**参数**
-
-*   `formatter`: [`NumericalFormatter`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=bmhb9tm5gl&sheetId=hERWDMS&viewId=qvGDAH2)\- 数字格式
-    
-
-**返回值**
-
-*   `string` - 字段ID
-    
-
-**示例**
-
-```typescript
-// 设置数字格式为货币类型
-const priceField = sheet.getField<NumberField>('价格');
-if (priceField) {
-  priceField.setFormatter('CNY_FLOAT');
-  console.log('已将价格字段设置为人民币格式');
-}
-
-// 设置数字格式为百分比
-const rateField = sheet.getField<NumberField>('完成率');
-if (rateField) {
-  rateField.setFormatter('PERCENT_FLOAT');
-  console.log('已将完成率字段设置为百分比格式');
-}
-
-```
-```typescript
-// 设置数字格式为货币类型
-const priceField = sheet.getField('价格');
-if (Base.isFieldOfType(priceField, 'number')) {
-  priceField.setFormatter('CNY_FLOAT');
-  Output.log('已将价格字段设置为人民币格式');
-}
-
-// 设置数字格式为百分比
-const rateField = sheet.getField('完成率');
-if (Base.isFieldOfType(rateField, 'number')) {
-  rateField.setFormatter('PERCENT_FLOAT');
-  Output.log('已将完成率字段设置为百分比格式');
-}
-
-```

package/templates/aitable-handoff/wiki/faq-support/18-/345/274/200/345/217/221/350/200/205/346/214/207/345/215/227/AI/350/241/250/346/240/274/345/257/271/350/261/241/346/250/241/345/236/213API/345/217/202/350/200/203/346/226/207/346/241/243/Field /346/250/241/345/235/227/PrimaryField /344/270/273/351/224/256/346/226/207/346/241/243/345/255/227/346/256/265.md"

@@ -1,91 +0,0 @@
-# PrimaryField 主键文档字段
-
-`PrimaryField`，继承自基础 [Field](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space) 类，专门用于处理主键文档字段数据。
-
-:::
-PrimaryField必须是主键字段，数据表中仅主键字段可以设置为PrimaryField。
-:::
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定记录在该文本字段的值。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<string | null>
-```
-
-**参数**
-
-*   `recordId` : `string` - 记录ID
-    
-
-**返回值**
-
-*   `Promise<string | null>`\- 文本值，如果记录不存在或值为空则返回null
-    
-
-**示例**
-
-```typescript
-const primayDocField = sheet.getField<PrimaryDocField>('标题');
-if (primayDocField) {
-  const text = await primayDocField.getValueAsync('rec123456');
-}
-
-```
-```typescript
-const primayDocField = sheet.getField('标题');
-if (Base.isFieldOfType(primayDocField, 'primaryDoc')) {
-  const text = await primayDocField.getValueAsync('rec123456');
-}
-
-```
-
-### setValueAsync
-
-设置指定记录在该文本字段的值。
-
-```typescript
-setValueAsync: (recordId: string, text: string) => Promise<boolean>
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-*   `text`: `string` - 要设置的文本值
-    
-
-**返回值**
-
-*   `Promise<boolean>`\- 设置是否成功
-    
-
-**示例**
-
-```typescript
-const primayDocField = sheet.getField<PrimaryDocField>('标题');
-if (primayDocField) {
-  const success = await primayDocField.setValueAsync('rec123456', '这是一条新的内容');
-  if (success) {
-    console.log('更新成功');
-  } else {
-    console.log('更新失败');
-  }
-}
-
-```
-```typescript
-const primayDocField = sheet.getField('标题');
-if (Base.isFieldOfType(primayDocField, 'primaryDoc')) {
-  const success = await primayDocField.setValueAsync('rec123456', '这是一条新的内容');
-  if (success) {
-    Output.log('更新成功');
-  } else {
-    Output.log('更新失败');
-  }
-}
-
-```