Partilhar via

Obter dados a partir das aplicações de interação com os clientes no portal

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.

Os portais do Power Apps têm a capacidade de compor e permitir a manipulação dos dados num Web site de portal com acesso interno ou externo. Nesta secção, iremos identificar as tabelas que fornecem os alicerces desta funcionalidade e debater os passos necessários para alcançar a alcançar.

Formulários básicos

Um registo de formulário básico permite que um administrador componha um formulário do Power Apps num portal para editar, apresentar ou capturar um conjunto de dados personalizável dos seus utilizadores. Isto é um processo relativamente simples e fácil e elimina a necessidade de todas as personalizações de código que seriam necessárias de outra forma para alcançar este resultado antes de implementar um portal.

Esta funcionalidade pode ser utilizada por muitas razões e para vários casos de utilização, mas um exemplo comum da sua utilização será criar um novo formulário na tabela Oportunidade Potencial na interface Personalizar o Sistema e, em seguida, criar um registo de formulário básico que pode ser exposto no portal para capturar dados de oportunidades através de uma página de contacto ou algum tipo da página de pedido de informações. De facto, este exemplo específico é utilizado para a página Contacte-nos predefinida nos portais por predefinição. Outros exemplos incluem a utilização de um formulário básico para gestão de perfis ou um inquérito de uma página.

Formulário Com Vários Passos Contacte-nos no lado esquerdo, e está a ser composto no portal no lado direito.

Os formulários básicos contêm relações com páginas Web e propriedades adicionais para controlar a inicialização do formulário no portal. A relação com uma página Web permite a obtenção dinâmica da definição do formulário para um determinado nó da página no site do portal

Ao criar um novo formulário básico, o primeiro passo é decidir a tabela e o nome do formulário que vai compor e o modo: Inserir, Editar ou Só de Leitura. O modo selecionado determinará se está a criar um novo registo a partir do portal, a editar um registo existente ou apenas a apresentar informações sobre um registo no portal.

Para esta demonstração, vamos considerar um cenário no qual a Contoso, Inc. pretende criar uma tabela personalizada no Power Apps associada a um formulário composto no respetivo Portal de Gestão Personalizada para Clientes que permitirá aos utilizadores submeterem sugestões para melhoramentos que gostariam de ver introduzidos na empresa. Os passos que o administrador da Contoso, Inc. poderá levar a cabo para alcançar este resultado incluem os seguintes:

  1. Crie a tabela personalizada utilizando o Power Apps. Mais informações: Criar uma tabela.
    Neste exemplo, vamos chamar à tabela "Sugestão".

  2. Crie dois campos personalizados sob a tabela Sugestão relacionados com as informações que devem ser capturadas no formulário. Neste exemplo, vamos criar os campos SuggestionOrigin (Conjunto de Opções) e SuggestionSummary (Várias Linhas de Texto). Ambos os campos serão definidos como Campo Necessário.

  3. Criar um novo formulário principal sob a tabela Sugestão:

    1. Insira um separador de uma coluna e altere as propriedades da secção para duas colunas.

    2. Adicione os campos personalizados além do campo Nome existente.

    3. Atribua ao separador o nome Sugestão.

    4. No Propriedades do Formulário, atribua ao formulário o nome Propriedades do Formulário.

    5. Guardar e publicar as alterações.

      Criar um formulário personalizado para ser composto num portal.

  4. Abra a aplicação Gestão do Portal > Formulários Básicos e crie um novo registo de formulário básico. Atribua-lhe o nome Sugestão, defina o respetivo campo Nome de Tabela como Sugestão (new_suggestion), defina o respetivo Nome do Formulário como Formulário de Sugestão, defina o respetivo Nome do Separador como Sugestão, defina o respetivo Tipo de Formulário como Inserir e modifique qualquer uma das outras opções conforme necessário.

  5. Através do Studio dos portais, crie uma nova página subordinada denominada Sugestões. Defina o valor de Modelo de Página como Formulário de Vários Passos, defina o valor do Formulário Básico como Sugestão e, em seguida, adicione uma introdução ao formulário.

    Nota

    A página subordinada também pode ser criada, consoante a preferência do utilizador.

  6. Para permitir que os utilizadores naveguem facilmente para o formulário: no portal, edite a Navegação Primária e selecione o ícone + para adicionar uma nova ligação Web ao formulário. Atribua o nome Sugestões à ligação Web e atribua-a à página Sugestões.

