株式会社XenoX

マニュアル›添付ファイルコピープラグイン

添付ファイルコピープラグイン マニュアル

このプラグインでできること

「添付ファイルコピープラグイン」は、別のアプリに登録されている添付ファイルを、現在のレコードへコピーするプラグインです。
レコードの詳細画面に専用のボタンを設置します。
ボタンを押すと、設定した絞り込み条件に一致するレコードを別アプリから探します。
見つかったレコードの添付ファイルを一覧表示し、必要なファイルだけを選んでコピーできます。

添付ファイルコピープラグインの紹介ページを見る

主な機能は次のとおりです。

  • 別アプリのレコードを複数の条件で絞り込み、添付ファイルを取得します。条件には、いま開いているレコードの値・固定値・ログインユーザーを使えます。
  • 取得元の添付ファイルフィールドを複数指定できます。条件に一致するレコードが複数あっても構いません。
  • 取得したファイルを一覧から選び、必要なものだけをコピーします。
  • 保存先の添付ファイルフィールドと、追加するか上書きするかを選べます。設定で固定することも、使うときに選ばせることもできます。
  • ボタンの配置場所・名称・デザイン(色、余白、角丸、枠線など)を設定できます。
  • 設定はタブ形式で複数登録できます。1つの設定につき、1つのボタンが表示されます。
  • パソコンとスマートフォンの両方で利用できます。

💡 このプラグインは、kintone標準の「ルックアップ」に近い動きをします。違いは、コピーする対象が文字列や数値ではなく「添付ファイル」である点と、1つのキーではなく複数の条件でレコードを探せる点です。

動作環境・前提条件

2-1. このアプリ(コピー先)に必要なもの

このプラグインを設定するアプリには、次の3つが必要です。

必要なもの用途補足
スペースフィールドボタンを表示する場所フォームの編集画面で「要素ID」を設定してください
キーとなるフィールド取得元アプリのレコードを探す条件「文字列 (1行)」または「数値」
添付ファイルフィールドコピーしたファイルの保存先複数ある場合は設定で選択します

⚠️ スペースフィールド(フォームに空白の領域を作るフィールド)には、必ず「要素ID」を設定してください。要素IDが空欄のスペースは、設定画面の選択肢に表示されません。

スペースフィールドに要素IDを設定する手順

  1. 「アプリの設定」の「フォーム」を開きます。
  2. フォームに配置した「スペース」の歯車アイコンをクリックします。
  3. 表示されたメニューで「設定」をクリックします。
  4. 「要素ID」に、半角英数字で任意のIDを入力します。
  5. 「保存」をクリックします。
  6. フォームの編集画面で「アプリを更新」をクリックします。

スペースの設定画面で「要素ID」を入力する

スペースの設定画面で「要素ID」を入力する

2-2. 取得元アプリ(コピー元)に必要なもの

ファイルの取得元になるアプリには、次のものが必要です。

  • 添付ファイルフィールド(取り出したいファイルが入っているフィールド)
  • 絞り込みに使うフィールド(どのレコードから取り出すかを決めるための条件に使います)

絞り込みに使えるフィールドの種類は次のとおりです。フィールドの重複を禁止する設定は不要です。

種類使える条件
文字列(1行)・文字列(複数行)・リッチエディター・リンク等しい/等しくない/含む/含まない/空である/空でない
数値・計算・レコード番号=/≠/>/</≧/≦/空である/空でない
日付・日時・時刻・作成日時・更新日時=/≠/>/</≧/≦/空である/空でない
ドロップダウン・ラジオボタン・チェックボックス・複数選択・ステータスいずれかを含む/いずれも含まない
ユーザー選択・組織選択・グループ選択・作成者・更新者・作業者いずれかを含む/いずれも含まない

💡 条件に一致するレコードが複数あっても構いません。一致したすべてのレコードの添付ファイルが、取得の候補として一覧に並びます。

💡 レコード番号も条件に使えます。クエリ上は kintone のレコード番号($id)として扱われます。

2-3. アクセス権

対象者必要な権限
設定する方このアプリの「アプリ管理権限」と、取得元アプリのレコードを閲覧できる権限
ボタンを使う方取得元アプリのレコードと添付ファイルを閲覧できる権限、このアプリのレコードを編集できる権限(保存先の添付ファイルフィールドを含む)

