Custom Dataset New Record Form

Updated January 12, 2023 14:59

Expand-All Collapse-All

Similar to the default form that creates new person record in Slate, you can make a form that creates records for other datasets.

Creating the Form

Create the Form

Select Forms on the top navigation bar Select New Form. A popup appears (pictured). Configure each setting* as necessary. Click Save
*Click here for a complete listing of all setting descriptions.

Adjust the Scope

Select Edit Form.
Select Edit Properties.
Change the Scope of the form to Dataset
Select the appropriate Dataset from the Dataset list.
Configure any other setting* as necessary.
Select Save.

*Click here for a complete listing of all setting descriptions.

Customize the Form

Default Fields

Prior to changing the scope, the scope of the form was person. Therefore the default person scoped form fields should be removed. Hover over each field and select the X that appears on the right side of the field. Confirm the deletion by clicking OK on the dialog box.

Dataset-Scoped Fields

Add in the desired form fields for the new dataset record, mapping to your new dataset-scoped custom fields.

Required Form Fields

Make sure to map a form field to the Name and Key or unique-for-merging field.

Record > Name

Mapping to Record > Name sets the display name for the dataset record. If the name is determined by a calculation of form fields (such as first name + last name), include a hidden form field using a calculation formula. The following example illustrates a typical dialog:

System Field to Record > Key

Mapping to the Key or unique-for-merging field ensures matching of form submissions based on the established matching criteria. To map to the Key, set the System Field to Record > Key. To map to the unique-for-merging field, set the System Field to Fields > the unique-for-merging field for the dataset.

Integrating the New Record Form

Now that you have created a record creation form, you can use it to replace the default New Record button functionality.

Note

These steps depend on whether you have enabled the Configurable Joins Record Lookup early access feature.

Using Configurable Joins Lookup

From the main navigation, select Records.
Click the Searcher icon in the top-right corner. A pop-up appears.
Click the Edit Shared Views link. On the Shared Views page, click the Edit Lookup button. Select the new record form you created in the dropdown menu. Click Save.

Using Traditional Query Bases

Within the New Record form that was just created, right-click the New Registration link on the registration page, and then select Copy link address.
Select Database on the top navigation.
Select Query Bases.
Select the Query Base of the new dataset.
In the Create Record URL settings, paste the New Registration link that was previously copied.
Select Save.

When manually adding a record to the custom dataset, if an error appears that reads "Resource not available," this indicates that the query base has not been properly configured. Go to the Query Base with the Database tool and complete the Create Record URL setting.