このプラグインでできること
「添付ファイルコピープラグイン」は、別のアプリに登録されている添付ファイルを、現在のレコードへコピーするプラグインです。
レコードの詳細画面に専用のボタンを設置します。
ボタンを押すと、設定した絞り込み条件に一致するレコードを別アプリから探します。
見つかったレコードの添付ファイルを一覧表示し、必要なファイルだけを選んでコピーできます。
主な機能は次のとおりです。
- 別アプリのレコードを複数の条件で絞り込み、添付ファイルを取得します。条件には、いま開いているレコードの値・固定値・ログインユーザーを使えます。
- 取得元の添付ファイルフィールドを複数指定できます。条件に一致するレコードが複数あっても構いません。
- 取得したファイルを一覧から選び、必要なものだけをコピーします。
- 保存先の添付ファイルフィールドと、追加するか上書きするかを選べます。設定で固定することも、使うときに選ばせることもできます。
- ボタンの配置場所・名称・デザイン(色、余白、角丸、枠線など)を設定できます。
- 設定はタブ形式で複数登録できます。1つの設定につき、1つのボタンが表示されます。
- パソコンとスマートフォンの両方で利用できます。
💡 このプラグインは、kintone標準の「ルックアップ」に近い動きをします。違いは、コピーする対象が文字列や数値ではなく「添付ファイル」である点と、1つのキーではなく複数の条件でレコードを探せる点です。
動作環境・前提条件
2-1. このアプリ(コピー先)に必要なもの
このプラグインを設定するアプリには、次の3つが必要です。
| 必要なもの | 用途 | 補足 |
|---|---|---|
| スペースフィールド | ボタンを表示する場所 | フォームの編集画面で「要素ID」を設定してください |
| キーとなるフィールド | 取得元アプリのレコードを探す条件 | 「文字列 (1行)」または「数値」 |
| 添付ファイルフィールド | コピーしたファイルの保存先 | 複数ある場合は設定で選択します |
⚠️ スペースフィールド(フォームに空白の領域を作るフィールド)には、必ず「要素ID」を設定してください。要素IDが空欄のスペースは、設定画面の選択肢に表示されません。
スペースフィールドに要素IDを設定する手順
- 「アプリの設定」の「フォーム」を開きます。
- フォームに配置した「スペース」の歯車アイコンをクリックします。
- 表示されたメニューで「設定」をクリックします。
- 「要素ID」に、半角英数字で任意のIDを入力します。
- 「保存」をクリックします。
- フォームの編集画面で「アプリを更新」をクリックします。
スペースの設定画面で「要素ID」を入力する
2-2. 取得元アプリ(コピー元)に必要なもの
ファイルの取得元になるアプリには、次のものが必要です。
- 添付ファイルフィールド(取り出したいファイルが入っているフィールド)
- 絞り込みに使うフィールド(どのレコードから取り出すかを決めるための条件に使います)
絞り込みに使えるフィールドの種類は次のとおりです。フィールドの重複を禁止する設定は不要です。
| 種類 | 使える条件 |
|---|---|
| 文字列(1行)・文字列(複数行)・リッチエディター・リンク | 等しい/等しくない/含む/含まない/空である/空でない |
| 数値・計算・レコード番号 | =/≠/>/</≧/≦/空である/空でない |
| 日付・日時・時刻・作成日時・更新日時 | =/≠/>/</≧/≦/空である/空でない |
| ドロップダウン・ラジオボタン・チェックボックス・複数選択・ステータス | いずれかを含む/いずれも含まない |
| ユーザー選択・組織選択・グループ選択・作成者・更新者・作業者 | いずれかを含む/いずれも含まない |
💡 条件に一致するレコードが複数あっても構いません。一致したすべてのレコードの添付ファイルが、取得の候補として一覧に並びます。
💡 レコード番号も条件に使えます。クエリ上は kintone のレコード番号($id)として扱われます。
2-3. アクセス権
| 対象者 | 必要な権限 |
|---|---|
| 設定する方 | このアプリの「アプリ管理権限」と、取得元アプリのレコードを閲覧できる権限 |
| ボタンを使う方 | 取得元アプリのレコードと添付ファイルを閲覧できる権限、このアプリのレコードを編集できる権限(保存先の添付ファイルフィールドを含む) |
⚠️ 取得元アプリのアクセス権がない場合、ファイルの取得に失敗します。取得元アプリの「アプリの設定」で、利用者のアクセス権をご確認ください。
⚠️ ファイルのコピーは、このレコードを更新して行います。このアプリのレコードを編集できない方は、ファイルを保存できません。
2-4. 対応する画面(PC版・モバイル版)
| 画面 | 動作 |
|---|---|
| レコードの詳細画面(PC版) | ボタンが表示され、利用できます |
| レコードの詳細画面(モバイル版) | ボタンが表示され、利用できます(設定はPC版と共通) |
| レコードの一覧画面・追加画面・編集画面 | ボタンは表示されません |
設定画面は、PC版のアプリの設定から開きます。
設定手順
3-1. 設定画面の全体構成
設定画面は、次の手順で開きます。
- 対象のアプリを開き、画面右上の歯車アイコンから「アプリの設定」を開きます。
- 「設定」タブの「プラグイン」を選びます。
- 一覧から「添付ファイルコピープラグイン」の歯車アイコンをクリックします。
設定画面は、上から次の3つの領域に分かれています。
| 領域 | 内容 |
|---|---|
| ヘッダー | 「設定保存」ボタンと、右端の閉じるボタン |
| タブバー | 登録した設定のタブと「+設定を追加」 |
| 設定パネル | 選択中のタブの設定内容 |
設定を1件も登録していない場合、パネルには「設定がありません。「設定を追加」から作成してください。」と表示されます。
設定が1件もないときの設定画面
💡 画面を開いた直後は「読み込み中...」と表示されます。アプリとフィールドの情報を読み込んでいる状態です。数秒お待ちください。
3-2. 設定を追加する
- 設定画面のタブバーで「+設定を追加」をクリックします。
- 新しいタブが追加され、そのタブの設定パネルが表示されます。
設定を追加したときの設定パネル
💡 1つの設定が、レコード詳細画面の1つのボタンに対応します。取得元アプリごとにボタンを分けたい場合は、設定を複数追加してください。
3-3. 設定名を入力する
- 設定パネルの「設定名(タブ名)」に、この設定の名前を入力します。
入力した名前が、そのままタブの表示名になります。
💡 未入力の場合、タブ名は「設定1」「設定2」のように自動で表示されます。どの設定か分かるように、「見積書の添付取得」など具体的な名前を付けることをおすすめします。
「設定名(タブ名)」の入力欄
3-4. ボタン設定
「ボタン設定」では、レコード詳細画面に表示するボタンの場所・名前・見た目を決めます。
3-4-1. 配置するスペースフィールドを選ぶ
- 「ボタン設定」の「配置するスペースフィールド」をクリックします。
- 一覧から、ボタンを表示したいスペースの要素IDを選択します。
選択肢には、このアプリのフォームに配置されたスペースの要素IDが表示されます。
⚠️ スペースフィールドが1つもない場合、「スペースフィールドがありません」と表示されます。この場合は、先に「2-1. このアプリ(コピー先)に必要なもの」の手順で、スペースフィールドに要素IDを設定してください。
「配置するスペースフィールド」で要素IDを選ぶ
💡 複数の設定で同じスペースフィールドを選ぶこともできます。その場合、1つのスペースにボタンが並んで表示されます。
3-4-2. ボタン名を入力する
- 「ボタン名」に、レコード詳細画面に表示する文字を入力します。
初期値は「添付ファイル取得」です。
「ボタン名」の入力欄
3-4-3. ボタンデザインを設定する
「ボタンデザイン」で、ボタンの見た目を調整します。設定した内容は、すぐ下の「プレビュー」に反映されます。
設定できる項目は次のとおりです。
| 項目名 | 内容 | 初期値 |
|---|---|---|
| 背景色 | ボタンの背景の色 | 青緑色 |
| 文字色 | ボタンの文字の色 | 白 |
| 文字の太さ | 「B」を押すと文字が太字になります | 太字にしない |
| 角丸 | ボタンの角の丸み(px) | 4 |
| 内側の余白(パディング)の「縦」 | 文字の上下の余白(px) | 8 |
| 内側の余白(パディング)の「横」 | 文字の左右の余白(px) | 20 |
| 外側の余白(マージン)の「上」 | ボタンの上側の余白(px) | 4 |
| 外側の余白(マージン)の「下」 | ボタンの下側の余白(px) | 4 |
| 外側の余白(マージン)の「左」 | ボタンの左側の余白(px) | 0 |
| 外側の余白(マージン)の「右」 | ボタンの右側の余白(px) | 8 |
| 枠線をつける | チェックを入れると枠線が表示されます | チェックなし |
| 枠線の色 | 枠線の色(「枠線をつける」がONのときのみ表示) | 青緑色 |
| 枠線の太さ | 枠線の太さ(px。「枠線をつける」がONのときのみ表示) | 1 |
色を変更する手順
- 「背景色」の色見本をクリックします。
- 表示されたカラーピッカー(色を選ぶ画面)で色を選びます。
色見本をクリックすると開くカラーピッカー
余白や角丸を変更する手順
- 変更したい項目の入力欄をクリックします。
- 数値を入力します。
💡 単位はすべてpx(ピクセル)です。0以上の数値を入力してください。
枠線をつける手順
- 「枠線をつける」のチェックボックスにチェックを入れます。
- 表示された「枠線の色」で色を選びます。
- 「枠線の太さ」に数値を入力します。
「枠線をつける」にチェックを入れると、「枠線の色」「枠線の太さ」が表示される
プレビューで確認する
「プレビュー」には、設定した見た目のボタンが表示されます。
ボタン名が未入力の場合、プレビューには「ボタン」と表示されます。
「プレビュー」に表示されたボタン
3-5. 取得元アプリ・絞り込み条件
どのアプリの、どのレコードから、どの添付ファイルを取り出すかを決めます。
3-5-1. 取得元アプリを選ぶ
「取得元アプリ」で、ファイルの取得元にするアプリを選びます。
- 「取得元アプリ」の欄をクリックします。
- アプリ名の一部を入力すると、候補が絞り込まれます。
- 一覧から選びます。
取得元アプリと絞り込み条件
⚠️ 取得元アプリを変更すると、下の「絞り込み条件」と「取得する添付ファイルフィールド」で選んだ内容がすべてリセットされます。設定し直してください。
⚠️ 「取得元アプリのフィールド取得に失敗しました(アクセス権をご確認ください)」と表示された場合、選んだアプリのフィールド情報を読み取れていません。そのアプリのアクセス権をご確認ください。
3-5-2. 絞り込み条件を設定する
取得元アプリのどのレコードからファイルを取り出すかを、条件で指定します。条件は何件でも追加できます。
- 「+ 条件を追加」をクリックします。
- 左から順に「フィールド」「条件」「値の種類」「値」を指定します。
| 欄 | 内容 |
|---|---|
| フィールド | 取得元アプリのフィールド。選んだフィールドの種類に応じて、使える条件が変わります |
| 条件 | 「等しい」「含む」「いずれかを含む」など(2-2の表を参照) |
| 値の種類 | 「このアプリのフィールド」「固定値」「ログインユーザー」から選びます |
| 値 | 値の種類に応じた入力欄が出ます |
値の種類
| 値の種類 | 内容 |
|---|---|
| このアプリのフィールド | いま開いているレコードの値と比べます。初期値はこちらです。レコード番号・作成者・作成日時なども選べます |
| 固定値 | 決まった値と比べます。日付は日付の入力欄、選択肢のフィールドは選択肢のチェック、ユーザー選択などは一覧から選ぶ欄になります |
| ログインユーザー | ボタンを押した方で比べます。ユーザー選択・組織選択・グループ選択・作成者・更新者・作業者のときだけ選べます |
💡 「このアプリのフィールド」を使うと、レコードごとに違う条件でファイルを探せます。たとえば「取得元の案件番号 = このアプリの案件番号」のように設定します。
💡 「固定値」を使うと、すべてのレコードで同じ条件になります。たとえば「取得元の種別 いずれかを含む 見積書」のように、決まった分類のレコードだけを対象にできます。
💡 「空である」「空でない」を選んだときは、値の指定は不要です。
条件が2件以上あるとき
条件が2件以上になると、条件の上に接続のしかたが表示されます。
- すべての条件を満たす(かつ) … 全部の条件に当てはまるレコードだけが対象になります
- いずれかの条件を満たす(または) … どれか1つでも当てはまるレコードが対象になります
⚠️ 接続のしかたは、条件ごとではなく条件全体で1つです。「かつ」と「または」を混ぜることはできません。
条件を削除するときは、行の右端にある「×」をクリックします。
3-5-3. 取得する添付ファイルフィールドを選ぶ
取得元アプリの、どの添付ファイルフィールドからファイルを取り出すかを選びます。複数選択できます。
取得する添付ファイルフィールド。チェックしたフィールドが対象になる
- 取り出したい添付ファイルフィールドをクリックして、チェックを入れます。
- 複数のフィールドを選ぶと、どのフィールドのファイルかが分かるように、取得の画面で見出しが付きます。
⚠️ 1つもチェックしていないと、設定を保存できません。
⚠️ 取得元アプリに添付ファイルフィールドがない場合、「取得元アプリに添付ファイルフィールドがありません」と表示されます。この場合は、先にアプリのフォームに添付ファイルフィールドを追加してください。
3-5-4. 保存先を設定する
コピーしたファイルを、このアプリのどの添付ファイルフィールドに、どのように保存するかを決めます。
保存先の設定。「保存時に選択する」と「固定する」を選べる
まず、保存先を使う人に選ばせるかどうかを決めます。
| 選択肢 | 動き |
|---|---|
| 保存時に選択する | ボタンを押したあとの画面で、保存先と保存のしかたを選べます。下で指定した内容が、その画面の初期値になります |
| 固定する | ボタンを押すと、下で指定した保存先・保存のしかたでそのまま保存します。使う人は変更できません |
次に、保存先の内容を指定します。
| 欄 | 内容 |
|---|---|
| 保存先の添付ファイルフィールド | コピーしたファイルを保存する、このアプリの添付ファイルフィールド |
| 保存のしかた | 「追加する(既存を残す)」または「上書きする(既存を削除)」 |
- 追加する … 保存先に元々あるファイルを残したまま、選んだファイルを後ろに足します。
- 上書きする … 保存先に元々あるファイルをすべて削除して、選んだファイルに差し替えます。
⚠️ 「上書きする」を選ぶと、保存先に元々あったファイルは削除されます。元に戻せません。
⚠️ 「固定する」を選んだときは、「保存先の添付ファイルフィールド」が必須になります。未選択のままでは設定を保存できません。
3-6. 設定を保存する
- 設定画面の上部にある「設定保存」をクリックします。アプリの更新まで自動で行います。
- 「設定を保存して、アプリを更新しました」と表示されたら完了です(「アプリを開く」でアプリへ、「設定を続ける」で設定画面に残ります)。
保存中は、画面中央に「設定を保存しています…」「アプリを更新しています…」と表示されます。
アプリの設定画面で改めて「アプリを更新」を押す必要はありません。
ヘッダー左の「設定保存」
💡 キーボードの「Ctrl」キーを押しながら「S」キーを押しても保存できます(Mac は「command」キーと「S」キー)。
入力に不足がある場合
必須項目が未入力の場合、保存されません。
画面右上に「「設定1」の入力が不足しています:ボタン名、取得元アプリ」のようなメッセージが表示されます。
同時に、不足がある設定のタブへ自動で切り替わります。
必須項目は次のとおりです。
| 必須項目 | メッセージ内の表記 |
|---|---|
| 配置するスペースフィールド | 配置するスペース |
| ボタン名 | ボタン名 |
| 取得元アプリ | 取得元アプリ |
| 絞り込み条件(1件以上) | 絞り込み条件 |
| 取得する添付ファイルフィールド(1つ以上) | 取得する添付ファイルフィールド |
| 保存先の添付ファイルフィールド(「固定する」のときのみ) | 保存先の添付ファイルフィールド |
条件の中身に不足があるときは、「「設定1」の条件1:フィールドを選択してください」のように、何件目のどこが足りないかが表示されます。
入力が不足しているときのメッセージ
⚠️ 「設定は保存しましたが、アプリを更新できませんでした」と表示された場合、設定内容は保存されていますが、運用環境へ反映されていません。「アプリの設定に戻る」をクリックし、アプリの設定画面で「アプリを更新」をクリックして反映してください。
3-7. 設定を切り替える・削除する
設定を切り替える手順
- 画面上部のタブバーで、表示したい設定のタブをクリックします。
設定ごとのタブ
設定を削除する手順
- 削除したい設定のタブにある「×」をクリックします。
- 「この設定を削除しますか?」という確認画面が表示されます。
- 「削除する」をクリックします。
「この設定を削除しますか?」の確認画面
⚠️ 削除後は「設定保存」をクリックしてください。保存するまで、削除内容はレコード画面に反映されません。
💡 削除をやめる場合は、確認画面で「キャンセル」をクリックします。
3-8. 設定画面を閉じる
- 画面右上の「×」をクリックします。
前の画面に戻ります。
⚠️ 保存していない変更は破棄されます。閉じる前に必ず「設定保存」をクリックしてください。
3-9. 設定項目の一覧
| 項目名 | 必須 | 初期値 | 内容 |
|---|---|---|---|
| 設定名(タブ名) | — | 設定1、設定2…(追加した順) | タブに表示する設定の名前 |
| 配置するスペースフィールド | 必須 | なし | ボタンを表示するスペースの要素ID |
| ボタン名 | 必須 | 添付ファイル取得 | ボタンに表示する文字 |
| ボタンデザイン | — | 「3-4-3. ボタンデザインを設定する」の表のとおり | 背景色・文字色・文字の太さ・角丸・余白・枠線 |
| 取得元アプリ | 必須 | なし | ファイルの取得元にするアプリ |
| 絞り込み条件 | 必須 | なし(1件以上) | どのレコードから取り出すかの条件。フィールド・条件・値の種類・値 |
| 条件の接続 | — | すべての条件を満たす(かつ) | 条件が2件以上のときの、全体の接続のしかた |
| 取得する添付ファイルフィールド | 必須 | なし(1つ以上) | ファイルを取り出す、取得元アプリの添付ファイルフィールド(複数可) |
| 保存先 | — | 保存時に選択する | 保存先を使う人に選ばせるか、固定するか |
| 保存先の添付ファイルフィールド | 「固定する」のとき必須 | なし | コピーしたファイルを保存するフィールド |
| 保存のしかた | — | 追加する(既存を残す) | 追加するか、上書きするか |
使い方
4-1. 添付ファイルを取得する(PC)
設定したボタンは、レコードの詳細画面に表示されます。
- ファイルをコピーしたいレコードの詳細画面を開きます。
- 絞り込み条件で「このアプリのフィールド」を使っている場合は、そのフィールドに値が入っていることを確認します。
- スペースフィールドに表示されているボタン(初期値は「添付ファイル取得」)をクリックします。
レコードの詳細画面に表示された「添付ファイル取得」ボタン
- 絞り込み条件に一致する取得元レコードの検索が始まります。読み込み中の表示が出ます。
- 「添付ファイルの取得」という画面(モーダル)が開きます。
「添付ファイルの取得」画面。上がファイルの一覧、下が保存先
画面は上下に分かれています。
- 上:取得できるファイルの一覧。レコードごとにまとまり、添付ファイルフィールドが複数あるときは横に並びます
- 下:保存先の添付ファイルフィールドと、保存のしかた
- 取得したいファイルの行をクリックして、チェックを入れます。
- 「保存先」で、保存先の添付ファイルフィールドと、保存のしかた(追加する/上書きする)を選びます。
- 画面右下の「保存する」をクリックします。
「保存する」の右側には、選択中の件数が「(3)」のように表示されます。ファイルを1つも選んでいないときは「保存する」を押せません。
💡 設定で「固定する」が選ばれているときは、保存先と保存のしかたは選択済みで表示され、変更できません。ファイルを選んで「保存する」を押すだけです。
- 「上書きする」を選んでいて、保存先にファイルが入っている場合は、確認の画面が出ます。
上書きするときの確認画面
内容を確認して「上書きする」をクリックします。やめる場合は「キャンセル」をクリックします。
- ファイルのコピーが始まります。読み込み中の表示が出ます。
- 完了すると、画面右上に「3件のファイルを取得しました」(上書きのときは「3件のファイルを上書きしました」)と表示されます。
- まもなく、レコードの詳細画面が自動で再読み込みされます。
💡 一部のファイルだけ失敗した場合は、「2件を取得しました(1件は失敗)」のように表示されます。成功した分だけが保存されます。
⚠️ 「追加する」を選んだ場合、同じボタンを2回押して同じファイルを選ぶと、同じファイルが2件登録されます。重複しているかどうかの確認は行われません。
4-2. すべてのファイルをまとめて選ぶ
- 画面上部の「すべて選択」にチェックを入れます。
- 一覧のすべてのファイルにチェックが入ります。
一覧の右側には「全 6 件」のように、表示されているファイルの総数が表示されます。
💡 チェックをすべて外す場合は、「すべて選択」のチェックを外します。
4-3. 複数のレコード・複数のフィールドから取得する
絞り込み条件に一致するレコードが複数あるときは、一覧がレコードごとに区切られて表示されます。区切りには「レコード #123」のように、レコード番号の見出しが表示されます。
取得する添付ファイルフィールドを複数選んでいるときは、レコードの中でフィールドごとに分かれて表示されます。パソコンでは横に並びます。
💡 レコードやフィールドをまたいで、必要なファイルを自由に選択できます。
💡 一致するレコードが1件だけのときは、レコードの見出しは表示されません。添付ファイルフィールドを1つだけ選んでいるときは、フィールドの見出しも表示されません。
4-4. 取得をやめる(モーダルを閉じる)
次のいずれかの操作で、ファイルを取得せずに画面を閉じられます。
- 画面右下の「キャンセル」をクリックします。
- 画面右上の「×」をクリックします。
- モーダルの外側(背景の暗い部分)をクリックします。
- キーボードの「Esc」キーを押します。
4-5. スマートフォン(モバイル版)で利用する
スマートフォンのレコード詳細画面でも、同じボタンが表示されます。操作の流れはパソコンと同じです。
- スマートフォンでレコードの詳細画面を開きます。
- スペースフィールドに表示されているボタンをタップします。
- ファイル一覧からファイルを選びます。レコード・フィールドは縦に並びます。
- 「保存先」で、保存先の添付ファイルフィールドと保存のしかたを選びます。スマートフォンでは、どちらも選択式(プルダウン)です。
- 「保存する」をタップします。
スマートフォンのレコード詳細画面に表示されたボタン
4-6. 使い方の例:案件の見積書を、受注アプリへコピーする
「案件管理」アプリ(案件番号、添付ファイル:見積書・図面)の添付ファイルを、「受注管理」アプリのレコードへコピーする例です。
- 受注管理アプリのフォームに、スペース(要素ID:
filecopy)、文字列(1行)の「案件番号」、添付ファイルの「資料」を置いて、アプリを更新します。 - 受注管理アプリにこのプラグインを追加し、設定画面で「+設定を追加」をクリックします。
- 「配置するスペースフィールド」で
filecopyを選び、「ボタン名」を「案件の資料を取得」にします。 - 「取得元アプリ」で案件管理アプリを選びます。
- 「+ 条件を追加」をクリックし、「案件番号」「等しい」「このアプリのフィールド」「案件番号」を選びます。
- 「取得する添付ファイルフィールド」で、案件管理アプリの「見積書」と「図面」の両方にチェックを入れます。
- 「保存先」で「保存時に選択する」を選び、「保存先の添付ファイルフィールド」で「資料」、「保存のしかた」で「追加する」を選びます。
- 「設定保存」をクリックし、「設定を保存して、アプリを更新しました」と表示されることを確認します。
- 受注管理アプリで、「案件番号」が入ったレコードの詳細画面を開き、「案件の資料を取得」をクリックします。
- 「見積書」「図面」それぞれの見出しの下にファイルが並ぶので、必要なものにチェックを入れます。
- 保存先と保存のしかたを確認して「保存する」をクリックします。
- 「◯件のファイルを取得しました」と表示され、画面が再読み込みされたら、「資料」にファイルが追加されていることを確認します。
制限事項・注意点
5-1. 対象となる画面
- ボタンが表示されるのは、レコードの詳細画面のみです。
- 一覧画面、レコードの追加画面、レコードの編集画面では利用できません。
5-2. ボタンの表示に関する注意
- 設定を保存していない場合、ボタンは表示されません。
- 設定で選んだスペースフィールドが、フォームから削除されている場合、ボタンは表示されません。
- スペースフィールドの要素IDを変更した場合、プラグイン設定で選び直す必要があります。
- ご契約を確認できない場合、ボタンは表示されません。
⚠️ ボタンが表示されないときは、まず「配置するスペースフィールド」の設定と、フォーム上のスペースの要素IDが一致しているかをご確認ください。
5-3. 絞り込み条件に関する制限
- 条件の接続(かつ・または)は、条件全体で1つです。条件ごとに「かつ」と「または」を混ぜることはできません。
- テーブル(サブテーブル)の中にあるフィールドは、条件にも添付ファイルの取得元・保存先にも指定できません。
- 添付ファイル・リッチエディター以外でも、条件に使えないフィールドは選択肢に出ません(「2-2. 取得元アプリ(コピー元)に必要なもの」の表を参照)。
- 「このアプリのフィールド」で比べる場合、取得元のフィールドの種類に合うフィールドだけが候補に出ます。
- ユーザー選択・組織選択・グループ選択の「固定値」は、一覧を読み込めない環境では選べません。その場合は「このアプリのフィールド」または「ログインユーザー」をご利用ください。
5-4. ファイルのコピーに関する注意
- 「追加する」を選んだ場合、コピーしたファイルは保存先フィールドの既存ファイルの後ろに追加されます。既存ファイルは削除されません。
- 「上書きする」を選んだ場合、保存先フィールドの既存ファイルはすべて削除されます。元に戻せません。
- 同じファイルを重ねて取得しても、重複の確認は行われません(「追加する」の場合)。
- コピーはファイル単位で行われます。一部が失敗しても、成功した分は保存されます。
- ファイルサイズが大きい場合や件数が多い場合、処理に時間がかかります。処理中は画面を閉じないでください。
⚠️ コピー完了後、レコードの詳細画面が自動で再読み込みされます。処理中は他の操作をしないでください。
5-5. 条件の値に関する注意
- 「このアプリのフィールド」で比べるとき、そのフィールドが空欄だと検索できません。メッセージが表示され、ファイルの取得は行われません。
- 数値・計算・レコード番号の条件に、数値として読めない値を使うと、メッセージが表示され検索できません。
- 条件が1件も設定されていない設定では、ボタンを押しても検索できません。
5-6. アクセス権に関する注意
- 取得元アプリのレコードやフィールドを閲覧できない利用者は、ファイルを取得できません。
- 保存先の添付ファイルフィールドに編集権限がない利用者は、ファイルを保存できません。
5-7. 設定変更時の注意
- 「取得元アプリ」を変更すると、「絞り込み条件」と「取得する添付ファイルフィールド」の内容がリセットされます。
- 条件の「フィールド」を変更すると、その行の「条件」「値の種類」「値」がリセットされます。
- 設定画面で「設定情報の読み込みに失敗しました。ページを再読み込みしてください。」と表示された場合は、ブラウザを再読み込みしてください。
5-8. レコードの更新について
- ファイルのコピーは、このレコードを更新して保存します。そのため、レコードの更新者・更新日時は、コピーを実行した方・日時に変わります。
困ったときは
6-1. 表示されるメッセージと対処
レコードの詳細画面でボタンを押したとき
画面右上に表示されるメッセージと、その対処方法です。
| メッセージ | 意味 | 対処方法 |
|---|---|---|
| 絞り込み条件が設定されていません | 設定に条件が1件もありません | 設定画面で条件を追加します(3-5-2を参照) |
| このアプリの「○○」に値がありません | 条件で比べる、このアプリのフィールドが空欄です | レコードを編集して、そのフィールドに値を入力します |
| 「○○」の条件で、このアプリのフィールドが選ばれていません | 値の種類が「このアプリのフィールド」なのに、フィールドが未選択です | 設定画面で、その条件のフィールドを選びます |
| 「○○」の条件に値が設定されていません | 条件の値が空欄です | 設定画面で、その条件の値を入力します |
| 「○○」の条件の値が数値ではありません(△△) | 数値で比べる条件に、数値として読めない値が入っています | 数値が入るようにします |
| 条件に一致するレコードに、取得できる添付ファイルがありません | 条件に合うレコードがないか、そのレコードの対象フィールドにファイルがありません | 条件と、取得元レコードの添付ファイルを確認します |
| 取得元アプリのレコード取得に失敗しました(条件とアクセス権をご確認ください) | 取得元アプリのレコードを読み取れませんでした | 条件の内容と、取得元アプリのアクセス権を確認します |
| このアプリに添付ファイルフィールドがありません | 保存先にできるフィールドがありません | このアプリのフォームに添付ファイルフィールドを追加します |
| ファイルの取得に失敗しました | ファイルのコピー処理がすべて失敗しました | 取得元アプリのファイルの閲覧権限を確認します |
| レコードの更新に失敗しました | このレコードへの保存に失敗しました | このアプリのレコード編集権限と、保存先フィールドの権限を確認します |
| ○件のファイルを取得しました | 「追加する」でコピーが完了しました | 対処は不要です |
| ○件のファイルを上書きしました | 「上書きする」でコピーが完了しました | 対処は不要です |
| ○件を取得しました(△件は失敗) | 一部のファイルのコピーに失敗しました | 失敗したファイルを、もう一度取得します |
設定画面で
| メッセージ | 意味 | 対処方法 |
|---|---|---|
| 「設定1」の入力が不足しています:ボタン名、取得元アプリ など | 必須項目が未入力です | 表示された項目を入力してから保存します(3-6を参照) |
| 「設定1」の条件1:フィールドを選択してください | 条件のフィールドが未選択です | その条件のフィールドを選びます |
| 「設定1」の条件1:条件を選択してください | 条件(等しい、含む など)が未選択です | その条件を選びます |
| 「設定1」の条件1:値を指定してください | 条件の値が未入力です | その条件の値を指定します |
| 設定を保存して、アプリを更新しました | 保存とアプリの更新が完了しました | 対処は不要です(「アプリを開く」でアプリへ、「設定を続ける」で設定画面に残ります) |
| 設定は保存しましたが、アプリを更新できませんでした | 設定は保存されましたが、運用環境へ反映されていません | 「アプリの設定に戻る」をクリックし、アプリの設定画面で「アプリを更新」をクリックします |
| 設定を保存できませんでした | 設定の保存に失敗しました(エラー内容が続けて表示されます) | 表示された内容を確認し、もう一度「設定保存」をクリックします |
| 取得元アプリのフィールド取得に失敗しました(アクセス権をご確認ください) | 選んだ取得元アプリのフィールド情報を読み取れませんでした | 取得元アプリのアクセス権を確認するか、別のアプリを選びます |
| ユーザー・組織・グループの一覧を取得できませんでした。「このアプリのフィールド」または「ログインユーザー」をご利用ください。 | 固定値で使うユーザー一覧を読み込めませんでした | 値の種類を「このアプリのフィールド」または「ログインユーザー」にします |
| 設定情報の読み込みに失敗しました。ページを再読み込みしてください。 | 設定画面の読み込みに失敗しました | ブラウザを再読み込みします |
| ご利用にはライセンスの契約が必要です。 | プラグインの契約が確認できません | ご契約の状態を確認します |
| スペースフィールドがありません | 要素IDを設定したスペースがこのアプリにありません | 2-1の手順で、スペースに要素IDを設定します |
| 取得元アプリに添付ファイルフィールドがありません | 取得元アプリに添付ファイルフィールドがありません | 取得元アプリのフォームに添付ファイルフィールドを追加します |
| 添付ファイルフィールドがありません | このアプリに添付ファイルフィールドがありません | このアプリのフォームに添付ファイルフィールドを追加します |
6-2. うまく動かないときの確認ポイント
- ボタンが表示されない
- アプリの設定の「プラグイン」で、このプラグインが有効になっているか
- 「設定保存」のあと「設定を保存して、アプリを更新しました」と表示されたか(「アプリを更新できませんでした」と出た場合は、アプリの設定画面で「アプリを更新」をクリックする)
- レコードの詳細画面を開いているか(追加画面・編集画面には表示されません)
- 「配置するスペースフィールド」の要素IDと、フォーム上のスペースの要素IDが一致しているか
- ご契約の状態
- ファイルが見つからない(「条件に一致するレコードに、取得できる添付ファイルがありません」)
- 絞り込み条件が意図したとおりか(「等しい」は完全一致です。部分一致にしたいときは「含む」を使います)
- 条件を複数にしている場合、接続が「かつ」になっていないか(「または」にすると範囲が広がります)
- 取得元レコードの、チェックした添付ファイルフィールドにファイルが入っているか
- 取得やコピーに失敗する
- ボタンを使う方が、取得元アプリのレコードと添付ファイルを閲覧できるか
- ボタンを使う方が、このアプリのレコードと保存先の添付ファイルフィールドを編集できるか
6-3. よくある質問
Q. 保存先のファイルを、取得したファイルで置き換えられますか。
できます。「保存のしかた」で「上書きする」を選ぶと、保存先に元々あったファイルをすべて削除して、選んだファイルに差し替えます。
設定画面で固定することも、使うときに選ぶこともできます(3-5-4を参照)。
⚠️ 上書きすると、元々あったファイルは元に戻せません。
Q. 同じファイルが2件登録されました。
「追加する」で同じファイルを2回取得すると、同じファイルが2件登録されます。重複の確認は行いません。
不要な方を、レコードを編集して削除してください。毎回入れ替えたい場合は「上書きする」をご利用ください。
Q. 複数のレコードからまとめてファイルを取得できますか。
できます。絞り込み条件に一致するレコードが複数あれば、すべてのレコードのファイルが一覧に並びます。
レコードをまたいで必要なものだけを選べます。
Q. 取得元の添付ファイルフィールドを複数選べますか。
選べます。「取得する添付ファイルフィールド」で複数にチェックを入れてください。
取得の画面では、フィールドごとに見出しが付いて並びます。
Q. レコードごとに違う条件でファイルを探せますか。
できます。条件の「値の種類」で「このアプリのフィールド」を選ぶと、いま開いているレコードの値が条件に使われます。
Q. レコードの追加画面でファイルを取得したいです。
ボタンは詳細画面にだけ表示されます。
先に条件に使うフィールドを入力してレコードを保存し、詳細画面からボタンを押してください。
Q. 取得元アプリごとに別のボタンを置けますか。
置けます。「+設定を追加」で設定を複数作ると、設定ごとに1つのボタンが表示されます。
Q. 使う人に保存先を選ばせたくありません。
「保存先」で「固定する」を選んでください。
取得の画面では保存先と保存のしかたが選択済みで表示され、使う人は変更できません。