IBM Verse: Customize and Extend IBM Verse

From Wiki
Revision as of 16:28, 12 January 2018 by Ebasso (talk | contribs) (→‎Important)

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
  • Mail Compose View
  • Mail Read View

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

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

Add the hostname of your test server on hosts files , example: mail.company.com

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

Example of Json File:

[
 {
   "name": "Templated Link Sample",
   "title": "Templated Link Sample",
   "description": "This samples demonstrates using the templated link extension point",
   "extensions": [
     {
       "name": "Person Templated Link",
       "type": "com.ibm.appreg.ext.templatedLink",
       "object": "com.ibm.appreg.object.person",
       "payload": {
         "text": "Templated Link Action",
         "title": "Templated Link Action",
         "href": "https://mail.company.com/vopext/extensions/samples/templatedLink.html?searchFor=${profile.primaryEmail}"
       }
     }
   ],
   "services": [
     "Verse"
   ]
 }
]


2) Create the vopext directory

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

3) Copy the sample files

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 this the Extension Points are loaded and the template link is working. Thanks to much!!!

Ver também