Använd entitetsformulärkontrollUse the Entity form control

Skapa appar snabbare med entitetsformulärkontroll för att lägga till avancerade formulär för en Common Data Service-entitet.Create apps faster by using the Entity form control to add rich forms for a Common Data Service entity.

En introduktion till entitetsformulärkontroll, finns i det här blogginlägget: Ny entitetsformulärkontroll (experimentfunktion) för Common Data Service.For an introduction to the Entity form control, see this blog post: New entity form control (experimental feature) for Common Data Service.

Viktigt: Tänk på den experimentella natur som entitetsformulärkontrollen har, som beskrivs i blogginlägget, och var försiktig med att använda entitetsformulärkontrollen i produktionsappar, åtminstone just nu.Important: Please be aware of the experimental nature of the Entity form control as outlined in the blog post, and be careful about using the Entity form control in production apps, at least for now.

NyckelegenskaperKey properties

Här följer nyckelegenskaperna för en entitetsformulärkontroll.Here are the key properties of an Entity form control.

DataSource – anger den datakälla som innehåller de poster som du vill visa.DataSource – Specifies the data source that contains the record(s) that you want to display.
Observera: För närvarande stöds endast enheter i Common Data Service som datakällor för entitetsformulärkontrollen.Note: Currently only entities in the Common Data Service are supported as data sources for the Entity form control.

Pattern – anger formatet för formuläret som du vill visa i entitetsformulärkontrollen.Pattern – Specifies the style of the form that you want to display in the Entity form control. Ange den här egenskapen genom att använda FormPattern-uppräkning.Set this property by using the FormPattern enumeration.

  • FormPattern.List – visar en lista med poster i tabellformat.FormPattern.List – Displays a tabular list of records.
  • FormPattern.CardList – visar en kort lista med poster.FormPattern.CardList – Displays a card list of records.
  • FormPattern.Details – visar ett formulär för att visa eller redigera detaljer för en enskild post.FormPattern.Details – Displays a form to view or edit the details of a single record.
  • FormPattern.None – ingen formatmall har uttryckligen angetts.FormPattern.None – No style has been explicitly specified. Standard är List för tablet-appar och CardList för telefonappar.Defaults to List for tablet apps and CardList for phone apps.

Item – anger posten i den datakälla som entitetsformulärkontrollen ska visa.Item – Specifies the record in the data source that the Entity form control should display. Den här egenskapen används endast när Pattern har angetts till FormPattern.Details.This property is used only when Pattern is set to FormPattern.Details.

Selected – hämtar den post som för närvarande är markerad.Selected – Gets the record that’s currently selected.
Exempel: Om entitetsformulärkontrollen visar en lista över försäljningsorderposter, ger egenskapen Selected dig den post som för närvarande är markerad.Example: If the Entity form control displays a list of sales-order records, the Selected property will give you the record that’s currently selected. Du kan även använda ett fält i en post.You can also access a field within a record. (Ange till exempel värdet för fältet Konto för den valda posten som Selected.Account.)(For example, specify the value of the Account field of the selected record as Selected.Account.)

SelectableFields – anger vilka fält som ska visas som länkar.SelectableFields – Specifies which fields should appear as links. Ange värdet för den här egenskapen med följande syntax:Set the value of this property by using this syntax:
{Field1Name : sant, Field2Name : sant}{Field1Name : true, Field2Name : true}
Exempel: Om du vill att fälten SalesOrderId och Konto ska visas som länkar i ett formulär kan du ange egenskapen SelectableFields för det formuläret till det här värdet:Example: If you want the SalesOrderId and Account fields to appear as links in a form, set the SelectableFields property of that form to this value:
{SalesOrderId : sant, Konto : sant}{SalesOrderId : true, Account : true}

