CRMJettyBack to crmjetty.comContact us
Menu
Docs / Guides

CRMJetty Portal

Works with
Docs / Dynamics 365

Dynamics 365 Customer Portalv6.3.0

Docs / Salesforce

Salesforce Customer Portalv6.3.0

Docs / Business Central

Business Central Portal

Guides / Forms

How to Create a Portal Form for Any CRM Entity

8 min readUpdated
Short answerGo to Design → Form Builder, select + Create, enter a title and select Save. Add a section and grid, select the entity and a creation method (Create New, Use Existing or Use All), drag in the fields, then publish the form and add it to a page with the Form widget.

You can create a portal form for any entity (Dynamics 365), object (Salesforce) or table (Business Central) that is synced with the portal. Portal users then use the form to add, edit or view records, and the data goes to your CRM.

Before you start

Open Form Builder

Go to Design → Form Builder. The Forms page lists every form with these columns:

Column What it shows
Title The name of the form.
Status The status of the form.
Language The language of the form.
Owner The admin who owns the form.
Entity The entity the form is built on.
Created On The date the form was created.

From this page you can also create, duplicate, delete, filter, preview and translate forms.

Design → Form Builder list showing the Title, Status, Language, Owner, Entity and Created On columns
Design → Form Builder list showing the Title, Status, Language, Owner, Entity and Created On columns
Design → Form Builder list showing the Title, Status, Language, Owner, Entity and Created On columns
Design → Form Builder list showing the Title, Status, Language, Owner, Entity and Created On columns

Create the form

  1. On the Forms page, select + Create.
  2. In the pop-up, enter the Title of the form.
  3. Select Save. The form layout design page opens.

Build the form layout

Every form layout is built in the same order: Add Section → Add Grid → Add Fields.

  1. On the left side of the page, select the + icon to add a section.
  2. Optionally, edit the section’s Panel Title and select Save.
  3. In the section, select Add Grid.
  4. Select a grid option. It is added to the selected section.
Form layout design page with a section added, the Add Grid button and the grid options displayed
Form layout design page with a section added, the Add Grid button and the grid options displayed
Form layout design page with a section added, the Add Grid button and the grid options displayed
Form layout design page with a section added, the Add Grid button and the grid options displayed

Note: Each grid box holds only one field. Design your sections and grids with enough boxes for your fields.

For forms with several titled sections, see How to Create Multi-Section Portal Forms.

Select the entity and creation method

  1. Select the Entity (Business Central: Table) from the drop-down list.
  2. Select how you want to add fields:
Creation method What it does
Create New Build the form from scratch by dragging in the fields you need.
Use Existing Start from a form that already exists in your CRM. See How to Use Existing CRM Forms and Views in the Portal.
Use All Add all the fields of the selected entity.
Form layout design page with the Entity drop-down and the Create New, Use Existing and Use All options
Form layout design page with the Entity drop-down and the Create New, Use Existing and Use All options
Form layout design page with the Entity drop-down and the Create New, Use Existing and Use All options
Form layout design page with the Entity drop-down and the Create New, Use Existing and Use All options

Note: You can only select entities that are synced with the portal. If the entity is missing, sync the CRM entity to the portal entities first.

Add and configure fields

  1. In the field list on the right, find the field. Use the search box to find it quickly.
  2. Drag the field into a grid box on the left.
  3. Repeat for each field you need.
  4. To configure a field, select its Settings icon and change the settings below.
  5. Select Save.
Fields dragged from the right-hand field list into the grid, with the field Settings icon highlighted
Fields dragged from the right-hand field list into the grid, with the field Settings icon highlighted
Fields dragged from the right-hand field list into the grid, with the field Settings icon highlighted
Fields dragged from the right-hand field list into the grid, with the field Settings icon highlighted
Setting What it does
Label The field name portal users see.
Placeholder Text shown inside the field before the portal user enters data.
Help Tip Extra guidance about the field.
Default Value A value the field is filled with by default.
Read Only Portal users can’t enter data in the field.
Required Portal users must fill in the field before they can continue.

For more, see How to Edit Form Field Labels and Placeholders.

Design the Add, Edit and Detail forms

After you select the entity and creation method, you can design the layout of the Add, Edit and Detail pages of the form.

See How to Design Add, Edit and Detail Form Layouts.

Publish the form

  1. Select Publish, or save the form as a draft to finish later.
  2. Optionally, preview the form to check its layout. You can preview a form after you save it as a draft or publish it.

Note: Draft forms are disabled in the portal. Publish a form before you use it on a page.

Add the form to a page

  1. Open the page in Design → Page Builder.
  2. Drag the Form widget onto a grid.
  3. Select the Settings icon on the widget.
  4. Enter a Form Title and, in Select Form View, select the form view to show.
  5. Set the success and exit settings, such as the On Success page and the Submit Button Text.
  6. Select Save, then publish the page.
Form widget configuration panel with Form Title, Select Form View and Select Record Type
Form widget configuration panel with Form Title, Select Form View and Select Record Type
Form widget configuration panel with Form Title, Select Form View and Select Record Type
Form widget configuration panel with Form Title, Select Form View and Select Record Type

Troubleshooting

The entity is not in the Entity drop-down: Only entities synced with the portal appear. Enable the entity in Entity Configurations (Business Central: Table Configurations) or sync your CRM, then reopen the form.

The form doesn’t appear in the portal: The form is still a draft. Publish the form and the page it’s on.

A field won’t drop into a grid box: The box already holds a field. Add another grid or choose a grid with more boxes.

Did this solve it?No, contact support