Obter datos de aplicacións Customer Engagement no portal
Portais de Power Apps ten a capacidade de representar—e permitir a manipulación de— datos dun sitio web de portal interno ou externo. Nesta sección, faremos perfís das táboas que fornezan a base desta funcionalidade e comentaremos os pasos necesarios para conseguilo.
Formularios básicos
Un rexistro de formulario básico permite que un administrador procese un formulario de Power Apps nun portal para editar, mostrar, ou capturar un conxunto de datos personalizables dos seus usuarios. Este é un proceso é bastante fácil e sinxelo, e elimina a necesidade de personalizacións de código que, en caso contrario, sería necesario conseguir un resultado antes da implementación dun portal.
Pódese aproveitar esta funcionalidade por varios motivos e casos de uso, pero un exemplo común de como se pode sacar proveito disto sería crear un novo formulario na táboa de cliente potencial dentro da interface de Personalizar o Sistema e depois crear un rexistro de formulario básico que se poida extraer do portal para capturar datos de clientes potenciais a través dunha páxina de contacto ou algún tipo da páxina de solicitude de información. De feito, este exemplo específico úsase para a páxina Póñase en contacto connosco predeterminada dentro dos portais por defecto. Outros exemplos inclúen utilizar un formulario básico para a xestión de perfís ou a enquisa dunha única páxina.

Os formularios básicos conteñen relacións con páxinas web e propiedades adicionais para controlar o inicio do formulario no portal. A relación unha Páxina Web permite a recuperación dinámica da definición do formulario para un determinado nó no sitio web do portal.
Cando está a crear un novo formulario básico, o primeiro paso é decidir a táboa e o nome de formulario que vai procesar, así como o modo: Inserir, Editar ou Só Lectura. O modo seleccionado determinará se está a crear un novo rexistro desde a portal, a editar un rexistro existente ou simplemente a mostrar información sobre un rexistro do portal.
Para esta demostración, consideremos un escenario no que Contoso, Inc. desexa crear unha táboa personalizada en Power Apps ligado a un formulario renderizado no seu Portal de autoservizo do cliente que permitirá aos usuarios enviar suxestións de mellora que lles gustaría que a empresa presentase. Os pasos que o administrador de Contoso, Inc. seguiría para conseguir isto inclúen os seguintes:
Cree a táboa personalizada usando Power Apps. Máis información: Crear unha táboa.
Neste exemplo, chamaremos a táboa "Suxestión."Cree dous campos personalizados debaixo da táboa Suxestión que é pertinente á información que se debe capturar no formulario. Neste exemplo, crearemos os campos SuggestionOrigin (Conxunto de Opcións) e SuggestionSummary (Varias Liñas de Texto). Ambos os campos estará definidos como necesario para a empresa.
Cree un novo formulario principal debaixo da táboa Suxestión:
Insira un separador dunha columna e cambie as propiedades da sección a dúas columnas.
Engada os campos personalizados, así como o campo Nome existente.
Nome do separador Suxestión.
En Propiedades de Formulario, déalle ao formulario o nome Formulario Suxestión.
Garde e publique as modificacións.

Abra a Aplicación de xestión de portais > Formularios básicos e cree un novo rexistro de formulario básico. Déalle o nome Suxestión, defina o campo Nome da táboa como Suxestión (new_suggestion), defina o Nome do Formulario como Formulario de Suxestión, defina o Nome do Separador como Suxestión e o Tipo de Formulario como Inserir e cambie calquera outra opción segundo sexa necesario.
Mediante Portals Studio, cree unha nova páxina secundaria chamada Suxestións. Defina o valor Modelo de páxina como Formulario avanzado, defina o valor Formulario básico como Suxestión e engada unha introdución ao formulario.
Nota
A Páxina Secundaria tamén se pode crear, dependendo da preferencia do usuario.
Para que os usuarios poidan navegar facilmente ao formulario: No portal, edite a Navegación Primaria e, a seguir, seleccione a icona + para engadir unha nova ligazón web no formulario. Déalle á ligazón web o nome Suxestións e atribúaa á páxina Suxestións.
Cando un usuario visita o portal de Contoso, navega até este formulario creado, introduce os datos relevantes e os envía, xerarase un rexistro novo automaticamente coa información enviada.