SelectedField – bestämmer vilka fält som har klickats eller tryckts på.SelectedField – Determines which field was clicked or tapped. Detta gäller enbart för de fält som anges som SelectableFields.This applies only to the fields specified as SelectableFields.
Exempel: Om du ställer in egenskapen SelectableFields till {SalesOrderId : true, Konto : true} och användaren klickar eller trycker på fältet Konto, anges SelectedField.Account till sant.Example: If you set the SelectableFields property to {SalesOrderId : true, Account : true} and the user clicks or taps the Account field, SelectedField.Account is set to true.

OnFieldSelect – hur en app reagerar när användaren klickar eller trycker på ett fält.OnFieldSelect – How an app responds when the user clicks or taps a field. Detta gäller enbart för de fält som anges som SelectableFields.This applies only to the fields specified as SelectableFields.

Mode – anger läget för formuläret.Mode – Determines the mode of the form. Om du vill ändra läget använder du funktionen ViewForm, EditForm eller NewForm.To change the mode, use the ViewForm, EditForm, or NewForm function. Fungerar bara när egenskapen Pattern har angetts till FormPattern.Details.These functions work only when the Pattern property is set to FormPattern.Details. Ange ett värde för egenskapen Mode till ett värde för FormMode-uppräkning.Set the value of the Mode property to a value of the FormMode enumeration.

  • FormMode.View – låter användarna visa men inte redigera eller lägga till en post.FormMode.View – Allows users to view but not edit or add a record.
  • FormMode.Edit – tillåter användare att redigera en post.FormMode.Edit – Allows users to edit a record.
  • FormMode.New – tillåter användare att lägga till en post.FormMode.New – Allows users to add a record.

OnSuccess – Hur en app svarar när en dataåtgärd har lyckats.OnSuccess – How an app responds when a data operation has been successful.

OnFailure - hur en app reagerar när en dataåtgärd har misslyckats.OnFailure - How an app responds when a data operation has been unsuccessful.

Unsaved – anger om en post som en användare redigerar har sparats.Unsaved – Determines whether a record that a user is editing has unsaved changes.

Du kan använda delade funktioner med antingen entitetsformulärkontroll eller redigera formulärkontroll.You can use these shared functions with either the Entity form control or the Edit form control. Dessa funktioner fungerar med entitetsformulärkontrollen bara när dess egenskap Pattern är inställd till FormPattern.Details.These functions work with the Entity form control only when its Pattern property is set to FormPattern.Details.

ViewForm – anger egenskapen Mode för en entitetsformulärkontroll till FormMode.View.ViewForm – Sets the Mode property of an Entity form control to FormMode.View.

EditForm – anger egenskapen Mode för en entitetsformulärkontroll till FormMode.Edit.EditForm- Sets the Mode property of an Entity form control to FormMode.Edit.

NewForm – anger egenskapen Mode för en entitetsformulärkontroll till FormMode.New.NewForm - Sets the Mode property of an Entity form control to FormMode.New.

SubmitForm – sparar ändringar när en användare redigerar en post i en entitetsformulärkontroll.SubmitForm - Saves changes when a user edits a record in an Entity form control.

ResetForm – avbryter ändringar när en användare redigerar en post i en entitetsformulärkontroll.ResetForm - Abandons unsaved changes when a user edits a record in an Entity form control.

Nu när du har en översikt över de olika egenskaperna och funktionerna kan vi titta på dem i praktiken.Now that you have an overview of the various properties and functions, let’s look at them in action.

Observera: Om du inte har åtkomst till Common Data Service-databasen, kan du skapa en innan du börjar följa dessa steg.Note: If you don’t have access to a Common Data Service database, create one before you start to follow these steps.

Visa en lista med posterDisplay a list of records

