Faasコネクタ-フォームインスタンスの追加または更新
注: このopenapiをhttpコネクタとしてフロントエンド・データ・ソースで直接使用することはお勧めしません。このケースを参照してfaasコネクタを構成してから使用してください。そうしないと、systemtokenパラメータが漏洩し、アプリケーションのデータセキュリティを脅かす可能性があります。
1. 使用シーン
この開発言語の例: nodejs
この例では、ホッチキスオープンプラットフォームopenapiを使用してフォームインスタンスを一括追加する方法について説明します。
2. 機能を実現する
2.1. ホッチキスのオープンプラットフォームの応用証明書とインタフェース権限を申請する
申請した場合、この手順は無視できます。
宜搭自定义连接器鉴权凭证申请及接口权限申请 | 钉钉宜搭·帮助中心
2.2. Faasコネクタの作成と構成
注意:
- 適用: openapi (オープンプラットフォームでもフロントエンド・インタフェースでも) は、文書番号の一意の値を検証するなど、ビジネス関連ルールの制約を受ける必要があります。
- ビジネスルールに相当するupsertは、フィルタ条件が満たされたときに更新され、逆に追加されます。
2.2.1. Faasコネクタの作成
2.2.2. コネクタの基本情報と開発言語の設定
2.2.3. コネクタの設定アクションの実行
Bodyを解析し、成功フラグビットを設定することに注意してください。
{
"appType": "String",
"formUuid": "String",
"searchCondition": "String",
"formDataJson": "String",
"noExecuteExpression": true
}
{
"success": true,
"content": "Array",
"error": ""
}
2.3. Faasコネクタの開発
2.3.1. クラウドideの開発に行き、Dingopenapiutil.jsファイルにコードを追加します
追加が完了したら保存する必要があります。
Windows: ctrl + s Mac:Command + s
次のコードをコピーして、上の図の指定した場所に追加します。
createOrUpdateFormData: async function (createOrUpdateFormDataInputs) {
let client = createClient();
let createOrUpdateFormDataHeaders = new $dingtalkyida_1_0.CreateOrUpdateFormDataHeaders({});
createOrUpdateFormDataHeaders.xAcsDingtalkAccessToken = innerGetAccessToken();
let createOrUpdateFormDataRequest = new $dingtalkyida_1_0.CreateOrUpdateFormDataRequest(createOrUpdateFormDataInputs);
try {
const result = await client.createOrUpdateFormDataWithOptions(createOrUpdateFormDataRequest, createOrUpdateFormDataHeaders, new $Util.RuntimeOptions({}));
return result.body.result;
} catch (err) {
if (!Util.empty(err.code) && !Util.empty(err.message)) {
// err 中含有 code 和 message 属性，可帮助开发定位问题
return {
code: err.code,
message: err.message
}
}
}
}
2.3.2. Faasentry.jsファイルのコードを完全に置き換えます
状況に応じて固定パラメータを変更することに注意してください。
Appkey、appsecretは2.1が申請したアプリケーション証明書です。
Systemtokenは、適切なアプリケーション設定-導入運送次元で直接見つけることができます。
const { openApi: OpenAPIUtil, yidaConnector: YidaConnectorUtil, httpUtil: HttpUtil } = require('./utils');
// 注意：涉及数据安全的参数（如：appKey、appSecret、systemToken）一定要在服务端发送，不可在前端数据源里传入。
const appKey = 'XXXXXXXXXXXXXXXXXXXXX';
const appSecret = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const systemToken = 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
module.exports = async function (faasInputs) {
// 这里的 inputs 跟你配置连接器时的 Body 参数及字段格式保持一致
const { inputs = {}, yidaContext = {} } = faasInputs || {};
const userId = yidaContext ? yidaContext['userId'] : ''; // 从连接器上下文获取调用人的 userId
const accessToken = yidaContext ? yidaContext['accessToken'] : '';
const consumeCode = yidaContext ? yidaContext['consumeCode'] : '';
OpenAPIUtil.setAccessToken(accessToken);
await OpenAPIUtil.getCustomAccessTokenThenCache(appKey, appSecret); // 获取调用连接器的 accessToken
YidaConnectorUtil.setConsumeCode(consumeCode);
inputs['systemToken'] = systemToken;
inputs['userId'] = userId;
return await createOrUpdateFormData(inputs).then((result) => {
const { message = '' } = result;
if (message) {
return {
success: false,
content: null,
error: message,
};
}
return {
success: true,
content: result,
error: null,
};
}).catch((error) => {
return {
success: false,
content: null,
error,
};
});
};
async function createOrUpdateFormData(inputs) {
return await OpenAPIUtil.createOrUpdateFormData(inputs);
}
2.4. Faasコネクタの導入
追加したコードを保存することに注意してください。
ヒントコードの導入が成功すると、faasコネクタクラウドideの開発が完了します。
2.5. コネクタ設定に戻り、「保存」をクリックします
2.6. 適切なページでデータソースを設定し、データソースを使用します
2.6.1. データを取得してテーブルに表示します
下記のケースを参考にしてください。この例は下記のケースに対してデータを追加または編集する機能のアップグレードです。
2.6.2. データソースで作成したばかりのコネクタを選択します
2.6.3. フロントエンドによるデータソースの直接呼び出し
// 新增｜编辑
export function onOk() {
const fieldList = [
'textField_lpalzd4k', // 姓名
'radioField_lpalzd4l', // 性别
'numberField_lpalzd4m', // 年龄
];
this.fieldsValidate(fieldList).then(errorList => {
if (errorList.length > 0) return
// 业务逻辑
this.$('dialog_lpalzd4i').set('confirmState', 'LOADING');
const params = {
serialNo: this.$('textField_lpayswqj').getValue(), // 流水号
textField_lpaj4gmm: this.$('textField_lpalzd4k').getValue(),
radioField_lpaj4gmn: this.$('radioField_lpalzd4l').getValue(),
numberField_lpaj4gmo: this.$('numberField_lpalzd4m').getValue(),
}
const condition = [
{
key: 'serialNo',
value: params.serialNo || 'null',
type: 'TEXT',
operator: 'eq',
componentName: 'TextField'
}
];
this.dataSourceMap.createOrUpdateFormData.load({
inputs: JSON.stringify({
body: {
noExecuteExpression: true,
formUuid: 'FORM-A12BBB90A89E48FCB11D23EEFB29ABC0RVHN',
searchCondition: JSON.stringify(condition),
appType: pageConfig.appType,
formDataJson: JSON.stringify(params),
}
})
}).then((res) => {
const { success, error } = res;
if (!success) {
this.utils.toast({
title: error,
type: 'error',
});
this.$('dialog_lpalzd4i').set('confirmState', 'NORMAL');
return;
}
this.utils.toast({
title: '操作成功',
type: 'success',
});
this.$('dialog_lpalzd4i').set('confirmState', 'NORMAL');
this.$('dialog_lpalzd4i').hide();
setTimeout(() => {
this.getTableData();
}, 1000);
}).catch((error) => {
this.$('dialog_lpalzd4i').set('confirmState', 'NORMAL');
this.utils.toast({
title: error.message,
type: 'error',
});
})
})
}
3. 効果を実現する
3.1. 新規追加
3.2. 編集
4. オンラインで試遊する
このドキュメントは役に立ちましたか？