Om grundläggande formulär

Anteckning

Från och med den 12 oktober 2022 byter Power Apps-portaler namn till Power Pages. Mer information: Microsoft Power Pages är nu allmänt tillgänglig (blogg)
Vi kommer snart migrera och sammanfoga dokumentationen för Power Apps-portaler med Power Pages-dokumentationen.

En datadriven konfiguration för att tillåta användare att lägga till ett formulär för att samla in data på portalen utan att det krävs någon programmering att formuläret i portalen, grundläggande formulär skapas i Microsoft Dataverse och placeras på webbsidor i portalen eller används tillsammans med underrutnät och listor för att bygga ut fullständiga webbprogram. Mer information: Om listor

Lägga till ett formulär till din portal

Grundläggande formuläret innehåller relationer till webbsidor och ytterligare egenskaper för att styra initieringen av formuläret på portalen. Relationen till webbsidor tillåter dynamiskt hämtning av formulärdefinitionen för en viss sidnod på webbplatsen.

Om du vill visa befintliga grundläggande formulär eller skapa nya grundläggande formulär öppnar du programmet Portalhantering och går till Portaler > Grundläggande formulär.

När du skapar ett nytt grundläggande formulär är det första steget att bestämma Tabell och Formulärnamn som du återge samt läge: Infoga, redigera eller skrivskyddad. Det markerade läget avgör om du skapar en ny post från portalen, redigerar en befintlig post eller bara visar information om en post på portalen.

Anteckning

Innan du fortsätter bör du se till att du går igenom saker som du bör tänka på i grundformulären.

De webbsidor som associeras med grundläggande formuläret kan visas genom att välja länken Webbsidor som finns i navigeringslänken Relaterade i menyn längst till vänster.

När du skapar eller redigerar en webbsida, kan ett grundläggande formulär anges i sökfältet på webbsideformuläret.

De olika huvudsidorna som portalen använder innehåller kontroll över TableForm-servern. När återgivning av webbsidan innehåller antingen sidmallen för sidan (~/Pages/Page.aspx) eller sidmallen för helsidan (~/Pages/FullPage.aspx) kommer kontrollerna att avgöra om grundläggande formulärets uppslag innehåller ett värde, vilket i så fall gör att formuläret återges.

Skydda dina formulär

Anteckning

Den här metoden för att skydda formulär kommer snart att tas bort. Därför ska den inte användas. Använd lämpliga tabellbehörigheter och konfiguration av webbroller om du vill ge användare åtkomst till alla data i stället. Mer information: Ändringar av tabellbehörighet för formulär och listor på nya portaler

För att skydda dina formulär måste du skapa tabellbehörigheter som bestämmer åtkomst och ägare av posterna enligt webbrollerna. Om en användare hamnar i ett grundläggande formulär utan behörighet kommer han/hon att få ett felmeddelande. Dessutom visas en varning när ett formulär har konfigurerats med tabellbehörigheter som inte är aktiverade:

Tabellbehörigheter måste aktiveras för den här posten, annars kan vem som helst på Internet visa data.

Aktivera behörigheter för ett grundläggande formulär genom att markera kryssrutan Aktivera tabellbehörigheter. Mer information: Skapa webbroller för portaler.

Attribut och relationer för grundläggande formulär

