IBM Verse: Customize and Extend IBM Verse

From Wiki
Revision as of 17:06, 22 February 2018 by Ebasso (talk | contribs)

You can customize IBM Verse On-Premises using Extensions Points. Is is very well documented on Verse developer site.

Currently on Verse 1.0.3, Verse has the following options:

  • Business Card
  • Simple Link (object: com.ibm.appreg.ext.simpleLink)
  • Templated Link (object: com.ibm.appreg.ext.templatedLink)
  • Action for Business Card (object: com.ibm.appreg.object.person)
  • Mail Compose View
Action for Mail Compose (path: mail.compose)
  • Mail Read View
Action for Mail Read (path: mail.read)
  • Hook Before Send (object: com.ibm.verse.ext.beforeOnSend)
  • Live Text (object: com.ibm.verse.ext.liveText)
  • Custom Name Picker (object: com.ibm.verse.ext.namePicker)

You can see screenshots of these examples at article IBM Verse: Extension Points - Examples.

In Verse developer site, they use IBM Verse Developer Browser Extension, that is a browser add-on which is used in the development of applications for IBM Verse. It allows you to register your application in IBM Verse as you develop it. Applications registered with the extension are only available in the developers' local browser, and cannot be accessed from other devices.

Rather than using the browser add-on, I use another approach, that is to install a domino server in my workstation and do my customization directly.

Here's how to do it.

Procedure

First you need to clone/download my files from Git Hub https://github.com/ebasso/ibm-verse-extension-points-examples

A prerequisite is to have an IBM Domino server installed and IBM Verse configured.

1) Copy the applications.json file to the notesdata directory

2) Edit applications.json, and change urls to the hostname of your Domino server

3) Copy or Move the vopext directory to

mkdir -p /domino/notesdata/domino/html/vopext

4) Set the variables in the notes.ini:

VOP_EXTENSIBILITY_DATA_PROVIDER_NAME=localFileProvider
VOP_Extensibility_Applications_Json_FilePath=/domino/notesdata/applications.json

5) Restart http the server

Important

I try to use Extension using a remote http server, with the following

VOP_EXTENSIBILITY_APPLICATIONS_JSON_URL=https://mail.company.com/vopext/applications.json
VOP_EXTENSIBILITY_DATA_PROVIDER_NAME=httpDataProvider

My website https://mail.company.com/vopext/applications.json, that store Extension Points use a Self-Signed TLS Certificate.

The Domino server that do the request to this json file. I need to add self-signed key as trusted key to Domino/JVM.

After, the Extension Points are loaded and the template link is working.

Ver também