カメラ
概要
カメラコンポーネントは、Salesforce ページ内でネイティブな画像撮影機能を直接有効にします。これはデバイスのハードウェア(ラップトップのウェブカメラやモバイルカメラ)を利用して、ユーザーがアプリケーションを離れたり手動でファイルをアップロードしたりすることなく写真を撮影します。
このコンポーネントは視覚的な記録が必要なワークフローを効率化するよう設計されており、撮影した画像を自動的に Salesforce Files(ContentDocument)として保存し、現在のレコードにリンクします。
よくあるユースケース
フィールドサービス
技術者がモバイルで現場の状況や完了した修理を記録できます。
修理済みの HVAC ユニットの写真を 作業指示(Work Order) レコードにリンクすること。
検査と監査
コンプライアンスチェックや安全監査のためのリアルタイムの視覚的証拠。
住宅検査中に物件の損傷を撮影して、 ケース(Case).
カスタマーサポート
担当者や顧客(Experience Cloud)が問題の視覚的証拠を提出できるようにします。
顧客が破損した荷物の写真をサポートポータルに直接アップロードする例 クレーム(Claim).
営業・小売
ビジュアルマーチャンダイジング、棚陳列、イベント設営などを記録します。
営業担当者がマーケティング契約の遵守を確認するために店舗ディスプレイの写真を撮ること。
人事・身元確認
識別のために標準化されたプロフィール写真を撮影します。
(例) ユーザー(User) または 従業員(Employee) レコードを新しいプロフィール写真で更新すること。
設定
キャンバス上でカメラコンポーネントを選択してそのプロパティにアクセスします。設定はデータ/ストレージ、表示設定、インタラクションイベントに分かれています。
データとストレージ(重要)
これらの設定は写真がどこに保存され、どの Salesforce レコードに添付されるかを決定します。
値 (変数 - 必須)
これをテキスト変数(単一撮影用)またはテキストコレクション(複数撮影用)にバインドしてください。
出力:撮影が成功した場合、この変数は新しいファイルの Salesforce ContentDocumentId(複数可)を格納します。
Content Document として保存 (ブール)
チェック済み(推奨):確認後、画像を自動的に Salesforce File(
ContentDocument)として即座に保存します。未チェック:Base64 画像データのみを返します。 これを処理するには高度なカスタムロジック(Apex/Flow)が必要であり、標準的なユースケースには推奨されません。
Content Document リンク先エンティティ ID
「Content Document として保存」がチェックされている場合にのみ表示されます。
目的:写真を添付する Salesforce レコードを指定します。
設定:通常、以下を使って現在のページのレコード ID にバインドします
$Component.recordId(または@recordId).
表示と動作
カメラのユーザーへの見え方と撮影ワークフローの動作を制御します。
表示方法
インライン:ライブカメラ映像をページ上に直接埋め込みます。
ボタン:クリックするとモーダル/フルスクリーンのカメラを開く「写真を撮る」ボタンを表示します。
複数撮影を許可
True の場合、ユーザーは1セッションで複数の写真を撮ることができます。属性がコレクション変数であることが必要です。 値 属性がコレクション変数である必要があります。
撮影した写真を表示
True の場合、保存前に確認できるようにカメラビューの下に撮影した写真のサムネイルを表示します。
カウントダウンを表示
シャッターを押してから撮影するまでの遅延(秒)を追加します。ハンズフリーのシナリオで便利です。
視覚的カスタマイズ
カメラフレームの外観を微調整します。
アスペクト比
フレーム寸法を設定します(例: 1:1 正方形、 4:3 標準、 16:9 ワイドスクリーン)。
クロップの適合方法
ビデオフィードがフレームをどう扱うかを決定します(例えば カバー (フレームを埋め、端が切れる可能性あり)または コンテイン (フィード全体を表示し、黒い余白ができる可能性あり)。
アイコンとラベル
シャッター、削除、確認ボタンの特定のアイコンやテキストラベルをブランドの言語に合わせてカスタマイズできます。
インタラクションの設定
カメラコンポーネントは他のアクション(Flow やトースト通知など)をトリガーするユニークなイベントをサポートします。
画像撮影時
ユーザーが写真を正常に撮影して確認をクリックした後に発火します。
トースト(「写真を保存しました!」)を表示する、またはウィザードの次のステップにナビゲートするなど。
カメラ開始時
カメラプレビューが開いたとき(またはインライン表示の場合はページ読み込み時)に発火します。
分析のログ記録や「カメラアクティブ」変数の設定など。
カメラ停止時
ユーザーがカメラを閉じるか操作をキャンセルしたときに発火します。
変数のリセットやホーム画面への戻りなど。
例
ケースへの写真証拠の追加
結果: ユーザーが「写真証拠を添付」をクリックし、写真を撮影して確認します。写真はファイルとして保存され および 自動的にケースにリンクされます。成功のトーストがアクションを確認します。
重要な考慮事項
権限:ユーザーはカメラにアクセスするためのデバイス権限が必要です。また、Salesforce にファイルを作成するための権限(Files)や、ファイルを保存/リンクする場合は ContentDocumentLink レコードの作成権限が必要になることがあります。
ContentDocument(Files)および場合によってはContentDocumentLinkレコード。モバイルファースト:ウェブカメラ搭載のデスクトップでも機能しますが、ユーザーエクスペリエンスは通常 Salesforce モバイルアプリまたはモバイルブラウザ向けに最適化されています。
Content Document として保存:これを有効にすることが Salesforce に画像を永続化する最も簡単な方法です。無効にした場合、出力データの処理にはカスタムロジック(Flow/Apex)が必要になります。
ネットワーク接続:Salesforce にファイルを保存するには接続が必要です。必要に応じてオフライン機能を検討してください(別のソリューションが必要になる場合があります)。
ストレージ制限:Salesforce のファイルストレージ制限に注意してください。
まとめ
Avonni のカメラコンポーネントは、Lightning ページ上の Salesforce UI 内で直接画像を撮影するための統合されたノーコードソリューションを提供し、フィールドサービス、検査、証拠収集などのワークフロー、特にモバイルユースケースを効率化します。
最終更新
役に立ちましたか?
