# 自定义连接器管理
# 新建自定义连接器
腾讯云微搭低代码自定义连接器支持调用第三方服务接口或使用代码来实现自定义业务逻辑,我们可以在控制台-数据源管理页面中进行自定义连接器的创建。
# 步骤1:填写基础信息
注意:
标识为自定义连接器的唯一标识,在微搭应用编辑器、自定义代码中均需要借助这个标识来使用。
# 步骤2:实现连接器方法
目前自定义连接器支持两种方式来实现自定义业务逻辑:
- HTTP 请求:使用 HTTP 方式调用外部服务,通过简单的配置 HTTP 请求地址、方法、参数等即可完成方法的配置。
- 云函数:集成了常用 NPM 包、数据模型、连接器等 API,只支持 JS 开发语言,可以用来实现自定义业务逻辑。
开发者可以根据业务需求使用 HTTP 请求 或 自定义代码 方式实现自定义连接器方法,下面只展示使用 自定义代码 实现方法的示例:
# 外部 HTTP 服务
若开发者有第三方服务可以通过 HTTP 调用,我们可以按照下列示例使用:
const fetch = require('node-fetch');
module.exports = async function (params, context) {
const response = await fetch(`https://reqres.in/api/users?page=${params.pageNo}`);
const result = await response.json();
// 这里的返回需要和出参结构对应
return {
pageNo: result.page,
pageSize: result.per_page,
total: result.total,
records: result.data.map(d => ({
_id: d.id,
...d,
})),
};
};
# 外部数据库
若开发者有自己的数据库(腾讯云或自有数据库),可以使用 云开发云函数 来实现数据库连接和读写,以下是云函数示例:
const mysql = require("mysql2/promise");
exports.main = async (event, context) => {
try {
const connection = await mysql.createConnection({
host: process.env.HOST,
user: process.env.USERNAME,
password: process.env.PASSWORD,
port: process.env.PORT,
database: process.env.DB,
});
console.log('已连接')
const [rows, fields] = await connection.execute('SELECT * FROM `weda_model_example`;');
// 这里可以对返回数据做加工
return rows;
} catch(err) {
console.log('错误连接', err);
return err;
}
};
然后在自定义代码调用上述云函数:
module.exports = async function (params, context) {
const result = await context.app.callFunction({
name: '云开发云函数名称',
data: {}, // 方法入参
});
// 在这里返回这个方法的结果,需要与出参定义的结构映射
return {
_id: 123456
};
};
注意:
只能调用与微搭相同云开发环境中的云函数。
# 云开发数据库
若开发者想自己实现 DB 读写逻辑,可以通过下列方式直接操作数据库:
module.exports = async function (params, context) {
const result = await context.database.collection('数据库集合名称').get();
// 在这里返回这个方法的结果,需要与出参定义的结构映射
return {
_id: 123456
};
};
注意:
只能调用与微搭相同云开发环境中的数据库。
# 步骤4:启用方法
最后请勾选方法以启用已经实现的方法。
# 编辑连接器
有两种方式可以对连接器进行编辑:
- 在 自定义连接器 页面,找到编辑的连接器,在 操作 列单击 编辑。
- 在 自定义连接器页面,点击右上角 编辑。
# 发布数据模型
数据模型需要发布才会在正式环境生效,有两种方式可以发布数据模型:
在 自定义连接器]页面,找到编辑的数据模型,在 操作 列单击 更多 > 发布。
在 自定义连接器详情 页面,在 基础信息 卡片中 状态 > 立即发布。
# 删除连接器
在 自定义连接器 列表页面,找到编辑的自定义连接器,在 操作 列单击 更多 > 删除。
注意:
自定义连接器删除前,必须解绑在所有应用的关联使用。