Übung – Eine Liste der Konten anzeigen

Abgeschlossen

Der Zweck dieser Übungseinheit besteht darin, mit Liquid auf Microsoft Dataverse-Daten zuzugreifen.

Diese Übungen funktionieren am besten, wenn Sie mit einigen Beispieldaten arbeiten können. Je nachdem, in welcher Umgebung Sie arbeiten, hätten Sie für die Übungen vielleicht gern geeignete Beispieldaten zur Hand. Microsoft Power Platform ermöglicht es Ihnen, nach Belieben Beispieldaten hinzufügen. Wenn in der Umgebung, mit der Sie arbeiten, keine Beispieldaten installiert sind, führen Sie die Schritte in der Dokumentation Beispieldaten hinzufügen oder entfernen aus, um in Ihrer Umgebung die Beispieldaten zu installieren.

Lernziele

Das Ziel dieser Übungen ist, dass Sie Folgendes lernen:

  • Liquid-Code als Teil des Seiteninhalts eingeben

  • Mit Liquid auf Dataverse-Daten zugreifen

  • Bedingte Anweisungen hinzufügen, um nur verfügbare Daten anzuzeigen

Voraussetzungen

Für diese Übung müssen Sie die folgenden Parameter in Ihrer Umgebung festlegen:

  • Eine bereitgestellte Power Pages-Website Wenn Ihnen keine Website zur Verfügung steht, folgen Sie den Anweisungen Eine Seite mit Power Pages erstellen.

  • Zugriff auf das Power Pages-Designstudio

Wesentliche Schritte

In dieser Übung zeigen Sie ausgewählte Dataverse-Datensätze an, indem Sie dem Abschnitt „Webseitenkopie“ HTML‑ und Liquid-Code über den Code-Editor des Power Pages-Designstudio hinzufügen.

  1. Öffnen Sie Ihre Website im Power Pages-Designstudio.

  2. Fügen Sie eine Lieferanten-Webseite hinzu.

  3. Fügen Sie HTML‑ und Liquid-Code hinzu, in dem alle aktiven Konten aufgelistet sind.

  4. Zeigen Sie eine Vorschau der Ergebnisse im Designstudio und in einem Browser an.

  5. Fügen Sie für die Kontotabelle Tabellenleseberechtigungen hinzu, und überprüfen Sie die Ergebnisse in einem Browser.

Detaillierte Schritte

Folgen Sie den detaillierten Schritte in diesem Abschnitt, um diese Übung abzuschließen.

Das Power Pages-Designstudio starten

Gehen Sie folgendermaßen vor, um Power Pages-Designstudio zu starten:

  1. Melden Sie sich bei Power Pages an.

  2. Wählen Sie in der oberen rechten Ecke die richtige Umgebung aus.

  3. Wählen Sie die Website und dann Bearbeiten aus.

Eine Lieferanten-Webseite erstellen

Führen Sie die folgenden Schritte aus, um die Lieferanten-Webseite zu erstellen:

  1. Wählen Sie den Arbeitsbereich Seiten aus.

  2. Wählen Sie + Seite aus.

    • Geben Sie als Seitenname Lieferanten ein.

    • Wählen Sie die Vorlage Leer starten aus.

    • Klicken Sie auf Hinzufügen.

Quellcode bearbeiten

Gehen Sie wie folgt vor, um den Quellcode zum Auflisten aller aktiven Konten zu bearbeiten:

  1. Wählen Sie den Inhalt auf der Seitencanvas aus, und fügen Sie dann eine Textkomponente hinzu.

  2. Ersetzen Sie den Komponentenplatzhalter mit dem folgenden Text:

    <h2>List of accounts</h2>
    {% entityview logical_name:'account', name:'Active Accounts' %}
    <p>We have {{ entityview.total_records }} accounts.</p>
    <ul>
      {% for account in entityview.records -%}
      <li>{{ account.name }}
        {% if account.telephone1 %}
        (<a href="tel:{{ account.telephone1 }}">{{ account.telephone1 }}</a>)
        {% endif %}
      </li>
      {% endfor %}
    </ul>
    {% endentityview %}
    
  3. Klicken Sie auf Sync.

  4. Die Liste der aktuellen Konten sollte Ihnen auf dem Canvas angezeigt werden, einschließlich der mit Hyperlinks versehenen Telefonnummern, wo sie vorhanden sind.

    Screenshot einer Liste von Konten auf einer Seite im Designstudio

    Wichtig

    Mit Designstudio können Sie Liquid mit einer Standardtextkomponente eingeben. Nachdem Sie die Seite gespeichert und synchronisiert haben, konvertiert Power Pages die Textkomponente in eine erweiterte Komponente und zeigt an, dass die Inline-Bearbeitung nicht mehr verfügbar ist. Sie können weiterhin auf den Liquid-Code im Visual Studio Code-Editor zugreifen, den Sie durch Klicken auf die Schaltfläche Code bearbeiten starten können.

  5. Wählen Sie Vorschau > Desktop aus. Die angezeigte Webseite sollte nur den Text „Wir haben 0 Konten“ enthalten.

    Hinweis

    Dieses Ergebnis wird erwartet, da Power Pages zur Laufzeit den Zugriff auf Tabellenzeilen verweigert, es sei denn, es gibt einen Tabellenberechtigungsdatensatz, der den Zugriff auf die Daten erlaubt.

Tabellenberechtigungen hinzufügen

Wir müssen Tabellenberechtigungen hinzufügen, um die Liste der Kontodatensätze beim Durchsuchen einer Seite anzuzeigen.

Warnung

In dieser Übung fügen Sie für alle Besucher globale Leseberechtigungen für die Kontotabelle hinzu. Es handelt sich bei dieser Einrichtung um keine typische Sicherheitskonfiguration und dient nur zu Demonstrationszwecken.

Führen Sie die folgenden Schritte aus, um Tabellenberechtigungen hinzuzufügen:

  1. Wählen Sie den Arbeitsbereich Einrichtung und dann Tabellenberechtigungen aus.

  2. Wählen Sie + Neu aus.

  3. Geben Sie die folgenden Werte ein:

    • Name – Lieferanten

    • Tabelle – Wählen Sie die Tabelle Konto aus.

    • Zugriffstyp – Wählen Sie Globaler Zugriff aus.

    • Berechtigung für – Wählen Sie Lesen aus.

  4. Wählen Sie Rollen hinzufügen aus.

  5. Wählen Sie Anonyme Benutzer und Authentifizierte Benutzer aus.

  6. Wählen Sie Speichern aus.

  7. Wählen Sie Vorschau > Desktop aus.

    Eine Liste aller Konten sollte angezeigt werden.

    Screenshot von einer Webseite, die eine Liste von Konten in einer anonymen Browsersitzung anzeigt