I nästa fem procedurer följer exempel på hur du använder ett enkelt exempel från slutpunkt till slutpunkt för hur du använder entitetsformulärkontroller.The next five procedures provide a single, end-to-end example of how to use Entity form controls. Lägg i den här proceduren till ett formulär som visar en lista över försäljningsorder.In this procedure, add a form that shows a list of sales orders.

  1. Skapa en tom tablet-app.Create a blank tablet app.

  2. Byt namn på den första skärmen SalesOrderListScreen.Rename the first screen SalesOrderListScreen.

  3. På fliken Infoga klickar du på eller trycker på Formulär, och klickar sedan på eller trycker på Entitetsformulär (experimentell).On the Insert tab, click or tap Forms, and then click or tap Entity form (experimental).

    En entitetsformulärkontroll har lagts till på skärmen.An Entity form control is added to the screen.

  4. Byt namn på entitetsformulärkontrollen till SalesOrderListForm, och ändra storlek på den så att den täcker hela skärmen.Rename the Entity form control SalesOrderListForm, and resize it to cover the entire screen.
  5. Klicka i rutan till höger eller tryck på databasikonerna bredvid texten Ingen datakälla har valts, och klicka sedan på eller tryck på Lägg till en datakälla.In the right-hand pane, click or tap the database icon next to the text No data source selected, and then click or tap Add a data source.

  6. I listan över anslutningar, klicka eller tryck på anslutningen för databasen.In the list of connections, click or tap the connection for your database.

  7. I listan över enheter klicka eller tryck på Försäljningsorder, och klicka sedan på eller tryck på Anslut.In the list of entities, click or tap Sales order, and then click or tap Connect.

    En datakälla för entiteten Försäljningsorder har skapats och egenskapen DataSource för SalesOrderListForm har angetts till datakällan.A data source for the Sales order entity is created, and the DataSource property of the SalesOrderListForm is set to that data source.

    Entitetsformulärkontrollen visar en lista över försäljningsorder.The Entity form control shows a list of sales orders. Med hjälp av entitetsformulärkontrollen kan du snabbt visa ett listformulär utan att behöva skapa det manuellt.By using the Entity form control, you quickly displayed a list form without having to manually build it.

    Ställa in egenskapen Pattern för entitetsformulärkontrollen så att den som standard använder mönstret List.You didn’t set the Pattern property for the Entity form control, so it defaults to the List pattern. Dessutom används fältgruppen DefaultList för entiteten Försäljningsorder för att visa listformuläret.In addition, the DefaultList field group of the Sales order entity is used to display the list form. Formuläret är också dynamiskt och avspeglar ändringar i fältgruppen automatiskt.The form is also dynamic and will automatically reflect any change in the field group.

  8. (Valfritt) visar fältgruppen DefaultList för entiteten Försäljningsorder:(Optional) View the DefaultList field group of the Sales order entity:

    1. Logga in på powerapps.com klicka eller tryck på Common Data Service i det vänstra navigeringsfältet. Klicka eller tryck sedan på Entiteter.Sign in to powerapps.com, click or tap Common Data Service in the left navigation pane, and then click or tap Entities.
    2. I listan över enheter, klicka eller tryck på Försäljningsorder, klicka på eller tryck på fliken Fältgrupper och klicka sedan eller tryck på fältgruppen DefaultList.In the list of entities, click or tap Sales order, click or tap the Field groups tab, and then click or tap the DefaultList field group.

      Fälten i listan över försäljningsordern matchar de som anges här.The fields in the sales order list match those listed here.

      I Common Data Service, kan du ändra fältgrupper för anpassade entiteter (men inte standardentiteter) för att ändra de fält som visas i motsvarande formulär som entitetsformulärkontrollen visar.In the Common Data Service, you can modify field groups for custom entities (but not standard entities) to change the fields that appear on the corresponding forms that the Entity form control displays. Bästa av allt är att eventuella ändringar i fältgruppen återspeglas automatiskt i alla appar som använder en entitetsformulärkontroll för att visa motsvarande formulär.Best of all, any change to the field group is automatically reflected in all the apps that use an Entity form control to display the corresponding form.

Visa information om en postDisplay the details of a record

