FormDev Service
Mimic a HybridForms server locally. An Express NodeJS server is used to enable the web client of HybridForms to work properly.
It is running on localhost:8182, be aware to not block this port with another service.
The service is automatically started together with the web client by running npm start in the root folder.
This process looks for FormDefinition folders in the formdefinition subfolder.
This path can be configured by applying additional flags.
-
--path [path to FormDefinitions] -
--include [FormDefinition to include into the service]
npm start -- --path ../../../Shared/FormDefinitions/ --include BaseForm
Stages
All stages specified in a stages.json are processed.
This means all conditions are working correctly and the currently active stage is set in the Form object.
Server workflows are not supported!
Proxy
The FormDev service allows the use of a reverse proxy to make requests against a real HybridForms Backend. It can be helpful to fetch online catalogs.
Usage
To use the reverse proxy the request url has to look like:
http://localhost:8182/proxy/<HybridForms host>/<request url>
Most of the time an authentication is required.
The credentials to achieve this have to be placed in a credentials.json in the root of the project.
It must contain a accountName and password field with a base64 encoded password.
The file is ignored by Git by default.
Never check in credentials and login information to a repository.