kintone ルックアップフィールドを更新する方法 フォローする
kintoneの仕様上、「ルックアップフィールド」を更新する場合、通常の認証設定とは異なり、2つのアプリ(更新対象アプリと参照先アプリ)のAPIトークンが必要になります。
そのため、ルックアップフィールドを更新しない場合の認証コネクタとは別途、新しく作成する必要があります。
本記事では、ルックアップフィールドの更新に対応したkintone認証コネクタの作成手順を解説します。
概要
ルックアップフィールドを更新する際、kintoneのAPIは以下の2つの権限を同時に要求します。
- 更新するアプリ(ルックアップフィールドがあるアプリ)の編集権限
- 参照先アプリ(コピー元のマスタアプリ)の閲覧権限
そのため、BizteX Connectの認証コネクタ設定時には、これら2つのAPIトークンをカンマ(,)区切りで設定する必要があります。
1. kintone側での準備(APIトークンの発行)
まず、関係する2つのアプリそれぞれでAPIトークンを発行します。
手順
- 更新するアプリ(A)の設定画面を開き、「設定」タブ > 「カスタマイズ/サービス連携」 > 「APIトークン」を選択します。
- 「生成する」をクリックし、「レコード閲覧」および「レコード編集」にチェックを入れます。
- 発行されたトークンをコピーし、メモ帳などに控えておきます(これをトークンAとします)。
- 「保存」し、「アプリを更新」します。
- 次に、参照先アプリ(B:マスタアプリ)の設定画面を開き、同様にAPIトークンを生成します。
- 参照先アプリでは、少なくとも「レコード閲覧」の権限が必要です。
- 発行されたトークンをコピーし、控えておきます(これをトークンBとします)。
- 「保存」し、「アプリを更新」します。
2. BizteX Connectでの認証コネクタ作成
BizteX Connectにて、kintone用の認証コネクタを作成します。
手順
- kintoneアクションの認証コネクタ選択ステップにて「新しいコネクタを作成する」から作成します。
- 以下の表に従って各項目を設定します。
| 設定項目 | 説明 | 入力例・注意点 | 必須 |
|---|---|---|---|
| 認証種別 | 使用する認証タイプを選択します。 | APIキー | ○ |
| タイトル | 任意の認証コネクタ名を入力します。 | 経費精算アプリ | ○ |
| トークン | kintoneアプリのAPIトークンを入力します。 重要: 手順1で控えた2つのトークンを半角カンマで区切って入力してください。 【入力形式】 [トークンA],[トークンB] | xxxxxxxxxxx,yyyyyyyyyyy※スペースは入れないでください | ○ |
| ドメイン | kintoneのドメイン名を入力します。 | cybozu.com | ○ |
| サブドメイン | kintoneのサブドメイン名を入力します。 | biztex | ○ |
| アプリID | 更新対象となるkintoneアプリのIDを入力します。 | 1 | ○ |
| basic認証 username | Basic認証のログイン名(設定している場合のみ)。 | username | - |
| basic認証 password | Basic認証のパスワード(設定している場合のみ)。 | password | - |
入力が完了したら「保存」をクリックします。
よくあるエラーと対処法
シナリオ実行時にエラーが発生する場合は、以下をご確認ください。
エラー:フィールド情報を取得出来ませんでした (GAIA_IA02)
HTTPエラー: Bad Request{"code":"GAIA_IA02", "message":"指定したAPIトークンは、アプリで生成されたトークンと異なります。..."}
- 原因:
- 入力したAPIトークンが間違っている。
- または、kintone側でAPIトークンを生成・保存したものの、「アプリを更新」ボタンを押しておらず、設定が反映されていない可能性があります。
- 対処:
- BizteX Connectに入力したトークンに不要なスペースなどが含まれていないか確認してください。
- kintoneのアプリ設定画面に戻り、画面右上の「アプリを更新」をクリックして設定を本番環境に反映させてから、再度実行してください。