銀行・支店の入力と点検を、kintoneで。
検索や名称からの候補確認で銀行・支店情報を入力し、保存済みレコードも点検できます。PC向けのプラグインです。
ダウンロード
バージョン 0.1.15 / プラグイン名 BankcodeJP for kintone
公開時のファイル名:bankcodejp-kintone-0.1.15-signed.zip(22,988 bytes)。ZIPは解凍せず、そのままkintoneへ読み込みます。
- SHA-256
0f786ad610e89d39d04a2fb6fd046299e7808475e2f02dc713ad08aced141da7- プラグインID
pijfglafjhhahnahgfpmgmlokkhajndf
ダウンロードしたファイルを確認する
ZIPとSHA256SUMSを同じフォルダーに保存して、ファイル名とハッシュを照合します。一致しなければ読み込まず、再取得してください。
macOS:
shasum -a 256 -c SHA256SUMS
Windows PowerShell:
Get-FileHash .\bankcodejp-kintone-0.1.15-signed.zip -Algorithm SHA256
Windowsでは表示されたハッシュを、このページのSHA-256と比較してください。
プラン・利用上限
Consoleの料金プランでBankcodeJP for kintoneを契約します。Search APIや銀行・支店選択ウィジェットとは別のサービスです。
| プラン | 料金(税別) | 銀行・支店検索 | Resolve(名称から候補確認) | 一覧点検 |
|---|---|---|---|---|
| Free | 0円 | 50回/日・1回/秒 | 3回/日・1回/秒 | 1操作100件まで |
| Standard | 月額4,980円/年額59,760円 | 5,000回/日・5回/秒 | 300回/日・2回/秒 | 1操作100件まで |
同じアカウントのkintone用Public Client・アプリでAPI利用枠を共有します。日次枠は日本時間9時にリセットされます。通常Search APIのAPIキーの利用枠とは別です。
一覧点検の100件は、1操作で選べるレコード数の上限です。APIの残枠を増やすものではなく、検索・Resolveの上限に達すると停止します。
導入前の準備
- プラグインが利用できるkintoneの契約コースをご用意ください。ライトコースでは利用できません。
- kintoneシステム管理者がZIPを登録し、アプリ管理者が利用するアプリに追加・設定します。
- 既存プラグインとの組み合わせは、検証用アプリで確認してから業務アプリへ適用してください。
- 既に同じIDのプラグインをお使いの場合は、手動更新へ進んでください。
初回導入
- 署名済みZIPを取得して確認します。
- kintoneの歯車メニューから「kintoneシステム管理」→「プラグイン」→「読み込む」を開き、ZIPをそのまま選択します。
- 一覧に「BankcodeJP for kintone」、バージョン「0.1.15」が表示されたことを確認します。
- 対象アプリの「アプリの設定」→「設定」→「プラグイン」で追加します。
登録しただけでは入力補助は使えません。続いてPublic Clientと項目対応を設定します。
初期設定
1. Public Clientを作成する
- ConsoleのPublic Clientで「作成」を選びます。
- 用途が分かる名前を付け、利用環境を選びます。機能は「銀行・支店入力・点検(kintone)」を選択してください。
- 許可するWebサイト(Origin)に
https://{subdomain}.cybozu.comを登録します。例:https://example.cybozu.com。/k/1/などのパスは付けません。 - 作成直後に表示されるPublic Keyを控えます。Public Keyはこのときだけ表示されます。
APIキーを入力する欄ではありません。Public Keyを紛失した場合は新しいClientを作成し、不要になったClientを無効化してください。
2. フォームの項目を用意する
ボタンを置く「スペース」と、次の文字列(1行)フィールドを用意します。フィールドコードの例は自由に変更できます。
| 項目 | フィールドコードの例 | 必須 |
|---|---|---|
| ボタンを表示するスペース | bankcodejpSpace(スペースの要素ID) | 必須 |
| 銀行コード | bankCode | 必須 |
| 銀行名 | bankName | 必須 |
| 銀行名カナ | bankKana | 任意 |
| 支店コード | branchCode | 必須 |
| 支店名 | branchName | 必須 |
| 支店名カナ | branchKana | 任意 |
コードも文字列で保存し、先頭の0を保持します。テーブル内・自動計算・ルックアップとそのコピー先は対象外です。同じフィールドを複数の項目へ割り当てないでください。
3. 設定を保存してアプリを更新する
- 対象アプリのプラグイン設定を開き、Public Key、表示スペース、銀行・支店の項目対応を選びます。
- 「設定を保存」を押します。
- アプリの設定へ戻り、「アプリを更新」を実行します。
使い方・動作確認
- レコードの編集画面で「銀行・支店を検索」を開き、銀行と支店を選び、「この銀行・支店を入力」で反映します。
- 名称から調べる場合は「名称から候補を確認」を開き、候補と反映する値を確認して「確認した内容を反映」を選びます。
- 反映後にkintoneの通常の「保存」を押し、レコードを開き直して値が残っていることを確認します。プラグインは自動保存しません。
- 一覧の「複数レコードをチェック」で、表示中のページから対象を選びます。設定の確認後に表示される上限は、Free・Standard共通で1操作100件です。一覧からの自動書き換えは行いません。
銀行・支店マスターの候補確認・照合です。口座の実在や口座名義を確認するものではありません。
手動更新
新しい版のZIPを管理者が読み込んで更新します。このZIP配布版に自動更新や新版の通知機能はありません。このページの変更履歴をご確認ください。
- システム管理のプラグイン一覧で、現在のバージョンと同じIDを使っているアプリを確認します。利用アプリの確認方法
- 現在の公開キー・表示スペース・項目対応を控え、変更履歴と新しいZIPのハッシュを確認します。
- システム管理の「プラグイン」→「読み込む」から、新しい版の署名済みZIPを読み込みます。既存プラグインを削除する必要はありません。
- バージョンとIDが正しいこと、各アプリの設定が維持されていることを確認します。項目設定を変更した場合は、設定保存後に「アプリを更新」を実行します。
- レコードを開き直し、検索・反映・通常保存を確認します。
同じIDの更新は、そのkintone環境で同じプラグインを使うアプリに及びます。APIの銀行・支店マスターの日々の更新だけで、プラグインを入れ直す必要はありません。
変更履歴
0.1.15
- 名称・説明から「開発版」表記を削除しました。
- 0.1.14の社内検証版と同じプラグインID・設定項目を維持しています。
- 検索・Resolve・点検の機能と利用上限の変更はありません。
配布状況はダウンロード欄をご確認ください。ファイル名が同じまま内容を差し替える更新は行いません。
無効化・復旧
- 対象アプリの「アプリの設定」→「設定」→「プラグイン」を開きます。
- BankcodeJP for kintoneの「無効にする」を選び、アプリの設定へ戻ります。
- 「アプリを更新」を実行してからレコードを開き直し、通常の閲覧・保存ができることを確認します。
無効化は設定を保持してプラグインの動作を止めます。必要なら同じ手順で有効に戻せます。ダウンロードの停止だけでは、導入済みプラグインは止まりません。
古いZIPへの上書きダウングレードは復旧手順に含めていません。修正版が必要な場合は、同じIDの新しい版をご案内します。kintone公式:無効化の手順
困ったとき
- ボタンが出ない:スペースの要素ID、プラグインの有効状態、設定保存後の「アプリを更新」を確認します。
- 認証・利用権エラー:Public Clientが有効か、kintone機能・Origin・契約が正しいか確認します。
- 上限エラー(429):画面の案内に従って待ちます。秒間上限と日次上限は別に適用されます。
BankcodeJPに問い合わせる。バージョン、エラー表示、発生時刻をお知らせください。認証トークンや業務レコード全文を送る必要はありません。