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/FilterUpField /346/237/245/346/211/276/345/274/225/347/224/250/345/255/227/346/256/265.md"

@@ -1,73 +0,0 @@
-# FilterUpField 查找引用字段
-
-FilterUpField 继承自基础 [Field](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)类，使用该字段，无需输入公式以及和其他表进行关联，即可根据指定条件快速查找并引用数据，轻松满足筛选和统计数据的需求。
-
-:::
-查找引用字段通过字段配置**自动计算**引用结果，不能手动写入单元格值。
-:::
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定记录在该字段中的值。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<FormulaValue | null>
-
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-
-**返回值**
-
-*   [`Promise<FormulaValue | null>`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_K1CUZhnWk4) -  可能是单个值或数组，如果没有关联数据则返回null
-    
-
-**示例**
-
-```typescript
-// 获取记录的查找引用汇总结果
-const filterUpField = sheet.getField<FilterUpField>('本月销售额');
-if (filterUpField) {
-  const monthlySales = await filterUpField.getValueAsync('rec_789');
-  if (monthlySales !== null) {
-    console.log(`本月销售额: ${monthlySales}`);
-    
-    // 如果汇总结果是数组（如多个汇总函数的结果）
-    if (Array.isArray(monthlySales)) {
-      console.log(`汇总结果包含${monthlySales.length}个值`);
-      monthlySales.forEach((value, index) => {
-        console.log(`汇总值${index + 1}: ${value}`);
-      });
-    }
-  } else {
-    console.log('筛选汇总计算失败或无匹配数据');
-  }
-}
-
-```
-```typescript
-// 获取记录的查找引用汇总结果
-const filterUpField = sheet.getField('本月销售额');
-if (Base.isFieldOfType(filterUpField, 'filterUp')) {
-  const monthlySales = await filterUpField.getValueAsync('rec_789');
-  if (monthlySales !== null) {
-    Output.log(`本月销售额: ${monthlySales}`);
-    
-    // 如果汇总结果是数组（如多个汇总函数的结果）
-    if (Array.isArray(monthlySales)) {
-      Output.log(`汇总结果包含${monthlySales.length}个值`);
-      monthlySales.forEach((value, index) => {
-        Output.log(`汇总值${index + 1}: ${value}`);
-      });
-    }
-  } else {
-    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/FormulaField /345/205/254/345/274/217/345/255/227/346/256/265.md"

@@ -1,109 +0,0 @@
-# FormulaField 公式字段
-
-FormulaField 继承自基础 [Field](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)类，专门用于处理公式计算类型数据。
-
-:::
-公式字段通过预定义的公式表达式**自动计算**并显示结果，不能手动写入单元格值。
-:::
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定记录在该公式字段中的计算结果值。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<FormulaValue | null>
-
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-
-**返回值**
-
-*   [`Promise<FormulaValue | null>`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_K1CUZhnWk4) - 公式计算结果，可能是单个值或数组，如果计算失败或记录不存在则返回null
-    
-
-**示例**
-
-```typescript
-// 获取记录的公式计算结果
-const formulaField = sheet.getField<FormulaField>('总金额');
-if (formulaField) {
-  const result = await formulaField.getValueAsync('rec_order_123');
-  if (result !== null) {
-    console.log(`订单总金额: ${result}`);
-    
-    // 如果公式返回数组结果
-    if (Array.isArray(result)) {
-      console.log(`计算结果包含${result.length}个值`);
-      result.forEach((value, index) => {
-        console.log(`结果${index + 1}: ${value}`);
-      });
-    }
-  } else {
-    console.log('公式计算失败或记录不存在');
-  }
-}
-```
-```typescript
-// 获取记录的公式计算结果
-const formulaField = sheet.getField('总金额');
-if (Base.isFieldOfType(formulaField, 'formula')) {
-  const result = await formulaField.getValueAsync('rec_order_123');
-  if (result !== null) {
-    Output.log(`订单总金额: ${result}`);
-    
-    // 如果公式返回数组结果
-    if (Array.isArray(result)) {
-      Output.log(`计算结果包含${result.length}个值`);
-      result.forEach((value, index) => {
-        Output.log(`结果${index + 1}: ${value}`);
-      });
-    }
-  } else {
-    Output.log('公式计算失败或记录不存在');
-  }
-}
-```
-
-### setFormula
-
-设置公式表达式，详情参考[公式字段基础介绍](https://wolai.dingtalk.com/k1gwYpHxHkj2QVBWSoKrTX)
-
-```typescript
-setFormula: (formula: string) => string;
-
-```
-
-**参数**
-
-*   `formula`: `string` - 公式表达式
-    
-
-**返回值**
-
-*   `string` - 字段 ID
-    
-
-**示例**
-
-```typescript
-// 获取记录的公式计算结果
-const formulaField = sheet.getField<FormulaField>('总金额');
-if (formulaField) {
-  formulaField.setFormula("[单价]*[数量]");
-  formulaField.setFormula("[单价]*20");
-}
-```
-```typescript
-// 获取记录的公式计算结果
-const formulaField = sheet.getField('总金额');
-if (Base.isFieldOfType(formulaField, 'formula')) {
-  formulaField.setFormula("[单价]*[数量]");
-  formulaField.setFormula("[单价]*20");
-}
-```

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/GeoLocationField /345/234/260/347/220/206/344/275/215/347/275/256/345/255/227/346/256/265.md"

@@ -1,33 +0,0 @@
-# GeoLocationField 地理位置字段
-
-GeoLocationField 继承自基础 [Field](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)类，获取地理位置字段的数据。
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定记录在该字段中的值。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<GeoLocationValue | null>
-
-export type GeoLocationValue = {
-  /** address */
-  address: string;
-  /** 简短地址 */
-  name: string;
-  /** 完整地址 */
-  fullAddress: string;
-  /** 经纬度 */
-  location: [number, number];
-};
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-
-**返回值**
-
-*   [`Promise<GeoLocationValue | null>`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_ICnmHpkyc2) -  查找到的值，如果没有关联数据则返回null。

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/GroupField /347/276/244/347/273/204/345/255/227/346/256/265.md"

@@ -1,111 +0,0 @@
-# GroupField 群组字段
-
-`GroupField` 继承自基础 [`Field`](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)类，专门用于处理群组类型数据。
-
-在读写群组字段前，请先了解钉钉群会话openConversationId概念：
-
-:::
-**openConversationId**
-
-openConversationId用于唯一识别**群聊会话**，通过创建群接口返回值获取。
-
-[https://open.dingtalk.com/document/development/im-session-overview: https://open.dingtalk.com/document/development/im-session-overview](https://open.dingtalk.com/document/development/im-session-overview)
-:::
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定记录在该群组字段中选择的群会话。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<GroupCellValue[] | null>
-
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-
-**返回值**
-
-*   [`Promise<GroupCellValue[] | null>`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=ElqZJVW4rg&sheetId=hERWDMS&viewId=qvGDAH2)\- 选中的群会话数组，返回群聊名称和openConversationId
-    
-
-**示例**
-
-```typescript
-// 获取记录的群组值
-const groupField = sheet.getField<GroupField>('群组');
-if (groupField) {
-  const groups = await groupField.getValueAsync('rec123456');
-  console.log('查询到群会话：', groups.map((group) => (`群名：${group.name}|群ID: ${group.openConversationId}`)).join('\n'));
-}
-```
-```typescript
-// 获取记录的群组值
-const groupField = sheet.getField('群组');
-if (Base.isFieldOfType(groupField, 'group')) {
-  const users = await groupField.getValueAsync('rec123456');
-  Output.log('查询到群会话：', groups.map((group) => (`群名：${group.name}|群ID: ${group.openConversationId}`)).join('\n'));
-}
-```
-
-### setValueAsync
-
-设置指定记录在该群组字段中的群会话值。
-
-```typescript
-setValueAsync: (recordId: string, value: GroupCellValue[]) => Promise<boolean>
-
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-*   `value`: [`GroupCellValue[]`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=ElqZJVW4rg&sheetId=hERWDMS&viewId=qvGDAH2) - 群会话值，支持传入openConversationId
-    
-
-**返回值**
-
-*   `Promise<boolean>`\- 操作是否成功
-    
-
-**示例**
-
-```typescript
-// 设置记录的选项值
-const groupField = sheet.getField<GroupField>('群组');
-if (groupField) {
-  const success = await groupField.setValueAsync('rec123456', [{
-    openConversationId: 'cidxxxxx123',
-  }, {
-    openConversationId: 'cidxxxxx456',
-  }]);
-  if (success) {
-    console.log('向记录中更新了两个群会话');
-  } else {
-    console.log('记录更新失败');
-  }
-}
-
-```
-```typescript
-// 设置记录的选项值
-const groupField = sheet.getField('群组');
-if (Base.isFieldOfType(groupField, 'group')) {
-  const success = await groupField.setValueAsync('rec123456', [{
-    openConversationId: 'cidxxxxx123',
-  }, {
-    openConversationId: 'cidxxxxx456',
-  }]);
-  if (success) {
-    Output.log('向记录中更新了两个群会话');
-  } else {
-    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/LastModifiedTimeField /346/234/200/345/220/216/346/233/264/346/226/260/346/227/266/351/227/264/345/255/227/346/256/265.md"

@@ -1,134 +0,0 @@
-# LastModifiedTimeField 最后更新时间字段
-
-`LastModifiedTimeField`，继承自基础 [Field](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space) 类，专门用于处理最后修改时间字段数据。系统自动记录数据行的最后修改时间，以毫秒级Unix时间戳形式存储。
-
-:::
-最后更新时间字段是系统自动生成的行记录最后更新时间，是一个只读字段，不能手动设置值。
-:::
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定行记录该最后修改时间字段的值。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<DateCellValue | null>
-
-```
-
-**参数**
-
-*   `recordId` : `string` - 记录ID
-    
-
-**返回值**
-
-*   [`Promise<DateCellValue | null>`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_Xnx2DrcnwE) - 最后修改时间的时间戳（毫秒），当字段值为空时返回null
-    
-
-**示例**
-
-```typescript
-// 获取最后修改时间字段值
-const lastModifiedTimeField = sheet.getField<LastModifiedTimeField>('最后修改时间');
-if (lastModifiedTimeField) {
-  const timestamp = await lastModifiedTimeField.getValueAsync('rec123456');
-  if (timestamp !== null) {
-    const date = new Date(timestamp);
-    console.log(`最后修改时间: ${date.toLocaleString()}`);
-  } else {
-    console.log('未设置最后修改时间');
-  }
-}
-
-```
-```typescript
-// 获取最后修改时间字段值
-const lastModifiedTimeField = sheet.getField('最后修改时间');
-if (Base.isFieldOfType(lastModifiedTimeField, 'lastModifiedTime')) {
-  const timestamp = await lastModifiedTimeField.getValueAsync('rec123456');
-  if (timestamp !== null) {
-    const date = new Date(timestamp);
-    Output.log(`最后修改时间: ${date.toLocaleString()}`);
-  } else {
-    Output.log('未设置最后修改时间');
-  }
-}
-
-```
-
-### getDateFormat
-
-获取最后修改时间字段的格式。
-
-```typescript
-getDateFormat: () => DateFormatter
-
-```
-
-**返回值**
-
-*   [`DateFormatter`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=sgmPZ03ioN&sheetId=hERWDMS&viewId=qvGDAH2) - 日期格式
-    
-
-**示例**
-
-```typescript
-// 获取最后修改时间字段格式
-const lastModifiedTimeField = sheet.getField<LastModifiedTimeField>('最后修改时间');
-if (lastModifiedTimeField) {
-  const formatter = lastModifiedTimeField.getDateFormat();
-  console.log(`最后修改时间格式: ${formatter}`);
-}
-
-```
-```typescript
-// 获取最后修改时间字段格式
-const lastModifiedTimeField = sheet.getField('最后修改时间');
-if (Base.isFieldOfType(lastModifiedTimeField, 'lastModifiedTime')) {
-  const formatter = lastModifiedTimeField.getDateFormat();
-  Output.log(`最后修改时间格式: ${formatter}`);
-}
-
-```
-
-### setDateFormat
-
-设置最后修改时间字段的格式化器。
-
-```typescript
-setDateFormat: (format: DateFormatter) => string
-
-```
-
-**参数**
-
-*   `format`: [`DateFormatter`](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=sgmPZ03ioN&sheetId=hERWDMS&viewId=qvGDAH2) - 日期格式
-    
-
-**返回值**
-
-*   `string` - 字段ID
-    
-
-**示例**
-
-```typescript
-// 设置最后修改时间字段格式
-const lastModifiedTimeField = sheet.getField<LastModifiedTimeField>('最后修改时间');
-if (lastModifiedTimeField) {
-  lastModifiedTimeField.setDateFormat('YYYY-MM-DD HH:mm:ss');
-  console.log('最后修改时间格式已更新');
-}
-
-```
-```typescript
-// 设置最后修改时间字段格式
-const lastModifiedTimeField = sheet.getField('最后修改时间');
-if (Base.isFieldOfType(lastModifiedTimeField, 'lastModifiedTime')) {
-  lastModifiedTimeField.setDateFormat('YYYY-MM-DD HH:mm:ss');
-  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/LookupField /345/205/263/350/201/224/345/274/225/347/224/250/345/255/227/346/256/265.md"

@@ -1,71 +0,0 @@
-# LookupField 关联引用字段
-
-LookupField 继承自基础 [Field](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)类，可以快捷地提供跨表的数据引用，并可以对数据按照你的需要进行后续的计算。
-
-:::
-关联引用字段通过字段配置**自动计算**引用结果，不能手动写入单元格值。
-:::
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定记录在该字段中的值。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<FormulaValue | null>
-
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-
-**返回值**
-
-*   [`Promise<FormulaValue | null>`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_K1CUZhnWk4) -  查找到的关联字段值，可能是单个值或数组，如果没有关联数据则返回null
-    
-
-**示例**
-
-```typescript
-// 获取记录的查找字段值
-const lookupField = sheet.getField<LookupField>('客户名称');
-if (lookupField) {
-  const customerName = await lookupField.getValueAsync('rec_order_456');
-  if (customerName !== null) {
-    console.log(`关联的客户名称: ${customerName}`);
-    
-    // 如果查找字段返回多个值（多对多关联）
-    if (Array.isArray(customerName)) {
-      console.log(`找到${customerName.length}个关联客户`);
-      customerName.forEach((name, index) => {
-        console.log(`客户${index + 1}: ${name}`);
-      });
-    }
-  } else {
-    console.log('未找到关联的客户信息');
-  }
-}
-```
-```typescript
-// 获取记录的查找字段值
-const lookupField = sheet.getField('客户名称');
-if (Base.isFieldOfType(lookupField, 'lookup')) {
-  const customerName = await lookupField.getValueAsync('rec_order_456');
-  if (customerName !== null) {
-    Output.log(`关联的客户名称: ${customerName}`);
-    
-    // 如果查找字段返回多个值（多对多关联）
-    if (Array.isArray(customerName)) {
-      Output.log(`找到${customerName.length}个关联客户`);
-      customerName.forEach((name, index) => {
-        Output.log(`客户${index + 1}: ${name}`);
-      });
-    }
-  } else {
-    Output.log('未找到关联的客户信息');
-  }
-}
-```