$p.apiCreate

2020年1月9日2026年10月11日

概要¶

AjaxのPOSTリクエストにより、新規レコードを作成します。

構文¶

JavaScript¶

$p.apiCreate({
    id: (サイトID),
    data: {
        項目名: '(値)'
    },
    done: (任意の処理),
    fail: (任意の処理),
    always: (任意の処理)
});

パラメータ¶

パラメータ名	型	必須	概要
id	long	○	任意のサイトのID
data	object	○	作成するレコードの条件等をJSON形式で指定。JSONの仕様はレコード作成APIを参照。
done	function	○	API通信成功時の処理
fail	function		API通信失敗時の処理
always	function		API通信完了時の処理

使用例¶

以下のサンプルコードは、サイトID:123のテーブルにタイトルが"コーヒー"、分類Aが"ブラック" のレコードを作成します。

JavaScript¶

$p.apiCreate({
    id: 123,
    data: {
        Title: 'コーヒー',
        ClassHash: {
            ClassA: 'ブラック'
        }
    },
    done: function (data) {
        $p.clearMessage();
        const message = {
            Css: 'alert-success',
            Text: '新規レコードを作成しました'
        };
        $p.setMessage('#Message',JSON.stringify(message));
    },
    fail: function (data) {
        console.log(data);
    }
});

サンプルコード¶

Note

コード内の【 ... 】は適宜修正してください。

1. レコード作成

レコードを新規作成します。

// 作成先のサイトID
const siteId = 【サイトID】;

$p.apiCreate({
    id: siteId,
    data: {
        ApiVersion: 1.1,
        Title: 'サンプル案件_P1',
        Status: 200,
        ClassHash: { ClassA: '問い合わせ' },
        DateHash: { DateA: '2025/1/10' },
        NumHash: { NumA: 5 },
    },
    done: function (data) {
        console.log('レコード作成成功');
    },
    fail: function (data) {
        console.log('レコード作成失敗');
    },
});

実行結果¶

レコード作成成功

2. 全ユーザを対象に、重複条件に一致しない人だけレコードを一括作成する

このサンプルは「$p.apiUsersGet」のサンプルコードにあります。