Unterstützung von Portalen für Microsoft Power Platform CLI

Hinweis

Ab 12. Oktober 2022 ist Power Apps-Portale Power Pages. Weitere Informationen: Microsoft Power Pages ist jetzt allgemein verfügbar (Blog)
Wir werden die in Kürze migrieren und die Dokumentation für Power Apps-Portale mit der Power Pages-Dokumentation zusammenführen.

Microsoft Power Platform CLI (Befehlszeilenschnittstelle) ist eine einfache Befehlszeilenschnittstelle für Entwickler, mit der Entwickler und App-Hersteller Codekomponenten erstellen können.

Microsoft Power Platform CLI-Tooling ist der erste Schritt zu einem umfassenden Application Life Cycle Management (ALM), bei dem Unternehmensentwickler und ISVs ihre Erweiterungen und Anpassungen schnell und effizient erstellen, bauen, debuggen und veröffentlichen können. Weitere Informationen finden Sie unter Was versteht man unter Microsoft Power Platform CLI?

Mit dieser Funktion unterstützen Microsoft Power Apps-Portale das Microsoft Power Platform CLI zum Aktivieren von CI/CD (kontinuierliche Integration/kontinuierliche Bereitstellung) der Portalkonfiguration. Sie können jetzt die Portalkonfiguration in die Quellcodeverwaltung einpflegen und die Portalkonfiguration mithilfe von Microsoft Power Platform CLI in eine beliebige Umgebung verschieben.

Hinweis

Diese Funktion ist allgemein ab der Power Platform CLI-Version 1.9.8 verfügbar. Wie Sie die neueste Version installieren, erfahren Sie unter Installation von Microsoft Power Platform CLI.

Warum sollte ich Microsoft Power Platform CLI für die Entwicklung von Portalen verwenden?

Mit der Portalunterstützung für Microsoft Power Platform CLI können Sie jetzt offline-ähnliche Funktionen für die Portalanpassung verwenden, indem Sie Änderungen am Portalinhalt vornehmen. Und sobald alle Anpassungen oder Änderungen gespeichert sind, laden Sie sie in das Portal hoch. Wenn Sie Portalinhalte mit Microsoft Power Platform CLI herunterladen, ist der Inhalt in YAML- und HTML-Formaten strukturiert, sodass er leicht angepasst werden kann und eine entwicklungsfreundliche Erfahrung bietet.

Hier ist eine Liste von Funktionen und Fähigkeiten, von denen Portale mit der Unterstützung Microsoft Power Platform CLI profitieren:

Einfache Verwendung

• Unterstützung für das Herunterladen/Hochladen von Portaldaten zum/vom lokalen Dateisystem

• Aufbau auf dem bestehenden Microsoft Power Platform CLI-Tool.

Application Lifecycle Management (ALM)

• Verfolgen Sie Änderungen an der Portalkonfiguration innerhalb einer Organisation

• Verschieben von Konfigurationsdateien zwischen Organisationen oder Mandanten

Unterstützung für Profientwickler und Unternehmen

• Hilft bei der nahtlosen Integration mit allen Quellcodeverwaltungstools wie „git“

• Einfache Einrichtung von CI/CD-Pipelines

Microsoft Power Platform CLI installieren

Schritt-für-Schritt-Anleitungen finden Sie unter Installieren von Microsoft Power Platform CLI.

Unterstützte Tabellen

Portalunterstützung für Microsoft Power Platform CLI ist auf die unten aufgeführten Tabellen beschränkt.

adx_ad

adx_adplacement

adx_blog

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding (nur herunterladen)

adx_websitelanguage

adx_webtemplate

Anmerkung

Wichtig

• Benutzerdefinierte Tabellen und portalvorlagenspezifische Tabellen (wie Blog-, Community- oder Ideenportal) werden für die Anpassung mit Microsoft Power Platform CLI nicht unterstützt.
• Bilddateianhänge für Anzeigendatensätze (adx_ad) werden nicht mit der Power Platform-CLI heruntergeladen. Verwenden Sie als Problemumgehung das Bild URL-Feld oder durch Hinzufügen einer HTML-Referenz im Kopieren-Feld zu einem Web-Datei-Datensatz, der eine Bilddatei enthält.

Microsoft Power Platform CLI für Portale installieren und überprüfen

Mehr über die Installation von Microsoft Power Platform CLI erfahren Sie unter Microsoft Power Platform CLI installieren.

Öffnen Sie nach der Installation von Microsoft Power Platform CLI eine Eingabeaufforderung und führe sie pac aus, um zu überprüfen, ob die Ausgabe „paportal“, den Befehl für Power Apps-Portale, enthält.

Microsoft Power Platform CLI-Befehle für Portale

Der Microsoft Power Platform CLI-Befehl für Portale ist „paportal“.

In den folgenden Abschnitten finden Sie zusätzliche Details zu den verschiedenen Eigenschaften des „paportal“ Befehls.

Parameter

Eigenschaftsname	Beschreibung des Dataflows	Beispiel
list	Enthält alle Portalwebsites aus der aktuellen Dataverse-Umgebung.	pac paportal list
download	Laden Sie den Inhalt der Portal-Website aus der aktuellen Dataverse-Umgebung herunter. Verfügt über die folgenden Parameter: - Pfad: Pfad, in dem der Inhalt der Website heruntergeladen wird (Alias: -p) - webSiteId: Portal-Website-ID, die heruntergeladen werden soll (Alias: -ID) - überschreiben: (Optional) true - um vorhandenen Inhalt zu überschreiben, false - um fehlzuschlagen, wenn der Ordner bereits Website-Inhalt hat (Alias: -o)	pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902
upload	Hochladen von Portal-Website-Inhalten in die aktuelle Dataverse-Umgebung. Es hat die folgenden Parameter: - path: Pfad, in dem der Website-Inhalt gespeichert ist (Alias: -p) -Bereitstellungsprofil: Portaldaten mit Umgebungsdetails hochladen, die durch Profilvariablen in der Datei deployment-profiles/[profile-name].deployment.yaml definiert wurden.	pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"

