generate

function

The main function of the plugin, called when the sketcher is used, once for each change. The function must return a Promise of the results. The results are broadcasted by the application.

Arguments:

• meetingData (Object) data structure containing structures and comments. See specification below.

• this includes domain and roomName for the current call

Return value: Promise

The fulfillment value of the promise must be a Buffer, Stream or String when returnType equals file.

name

string

Unique identifier of the plugin, used by Marvin Live for identification and internal communication. If multiple plugins use the same identifier, the last one to be loaded overrides the others.

label

string

Human readable name of the plugin, used by Marvin Live to display GUI elements related to this plugin.

domains

array of strings

List of domains where this plugin may be used, when authentication is enabled in Marvin Live. Use * to allow any domain. If no authentication is setup, this option has no effect. To query the configured domains, send a GET request to /domains or open /domains in your browser.

returnType

string

Configures the application to expect a file or a text message when the generate() promise is resolved. Files are downloaded to the client browser, text messages are displayed in a dialog.

Values: file or message

Required: no

Default: file

filename

string

Suggested file name when the download prompt appears in the browser. Only used when returnType is set to file . It’s possible to use variables that are replaced automatically when creating the file.

%roomName% - name of the discussion room
%domain% - name of the authentication domain
%downloadDate% - current date formatted as YYYY-mm-dd
%roomCreateDate% - room creation date formatted as YYYY-mm-dd
%lastActivityDate% - date of last activity in the room, formatted as YYYY-mm-dd
%serviceName% - name of this plugin

Default: mlreport-%roomName%.%serviceName%

templateFile

string

Relative path to an HTML template, when returnType equals message. The template is injected into the room’s interface as a dialog. The templating language is Angular JS, which should allow interpolating formatted numbers or easily enumerating a list. The result of the generate call is made available as the client variable inside the template fragment.