# Integration

## Form Builder URLs

### URL formats

The following URL patterns are followed:

* Summary page:

    `/fr/orbeon/builder/summary`
* New empty form definition:

    `/fr/orbeon/builder/new`
* Edit existing form definition:

    `/fr/orbeon/builder/edit/[FORM_ID]`

*NOTE: All paths above are relative to the deployment context, e.g the actual URLs start with* `http://localhost:8080/orbeon/fr/...`

### Specifying the initial language of the form

\[SINCE Orbeon Forms 4.10]

When navigating to `/fr/orbeon/builder/new`, Form Builder picks as default form language the language of the Form Builder user interface. For example, if the Form Builder language is English, by default the new form's language is set to English as well.

You can override this default by specifying the `fb-language` URL parameter (not to be confused with `fr-language`). For example this sets the language of the form to Italian:

```
/fr/orbeon/builder/new?fb-language=it
```

### Bypassing the New Form dialog

\[SINCE Orbeon Forms 4.10]

When navigating to `/fr/orbeon/builder/new`, Form Builder usually presents the user with the New Form dialog, which asks for at least an app and form name.

![New Form Dialog](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEkBiSDvlXs3VWiO0Zu%2F-LEkBmMpnaxnftLGDglW%2F-LEkByzD34XkgNzpeiFH%2Fnew-form-dialog.png?generation=1528743338867246\&alt=media)

It is possible to bypass that dialog by providing the following URL parameters:

* `fr-app`: requested app name
* `fr-form`: requested form name
* `fr-title`: requested form title
* `fr-description`: requested form description

The dialog is actually bypassed only if the values passed are valid, specifically:

* `fr-app`
  * must be non-blank and only contain ASCII letters, digits, "-" or "\_"
  * if Form Builder permission are enabled, the app name must be allowed by those permissions (see [Form Builder Permissions](https://doc.orbeon.com/~/revisions/-LFrzxlvP9UXA6_RDYI9/form-runner/access-control-and-permissions/editing-forms#form-builder-permissions))
* `fr-form`
  * must be non-blank and only contain ASCII letters, digits, "-" or "\_"

In case the app and/or form name are missing or invalid, Form Builder presents the user with the New Form dialog. For example, with the following path:

```
/fr/orbeon/builder/new?fr-app=acme&fr-form=o/rder&fr-title=This+is+a+wonderful+form!
```

![New Form Dialog with Error](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEkBiSDvlXs3VWiO0Zu%2F-LEkBmMpnaxnftLGDglW%2F-LEkByzJBvA8EbTeCPOR%2Fnew-form-dialog-error.png?generation=1528743349733755\&alt=media)

## See also

* [Form Runner Integration](https://doc.orbeon.com/~/revisions/-LFrzxlvP9UXA6_RDYI9/form-runner/overview/integration)
* [Form Builder Permissions](https://doc.orbeon.com/~/revisions/-LFrzxlvP9UXA6_RDYI9/form-runner/access-control-and-permissions/editing-forms)