aitable-workflow-cli 0.1.13-beta.1

package/templates/support-qa/profiles/aitable/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"

@@ -0,0 +1,295 @@
+# 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/support-qa/profiles/aitable/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"

@@ -0,0 +1,163 @@
+# 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: '重要合作伙伴官网'
+    });
+  }
+}
+
+```