Obter os dados de aplicativos do Customer Engagement no portal

Artigo
03/09/2022
7 minutos para o fim da leitura

Os portais do Power Apps têm a capacidade de renderizar — e permitir a manipulação de — dados em um site da Web voltado para o mercado interno ou externo. Nesta seção, iremos descrever as tabelas que fornecem a base dessa funcionalidade e discutir as etapas necessárias para alcançá-la.

Formulários básicos

Um registro de formulário básico permite que o administrador renderize um formulário do Power Apps em um portal para editar, exibir ou capturar um conjunto personalizável de dados de seus usuários. É um processo relativamente simples e fácil, além de eliminar a necessidade de personalizações de código que, de outra forma, teria sido necessária para alcançar esse resultado antes de implantar um portal.

Essa funcionalidade pode ser aproveitada por vários motivos e casos de utilização, mas um exemplo comum de como isso pode ser aproveitado seria criar um novo formulário na tabela do cliente potencial, na interface Personalizar o sistema, em seguida, criar um registro de formulário básico que possa ser exibido no portal para capturar dados do cliente potencial através de uma página de contato ou algum tipo de página de solicitação de informações. Na verdade, este exemplo específico é usado para a página padrão Fale Conosco dentro dos portais por padrão. Outros exemplos incluem utilizar um formulário básico para gerenciamento de perfil ou página única de pesquisa.

Formulário Avançado de Contato à esquerda e sua renderização no portal à direita.

Os formulários básicos contêm relacionamentos com as páginas da Web e propriedades adicionais para controlar a inicialização do formulário no portal. O relacionamento com a página da Web permite a recuperação dinâmica da definição do formulário em relação a um determinado nó de página no site do portal.

Ao criar um novo formulário básico, a primeira etapa é determinar qual tabela e nome do formulário você renderizará, bem como o modo: Inserir, Editar ou Somente Leitura. O modo selecionado determinará se você está criando um novo registro do portal, editando um registro existente ou apenas exibindo informações sobre um registro no portal.

Para esta demonstração, consideremos um cenário em que a Contoso, Inc. gostaria de criar uma tabela personalizada no Power Apps vinculada a um formulário renderizado no Portal de Autoatendimento para Clientes que permita aos usuários enviar sugestões de melhorias que gostariam que fossem incorporadas pela empresa. As etapas adotadas pelo administrador da Contoso, Inc. para executar essa operação incluem o seguinte:

Crie a tabela personalizada usando o Power Apps. Mais informações: Criar uma tabela.
Neste exemplo, chamaremos a tabela "Sugestão".
Crie dois campos personalizados abaixo da tabela Sugestão que se referem às informações que devem ser capturadas no formulário. Neste exemplo, criaremos campos de SuggestionOrigin (Conjunto de Opções) e SuggestionSummary (Várias Linhas de Texto). Os dois campos serão definidos como Requisitos Comerciais.
Crie um formulário principal abaixo da tabela Sugestão:
1. Insira uma guia de uma coluna e altere as propriedades da seção para duas colunas.
2. Adicione os campos personalizados além do campo Nome existente.
3. Nomeie a guia Sugestão.
4. Em Propriedades do Formulário, nomeie o formulário Formulário de Sugestão.
5. Salve e publique as alterações.
Abra o aplicativo de Gerenciamento do Portal > Formulários Básicos e crie um registro de formulário básico. Nomeie-o Sugestão, defina o campo Nome da Tabela como Sugestão (nova_sugestão), defina o Nome do Formulário como Formulário de Sugestão, defina o Nome da Guia como Sugestão, o Tipo de Formulário como Inserir e altere quaisquer outras opções necessárias.
Usando os portais do Studio, crie uma página secundária chamada Sugestões. Defina o valor do Modelo de Página como Formulário Avançado, defina o valor do Formulário Básico como Sugestão e adicione uma introdução ao formulário.

Observação

A página filho também pode ser criada via , dependendo da preferência do usuário.
Para permitir que os usuários naveguem com facilidade pelo formulário: no portal, edite a Navegação Principal e selecione o ícone + para adicionar um novo link da Web ao formulário. Nomeie o link da Web Sugestões e atribua-o à página Sugestões.