Quando um utilizador visita o portal Contoso, navega para este formulário criado e introduz os dados relevantes e envia-o, um novo registo será gerado automaticamente com as informações enviadas.

Formulário de sugestão personalizada composto num portal.

Metadados de formulário básico

Os registos de metadados de formulário básico contêm lógica de modificação de comportamento adicional para aumentar ou definir manualmente a funcionalidade de campos de formulário que de outra forma não poderia modificar utilizando a funcionalidade de edição do formulário básico nativo.

Estes registos permitem a configuração adicional e a manipulação de elementos específicos no formulário, incluindo campos, subgrelhas ou secções ou separadores completos. Cada elemento do formulário que necessite de algum tipo da modificação necessita de um registo de metadados separado, que por sua vez está associado ao registo de formulário básico.

Para adicionar registos de metadados a um formulário básico, pode ir para a Vista Associada de Metadados de Formulários Básicos a partir do menu de navegação ou pode criar estes registos diretamente a partir do formulário básico propriamente dito utilizando a subgrelha Metadados do Formulário Básico existente na parte inferior do formulário do registo.

Os registos de metadados de formulário básico podem ser utilizados para uma variedade de cenários, incluindo controlar o estilo de um campo, preencher previamente um campo com um valor específico, definir valores no formulário ao guardar, validação de valores introduzidos pelo utilizador e muito mais.

Listas

Apesar de um registo de Formulário Básico permitir que um administrador do portal exponha um formulário do Power Apps aos utilizadores do portal, as listas de entidade fornecem aos administradores a possibilidade de adicionar uma página Web ao seu portal que irá compor uma lista de registos sem que seja necessário um programador para expor a vista no portal utilizando código personalizado.

As listas suportam ordenação e filtragem e serão paginadas se o número de registos for maior que o valor de Tamanho da Página especificado no registo Lista. Se uma Página Web para a Vista de Detalhes também tiver sido especificada, cada registo conterá uma ligação para a página e o ID do registo que será adicionado acrescentado à cadeia de consulta, juntamente com o Nome do Parâmetro da Cadeia de Consulta de ID.

As listas também suportam várias vistas e ações. Se tiver sido especificada mais de uma vista, será composto um menu pendente para permitir que o utilizador final alterne entre as várias vistas. Da mesma forma, se ações como Editar ou Eliminar tiverem sido adicionadas como botões de ação, os utilizadores com as permissões corretas verão estas opções compostas na vista.

Com base no exemplo anterior do administrador da Contoso, Inc. criar um formulário básico para recolher sugestões de utilizadores, vamos agora abordar os passos que o administrador poderá levar a cabo para expor (de uma forma muito simples) os registos submetidos no portal para outros utilizadores reverem e para proporcionar o acesso fácil à submissão de novas sugestões:

  1. Edite a vista denominada Sugestões Ativas para a tabela Sugestões e adicione as colunas que devem ser expostas no portal para esta vista.

  2. Abra a aplicação Gestão do Portal > Listas e crie um novo registo de Lista.

    1. Introduza um nome de Lista de Sugestões, defina o valor de Nome da Tabela como Sugestão (new_suggestion).

    2. Adicione a vista predefinida Sugestões Ativas ou a vista personalizada à lista Vistas.

    3. Defina Página Web para Criar como Sugestões e adicione o texto do botão criar/lista vazia conforme necessário.

  3. Através do Studio dos portais, crie uma nova página subordinada denominada Lista de Sugestões. Defina Modelo de Página como Página Completa, defina Lista como Lista de Sugestões e, em seguida, adicione uma introdução à vista exposta.

  4. Se assim o pretender, no portal, edite a Navegação Principal e, em seguida, selecione o botão Adicionar (+) para adicionar uma nova ligação web para a lista. Atribua o nome Lista de Sugestões à ligação Web e atribua-a à página Lista de Sugestões. Pode arrastar a ligação do formulário Sugestões criada anteriormente para baixo da ligação da nova lista, para a tornar subordinada.

