Supporto dei portali per l'interfaccia della riga di comando di Microsoft Power Platform
Nota
A partire dal 12 ottobre 2022, i portali Power Apps sono denominati Power Pages. Altre informazioni: Microsoft Power Pages è ora generalmente disponibile (blog)
A breve verrà eseguita la migrazione e l'unione della documentazione dei portali Power Apps con la documentazione di Power Pages.
Microsoft Power Platform CLI (Command Line Interface) è un'interfaccia a riga di comando per sviluppatori semplice e completa che consente a sviluppatori e creatori di app di creare componenti di codice.
Gli strumenti di Microsoft Power Platform CLI sono il primo passo verso una storia completa di gestione del ciclo di vita delle applicazioni (ALM) in cui gli sviluppatori aziendali e gli ISV possono eseguire la creazione, la compilazione, il debug e la pubblicazione delle proprie estensioni e personalizzazioni in modo rapido ed efficiente. Per altre informazioni su , vedi Cos'è l'interfaccia della riga di comando di Microsoft Power Platform?
Con questa funzionalità, i portali Microsoft Power Apps supportano l'interfaccia della riga di comando Microsoft Power Platform per abilitare CI/CD (Continuous Integration/Continuous Deployment) della configurazione del portale. Ora puoi eseguire il check-in della configurazione del portale per il controllo del codice sorgente e spostare tale configurazione in qualsiasi ambiente utilizzando l'interfaccia della riga di comando Microsoft Power Platform.
Nota
Questa funzione è generalmente disponibile a partire dall'interfaccia della riga di comando Power Platform versione 1.9.8. Per informazioni sull'installazione dell'ultima versione, vedi Installare l'interfaccia della riga di comando Microsoft Power Platform.
Perché conviene usare Microsoft Power Platform CLI per lo sviluppo di portali?
Con il supporto dei portali per Microsoft Power Platform CLI, ora puoi utilizzare funzionalità di tipo offline per la personalizzazione dei portali apportando modifiche al contenuto dei portali. E una volta salvate tutte le personalizzazioni o le modifiche, le puoi caricare nel portale. Quando scarichi il contenuti dei portali usando Microsoft Power Platform CLI, il contenuto viene strutturato nei formati YAML e HTML che lo rendono facile da personalizzare, consentendo un'esperienza di sviluppo professionale.
Ecco un elenco di caratteristiche e funzionalità di cui i portali beneficiano con il supporto per Microsoft Power Platform CLI:
Semplicità di utilizzo
Supporto per il download/upload dei dati del portale da/verso il file system locale
Compilazione sullo strumento Microsoft Power Platform CLI esistente.
Application Lifecycle Management (ALM)
Tieni traccia delle modifiche alla configurazione del portale all'interno di un'organizzazione
Spostamento dei file di configurazione tra organizzazioni o tenant
Supporto professionale e aziendale
Perfetta integrazione con qualsiasi strumento di controllo del codice sorgente, come "git"
Configurazione agevole delle pipeline CI/CD
Installare Microsoft Power Platform CLI
Per istruzioni dettagliate, fai riferimento a Installare l'interfaccia della riga di comando di Microsoft Power Platform.
Tabelle supportate
Il supporto dei portali per Microsoft Power Platform CLI è limitato alle tabelle elencate di seguito.
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 (solo download)
adx_websitelanguage
adx_webtemplate
Annotazione
Importante
- Le tabelle personalizzate e le tabelle specifiche del modello di portale (come blog, community o portale di idee) non sono supportate per la personalizzazione con Microsoft Power Platform CLI.
- I file di immagine allegati ai record di annunci (adx_ad) non vengono scaricati utilizzando l'interfaccia della riga di comando di Power Platform. Come soluzione alternativa, utilizza il campo URL immagine o aggiungi un riferimento HTML nel campo Copia ad un record di file Web contenente un file immagine.
Installare e verificare Microsoft Power Platform CLI per portali
Per informazioni sull'installazione di Microsoft Power Platform CLI, vai a Installare Microsoft Power Platform CLI.
Dopo l'installazione dell'interfaccia della riga di comando di Microsoft Power Platform, apri un prompt dei comandi ed esegui pac per verificare che l'output contenga "paportal", il comando per portali Power Apps.
Comandi di Microsoft Power Platform CLI per portali
Il comando dell'interfaccia della riga di comando di Microsoft Power Platform per portali è "paportal".
Le sezioni seguenti forniscono più dettagli sulle diverse proprietà del comando "paportal".
Parametri
| Nome proprietà | Description | Esempio |
|---|---|---|
| list | Elenca tutti i siti Web del portale dell'ambiente Dataverse corrente. | pac paportal list |
| download | Scarica il contenuto del sito Web del portale dall'ambiente Dataverse corrente. Ha i parametri seguenti: - path: percorso in cui verrà scaricato il contenuto del sito Web (alias: -p) - webSiteId: ID del sito web del portale da scaricare (alias: -id) - overwrite: (facoltativo) true - per sovrascrivere il contenuto esistente, false - per non riuscire se la cartella ha già contenuto del sito Web (alias: -o) |
pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902 |
| upload | Carica il contenuto del sito Web del portale nell'ambiente Dataverse corrente. Ha il parametro seguente: - path: percorso in cui è archiviato il contenuto del sito Web (alias: -p) -deploymentProfile: Carica i dati del portale con i dettagli dell'ambiente definiti tramite le variabili di profilo nel file deployment-profiles/[profile-name].deployment.yaml |
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name" |
Usare un profilo di distribuzione
Lo switch deploymentProfile ti consente di definire un insieme di variabili per l'ambiente in formato YAML. Ad esempio, puoi avere diversi profili di distribuzione (come dev, test, prod) con differenti dettagli di schema definiti nel profilo.
Se stai creando un profilo di prova, puoi creare un file sotto deployment-profiles con il nome "test.deployment.yml" (ovvero, <profileTag> .deployment.yml). E puoi eseguire il comando con tag (<profileTag>) per utilizzare questo profilo:
pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test
In questo file, puoi avere il nome della tabella (entità) con l'ID della tabella, l'elenco degli attributi e i valori che desideri sovrascrivere durante il caricamento della configurazione del portale utilizzando il parametro deploymentProfile.
Inoltre, puoi utilizzare la variabile OS per accedere alle variabili di ambiente del sistema operativo.
Di seguito è riportato un esempio del file YAML di questo profilo "test.deployment.yml" che include dettagli di schema univoci:
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
Nota
Per informazioni su comandi utilizzati nella CLI oltre ai portali, vai a Comandi comuni in Microsoft Power Platform CLI.
File manifesto
Quando scarichi il contenuto del sito web utilizzando il comando pac paportal download dell'interfaccia della riga di comando, vengono generati anche due file manifesto:
- File manifesto dell'ambiente (org-url-manifest.yml)
- Eliminare il file manifesto di monitoraggio (manifest.yml)
File manifesto dell'ambiente (org-url-manifest.yml)
Il file manifesto dell'ambiente viene generato ogni volta che viene eseguito il comando pac paportal download.
Dopo ogni download, lo strumento dell'interfaccia della riga di comando PAC legge il file manifesto dell'ambiente esistente e aggiorna le voci eliminate nell'ambiente oppure crea il file manifesto dell'ambiente se non esiste.
Quando esegui il comando pac paportal upload per caricare il contenuto del sito web del portale. Legge il file manifesto dell'ambiente e identifica le modifiche apportate dall'ultimo download e carica solo il contenuto aggiornato. Ciò aiuta a ottimizzare il processo di caricamento poiché vengono caricati solo i contenuti del sito Web aggiornati, invece di caricare tutti i contenuti a ogni comando di caricamento.
Il file manifesto dell'ambiente sarà di sola lettura quando si connette allo stesso ambiente (l'URL dell'ambiente corrisponde al nome del file), per evitare modifiche accidentali.
Eliminare il file manifesto di monitoraggio (manifest.yml)
Questo file viene utilizzato per tenere traccia dei record eliminati dall'ambiente.
Quando il contenuto del sito Web viene scaricato con il comando pac paportal download, i record eliminati dal file manifesto dell'ambiente (org-url-manifest.yml) vengono aggiunti al file manifest.yml. Quindi, quando carichi il contenuto del sito Web utilizzando il comando pac paportal upload, i file verranno eliminati dall'ambiente (anche in un ambiente diverso). Questo file non viene eliminato e viene utilizzato indipendentemente dall'ambiente a cui sei connesso.
Nota
Per eliminare i record di contenuto del sito in un ambiente nonché gli stessi record di contenuto in un altro ambiente utilizzando l'interfaccia della riga di comando PAC, dovrai eseguire il comando pac paportal download prima e dopo l'eliminazione del contenuto del record del sito Web. Il file manifest.yml terrà traccia di queste modifiche e rimuoverà i record corrispondenti nell'ambiente di destinazione quando viene eseguito il comando pac paportal upload.
Utilizzare l'estensione Visual Studio Code
Puoi anche usare l'estensione VS Code Estensione codice VS Power Platform per beneficiare del linguaggio Liquid integrato di IntelliSense, assistenza per il completamento del codice, suggerimenti e interazione con Microsoft Power Platform CLI che utilizza il terminale integrato VS Code. Altre informazioni: Utilizzare l'estensione Visual Studio Code (anteprima)
Considerazioni aggiuntive
- Viene segnalato un errore se il percorso di file supera il limite massimo di lunghezza del percorso. Maggiori informazioni: Limitazione della lunghezza massima del percorso in Windows
- Per i record duplicati come un nome di pagina Web duplicato, l'interfaccia della riga di comando di Microsoft Power Platform crea due cartelle diverse differenti: una con il nome della pagina Web e l'altra con lo stesso nome preceduto da un codice hash. Ad esempio, "My-page" e "My-page-codice hash".
Passaggi successivi
Esercitazione: utilizzare Microsoft Power Platform CLI con i portali