Quant als formularis bàsics
Els formularis bàsics es poden configurar a l'estudi de disseny del Power Pages. Per obtenir més informació, vegeu Afegir un formulari.
Configuració de les metadades d'un formulari bàsic
Una configuració basada en dades que permet que els usuaris finals afegeixin un formulari per recopilar dades al lloc web sense necessitat que un desenvolupador exposi el formulari en un lloc. Els formularis del Dataverse es creen a l'Àrea de treball Dades i després s'utilitzen per crear components de formulari bàsic que es poden col·locar al lloc web o bé utilitzar-se amb subquadrícules i llistes d'entitats per generar aplicacions web completes. Més informació: Quant a les llistes.
Afegir un formulari al lloc web
El formulari bàsic conté relacions amb pàgines web i altres propietats per controlar la inicialització del formulari dins del portal. La relació amb les pàgines web permet la recuperació dinàmica de la definició de formulari per a un node de pàgina determinat del lloc web.
Per visualitzar formularis bàsics existents o crear formularis bàsics nous, obriu l'aplicació Administració de portals i aneu a Contingut>Formularis bàsics.
Quan creeu un formulari bàsic nou, el primer pas és decidir la taula i el nom del formulari que representeu, a més del mode: Insereix, Edita o Només de Dataverse lectura. El mode seleccionat determina si esteu creant un registre nou des del portal, editant un registre existent o només mostrant informació sobre un registre al portal.
Nota
Abans de continuar, assegureu-vos de revisar les consideracions per als formularis bàsics.
Les pàgines web associades amb el formulari bàsic es poden veure si seleccioneu l'enllaç Pàgines web que es mostra als enllaços de navegació Relacionats del menú esquerre.
Quan creeu o editeu una pàgina web, es pot especificar un formulari bàsic al camp de cerca proporcionat al formulari de la pàgina web.
Afegir un formulari bàsic mitjançant Liquid
Un formulari bàsic, també es pot afegir a un lloc web afegint l'etiqueta Liquid {% entityform name: '<<basic form name>>' %} a una àrea de contingut, com ara al camp Còpia de pàgina d'una pàgina web o a una plantilla web.
Protecció dels formularis
Nota
Aquest mètode de protegir els formularis quedarà obsolet aviat. Per tant, no s'ha d'utilitzar. Use proper table permissions, and web role setup to provide access to users for any data instead. Més informació: Canvis de permisos de taula per a formularis i llistes en portals nous
Per protegir els vostres formularis, heu de crear permisos de taula que determinen l'accés i la propietat dels registres segons les funcions web. Si un usuari entre en un formulari bàsic i no té permisos, rebrà un missatge d'error. A més, també veureu un advertiment quan un formulari està configurat amb permisos de taula no habilitats:
"Els permisos de taula s'han d'habilitar per a aquest registre o qualsevol usuari d'Internet pot visualitzar les dades".
Per habilitar els permisos d'un formulari bàsic, marqueu la casella de selecció Habilita els permisos de taula. Per obtenir-ne més informació, vegeu Crear funcions web.
Atributs de formulari bàsic i relacions del conjunt d'enllaços web
| Nom | Descripció |
|---|---|
| Nom | El nom descriptiu del registre. Aquest camp és necessari. |
| Nom de la taula | El nom de la taula des de la qual es carrega el formulari. Aquest camp és necessari. |
| Nom de formulari | El nom del formulari de la taula de destinació que es modificarà. Aquest camp és obligatori. |
| Nom de la pestanya | El nom opcional d'una pestanya d'un formulari per a una taula especificada que representarà. |
| Mode | Un dels valors següents:
|
| Tipus d'origen de registre | Un dels valors següents:
Si se selecciona Usuari de portal actual, es recupera el registre d'usuari de portal de l'usuari autenticat actual. Si seleccioneu Registre associat a l'usuari del portal actual, es recupera el registre de l'usuari del portal per a l'usuari autenticat actual i després es recupera el registre de la relació determinada tal com s'especifica en el camp "Nom de la relació". |
| Nom de paràmetre d’identificador de registre | Un nom de paràmetre proporcionat en la cadena de consulta de l'adreça URL a la pàgina web que conté aquest formulari bàsic. |
| Nom de la relació | Es requereix quan el tipus d'origen de registre és un registre associat a l'usuari del portal actual. El nom lògic de la relació entre l'usuari de portal actual i el registre de destinació. Això ha de tornar el mateix tipus de taula especificat pel camp Nom de taula. |
| Permet la creació si és Nul | Un valor booleà opcional disponible quan el tipus d'origen de registre és un registre associat a l'usuari del portal actual. Indicarà que si no existeix el registre relacionat, es permeti que els usuaris el creïn la primera vegada. En cas contrari, es generarà una excepció si el registre no existeix perquè el formulari necessita un registre al qual enllaçar les dades. NOTA: aquesta característica no està disponible als formularis de diversos passos. |
| Habilita els permisos de la taula | Fa que el formulari respecti els permisos de taula. El valor per defecte és fals per raons de compatibilitat amb versions anteriors. Si es configura en cert, es requeriran permisos explícits per a qualsevol usuari que vulgui accedir al formulari. NOTA: aquest mètode de protegir els formularis quedarà obsolet aviat. Per tant, no s'ha d'utilitzar. Use proper table permissions, and web role setup to provide access to users for any data instead. Més informació: Canvis de permisos de taula per a formularis i llistes en portals nous |
Opcions de formulari
| Nom | Descripció |
|---|---|
| Afegeix Captcha | Mostra captcha. |
| Mostra el Captcha per als usuaris autenticats | Mostra el captcha per als usuaris autenticats. |
| Grup de validació | El nom del grup assignat als controls d'entrada per avaluar l'entrada vàlida dels grups amb nom. |
| Genera automàticament passos des de pestanyes | Indica que es mostren diverses pestanyes d'un formulari bàsic amb cada pestanya com a pas seqüencial, començant per la primera pestanya i continuant fins que es navegui per totes les pestanyes i després de l'enviament final s'insereixi un registre. Per defecte, no està seleccionat. El valor per defecte indica que només es representarà una pestanya o formulari per al pas actual. Si no s'especifica el nom de la pestanya, es mostrarà la primera pestanya. |
| Representa recursos web inserits | Suprimeix l'iframe que abasteix un recurs web en un formulari bàsic. |
| Indicadors de funció habilitat | Es defineix l'indicador de funció mitjançant la descripció de l'atribut de la taula de destinació. |
| Mostra els camps no admesos | Mostra o amaga els noms de les columnes amb tipus de columnes no admesos del Dataverse. |
| Defineix els camps recomanats com a obligatoris | Fa que tots els atributs que tinguin el nivell de requisits de camp configurat en "Recomanat per a l'empresa" siguin obligatoris. |
| Fes que tots els camps siguin obligatoris | Fa que tots els camps siguin obligatoris, independentment del nivell de requisits de camp. |
| Resum de validació de classe de CSS | El nom de la classe de CSS assignat al resum de validació. El valor per defecte és "avís de resum de validació avís de bloc avís d'error" |
| Habilita els enllaços de resum de validació | Un valor booleà de cert o fals que indica si els enllaços de l'àncora s'han de representar al resum de validació per desplaçar-se al camp que conté un error. El valor per defecte és cert. |
| Text d'enllaç de resum de validació | L'etiqueta assignada als enllaços de resum de validació. El valor per defecte és "fes clic aquí". |
| Text de capçalera de resum de validació | L'etiqueta assignada a la capçalera de resum de validació. |
| Instruccions | Instruccions per treballar amb el formulari. |
| Missatge El registre no s'ha trobat | Missatge que es mostrarà quan no es trobi un registre. |
Configuració en cas d'èxit
| Nom | Descripció |
|---|---|
| En cas d'èxit | Un dels valors següents:
|
| Amaga el formulari en cas d'èxit | Cal tenir definida l'opció En cas d'èxit per Visualitza el missatge satisfactori. Quan està seleccionada, el formulari s'amaga fins que l'enviament s'hagi realitzat correctament. |
| Missatge satisfactori | Cal tenir definida l'opció En cas d'èxit per Visualitza el missatge satisfactori. El missatge que apareix a l'usuari després d'haver realitzat correctament l'enviament. Si no se n'especifica cap, es mostrarà un missatge predeterminat (Enviament completat correctament). Per a cada paquet de llengua instal·lat i habilitat per a l'organització, hi ha disponible un camp per introduir el missatge en la llengua associada. |
| Adreça URL externa | Requereix que l'opció En cas d'èxit estigui establerta en Redirigir. Especifiqui una adreça URL a un recurs extern del web. |
| o pàgina web | Requereix que l'opció En cas d'èxit estigui establerta en Redirigir. Seleccioneu una pàgina web des de la pàgina web actual. |
| Annexa la cadena de consulta existent | Requereix que l'opció En cas d'èxit estigui establerta en Redirigir. Quan se selecciona, els paràmetres de cadena de consulta existents s'afegeixen a l'adreça URL de destinació abans de la redirecció. |
| Annexa l'identificador de registre a la cadena de consulta | Requereix que l'opció En cas d'èxit estigui establerta en Redirigir. Quan seleccioneu aquesta opció, l'identificador del registre creat s'annexa a la cadena de consulta de l'adreça URL que s'està redirigint. |
| Nom de paràmetre d’identificador de registre | Requereix que l'opció En cas d'èxit estigui establerta en Redirigir. El nom del paràmetre de l'identificador de la cadena de consulta de l'adreça URL que s'està redirigint. |
| Annexa la cadena de consulta personalitzada | Requereix que l'opció En cas d'èxit estigui establerta en Redirigir. Una cadena personalitzada que es pot annexar a la cadena de consulta existent de l'adreça URL de redirecció. |
| Annexa el valor d'atribut a la cadena de consulta - Nom del paràmetre | Requereix que l'opció En cas d'èxit estigui establerta en Redirigir. Un nom per assignar al paràmetre que es correlaciona amb el valor d'atribut de la taula de destinació que s'annexa a la cadena de consulta de l'adreça URL de redirecció. |
| Annexa el valor d'atribut a la cadena de consulta - Nom lògic de l'atribut | Requereix que l'opció En cas d'èxit estigui establerta en Redirigir. Un nom lògic d'un atribut de la taula de destinació per annexar el valor a la cadena de consulta de l'adreça URL de redirecció. |
Configuració addicional
| Nom | Descripció |
|---|---|
| Associa l'usuari del portal actual | Indica que el registre de l'usuari que ha iniciat sessió actualment ha d'associar-se amb el registre de taula de destinació. |
| Columna de cerca d’usuaris del portal | El nom lògic de l'atribut de la taula de destinació que emmagatzema l'usuari del portal. |
| És un grup d'activitat | El valor booleà que indica si la columna de cerca d'usuaris del portal és un tipus del grup d'activitat o no. |
| Adjunta un fitxer | Seleccioneu aquesta opció perquè el formulari inclogui un control de càrrega de fitxer a la part inferior del formulari per tal de permetre que s'adjunti un fitxer al registre. Nota: Els portals amb la versió 9.2.2.x i posteriors no requereixen habilitar Activa els permisos de taula al formulari bàsic per adjuntar fitxers. Tanmateix, si el seleccioneu, heu d'assegurar-vos que es proporcionen privilegis adequats a la taula principal i a la taula d'anotacions per mostrar el botó Adjunta un fitxer al formulari. La taula d'anotació ha de tenir com a mínim els privilegis Creació i Annexa i la taula principal ha de tenir el privilegi Annexa a corresponent. En funció de si teniu un formulari de creació o actualització, és possible que també necessiteu privilegis de creació, ** lectura i escriptura per completar l'escenari del formulari. Els fitxers carregats es poden mostrar habilitant el control de temporitzador. Per obtenir informació addicional, vegeu les Configurar notes. |
| Ubicació d'emmagatzematge dels fitxers adjunts | Opcions: Fitxer adjunt de la nota, Emmagatzematge blob de l'Azure. Si la vostra organització està configurada per utilitzar l’emmagatzematge de l'Azure, allà podeu triar els fitxers carregats per emmagatzemar per a aquest formulari bàsic. En cas contrari, els fitxers s'emmagatzemaran com a fitxers adjunts de notes. |
| Permet diversos fitxers | Un valor booleà indica si l'usuari pot carregar més d'un arxiu. |
| Accepta | L'atribut d'acceptació especifica els tipus MIME dels fitxers que accepta el servidor a través de la càrrega de fitxers. Per especificar més d'un valor, separeu els valors amb comes (per exemple, audio/,video/,image/*). |
| Label | El text que apareix al costat del control de càrrega de fitxer. Per a cada paquet de llengua instal·lat i habilitat per a l'organització, hi ha disponible un camp per introduir el missatge en la llengua associada. |
| És obligatori adjuntar un fitxer | Caldran les dades adjuntes d'un fitxer per continuar. |
| Missatge d'error obligatori | Missatge que apareix durant la validació del formulari si És obligatori és cert i l'usuari no ha adjuntat un fitxer. Per a cada paquet de llengua instal·lat i habilitat per a l'organització, hi ha disponible un camp per introduir el missatge en la llengua associada. |
| Restringeix els fitxers als tipus acceptats | Força la validació al camp Accepta. Si no està seleccionat, l'atribut Accepta només s'utilitza com a suggeriment per al diàleg de càrrega de fitxers. |
| Missatge d'error de tipus de fitxer | El missatge que es mostra durant la validació del formulari si restringeix els fitxers als tipus acceptats és cert i l'usuari intenta carregar un tipus de fitxer no vàlid. Per a cada paquet de llengua instal·lat i habilitat per a l'organització, hi ha disponible un camp per introduir el missatge en la llengua associada. |
| Mida màxima del fitxer (en kilobytes) | Força la validació de la mida màxima permesa del fitxer carregat. |
| Missatge d'error de mida de fitxer | El missatge que es mostra durant la validació del formulari si Mida màxima del fitxer (en kilobytes) és true i l'usuari ha intentat carregar un fitxer massa gran. Per a cada paquet de llengua instal·lat i habilitat per a l'organització, hi ha disponible un camp per introduir el missatge en la llengua associada. |
| JavaScript personalitzat | S'afegeix un bloc personalitzat de JavaScript a la part inferior de la pàgina just abans de l'element d'etiqueta de formulari de tancament. L'identificador d'entrada HTML d'un camp de taula es defineix com a nom lògic de l'atribut. Això fa que la selecció d'un camp, de valors de configuració o la manipulació d'altres clients sigui fàcil amb jQuery.$(document).ready(function() { $("#address1_stateorprovince").val("Saskatchewan");}); |
Referència de la taula associada
Els paràmetres següents estan relacionats amb la configuració d'una taula de referència associada quan s'ha desat el formulari.
Això proporciona una manera d'associar el registre actual que s'ha creat o actualitzat a través del formulari amb un altre registre de la destinació. És útil si teniu diversos passos amb diversos tipus de taula i voleu relacionar els registres resultants o si es passa a la pàgina una cadena de consulta d'un identificador de registre que voldríeu que hi estigués associat. Per exemple, tenim una pàgina de carreres professionals que llista les ofertes de feina, cadascuna amb un enllaç a una sol·licitud per al lloc de treball que conté l'identificador de la publicació de feina al formulari de sol·licitud, de manera que quan es crea la sol·licitud la publicació de llocs de treball s'associa amb el registre.
| Nom | Descripció |
|---|---|
| Defineix la referència de taula en desar | Sí o No. Un valor de sí indica que s'ha d'assignar una referència de taula associada quan es desa el formulari, en cas contrari no se n'estableix cap. |
| Nom de la relació | El nom de definició de relació d'una relació determinada entre dos tipus de taula. |
| Nom lògic de la taula | El nom lògic de la taula a la qual es fa referència. |
| Nom lògic de l'atribut de cerca de destinació | El nom lògic de l'atribut de cerca de la taula de destinació que s'ha creat o actualitzat. |
| Emplena el camp de cerca | Si la cerca referent a la taula de referència es troba al formulari, la comprovació d'aquest valor emplena el camp del formulari amb el valor recuperat mitjançant la configuració següent. |
| Tipus d'origen | Un dels valors següents:
|
| Pas de taula de referència | El registre Pas de formulari de diversos passos d'un pas anterior per recuperar la taula creada o editada en aquell pas i associar-la amb el registre d'aquest pas actual. |
| Nom de la cadena de consulta | Nom de paràmetre proporcionat en la cadena de consulta de l'adreça URL a la pàgina web que conté aquest formulari de diversos passos. |
| La cadena de consulta és la clau principal | Sí indica que el valor de la cadena de consulta és el valor de la clau principal. No indica que el valor de la cadena de consulta és un tipus d'atribut que no és la clau principal. |
| Nom lògic de l'atribut de consulta | El nom lògic de l'atribut per fer la consulta del registre. |
| Mostra detalls de només de lectura | Indicarà que s'ha de representar un formulari a la part superior de la pàgina que mostri informació només de lectura relativa al registre de referència. Requereix un nom de formulari. |
| Nom de formulari | El nom del formulari de la taula de referència que s'ha d'utilitzar per mostrar informació només de lectura. |
Configuració d'acció del formulari bàsic
Per defecte, un formulari bàsic permet la lectura o actualització d'un registre existent o la inserció d'un registre nou. Tanmateix, també podeu habilitar i configurar fàcilment més accions per als registres d'un formulari bàsic (Suprimeix, Activa, Desactiva, etc.). També és possible substituir les etiquetes, les mides i altres atributs predeterminats que apareixen si hi ha accions activades.
Aquesta configuració es troba a la secció Configuració addicional del formulari bàsic. Per defecte, només es mostra la Configuració bàsica. Podeu seleccionar Configuració avançada per mostrar configuracions addicionals.
Podeu afegir botons d'acció per a les accions aplicables a un registre individual i aparèixer per a cada fila de la quadrícula sempre que els permisos de taula concedeixin el privilegi adequat. Hi ha disponibles les accions següents:
- Delete
- Flux de treball
- Crea un registre relacionat
- Activa
- Desactiva
Si feu clic a una d'aquestes opcions, es mostra una àrea de configuració per a aquesta acció. A més, algunes taules disposen d'accions especials que estan disponibles en funció de cada taula:
- Calcular valor de l'oportunitat (oportunitat)
- Cancel·lar l'acció de cas (incident)
- Tancar (resoldre) l'acció del cas (incident)
- Convertir oferta en comanda (oferta)
- Convertir ofertes en factures (comanda venda)
- Generar una oferta a partir de l'oportunitat (oportunitat)
- Perdre l'acció de l'oportunitat (oportunitat)
- Guanyar l'acció de l'oportunitat (oportunitat)
- Reobrir l'acció de cas (incident)
- Definir l'oportunitat en espera (oportunitat)
Nota
Es recomana crear un flux de treball en comptes d'afegir un botó Activa o Desactiva per a les taules de fàbrica que tenen valors específics d'estat i codi d'estat definits que requereixin per al procés de negocis. Per exemple, Incident (opcions d'estat), Oportunitat (opcions d'estat), Drets (opcions d'estat).
Configuració de la ubicació geogràfica per a formularis bàsics
Es pot configurar un formulari per mostrar un control del mapa per mostrar una ubicació existent com un marcador en un mapa o proporcionar la possibilitat que l'usuari especifiqui una ubicació. Consulteu Afegeix la ubicació geogràfica.
El control de mapes del formulari requereix una configuració addicional per indicar-li quins són els ID dels diferents camps d'ubicació, per assignar-los valors o recuperar-ne valors. El registre de formulari bàsic conté una secció de configuració que defineix aquestes assignacions de camps que s'han d'especificar. Els noms dels camps varien en funció de l'esquema que hàgiu creat.
Nota
- El camp d'adreça en un formulari bàsic de només lectura se substitueix pel mapa quan està activada la ubicació geogràfica.
- El mapa només es representarà quan es visualitzi el formulari en una finestra de la finestra modal.
- La secció d'ubicació geogràfica no és visible en l'entorn German Sovereign Cloud. Si un usuari ha activat la ubicació geogràfica amb un altre formulari, no es mostrarà durant la representació al portal.
Validació de sol·licituds
La validació de sol·licituds, característica de ASP.NET la versió 1.1, impedeix que el servidor accepti continguts que continguin HTML sense codificar. Aquesta característica està dissenyada per ajudar-vos a impedir alguns atacs d'injecció de scripts per la qual cosa el codi de l'script del client o l'HTML es poden enviar sense saber-ho a un servidor, emmagatzemar i després presentar-se a altres usuaris. Encara recomanem que valideu totes les dades d'entrada i codificar-les amb HTML quan sigui necessari.
Per defecte, la validació de sol·licitud s'habilita al portal que resulta en l'error genèric següent si introduïu codi script sense codificació HTML en camps de formulari bàsics:
Found field(s) submitted with potentially dangerous value(s) such as HTML, or script. Please review the field value(s) and try again.
Nota
Per evitar l'execució de codi maliciós, inclosos els blocs de scripts, podeu actualitzar la configuració del lloc Site/DisableFormDataSafeHtmlValidation a false. Per defecte, la configuració és certa i només es valida el bloc de scripts.
Per inhabilitar la validació de sol·licituds, seguiu aquests passos:
Obriu l'aplicació d'administració del portal.
Aneu a Configuració del lloc.
Seleccioneu Crea.
Escriviu el nom com a DisableValidationWebTemplate.
Seleccioneu el registre del lloc web adient.
Escriviu el valor com a cert. Per defecte, el paràmetre és fals, que habilita la validació de sol·licituds.
Escriviu la descripció adequada.
Seleccioneu Desa i tanca.
Atenció
Quan està inhabilitada la validació de sol·licituds, el contingut es pot enviar a una pàgina. Heu d'assegurar-vos que el contingut està degudament codificat o processat.
Consideracions
- Un formulari bàsic ha d'estar associat amb una pàgina web per a una determinada pàgina web per al formulari perquè es visualitzi al lloc.
- Les subquadrícules de taula de connexió no estan admeses als formularis bàsics. Si afegiu una subquadrícula de taula de connexió al formulari amb el Dissenyador de formularis, es mostraran missatges d'error quan representeu el formulari al portal i utilitzeu la taula de connexió.
- Els camps duplicats, els camps de la llista de grups i les regles de negoci no estan admesos en els formularis bàsics.
- Els components de codi de nivell de camp es poden afegir als formularis. Més informació: Utilitzar els components de codi
- Les regles de negoci i l'API de client poden habilitar els camps bloquejats en un formulari de només lectura.
- Si creeu un formulari bàsic en el mode Inserció, no podeu canviar l'alineació d'un botó ni col·locar un botó d'acció sobre el formulari bàsic.
- Si renderitzeu un control de cerca com a llista desplegable al formulari, el filtre de registres relacionats no funciona.
- De vegades, les columnes acumulatives dels formularis es poden mostrar com a editables, tot i que estan pensades per ser només de lectura. Per assegurar-vos que aquestes columnes siguin només de lectura, marqueu la columna com a Només de lectura al formulari del Dataverse.
Consulteu també
- Aplicació d'administració del portal
- Propietats del formulari de diversos passos
- Passos de formulari de diversos passos
- Metadades de formulari de diversos passos
- Configuració de subquadrícula de formulari de diversos passos
- Configuració de notes per a formularis bàsics i formularis de diversos passos