modifyTablesData() メソッド

modifyTablesData(modifyData, callback, errorCallback): void

指定した更新レコード情報に基づき、複数レコードを一括更新します。更新は新規追加、編集、削除の3つの処理すべてを含むことが可能です。
たとえば、addTableDataメソッドを使用してデータを1,000行追加する場合、サーバーに対して1,000件のリクエストが送信されます。この方法の場合、大量のリクエストが発生するだけでなく、そのうちの1回が失敗した場合であってもすべてをキャンセルできないという問題があります。本メソッドを使用することで、そのような問題を回避できます。

引数

• modifyData

どのテーブルに対して、どの行のどの列を追加/変更/削除するかを含むModifyDataオブジェクトを指定します。

• callback: Function

レコードの一括更新が成功したときに実行するコールバック関数を指定します。

• errorCallback: Function

レコードの一括更新が失敗したときに実行するコールバック関数を指定します。 引数にエラーメッセージが渡されます。なお、テーブル名の指定に誤りがあるなどのデータベースアクセスにおける構文エラーについては、本コールバック関数を使用してエラーをハンドルすることはできません。そのような場合のエラー内容については、HTTP応答ヘッダーの内容を確認する必要があります。

戻り値

void

使用例

// テーブル1とテーブル2にレコードを追加します。
Forguncy.modifyTablesData({
    テーブル1: {
        addRows: [
            {
                名前: "山田太郎",
                部門: "開発部"
            },
            {
                名前: "鈴木花子",
                部門: "総務部"
            },
        ]
    },
    テーブル2: {
        addRows: [
            {
                名前: "佐々木一郎",
                部門: "マーケティング部"
            },
            {
                名前: "斎藤次郎",
                部門: "マーケティング部"
            },
        ]
    }
});
// テーブル1とテーブル2からそれぞれ2レコードずつ削除します。
Forguncy.modifyTablesData({
    テーブル1: {
        deleteRows: [
            {
                ID: 2
            },
            {
                ID: 3
            },
        ]
    },
    テーブル2: {
        deleteRows:  [
            {
                ID: 3
            },
            {
                ID: 4
            },
        ]
    }
});
// テーブル1とテーブル2の複数件のレコードを一括更新します。
Forguncy.modifyTablesData({
    テーブル1: {
        editRows: [
            {
                primaryKey:
                {
                    ID: 2
                },
                values: {
                    名前: "山田太郎",
                    部門: "開発部"
                }
            },
            {
                primaryKey:
                {
                    ID: 3
                },
                values: {
                    名前: "鈴木花子",
                    部門: "総務部"
                }
            },
        ]
    },
    テーブル2: {
        editRows: [
            {
                primaryKey:
                {
                    ID: 3
                },
                values: {
                    名前: "佐々木一郎",
                    部門: "マーケティング部"
                }
            },
            {
                primaryKey:
                {
                    ID: 4
                },
                values: {
                    名前: "斎藤次郎",
                    部門: "マーケティング部"
                }
            },
        ]
    }
});
// テーブル1に対して複数レコードの追加、複数レコードの削除、複数レコードの更新を一括で行います。
Forguncy.modifyTablesData({
    テーブル1: {
        addRows: [
            {
                名前: "佐々木一郎",
                部門: "マーケティング部"
            },
            {
                名前: "斎藤次郎",
                部門: "マーケティング部"
            },
        ],
        deleteRows: [
            {
                ID: 2
            },
            {
                ID: 3
            },
        ],
        editRows: [
            {
                primaryKey:
                {
                    ID: 2
                },
                values: {
                    名前: "山田太郎",
                    部門: "開発部"
                }
            },
            {
                primaryKey:
                {
                    ID: 3
                },
                values: {
                    名前: "鈴木花子",
                    部門: "総務部"
                }
            },
        ]
    }
});