レコードの追加(複数件)

にメンテナンス済み

kintone は豊富な API を提供しており、これを活用することでアプリケーションのデータをプログラムから直接操作することが可能です。

特に、REST API は HTTP リクエストを通じて kintone のデータを操作するための強力なツールです。

このページでは、kintone の REST API を使用して、特定のレコードを 複数件追加する方法について詳しく解説します。

レコードを 1 件だけ追加する場合は、エンドポイントが異なります。詳細は以下のページを参照してください。

kintone から利用する場合

kintone の JavaScript カスタマイズとして REST API を実行する場合、用意されている JavaScript API を使用することで、簡単に REST API を実行することができます。

JavaScript API のkintone.api.urlメソッドを使用することで、実行されるスペースを意識することなく、REST API のエンドポイントを取得することができます。

汎用的な関数の定義
/**
 * kintone REST APIを使用して、アプリにレコードを複数件追加する
 *
 * @param { Object } params
 * @param { string | number } params.app - アプリID
 * @param { Record<string, any>[] } params.records - 追加するレコード情報
 * @return { Promise<{ id: string[]; revision: "1"[] }> } - 追加したレコードのIDとリビジョン番号
 */
const addRecords = (params) => {
  const { app, records } = params;
  return kintone.api(kintone.api.url('/k/v1/records.json', true), 'POST', { app, records });
};

レコードを 1 件だけ追加する場合は、record.jsonを指定しますが、複数件だけ追加する場合は、records.jsonを指定する点に注意してください。

引数には、追加先のアプリ ID と、追加したいレコードの情報を指定します。

追加に成功した場合は、idプロパティとrevisionプロパティを持つオブジェクトが返されます。

10件のレコードを追加する
(() => {
  const addRecords = (params) => {
    /** 省略 */
  };

  kintone.events.on(['app.record.detail.show'], async (event) => {
    const appId = kintone.app.getId();
    await addRecord({
      app: appId,
      records: new Array(10).fill('').map((record, i) => ({ フィールドコード: { value: i } })),
    });
    return event;
  });
})();
ダイアログに入力された情報を使ってレコードを登録する
(() => {
  const addRecords = (params) => {
    /** 省略 */
  };

  kintone.events.on(['app.record.index.show'], async (event) => {
    const input = prompt('登録するレコード情報を入力してください');
    const appId = kintone.app.getId();
    await addRecords({
      app: appId,
      records: new Array(10).fill('').map((record, i) => ({ フィールドコード: { value: `${input}-${i}` } })),
    });
    return event;
  });
})();

kintone 以外から利用する場合

kintone の REST API は、Excel や GAS、Node.js など、様々な環境から利用することができます。

REST API を使用することで、kintone 以外の環境から kintone のデータを使用して、アプリケーションを動作させることが可能です。

APIトークンを使用しましょう

kintone 以外の環境から kintone のデータを取得する場合、認証情報をリクエストに含める必要があります。

認証情報にはいくつかの種類がありますが、API トークンを選択することで、セキュリティを確保しつつ、簡単に認証情報を取得することができます。

最も簡単に使用できるのは ID とパスワードを使用した方法ですが、セキュリティ上のリスクがあるため、必要最小限の権限を付与した API トークンを使用することをおすすめします。

Node.js を使用した場合

Node.js から kintone の REST API を使用する場合、ブラウザで JavaScript を実行するのとほとんど同じコードで、HTTP リクエストを送信することができます。

/**
 * kintone REST APIを使用して、アプリにレコードを複数件追加する
 *
 * @param { Object } params
 * @param { string | number } params.app - アプリID
 * @param { Record<string, any>[] } params.records - 追加するレコード情報
 * @return { Promise<{ id: string[]; revision: "1"[] }> } - 追加したレコードのIDとリビジョン番号
 */
const addRecords = (params) => {
  const { app, records } = params;
  const url = `https://__your_subdomain__.cybozu.com/k/v1/records.json`;
  const options = {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Cybozu-API-Token': 'YOUR_API_TOKEN',
    },
    body: JSON.stringify({ app, records }),
  };
  return fetch(url, options).then((response) => response.json());
};

__your_subdomain__の部分と、YOUR_API_TOKENの部分を、それぞれご自身の環境に合わせて変更してください。

引数として設定しても良いですが、関数内で直接設定しても問題ありません。

前述した kintone から利用するコードと異なり、参照先のアプリがゲストスペースである場合は、URL を変更する必要があります。

GAS を使用した場合

Google Apps Script (GAS) から kintone の REST API を使用する場合、UrlFetchAppクラスを使用することで、HTTP リクエストを送信することができます。

GASを使用した場合のサンプルコード
/**
 * kintone REST APIを使用して、アプリにレコードを複数件追加する
 *
 * @param { Object } params
 * @param { string | number } params.app - アプリID
 * @param { Record<string, any>[] } params.records - 追加するレコード情報
 * @return { Promise<{ id: string[]; revision: "1"[] }> } - 追加したレコードのIDとリビジョン番号
 */
const addRecords = (params) => {
  const { app, records } = params;
  const url = `https://__your_subdomain__.cybozu.com/k/v1/records.json`;
  const options = {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-Cybozu-API-Token': 'YOUR_API_TOKEN',
    },
    payload: JSON.stringify({ app, records }),
  };
  const response = UrlFetchApp.fetch(url, options);
  return JSON.parse(response.getContentText());
};

制限事項

kintone でレコードを複数件追加する場合、以下の制限事項があります。

  • 1 回のリクエストで登録できるレコード数は最大 100 件

この制限を意識することなく追加する方法については、以下のページを参照してください。

#kintone #JavaScript #TypeScript