Lägg till en annan entitetsformulärkontroll för att visa information om försäljningsordern som har valts i listan som du skapade tidigare.Let’s add another Entity form control to display the details of the sales order that’s selected in the list that you created earlier.

  1. Ändra storlek på SalesOrderListForm för att täcka halva skärmen och lägg till en andra entitetsformulärkontroll för den andra halvan av skärmen.Resize SalesOrderListForm to cover half the screen, and add a second Entity form control to cover the other half of the screen.

  2. Byt namn på den andra entitetsformulärkontrollen till SalesOrderDetailsForm, och anslut den till datakällan Försäljningsorder som du skapade tidigare.Rename the second Entity form control SalesOrderDetailsForm, and connect it to the Sales order data source that you created earlier.

  3. Ange egenskapen Pattern för SalesOrderDetailsForm till FormPattern.Details.Set the Pattern property of SalesOrderDetailsForm to FormPattern.Details.

    SalesOrderDetailsForm använder fältgruppen DefaultDetails i entiteten Försäljningsorder för att visa formuläret.SalesOrderDetailsForm uses the DefaultDetails field group of the Sales order entity to display the form. Med SalesOrderListForm, kan du snabbt visa registrerad information utan att manuellt skapa ett formulär.As with the SalesOrderListForm, you can quickly show record details without having to manually build a form.

  4. Ange egenskapen Item för SalesOrderDetailsForm till SalesOrderListForm.Selected.Set the Item property of SalesOrderDetailsForm to SalesOrderListForm.Selected.

    SalesOrderDetailsForm visar information om den post som användaren klickar eller trycker på i SalesOrderListForm.SalesOrderDetailsForm will display the details of the record that the user clicks or taps in SalesOrderListForm.

  5. Förhandsgranska appen genom att trycka på F5, och klicka på eller tryck på en försäljningsorder i listan till vänster.Preview the app by pressing F5, and then click or tap a sales order in the list on the left.

    Information om den order som du har valt visas till höger.The details of the order that you selected appear on the right side.

Konfigurera ett fält för att navigera till en annan skärmConfigure a field to navigate to another screen

Härnäst lägger vi till flera skärmar i vår app och konfigurerar sedan fälten i en entitetsformulärkontroll för att navigera till en annan skärm i appen när användaren klickar eller trycker på ett fält.Next let’s add more screens to our app and then configure fields in an Entity form control to navigate to another screen in the app when the user clicks or taps a field.

  1. Lägg till en andra skärm till appen och byt namn på skärmen till SalesOrderDetailsScreen.Add a second screen to the app, and rename the screen SalesOrderDetailsScreen.
  2. Klipp ut SalesOrderDetailsForm, klistra in det på SalesOrderDetailsScreen, och ändra storlek på formuläret till att omfatta det mesta av skärmen, men lämna tillräckligt med utrymme för en ikon överst på skärmen.Cut the SalesOrderDetailsForm, paste it on the SalesOrderDetailsScreen, and resize the form to cover most of the screen, leaving enough space for an icon at the top.
  3. Lägg till en ikon med en bakåtpil nära det övre vänstra hörnet i SalesOrderDetailsScreen.Add a back-arrow icon near the upper-left corner of SalesOrderDetailsScreen.
  4. Ange egenskapen OnSelect för ikonen med bakåtpilen till funktionen Back.Set the OnSelect property of the back-arrow icon to the Back function.

  5. SalesOrderListScreen, ändra storlek på SalesOrderListForm till att täcka hela skärmen.On the SalesOrderListScreen, resize the SalesOrderListForm to cover the entire screen.
  6. Klicka på eller tryck på SalesOrderListForm för att välja den.Click or tap the SalesOrderListForm to select it.
  7. I den högra rutan under Fält, ange SalesOrderId för att navigera till SalesOrderDetailsScreen.In the right-hand pane, under Fields, set SalesOrderId to navigate to the SalesOrderDetailsScreen.

    Entitetsformulärkontrollen visar värdena i fältet SalesOrderId (den första kolumnen i listan) som länkar.The Entity form control displays the values in the SalesOrderId field (the first column in the list) as links.

  8. Förhandsgranska appen genom att trycka på F5, och klicka på eller tryck på en länk i listan över försäljningsorder.Preview the app by pressing F5, and then click or tap a link in the list of sales orders.

    Den andra skärmen öppnas och visar information om försäljningsordern som du har angett.The second screen opens and displays the details of the sales order that you specified.

    För att visa information om en annan försäljningsorder, klicka eller tryck på bakåtpilen om du vill gå tillbaka till listan och klicka eller tryck på länken för den order som du vill visa information för.To display the details of a different sales order, click or tap the back arrow to navigate back to the list, and then click or tap the link of the order for which you want to show details.