Bereitstellungsprofil verwenden

Der Bereitstellungsprofil Wechsler kann eine Reihe von Variablen für die Umgebung im YAML-Format definieren. Sie können beispielsweise unterschiedliche Bereitstellungsprofile (wie dev, Test, prod) haben, für die unterschiedliche Schemadetails im Profil definiert sind.

Wenn Sie ein Testprofil erstellen, können Sie eine Datei unter Bereitstellungsprofile mit dem Namen test.deployment.yml" (d. h. <profileTag>.bereitstellung.yml) verwenden. Und Sie können den Befehl mit dem Tag (<profileTag>) ausführen, um dieses Profil zu verwenden:

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test

In dieser Datei können Sie den Tabellen-(Entitäts-)Namen mit der Tabellen-ID, die Liste der Attribute und die Werte haben, die Sie beim Hochladen der Portalkonfiguration deploymentProfile Parameter überschreiben möchten.

Zusätzlich können Sie die OS Variable verwenden, um auf die Umgebungsvariablen des Betriebssystems zuzugreifen.

Hier ist ein Beispiel für diese YAML-Profildatei test.deployment.yml, die eindeutige Schemadetails enthält:

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

Hinweis

Um mehr über alle Befehle zu erfahren, die in CLI zusätzlich zu Portalen verwendet werden, gehen Sie zu Häufige Befehle in Microsoft Power Platform CLI.

Manifestdateien

Wenn Sie den Inhalt der Website herunterladen, indem Sie den pac paportal download-CLI-Befehl beim Herunterladen des Website-Inhalts verwenden, werden auch zwei Manifest-Dateien generiert;

• Umgebungsmanifestdatei (org-url-manifest.yml)
• Tracking-Manifestdatei löschen (manifest.yml)

Umgebungsmanifestdatei (org-url-manifest.yml)

Die Manifestdatei der Umgebung wird jedes Mal generiert, wenn der pac paportal download-Befehl ausgeführt wird.

Nach jedem Download liest das PAC CLI-Tool die vorhandene Umgebungsmanifestdatei und aktualisiert die in der Umgebung gelöschten Einträge oder erstellt die Umgebungsmanifestdatei, falls sie nicht vorhanden ist.

Beim Ausführen des pac paportal upload-Befehls zum Hochladen des Inhalts der Portal-Website. Es liest die Umgebungsmanifestdatei und identifiziert die seit dem letzten Download vorgenommenen Änderungen und lädt nur die aktualisierten Inhalte hoch. Dies hilft bei der Optimierung des Upload-Prozesses, da nur aktualisierte Website-Inhalte hochgeladen werden, anstatt den gesamten Inhalt bei jedem Upload-Befehl hochzuladen.

Die Umgebungsmanifestdatei ist schreibgeschützt, wenn sie sich mit derselben Umgebung verbindet (Umgebungs-URL stimmt mit dem Dateinamen überein), um versehentliche Änderungen zu vermeiden.

Tracking-Manifestdatei löschen (manifest.yml)

Diese Datei wird zum Verfolgen der gelöschten Datensätze aus der Umgebung verwendet.

Beim Herunterladen von Website-Inhalten mit dem pac paportal download-Befehl, fügt dies die gelöschten Datensätze aus der Manifestdatei der Umgebung (org-url-Manifest.yml) in der Manifest.yml-Datei hinzu. Wenn Sie also den Website-Inhalt mit dem pac paportal upload-Befehl hochladen, werden die Dateien aus der Umgebung gelöscht (sogar in einer anderen Umgebung). Diese Datei wird nicht gelöscht und unabhängig davon verwendet, mit welcher Umgebung Sie verbunden sind.

Hinweis

Um die Website-Inhaltsdatensätze in einer Umgebung zu löschen und dieselben Inhaltsdatensätze in einer anderen Umgebung mit der PAC-CLI zu löschen, müssen Sie den pac paportal download-Befehl vor und nach dem Löschen des Website-Datensatzinhalts verwenden. Die manifest.yml verfolgt diese Änderungen und entfernt die entsprechenden Datensätze in der Zielumgebung, wenn der pac paportal upload-Befehl ausgeführt wird.

Erweiterung von Visual Studio Code verwenden

Sie können auch die VS Code-Erweiterung Power Platform VS Code-Erweiterung verwenden, um die integrierte Liquid-Sprache von IntelliSense zu nutzen, Hilfe bei der Codevervollständigung zu erhalten, Hinweise zu nutzen und mit dem Microsoft Power Platform CLI mit dem integrierten VS Code-Terminal zu interagieren. Weitere Informationen: Erweiterung von Visual Studio Code verwenden (Vorschauversion)

Weitere Überlegungen

• Ein Fehler wird gemeldet, wenn Ihr Dateipfad die Beschränkung der maximalen Pfadlänge überschreitet. Weitere Informationen: Begrenzung der maximalen Pfadlänge in Windows
• Bei doppelten Datensätzen, wie einem doppelten Webseitennamen, erstellt Microsoft Power Platform CLI zwei verschiedene Ordner—– einen mit dem Namen der Webseite und einen anderen mit demselben Namen, dem ein Hash vorangestellt ist. Zum Beispiel „Meine Seite“ und „Meine Seite-Hash“.

Nächste Schritte

Tutorial: Microsoft Power Platform CLI mit Portalen verwenden

Siehe auch

• Microsoft Power Platform CLI
• Erweiterung von Visual Studio Code verwenden (Vorschauversion)