Kamera

Überblick

Die Camera-Komponente ermöglicht native Bildaufnahmefunktionen direkt in Ihren Salesforce-Seiten. Sie nutzt die Hardware des Geräts (Laptop-Webcam oder Mobilkamera), um Fotos aufzunehmen, ohne dass der Benutzer die Anwendung verlassen oder Dateien manuell hochladen muss.

Diese Komponente ist darauf ausgelegt, Arbeitsabläufe zu vereinfachen, die visuelle Dokumentation erfordern, und speichert aufgenommene Bilder automatisch als Salesforce-Dateien (ContentDocument) und verknüpft sie mit dem aktuellen Datensatz.

---

Häufige Anwendungsfälle

Anwendungsfall	Beschreibung	Beispiel
Field Service	Techniker können Standortbedingungen oder abgeschlossene Reparaturen direkt mobil dokumentieren.	Ein Foto einer reparierten Klimaanlage an ein Work Order Datensatz anhängen.
Inspektionen & Audits	Echtzeit-visueller Nachweis für Compliance-Prüfungen und Sicherheitsaudits.	Aufnehmen von Bildern von Gebäudeschäden während einer Wohnungsinspektion, um sie an ein Case.
Kundensupport	Ermöglichen Sie Agenten oder Kunden (Experience Cloud), visuelle Beweise für Probleme einzureichen.	Ein Kunde lädt ein Foto einer beschädigten Lieferung direkt in ein Support-Portal hoch Claim.
Vertrieb & Einzelhandel	Dokumentieren Sie Visual Merchandising, Regalpräsentationen oder Event-Setups.	Ein Vertriebsmitarbeiter macht ein Foto einer Store-Präsentation, um die Einhaltung einer Marketingvereinbarung zu überprüfen.
HR & Identität	Aufnehmen standardisierter Profilfotos für Identifikationszwecke.	Aktualisieren eines User oder Employee Datensatzes mit einem aktuellen Profilbild.

---

Konfiguration

Wählen Sie die Camera-Komponente auf der Leinwand aus, um auf deren Eigenschaften zuzugreifen. Die Konfiguration ist in Daten/Speicherung, Anzeigeeinstellungen und Interaktionsereignisse unterteilt.

Daten & Speicherung (Wesentlich)

Diese Einstellungen bestimmen, wo das Foto gespeichert wird und an welchen Salesforce-Datensatz es angehängt wird.

Wert (Variable - Erforderlich)

Binden Sie dies an eine Text-Variable (für einzelne Aufnahmen) oder eine Text-Sammlung (für Mehrfachaufnahmen).

Ausgabe: Nach erfolgreicher Aufnahme speichert diese Variable die Salesforce ContentDocumentId(s) der neuen Datei(en).

Als Content Document speichern (Boolean)

• Angehakt (empfohlen): Speichert das Bild automatisch als Salesforce-Datei (ContentDocument) sofort nach Bestätigung.

• Nicht angehakt: Gibt nur Base64-Bilddaten zurück. Erfordert erweiterte benutzerdefinierte Logik (Apex/Flow) zur Verarbeitung und wird für Standardanwendungsfälle nicht empfohlen.

Content Document Linked Entity Id

• Nur sichtbar, wenn "Als Content Document speichern" angehakt ist.

• Zweck: Gibt den Salesforce-Datensatz an, an den das Foto angehängt werden soll.

• Konfiguration: Normalerweise an die Datensatz-ID der aktuellen Seite gebunden unter Verwendung von $Component.recordId (oder @recordId).

Anzeige & Verhalten

Steuern Sie, wie die Kamera für den Benutzer angezeigt wird und wie der Aufnahme-Workflow funktioniert.

Einstellung	Beschreibung
Darstellung als	Inline: Betten Sie den Live-Kamerafeed direkt auf der Seite ein. Button: Zeigt eine "Foto aufnehmen"-Schaltfläche an, die beim Klicken ein Modal/Vollbild-Kamerafenster öffnet.
Mehrere Aufnahmen erlauben	Wenn Wahr, können Benutzer in einer Sitzung mehrere Fotos machen. Erfordert, dass das Wert Attribut eine Sammlung-Variable ist.
Aufgenommene Fotos anzeigen	Wenn Wahr, werden Miniaturansichten der aufgenommenen Fotos unterhalb der Kameransicht zur Überprüfung vor dem Speichern angezeigt.
Countdown anzeigen	Fügt eine Verzögerung (in Sekunden) zwischen Drücken des Auslösers und der Aufnahme hinzu. Nützlich für freihändige Szenarien.

Visuelle Anpassung

Feinabstimmung der Ästhetik des Kamerarahmens.

