貼り付け一括登録プラグイン

使い方

kintone標準のCSV読み込みは「ファイル読み込み」の権限が必要なので、現場の一般ユーザーには使えないことがよくあります。ファイルのフィールドコードを正確に合わせる必要もあり、失敗したときに何が悪かったのか分かりにくいのも困りどころです。さらに「キーが一致したら更新、なければ追加」は標準ではできません。 このプラグインは、Excelからコピーした表を一覧画面にそのまま貼り付けて、列とフィールドを画面で対応づけ、全部の行を検証して見せてから、まとめて登録・更新します。どの行がどう間違っているかを日本語で先に出すので、失敗の原因がその場で分かります。 スマホでも同じように使えます。

1. 取り込み方法とキーを決める

   プラグインの設定画面で、次のことを決めます。

   1. 「取り込み方法」を選びます。

   　・追加のみ：貼り付けた行を、いつも新しいレコードとして作ります。

   　・更新のみ：キーが一致するレコードだけ直します。見つからない行はエラーにします。

   　・キーが一致したら更新・なければ追加：kintone標準の読み込みにはない動きです。

   2. 「追加のみ」以外を選んだときは、「キーにするフィールド」を決めます。文字列（1行）・数値・リンクと、レコード番号から選べます。アプリのフォーム設定で「値の重複を禁止する」にしておいてください。

   3. 「取り込んでよいフィールド」で、取り込み画面の選択肢に出すフィールドを絞れます。どれも選ばなければ、値を入れられるフィールドをすべて出します。

   4. 「ボタンを出す一覧」「ボタンの名前」「1回に取り込める行数」も決められます。

   レコード番号・作成者・更新日時・計算フィールド・自動計算の文字列・ルックアップのコピー先・添付ファイル・テーブルは、kintoneが値を受け付けないので最初から選択肢に出しません。ルックアップは、キーの値（例：取引先名）を入れれば、コピー先はkintoneが自動で埋めます。

   設定を保存したら「アプリを更新」を押してください。

2. Excelの表を貼り付けて、列をフィールドに対応づける

   一覧画面の上に出るボタンを押すと、取り込みの画面が開きます。

   1. Excelで表を選んでコピーし、貼り付け欄にCtrl+Vで貼り付けます。1行目がフィールド名の見出しなら「1行目は見出し」にチェックを入れたままにします。

   2. 「内容を読み取る」を押すと、列の対応づけの画面になります。見出しの名前とフィールド名が同じ列は、あらかじめ選ばれています。

   3. 選ばれていない列は、その列を入れるフィールドを選びます。取り込まない列は「（取り込まない）」のままにします。

   4. 「内容を確かめる」を押します。

   セルの中に改行が入った値も、Excelのコピーのまま貼り付けられます。タブ区切りが1つもないときは、カンマ区切り（CSVの文字列）として読みます。

3. 全部の行を確かめてから取り込む

   確認の画面に、1行ずつ「追加」「更新」「エラー」が出ます。

   ・追加：新しいレコードとして作ります。

   ・更新：キーが一致したレコードを直します。どのレコードを直すかも出ます。

   ・エラー：取り込めません。「金額：数値として読めません（「あいうえお」）。」のように、フィールド名と理由を日本語で出します。

   エラーが1行でもあると、取り込みボタンは出ません。kintoneはまとめての登録・更新で1件でも失敗すると全部が失敗するためです。貼り付け欄に戻って直すか、「エラーの◯行を取り除く」を押して、正しい行だけ取り込んでください。

   エラーが1つもなければ「この内容で取り込む」を押します。追加と更新をそれぞれ1回のリクエストで送り、終わったら件数を知らせて一覧を読み直します。