⚠️ 取得元アプリのアクセス権がない場合、ファイルの取得に失敗します。取得元アプリの「アプリの設定」で、利用者のアクセス権をご確認ください。

⚠️ ファイルのコピーは、このレコードを更新して行います。このアプリのレコードを編集できない方は、ファイルを保存できません。

2-4. 対応する画面(PC版・モバイル版)

画面動作
レコードの詳細画面(PC版)ボタンが表示され、利用できます
レコードの詳細画面(モバイル版)ボタンが表示され、利用できます(設定はPC版と共通)
レコードの一覧画面・追加画面・編集画面ボタンは表示されません

設定画面は、PC版のアプリの設定から開きます。

設定手順

3-1. 設定画面の全体構成

設定画面は、次の手順で開きます。

  1. 対象のアプリを開き、画面右上の歯車アイコンから「アプリの設定」を開きます。
  2. 「設定」タブの「プラグイン」を選びます。
  3. 一覧から「添付ファイルコピープラグイン」の歯車アイコンをクリックします。

設定画面は、上から次の3つの領域に分かれています。

領域内容
ヘッダー「設定保存」ボタンと、右端の閉じるボタン
タブバー登録した設定のタブと「+設定を追加」
設定パネル選択中のタブの設定内容

設定を1件も登録していない場合、パネルには「設定がありません。「設定を追加」から作成してください。」と表示されます。

設定が1件もないときの設定画面

設定が1件もないときの設定画面

💡 画面を開いた直後は「読み込み中...」と表示されます。アプリとフィールドの情報を読み込んでいる状態です。数秒お待ちください。

3-2. 設定を追加する

  1. 設定画面のタブバーで「+設定を追加」をクリックします。
  2. 新しいタブが追加され、そのタブの設定パネルが表示されます。

設定を追加したときの設定パネル

設定を追加したときの設定パネル

💡 1つの設定が、レコード詳細画面の1つのボタンに対応します。取得元アプリごとにボタンを分けたい場合は、設定を複数追加してください。

3-3. 設定名を入力する

  1. 設定パネルの「設定名(タブ名)」に、この設定の名前を入力します。

入力した名前が、そのままタブの表示名になります。

💡 未入力の場合、タブ名は「設定1」「設定2」のように自動で表示されます。どの設定か分かるように、「見積書の添付取得」など具体的な名前を付けることをおすすめします。

「設定名(タブ名)」の入力欄

「設定名(タブ名)」の入力欄

3-4. ボタン設定

「ボタン設定」では、レコード詳細画面に表示するボタンの場所・名前・見た目を決めます。

3-4-1. 配置するスペースフィールドを選ぶ

  1. 「ボタン設定」の「配置するスペースフィールド」をクリックします。
  2. 一覧から、ボタンを表示したいスペースの要素IDを選択します。

選択肢には、このアプリのフォームに配置されたスペースの要素IDが表示されます。

⚠️ スペースフィールドが1つもない場合、「スペースフィールドがありません」と表示されます。この場合は、先に「2-1. このアプリ(コピー先)に必要なもの」の手順で、スペースフィールドに要素IDを設定してください。

「配置するスペースフィールド」で要素IDを選ぶ

「配置するスペースフィールド」で要素IDを選ぶ

💡 複数の設定で同じスペースフィールドを選ぶこともできます。その場合、1つのスペースにボタンが並んで表示されます。

3-4-2. ボタン名を入力する

  1. 「ボタン名」に、レコード詳細画面に表示する文字を入力します。

初期値は「添付ファイル取得」です。

「ボタン名」の入力欄

「ボタン名」の入力欄

3-4-3. ボタンデザインを設定する

「ボタンデザイン」で、ボタンの見た目を調整します。設定した内容は、すぐ下の「プレビュー」に反映されます。

設定できる項目は次のとおりです。

