Supporto di Microsoft Power Platform CLI per Power Pages

Microsoft Power Platform CLI (Command Line Interface) è un'interfaccia della 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, vai a Cos'è Microsoft Power Platform CLI?.

Con questa funzionalità, Microsoft Power Platform CLI abilita la configurazione del sito Power Pages CI/CD (Integrazione continua/distribuzione continua). Ora puoi eseguire il check-in della configurazione del sito Web per il controllo del codice sorgente e spostare tale configurazione in qualsiasi ambiente tramite Microsoft Power Platform CLI.

Perché conviene usare Microsoft Power Platform CLI per lo sviluppo del sito Web?

Con Microsoft Power Platform CLI, ora puoi utilizzare funzionalità di tipo offline per la personalizzazione del sito Web apportando modifiche al contenuto del sito Web. E una volta salvate tutte le personalizzazioni o le modifiche, puoi caricare la configurazione del sito Web in Microsoft Dataverse. Quando scarichi il contenuti del sito Web 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 della configurazione del sito Web 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 sito Web 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 seguenti.

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

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 Profili di sviluppo 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 --modelVersion 2

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

File manifesto

Quando scarichi il contenuto del sito Web utilizzando il comando pac paportal download CLI, insieme al download del contenuto del sito vengono generati anche due file manifest;

• 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 manifest dell'ambiente è 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, vengono aggiunti i record eliminati dal file manifest dell'ambiente (org-url-manifest.yml) nel file manifest.yml. Pertanto, quando carichi il contenuto del sito Web utilizzando il comando pac paportal upload, i file vengono eliminati dall'ambiente (anche in un ambiente diverso). Questo file non viene eliminato e viene utilizzato indipendentemente dall'ambiente a cui sei connesso. Questo file deve essere preso in considerazione quando si inviano modifiche al controllo del codice sorgente per prendere in considerazione l'eliminazione di elementi nell'ambiente di destinazione.

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)

Altre considerazioni

• 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, Microsoft Power Platform CLI 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

Vedi anche

• Microsoft Power Platform CLI
• Utilizzare l'estensione Visual Studio Code (anteprima)