Além da configuração simples que foi mencionada anteriormente, as Listas suportam muitas outras opções, incluindo (sem limitações):

  • Permitir que os utilizadores filtrem e pesquisem registos nessa tabela no portal.
  • Permitir que os utilizadores criem, editem ou eliminem registos e que transfiram os registos para uma folha de cálculo do Excel.
  • Permitir que os utilizadores executem um fluxo de trabalho a pedido contra um registo selecionado na lista.
  • Apresentar os registos da lista utilizando uma vista dos Mapas Bing dos dados
  • Apresentar os registos da lista utilizando uma Vista de Calendário dos dados.

Formulários de Vários Passos

Os Formulários de Vários Passos permitem que os utilizadores definam formulários básicos e lógica personalizada para compor formulários de introdução de dados num portal sem necessidade de código personalizado. Os formulários de vários passos suportam a navegação de um e vários passos, bem como a lógica de ramificação. Os formulários de vários passos são frequentemente utilizados para produzir inquéritos, como os formulários de vários passos "Inquérito de Satisfação do Caso" predefinidos ou para facilitar a pedidos, como o formulário de vários passos "Abrir Novo Pedido de Suporte" predefinido.

Os formulários de vários passos diferem dos formulários básicos no aspeto em que permitem que um administrador especifique um ou mais formulários que devem ser carregados para produzir um formulário simples ou um processo de vários passos tipo assistente com lógica de ramificação condicional. Os formulários de vários passos também têm propriedades adicionais que podem ser especificadas para substituir alguns comportamentos predefinidos e ultrapassar algumas limitações dos metadados de tabela e do estruturador de formulários.

