ヘルプで見つからない情報は、サポートにお問い合わせください。お問い合わせ

開発者向け機能：API機能：テーブル操作：レコード一括作成・更新

Avatar
サポートセンター

APIを使用して複数レコードを作成または更新することができます。
指定したキー項目が一致するレコードがある場合はそのレコードを更新、一致するレコードがない場合は新規作成を行います。
キー項目が無い場合は全てのレコードの新規作成を行います。
処理が正常に終了した場合に通知タイミングがインポート後の通知を行います。
レコード単位で処理をおこない途中がエラーが発生した場合は以降の処理は中止されます。

■事前準備
APIの操作を行う前にAPIキーの作成を実施してください。
また、この機能はテナント管理者でないと行えないため、ユーザ管理からテナント管理者の設定を行ってください。

■制限事項
対象のサイトに「作成」および「更新」権限が必要です。
500件を超えたレコードがあった場合は処理を行いません。

■リクエスト 
下記のリクエスト形式で、jsonデータを送信します。

＜設定項目＞

設定項目 値
HTTPメソッド POST
Content-Type application/json
文字コード UTF-8
URL https://ks01.shelterdb.net/api/items/{サイトID}/bulkupsert
{サイトID}には、更新対象のサイトIDを指定してください。
Body 以下のjsonデータを参考のこと

 

＜jsonデータ＞

{
    "ApiVersion": "1.1",
    "ApiKey": "345yuAjA6789dA09d8uj6...",
    "Keys": [
        "ClassA"
    ],
    "KeyNotFoundCreate": true,
    "Data": [
        {
            "Title": "新機能XXを開発する1",
            "ClassHash": {
                "ClassA": "RC0001"
            }
        },        
        {
            "Title": "新機能XXを開発する2",
            "ClassHash": {
                "ClassA": "RC0002"
            }
        }
    ]
}

 

カラム 設定内容
Keys キーとなる項目を指定。複数の項目を指定可能（省略時：全てのレコードの新規作成）
KeyNotFoundCreate キーと一致するレコードが無い場合に新規作成します（省略時：true）
Data レコードの配列


指定するキー項目について
指定したキー項目をもとにAPIによるレコード作成・更新(upsert)を行います。キー項目の指定は以下のパラメータで指定します。
キー項目の指定が無い場合は全てのレコードの新規作成を行います。
詳細につきましては、下記の (a)キーが無い場合、(b)単一キーの場合、(c)複合キーの場合 をご参照ください。


APIによる画像の挿入について
BodyにImageHashを指定することで「内容」「コメント」「説明」項目に画像を挿入することが可能です。 更新系のAPI（update／upsert）で本機能によるレコード更新を行う場合、既存レコードの該当項目は「内容」「説明」項目では上書き、「コメント」項目では追加となります。また、更新系のAPIで「内容」「説明」項目に登録する文字列を指定するBodyやDescriptionHashを省略した状態でImageHashのみを指定すると、上書きではなく追加となります。

＜ImageHashの指定方法＞

第1階層 第2階層 第3階層 説明 例
ImageHash Body HeadNewLine 画像を挿入する際の先頭の改行有無をtrue/falseで指定します。省略した場合は改行無しになります。 true
EndNewLine 画像を挿入する際の末尾の改行有無をtrue/falseで指定します。省略した場合は改行無しになります。 true
Position 同じリクエスト内で対象項目に文字列を設定する場合に画像を何文字目に挿入するかを数値で指定します。-1を指定した場合および省略した場合は末尾に挿入されます。 3
Alt alt属性（Webブラウザで画像が表示できないときに、画像の代わりに表示されるテキスト）に挿入する文字列を指定します。省略した場合は「image」が設定されます。 hayato
Extension Binariesテーブルに登録するファイル拡張子を指定します。省略した場合は「.png」が設定されます。 .jpeg
Base64 Base64エンコードした画像のバイナリデータを文字列で指定します。ImageHashを指定する場合、省略はできません。 iVBORw0KG…（以下略）
Comments （同上） （同上） -
DescriptionA （同上） （同上） -
DescriptionB （同上） （同上） -

 

APIによるプロセスの実行について
リクエストデータに、プロセスIDを指定し、プロセスを実行することが可能です。

■事前準備
事前に「プロセス」を設定してください。

