Custom hosted forms

A custom hosted form is a customized HTML page within Identify Runtime that is not included in the list of built-in hosted forms. It allows users to create, edit, and delete hosted forms, modifying their HTML, bindings, CSS, and JavaScript using the REST API or Identify Admin. Custom hosted forms are typically used for features that require creating views tailored to customer needs, such as scripting home realm discovery, scripting interceptors, and scripting generic providers.

custom-hosted-form-list.png

Creating, editing and deleting a custom hosted forms

Creating a new custom hosted form

To create a new custom hosted form, click the (+) icon.

custom-hosted-form-add.png

A dialog will appear, allowing you to enter the display name for the form and specify its HTML content.

custom-hosted-form-dialog.png

  • Display name: Enter the display name of the hosted form. This name will appear under the Runtime (custom) section in the hosted forms list.
  • Reference name: This value is automatically generated based on the display name. Features that refer to the custom hosted form use this reference name.
  • HTML content: Define your custom HTML content using DotLiquid syntax to render dynamic elements.

After entering the necessary details, click the SAVE button to create the new custom hosted form.

The newly created form will appear in the Runtime (custom) section on the hosted forms list.

custom-hosted-form-created.png

Editing a custom hosted form

To edit an existing custom hosted form, select it from the Runtime (custom) section, update the HTML content as needed, and click the SAVE button.

custom-hosted-form-edit.png

Deleting a custom hosted form

To delete a custom hosted form, select it and click the DELETE button.

custom-hosted-form-delete.png

Identify Admin will prompt you for confirmation before proceeding with the deletion.

custom-hosted-form-delete-confirmation.png

Custom layout

A new custom layout can also be created as shown below:

custom-layout.png

This layout can then be used in a custom hosted form.

use-custom-layout.png

Layout elements

Same as built-in hosted forms.

Common fields

Same as built-in hosted forms.

Text resource support

The text resources used for custom hosted forms must be added to GlobalTextResources.

Customize the text resources by following the instructions found here.

Syntax:

{{ Resources.GlobalTextResources.TestResource }}

Property access

You can directly access the model properties using Model.<PropertyName>, similar to Razor views.

For instance, with a returned model like:

var model = new { Key = "Safewhere" };

Access the property directly:

<!-- Access properties like this -->
<p>{{ Model.Key }}</p>