FeedHenry WFM Result

A result module for WFM, for working with the results of pushing a workorder through a workflow.

Client-side usage

Setup

This module can be initialised by

var resultModule = require('fh-wfm-result');

//Initialising the result module with a mediator. This will set up all of the subscribers for the result module.
resultModule(mediator);

//The result mediator topics are now subscribed.
mediator.subscribe("done:wfm:results:list", function(arrayOfResults) {
  ...
  console.log("All Results", arrayOfResults);
  ...
});

mediator.publish("wfm:results:list");

Integration

Topic Subscriptions

wfm:result:create

Description

Creating a new Result

Example

var parameters = {
  resultToCreate: {
    //A Valid JSON Object
  },
  //Optional topic unique identifier.
  topicUid: "uniquetopicid"
}

mediator.publish("wfm:result:create", parameters);

wfm:result:read

Description

Read a single Result

Example

var parameters = {
  id: "resultId",
  //Optional topic unique identifier.
  topicUid: "uniquetopicid"
}

mediator.publish("wfm:result:read", parameters);

wfm:result:update

Description

Update a single Result

Example

var parameters = {
  resultToUpdate: {
    ...
    id: "resultId"
    ...
  },
  //Optional topic unique identifier.
  topicUid: "uniquetopicid"
}

mediator.publish("wfm:result:update", parameters);

wfm:result:remove

Description

Remove a single Result

Example

var parameters = {
  id: "resultId",
  //Optional topic unique identifier.
  topicUid: "uniquetopicid"
}

mediator.publish("wfm:result:remove", parameters);

wfm:result:list

Description

List All Results

Example

var parameters = {
  //Optional topic unique identifier.
  topicUid: "uniquetopicid"
}

mediator.publish("wfm:result:list", parameters);

Published Topics

The following topics are published by this module. Developers are free to implement these topics subscribers, or use a module that already has these subscribers implement (E.g. the raincatcher-sync module).

| Topic | Description | | ------------- |:-------------:| | wfm:sync:results:create | Create a new item in the sync results collection | | wfm:sync:results:update | Update an existing item in the sync results collection | | wfm:sync:results:list | List all items in the sync results collection | | wfm:sync:results:remove | Remove an existing item from the sync results collection | | wfm:sync:results:read | Read a single item from the sync results collection | | wfm:sync:results:start | Start the sync process for sync results collection | | wfm:sync:results:stop | Stop the sync process for sync results collection | | wfm:sync:results:force_sync | Force a sync cycle from client to cloud for sync results collection |

Topic Subscriptions

| Topic | Description | | ------------- |:-------------:| | done:wfm:sync:results:create | A result was created in the results dataset | | error:wfm:sync:results:create | An error occurred when creating an item in the results dataset. | | done:wfm:sync:results:update | A result was updated in the results dataset | | error:wfm:sync:results:update | An error occurred when updating an item in the results dataset. | | done:wfm:sync:results:list | A list of the items in the results dataset completed | | error:wfm:sync:results:list | An error occurred when listing items in the results dataset. | | done:wfm:sync:results:remove | A result was removed from the results dataset | | error:wfm:sync:results:remove | An error occurred when removing an item in the results dataset. | | done:wfm:sync:results:read | A item was read correctly from the results dataset | | error:wfm:sync:results:read | An error occurred when reading an item in the results dataset. | | done:wfm:sync:results:start | The sync process started for the results dataset. | | error:wfm:sync:results:start | An error occurred when starting the results dataset. | | done:wfm:sync:results:stop | The sync process stopped for the results dataset. | | error:wfm:sync:results:stop | An error occurred when stopping the results dataset sync process. | | done:wfm:sync:results:force_sync | A force sync process completed for the results dataset. | | error:wfm:sync:results:force_sync | An error occurred when forcing the sync process for the results dataset. |

Usage in an express backend

Setup

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

var express = require('express')
  , app = express()
  , mbaasExpress = mbaasApi.mbaasExpress()
  , mediator = require('fh-wfm-mediator/lib/mediator')
  ;

// configure the express app
...

// setup the wfm result sync server
require('fh-wfm-result/lib/server')(mediator, app, mbaasApi);

Integration

Check this demo cloud application