Herunterladen

Übersicht

Die Download-Interaktion bietet eine vereinfachte Möglichkeit, Dateien, die mit Ihren Salesforce-Datensätzen verknüpft sind, in einer Daten­tabelle zugänglich zu machen. Dies verbessert die Benutzererfahrung und Effizienz, da das Navigieren weg von der Tabelle zum Auffinden und Herunterladen von Dateien entfällt.

Funktionsweise

Die Download-Interaktion wird konfiguriert innerhalb einer Avonni Data Table-Komponente. So funktioniert der Ablauf:

Einrichtung der Daten­tabelle

• Ihre Daten­tabelle sollte so konfiguriert sein, dass Datensätze eines Salesforce-Objekts mit zugehörigen Dateien angezeigt werden (z. B. Fälle mit angehängten Dokumenten, Konten mit Vertragsdateien usw.).

• Sie benötigen eine Möglichkeit, die mit jedem Datensatz verknüpfte Datei zu identifizieren. Dies wird üblicherweise durch eine der folgenden Methoden erreicht:

  • Ein Feld, das die Content Document ID der zugehörigen Datei enthält.

  • Ein Feld, das eine URL enthält, die direkt auf die Datei zeigt.

  • Eine Beziehung zum ContentDocument Objekt (dies ist weniger üblich für direkte Download-Links, aber möglich).

Fügen Sie die Download-Interaktion hinzu

• Wählen Sie die Avonni Data Table-Komponente im Seiteneditor aus.

• Fügen Sie in den Eigenschaften der Komponente "Aktionen"- oder "Schaltflächen"-Spalten hinzu.

• Fügen Sie eine neue Interaktion hinzu und wählen Sie den Typ "Download".

Konfigurieren Sie die Download-Interaktion

• URL-Feld: (Optional) Wählen Sie das Feld aus der Datenquelle Ihrer Daten­tabelle aus, das die URL der Dateienthält. Wenn Sie eine URL angeben, hat diese Vorrang vor der Content Document ID.

• Feld für Content Document ID: (Optional) Wählen Sie das Feld aus der Datenquelle Ihrer Daten­tabelle aus, das die Content Document ID der Datei.

• Öffentlichen Link automatisch erzeugen: (Optional, aber sehr wichtig)

  • Wenn angekreuzt (aktiviert): Versucht die Komponente, einen öffentlich zugänglichen Link für die Datei zu erzeugen. Dadurch können Benutzer ohne Salesforce-Anmeldung auf die Datei zugreifen und sie herunterladen.

    • Existiert bereits ein öffentlicher Link für das Content Document, wird dieser verwendet.

    • Wenn kein öffentlicher Link vorhanden ist, wird einer automatisch erstellt. Wichtig: Dadurch wird die Datei über den erzeugten Link öffentlich zugänglich.

  • Wenn nicht angekreuzt (deaktiviert): Erzeugt die Komponente einen Download-Link, der Salesforce-Authentifizierung erfordert. Nur Benutzer, die in Ihrer Salesforce-Organisation mit ausreichenden Berechtigungen angemeldet sind, können die Datei herunterladen.

Wichtiger Hinweis

Das URL-Feld hat Vorrang. Wenn sowohl ein URL-Feld als auch ein Feld für die Content Document ID angegeben sind, verwendet die Komponente die URL. Wenn Sie Öffentlichen Link automatisch erzeugen, seien Sie sehr vorsichtig in Bezug auf die Datensicherheit.

Benutzerinteraktion

• Wenn die Daten­tabelle angezeigt wird, erscheint in der konfigurierten Spalte oder neben jeder Zeile ein Download-Symbol.

• Ein Klick auf dieses Symbol startet den Download der mit diesem bestimmten Datensatz verknüpften Datei.

Beispielanwendung: Fallanhänge

Angenommen, Sie haben eine Daten­tabelle, die eine Liste von Fällen anzeigt. Jeder Fall könnte eine angehängte Datei haben (z. B. einen Screenshot, eine Protokolldatei, einen PDF-Bericht).