項目名内容初期値
背景色ボタンの背景の色青緑色
文字色ボタンの文字の色白
文字の太さ「B」を押すと文字が太字になります太字にしない
角丸ボタンの角の丸み(px)4
内側の余白(パディング)の「縦」文字の上下の余白(px)8
内側の余白(パディング)の「横」文字の左右の余白(px)20
外側の余白(マージン)の「上」ボタンの上側の余白(px)4
外側の余白(マージン)の「下」ボタンの下側の余白(px)4
外側の余白(マージン)の「左」ボタンの左側の余白(px)0
外側の余白(マージン)の「右」ボタンの右側の余白(px)8
枠線をつけるチェックを入れると枠線が表示されますチェックなし
枠線の色枠線の色(「枠線をつける」がONのときのみ表示)青緑色
枠線の太さ枠線の太さ(px。「枠線をつける」がONのときのみ表示)1

色を変更する手順

  1. 「背景色」の色見本をクリックします。
  2. 表示されたカラーピッカー(色を選ぶ画面)で色を選びます。

色見本をクリックすると開くカラーピッカー

色見本をクリックすると開くカラーピッカー

余白や角丸を変更する手順

  1. 変更したい項目の入力欄をクリックします。
  2. 数値を入力します。

💡 単位はすべてpx(ピクセル)です。0以上の数値を入力してください。

枠線をつける手順

  1. 「枠線をつける」のチェックボックスにチェックを入れます。
  2. 表示された「枠線の色」で色を選びます。
  3. 「枠線の太さ」に数値を入力します。

「枠線をつける」にチェックを入れると、「枠線の色」「枠線の太さ」が表示される

「枠線をつける」にチェックを入れると、「枠線の色」「枠線の太さ」が表示される

プレビューで確認する

「プレビュー」には、設定した見た目のボタンが表示されます。
ボタン名が未入力の場合、プレビューには「ボタン」と表示されます。

「プレビュー」に表示されたボタン

「プレビュー」に表示されたボタン

3-5. 取得元アプリ・絞り込み条件

どのアプリの、どのレコードから、どの添付ファイルを取り出すかを決めます。

3-5-1. 取得元アプリを選ぶ

「取得元アプリ」で、ファイルの取得元にするアプリを選びます。

  1. 「取得元アプリ」の欄をクリックします。
  2. アプリ名の一部を入力すると、候補が絞り込まれます。
  3. 一覧から選びます。

取得元アプリと絞り込み条件

取得元アプリと絞り込み条件

⚠️ 取得元アプリを変更すると、下の「絞り込み条件」と「取得する添付ファイルフィールド」で選んだ内容がすべてリセットされます。設定し直してください。

⚠️ 「取得元アプリのフィールド取得に失敗しました(アクセス権をご確認ください)」と表示された場合、選んだアプリのフィールド情報を読み取れていません。そのアプリのアクセス権をご確認ください。

3-5-2. 絞り込み条件を設定する

取得元アプリのどのレコードからファイルを取り出すかを、条件で指定します。条件は何件でも追加できます。

  1. 「+ 条件を追加」をクリックします。
  2. 左から順に「フィールド」「条件」「値の種類」「値」を指定します。
欄内容
フィールド取得元アプリのフィールド。選んだフィールドの種類に応じて、使える条件が変わります
条件「等しい」「含む」「いずれかを含む」など(2-2の表を参照)
値の種類「このアプリのフィールド」「固定値」「ログインユーザー」から選びます
値値の種類に応じた入力欄が出ます

値の種類

値の種類内容
このアプリのフィールドいま開いているレコードの値と比べます。初期値はこちらです。レコード番号・作成者・作成日時なども選べます
固定値決まった値と比べます。日付は日付の入力欄、選択肢のフィールドは選択肢のチェック、ユーザー選択などは一覧から選ぶ欄になります
ログインユーザーボタンを押した方で比べます。ユーザー選択・組織選択・グループ選択・作成者・更新者・作業者のときだけ選べます

💡 「このアプリのフィールド」を使うと、レコードごとに違う条件でファイルを探せます。たとえば「取得元の案件番号 = このアプリの案件番号」のように設定します。

💡 「固定値」を使うと、すべてのレコードで同じ条件になります。たとえば「取得元の種別 いずれかを含む 見積書」のように、決まった分類のレコードだけを対象にできます。

💡 「空である」「空でない」を選んだときは、値の指定は不要です。

条件が2件以上あるとき

条件が2件以上になると、条件の上に接続のしかたが表示されます。

  • すべての条件を満たす(かつ) … 全部の条件に当てはまるレコードだけが対象になります
  • いずれかの条件を満たす(または) … どれか1つでも当てはまるレコードが対象になります

