Esercitazione: utilizzare l'interfaccia della riga di comando di Microsoft Power Platform con i portali

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.

In questo esempio di esercitazione, vedrai come iniziare a utilizzare l'interfaccia della riga di comando di Microsoft Power Platform per aggiornare la configurazione di portali di esempio.

Nota

• È inoltre possibile utilizzare l'interfaccia della riga di comando di Power Platform con Power Pages. Altre informazioni: Cos'è Power Pages?
• Questa esercitazione descrive i comandi di Microsoft Power Platform CLI necessari per l'uso di portali Power Apps. Per ulteriori informazioni sui comandi utilizzati in Power Platform CLI, leggi comandi comuni.

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 portali disponibili

Usa il comando pac paportal list per elencare i portali Power Apps disponibili nell'ambiente Dataverse a cui ti sei connesso nel passaggio precedente.

pac paportal list

Passaggio 3: Scaricare il contenuti di portali

Scarica il contenuto del sito Web del portale dall'ambiente Dataverse connesso utilizzando il comandopac paportal download .

pac paportal download --path [PATH] -id [WebSiteId-GUID]

Esempio

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

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

Passaggio 4: Modificare il contenuto dei portali

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

Nota

Assicurati di aggiornare solo le tabelle supportate per l'uso con Power Platform CLI. Per altre informazioni, vedi Tabelle supportate.

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:

Suggerimento

Puoi modificare la posizione del percorso della cartella in PowerShell/terminale integrato nella posizione scaricata e immettere "code ." per aprire la cartella direttamente in Visual Studio Code.

Passaggio 5: Caricare le modifiche

Nota

• Se stai caricando in più ambienti, vedi caricare le modifiche utilizzando il profilo di distribuzione per informazioni su come caricare le modifiche utilizzando il profilo di distribuzione.
• Verifica che la dimensione massima dell'allegato dell'ambiente di destinazione sia impostata sulla stessa dimensione o su una dimensione maggiore dell'ambiente di origine.
• La dimensione massima dei file è determinata dall'impostazione Dimensione massima del file nella scheda e-mail delle impostazioni di sistema nella finestra di dialogo delle impostazioni di sistema dell'ambiente.

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

pac paportal upload --path [Folder-location]

Esempio

pac paportal upload --path C:\pac-portals\downloads\custom-portal\

Nota

Assicurati che il percorso del contenuto dei portali che hai inserito sia corretto. Per impostazione predefinita, viene creata una cartella denominata dal portale (nome descrittivo) con il contenuto dei portali scaricati. Ad esempio, se il nome descrittivo del portale è custom-portal il percorso per il comando precedente (--path) deve essere C:\pac-portals\downloads\custom-portal.

Il caricamento avviene solo per i contenuti che sono stati modificati. 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 comando pac paportal upload per caricare il contenuto:

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

   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 del portale:

1. Cancella la cache lato server, o usa Configurazione sincronizzazione usando Studio nei portali Power Apps.

2. Sfoglia la pagina Web del portale per vedere la modifica.

   

3. Se hai utilizzato un esempio di profilo di distribuzione spiegato in precedenza, il frammento YAML aggiornerà il valore come mostrato di seguito.

   

   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

• Interfaccia della riga di comando di Microsoft Power Platform
• Utilizzare l'estensione Visual Studio Code (anteprima)