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/UnidirectionalLinkFields /345/215/225/345/220/221/345/205/263/350/201/224/345/255/227/346/256/265.md"

@@ -1,295 +0,0 @@
-# UnidirectionalLinkFields 单向关联字段
-
-UnidirectionalLinkField 继承自基础 [Field](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)类，专门用于处理单向关联类型数据。用于从当前表向目标表建立关联关系，只在当前表中记录关联信息，不会在目标表中创建反向关联。
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定记录在该单向关联字段中的关联值。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<AssociationsValue | null>
-
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-
-**返回值**
-
-*   [`Promise<AssociationsValue | null>`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_ICnmHpkyc2) - 关联值对象，如果未设置关联则返回null
-    
-
-**示例**
-
-```typescript
-// 获取记录的关联值
-const linkField = sheet.getField<UnidirectionalLinkField>('参考方案');
-if (linkField) {
-  const linkValue = await linkField.getValueAsync('rec_project_123');
-  if (linkValue) {
-    console.log(`关联的记录数量: ${linkValue.linkedRecordIds.length}`);
-    
-    // 打印每个关联的记录ID
-    linkValue.linkedRecordIds.forEach((recordId, index) => {
-      console.log(`参考方案${index + 1}: ${recordId}`);
-    });
-  } else {
-    console.log('该项目未设置参考方案');
-  }
-}
-
-```
-```typescript
-// 获取记录的关联值
-const linkField = sheet.getField('参考方案');
-if (Base.isFieldOfType(linkField, 'unidirectionalLink')) {
-  const linkValue = await linkField.getValueAsync('rec_project_123');
-  if (linkValue) {
-    Output.log(`关联的记录数量: ${linkValue.linkedRecordIds.length}`);
-    
-    // 打印每个关联的记录ID
-    linkValue.linkedRecordIds.forEach((recordId, index) => {
-      Output.log(`参考方案${index + 1}: ${recordId}`);
-    });
-  } else {
-    Output.log('该项目未设置参考方案');
-  }
-}
-
-```
-
-### setValueAsync
-
-设置指定记录在该单向关联字段中的关联值。
-
-```typescript
-setValueAsync: (recordId: string, value: AssociationsValue) => Promise<boolean>
-
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-*   `value`: [`AssociationsValue`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_ICnmHpkyc2) - 关联值对象
-    
-
-**返回值**
-
-*   `Promise<boolean>` - 操作是否成功
-    
-
-**示例**
-
-```typescript
-// 设置记录的关联值
-const linkField = sheet.getField<UnidirectionalLinkField>('技术栈');
-if (linkField) {
-  const linkValue: AssociationsValue = {
-    linkedRecordIds: ['rec_1', 'rec_2'],
-  };
-  
-  const success = await linkField.setValueAsync('rec_123', linkValue);
-  if (success) {
-    console.log('技术栈关联设置成功');
-    console.log('注意：这是单向关联，目标表中不会创建反向关联');
-  } else {
-    console.log('技术栈关联设置失败');
-  }
-}
-
-```
-```typescript
-// 设置记录的关联值
-const linkField = sheet.getField('技术栈');
-if (Base.isFieldOfType(linkField, 'unidirectionalLink')) {
-  const linkValue: AssociationsValue = {
-    linkedRecordIds: ['rec_1', 'rec_2'],
-  };
-  
-  const success = await linkField.setValueAsync('rec_123', linkValue);
-  if (success) {
-    Output.log('技术栈关联设置成功');
-    Output.log('注意：这是单向关联，目标表中不会创建反向关联');
-  } else {
-    Output.log('技术栈关联设置失败');
-  }
-}
-
-```
-
-### setLinkedSheetId
-
-设置关联的目标数据表ID。
-
-```typescript
-setLinkedSheetId: (linkedSheetId: string) => string
-
-```
-
-**参数**
-
-*   `linkedSheetId`: `string` - 目标数据表ID
-    
-
-**返回值**
-
-*   `string` - 字段ID
-    
-
-**示例**
-
-```typescript
-// 设置关联的目标表
-const linkField = sheet.getField<UnidirectionalLinkField>('参考资料');
-if (linkField) {
-  const fieldId = linkField.setLinkedSheetId('abcdefg');
-  console.log(`成功设置关联目标表，字段ID: ${fieldId}`);
-}
-
-```
-```typescript
-// 设置关联的目标表
-const linkField = sheet.getField('参考资料');
-if (Base.isFieldOfType(linkField, 'unidirectionalLink')) {
-  const fieldId = linkField.setLinkedSheetId('abcdefg');
-  Output.log(`成功设置关联目标表，字段ID: ${fieldId}`);
-}
-
-```
-
-### getLinkedSheetId
-
-获取当前关联的目标数据表ID。
-
-```typescript
-getLinkedSheetId: () => string
-
-```
-
-**返回值**
-
-*   `string` - 目标数据表ID
-    
-
-**示例**
-
-```typescript
-// 获取关联的目标表ID
-const linkField = sheet.getField<UnidirectionalLinkField>('参考资料');
-if (linkField) {
-  const linkedSheetId = linkField.getLinkedSheetId();
-  console.log(`关联的目标表ID: ${linkedSheetId}`);
-}
-
-```
-```typescript
-// 获取关联的目标表ID
-const linkField = sheet.getField('参考资料');
-if (Base.isFieldOfType(linkField, 'unidirectionalLink')) {
-  const linkedSheetId = linkField.getLinkedSheetId();
-  Output.log(`关联的目标表ID: ${linkedSheetId}`);
-}
-
-```
-
-### setMultiple
-
-设置是否允许关联多条记录。
-
-```typescript
-setMultiple(multiple: boolean): string
-
-```
-
-**参数**
-
-*   `multiple`: `boolean` - 是否允许多选，true表示可以关联多条记录，false表示只能关联一条记录
-    
-
-**返回值**
-
-*   `string` - 字段ID
-    
-
-**示例**
-
-```typescript
-// 设置允许关联多条记录
-const linkField = sheet.getField<UnidirectionalLinkField>('相关文档');
-if (linkField) {
-  const fieldId = linkField.setMultiple(true);  // 允许关联多个文档
-  console.log(`已设置为允许多选，字段ID: ${fieldId}`);
-}
-
-// 设置只允许关联一条记录
-const templateField = sheet.getField<UnidirectionalLinkField>('使用模板');
-if (templateField) {
-  const fieldId = templateField.setMultiple(false);  // 只能选择一个模板
-  console.log(`已设置为单选模式，字段ID: ${fieldId}`);
-}
-
-```
-```typescript
-// 设置允许关联多条记录
-const linkField = sheet.getField('相关文档');
-if (Base.isFieldOfType(linkField, 'unidirectionalLink')) {
-  const fieldId = linkField.setMultiple(true);  // 允许关联多个文档
-  Output.log(`已设置为允许多选，字段ID: ${fieldId}`);
-}
-
-// 设置只允许关联一条记录
-const templateField = sheet.getField('使用模板');
-if (Base.isFieldOfType(templateField, 'unidirectionalLink')) {
-  const fieldId = templateField.setMultiple(false);  // 只能选择一个模板
-  Output.log(`已设置为单选模式，字段ID: ${fieldId}`);
-}
-
-```
-
-### getMultiple
-
-获取当前是否允许关联多条记录的设置。
-
-```typescript
-getMultiple(): boolean
-
-```
-
-**返回值**
-
-*   `boolean` - true表示允许多选，false表示只能单选
-    
-
-**示例**
-
-```typescript
-// 检查多选设置
-const linkField = sheet.getField<UnidirectionalLinkField>('参考案例');
-if (linkField) {
-  const isMultiple = linkField.getMultiple();
-  if (isMultiple) {
-    console.log('当前允许关联多条记录');
-  } else {
-    console.log('当前只允许关联一条记录');
-  }
-}
-
-```
-```typescript
-// 检查多选设置
-const linkField = sheet.getField('参考案例');
-if (Base.isFieldOfType(templateField, 'unidirectionalLink')) {
-  const isMultiple = linkField.getMultiple();
-  if (isMultiple) {
-    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/UrlField /351/223/276/346/216/245/345/255/227/346/256/265.md"

@@ -1,163 +0,0 @@
-# UrlField 链接字段
-
-UrlField 继承自基础 [Field](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space) 类，用于存储和管理URL链接，可以包含显示文本和实际链接地址。它适合用于存储网站链接、资源地址等需要跳转的信息。
-
-## 字段特有方法
-
-### getValueAsync
-
-获取指定记录在该URL字段的值。
-
-```typescript
-getValueAsync: (recordId: string) => Promise<LinkValue | null>
-
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-
-**返回值**
-
-*   [`Promise<LinkValue | null>`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_cfDWOQUVmU) - URL对象，包含text（显示文本）和link（链接地址）属性，如果记录不存在或值为空则返回null
-    
-
-**示例**
-
-```typescript
-// 获取URL字段值
-const websiteField = sheet.getField<UrlField>('网站');
-if (websiteField) {
-  const url = await websiteField.getValueAsync('rec123456');
-  if (url) {
-    console.log(`链接地址: ${url.link}`);
-    if (url.text) {
-      console.log(`显示文本: ${url.text}`);
-    }
-  } else {
-    console.log('未设置网站链接');
-  }
-}
-
-```
-```typescript
-// 获取URL字段值
-const websiteField = sheet.getField('网站');
-if (Base.isFieldOfType(websiteField, 'url')) {
-  const url = await websiteField.getValueAsync('rec123456');
-  if (url) {
-    Output.log(`链接地址: ${url.link}`);
-    if (url.text) {
-      Output.log(`显示文本: ${url.text}`);
-    }
-  } else {
-    Output.log('未设置网站链接');
-  }
-}
-
-```
-
-### setValueAsync
-
-设置指定记录在该URL字段的值。
-
-```typescript
-setValueAsync: (recordId: string, url: LinkValue | string) => Promise<boolean>
-```
-
-**参数**
-
-*   `recordId`: `string` - 记录ID
-    
-*   `url`: [`LinkValue | string`](https://alidocs.dingtalk.com/i/nodes/GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno?iframeQuery=record%3DhERWDMS_qvGDAH2_cfDWOQUVmU) - URL值，可以是字符串（直接作为链接地址）或包含link和可选text属性的对象
-    
-
-**返回值**
-
-*   `Promise<boolean>`\- 操作是否成功
-    
-
-**示例**
-
-```typescript
-// 使用字符串设置URL字段值
-const websiteField = sheet.getField<UrlField>('网站');
-if (websiteField) {
-  // 方式1：直接设置链接地址
-  const success1 = await websiteField.setValueAsync('rec123456', 'https://www.example.com');
-  
-  // 方式2：设置带显示文本的链接
-  const success2 = await websiteField.setValueAsync('rec234567', {
-    link: 'https://www.example.org',
-    text: '示例网站'
-  });
-}
-
-```
-```typescript
-// 使用字符串设置URL字段值
-const websiteField = sheet.getField('网站');
-if (Base.isFieldOfType(websiteField, 'url')) {
-  // 方式1：直接设置链接地址
-  const success1 = await websiteField.setValueAsync('rec123456', 'https://www.example.com');
-  
-  // 方式2：设置带显示文本的链接
-  const success2 = await websiteField.setValueAsync('rec234567', {
-    link: 'https://www.example.org',
-    text: '示例网站'
-  });
-}
-
-```
-
-## 使用示例
-
-```typescript
-// 完整的URL字段使用示例
-async function manageWebsiteLinks() {
-  const sheet = base.getSheet('合作伙伴');
-  const websiteField = sheet.getField<UrlField>('官网链接');
-  
-  if (websiteField && websiteField.getType() === 'url') {
-    // 获取所有记录
-    const partners = await sheet.getRecordsAsync({ pageSize: 50 });
-    
-    // 统计有效的网站链接
-    let validLinksCount = 0;
-    let missingLinksCount = 0;
-    
-    for (const partner of partners.records) {
-      const website = await websiteField.getValueAsync(partner.getId());
-      
-      if (website && website.link) {
-        validLinksCount++;
-        console.log(`${partner.getCellValue('公司名称')}: ${website.text || website.link}`);
-      } else {
-        missingLinksCount++;
-        
-        // 为没有网站的合作伙伴自动添加一个搜索链接
-        const companyName = partner.getCellValue('公司名称');
-        if (companyName) {
-          const searchUrl = `https://www.google.com/search?q=${encodeURIComponent(companyName)}`;
-          await websiteField.setValueAsync(partner.getId(), {
-            link: searchUrl,
-            text: `搜索 ${companyName}`
-          });
-          console.log(`为 ${companyName} 添加了搜索链接`);
-        }
-      }
-    }
-    
-    console.log(`统计结果: ${validLinksCount} 个有效链接, ${missingLinksCount} 个缺失链接`);
-    
-    // 更新特定记录的链接
-    const importantPartnerId = 'rec123456';
-    await websiteField.setValueAsync(importantPartnerId, {
-      link: 'https://www.important-partner.com',
-      text: '重要合作伙伴官网'
-    });
-  }
-}
-
-```