⚠️ 接続のしかたは、条件ごとではなく条件全体で1つです。「かつ」と「または」を混ぜることはできません。

条件を削除するときは、行の右端にある「×」をクリックします。

3-5-3. 取得する添付ファイルフィールドを選ぶ

取得元アプリの、どの添付ファイルフィールドからファイルを取り出すかを選びます。複数選択できます。

取得する添付ファイルフィールド。チェックしたフィールドが対象になる

取得する添付ファイルフィールド。チェックしたフィールドが対象になる

  1. 取り出したい添付ファイルフィールドをクリックして、チェックを入れます。
  2. 複数のフィールドを選ぶと、どのフィールドのファイルかが分かるように、取得の画面で見出しが付きます。

⚠️ 1つもチェックしていないと、設定を保存できません。

⚠️ 取得元アプリに添付ファイルフィールドがない場合、「取得元アプリに添付ファイルフィールドがありません」と表示されます。この場合は、先にアプリのフォームに添付ファイルフィールドを追加してください。

3-5-4. 保存先を設定する

コピーしたファイルを、このアプリのどの添付ファイルフィールドに、どのように保存するかを決めます。

保存先の設定。「保存時に選択する」と「固定する」を選べる

保存先の設定。「保存時に選択する」と「固定する」を選べる

まず、保存先を使う人に選ばせるかどうかを決めます。

選択肢動き
保存時に選択するボタンを押したあとの画面で、保存先と保存のしかたを選べます。下で指定した内容が、その画面の初期値になります
固定するボタンを押すと、下で指定した保存先・保存のしかたでそのまま保存します。使う人は変更できません

次に、保存先の内容を指定します。

欄内容
保存先の添付ファイルフィールドコピーしたファイルを保存する、このアプリの添付ファイルフィールド
保存のしかた「追加する(既存を残す)」または「上書きする(既存を削除)」
  • 追加する … 保存先に元々あるファイルを残したまま、選んだファイルを後ろに足します。
  • 上書きする … 保存先に元々あるファイルをすべて削除して、選んだファイルに差し替えます。

⚠️ 「上書きする」を選ぶと、保存先に元々あったファイルは削除されます。元に戻せません。

⚠️ 「固定する」を選んだときは、「保存先の添付ファイルフィールド」が必須になります。未選択のままでは設定を保存できません。

3-6. 設定を保存する

  1. 設定画面の上部にある「設定保存」をクリックします。アプリの更新まで自動で行います。
  2. 「設定を保存して、アプリを更新しました」と表示されたら完了です(「アプリを開く」でアプリへ、「設定を続ける」で設定画面に残ります)。

保存中は、画面中央に「設定を保存しています…」「アプリを更新しています…」と表示されます。
アプリの設定画面で改めて「アプリを更新」を押す必要はありません。

ヘッダー左の「設定保存」

ヘッダー左の「設定保存」

💡 キーボードの「Ctrl」キーを押しながら「S」キーを押しても保存できます(Mac は「command」キーと「S」キー)。

入力に不足がある場合

必須項目が未入力の場合、保存されません。
画面右上に「「設定1」の入力が不足しています:ボタン名、取得元アプリ」のようなメッセージが表示されます。
同時に、不足がある設定のタブへ自動で切り替わります。

必須項目は次のとおりです。

必須項目メッセージ内の表記
配置するスペースフィールド配置するスペース
ボタン名ボタン名
取得元アプリ取得元アプリ
絞り込み条件(1件以上)絞り込み条件
取得する添付ファイルフィールド(1つ以上)取得する添付ファイルフィールド
保存先の添付ファイルフィールド(「固定する」のときのみ)保存先の添付ファイルフィールド

条件の中身に不足があるときは、「「設定1」の条件1:フィールドを選択してください」のように、何件目のどこが足りないかが表示されます。

入力が不足しているときのメッセージ

入力が不足しているときのメッセージ

⚠️ 「設定は保存しましたが、アプリを更新できませんでした」と表示された場合、設定内容は保存されていますが、運用環境へ反映されていません。「アプリの設定に戻る」をクリックし、アプリの設定画面で「アプリを更新」をクリックして反映してください。

3-7. 設定を切り替える・削除する