Seitenverhältnis

Legt die Rahmenabmessungen fest (z. B. 1:1 Quadratisch, 4:3 Standard, 16:9 Breitbild).

Zuschneide-Verhalten

Bestimmt, ob der Videofeed Cover (den Rahmen füllen und dabei möglicherweise Ränder zuschneiden) oder Contain (den gesamten Feed anzeigen und dabei möglicherweise schwarze Balken zeigen) sein soll.

Symbole & Beschriftungen

Sie können die spezifischen Symbole und Textbeschriftungen für Auslöser, Löschen und Bestätigen an Ihre Marken Sprache anpassen.

---

Interaktionen konfigurieren

Die Camera-Komponente unterstützt eindeutige Ereignisse, die andere Aktionen auslösen (wie Flows oder Toast-Benachrichtigungen).

Ereignis	Auslöser	Häufiger Anwendungsfall
Bei Bildaufnahme	Wird ausgelöst, nachdem der Benutzer erfolgreich ein Foto aufgenommen und bestätigt hat.	Zeige Toast ("Foto gespeichert!") oder navigiere zum nächsten Schritt in einem Assistenten.
Beim Start der Kamera	Wird ausgelöst, wenn die Kameravoransicht geöffnet wird (oder beim Laden der Seite, wenn Inline).	Analysen protokollieren oder eine "Kamera aktiv"-Variable setzen.
Beim Stoppen der Kamera	Wird ausgelöst, wenn der Benutzer die Kamera schließt oder die Aktion abbricht.	Variablen zurücksetzen oder zur Startseite zurück navigieren.

---

Beispiel

Foto als Beweismittel zu einem Case hinzufügen

1

Kamera-Komponente hinzufügen

Fügen Sie die Camera-Komponente zur Leinwand hinzu.

2

Kamera konfigurieren

• API-Name: evidenceCamera

• Bezeichnung: "Foto-Beweis anhängen"

• Darstellung als: Schaltfläche

• Mehrere Aufnahmen erlauben: Angekreuzt

• Als Content Document speichern: Angekreuzt

3

Interaktion zur Schaltfläche hinzufügen

• Wählen Sie die evidenceCamera Komponente.

• Gehen Sie zum Interaktionen Bereich.

• Fügen Sie dem Bei Bildaufnahme Ereignis (oder einem ähnlichen Erfolgsevent) eine Aktion hinzu.

• Aktionstyp: Toast anzeigen

• Toast konfigurieren: Variante Erfolg, Titel Erfolg, Nachricht Foto(s) dem Case hinzugefügt!.

Stellen Sie sicher, dass die Als Content Document speichern Option auf der Komponente aktiviert (angehakt) ist UND dass das Content Document Linked Entity Id Feld auf die ID des aktuellen Datensatzes gesetzt ist (indem Sie es an $Component.recordId binden, indem Sie den Ressourcen-Selector verwenden)

Ergebnis: Der Benutzer klickt auf "Foto-Beweis anhängen", macht Fotos und bestätigt. Die Fotos werden als Dateien gespeichert und automatisch mit dem Case verknüpft. Ein Erfolgstoast bestätigt die Aktion.

Wichtige Überlegungen

• Berechtigungen: Benutzer benötigen Geräteberechtigungen, um auf die Kamera zuzugreifen. Sie benötigen außerdem Salesforce-Berechtigungen zum Erstellen von ContentDocument (Dateien) und möglicherweise ContentDocumentLink Datensätzen, wenn Dateien gespeichert/verknüpft werden.

• Mobile First: Obwohl sie auf Desktops mit Webcams funktioniert, ist die Benutzererfahrung typischerweise für die Salesforce Mobile App oder mobile Browser optimiert.

• Als Content Document speichern: Dies zu aktivieren ist der einfachste Weg, Bilder in Salesforce zu speichern. Wenn deaktiviert, erfordert die Verarbeitung der Ausgabedaten benutzerdefinierte Logik (Flow/Apex).

• Netzwerkverbindung: Erforderlich, um Dateien in Salesforce zu speichern. Erwägen Sie Offline-Funktionen, falls erforderlich (dazu sind möglicherweise andere Lösungen nötig).

• Speicherlimits: Achten Sie auf die Speicherlimits für Salesforce-Dateien.

---

Zusammenfassung

Die Avonni Camera-Komponente bietet eine integrierte No-Code-Lösung zum Erfassen von Bildern direkt innerhalb Ihrer Salesforce-Benutzeroberfläche auf Lightning-Seiten und vereinfacht Arbeitsabläufe für Field Service, Inspektionen, Beweiserfassung und mehr, insbesondere für mobile Anwendungsfälle.