A melhor forma de compreender totalmente o modo como um formulário de vários passos é utilizado num portal é fornecer um exemplo de um cenário de utilização e, em seguida, descrever o processo de criação do formulário e todas as partes subjacentes. Anteriormente neste documento, descrevemos o processo de criação de um formulário básico personalizado para os utilizadores submeterem sugestões e uma lista personalizada para expor estas sugestões numa vista no portal. Agora vamos supor que a Contoso quer fazer uma pesquisa aos utilizadores sobre quais as sugestões submetidas que preferem ver implementadas, bem como outras informações sobre a base de utilizadores ao mesmo tempo. Os passos que o administrador poderá levar a cabo para configurar este inquérito no portal seriam os seguintes:

  1. Crie uma tabela personalizada utilizando o Power Apps. Mais informações: Criar uma tabela
    . Neste exemplo, vamos chamar à tabela Inquérito.

  2. Crie vários campos personalizados abaixo da tabela Inquérito para representar as respostas que estarão disponíveis para o utilizador escolher no inquérito:

    1. Três campos personalizados denominados Horas de Suporte Alargado,Novos Produtos e Mais Lojas para uma pergunta de múltipla escolha que o administrador planeou para "Qual é a sua sugestão favorita para um melhoramento futuro da Contoso?" Cada campo está definido para um tipo de dados de Duas Opções.

    2. Quatro campos personalizados denominados Loja, Motor de Busca, Anúncio Web e Ouvir Falar para uma pergunta de escolha múltipla que o administrador tem planeado para "Como é que ficou a saber da existência da Contoso Ltd.?" Cada campo está definido para um tipo de dados de Duas Opções.

    3. Um campo personalizado denominado Classificação de Contoso Ltd. do tipo de dados Conjunto de Opções. Para Utilizar Conjunto de Opções Existente, selecione Sim e, na lista pendente, seleccione Qualidade de Escala de Likert.

    4. Para monitorizar o utilizador atual do portal que está a preencher o inquérito, um campo personalizado chamado Relativo a Contacto com o tipo de dados Pesquisa e o registo de destino Contacto.

  3. Abra o formulário principal Informações abaixo da tabela Inquérito, selecione o separador Geral e selecione Alterar Propriedades. No separador Formatação, selecione Uma Colunae, em seguida, selecione OK. Mais informações: Criar ou editar um formulário

  4. Passe para o separador Inserir do formulário Informações, selecione Secção e escolha Duas Colunas. Mova os campos predefinidos Nome e Proprietário para esta secção e elimine a antiga. Abra as propriedades do campo Nome e desmarque a opção Visível por predefinição no separador Apresentar.

  5. Guarde o formulário e, em seguida, selecione Guardar Como no friso para criar uma cópia do formulário denominado Passo 2 do Inquérito. Selecione Guardar Como novamente para criar outra cópia denominada Passo 1 do Inquérito.

  6. Abra o formulário Passo 1 do Inquérito, passe para o separador Inserir e, em seguida, selecione Secção > Duas Colunas.

  7. Abra as propriedades da nova secção, altere a etiqueta para "Qual é a sua sugestão favorita para um melhoramento futuro da Contoso?" e selecione a caixa de verificação para a opção Mostrar a etiqueta desta secção no formulário.

  8. Arraste os campos Horas de Suporte Alargado, Novos Produtos e Mais Lojas para esta secção.

  9. Repita o passo de adicionar uma nova secção de duas colunas mas, desta vez, altere a etiqueta para "Como é que ficou a saber da existência da Contoso Ltd.?" e arraste os campos Loja, Motor de Busca, Anúncio Web e Ouvir Falar para esta secção.

  10. Abra as propriedades de cada campo. No separador Formatação, defina Controlar Formatação como Caixa de verificação. Guarde e feche o formulário.

  11. Abra o formulário Passo 2 do Inquérito, mude para o separador Inserir e selecione Secção > Uma Coluna.

  12. Arraste o campo Classificação de Contoso Ltd. para a nova secção, em seguida, abra as propriedades do campo no formulário e altere a etiqueta para "Classifique o nosso desempenho! Avalie a qualidade de várias séries de produtos da Contoso Ltd." Guarde e feche o formulário.

  13. Na área Formulários de inquérito, escolha Ordenar Formulário > Conjunto de Formulários Principais. Isto permitir-lhe-á configurar a ordem dos formulários para trabalhar numa sequência Informações > Passo 1 do Inquérito > Passo 2 do Inquérito.

  14. No formulário principal Informações e no separador Inserir, selecione Secção > Duas Colunas.

  15. Abrir as propriedades da nova secção, altere a etiqueta para "Qual é a sua sugestão favorita para um melhoramento futuro da Contoso?" e selecione a caixa de verificação para a opção Mostrar a etiqueta desta secção no formulário. Arraste os campos Horas de Suporte Alargado, Novos Produtos e Mais Lojas para esta secção.

    Repita o passo de adicionar uma nova secção de duas colunas mas, desta vez, altere a etiqueta para "Como é que ficou a saber da existência da Contoso Ltd.?" e arraste os campos Loja, Motor de Busca, Anúncio Web e Ouvir Falar para esta secção. Abra as propriedades de cada um dos sete campos adicionados ao formulário até aqui, selecione o separador Formatação e defina Controlar Formatação como Caixa de Verificação.

    Repita o passo de adicionar uma secção mas, desta vez, escolha uma secção de uma coluna. Arraste o campo Classificação de Contoso Ltd. para esta secção e, em seguida, abra as propriedades do campo no formulário e altere a etiqueta para "Classifique o nosso desempenho! Avalie a qualidade de várias séries de produtos da Contoso Ltd."

    Por último, arraste o campo Relativo a Contacto da primeira secção do separador Geral para monitorizar o utilizador que preencheu o inquérito. Guarde e feche o formulário e, em seguida, selecione Publicar Todas as Personalizações.

  16. Abra a aplicação Gestão de Portais > Formulários de Vários Passos e crie um novo formulário Web de vários passos Inquérito da Contoso Ltd.. Defina o campo Autenticação Necessária como Sim e o campo Múltiplos Registos por Utilizador Permitidos como Não. Guarde o formulário, mas mantenha-o aberto.

  17. No registo do Formulário de Vários Passos “Inquérito da Contoso Ltd.”:

    1. Abra o campo de pesquisa Passo Inicial e selecione Novo para criar um novo Passo de Formulário de Vários Passos.
    2. Atribua ao passo o nome Passo 1 do Inquérito.
    3. Defina o Nome Lógico da Tabela de Destino como Inquérito (new_survey).
    4. Defina o Nome do Formulário como Passo 1 do Inquérito.
    5. Selecione a caixa de verificação Associar Utilizador do Portal Atual.
    6. Defina a Coluna de Pesquisa do Utilizador do Portal como Relativo a Contacto (new_regardingcontact).
    7. Guarde o formulário, mas mantenha-o aberto.

  18. No registo "Passo 1 do Inquérito" do Passo de Formulário de Vários Passos:

    1. Abra o campo de pesquisa Passo Seguinte e selecione Novo para criar um novo Passo de Formulário de Vários Passos.
    2. Atribua ao passo o nome Passo 2 do Inquérito.
    3. Defina o Formulário de Vários Passos como Inquérito da Contoso Ltd..
    4. Defina o Nome Lógico da Tabela de Destino como Inquérito (new_survey).
    5. Defina Modo como Editar.
    6. Defina o Nome do Formulário como Passo 2 do Inquérito.
    7. Defina o Tipo de Origem como Resultado do Passo Anterior.
    8. Defina a Mensagem de Êxito como “Obrigado pelo tempo que dedicou a preencher este inquérito!
    9. Certifique-se de que o campo Passo Seguinte está em branco e guarde o formulário, mas mantenha-o aberto.

  19. No registo "Passo 2 do Inquérito" do Passo de Formulário de Vários Passos:

    1. Selecione as divisas mais à direita na navegação principal e selecione Metadados para abrir a Vista Associada de Metadados de Formulário de Vários Passos abaixo do registo "Passo 2 do Inquérito".
    2. Selecione Adicionar Novos Metadados de Formulários de Vários Passos e defina Nome Lógico do Atributo neste novo registo como Classificação de Contoso Ltd. (new_contosoltdrating) e o Estilo como Opção Definir Como Lista Horizontal de Botões de Opção.
    3. Guarde e feche todos os formulários abertos.

  20. Na aplicação Gestão de Portais, aceda a Páginas Web e crie uma nova Página Web chamada Inquérito da Contoso Ltd.. Defina o Web site como Contoso Ltd.”, a Página Principal como Inicial, o URL Parcial como contoso-ltd-survey, o PageTemplate como Página Completa, o Estado de Publicação como Publicado e o Formulário de Vários Passos para o “Inquérito da Contoso Ltd.” criado anteriormente. Guarde o registo.