Quando um usuário visita o portal da Contoso, ele navega por esse formulário, insere os dados pertinentes e envia o formulário; um novo registro é gerado automaticamente com as informações enviadas.

Formulário de sugestões personalizado renderizado em um portal.

Metadados do formulário básico

Os registros de metadados do formulário básico contêm a lógica de modificação de comportamento adicional para aumentar ou substituir a funcionalidade dos campos do formulário que, de outro modo, não poderiam ser modificados usando os recursos de edição do formulário básico nativos.

Esses registros permitem a configuração adicional e a manipulação de elementos específicos no formulário, incluindo campos, subgrades, guias e seções inteiras. Cada elemento do formulário que requer algum tipo de modificação requer um registro separado de metadados que, por sua vez, está associado ao registro de formulário básico.

Para adicionar registros de metadados a um formulário básico, você pode ir para Visualização Associada de Metadados do Formulário Básico no menu de navegação ou pode criar esses registros diretamente do formulário básico usando a subgrade de Metadados do Formulário Básico na parte inferior do formulário de registro.

Os registros de metadados do formulário básico podem ser usados para uma variedade de situações, incluindo controlar o estilo de um campo, pré-preencher um campo com um valor específico, definir valores no formulário após salvar, validar os valores inseridos pelo usuário e muito mais.

Listas

Enquanto um registro de Formulário básico permite que um administrador do portal exponha um formulário do Power Apps para os usuários do portal, as listas de entidades possibilitam aos administradores adicionar uma página da Web ao seu portal que renderizará uma lista de registros sem a necessidade de um desenvolvedor para exibi-la no portal usando um código personalizado.

As listas suportam a classificação e a filtragem e serão paginadas se o número de registros for maior que o valor do Tamanho da Página especificado no registro da Lista. Se a Página da Web para a Exibição de Detalhes tiver sido especificada, cada registro conterá um link para essa página, e a ID do registro será acrescentada à cadeia de consulta junto com o Nome do Parâmetro da Cadeia de Consulta de ID.

As listas também oferecem várias exibições e ações. Se mais de uma exibição for especificada, um menu suspenso será renderizado para permitir que o usuário final alterne entre várias exibições. Do mesmo modo, se ações como Editar ou Excluir foram adicionadas como botões de ação, os usuários com as permissões corretas verão essas opções renderizadas na visualização.

Com base no exemplo anterior do administrador da Contoso, Inc. que criou um formulário básico para coletar sugestões de usuários, trataremos agora das etapas que o administrador adotaria (de forma simplista) para expor os registros enviados no portal para revisão por outros usuários, e fácil acesso para envio de novos registros:

Edite a exibição chamada Sugestões Ativas da tabela Sugestões e adicione as colunas que devem ser expostas no portal para esta exibição.
Abra o aplicativo de Gerenciamento do Portal > Listas e crie um registro da Lista.
1. Digite o nome da Lista de Sugestões, defina o Nome da Tabela como Sugestão (nova_sugestão).
2. Adicione a exibição padrão Sugestões Ativas ou a exibição personalizada à lista Exibições.
3. Defina a Página da Web para Criar como Sugestões, e adicione um botão criar ou uma lista vazia conforme necessário.
Usando os portais do Studio, crie uma página secundária chamada Lista de Sugestões. Defina o Modelo de Página como Página Inteira, defina a Lista como Lista de Sugestões e adicione uma introdução à exibição exposta.
Se desejar, no portal, edite a Navegação Principal e, em seguida, selecione o botão Adicionar (+) para adicionar um novo link da Web à lista. Nomeie o link da Web Lista de Sugestões e atribua-o à página Lista de Sugestões. Você pode arrastar o link do formulário Sugestões, criado anteriormente, sob o novo link da lista para se tornar secundário.

Além da configuração simplista que foi discutida anteriormente, as Listas suportam muitas outras opções, incluindo (entre outras):