Metadatos do formulario básico
Os rexistros de metadatos do formulario básico conteñen lóxica de modificación do comportamento adicional para aumentar ou anular a funcionalidade dos campos do formulario que non sería posible conseguir coas capacidades de edición de formularios básicos nativas.
Estes rexistros permiten configuracións adicionais e manipulation de elementos específicos no formulario, incluíndo campos, subgrades ou separadores ou seccións completos. Cada elemento do formulario que require algún tipo de modificación necesita un rexistro de metadatos independente, que está asociado ao rexistro do formulario básico.
Para engadir rexistros de metadatos a un formulario básico, pode ir á Visualización asociada de metadatos do formulario básico desde o menú de navegación ou estes rexistros pódense crear directamente desde o formulario básico utilizando a subgrade de Metadatos do Formulario básico na parte inferior do formulario do rexistro.
Os rexistros de metadatos de formulario básico pódense usar en diversos escenarios, como por exemplo para controlar o estilo dun campo, encher previamente un campo cun valor específico, definir valores no formulario despois de gardar, validar valores introducidos polo usuario etc.
Listas
Mentres que un rexistro de Formulario básico permite que un administrador do portal expoña un formulario de Power Apps aos usuarios do portal, as listas fornecen aos administradores a capacidade de engadir unha páxina web ao seu portal que procesará unha lista de rexistros sen que os programadores teñan que navegar pola visualización no portal utilizando un código personalizado.
As listas admiten ordenación e filtraxe e estarán paxinadas se o número de rexistros é maior que o valor Tamaño de páxina especificado no rexistro da lista. Se se especificou unha isualización de información da páxina web, cada rexistro conterá unha ligazón á páxina e o Identificador do rexistro engadirase á Cadea de Consulta xunto co Nome do Parámetro da Cadea de Consulta do identificador.
As listas tamén admiten varias visualizacións e accións. Se se especificou máis dunha visualización, procesarase un menú despregable que lle permite ao usuario final alternar entre varias visualizacións se o desexan. Se se engadiron accións como Editar ou Eliminar como botóns de acción, os usuarios cos permisos adecuados verán estas opcións procesadas na visualización.
Partindo do exemplo anterior do administrador de Contoso, Inc. creando un formulario básico para recoller suxestións dos usuarios, agora trataremos os pasos que o administrador tomaría para (de forma moi simplista) expor os rexistros enviados no portal para que outros usuarios poidan revisa e facilita o acceso para enviar outras novas:
Edite a vista nomeada Suxestións activas da táboa Suxestións e dd as columnas que deberían estar expostas no portal nesta vista.
Abra a Aplicación de xestión de portais > Listas e cree un novo rexistro de lista.
Introduza un nome de Lista de suxestións, defina o valor Nome da táboa como Suxestión (new_suggestion).
Engada a visualización predefinida Suxestións activas ou a visualización personalizada á lista Visualizacións.
Defina o valor Páxina Web para crear como Suxestións e engada o texto crear botón/lista baleira, segundo sexa necesario.
Mediante Portals Studio, cree unha nova páxina secundaria chamada Lista de suxestións. Defina o valor Modelo de páxina como Páxina completa, defina o valor Lista como Lista de suxestións e engada unha introdución para a visualización exposta.
Se o desexa, no portal, pode editar a Navegación Primaria e logo seleccionar o botón Engadir (+) para engadir unha nova ligazón web á lista. Déalle á ligazón web o nome Lista de suxestións e atribúaa á páxinae "Lista de suxestións. Pode arrastrar a ligazón do formulario Suxestións que se creou ata debaixo da nova ligazón da lista par se converter en secundaria.
Máis alá da configuración sinxela que se explicou antes, as Listas admiten moitoas outras opcións, incluíndo (pero sen estar limitada a):
- Permitir aos usuarios filtrar e buscar os rexistros dentro desa táboa no portal.
- Permitir aos usuarios crear, editar ou eliminar rexistros e descargar os rexistros a unha folla de Cálculo de Excel.
- Permitir aos usuarios executar un fluxo de traballo a pedido fronte a un rexistro seleccionados da lista.
- Mostrar os rexistros da lista utilizando unha visualización de Mapas de Bing dos datos
- Mostrar os rexistros da lista utilizando unha visualización de calendario dos datos.
Formularios avanzados
Os Formularios avanzados permiten aos usuarios definir os formularios básicos e a lóxica personalizada para procesar formularios de entrada de datos nun portal sen necesidade de código personalizado. Os formularios avanzados admiten navegación de varios pasos e dun único paso, así como lóxica de ramificación. Os formularios avanzados úsanse normalmente para producir enquisas, como por exemplo os formularios avanzados listos para usar de "Enquisa de Satisfacción do caso", ou para facilitar solicitudes, como por exemplo os formularios avanzados listos para usar de "Abrir nova solicitude de asistencia".
Os formularios avanzados son diferentes aos formularios básicos porque fornecen a capacidade a un administrador de especificar un ou máis formularios que se poden cargar para producir un único formulario ou un proceso de varios pasos con estilo de asistente e con lóxica de ramificación condicional. Os formularios avanzados tamén teñen propiedades adicionais que se poden especificar para anular algúns comportamentos predefinidos e superar algunhas limitacións de deseñador de formularios e metadatos de táboa.
A mellor maneira de comprender ben como usar un Formulario avanzado dentro dun portal é fornecer un exemplo de escenario dun caso de uso e despois seguir o proceso de crear o formulario e todas as partes subxacentes. Anteriormente neste documento, seguimos o proceso de creación dun formulario básico personalizado para que os usuarios envíen suxestións e unha lista personalizada para expoñer estas suxestións dentro dunha visualización do portal. Imaxinemos agora que Contoso quere facerlle unha enquisa aos seus usuarios das suxestións enviadas que prefiren implantar e outra información sobre a súa base de usuario ao mesmo tempo. Os pasos que o administrador seguiría para configurar a enquisa no portal serían estes:
Cree unha táboa personalizada usando Power Apps. Máis información: Crear unha táboa
, Neste exemplo, chamaremos a táboa Enquisa.Cree varios campos personalizados debaixo da táboa Enquisa para representar as respostas que estarán dispoñibles para que os usuario as esollan na enquisa:
Tres campos personalizados chamados Horas de Asistencia estendida, Novos Produtos e Máis Almacenamentos para unha pregunta tipo test que o administrador planeou para "Cal é a súa suxestión favorita para unha mellora de Contoso no futuro?" Cada campo está definido para un tipo de datos de Dúas Opcións.
Catro campos personalizados chamados Minorista, Motor de Busca, Publicidade web e Comentarios doutras persoas para unha pregunta tipo test que o administrador planeou para: "Como coñeceu Contoso Ltd.?" Cada campo está definido para un tipo de datos de Dúas Opcións.
Un campo personalizado chamado Clasificación de Contoso Ltd. do tipo de datos Conxunto de Opcións. Para Usar Conxunto de Opcións existente, seleccione Si e na lista despregable, seleccione Calidade de escala Likert.
Para rastrexar se o usuario actual do portal enche a enquisa, un campo personalizado chamado Referente a contacto do tipo de datos Busca e rexistro de destino Contacto.
Abra o formulario principal Información debaixo da táboa Enquisa, seleccione o separador Xeral e, a seguir, seleccione Modificar Propiedades. No separador Formatar, seleccione Unha Columna e, a seguir, seleccione Aceptar. Máis información: Crear ou editar un formulario
Mude ao separador Inserir do formulario Información, seleccione Sección e escolla Dúas Columnas. Mova os campos Nome e Propietario predefinidos a esta sección e elimine os antigos. Abra as propiedades do campo Nome e desmarque a opción de Visible por defecto no separador Visualización.
Garde o formulario e, a seguir, seleccione en Gardar como na fita para crear unha copia do formulario chamado Enquisa paso 2. Seleccione Gardar como de novo para crear outra copia chamada Enquisa paso 1.
Abra o formulario Enquisa paso 1, mude ao separador Inserir e, a seguir, seleccione Sección > Dúas columnas.
Abra as propiedades da sección nova, cambie a etiqueta a "Cal é a súa suxestión favorita para unha futura mellora de Contoso?" e seleccione a caixa de verificación da opción Mostrar a etiqueta desta sección no formulario.
Arrastre os campos Horas de asistencia estendidas, Novos Produtos e Máis tendas a esta sección.
Repita o paso de engadir unha nova sección de dúas columnas, pero esta vez cambie a etiqueta a "Como coñeceu Contoso Ltd.?" e arrastre os campo Tenda minorista, Motor de Busca, Publicidade web e Comentarios doutras persoas a esta sección.
Abra as propiedades de cada campo. No separador Formatar, defina Controlar Formatado como Caixa de Verificación. Garde e peche o formulario.
Abra o formulario Enquisa paso 2, mude ao separador Inserir e seleccione Sección > Unha Columna.
Arrastre o campo Clasificación de Contoso Ltd. á nova sección e logo abra as propiedades do campo no formulario e cambie a etiqueta a "Cóntanos como lle vai. Valore a calidade das diferentes series de produtos de Contoso Ltd." Garde e peche o formulario.
Na área Formularios da enquisa, escolla Pedido de Formulario > Principal conxunto de formularios. Isto permitiralle configurar a orde de formularios para traballar nunha secuencia de Información > Enquisa Paso 1 > Enquisa Paso 2.
No formulario de Información e no separador Inserir, seleccione Sección > Dúas Columnas.
Abra as propiedades da sección nova, cambie a etiqueta a "Cal é a súa suxestión favorita para unha futura mellora de Contoso?" e seleccione a caixa de verificación Mostrar a etiqueta desta sección no formulario. Arrastre os campos Horas de asistencia estendidas, Novos Produtos e Máis tendas a esta sección.
Repita o paso de engadir unha nova sección de dúas columnas, pero esta vez cambie a etiqueta a "Como coñeceu Contoso Ltd.?" e arrastre os campo Tenda minorista, Motor de Busca, Publicidade web e Comentarios doutras persoas a esta sección. Abra as propiedades de cada un dos sete campos engadidos ao formulario, seleccione o separador Formatar e defina o Controlde formatado a caixa de Verificación.
Repita o paso de engadir unha sección, pero esta vez escolla unha sección dunha columna. Arrastre o campo Clasificación de Contoso Ltd. a esta sección e logo abra as propiedades do campo no formulario e cambie a etiqueta a "Cóntanos como lle vai. Valore a calidade das diferentes series de produtos de Contoso Ltd."
Finalmente, arrastre o campo de Referente ao contacto á primeira sección do separador Xeral para rastrexar que usuario encheeu a enquisa. Garde e peche o formulario e despois seleccione Publicar Todas as Personalizacións.
Aberto Aplicación de xestión de portais > Formularios avanzados e cree un novo formulario avanzado chamado Contoso Ltd. Enquisa. Defina o campo Autenticación requerida como Si e o campo Permítense Varios Rexistros Por Usuario como Non. Garde o formulario, pero déixeo aberto.
No rexistro do formulario avanzado "Contoso Ltd. Survey":
- Abra o campo de busca Comezar paso e, a seguir, seleccione Novo para crear un novo Paso de Formulario avanzado.
- Déalle ao paso o nome de Enquisa paso 1.
- Defina o Nome Lóxico da táboa de destino como Enquisa (new_survey).
- Defina o Nome do Formulario como Enquisa paso 1.
- Seleccione a caixa de verificación Asociar Portal actual do Usuario.
- Defina a Columna de busca do usuario do portal como Contacto relacionado (new_regardingcontact).
- Garde o formulario, pero déixeo aberto.
No rexistro do paso do formulario avanzado de "Paso 1 da enquisa":
- Abra o campo de busca Paso seguinte e, a seguir, seleccione Novo para crear un novo Paso de Formulario avanzado.
- Déalle ao paso o nome de Enquisa paso 2.
- Establece o formulario avanzado en Contoso Ltd. Enquisa.
- Defina o Nome Lóxico da táboa de destino como Enquisa (new_survey).
- Defina o Modo como Editar.
- Defina o Nome do Formulario como Enquisa paso 2.
- Defina o Tipo de Orixe como Resultado do Paso Anterior.
- Defina a Mensaxe de Éxito como "Grazas por completar esta enquisa!"
- Asegúrese de que o campo Seguinte paso está en branco e garde o formulario, pero déixeo aberto.
No rexistro do paso do formulario avanzado de "Paso 2 da enquisa":
- Seleccione as comiñas angulares que están máis á dereita na navegación principal e seleccione Metadatos para abrir a a visualización asociada dos metadatos do formulario avanzado debaixo do rexistro "Paso 2 da enquisa".
- Seleccione Engadir novos metadatos de formularios avanzados e establece o Nome lóxico do atributo neste novo disco para Clasificación de Contoso Ltd. (new_contosoltdrating) e o Estilo a conxunto de opcións como Lista de botóns de radio horizontal.
- Garde e peche todos os formularios abertos.
Na aplicación Xestión de portais, vaia a Páxinas web e cree unha nova páxina web chamada Enquisa de Contoso Ltd.. Establece o Sitio web a Contoso Ltd.", o Páxina principal a Casa, o URL parcial a contoso-ltd-survey, o Modelo de páxina a Páxina completa, o Estado editorial a Publicado, e o Formulario avanzado para a "Enquisa Contoso Ltd." que se creou anteriormente. Garde o rexistro.
É verdade que estes pasos son moi complexos e requiren que varios funcionen en tándem para conseguir o resultado. No entanto, despois de concluído o proceso, os usuarios poden navegar á páxina que creou no portal e encha a enquisa como tiña previsto.