Sabemos que estes passos são muito complexos e necessitam de vários registos para trabalharem em conjunto para alcançarem o resultado. No entanto, quando o processo estiver concluído, os utilizadores podem navegar para a página que criou no portal e preencher o inquérito conforme esperado.

Primeiro passo no formulário de inquérito composto num portal.

Segundo passo no formulário de inquérito composto num portal.

Cada inquérito concluído que é submetido passará a ser um registo da tabela Portais > Inquérito e este registo conterá o contacto que preencheu o formulário de vários passos, juntamente com todas as respostas.

Composição de elementos do formulário

Embora a maioria dos formulários possa ser composta com êxito num portal, note que algumas funcionalidades não são suportadas pelo controlo BasicFormView que processa a composição real do formulário básico.

Elementos de formulário suportados Suportado mas com elementos de formulário com ressalvas Elementos de formulário não suportados
Todas as regras de validação de campos Todos os tipos de campo, exceto os campos de Lista de Entidades Os cabeçalhos e rodapés do formulário não serão apresentados no portal
Esquemas de uma e várias colunas Só é suportado "Página Web (HTML)" e tipos de recurso Web relacionados com imagens iFrames
Traduções de idioma de etiquetas A filtragem de registos num campo de pesquisa é suportada, mas apenas para as relações N:1 Scripts de formulários
Notas (inseridas no formulário) Os campos de pesquisa são suportados, mas a criação de um novo registo através de uma vista de pesquisa no formulário não é suportada
Subgrelhas (inseridas no formulário)

Finalmente, é importante mencionar que o registo Formulário Básico tem várias opções que permitem que este seja otimizado conforme necessário, incluindo uma secção para opções de Anexar Ficheiro. Se um formulário necessitar do anexo de ficheiros, selecione a caixa de verificação Anexar Ficheiro e configure a opção Localização de Armazenamento do Ficheiro de Anexo para Anexo de Nota ou Armazenamento de Blobs do Azure. Mais informações: Configurar notas como anexos

Consulte também

Acerca dos formulários básicos
Definir passos de formulário com de vários passos

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).