■制限事項
APIからプロセスを実行する場合、プロセスで設定した入力検証は適用されません。

＜プロセスの指定方法＞

設定項目 説明 例
ProccessId プロセスのIDを指定します。 1

 

(a)キーが無い場合
Keys パラメータが無い場合には、全てのレコードを新規作成します。
KeyNotFoundCreate パラメータの値は無視されます。

{
    "ApiVersion": 1.1,
    "ApiKey": "145Afa9AF2A10SafaA21641...",
    "Data": [
        {
            "Title": "新機能XXを開発する1",
            "Body": "ボディ1",
            "CompletionTime": "2023/3/31",
            "ProcessId": 1,
            "ClassHash": {
                "ClassA": "RC0001",
                "ClassB": "分類２"
            },
            "NumHash": {
                "NumA": 100
            },
            "DateHash": {
                "DateA": "2024/01/01"
            },
            "DescriptionHash": {
                "DescriptionA": "説明1"
            },
            "CheckHash": {
                "CheckA": false
            },
            "ImageHash": {
                "Body": {
                    "HeadNewLine": true,
                    "EndNewLine": true,
                    "Position": 3,
                    "Alt": "imageBody",
                    "Extension": ".jpeg",
                    "Base64": "iVBORw0KG..."
                },
                "DescriptionA": {
                    "HeadNewLine": true,
                    "EndNewLine": true,
                    "Position": 3,
                    "Alt": "imageDescriptionA",
                    "Extension": ".jpeg",
                    "Base64": "iVBORw0KG..."
                }
            }
        },
        {
            "Title": "新機能XXを開発する2",
            "Body": "ボディ2",
            "CompletionTime": "2023/3/31",
            "ProcessId": 1,
            "ClassHash": {
                "ClassA": "RC0002",
                "ClassB": "分類３"
            },
            "NumHash": {
                "NumA": 100
            },
            "DateHash": {
                "DateA": "2024/01/01"
            },
            "DescriptionHash": {
                "DescriptionA": "説明2"
            },
            "CheckHash": {
                "CheckA": false
            }
        }
    ]
}

 

 

(b)単一キーの場合

Keys パラメータにキーとなる項目の項目名を配列形式で設定します。Keys に指定した項目について、パラメータで指定した値と一致するレコードを検索します。
下記の例では、１つ目のレコード「ClassA」項目の値が "RC0001" のレコードを検索します。 ２つ目のレコード「ClassA」項目の値が "RC0002"のレコードを検索します。
レコードを検索した結果に応じて下記の処理が実行されます。

  1. 対象のレコードが存在しなかった場合: レコードが新規作成されます。ただしKeyNotFoundCreateパラメータがfalseの場合は新規作成されません。
  2. 対象のレコードが１件存在した場合: そのレコードが更新されます。
  3. 対象のレコードが複数件存在した場合: レコードの作成・更新は行われず、エラーレスポンスが返却されます。

{
    "ApiVersion": 1.1,
    "ApiKey": "145Afa9AF2A10SafaA21641...",
    "Keys": [
        "ClassA"
    ],
    "KeyNotFoundCreate": true,
    "Data": [
        {
            "Title": "新機能XXを開発する1",
            "Body": "ボディ1",
            "CompletionTime": "2023/3/31",
            "ProcessId": 1,
            "ClassHash": {
                "ClassA": "RC0001",
                "ClassB": "分類２"
            },
            "NumHash": {
                "NumA": 100
            },
            "DateHash": {
                "DateA": "2024/01/01"
            },
            "DescriptionHash": {
                "DescriptionA": "説明1"
            },
            "CheckHash": {
                "CheckA": false
            },
            "ImageHash": {
                "Body": {
                    "HeadNewLine": true,
                    "EndNewLine": true,
                    "Position": 3,
                    "Alt": "imageBody",
                    "Extension": ".jpeg",
                    "Base64": "iVBORw0KG..."
                },
                "DescriptionA": {
                    "HeadNewLine": true,
                    "EndNewLine": true,
                    "Position": 3,
                    "Alt": "imageDescriptionA",
                    "Extension": ".jpeg",
                    "Base64": "iVBORw0KG..."
                }
            }
        },
        {
            "Title": "新機能XXを開発する2",
            "Body": "ボディ2",
            "CompletionTime": "2023/3/31",
            "ProcessId": 1,
            "ClassHash": {
                "ClassA": "RC0002",
                "ClassB": "分類３"
            },
            "NumHash": {
                "NumA": 100
            },
            "DateHash": {
                "DateA": "2024/01/01"
            },
            "DescriptionHash": {
                "DescriptionA": "説明2"
            },
            "CheckHash": {
                "CheckA": false
            }
        }
    ]
}

 

