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