Integrate with other Foundry applications

Forms offers seamless integration with other Foundry applications. This page discusses how Foundry Forms can be used with Fusion, Slate, and Object Explorer.

Fusion

If Fusion is chosen as the response destination, Forms will immediately create the backing spreadsheet. Every time the form is saved, the newly required columns will be automatically added to the table region.

Users can also create a form from an existing table region in Fusion by selecting the Insert tab and choosing Form.

Slate

Two Slate widgets can be used to embed a form in Slate:

• Foundry Form
• iIframe

When using an iframe, the following URL parameters can be used to customize the display of the form:

• embedded=true: Must be provided when iframing a form.
• noHeader=true: Will remove the header from the form.
• progressOnly=true : Will render only the progress bar as the header; ignored when noHeader=true.
• forceDarkMode=true: Will render the form in dark mode.

Additionally, users can prefill values by using the Code Editor to add a urlParam to each field:

fields:
  - uri: display.Text
    name: Text
    type: Text
    urlParam: text
    options: {}

The URL will then show as: workspace/fforms/f/new/<form-id>?embedded=true&progressOnly=true&text=prefilled.

Object Explorer

Three section widgets can be used to embed a form in an Object View:

• Edit object form
• Create linked object form
• iframe

In addition, Forms supports bulk editing multiple objects through one object-backed form.

Edit object form

To add the Edit object form section:

1. Create a form linked with object type X.
2. Navigate to the Object View for X, and select Actions followed by Edit object view.
3. Add the Edit object form section.

The Default Form ID can be found in the Forms URL: /workspace/fforms/v1/entry/<form-id>/new.

In the Prefilled Values section:

• The URI or URL parameter associated with a field can be found using the Code Editor.
• The values themselves can either be static (2000-01-01) or taken from a property of the current object ({{start_date}}, where start_date is a property ID for object type X).

The Conditional Form section can be used to render different forms based on the value of some property.

Create linked object form

Adding and configuring this section is very similar to editing an object form, with two notable differences:

1. The section should be added to the Object View for Y, which is linked to X.
2. The form can be prefilled based on the last linked object, and a sort property can be provided to customize the definition of "last".

iframe

This section can be added as described above, and configured as described in Slate.

Bulk edit multiple objects

By default, this feature is disabled on a object-backed form. Enable it by toggling Allow this form to bulk edit (in Actions menu) in the Settings tab in the Visual Editor to the right of the form.

When enabled, follow the steps below to bulk edit multiple objects:

1. Navigate to Object Explorer and select the objects that you want to edit.
2. Select the Open in button and choose Edit [number-of-selected-objects] objects in [name-of-the-form].
3. The form opens in a dialog and allows you to override properties on all selected objects.