Egenskapen Item för SalesOrderDetailsForm har angetts till SalesOrderListForm.Selected så att SalesOrderDetailsForm visar information om den post som användaren väljer i SalesOrderListForm.The Item property of the SalesOrderDetailsForm is set to SalesOrderListForm.Selected so that SalesOrderDetailsForm shows details about the record that the user selects in SalesOrderListForm. Du kan också få kontexten för den valda posten med hjälp av kontextvariabeln NavigationContext som skapas automatiskt när du använder fönstret Anpassa formulär för att konfigurera ett fält att navigera.You can also get the context of the selected record by using the NavigationContext context variable, which gets automatically created when you use the form-customization pane to configure a field to navigate.

  1. Ange egenskapen Item för SalesOrderDetailsForm till NavigationContext.Set the Item property of SalesOrderDetailsForm to NavigationContext.

  2. Förhandsgranska appen genom att trycka på F5, och klicka på eller tryck på en länk i listan över försäljningsorder.Preview the app by pressing F5, and then click or tap a link in the list of sales orders.

    Appen öppnar SalesOrderDetailsScreen och visar information om den försäljningsorder som du har angett.The app opens SalesOrderDetailsScreen and displays the details of the sales order that you specified.

Låt oss analysera hur fönstret Anpassa formulär ställer in navigeringen och kontexten för oss.Let’s dig into how the form-customization pane sets up the navigation and context for us.

Egenskapen SelectableFields för SalesOrderListForm anger SalesOrderId som ett valbart fält.The SelectableFields property of the SalesOrderListForm specifies SalesOrderId as a selectable field.

Detta ställdes in automatiskt när vi använde fönstret Anpassa formulär för att få fältet SalesOrderId att navigera till SalesOrderDetailsScreen.This was set up automatically when we used the form-customization pane to make the SalesOrderId field navigate to the SalesOrderDetailsScreen. Därför visas värdena i fältet SalesOrderId som länkar.Therefore, the values in the SalesOrderId field appear as links.

Egenskapen OnFieldSelect för SalesOrderListForm är inställd på funktionen If , som avgör om användaren klickar eller trycker på fältet Försäljningsorder-ID: SalesOrderListForm.SelectedField.SalesOrderId = sant.The OnFieldSelect property of the SalesOrderListForm is set to an If function, which determines whether the user clicks or taps the Sales order ID field: SalesOrderListForm.SelectedField.SalesOrderId = true.

Om funktionen utvärderas till sant, öppnas SalesOrderDetailsScreen med kontextvariabeln NavigationContext som vi använde tidigare.If the function is evaluated as true, the SalesOrderDetailsScreen opens with the context variable named NavigationContext that we used earlier.

Allt detta ställdes också in automatiskt in när vi använde fönstret Anpassa formulär för att få fältet SalesOrderId att navigera till SalesOrderDetailsScreen.All this was also set up automatically when we used the form-customization pane to make the SalesOrderId field navigate to the SalesOrderDetailsScreen.

När användaren klickar eller trycker på ett fält för försäljningsorder-ID, utvärderas därför funktionen If till sant, och funktionen Navigate anropas med motsvarande kontext, vilket öppnar informationsskärmen.Therefore, when the user clicks or taps a sales order ID field, the If function evaluates to true, and the Navigate function is called with the corresponding context, opening the details screen.