Namn	Beskrivning
Namn	Det beskrivande namnet på posten. Det här fältet är obligatoriskt.
Tabellnamn	Namnet på den tabell som formuläret ska läsas in från. Det här fältet är obligatoriskt.
Formulärnamn	Namnet på formuläret på måltabell som ska återges. Det här fältet är obligatoriskt.
Fliknamn	Valfritt namn på en flik i ett formulär för en angiven tabell som ska återges.
Läge	Ett av följande värden: Infoga Redigera Skrivskyddat Att välja Infoga anger att formuläret bör infoga en ny post vid överföring. Att ange Redigera anger att formuläret ska redigera en befintlig post. Att välja Skrivskyddat anger att formuläret ska visa ett icke redigerbart formulär för en befintlig post. Redigera och Skrivskyddat kräver att det finns en källpost och parametrar som anges i fälten "Postens källtyp" och "Parameternamn för post-ID" för att välja rätt post när formuläret läses in i portalen.
Postens källtyp	Ett av följande värden: Frågesträng Aktuell portalanvändare Post associerad med aktuell portalanvändare Att välja Frågesträng kräver att ett parameternamn måste anges i URL:ens frågesträng till formuläret. Detta kan anges i fältet "Parameternamn för post-ID". Att välja Aktuell portalanvändare kommer att hämta portalens användarpost för den aktuella autentiserade användaren. Välja post som är kopplad till den aktuella portalanvändaren hämtar portalanvändarens post för den aktuella autentiserade användaren och hämtar sedan posten för relationen som anges i fältet ”Realtionsnamn”.
Parameternamn för post-ID	Namnet på en parameter som anges i URL:ens frågesträng till webbsidan som innehåller det här grundläggande formuläret.
Relationsnamn	Krävs när postens källtyp är den post som är associerad till den aktuella portalanvändaren. Det logiska namnet på förhållandet mellan den aktuella portalanvändarposten och målposten. Detta måste returnera samma tabelltyp som anges i fältet tabellnamn.
Tillåt Skapa om null	Ett booleskt värde är tillgängligt när postens källtyp är posten som är associerad till den aktuella portalanvändaren. Anger att om den relaterade posten inte finns, tillåts användaren att skapa den posten första gången, annars kommer ett undantag uppkomma om posten inte redan finns eftersoom ett formulär kräver en post som data kan bindas till. OBS! Denna funktion är inte tillgänglig i formulär med flera steg.
Aktivera behörigheter för tabellen	Kommer att få formuläret att respektera tabellbehörigheter. Standardvärdet är "false" av bakåtkompatibilitetsskäl. Om värdet är sant, KRÄVS explicita behörigheter för alla användare som vill ha åtkomst till formuläret. OBS! Den här metoden för att skydda formulär kommer snart att tas bort. Därför ska den inte användas. Använd lämpliga tabellbehörigheter och konfiguration av webbroller om du vill ge användare åtkomst till alla data i stället. Mer information: Ändringar av tabellbehörighet för formulär och listor på nya portaler

Formuläralternativ

Name	Description
Lägg till captcha	Visar captcha.
Visa captcha för autentiserade användare	Visa captcha för autentiserade användare
Verifieringsgrupp	Gruppnamnet tilldelats indatakontroller för utvärdering av giltiga indata i namngivna grupper.
Autogenerera steg från flikar	Anger att flera flikar i ett grundläggande formulär visas för varje flik som ett sekventiellt steg som börjar med den första fliken, och fortsätter tills alla flikar har navigerats till och en sista post infogas efter sista insändande. Som standard markeras detta inte. Standardvärde anger att endast en flik eller ett formulär ska återges för det aktuella steget. Om fliknamnet inte anges visas den första fliken.
Återge webbresurser infogat	Eliminerar den iFrame som omfattar en webbresurs i ett grundläggande formulär.
Knappbeskrivningar aktiverade	Knappbeskrivningen ställs in med en beskrivning av attributet på måltabell.
Visa fält som inte stöds	Visa eller dölja kolumnnamn med Dataverse-kolumner som inte stöds.
Ange rekommenderade fält som obligatoriska	Gör alla attribut obligatoriska med fältkravnivå inställt på "Rekommenderas av företaget".
Gör alla fält obligatoriska	Gör alla fält obligatoriska oavsett fältkravnivå.
CSS-klass för verifieringssammanfattning	CSS-klassnamn som tilldelats verifieringssammanfattningen. Standardvärdet är "validering-sammanfattning avisering avisering-fel avisering-blockering"
Aktivera länkar för verifieringssammanfattning	Ett booleskt värde med SANT eller FALSKT anger om fästpunktlänkar ska återges i verifieringssammanfattning för att bläddra till det fält som innehåller ett fel. Standardvärdet är sant.
Länktext för verifieringssammanfattning	Etiketten som tilldelats länkarna för verifieringssammanfattningen. Standardvärdet är "klicka här".
Rubriktext för verifieringssammanfattning	Etiketten som tilldelats rubriken för verifieringssammanfattningen.
Anvisningar	Instruktioner om du vill arbeta med formuläret.
Meddelandet Det går inte att hitta posten	Meddelande som ska visas när en post inte hittas.