(c)複合キーの場合
Keys パラメータに複数の項目名を設定した場合、Keys に指定したすべての項目について、パラメータで指定した値と一致するレコードを検索します。
下記の例では、１つ目のレコード「ClassA」項目の値が "RC0001" かつ、「ClassB」項目の値が "001" のレコードを検索します。 ２つ目のレコード「ClassA」項目の値が "RC0001" かつ、「ClassB」項目の値が "002" のレコードを検索します。

  1. 対象のレコードが存在しなかった場合: レコードが新規作成されます。ただしKeyNotFoundCreateパラメータがfalseの場合は新規作成されません。
  2. 対象のレコードが１件存在した場合: そのレコードが更新されます。
  3. 対象のレコードが複数件存在した場合: レコードの作成・更新は行われず、エラーレスポンスが返却されます。
{
    "ApiVersion": 1.1,
    "ApiKey": "145Afa9AF2A10SafaA21641...",
    "Keys": [
        "ClassA",
        "ClassB"
    ],
    "KeyNotFoundCreate": true,
    "Data": [
        {
            "Title": "新機能XXを開発する1",
            "Body": "ボディ1",
            "CompletionTime": "2023/3/31",
            "ProcessId": 1,
            "ClassHash": {
                "ClassA": "RC0001",
                "ClassB": "001"
            },
            "NumHash": {
                "NumA": 100
            },
            "DateHash": {
                "DateA": "2024/01/01"
            },
            "DescriptionHash": {
                "DescriptionA": "説明1"
            },
            "CheckHash": {
                "CheckA": false
            },
            "ImageHash": {
                "Body": {
                    "HeadNewLine": true,
                    "EndNewLine": true,
                    "Position": 3,
                    "Alt": "imageBody",
                    "Extension": ".jpeg",
                    "Base64": "iVBORw0KG..."
                },
                "DescriptionA": {
                    "HeadNewLine": true,
                    "EndNewLine": true,
                    "Position": 3,
                    "Alt": "imageDescriptionA",
                    "Extension": ".jpeg",
                    "Base64": "iVBORw0KG..."
                }
            }
        },
        {
            "Title": "新機能XXを開発する2",
            "Body": "ボディ2",
            "CompletionTime": "2023/3/31",
            "ProcessId": 1,
            "ClassHash": {
                "ClassA": "RC0001",
                "ClassB": "002"
            },
            "NumHash": {
                "NumA": 100
            },
            "DateHash": {
                "DateA": "2024/01/01"
            },
            "DescriptionHash": {
                "DescriptionA": "説明2"
            },
            "CheckHash": {
                "CheckA": false
            }
        }
    ]
}

 

■レスポンス
下記の形式のjsonデータが返却されます。

レコードが新規作成された場合

{
    "Id": 12345,
    "StatusCode": 200,
    "LimitPerDate": 10000,
    "LimitRemaining": 9994,
    "Message": "記録テーブル: 1 件追加し、0 件更新しました。"
}


レコードが更新された場合

{
    "Id": 12345,
    "StatusCode": 200,
    "LimitPerDate": 10000,
    "LimitRemaining": 9994,
    "Message": "記録テーブル: 0 件追加し、1 件更新しました。"
}

 

サイト単位でエラーとなった場合

{
    "Id": 12345,
    "StatusCode": 401,
    "Message": "認証できませんでした。"
}


レコード単位でエラーとなった場合

{
    "Id": 12345,
    "StatusCode": 500,
    "Message": "記録テーブル:エラーが発生しました。0 件追加し、0 件更新。\nIndex:1(ClassA=RC00011)\nエラー内容:条件に一致するレコードが複数存在します。"
}


500件を超えたレコードがあった場合

{
    "Id": 12345,
    "StatusCode": 500,
    "Message": "500 行を超えるデータは一度にインポートできません。"
}
  • はじめてご利用になる方へ
Powered by Zendesk