設定を切り替える手順

  1. 画面上部のタブバーで、表示したい設定のタブをクリックします。

設定ごとのタブ

設定ごとのタブ

設定を削除する手順

  1. 削除したい設定のタブにある「×」をクリックします。
  2. 「この設定を削除しますか?」という確認画面が表示されます。
  3. 「削除する」をクリックします。

「この設定を削除しますか?」の確認画面

「この設定を削除しますか?」の確認画面

⚠️ 削除後は「設定保存」をクリックしてください。保存するまで、削除内容はレコード画面に反映されません。

💡 削除をやめる場合は、確認画面で「キャンセル」をクリックします。

3-8. 設定画面を閉じる

  1. 画面右上の「×」をクリックします。

前の画面に戻ります。

⚠️ 保存していない変更は破棄されます。閉じる前に必ず「設定保存」をクリックしてください。

3-9. 設定項目の一覧

項目名必須初期値内容
設定名(タブ名)—設定1、設定2…(追加した順)タブに表示する設定の名前
配置するスペースフィールド必須なしボタンを表示するスペースの要素ID
ボタン名必須添付ファイル取得ボタンに表示する文字
ボタンデザイン—「3-4-3. ボタンデザインを設定する」の表のとおり背景色・文字色・文字の太さ・角丸・余白・枠線
取得元アプリ必須なしファイルの取得元にするアプリ
絞り込み条件必須なし(1件以上)どのレコードから取り出すかの条件。フィールド・条件・値の種類・値
条件の接続—すべての条件を満たす(かつ)条件が2件以上のときの、全体の接続のしかた
取得する添付ファイルフィールド必須なし(1つ以上)ファイルを取り出す、取得元アプリの添付ファイルフィールド(複数可)
保存先—保存時に選択する保存先を使う人に選ばせるか、固定するか
保存先の添付ファイルフィールド「固定する」のとき必須なしコピーしたファイルを保存するフィールド
保存のしかた—追加する(既存を残す)追加するか、上書きするか

使い方

4-1. 添付ファイルを取得する(PC)

設定したボタンは、レコードの詳細画面に表示されます。

  1. ファイルをコピーしたいレコードの詳細画面を開きます。
  2. 絞り込み条件で「このアプリのフィールド」を使っている場合は、そのフィールドに値が入っていることを確認します。
  3. スペースフィールドに表示されているボタン(初期値は「添付ファイル取得」)をクリックします。

レコードの詳細画面に表示された「添付ファイル取得」ボタン

レコードの詳細画面に表示された「添付ファイル取得」ボタン

  1. 絞り込み条件に一致する取得元レコードの検索が始まります。読み込み中の表示が出ます。
  2. 「添付ファイルの取得」という画面(モーダル)が開きます。

「添付ファイルの取得」画面。上がファイルの一覧、下が保存先

「添付ファイルの取得」画面。上がファイルの一覧、下が保存先

画面は上下に分かれています。

  • 上:取得できるファイルの一覧。レコードごとにまとまり、添付ファイルフィールドが複数あるときは横に並びます
  • 下:保存先の添付ファイルフィールドと、保存のしかた
  1. 取得したいファイルの行をクリックして、チェックを入れます。
  2. 「保存先」で、保存先の添付ファイルフィールドと、保存のしかた(追加する/上書きする)を選びます。
  3. 画面右下の「保存する」をクリックします。

「保存する」の右側には、選択中の件数が「(3)」のように表示されます。ファイルを1つも選んでいないときは「保存する」を押せません。

💡 設定で「固定する」が選ばれているときは、保存先と保存のしかたは選択済みで表示され、変更できません。ファイルを選んで「保存する」を押すだけです。

  1. 「上書きする」を選んでいて、保存先にファイルが入っている場合は、確認の画面が出ます。

上書きするときの確認画面

上書きするときの確認画面

内容を確認して「上書きする」をクリックします。やめる場合は「キャンセル」をクリックします。

  1. ファイルのコピーが始まります。読み込み中の表示が出ます。
  2. 完了すると、画面右上に「3件のファイルを取得しました」(上書きのときは「3件のファイルを上書きしました」)と表示されます。
  3. まもなく、レコードの詳細画面が自動で再読み込みされます。

