fh-wfm-appform

0.0.25-b1 • Public • Published

FeedHenry RainCatcher AppForms

A RainCatcher AppForm module for FeedHenry RainCatcher. This module provides :

  • A set of AngularJS directives
  • An AngularJS Service to interact with AppForms.
  • A backend Service to interact with AppForms

Client-side usage (via broswerify)

Setup

This module is packaged in a CommonJS format, exporting the name of the Angular namespace. The module can be included in an angular.js as follows:

angular.module('app', [
, require('fh-wfm-appform')
...
])

Integration

Angular Services

This module provides a injectable file service : appformClient

This client offers these functions :

  • init
  • list
  • getForm
  • getSubmissionLocal
  • getSubmission
  • getSubmissions
  • getFields
  • createSubmission
  • submitSubmission
  • uploadSubmission
  • composeSubmissionResult
  • syncStepResult
  • watchSubmissionModel

Example of getForm usage :

resolve: {
    form: function($stateParams, appformClient) {
      return appformClient.getForm($stateParams.formId);
    }
  }

For a more complete example around files operations, please check the demo portal app.

Directives
Name Attributes
appformSubmission submissionLocalId, submissionId, submission
appform form, formId
appformField field, model
appformFieldLocation field, model
appformFieldPhoto field, model
appformFieldNumber field, model
appformFieldDatetime field, model
appformFieldDate field, model
appformFieldTime field, model

Usage in an express backend

The server-side component of this RainCatcher module exports a function that takes express and mediator instances as parameters, as in:

var express = require('express')
  , mbaasApi = require('fh-mbaas-api')
  , app = express()
  , mbaasExpress = mbaasApi.mbaasExpress()
  , mediator = require('fh-wfm-mediator/lib/mediator')
  ;
 
// configure the express app
...
 
// setup the wfm user router
require('fh-wfm-appform/lib/server')(mbaasApi);
 

Forms events

This module will subscribe to the the submissionEventListener and react on these events :

  • submissionStarted
  • submissionComplete

Versions

Current Tags

Version History

Package Sidebar

Install

npm i fh-wfm-appform

Weekly Downloads

2

Version

0.0.25-b1

License

MIT

Last publish

Collaborators

  • emilioicai
  • grdryn