Permitir que os usuários usem filtro e pesquisa de registros dessa tabela no portal.
Permitir que os usuários criem, editem, excluam registros e baixem os registros em uma planilha do Excel.
Permitir que os usuários executem um fluxo de trabalho sob demanda para um registro selecionado na lista.
Exibir os registros da lista usando uma exibição Bing Mapas dos dados
Exibir os registros da lista usando uma Exibição Calendário dos dados.

Formulários Avançados

Os Formulários Avançados permitem aos usuários definir formulários básicos e lógica personalizada para renderizar formulários de entrada de dados em um portal sem a necessidade de código personalizado. Os formulários avançados oferecem suporte à navegação de uma ou várias etapas, além da lógica de ramificação. Os formulários avançados são normalmente usados para gerar pesquisas, como os formulários da Web pronto para uso "Pesquisa de Satisfação Referente à Ocorrência", ou para facilitar solicitações, como o formulário avançado pronto para uso "Abrir Nova Solicitação de Suporte”.

Os formulários avançados diferem dos formulários básicos na medida em que possibilitam ao administrador especificar um ou mais formulários a serem carregados para gerar um formulário único ou um processo no estilo assistente, de múltiplos passos, com lógica de ramificação condicional. Os formulários avançados também possuem propriedades adicionais que podem ser especificadas para substituir alguns dos comportamentos padrão e superar algumas limitações de designer de formulários e metadados.

A melhor forma de entender bem como um formulário avançado é usado em um portal é fornecer um exemplo de situação de uso e, depois, passar pelo processo de gerar o formulário e todas as partes subjacentes. Anteriormente neste documento, passamos pelo processo de criação de um formulário básico personalizada para o envio de sugestões e de uma lista personalizada pelos usuários com a finalidade de expor essas sugestões no portal. Agora suporemos que a Contoso deseja pesquisar, simultaneamente, quais das sugestões enviadas os usuários preferem que sejam implementadas e outras informações sobre sua base de usuários. As etapas adotadas pelo administrador para configurar essa pesquisa no portal seriam as seguintes:

Crie uma tabela personalizada usando o Power Apps. Mais informações: Criar uma tabela
. Neste exemplo, chamaremos a tabela de Pesquisa.
Crie vários campos personalizados abaixo da tabela Pesquisa para representar as respostas que serão disponibilizadas ao usuário na pesquisa:
1. Três campos personalizados denominados Horários Prolongados de Suporte, Novos Produtos e Mais lojas para uma pergunta de múltipla escolha formulada pelo administrador: "Qual é a sua sugestão favorita para uma futura melhoria da Contoso?" Cada campo é definido para tipos de dados de Duas opções.
2. Quatro campos personalizados denominados Loja de Varejo, Mecanismo de Pesquisa, Anúncio na Web e Boca a Boca para uma pergunta de múltipla escolha formulada pelo administrador: "Como você conheceu a Contoso Ltd.?" Cada campo é definido para tipos de dados de Duas opções.
3. Um campo personalizado denominado Classificação da Contoso Ltd. de tipo de dados Conjunto de opções. Para Usar o Conjunto de Opções Existente, selecione Sim e, na lista suspensa, Qualidade da Escala Likert.
4. Para rastrear o usuário do portal atual preenchendo a pesquisa, vá para um campo personalizado denominado Contato Relacionado de tipo de dados Pesquisa e registro de destino do Contato.
Abra o formulário principal Informações, abaixo da tabela Pesquisa, selecione a guia Geral e, em seguida, selecione Alterar Propriedades. Na guia Formatar selecione Uma Coluna e, em seguida, selecione OK. Mais informações: Criar ou editar um formulário
Alterne para a guia Inserir do formulário Informações, selecione Seção e escolha Duas colunas. Mova os campos Nome e Proprietário padrão para esta seção e exclua a antiga. Abra as propriedades do campo Nome e limpe a opção Visível por padrão na guia Exibir.
Salve o formulário, selecione Salvar como na faixa de opções para criar uma cópia do formulário denominada Etapa 2 da Pesquisa. Selecione Salvar como novamente para criar outra cópia denominada Etapa 1 da Pesquisa.
Abra o formulário Etapa 1 da Pesquisa, alterne para a guia Inserir e, em seguida, selecione Seção > Duas colunas.
Abra as propriedades da nova seção, altere o rótulo para “Qual é a sua sugestão favorita para uma futura melhoria da Contoso?" e selecione a caixa de seleção na opção Exibir o rótulo dessa seção no formulário.
Arraste os campos Horários Prolongados de Suporte, Novos Produtos e Mais Lojas para esta seção.
Repita a etapa de adicionar uma nova seção de duas colunas, mas desta vez altere o rótulo para "Como você conheceu a Contoso Ltd.?" e arraste os campos Loja de Varejo, Mecanismo de Pesquisa, Anúncio na Web e Boca a Boca para esta seção.
Abra as propriedades de cada campo. Na guia Formatar, defina Controlar Formatação como Caixa de seleção. Salve e feche o formulário.
Abra o formulário Etapa 2 da Pesquisa, alterne para a guia Inserir e selecione Seção > Uma coluna.
Arraste o campo Classificação da Contoso Ltd. para a nova seção e, em seguida, abra as propriedades do campo no formulário e altere o rótulo para “Dê sua opinião sobre o nosso desempenho! Avalie a qualidade dos produtos da Contoso Ltd.” Salve e feche o formulário.
Na área Formulários de Pesquisa , escolha Ordem de Formulários > Conjunto de Formulários Principais. Isso permitirá que você configure a ordem de formulários para funcionar com uma sequência de Informações > Etapa 1 da Pesquisa > Etapa 2 da Pesquisa.
No formulário principal Informações e na guia Inserir, selecione Seção > Duas colunas.
Abra as propriedades da nova seção, altere o rótulo para “Qual é a sua sugestão favorita para uma futura melhoria da Contoso?" e selecione a caixa de seleção Exibir o rótulo dessa seção no formulário. Arraste os campos Horários Prolongados de Suporte, Novos Produtos e Mais Lojas para esta seção.

