IBM Verse: Customize and Extend IBM Verse: Difference between revisions

From Wiki
No edit summary
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 3: Line 3:
Currently on Verse 1.0.3, Verse has the following options:
Currently on Verse 1.0.3, Verse has the following options:


* Business Card
* '''Business Card'''
* Mail Compose View
:* Simple Link (object: com.ibm.appreg.ext.simpleLink)
* Mail Read View
:* 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 extensions at article [[IBM Verse: Extension Points - Examples]].
You can see screenshots of these examples at article [[IBM Verse: Extension Points - Examples]].


In [https://ibmverse.github.io/verse-developer/ 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.
In [https://ibmverse.github.io/verse-developer/ 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.
Line 17: Line 24:


= Procedure =
= 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.
A prerequisite is to have an IBM Domino server installed and IBM Verse configured.
Line 22: Line 31:
1) Copy the '''applications.json''' file to the '''notesdata''' directory
1) Copy the '''applications.json''' file to the '''notesdata''' directory


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


mkdir -p /domino/notesdata/domino/html/vopext
3) Copy or Move the vopext directory to


4) Copy the samples files, to vopext directory.
/domino/notesdata/domino/html/vopext


5) Set the variables in the notes.ini:
4) Set the variables in the notes.ini:


  VOP_EXTENSIBILITY_DATA_PROVIDER_NAME=localFileProvider
  VOP_EXTENSIBILITY_DATA_PROVIDER_NAME=localFileProvider
Line 37: Line 44:
5) Restart http the server
5) Restart http the server


= Important =
== Using httpDataProvider ==


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

Latest revision as of 17:36, 22 February 2018

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 extensions 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

/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

Using httpDataProvider

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