💡 一部のファイルだけ失敗した場合は、「2件を取得しました(1件は失敗)」のように表示されます。成功した分だけが保存されます。

⚠️ 「追加する」を選んだ場合、同じボタンを2回押して同じファイルを選ぶと、同じファイルが2件登録されます。重複しているかどうかの確認は行われません。

4-2. すべてのファイルをまとめて選ぶ

  1. 画面上部の「すべて選択」にチェックを入れます。
  2. 一覧のすべてのファイルにチェックが入ります。

一覧の右側には「全 6 件」のように、表示されているファイルの総数が表示されます。

💡 チェックをすべて外す場合は、「すべて選択」のチェックを外します。

4-3. 複数のレコード・複数のフィールドから取得する

絞り込み条件に一致するレコードが複数あるときは、一覧がレコードごとに区切られて表示されます。区切りには「レコード #123」のように、レコード番号の見出しが表示されます。

取得する添付ファイルフィールドを複数選んでいるときは、レコードの中でフィールドごとに分かれて表示されます。パソコンでは横に並びます。

💡 レコードやフィールドをまたいで、必要なファイルを自由に選択できます。

💡 一致するレコードが1件だけのときは、レコードの見出しは表示されません。添付ファイルフィールドを1つだけ選んでいるときは、フィールドの見出しも表示されません。

4-4. 取得をやめる(モーダルを閉じる)

次のいずれかの操作で、ファイルを取得せずに画面を閉じられます。

  • 画面右下の「キャンセル」をクリックします。
  • 画面右上の「×」をクリックします。
  • モーダルの外側(背景の暗い部分)をクリックします。
  • キーボードの「Esc」キーを押します。

4-5. スマートフォン(モバイル版)で利用する

スマートフォンのレコード詳細画面でも、同じボタンが表示されます。操作の流れはパソコンと同じです。

  1. スマートフォンでレコードの詳細画面を開きます。
  2. スペースフィールドに表示されているボタンをタップします。
  3. ファイル一覧からファイルを選びます。レコード・フィールドは縦に並びます。
  4. 「保存先」で、保存先の添付ファイルフィールドと保存のしかたを選びます。スマートフォンでは、どちらも選択式(プルダウン)です。
  5. 「保存する」をタップします。

スマートフォンのレコード詳細画面に表示されたボタン

スマートフォンのレコード詳細画面に表示されたボタン

4-6. 使い方の例:案件の見積書を、受注アプリへコピーする

「案件管理」アプリ(案件番号、添付ファイル:見積書・図面)の添付ファイルを、「受注管理」アプリのレコードへコピーする例です。

  1. 受注管理アプリのフォームに、スペース(要素ID:filecopy)、文字列(1行)の「案件番号」、添付ファイルの「資料」を置いて、アプリを更新します。
  2. 受注管理アプリにこのプラグインを追加し、設定画面で「+設定を追加」をクリックします。
  3. 「配置するスペースフィールド」で filecopy を選び、「ボタン名」を「案件の資料を取得」にします。
  4. 「取得元アプリ」で案件管理アプリを選びます。
  5. 「+ 条件を追加」をクリックし、「案件番号」「等しい」「このアプリのフィールド」「案件番号」を選びます。
  6. 「取得する添付ファイルフィールド」で、案件管理アプリの「見積書」と「図面」の両方にチェックを入れます。
  7. 「保存先」で「保存時に選択する」を選び、「保存先の添付ファイルフィールド」で「資料」、「保存のしかた」で「追加する」を選びます。
  8. 「設定保存」をクリックし、「設定を保存して、アプリを更新しました」と表示されることを確認します。
  9. 受注管理アプリで、「案件番号」が入ったレコードの詳細画面を開き、「案件の資料を取得」をクリックします。
  10. 「見積書」「図面」それぞれの見出しの下にファイルが並ぶので、必要なものにチェックを入れます。
  11. 保存先と保存のしかたを確認して「保存する」をクリックします。
  12. 「◯件のファイルを取得しました」と表示され、画面が再読み込みされたら、「資料」にファイルが追加されていることを確認します。

制限事項・注意点

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. 使う人に保存先を選ばせたくありません。

「保存先」で「固定する」を選んでください。
取得の画面では保存先と保存のしかたが選択済みで表示され、使う人は変更できません。

« マニュアルの一覧に戻る