Repita a etapa de adicionar uma nova seção de duas colunas, mas desta vez altere o rótulo para "Como você conheceu a Contoso Ltd.?" e arraste os campos Loja de Varejo, Mecanismo de Pesquisa, Anúncio na Web e Boca a Boca para esta seção. Abra as propriedades de cada um dos sete campos adicionados ao formulário até este momento, selecione a guia Formatação e defina Formatação de Controle como Caixa de seleção.

Repita a etapa de adicionar uma seção, mas desta vez escolha uma seção de uma coluna. Arraste o campo Classificação da Contoso Ltd. para esta seção e, em seguida, abra as propriedades do campo no formulário e altere o rótulo para “Dê sua opinião sobre o nosso desempenho! Avalie a qualidade dos produtos da Contoso Ltd.”

Por fim,, arraste o campo Contato Relacionado para a primeira seção da guia Geral para rastrear quais usuários preencheram a pesquisa. Salve e feche o formulário e, em seguida, selecione Publicar todas as Personalizações.
Abra Aplicativo Gerenciamento do Portal > Formulários Avançados e crie um novo formulário avançado chamado Pesquisa da Contoso Ltd.. Defina o campo Autenticação Necessária como Sim e o campo Registros Múltiplos por Usuário Permitidos como Não. Salve o formulário, mas mantenha-o aberto.
No registro do Formulário Avançado "Pesquisa da Contoso Ltd.":
1. Abra o campo de pesquisa Iniciar Etapa e selecione Novo para criar uma nova Etapa do Formulário Avançado.
2. Nomeie a etapa como Etapa 1 da Pesquisa.
3. Defina o Nome Lógico da Tabela de Destino como Pesquisa (nova_pesquisa).
4. Defina o Nome do Formulário como Etapa 1 da Pesquisa.
5. Marque a caixa de seleção Associar Usuário do Portal Atual .
6. Defina a Coluna de Pesquisa de Usuário do Portal como Contato Relacionado (new_regardingcontact).
7. Salve o formulário, mas mantenha-o aberto.
No registro de Etapa do Formulário Avançado "Etapa 1 da Pesquisa":
1. Abra o campo de pesquisa Próxima Etapa e selecione Novo para criar uma nova Etapa do Formulário Avançado.
2. Nomeie a etapa como Etapa 2 da Pesquisa.
3. Defina o Formulário Avançado como Pesquisa da Contoso Ltd.
4. Defina o Nome Lógico da Tabela de Destino como Pesquisa (nova_pesquisa).
5. Defina o Modo como Editar.
6. Defina o Nome do Formulário como Etapa 2 da Pesquisa.
7. Defina o Tipo de Destino como Resultado da Etapa Anterior.
8. Defina a Mensagem de Êxito como "Obrigado por dedicar parte do seu tempo para preencher a nossa pesquisa!"
9. Certifique-se de que o campo Próxima Etapa está em branco e, em seguida, salve o formulário, mas mantenha-o aberto.
No registro de Etapa do Formulário Avançado "Etapa 2 da Pesquisa":
1. Selecione a divisa mais à direita da navegação e selecione Metadados para abrir a Exibição Associada aos Metadados do Formulário Avançado abaixo do registro “Etapa 2 da Pesquisa".
2. Selecione Adicionar Novos Metadados do Formulário Avançado e defina o Nome Lógico do Atributo neste novo registro como Classificação da Contoso Ltd. (new_contosoltdrating) e o Estilo como Conjunto de Opções como Lista de Botão do Rádio Horizontal.
3. Salve e feche todos os formulários em aberto.
No aplicativo de Gerenciamento do Portal, vá para Páginas da Web e crie uma página da Web denominada Pesquisa da Contoso Ltd. Defina o Site como Contoso Ltd., a Página Principal como Página Inicial, a URL Parcial como contoso-ltd-survey, o PageTemplate como Página Inteira, o Estado de Publicação como Publicado e o Formulário Avançado como “Pesquisa da Contoso Ltd." criado anteriormente. Salve o registro.

