Usar a extensão do Visual Studio Code

O Visual Studio Code é um editor de código-fonte leve, porém poderoso, que é executado em sua área de trabalho e está disponível para Windows, macOS e Linux. Ele vem com suporte interno para JavaScript, TypeScript e Node.js e tem um ecossistema avançado de extensões para outras linguagens (como C ++, C#, Java, Python, PHP e Go) e runtime (como .NET e Unity). Para obter mais informações, confira Introdução ao VS Code.

O Visual Studio Code permite estender sua capacidade por meio de extensões. As extensões do Visual Studio Code podem adicionar mais recursos à experiência geral. Com o lançamento desse recurso, agora você pode usar a extensão do Visual Studio Code para trabalhar com o Power Pages.

Extensão do Visual Studio Code para o Power Pages

O Power Platform Tools adiciona a capacidade de configurar sites usando o Visual Studio Code e usa a linguagem Liquid integrada IntelliSense, permitindo ajuda com preenchimento de código, assistência e dicas ao personalizar a interface de sites usando o Visual Studio Code. Usando a extensão do Visual Studio Code, você também pode configurar portais por meio do Microsoft Power Platform CLI.

Observação

  • Você precisará garantir que node.js tenha sido baixado e instalado na mesma estação de trabalho que o Visual Studio Code para que os recursos do Power Pages funcionem.
  • Certifique-se de que somente Power Platform Tools estejam instaladas e não Power Platform Tools e Power Platform Tools [VERSÃO PRELIMINAR]. Consulte Problemas conhecidos para obter detalhes.

Animação que explica como instalar e definir o Power Platform Tools.

Pré-requisitos

Antes de usar a extensão do Visual Studio Code para o Power Pages, você deve:

Instalar a extensão do Visual Studio Code

Depois de instalar o Visual Studio Code, você precisa instalar a extensão para o plug-in do Power Platform Tools para Visual Studio Code.

Para instalar a extensão Visual Studio Code:

  1. Abra o Visual Studio Code.

  2. Selecione Extensões no painel esquerdo.

    Extensão do Visual Studio Code.

  3. Selecione o ícone Configurações no canto superior direito do painel de extensões.

  4. Pesquise e selecione o Power Platform Tools.

    Selecione o Power Platform Tools.

  5. Selecione Instalar.

  6. Verifique se a extensão foi instalada com êxito pelas mensagens de status.

Baixar conteúdo do site

Para se autenticar em um ambiente do Microsoft Dataverse e para baixar conteúdo do site, consulte o tutorial Usar o Microsoft Power Platform CLI com o Power Pages – baixar conteúdo do site.

Dica

A extensão do Power Platform Tools permite automaticamente o uso de comandos do Microsoft Power Platform CLI de dentro do Visual Studio Code por meio do Terminal Integrado do Visual Studio.

Ícones de arquivo

A extensão do Visual Studio Code para o Power Pages identifica e mostra automaticamente ícones para arquivos e pastas dentro do conteúdo do site baixado.

Lista de arquivos em um modelo inicial com tema de ícone de arquivo específico do site.

O Visual Studio Code usa o tema de ícone de arquivo padrão que não mostra ícones específicos do Power Pages. Para exibir ícones de arquivo específicos de seus sites, você terá que atualizar a instância do Visual Studio Code para usar o tema de ícone de arquivo específico do Power Pages.

Para habilitar um tema de ícone de arquivo específico de portais:

  1. Abra o Visual Studio Code.

  2. Acesse Arquivo>Preferências>Tema>Tema de Ícone de Arquivo

  3. Selecione o tema para Ícones de portais do PowerApps.

    Selecione o tema para Ícones de Portais do Power Apps.

Visualização dinâmica

A extensão do Visual Studio Code habilita uma opção de visualização dinâmica para exibir a página de conteúdo do Power Pages dentro da interface do Visual Studio Code durante a experiência de desenvolvimento.

Para ver a versão preliminar, selecione Botão Visualização. no canto superior direito quando um arquivo HTML estiver aberto no modo de edição.

Visualização da página.

O painel de visualização é aberto no lado direito da página que está sendo editada.

Uma tela com lista de arquivos, arquivo aberto no editor do Visual Studio Code e uma visualização no lado direito.

O recurso de visualização exige que os outros arquivos também sejam abertos na mesma sessão do Visual Studio Code que compõe o markup HTML para que a visualização seja exibida. Por exemplo, se somente o arquivo HTML for aberto sem a estrutura de pastas aberta usando o Visual Studio Code, você verá a seguinte mensagem:

Houve falha na execução do comando contribuído: 'microsoft-powerapps-portals.preview-show'.

Quando esse problema ocorrer, abra a pasta usando Arquivo > Abrir pasta e selecione a pasta de conteúdo do site baixada a ser aberta antes de tentar visualizar novamente.

Preenchimento automático

O recurso de preenchimento automático na extensão do Visual Studio Code mostra o contexto atual que está sendo editado e os elementos de preenchimento automático relevantes por meio do IntelliSense.

Um exemplo de preenchimento automático para a ID do modelo de página.

Marcas do Liquid

Ao personalizar o conteúdo baixado usando o Visual Studio Code, agora você pode usar o IntelliSense para marcas Liquid do Power Pages.

Comece a digitar e uma lista de marcas Liquid aparecerá; depois de selecionar a marca, esta será formatada corretamente e estará pronta para mais entradas.

Trecho com um exemplo de preenchimento da marca Liquid.

Objetos Liquid

Você pode ver preenchimentos de código de objeto Liquid inserindo {{ }}. Com o cursor posicionado entre os colchetes, selecione <CTRL + space> para exibir uma lista de objetos Liquid que você pode selecionar. Se o objeto tiver mais propriedades, você poderá inserir um . e, em seguida, selecionar <CTRL + space> novamente para ver as propriedades específicas do objeto Liquid.

Inserindo um objeto Liquid.

Marcas de modelo

Você pode ver sugestões de modelo da Web do Power Pages colocando o cursor na instrução {include ' '} e selecionando <CTRL> - space. Uma lista de modelos da Web existentes aparecerá para você selecionar.

Marcas do modelo.

Criar, excluir e renomear objetos do site

No Visual Studio Code, você pode criar, excluir e renomear os seguintes componentes do site:

  • Páginas da Web
  • Modelos de página
  • Modelos da Web
  • Trechos de conteúdo
  • Novos ativos (arquivos da Web)

Criar operações

Você pode usar as opções do menu de contexto para criar novos componentes de site, selecionar com o botão direito um dos objetos suportados, escolher Power Pages e selecionar o tipo de objeto de site que deseja criar.

Como alternativa, é possível usar a paleta de comandos do Visual Studio Code selecionando Ctrl + Shift + P.

Crie um novo objetivo.

Você precisará especificar mais parâmetros para criar o objeto.

Object Parâmetros
Páginas da Web Nome, modelo de página, página pai
Modelos de página Nome, modelo da Web
Modelos da Web Name
Trechos de conteúdo Nome, e se o trecho será em HTML ou texto.
Novos ativos (arquivos da Web) Nome, página pai e selecione o arquivo a ser carregado.

Renomear e excluir operações

Na navegação de arquivos, você pode usar o menu de contexto para renomear ou excluir componentes do Power Pages.

Observação

Os objetos excluídos podem ser restaurados da lixeira na área de trabalho.

Limitações

Atualmente, as seguintes limitações se aplicam ao Power Platform Tools para portais:

Confira também

Suporte do Power Pages para Microsoft Power Platform CLI (versão preliminar)