Lizenzverwaltung

Lizenz- und Berechtigungsverwaltung

Damit Benutzer Avonni Components anzeigen und verwenden können, insbesondere auf Experience Cloud-Seiten, müssen Sie einen Konfigurationsprozess in zwei Schritten abschließen.

⚠️ Konfigurationsanforderung: Damit ein Benutzer erfolgreich auf Avonni Components zugreifen kann, müssen Sie BEIDES zuweisen:

1. Eine Paketlizenz (Weist dem Benutzer einen Sitzplatz zu).
2. Ein Berechtigungssatz (Gewährt technischen Zugriff auf die Komponenten).

Wichtig

Wenn ein Benutzer eine Lizenz, aber keinen Berechtigungssatz hat (oder umgekehrt), werden die Komponenten nicht geladen, und der Benutzer sieht eine Fehlermeldung.

---

Schritt 1: Paketlizenzen zuweisen

Die Paketlizenz gewährt dem Benutzer das grundlegende Recht, die Software innerhalb von Salesforce zu nutzen.

Verfügbarkeit der Lizenzen:

• Production: Enthält 10 Freemium-Lizenzen.
• Sandbox: Enthält eine Site-Lizenz (unbegrenzte Benutzer/kein Ablaufdatum).

Wie viele Lizenzen benötigen Sie?

Weisen Sie jedem Benutzer, der sich auf der Site anmelden muss, eine Avonni-Lizenz zu. Es ist nichts zu berechnen.

Dies gilt auch dann, wenn Ihre Salesforce-Experience-Cloud-Lizenzen anmeldungsbasiert sind. Avonni-Sitze werden nicht auf Anmeldungen, Sitzungen oder die Häufigkeit von Besuchen angerechnet, daher können Sie ihre Anzahl nicht aus dem erwarteten Datenverkehr ableiten. Entscheidend ist, wie viele Benutzer die Lizenz in Ihrer Organisation besitzen.

Der Grund ist eine Plattformbeschränkung und keine Entscheidung von uns: Salesforce teilt uns nicht mit, ob ein anmeldungsbasierter Benutzer tatsächlich mit einer Site verbunden war, daher gibt es keine Nutzung, die gemessen werden könnte. Wenn jedem Benutzer, der sich anmelden kann, eine Lizenz zugewiesen wird, verhindert das, dass einer von ihnen einen Zugriffsfehler erhält.

Um Ihren aktuellen Stand zu sehen, öffnen Sie Setup > Installierte Pakete, suchen Sie Avonni Experience Components und klicken Sie auf Lizenzen verwalten. Auf der Seite werden die Benutzer aufgelistet, die eine Lizenz besitzen, sowie die Anzahl der von Ihnen verwendeten Lizenzen.

So weisen Sie zu:

1. Navigieren Sie zu Setup.
2. Suchen Sie nach und wählen Sie Installierte Pakete.
3. Suchen Sie Avonni Experience Components und klicken Sie auf Lizenzen verwalten.
4. Klicken Sie auf Benutzer hinzufügen.
5. Wählen Sie alle Benutzer aus, die Zugriff benötigen, und klicken Sie auf Speichern.

---

Schritt 2: Berechtigungssätze zuweisen

Sobald die Lizenz zugewiesen ist, müssen Sie den richtigen Berechtigungssatz basierend auf der Rolle des Benutzers zuweisen. Das Avonni-Paket enthält drei verschiedene Berechtigungssätze.

Wählen Sie den richtigen Berechtigungssatz für Ihren Benutzer aus:

Rolle	Name des Berechtigungssatzes	Funktion
Endbenutzer (Experience Cloud & App Builder)	Avonni Experience Cloud Components User	Erforderlich für Benutzer, die Komponenten auf Experience Sites oder Standardseiten des Lightning App Builder anzeigen.
Endbenutzer (Dynamische Komponenten)	Avonni Dynamic Components User	Erforderlich für Benutzer, die mit Dynamic Components (z. B. benutzerdefinierten Datentabellen, Aktionsschaltflächen) innerhalb von Salesforce interagieren.
Admins & Builder	Avonni Experiences Admin	Erforderlich für Benutzer, die Layouts mit dem Avonni Component Builder erstellen, bearbeiten oder aufbauen müssen.

So weisen Sie zu:

1. Navigieren Sie zu Setup > Berechtigungssätze.
2. Wählen Sie den passenden Berechtigungssatz aus der obigen Tabelle aus.
3. Klicken Sie auf Zuweisungen verwalten > Zuweisung hinzufügen.
4. Wählen Sie die Benutzer aus, denen Sie in Schritt 1 Lizenzen zugewiesen haben.
5. Klicken Sie auf Zuweisen.

---

Konfiguration für Gastbenutzer

Gastbenutzer (nicht authentifizierte Besucher auf öffentlichen Websites) benötigen keine standardmäßige Paketlizenz, aber sie benötigen Berechtigungen.

Hinweis

Der Gastbenutzerzugriff für Produktionsumgebungen ist eine Zusatzfunktion. Bitte kontaktieren Sie den Support für Details.

So aktivieren Sie den Gastzugriff:

1. Öffnen Sie Ihre Experience-Cloud-Site im Builder.
2. Gehen Sie zu Einstellungen > Allgemein und klicken Sie auf den Link zum Gastbenutzerprofil.
3. Scrollen Sie in den Profileinstellungen zu Berechtigungssatz-Zuweisungen.
4. Fügen Sie dem Profil den Berechtigungssatz Avonni Experience Cloud Components hinzu.

Fehlerbehebung bei Zugriffsproblemen

Wenn ein Benutzer den Fehler meldet „Sie haben keinen Zugriff auf diese Avonni-Komponente,“ prüfen Sie Folgendes:

Problem	Lösung
Lizenz fehlt	Stellen Sie sicher, dass der Benutzer aufgeführt ist in Installierte Pakete > Lizenzen verwalten.
Berechtigung fehlt	Stellen Sie sicher, dass dem Benutzer der Avonni Experience Cloud Components Berechtigungssatz zugewiesen ist.
LWS deaktiviert	Stellen Sie sicher, dass Lightning Web Security aktiviert ist in Setup.

---

Optional: Routing für Routen auf der Karte

Die Kartenkomponente kann eine Fahrtroute mit mehreren Stopps planen. Diese Funktion ist deaktiviert, bis ein Administrator sie aktiviert, und sie erfordert eine separate Einrichtung unabhängig von Lizenzen und Berechtigungssätzen.

• Routing ist bring-your-own-key — Sie stellen einen API-Schlüssel von OpenRouteService oder Mapbox bereit. Avonni hostet kein Routing-Backend.
• Aktivieren Sie es über die Registerkarte Einstellungen der Avonni Experiences App im App Launcher.
• Durch die Aktivierung wird ein Berechtigungssatz für den aktiven Anbieter erstellt, Avonni Route ORS Access oder Avonni Route Mapbox Access. Da sie an diesem Punkt erstellt und nicht mit dem Paket ausgeliefert werden, erscheinen sie nicht in der Berechtigungssatzliste einer Neuinstallation.
• Weisen Sie diesen Berechtigungssatz allen zu, die Routen auf einer Karte berechnen müssen. Weisen Sie ihn auf einer öffentlichen Site auch dem Gastbenutzerprofil zu, wenn Site-Besucher Routen berechnen.

Vollständige Anleitung: Routing-Einrichtung.