Inställningar för När klar

Namn	Beskrivning
När klar	Ett av följande värden: Visa framgångsmeddelande (standard) Omdirigera
Dölj formulär när klar	Kräver att När klar anges på Visa framgångsmeddelande. När den väljs döljs formuläret efter att ha skickat formuläret.
Framgångsmeddelande	Kräver att När klar anges på Visa framgångsmeddelande. Meddelandet visas för användaren efter att ha skickat. Om inget annat anges visas ett standardmeddelande (Inlämningen har slutförts). Ett fält kommer att kunna ange meddelandet i det associerade språket för varje språkpaket som är installerat och aktiverat för organisationen.
Extern URL	Kräver vid framgång anges som Omdirigera. Ange en URL till en extern resurs på webben.
eller webbsida	Kräver vid framgång anges som Omdirigera. Välj en webbsida från den aktuella webbplatsen.
Lägg till befintlig frågesträng	Kräver vid framgång anges som Omdirigera. När kryssrutan är markerad kommer befintliga frågesträngsparametrar att läggas till i mål-URL:en innan omdirigering.
Lägg till post-ID i frågesträng	Kräver vid framgång anges som Omdirigera. När kryssrutan är markerad kommer ID för den skapade posten att läggas till i URL:ens frågesträng som den omdirigeras till.
Parameternamn för post-ID	Kräver vid framgång anges som Omdirigera. Namnet på parameter-ID i URL:ens frågesträng som den omdirigeras till.
Lägg till anpassad frågesträng	Kräver vid framgång anges som Omdirigera. En anpassad sträng som kan läggas till den befintliga frågesträngen av omdirigerings-URL:en.
Lägg till attributvärde i frågesträng – parameternamn	Kräver vid framgång anges som Omdirigera. Ett namn som ges till den parameter som motsvarar attributvärde för måltabell som kommer att läggas till i omdirigerings-URL:ens frågesträng.
Lägg till attributvärde i frågesträng – attributets logiska namn	Kräver vid framgång anges som Omdirigera. Ett logiskt namn av ett attribut för måltabellen som ger värdet som ska läggas till i omdirigerings-URL:ens frågesträng.

Ytterligare inställningar

