Utilizzare l'estensione Visual Studio Code

Visual Studio Code è un editor di codice sorgente leggero e potente per Windows, macOS e Linux. Supporta JavaScript, TypeScript e Node.js e ha un ricco ecosistema di estensioni per altri linguaggi (come C++, C#, Java, Python, PHP e Go) e runtime (come .NET e Unity). Per altre informazioni su Visual Studio Code, vedi Introduzione a VS Code.

Visual Studio Code ti consente di estendere le tue capacità attraverso le estensioni. Le estensioni di Visual Studio Code possono aggiungere più funzionalità all'esperienza complessiva. Con il rilascio di questa funzionalità, ora puoi utilizzare l'estensione Visual Studio Code con portali Power Pages.

Estensione Visual Studio Code per Power Pages

Power Platform Tools aggiunge la capacità di configurare i siti Web utilizzando Visual Studio Code e utilizzare il linguaggio Liquid integrato IntelliSense facilitando il completamento del codice, l'assistenza e i suggerimenti durante la personalizzazione dell'interfaccia dei siti Web utilizzando Visual Studio Code. Utilizzando l'estensione Visual Studio Code, puoi anche configurare portali tramite Microsoft Power Platform CLI.

Prerequisiti

Prima di utilizzare l'estensione Visual Studio Code per Power Pages, devi:

• Scarica, installa e configura Visual Studio Code. Ulteriori informazioni: Scarica Visual Studio Code

• Configura l'ambiente e il sistema per il supporto CI/CD Power Pages usando CLI. Altre informazioni: Microsoft Power Platform CLI (anteprima)

Installare l'estensione Visual Studio Code

Dopo aver installato Visual Studio Code, è necessario installare l'estensione per il componente aggiuntivo Power Platform Tools per Visual Studio Code.

Per installare l'estensione Visual Studio Code:

1. Aprire Visual Studio Code.

2. Seleziona Estensioni nel riquadro sinistro.

   

3. Seleziona l'icona Impostazioni in alto a destra nel riquadro delle estensioni.

4. Cerca e seleziona Power Platform Tools.

   

5. Seleziona Installa.

6. Verifica che l'estensione sia installata correttamente esaminando i messaggi di stato.

Azioni Power Pages

Azioni Power Pages semplifica la gestione del sito e riduce la dipendenza dai comandi di Microsoft Power Platform CLI. Azioni di Power Pages è disponibile nel riquadro Azioni di Power Pages nella barra laterale di Explorer di Visual Studio Code.

All'interno di questo riquadro, i siti sono classificati come segue:

• Siti attivi: siti attualmente disponibili e attivi nell'ambiente selezionato.
• Siti inattivi: siti presenti nell'ambiente ma non attualmente attivi.
• Altri siti: siti scaricati localmente ma non ancora associati all'ambiente selezionato.

Cambiare ambienti

Per cambiare ambienti:

1. Selezionare il pulsante Cambia ambiente nel riquadro Azioni di Power Pages.

   

2. Seleziona l'ambiente desiderato nell'elenco visualizzato.

Quando selezioni un ambiente, l'elenco dei siti si aggiorna automaticamente.

Azioni per i siti

Diversi tipi di siti forniscono azioni specifiche del contesto a cui è possibile accedere facendo clic con il pulsante destro del mouse.

Azioni di Siti attivi

Fai clic con il pulsante destro del mouse su Siti attivi per accedere alle seguenti azioni:

• Anteprima: cancella la cache e apre il sito all'interno di VS Code per un'anteprima immediata.
• Carica: carica le modifiche locali nell'ambiente.
• Download: scarica il contenuto del sito in una cartella locale per la modifica offline.
• Dettagli sito: mostra informazioni dettagliate sul sito.
• Mostra in Explorer: passa alla directory locale contenente il codice del sito.
• Apri nello studio di progettazione di Power Pages: apre il sito nello studio di progettazione di Power Pages.
• Eseguire lo screening codeQL: eseguire l'analisi statica del codice sui file HTML e JavaScript per identificare le vulnerabilità nella codebase usando CodeQL. Questa opzione è disponibile solo per i siti scaricati localmente, indicati dal tag Current nell'elenco dei siti attivi.
• Confronto con Locale: apre una visualizzazione di confronto per identificare le differenze tra l'area di lavoro locale e l'ambiente remoto. Vedere altri dettagli sulla funzionalità di configurazione del sito di confronto.

Azioni Siti inattivi

Siti inattivi fornisce queste azioni:

• Apri gestione sito : apre il sito all'interno dell'applicazione Power Pages Management.
• Dettagli sito: fornisce informazioni dettagliate sul sito selezionato, ad esempio l'ID sito Web, l'URL del sito Web, la versione del modello di dati e altro ancora.

Altre Azioni sito

I siti archiviati in locale ma non ancora nel tuo ambiente offrono le azioni seguenti:

• Carica sito: carica il sito locale nell'ambiente connesso. Dopo il caricamento, il sito viene visualizzato nell'elenco Siti inattivi, dove è possibile attivarlo dalla home page di Power Pages.
• Mostra in Explorer: passa alla directory locale contenente il codice del sito.

Icone di file

L'estensione Visual Studio Code per Power Pages identifica e mostra automaticamente le icone per file e cartelle all'interno del contenuto dei siti Web scaricato.

Visual Studio Code utilizza l'impostazione predefinita del tema dell'icona del file che non mostra le icone specifiche Power Pages. Per visualizzare le icone di file specifiche per i tuoi siti Web, dovrai aggiornare l'istanza di Visual Studio Code per utilizzare il tema dell'icona del file specifico per Power Pages.

Per abilitare un tema di icone file specifico per i portali:

1. Aprire Visual Studio Code.

2. Vai a File>Preferenze>Tema>Tema icona file.

3. Seleziona il tema per le icone dei portali PowerApps.

   

Anteprima del sito

L'azione di anteprima usa l'estensione DevTools Microsoft Edge per Visual Studio Code per fornire un'anteprima del sito nell'editor. Questa funzionalità esegue Microsoft Edge DevTools e un browser integrato di Microsoft Edge con emulazione del dispositivo direttamente all'interno di VS Code, offrendo quasi tutte le stesse funzionalità di debug e ispezione disponibili in Microsoft Edge DevTools completo.

L'anteprima mostra sempre le modifiche che hai caricato nel tuo sito, quindi assicurati di eseguire il push di eventuali modifiche locali prima di aprirlo. Ogni volta che avvii l'anteprima, la cache del sito si svuota automaticamente per consentirti di visualizzare gli aggiornamenti più recenti.

Per aprire l'anteprima, fai clic con il pulsante destro del mouse sul sito attivo in Azioni Power Pages e seleziona Anteprima. Questa azione apre il browser Microsoft Edge integrato che punta al sito scelto.

Il riquadro di anteprima si apre sul lato destro.

Confrontare la configurazione del sito

Usare l'opzione Confronta con locale per identificare le differenze tra l'area di lavoro locale e la configurazione del sito attivo nell'ambiente remoto. Questa funzionalità consente di rilevare modifiche impreviste, risolvere i problemi specifici dell'ambiente e mantenere la coerenza prima di sincronizzare le configurazioni del sito.

Quando si seleziona questa azione, viene visualizzata una sezione Confronto siti nella visualizzazione Strumenti nella visualizzazione Azioni di Power Pages. In questa sezione vengono visualizzati tutti i file nell'area di lavoro locale che differiscono dall'ambiente, evidenziando:

• Aggiunti; nuovi file creati nell'area di lavoro locale che non esistono nell'ambiente.
• Modificato: file in cui il codice o i metadati differiscono tra le versioni locali e di ambiente.
• Eliminato: file rimossi dall'area di lavoro locale ma ancora presenti nell'ambiente.

Per confrontare una configurazione del sito live con l'area di lavoro locale:

1. Nella barra laterale di Esplora risorse, espandi il riquadro Azioni Power Pages.
2. Nell'elenco Siti attivi/inattivi fare clic con il pulsante destro del mouse sul sito da confrontare.
3. Selezionare Confronta con locale.

Per confrontare una cartella specifica:

1. Nella barra laterale di Explorer selezionare una cartella ( ad esempio web-pages) dall'area di lavoro locale.
2. Fare clic con il pulsante destro del mouse e selezionare Power Pages>Confronta con l'ambiente.

Gestire i risultati del confronto

Quando la scheda Confronto siti è attiva con le modifiche, è possibile fare clic con il pulsante destro del mouse sull'elenco di confronto per accedere ad altre azioni:

• Apri tutte le differenze: apre l'editor diff di Visual Studio Code per ogni file nell'elenco per esaminare tutte le modifiche contemporaneamente.
• Confronto aggiornamenti: analizza nuovamente l'area di lavoro locale e l'ambiente remoto per aggiornare l'elenco con le modifiche più recenti.
• Esporta come report HTML: genera un documento HTML condivisibile che illustra in dettaglio tutte le differenze rilevate.
• Esporta come JSON: esporta i dati di confronto in formato JSON per flussi di lavoro automatizzati o report personalizzati. È possibile condividere questo file esportato con i membri del team, che possono importarlo nella propria visualizzazione facendo clic con il pulsante destro del mouse sulla sezione Confronto siti e selezionando l'opzione Importa confronto .
• Ignora tutte le modifiche locali: ripristina tutte le modifiche locali in modo che corrispondano alla versione attualmente presente nell'ambiente remoto.
• Rimuovi confronto: chiude la sessione di confronto corrente e cancella la scheda dei risultati.

Completamento automatico

La funzionalità di completamento automatico nell'estensione Visual Studio Code mostra il contesto corrente in fase di modifica e gli elementi di completamento automatico pertinenti tramite IntelliSense.

Tag Liquid

Quando si personalizzano i contenuti scaricati utilizzando Visual Studio Code, ora è possibile utilizzare IntelliSense per i tag Liquid di Power Pages.

Inizia a digitare per visualizzare un elenco di tag Liquid. Seleziona un tag per formattarlo correttamente e continuare con l'input.

Oggetti Liquid

Puoi vedere i completamenti di codice dell'oggetto Liquid inserendo {{ }}. Con il cursore posizionato tra le parentesi, seleziona <CTRL + space> per visualizzare un elenco di oggetti Liquid che puoi selezionare. Se l'oggetto ha più proprietà, puoi inserire un . e poi selezionare <CTRL + space> di nuovo per vedere le proprietà specifiche dell'oggetto Liquid.

Tag di modello

Puoi vedere i suggerimenti per i modelli Web di Power Pages posizionando il cursore nella {include ' '} dichiarazione e selezionando <CTRL> - space. Viene visualizzato un elenco di modelli Web esistenti che puoi selezionare.

Crea, elimina e rinomina gli oggetti del sito Web

All'interno di Visual Studio Code, puoi creare, eliminare e rinominare i seguenti componenti del sito Web:

• Pagine Web
• Modelli di pagina
• Modelli Web
• Frammenti di contenuto
• Nuovi cespiti (file Web)

Creare operazioni

Puoi utilizzare le opzioni del menu contestuale per creare nuovi componenti del sito Web. Fai clic con il pulsante destro del mouse su uno degli oggetti supportati, scegli Power Pages e seleziona il tipo di oggetto sito Web che desideri creare.

In alternativa, puoi utilizzare il riquadro comandi di Visual Studio Code selezionando Ctrl + Shift + P.

Per creare l'oggetto, è necessario specificare altri parametri.

Rinomina ed elimina operazioni

Dallo spostamento dei file, puoi utilizzare il menu contestuale per rinominare o eliminare componenti di Power Pages.

Limiti

Le seguenti limitazioni si applicano attualmente a Power Platform Tools per i portali:

• Le funzionalità Completamento automatico supportano solo funzionalità limitate.

Informazioni correlate

Supporto Power Pages per Microsoft Power Platform CLI (anteprima)