Observera: När du använder fönstret Anpassa formulär bestäms NavigationContext intelligent åt dig.Note: When you use the form-customization pane, the NavigationContext is intelligently determined for you. När användaren klickar eller trycker på SalesOrderId, har NavigationContext angetts till SalesOrderListForm.Selected, som den tidigare formeln visar.When the user clicks or taps SalesOrderId, NavigationContext is set to SalesOrderListForm.Selected, as the earlier formula shows. Om vi hade angett fältet Konto för navigering istället, skulle NavigationContext ha ställts in till SalesOrderListForm.Selected.Account, vilket säkerställer att rätt sammanhang skickas.If we had specified the Account field for navigation instead, NavigationContext would have been set to SalesOrderListForm.Selected.Account, ensuring that the correct context is passed. Men om du vill använda denna kontext behöver du en entitetsformulärkontroll som är kopplad till entiteten Konto i Common Data Service.However, to consume that context, you would need an Entity form control connected to the Account entity in the Common Data Service.

Redigera och spara en postEdit and save a record

Slutligen ska vi titta på hur vi kan redigera och spara en post i en entitetsformulärkontroll.Finally let’s look at how we can edit and save a record in an Entity form control.

  1. SalesOrderDetailsScreen, lägger du till en ikon för redigering och anger sedan dess egenskap OnSelect till den här formeln:On the SalesOrderDetailsScreen, add an edit icon, and then set its OnSelect property to this formula:
    EditForm(SalesOrderDetailsForm)EditForm(SalesOrderDetailsForm)

  2. Lägg till en bockikon bredvid redigeringsikonen och ange sedan egenskapen OnSelect för bockikonen på den här formeln:Add a checkmark icon next to the edit icon, and then set the OnSelect property of the checkmark icon to this formula:
    SubmitForm(SalesOrderDetailsForm)SubmitForm(SalesOrderDetailsForm)

  3. Förhandsgranska appen genom att trycka på F5, klicka eller tryck på en länk för Försäljningsorder-ID för att visa information om en försäljningsorder och klicka eller tryck sedan på redigeringsikonen.Preview the app by pressing F5, click or tap a Sales order ID link to view the details of a sales order, and then click or tap the edit icon.

    Mode för entitetsformulärkontrollen är inställt till FormMode.Edit så att du kan redigera posten.The Mode of the Entity form control is set to FormMode.Edit so that you can edit the record.

  4. Uppdatera Orderstatus till Faktura.Update the Order status to Invoice.

  5. Uppdatera Säljare till WRK014.Update the Sales person to WRK014.

    För att välja Säljare, gör entitetsformulärkontrollen automatiskt en omfattande detaljerad sökning.To help you pick the Sales person, the Entity form control automatically renders a rich detailed lookup. För att skapa och visa den här sökningen, använder kontrollen fältgruppen DefaultLookup i entiteten Underordnad i Common Data Service.To generate and display this lookup, the control uses the DefaultLookup field group of the Worker entity in the Common Data Service. Entiteten Underordnad används eftersom fältet Säljare är av typen Underordnad.The Worker entity is used because the Sales person field is of type Worker.

  6. Klicka eller tryck på bockikonen för att spara ändringarna.Click or tap the checkmark icon to save your changes.

Det här steget fullbordar den här artikeln om hur du använder entitetsformulärkontrollen i dina appar.This step concludes this article on how to use the Entity form control in your apps. Vi hoppas att du tycker att den information som beskrivs här är användbar för att komma igång med entitetsformulärkontrollen.We hope that you find the information covered here useful to get started using the Entity form control. Vi ser fram emot att höra vad du tycker om entitetsformulärkontrollen och vårt försök att hjälpa dig att snabbt lägga till avancerade formulär dina appar.We look forward to hearing what you think about the Entity form control and our overall push toward helping you quickly add rich forms to your apps.