カメラ

概要

カメラコンポーネントは、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 やトースト通知など)をトリガーするユニークなイベントをサポートします。

イベント
トリガー
一般的なユースケース

画像撮影時

ユーザーが写真を正常に撮影して確認をクリックした後に発火します。

トースト(「写真を保存しました!」)を表示する、またはウィザードの次のステップにナビゲートするなど。

カメラ開始時

カメラプレビューが開いたとき(またはインライン表示の場合はページ読み込み時)に発火します。

分析のログ記録や「カメラアクティブ」変数の設定など。

カメラ停止時

ユーザーがカメラを閉じるか操作をキャンセルしたときに発火します。

変数のリセットやホーム画面への戻りなど。


ケースへの写真証拠の追加

1

カメラコンポーネントを追加

カメラコンポーネントをキャンバスに追加します。

2

カメラを設定

  • API 名: evidenceCamera

  • ラベル:「写真証拠を添付」

  • 表示方法: ボタン

  • 複数撮影を許可:チェック済み

  • Content Document として保存:チェック済み

3

ボタンにインタラクションを追加

  • コンポーネントを選択します。 evidenceCamera コンポーネント。

  • に移動します インタラクション パネル。

  • イベント(または類似の成功イベント)にアクションを追加します。 画像撮影時 イベント(または類似の成功イベント)。

  • アクションタイプ: トーストを表示

  • トーストを構成: バリアント 成功(success)、タイトル 成功、メッセージ 写真がケースに添付されました!.

次を確認してください: Content Document として保存 コンポーネントでそのオプションが有効(チェックされている)であり、かつ Content Document リンク先エンティティ ID フィールドが現在のレコードの ID に設定されていること(リソースセレクタを使って $Component.recordId にバインドする)

結果: ユーザーが「写真証拠を添付」をクリックし、写真を撮影して確認します。写真はファイルとして保存され および 自動的にケースにリンクされます。成功のトーストがアクションを確認します。

重要な考慮事項


まとめ

Avonni のカメラコンポーネントは、Lightning ページ上の Salesforce UI 内で直接画像を撮影するための統合されたノーコードソリューションを提供し、フィールドサービス、検査、証拠収集などのワークフロー、特にモバイルユースケースを効率化します。

最終更新

役に立ちましたか?