delete_form_data

Instructions

Implementation Reference

• src/index.ts:858-904 (handler)

  MCP tool handler implementation for 'delete_form_data'. Validates parameters, resolves form ID, instantiates JianDaoYunClient, calls deleteFormData, handles response and errors.

  case 'delete_form_data': {
    const { formId, dataIds, isStartTrigger } = args as {
      formId: string;
      dataIds: string | string[];
      isStartTrigger?: boolean;
    };
    const { appId, appKey, baseUrl } = getDefaultParams(args);
    
    // 验证必需参数
    if (!appKey) {
      throw new Error('appKey is required. Please set JIANDAOYUN_APP_KEY in MCP server configuration.');
    }
    if (!appId) {
      throw new Error('appId is required. Please provide it as parameter.');
    }
  
    try {
      // 创建客户端实例
      const jdyClient = new JianDaoYunClient({
        appId,
        appKey,
        baseUrl
      });
      
      const resolved = await resolveFormId(formId, appKey);
      const result = await jdyClient.deleteFormData(resolved.formId, dataIds, {
        isStartTrigger,
      });
  
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify({
              success: true,
              result,
              message: `成功删除 ${Array.isArray(dataIds) ? dataIds.length : 1} 条记录`,
              formUsed: resolved.formId,
              appId: resolved.appId || appId
            }, null, 2),
          },
        ],
      };
    } catch (error) {
      throw createEnhancedError(error, '删除表单数据');
    }
  }

• src/index.ts:431-461 (registration)

  Tool registration entry for 'delete_form_data' in the ListToolsRequestSchema response, including name, description, and input schema definition.

  {
    name: 'delete_form_data',
    description: 'Delete one or more form data entries',
    inputSchema: {
      type: 'object',
      properties: {
        appId: {
          type: 'string',
          description: 'The JianDaoYun application ID',
        },
        appKey: {
          type: 'string',
          description: 'The JianDaoYun application key (API key) (optional, will use JIANDAOYUN_APP_KEY from environment if not provided)',
        },
        formId: {
          type: 'string',
          description: 'The form ID (can be form ID or app ID)',
        },
        dataIds: {
          type: ['string', 'array'],
          description: 'Data ID(s) to delete',
          items: { type: 'string' },
        },
        isStartTrigger: {
          type: 'boolean',
          description: 'Whether to trigger automation',
        },
      },
      required: ['appId', 'formId', 'dataIds'],
    },
  },

• src/client.ts:296-329 (helper)

  Core implementation of form data deletion in JianDaoYunClient class. Handles single or batch delete via API endpoints, constructs request, sends POST, processes response and errors.

  async deleteFormData(formId: string, dataId: string | string[], options?: { isStartTrigger?: boolean }): Promise<any> {
    try {
      const isMultiple = Array.isArray(dataId);
      const endpoint = isMultiple ? '/v5/app/entry/data/batch_delete' : '/v5/app/entry/data/delete';
      
      const requestData: any = {
        app_id: this.config.appId,
        entry_id: formId
      };
  
      if (isMultiple) {
        requestData.data_ids = dataId;
      } else {
        requestData.data_id = dataId;
      }
  
      if (options?.isStartTrigger !== undefined) {
        requestData.is_start_trigger = options.isStartTrigger;
      }
  
      const response = await this.axios.post<ApiResponse>(endpoint, requestData);
  
      if (response.data.code !== 0) {
        throw new Error(`Failed to delete form data: ${response.data.msg}`);
      }
  
      return response.data.data;
    } catch (error) {
      if (axios.isAxiosError(error)) {
        throw new Error(`API request failed: ${error.response?.data?.msg || error.message}`);
      }
      throw error;
    }
  }

• src/index.ts:75-129 (helper)

  Helper function to resolve formId, handling both direct form IDs and app IDs by fetching form lists if necessary, with suggestions for multiple forms.

  async function resolveFormId(inputId: string, appKey: string): Promise<{ formId: string; appId?: string; suggestions?: string[] }> {
    // 如果输入看起来像表单ID（通常24位字符），直接返回
    if (inputId.length === 24 && /^[a-f0-9]{24}$/i.test(inputId)) {
      return { formId: inputId };
    }
  
    // 尝试作为应用ID处理
    const appList = await getAppList(appKey);
    const targetApp = appList.find(app => app.app_id === inputId);
    
    if (targetApp) {
      // 这是一个应用ID，需要获取其下的表单列表
      try {
        const response = await axios.post(
          `${process.env.JIANDAOYUN_BASE_URL || 'https://api.jiandaoyun.com'}/api/v1/app/${inputId}/entry/list`,
          {},
          {
            headers: {
              'Authorization': `Bearer ${appKey}`,
              'Content-Type': 'application/json'
            }
          }
        );
        
        const forms = response.data || [];
        if (forms.length === 0) {
          throw new Error(`应用 "${targetApp.name}" 下没有找到可用的表单`);
        }
        
        // 如果只有一个表单，直接返回
        if (forms.length === 1) {
          return { 
            formId: forms[0].entry_id || forms[0]._id,
            appId: inputId
          };
        }
        
        // 多个表单时，返回建议列表
        const suggestions = forms.map((form: any) => 
          `${form.name || '未命名表单'} (${form.entry_id || form._id})`
        );
        
        return {
          formId: forms[0].entry_id || forms[0]._id, // 默认返回第一个
          appId: inputId,
          suggestions
        };
      } catch (error) {
        throw new Error(`无法获取应用 "${targetApp.name}" 下的表单列表: ${error instanceof Error ? error.message : '未知错误'}`);
      }
    }
    
    // 既不是标准表单ID也不是已知应用ID，直接尝试使用
    return { formId: inputId };
  }