kintone: レコード更新

const FIELD_NUM = 7; // 扱えるフィールドの数

function main() {
    //// == 工程コンフィグ・ワークフローデータの参照 / Config & Data Retrieving ==
    const auth = configs.getObject("conf_auth");
    const basic = configs.getObject("conf_basic");
    const domain = configs.get("conf_domain");
    const guestSpaceId = configs.get("conf_guestSpaceId");
    const appId = configs.get("conf_appId");
    const recordId = retrieveRecordId();

    const apiToken = auth.getToken();
    const recordObj = retrieveRecordContent();

    //// == 演算 / Calculating ==
    const apiUri = determineApiUri(domain, guestSpaceId);
    updateRecord(apiUri, apiToken, basic, appId, recordId, recordObj);
}

/**
  * config からレコード ID を読み出す
  * @return {Stromg} recordId  レコード ID
  */
function retrieveRecordId() {
    const recordIdDef = configs.getObject("conf_recordId");
    let recordId = configs.get("conf_recordId");
    if (recordIdDef !== null) {
        recordId = engine.findData(recordIdDef);
    }
    return recordId;
}

/**
  * configからレコード情報（フィールドコードとフィールドの値）を読み出し、JSON オブジェクトを返す
  * レコード情報が空の場合はエラーとする
  * @return {Object} recordObj  レコード情報の JSON オブジェクト
  */
function retrieveRecordContent() {
    const recordObj = {};
    for (let i = 0; i < FIELD_NUM; i++) {
        const fieldCodeConfigName = `conf_fieldCode${i + 1}`;
        const fieldValueConfigName = `conf_fieldValue${i + 1}`;

        const fieldCode = configs.get(fieldCodeConfigName);
        if (fieldCode === "" || fieldCode === null) { // フィールドコードが空
            continue;
        }
        if (recordObj[fieldCode] !== undefined) { // フィールドコードの指定が重複
            throw new Error("The same Field Code is set multiple times.");
        }

        let fieldValue = configs.get(fieldValueConfigName);
        if (fieldValue === "" || fieldValue === null) { // 値が空
            fieldValue = null;
        }
        recordObj[fieldCode] = {
            "value": fieldValue
        };
    }
    if (Object.keys(recordObj).length === 0) { // レコード情報が空
        throw new Error("No field to update is set.");
    }
    return recordObj;
}

/**
  * kintone REST API のレコード追加の URI を決定する
  * ドメインが空、または kintone のドメインとして不正な文字列であればエラーとする
  * ゲストスペース ID が不正な文字列であればエラーとする
  * @param {String} domain  ドメイン
  * @param {String} guestSpaceId  ゲストスペース ID
  * @return {String} apiUri  API の URI
  */
function determineApiUri(domain, guestSpaceId) {
    if (domain === "" || domain === null) {
        throw new Error("Domain is empty.");
    }
    const domainReg = new RegExp('^[0-9a-zA-Z-]{3,32}.(?:kintone.com|cybozu.com)$');
    if (!domainReg.test(domain)) {
        throw new Error("Invalid Kintone domain.");
    }
    let apiUri = "";
    if (guestSpaceId === "" || guestSpaceId === null) {
        apiUri = `https://${domain}/k/v1/record.json`;
    } else {
        if (!isValidId(guestSpaceId)) {
            throw new Error("Invalid Guest Space ID.");
        }
        apiUri = `https://${domain}/k/guest/${guestSpaceId}/v1/record.json`;
    }
    return apiUri;
}

/**
  * kintone REST API にレコード更新の PUT リクエストを送信する
  * アプリ ID、レコード ID が空、または不正な文字列であればエラーとする
  * @param {String} apiUri  API の URI
  * @param {String} apiToken  API トークン
  * @param {AuthSettingWrapper} basic  Basic 認証設定
  * @param {String} appId  アプリ ID
  * @param {String} recordId  レコード ID
  * @param {Object} recordObj  レコード情報の JSON オブジェクト
  */
function updateRecord(apiUri, apiToken, basic, appId, recordId, recordObj) {
    if (appId === "" || appId === null) {
        throw new Error("App ID is empty.");
    }
    if (!isValidId(appId)) {
        throw new Error("Invalid App ID.");
    }
    if (recordId === "" || recordId === null) {
        throw new Error("Record ID is empty.");
    }
    if (!isValidId(recordId)) {
        throw new Error("Invalid Record ID.");
    }
    const body = {
        "app": appId,
        "id": recordId,
        "record": recordObj
    };
    let request = httpClient.begin()
        .header("X-Cybozu-API-Token", apiToken)
        .body(JSON.stringify(body), "application/json; charset=UTF-8");
    if (basic !== "" && basic !== null) {
        request = request.authSetting(basic);
    }
    //when error thrown
    const response = request.put(apiUri);
    const responseJson = response.getResponseAsString();
    const status = response.getStatusCode();
    if (status >= 300) {
        engine.log(`API URI: ${apiUri}`);
        engine.log(`Request Body: ${JSON.stringify(body)}`);
        const accessLog = `---PUT request--- ${status}\n${responseJson}\n`;
        engine.log(accessLog);
        throw new Error(`Failed to update record. status: ${status}`);
    }
}

/**
  * ID が有効か（自然数か）を判定する
  * @param {String} idString  ID の文字列
  * @return {Boolean}  有効な ID かどうか
  */
function isValidId(idString) {
    const idReg = new RegExp('^[1-9][0-9]*$');
    return idReg.test(idString);
}