Partilhar via

Tutorial: Configurar o controlo rich text editor nos portais

Nota

A partir de 12 de outubro de 2022, os portais do Power Apps passam a ser Power Pages. Mais informações: O Microsoft Power Pages está agora em disponibilidade geral (blogue)
Em breve, vamos migrar e unir a documentação dos portais do Power Apps com a documentação do Power Pages.

Neste tutorial, irá configurar os portais do Power Apps para adicionar o controlo rich text editor a um formulário básico e, em seguida, adicionar o formulário básico a uma página Web. Os utilizadores do portal poderão interagir com o controlo rich text editor para formatar texto no formulário.

Pré-requisitos

A sua versão do portal tem de ser 9.4.3.x ou posterior.

Passo 1. Adicionar o controlo rich text editor a uma coluna numa aplicação condicionada por modelo

Siga os passos no tutorial Adicionar ou substituir uma coluna de texto para uma edição de texto formatado para adicionar o componente a uma coluna num formulário condicionado por modelo.

Nota

Para apresentar os dados como rich text, poderá ter de aumentar o tamanho dos carateres das colunas de texto para acomodar informação adicional.

Passo 2. Verificar que a aplicação condicionada por modelo utiliza o novo controlo

Pode Atualizar uma aplicação condicionada por modelo existente ou criar uma nova aplicação com o formulário ao qual adicionou o componente. Por exemplo, a imagem a seguir mostra a tabela de comentários formulário de contacto simples através do controlo rich text editor numa aplicação condicionada por modelo.

Rich text editor para a tabela de comentários.

Passo 3. Adicionar um controlo rich text editor a um formulário básico em portais

Neste passo, irá criar um novo formulário básico em portais e, em seguida, adicionar o controlo ao formulário básico. Também pode usar um formulário básico existente.

Passo 3.1. Criar um novo formulário básico

  1. Abra a aplicação Gestão do Portal.

  2. No painel esquerdo, em Conteúdo, selecione Formulários Básicos.

  3. Selecione Novo.

  4. Introduza um Nome para o formulário. Neste exemplo, utilizamos Formulário básico de comentário com RTE.

  5. Para Nome da Tabela, selecione Comentário (comentário).

  6. Selecione o nome do formulário da aplicação condicionada por modelo ao qual adicionou o controlo rich text. Neste exemplo, formulário de contacto simples.

  7. Selecione o site do seu portal.

    Configuração de formulário básico.

  8. Selecione Guardar e Fechar.

Passo 3.2. Adicionar o controlo rich text editor ao formulário básico

  1. Abra a aplicação Gestão do Portal.

  2. No painel esquerdo, em Conteúdo, selecione Formulários Básicos.

  3. Selecione o formulário básico que criou no passo 3.1.

  4. Selecione o separador Metadados de Formulário Básico.

  5. Selecione Novos Metadados de Formulário Básico.

  6. Para Tipo, selecione Atributo.

  7. Para Nome Lógico do Atributo, selecione o nome da coluna para a qual o controlo rich text está ativado. Neste exemplo, Comentários (comentários).

    Configuração de metadados do formulário básico.

  8. Introduza um valor para Etiqueta. Neste exemplo, Comentários.

  9. Para Estilo de Controlo, selecione Componente de código.

    Configuração de metadados de formulário básico que define o estilo de controlo para o 'componente de código'.

  10. Selecione Guardar e Fechar.

Passo 3.3. Adicionar permissões de tabela para a tabela de anexos de rich text

Para utilizar e armazenar imagens no controlo rich text editor no portal, terá de adicionar permissões de tabela à tabela de anexos de rich text (msdyn_richtextfile).

  1. Abra o seu portal em Studio de portais.

  2. No painel esquerdo, escolha Definições (ícone de engrenagem) e selecione Permissões de Tabela

    Selecionar permissões de tabela.

  3. Crie uma nova permissão de tabela para a tabela de anexos de rich text. O nome pode ser qualquer coisa que escolha; neste por exemplo utilizamos Anexo RTE.

  4. Para Tipo de acesso, selecione Acesso global.

    Nota

    O tipo Acesso global é escolhido porque não existe uma relação entre a tabela configurada para utilizar o controlo rich text editor e a tabela de anexos de rich text.

  5. Em Permissão para, selecione as caixas de verificação Ler, Escrever, Criar e Eliminar.

  6. Atribua uma função Web adequada à permissão de tabela.

    Configuração das permissões de tabela de rich text.

Importante

Se pretende armazenar imagens como cadeias base 64 diretamente na coluna que configurou para utilizar o controlo rich text editor, tem de configurar o controlo ao utilizar um ficheiro de configuração JSON. Defina disableImages e disableDefaultImageProcessing como true para permitir a composição consistente de imagens em todos os clientes. A utilização deste método não requer a permissão de tabela global na tabela de anexos de rich text (msdyn_richtextfile).

Passo 3.4. Adicionar a definição do site da API Web

  1. Abra a aplicação Gestão do Portal.

  2. Aceda a Definições do Site.

  3. Crie as seguintes definições de site: introduza o nome, o seu site e o valor de true e, em seguida, selecione Guardar e Fechar.

    Nome de definição do site Valor
    Webapi/msdyn_richtextfile/enabled true
    Webapi/msdyn_richtextfile/fields *

Passo 4. Criar uma página Web em portais que utilizem o formulário básico

  1. Abra o seu portal no Power Apps portals Studio

  2. No canto superior esquerdo, selecione Nova página.

  3. Selecione o esquema Em Branco.

  4. No painel de propriedades do lado direito, atualize o nome da página Web. Por exemplo, Comentários.

  5. Atualize o URL Parcial. Por exemplo, comentários.

  6. Dentro do editor de páginas, abaixo da secção Cabeçalho, selecione a secção Coluna.

  7. No painel esquerdo selecione Componentes(+).

  8. Em Componentes do portal, selecione Formulário.

  9. No painel de propriedade do lado direito, selecione Utilizar existente.

  10. Em Nome, selecione o formulário básico que criou anteriormente neste tutorial. Neste exemplo, Formulário básico de comentário com RTE.

    Dica

    Se não vir o formulário, selecione Configuração da Sincronização para sincronizar as alterações a partir do Dataverse.

  11. Em Permissões, selecione Gerir permissões da tabela e certifique-se de que tem as permissões de tabela adequadas e as funções Web configuradas para a tabela do Dataverse associada ao formulário.

    Nota

    Por predefinição, a tabela comentários tem as permissões criar configuradas para as funções Web predefinidas. Para mais informações, aceda ao exemplo de Contacte-nos.

  12. No canto superior direito, selecione Navegar no site.

    A página Web irá agora mostrar o formulário básico para a tabela de comentários com o controlo rich text editor, semelhante ao modo como o formulário aparece enquanto a aplicação condicionada por modelo é utilizada.

    Formulário básico a mostrar o componente de rich text numa página Web.

Rich text editor num formulário só de leitura

Num formulário só de leitura, o conteúdo do rich text editor apresenta o conteúdo com formatação e imagens. O conteúdo pode ser lido, mas não pode ser editado nem atualizado.

Consulte também

Descrição geral do Power Apps component framework
Criar o seu primeiro componente
Adicionar componentes de código a um campo ou a uma tabela em aplicações condicionadas por modelo