Cada enquisa concluída que se envía será un rexistro dentro da táboa Portais > Enquisa e este rexistro conterá o contacto que completou o formulario avanzado xunto con todas as respostas de tabulación.
Procesamento de elementos de formulario
Aínda que a maioría dos formularios se poden procesar correctamente nun portal, hai que ter en conta que algunhas funcionalidades non son compatibles co control BasicFormView que procesa o formulario básico.
| Elementos de forma compatibles | Compatible, but con elementos de formulario de advertencia | Elementos de formulario non compatibles |
|---|---|---|
| Todas as regras de validación do campo | Todos os tipos de campo, excepto os campos da Lista de grupo | As cabeceiras e pés de páxina non se mostrarán no portal |
| Deseños de varias columnas e dunha soa columna | Só son compatibles os tipos de recurso web relacionados con imaxes e "páxina web (HTML)" | iFrames |
| Traducións de idioma con etiqueta | A filtraxe de rexistros nun campo de busca é compatible, mais só para relacións N:1 | Procesamento de scripts de formularios |
| Notas (inseridas no formulario) | Admítense campos de busca, pero non a creación de novos rexistros a través dunha visualización da busca no formulario | |
| Subgrades (inseridas no formulario) |
Finalmente, hai que mencionar que o rexistro de Formulario básico ten unha variedade de opcións que permiten que se poida axustar segundo sexa necesario, incluíndo unha sección para as opcións de Anexar Ficheiro. Se un formulario require o anexo de ficheiros, seleccione a caixa de verificación Anexar Ficheiro e configure a opción Anexar localización de almacenamento do Ficheiro para Anexo da Nota ou Azure Blob Storage. Máis información: Configura as notas como anexos
Consulte tamén
Acerca dos formularios básicos
Definir os pasos do formulario avanzado
Nota
Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)
Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).
Comentarios
Enviar e ver os comentarios