1. Datenquelle: Die Abfrage Ihrer Daten­tabelle ruft Falldatensätze ab. Sie sollte auch Folgendes einschließen:

   • Das ContentDocumentId der angehängten Datei (dies ist die standardmäßige Methode, Dateien in Salesforce mit Datensätzen zu verknüpfen). ODER

   • Ein benutzerdefiniertes Feld auf dem Fallobjekt enthält eine URL, die auf die Datei zeigt.

2. Download-Interaktion: Sie fügen der Daten­tabelle eine Download-Interaktion hinzu.

   • Sie würden auswählen entweder das ContentDocumentId Feld oder oder das benutzerdefinierte URL-Feld.

   • Sie entscheiden, ob Sie "Öffentlichen Link automatisch erzeugen" aktivieren, abhängig davon, ob die Dateien für Benutzer außerhalb von Salesforce zugänglich sein sollen.

3. Ergebnis: Die Daten­tabelle zeigt für jeden Fall ein Download-Symbol an. Ein Klick auf das Symbol eines bestimmten Falls lädt die mit diesem Fall verknüpfte Datei herunter, entweder über einen Salesforce-authentifizierten Link oder einen öffentlichen Link, je nach Ihrer Konfiguration.

Wichtige Vorteile

Die Integration der Download-Interaktion bietet echte Vorteile:

• Weniger Klicken, mehr Tun (optimierter Arbeitsablauf): Benutzer müssen die Tabelle nicht verlassen und auf den Datensatzseiten nach Dateien suchen. Sie laden direkt aus der Zeile herunter, was Zeit und Aufwand spart.

• Zufriedenere Benutzer (verbesserte UX): Dateien direkt in Verbindung mit den angezeigten Daten zu erhalten, ist einfach bequemer und intuitiver.

• Die richtige Datei, direkt dort (kontextbezogener Zugriff): Das Download-Symbol befindet sich neben dem zugehörigen Datensatz, wodurch Ratespiele entfallen und sichergestellt wird, dass Benutzer das richtige Dokument erhalten

) werden dann gerendert, sind bereits mit den korrekten Kontaktdaten gefüllt und bereit zur Bearbeitung.

• Berechtigungen: Um die Dateien herunterzuladen, müssen Benutzer die erforderlichen Salesforce-Berechtigungen haben (z. B. "Inhalte anzeigen" auf dem ContentDocument-Objekt oder entsprechende Freigabeeinstellungen).

• Verfügbarkeit des Feldes: Stellen Sie sicher, dass das Feld, das die Content Document ID oder die URL enthält, in der Datenquelle Ihrer Daten­tabelle enthalten ist.

• Gültigkeit der URL (bei Verwendung von URLs): Wenn Sie ein URL-Feld verwenden, stellen Sie sicher, dass die URLs gültig und zugänglich sind.

• Sicherheit öffentlicher Links (bei Verwendung von "Öffentlichen Link automatisch erzeugen"): Seien Sie äußerst vorsichtig, wenn Sie "Öffentlichen Link automatisch erzeugen" aktivieren. Dadurch werden Dateien öffentlich zugänglich, verwenden Sie diese Option also nur, wenn es angemessen ist und Sie die Sicherheitsfolgen vollständig verstehen. Erwägen Sie, eine kurze Ablaufzeit für öffentliche Links zu verwenden.

Implementieren Sie Fehlerbehandlung innerhalb von Flows, wenn diese verwendet werden.

Die Download-Interaktion bietet eine leistungsstarke Möglichkeit, direkte Datei-Download-Funktionen zu Ihren Avonni Data Tables hinzuzufügen. Überlegen Sie sorgfältig, ob Sie Content Document IDs oder URLs verwenden möchten, und beachten Sie die Sicherheitsfolgen der Option "Öffentlichen Link automatisch erzeugen".