ファイルアップロード
概要
Avonni ファイルアップロードコンポーネントは、ユーザーが動的コンポーネント内からローカルデバイス上のファイルを1つまたは複数選択してアップロードできるユーザーフレンドリーなインターフェースを提供します。これらのアップロードされたファイルは通常 Salesforce Files（ContentDocument レコード）として保存されます。指定された親レコードに自動的にリンクすることができ、別のファイルアップロード領域に移動することなく、ドキュメントの添付や証拠の提出などの処理を簡素化します。
主な機能
直接ファイルアップロード: コンポーネント内からユーザーがファイルをアップロードできるようにします。
複数ファイル対応: 単一または複数ファイルを同時にアップロードできるオプション。
フォーマット制限: 許可されるファイル形式を定義します（例: PDF、JPG、DOCX）。
Salesforce 統合: アップロードされたファイルを Salesforce Files として保存し、指定したレコードにリンクします。
カスタマイズ可能な UI: ラベル、ヘルプテキスト、ファイル表示、コンポーネントのレイアウトを制御できます。
ファイル名オプション: 整理のためにアップロードされたファイル名にプレフィックスやサフィックスを追加できます。
ユースケース
商談レコードに提案書や契約書を添付すること。
ケースレコードの補足文書をアップロードすること。
商品レコードに画像や仕様書を追加すること。
カスタムワークフローで添付ファイル付きの課題提出や完了フォームを送信すること。
ユーザーがプロフィール写真や身分証明書をアップロードできるようにすること。
ファイルアップロードコンポーネントの追加
ドラッグアンドドロップ: コンポーネントライブラリ（左パネル）から「File Upload」コンポーネントを見つけ、コンポーネントビルダー内のキャンバスにドラッグします。
設定
キャンバス上でファイルアップロードコンポーネントを選択して、プロパティパネルでそのプロパティにアクセスします。
基本プロパティ
これらのプロパティは基本的なラベリングと識別を制御します。
API 名： (テキスト) このコンポーネントインスタンスの一意の識別子（例：
ProposalUploader,CaseAttachmentUpload).ラベル： (テキスト) ファイルアップローダーに表示される主要なテキストラベル。例:「提案書をアップロード:」「補助ファイルを添付:」。
フィールドレベルヘルプ： (テキスト、任意) ラベルの横に表示されるヘルプテキスト（多くの場合クエスチョンマークアイコンとして）、アップロードするファイルの種類やサイズ制限に関する追加の指示や文脈を提供します。
ファイルアップロードの動作
これらの設定はファイルアップロードのプロセスの動作を定義します。
許可される形式: (テキスト) アップロードを許可するファイル拡張子のカンマ区切りリストを指定します（例:
.pdf,.jpg,.png,.docx). 先頭のドットを含めてください。空白にするとすべてのファイルタイプを許可します（制御のためには一般的に推奨されません）。複数ファイルを許可: （ブール - チェックボックス）
チェック済み: ユーザーは複数のファイルを同時に選択してアップロードできます。
未チェック（デフォルト）: ユーザーは1回の操作で単一のファイルのみアップロードできます。
アップロードされたファイルを表示: (ブール - チェックボックス) 有効にすると、コンポーネントは現在のセッションまたはコンテキスト内で正常にアップロードされたファイルの一覧やプレビューを表示します。
必須： (ブール - チェックボックス) 有効にすると、ユーザーは まず 少なくとも1つのファイルをアップロードする必要があります。これはフォーム検証でよく使用されます。
ファイルの関連付けと命名
これらはアップロードされたファイルが Salesforce に正しくリンクされ、命名されることを確保するための重要な設定です。
関連レコード ID: （テキスト - リンクのために必須) アップロードされたファイルを関連付けるべきレコードの 15 または 18 文字の Salesforce ID。
設定方法: 通常、マップオプションを使用して動的な値にバインドします:
$Component.recordId: 動的コンポーネントがその Target Page Object を設定されており、レコードページに配置されている場合に使用します。これによりファイルが自動的に現在表示されているレコードにリンクされます。変数リソース: モーダルコンポーネントに渡された ID など、リンクしたいレコードの ID を保持する変数を選択します。
ファイル名プレフィックス: (テキスト、任意) Salesforce に保存される際に元のファイル名の 先頭 に自動的に追加されるテキストを入力します。例: プレフィックスが
Contract_でユーザーがアップロードしたファイル名がDetails.pdfの場合、保存時にContract_Details.pdf.ファイル名サフィックス: (テキスト、任意) Salesforce に保存される際に元のファイル名の 末尾 （拡張子の前）に追加される例。例: サフィックスが
_Finalでユーザーがアップロードしたファイル名がReport.docxの場合、保存時にReport_Final.docx.
表示とレイアウト
これらのプロパティはコンポーネントの視覚的な表示を制御します。
バリアント： (選択) メインコンポーネントの視覚スタイルと配置を制御します
ラベル:standard: コンポーネント上部のラベル。label-inline: 左側のラベル。label-stacked: 上部のラベル（場合によってはstandard).label-hidden: メインラベルを非表示にします。
ストレッチ: (ブール - チェックボックス) 有効にすると、ファイルアップローダーのインターフェースがコンテナの利用可能な幅全体を占有するように試みます。
状態と表示/非表示
無効： (ブール - チェックボックス) 有効にすると、ファイルアップロードコンポーネントは完全に無効になり、ユーザーは操作できなくなります。
表示： (ブール) ファイルアップロードコンポーネント全体がページ上で表示されるかどうかを制御します。動的な表示にはこの値をブール変数や数式にバインドしてください。
アップロードイベントへの応答
Avonni ファイルアップロードコンポーネントは、ファイルを自動的に Salesforce にアップロードし、 関連レコード ID プロパティで指定されたレコードにリンクするように設計されています。 （プロパティ） ユーザーがファイルを選択したときに。
例: 商談に提案書を添付する
動的コンポーネントの設定: 動的コンポーネントに
そのが設定されていることを確認してください商談（Opportunity）.ファイルアップロードコンポーネントを追加:
API 名：
ProposalUploadラベル: 「提案書をアップロード」
許可される形式:
.pdf,.docx関連レコード ID: にバインド
$Component.recordId（現在の商談にリンクするため）。アップロードされたファイルを表示: チェック済み
結果： 商談ページでは、ユーザーはこのコンポーネントを使って PDF または DOCX ファイルをアップロードできます。ファイルは自動的にその商談にリンクされ、成功メッセージが表示されます。
主な注意点
Salesforce のファイルストレージ制限: 組織全体のファイルストレージの上限に注意してください。
ユーザー権限: ユーザーは以下を作成するための適切な権限が必要です:
ContentDocument（ファイル）およびContentDocumentLinkレコードを通じてファイルをレコードに関連付けます。ファイルサイズの制限: Salesforce は個々のファイルサイズに制限を課しています。コンポーネントにも設定可能な制限がある場合があります。
セキュリティ: ファイルをアップロードおよびリンクする機能が、ユーザーとページのコンテキストに対して適切であることを確認してください。
命名規則： 標準化されたファイル命名が必要な場合は、プレフィックス/サフィックスを慎重に使用してください。
まとめ
Avonni ファイルアップロードコンポーネントは、カスタム Lightning ページ体験にファイルアップロードとレコード関連付けを直接統合するためのノーコードでの効率的な方法を提供し、データの完全性とユーザーの効率を向上させます。
最終更新
役に立ちましたか？