Essas etapas são muito complexas e exigem vários registros para trabalhar em conjunto entre si e alcançar o resultado pretendido. No entanto, após a conclusão do processo, os usuários poderão navegar até a página que você criou no portal e preencher a pesquisa conforme esperado.

Primeira etapa do formulário de pesquisa renderizado em um portal.

Segunda etapa do formulário de pesquisa renderizado em um portal.

Toda pesquisa concluída e enviada se tornará um registro dentro da tabela Portais > Pesquisa e esse registro conterá o contato que concluiu o formulário avançado juntamente com todas as suas respostas para tabulação.

Renderização de elementos do formulário

Embora a maioria dos formulários possa ser renderizada com êxito em um portal, observe que alguns recursos não são suportados pelo controle BasicFormView que lida com a renderização real do formulário de entidade.

Elementos do formulário com suporte	Com suporte, mas com elementos de advertências do formulário	Elementos do formulário sem suporte
Todas as regras de validação de campo	Todos os tipos de campo, exceto campos da Lista de Entidades	Cabeçalhos e rodapés do formulário não serão exibidos no portal
Layouts de uma ou várias colunas	Suporte somente para os tipos de Recursos da Web relacionados à imagem e "Webpage (HTML)"	iFrames
Traduções do idioma do rótulo	Há suporte para a filtragem de registro em um campo de pesquisa, mas somente para relacionamentos N:1	Script de formulário
Observações (inseridas no formulário)	Há suporte para campos de pesquisa, mas não ao criar um novo registro por meio de uma exibição de pesquisa no formulário
Subgrades (inseridas no formulário)

Por fim, vale mencionar que o registro do Formulário Básico possui uma variedade de opções que permite que ele seja ajustado conforme necessário, incluindo uma seção para as opções Anexar Arquivo. Se um formulário exigir a anexação de arquivos, marque a caixa de seleção Anexar Arquivo e configure a opção Local de Armazenamento de Anexar Arquivo para Anexo de Anotação ou Armazenamento de Blobs do Azure. Mais informações: Configurar anotações como anexos

Consulte também

Sobre formulários básicos
Definir etapas do formulário avançado

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).