Esercitazione: utilizzare Microsoft Power Platform CLI con Power Pages

In questa esercitazione imparerai come iniziare a utilizzare Microsoft Power Platform CLI per aggiornare la configurazione di un sito Web di esempio.

Scaricare e installa Visual Studio Code

Per connetterti a portali Power Apps e per utilizzare i comandi di Microsoft Power Platform CLI, usa Visual Studio Code e il terminale integrato. Il terminale integrato facilita il collegamento all'ambiente Dataverse e per scaricare, modificare e caricare la configurazione dei portali. In alternativa, puoi anche utilizzare Windows PowerShell.

Passaggio 1: Autentica

Prima di connetterti, elencare, scaricare o caricare eventuali modifiche per un portale di Power Apps, devi dapprima eseguire l'autenticazione per l'ambiente Dataverse. Per ulteriori informazioni sull'autenticazione mediante l'interfaccia della riga di comando di Microsoft Power Platform, vai a pac auth.

Per eseguire l'autenticazione, apri Windows PowerShell ed esegui il comando pac auth create utilizzando l'URL dell'ambiente Dataverse.

pac auth create -u [Dataverse URL]

Esempio

pac auth create -u https://contoso-org.crm.dynamics.com

Segui le richieste di autenticazione per accedere all'ambiente.

Passaggio 2. Elencare i siti Web disponibili

Usa il comando elenco pac powerpages per elencare i siti Web Power Pages disponibili nell'ambiente Dataverse a cui ti sei connesso nel passaggio precedente.

pac powerpages list

Passaggio 3: Scarica contenuti siti Web

Scarica il contenuto del sito Web dall'ambiente Dataverse connesso utilizzando il comando pac powerpages download.

pac powerpages download --path [PATH] -id [WebSiteId-GUID] --modelVersion [DataModel]

Esempio

pac powerpages download --path c:\pac-portals\downloads -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141 --modelVersion 2

Per il parametro id, utilizza WebSiteId restituito dall'output del passaggio precedente.

Passaggio 4: Modificare il contenuto del sito Web

Modifica la configurazione utilizzando Visual Studio Code e salva le modifiche.

Ad esempio, la pagina del portale predefinita mostra un testo come questo:

Questo testo è visibile dalla pagina web html:

Puoi modificare questo testo e salvare le modifiche:

Passaggio 5: Caricare le modifiche

Dopo aver apportato le modifiche necessarie, caricale utilizzando il comando pac powerpages upload:

pac powerpages upload --path [Folder-location] --modelVersion [ModelVersion]

Esempio

pac powerpages upload --path C:\pac-portals\downloads\custom-portal\ --modelVersion 2

Il caricamento avviene solo per il contenuto modificato. In questo esempio, poiché la modifica viene apportata a una pagina Web, il contenuto viene caricato solo per la tabella adx_webpage.

Caricare le modifiche utilizzando il profilo di distribuzione

Quando si lavora con più ambienti diversi, è possibile prendere in considerazione l'utilizzo dei profili di distribuzione per assicurarsi che le modifiche vengano caricate nell'ambiente corretto utilizzando il profilo di distribuzione.

1. Crea una cartella denominata profili di distribuzione all'interno della cartella contenente il contenuto del portale. Ad esempio, se il contenuto del portale scaricato si trova all'interno di "starter-portal", la cartella dei profili di distribuzione dovrebbe trovarsi all'interno di questa cartella.

   

2. All'interno della cartella dei profili di distribuzione, crea un file YAML di distribuzione che contenga le modifiche specifiche dell'ambiente. Ad esempio, l'ambiente di sviluppo si potrebbe chiamare "dev.deployment.yml".

   

3. Modifica il file YAML di distribuzione usando Visual Studio Code con il seguente formato:

   <table-name>:
   - <record-id>: <GUID>
     <column-name>: <Name>
     <column-value>: <Value>
   

   Ad esempio, il seguente codice YAML di esempio aggiorna il valore di "Browser Title Suffix" da "Custom Portal" predefinito a "Custom Portal (Dev)".

   adx_contentsnippet:
       - adx_contentsnippetid: 76227a41-a33c-4d63-b0f6-cd4ecd116bf8 # Replace with your content snippet ID
         adx_name: Browser Title Suffix # Setting name
         adx_value:   · Custom Portal (Dev) # Setting value
   

4. Per caricare le modifiche in un ambiente diverso utilizzando un file YAML del profilo di distribuzione, autentica l'organizzazione di destinazione.

5. Dopo esserti autenticato e connesso all'ambiente corretto, usa il seguente comando pac powerpages upload per caricare il contenuto:

   pac powerpages upload --path "C:\portals\starter-portal" --deploymentProfile dev --modelVersion 2

   Nota

   Nell'esempio precedente, il nome del profilo di distribuzione utilizzato è "dev" dopo aver seguito i passaggi precedenti per creare un profilo di distribuzione di sviluppo. Cambia il nome da "dev" a qualsiasi altro (come QA per "qa.deployment.yml" o Test per "test.deployment.yml") se hai utilizzato un nome file diverso per il tuo file YAML di distribuzione.

Passaggio 6. Confermare le modifiche

Per confermare le modifiche apportate alla pagina Web:

1. Seleziona Sincronizza nella finestra di progettazione Power Pages.

2. Per visualizzare la modifica, accedi alla pagina Web.

   

3. Se hai utilizzato un esempio di profilo di distribuzione spiegato in precedenza, il frammento di codice YAML aggiorna il valore come mostrato nello screenshot seguente.

   

   Il suffisso del titolo del browser aggiornato tramite la modifica precedente mostra la modifica quando si apre il portale in un browser:

   

Qui si conclude l'esercitazione. Puoi ripetere i passaggi precedenti e modificare il contenuto dei portali per altre tabelle supportate.

Passaggi successivi

Utilizzare l'estensione Visual Studio Code

Vedi anche

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