Namn	Beskrivning
Associera aktuell portalanvändare	Anger att posten för den aktuella inloggade användaren ska vara associerad med entiteten för tabellposten.
Uppslagskolumn för portalanvändare	Det logiska namnet på attributet på måltabellen som lagrar portalanvändaren.
Är aktivitetspart	Booleskt värde som anger huruvida sökkolumnen för portalanvändare är en aktivitetsparttyp.
Bifoga fil	Välj för att formuläret ska innehålla en kontroll för filöverföring längst ned i formuläret om du vill tillåta att en fil ska bifogas posten. Obs! Portaler med version 9.2.2.x och senare behöver inte aktivera Aktivera tabellbehörigheter i det grundläggande formuläret för att bifoga filer. Om du väljer alternativet måste du dock se till att rätt privilegier finns i det överordnade tabellen och i anteckningstabellen för att knappen Bifoga fil ska kunna visas i formuläret. Anteckningstabell måste ha minst privilegierna Skapa och Lägga till och den överordnade tabellen måste ha motsvarande AppendTo-privilegium. Beroende på om du har ett formulär för skapa eller uppdatera kan du också behöva skapa behörigheterna skapa, läsa och skriva för att slutföra formulärets scenario.
Lagringsplats för bifogad fil	Alternativ: Bifogad anteckning, Azure Blob Storage. Om din organisation har konfigurerats för att använda Azure Storage, kan du överföra filer för det här grundläggande formuläret. I annat fall lagras filer med som bifogad anteckning.
Tillåt flera filer	Ett booleskt värde anger huruvida användaren kan överföra flera filer.
Godkänn	Attributet accept anger de MIME-typer av filer som servern accepterar via filöverföring. Om du vill ange fler än ett värde, avgränsar du värdena med ett komma (t.ex. ljud ,video/,bild/*).
Etikett	Texten som visas bredvid filöverföringskontrollen. Ett fält kommer att kunna ange meddelandet i det associerade språket för varje språkpaket som är installerat och aktiverat för organisationen.
Bifoga fil krävs	Gör att en bilaga av en fil krävs för att fortsätta.
Obligatoriskt felmeddelande	Meddelandet visas under formulärvalidering om Krävs är sant och användaren inte har bifogat en fil. Ett fält kommer att kunna ange meddelandet i det associerade språket för varje språkpaket som är installerat och aktiverat för organisationen.
Begränsa filer till godkända typer	Framtvingar validering på fältet Acceptera. Om du inte markerade detta kommer attributet Acceptera endast att användas som ett förslag för filöverföringsdialogen.
Felmeddelande för filtyp	Meddelandet visas under formulärvalidering om begränsa filer till accepteras typer gäller och användaren försökte överföra en ogiltig filtyp. Ett fält kommer att kunna ange meddelandet i det associerade språket för varje språkpaket som är installerat och aktiverat för organisationen.
Maximal filstorlek (i kilobyte)	Framtvingar validering av den tillåtna storleken på den överförda filen.
Felmeddelande om filstorlek	Meddelandet visas under formulärvalidering om maximal filstorlek (i kilobytes) gäller och användaren försökte överföra en fil som är för stor. Ett fält kommer att kunna ange meddelandet i det associerade språket för varje språkpaket som är installerat och aktiverat för organisationen.
Anpassat JavaScript	Ett anpassat blocket med JavaScript kommer att läggas till längst ned på sidan precis före det avslutandet formulärtaggelementet. Indata-ID för HTML för ett tabellfält anges till det logiska namnet på attributet. Detta gör det enkelt att välja fält, inställningsvärden eller annan klientmanipulering med jQuery. $(document).ready(function() { $("#address1_stateorprovince").val("Saskatchewan");});

Associerad tabellreferens

Följande parametrar hör till att ställa in en referens associerad tabell när formuläret sparas.

Detta ger ett sätt att associera en aktuell post som skapas eller uppdateras av formuläret med en annan målpost. Detta är användbart om du har flera steg med flera tabelltyper och vill relatera de resulterande posterna, eller om sidan erhåller en frågesträng från ett post-ID som du vill associera. Vi har till exempel en karriärsida som visar en lista över lediga jobb, var och en med en länk till ett program för projektet som innehåller id för jobbinlägget till ansökningsformuläret så att när programmet skapas kommer jobbinlägget att associeras med posten.

Namn	Beskrivning
Ange tabellreferens vid spara	Ja eller Nej. Värdet ja anger att en referens associerad tabell ska tilldelas när formuläret sparas, annars kommer ingen att anges.
Relationsnamn	Relationsdefinitionens namn för en angiven relation mellan två tabelltyper.
Logiskt namn för tabell	Det logiska namnet på referenstabellen.
Logiskt namn på målets uppslagsattribut	Logiskt namn på det uppslagsattribut på måltabell som skapas eller uppdateras.
Fyll i uppslagsfält	Om uppslaget om referenstabellen är i formuläret, kommer fältet i formuläret att fyllas i med värdet som hämtas med hjälp av inställningen nedan om du markerar det här värdet.
Källtyp	Ett av följande värden: Frågesträng Att välja Frågesträng kräver att ett parameternamn måste anges i URL:ens frågesträng till formuläret. Detta kan anges i fältet Namn på frågesträng. Om den här parametern är den primära nyckeln väljer du Ja för Frågesträng är primär nyckel, annars väljer du Nej och anger attributets logiska namn på måltabellen till frågan som anges i fältet Frågeattributets logiska namn. Aktuell portalanvändare Att välja Aktuell portalanvändare kommer att hämta kontaktposten för den aktuella autentiserade användaren.
Steg för referenstabell	Stegposten för flerstegsformulär i ett tidigare steg för att hämta den tabell som skapades eller redigerades i det steget, för att associera det med posten för detta aktuella steg.
Namn på frågesträng	Det parameternamn som anges i URL:ens frågesträng till webbsidan som innehåller flerstegsformuläret.
Frågesträng är primär nyckel	Ja anger att frågesträngvärdet är värdet för primärnyckeln. Nej anger att frågesträngen är en attributtyp som skiljer sig från primärnyckeln.
Frågeattributets logiska namn	Logiskt namn på attributet för att ställa fråga om posten.
Visa information om skrivskydd	Anger att ett formulär ska återges högst upp på sidan som visar skrivskyddad information som rör referensposten. Kräver ett formulärnamn.
Formulärnamn	Namnet på formuläret på referenstabell som ska användas för att visa skrivskyddad information.

Åtgärdskonfigurationer för grundläggande formulär

Som standard tillåter ett grundläggande formulär läsning eller uppdatering av en befintlig post, eller infogandet en ny post. Du kan emellertid även enkelt aktivera och konfigurera ytterligare åtgärder för poster i ett grundläggande formulär (ta bort, aktivera, inaktivera, osv.). Det går också att åsidosätta standardetiketter, storlek och andra attribut som visas om det finns åtgärder som har aktiverats.

Dessa inställningar finns i avsnittet Ytterligare inställningar i det grundläggande formuläret. Som standard visas endast Grundläggande inställningar. Du kan välja Avancerade inställningar för att visa ytterligare inställningar.

Du kan lägga till åtgärdsknappar för åtgärder som gäller för en enskild post och som visas för varje rad i underrutnätet, förutsatt att lämplig behörighet har beviljats av tabellbehörigheter. Följande åtgärder är tillgängliga:

• Delete
• Arbetsflöde
• Skapa relaterad post
• Aktivera
• Inaktivera

Genom att klicka på något av följande alternativ visas ett konfigurationsområde för åtgärden. Vissa tabeller har dessutom särskilda åtgärder som är tillgängliga för dem på enskild tabellbasis:

• Beräkna värde för affärsmöjlighet (opportunity)
• Avbryta en åtgärd för ärende (incident)
• Stäng (lös) ärende (incident)
• Omvandla offerten till en order (offert)
• Konvertera order till faktura (säljorder)
• Skapa offert från affärsmöjlighet (affärsmöjlighet)
• Åtgärden stäng affärsmöjlighet (affärsmöjligt)
• Åtgärden Vinn affärsmöjlighet (affärsmöjlighet)
• Öppna ärendeåtgärd på nytt (incident)
• Låt affärsmöjlighet vänta (affärsmöjlighet)

Anteckning

Det rekommenderas att skapa ett arbetsflöde i stället för att lägga till knappen aktivera eller inaktivera för färdiga tabellerna som har definierat specifika värden för tillstånd och tillståndskod för deras affärsprocesser. Till exempel Incident (statusalternativen), affärsmöjlighet (statusalternativen), berättiganden (statusalternativen).

Konfiguration av platslokalisering för grundläggande formulär

Ett formulär kan konfigureras för att visa en kartkontroll för att antingen visa en befintlig plats som en kartnål på en karta eller för att ge möjlighet för användare att ange en plats. Se lägga till platslokalisering.

Formulärets kartkontroll kräver ytterligare konfiguration för att tala om vad ID:na för de olika platsfälten är för att tilldela/hämta värden till/från dem. Posten för grundläggande formulär har ett konfigurationsavsnitt som definierar dessa fältmappningar du måste ange. Fältnamnen varierar beroende på det schema som du har skapat.

Anteckning

• Adressfältet i ett skrivskyddat grundläggande formulär ersätts med kartan när platslokaliseringen aktiveras.
• Kartan återges endast när formuläret visas i ett modalt fönster.
• Avsnittet Geoplats visas inte i miljön Suveränt moln, Tyskland. Om en användare har aktiverat platslokalisering med ett annat formulär, visas det inte under återgivning på portalen.

Begäran om validering

Begäran om validering, en funktion för ASP.NET sedan version 1.1, hindrar servern från att acceptera innehåll som innehåller en avkodad HTML-kod. Den här funktionen är utformad för att förhindra vissa angrepp med skriptinmatning genom att en klients skriptkod eller HTML-kod kan omedvetet skickas till en server, lagras och sedan visas för andra användare. Vi rekommenderar fortfarande att du validerar alla indata och HTML-kod när det passar.

Som standard aktiveras begäransverifiering på portalen vilket resulterar i följande allmänna fel om du anger skriptkod utan HTML-kod i grundläggande formulärfält:

Found field(s) submitted with potentially dangerous value(s) such as HTML, or script. Please review the field value(s) and try again.

Så här inaktiverar du begäran om validering:

1. Gå till portalinställningar och välj Webbplatsinställningar.

2. Välj Nytt.

3. Skriv namnet som DisableValidationWebTemplate.

4. Välj lämplig webbplatspost.

5. Skriv värdet som sant. Som standard är inställningen falsk som aktiverar begäran om validering.

6. Ange lämplig beskrivning.

7. Välj Spara och stäng.

Varning

Om begäran om validering har inaktiverats kan innehåll skickas till en sida. Du måste se till att innehåll är korrekt kodat eller bearbetat.

Att tänka på

• Ett Grundläggande formulär måste associeras med en webbsida för en given webbplats för att formuläret ska kunna visas på webbplatsen.
• Underrutnät i anslutningstabeller stöds inte i grundformulär. Om du lägger till ett underrutnät för anslutningstabellen med formulärdesigner kan felmeddelanden visas när du återger formuläret på portalen och använda anslutningstabellen.
• Dubblettfält, partylistefält och affärsregler stöds inte i grundformulär.
• Kodkomponenter på fältnivå finns i förhandsgranskning för allmänheten och kan läggas till i formulär. Mer information: Lägga till kodkomponenter i ett fält i modellstyrda appar
• Med affärsregler och klient-API kan låsta fält aktiveras i ett skrivskyddat formulär.
• Om du skapar ett grundläggande formulär i läget Infoga kan du inte ändra justeringen för en knapp eller placera en åtgärd ovanför det grundläggande formuläret.
• Om du gör en sökkontroll till en nedrullningsbar lista i formuläret fungerar inte det relaterade postfiltret.
• Sammanslagningskolumner i portalformulär kan ibland visas som redigerbara, men de är avsedda att vara skrivskyddade. För att se till att kolumnerna förblir skrivskyddade markerar du kolumnen som skrivskyddad i det modellstyrda appformuläret.

Se även

• Konfigurera en portal
• Egenskaper för flerstegsformulär för portaler
• Flerstegsformulärsteg för portaler
• Metadata för flerstegsformulär för portaler
• Konfiguration av underrutnät för flerstegsformulär för portaler
• Anteckningskonfiguration för grundläggande formulär och flerstegsformulär för portaler

Anteckning

Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)

Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).