# Forms

Category: Web
|
Runtime: 2.1+
|
Available: Free

# Overview

Forms node will render HTML form based on JSONform UI schema. The node can be used for building quick forms within Kumologica without investing effort on building from scratch UI application.

# Setup

# Prerequisites

Not applicable

# Installation

To install the node from designer:

  1. Go to Add more nodes option on the palette section.
  2. Check for the Forms node and click install.
  3. Once installed, the designer is required to be restarted.

To install the node from CLI:

  1. Go to your project workspace where you can see your package.json file.
  2. Run the below give npm command.
    npm i @kumologica/kumologica-contrib-forms

# Technical Details

Properties

  • Submit Path (Optional)
    HTTP endpoint for form data to submit. This endpoint must have a POST method. You need provide the absolute path.
  • Authorization Required ? (Required)
    Enable if the submit endpoint is having any Authorization header expected.
  • Authorization (Optional)
    If Authorization required ? is enabled then provide the Authorization header value. Ensure to provide base64 encoded string if it is basic auth security along with key word Basic prefixed. Similarly for bearer token.
  • Form (Optional)
    Provide the JSONforms UI JSON having the schema and form section. Don't provide the onSubmit field in the JSON form as this is by default added to the form by the node.
  • Style (Optional)
    JSONforms is based on bootstrap css and JS. You can customize the bootstrap css style in this editor.

Note
You may use JSONForm playground for selecting the form template of your choice as well as for testing the form before implementing it on the Forms node.

Supported Operations

Not Applicable

Throws

Base64 node throws the following exception.

Not Applicable

Returns

Payload is overwritten by the response from this node. The node return an html string rendered from the JSONforms schema provided.