ibm notes domino & verse update - entwicklercamp · contacts service: manage personal contacts...

EntwicklerCamp 2017 IBM Notes – Gesichert bis 2024 - Auf in die Zukunft

IBM Verse - programmatische Integration von Verse Funktionen via Verse API

Track 3 Session 5

Stefan NethCollaboration [email protected]

IBM Verse: Grundlagen verstehenAnwendungen einbindenVorhandenes nutzen

© 2017 IBM Corporation

IBM Collaboration Solutions

Please note:

IBM’s statements regarding its plans, directions, and intent are subject to change or withdrawal without notice at IBM’s sole discretion.

Information regarding potential future products is intended to outline our general product direction and it should not be relied on in making a purchasing decision.

The information mentioned regarding potential future products is not a commitment, promise, or legal obligation to deliver any material, code or functionality. Information about potential future products may not be incorporated into any contract. The development, release, and timing of any future features or functionality described for our products remains at our sole discretion.

Performance is based on measurements and projections using standard IBM

benchmarks in a controlled environment. The actual throughput or performance that any

user will experience will vary depending upon many factors, including considerations

such as the amount of multiprogramming in the user's job stream, the I/O configuration,

the storage configuration, and the workload processed. Therefore, no assurance can be

given that an individual user will achieve results similar to those stated here.



Dieses Bild sollten Sie kennen…!

Private Cloud Hybrid Connections Cloud



IBM’s statements regarding its plans, directions and intent are subject to change or withdrawal without notice at IBM’s sole discretion.

E-Mail die Dich versteht Weniger Chaos, mehrKlarheit

Mich mit uns verbinden



Demo

6 3/28/2017



IBM Verse On-PremisesCloud & mobile first…aber nicht “cloud only”

Mehrwert und Investitionsschutz:

IBM Domino Kunden können IBM Verse

jetzt auch On-Premises betreiben.

Verse On-Premises bietet dieselbe User

Experience wie Verse On-cloud.

Verse On-Premises beinhaltet

Komponenten für die facettierte Suche

und den API-basierten Zugriff auf

Connections.

IBM Verse testen oder produktiv nutzen ohne die eigenen

Mailfiles in die IBM Cloud zu verschieben und ohne eine

Hybrid Infrastruktur aufbauen zu müssen.



Verse UI (Für Mail und Kalender,

läuft auf Domino unter

Windows oder Linux)

IBM Verse On-Premises High-Level Architektur

APIs for populating “Important to

Me” bar, social content, etc.

Domino 9.0.1 / FP7+(Domino Mail Infrastruktur)

Connections 5.5 / CRx(Files, Profiles, Preview, Business

Card, Team Analytics, etc.)

Search Index

(on Domino)

Neue KomponentenBestehende Komponenten

Entitlement für Connections 5.5 Files & Profiles enthalten

(auch unabhängig von Verse nutzbar)



Verse ohne IBM Connections macht wenig Sinn…



IBM Verse On-Premises – Plattformen und Lizenzen

Download der Software wie üblich über Passport Advantage

IBM Verse On-Premises 1.0 (Partnumber CJ13YML or CNGD8ML)

IBM Verse On-Premises 1.0.0.1 (Partnumber CNH56ML)

Voraussetzung: Aktive N/D Softwarewartung für…

CEO or IBM Domino Messaging / Enterprise CAL+PVU

IBM Domino Messaging / Collaboration Express

All Dual Entitlement (DE) Licences

Entitlement für IBM Connections Files & Profiles kann genutzt werden

Browser:• Google Chrome, aktuelles Release (keine Beta)• Mozilla Firefox ESR, aktuelles Release (keine Beta)• Apple Safari 8, 9• Microsoft Internet Explorer 11• Microsoft Edge

Domino Server 9.0.1 FP7+ auf:• Red Hat Enterprise Linux (RHEL) Server 6 oder 7 • Windows Server 2008 R2 Standard oder Enterprise• Windows Server 2012 / 2012 R2 Standard Edition• Windows Server 2012 / 2012 R2 Datacenter Edition



IBM Verse On-Premises – weitere Vorteile

Einfache, intuitive Benutzeroberfläche => geringere Kosten für Schulung der Anwender

Sichere Offlinenutzung im Browser ohne Zusatzsoftware

Optional: Desktop Clients wie Notes oder Outlook für Email nicht mehr erforderlich

Investitionsschutz für vorhandene Domino Infrastruktur

─ Zugriff auf Notes Anwendungen von Verse über ICAA oder IBM Notes Client

Verteilte Domino Server als effiziente Alternative zur Cloud in Umgebungen mit niedriger Bandbreite und

hohen Netzwerk-Latenzen

Verse On-Premises (VOP) erhält regelmäßig Feature Updates von Verse On-Cloud.

─ Neuer Verse Kalender

─ Actions in Compose message menu, extending business card, actions while reading mail

─ Zukünftige Optionen für Integration und Erweiterbarkeit

Leichter Umstieg für Endanwender in die IBM Connections Cloud



Notes für Windows Feature Pack Themen

Notes Feature Pack 8

Java 8 runtime upgrade

Show Internet addresses

instead of Notes

addresses in Mail /

Calendar / Contacts and

ToDo’s

Improvements in

rendering forwarded

MIME messages (read-

only)

Mail template update

Policy support for Group

By Date and beginning of

message

Notes Feature Pack 9

Upgrade OSGi / Eclipse /

SWT to support Java 8

compile time

Run rules on existing

emails

Support for persistent

VDIs for Roaming and

SAML configurations

Support for Last Name /

First Name mail

addressing in Notes Client

providing consisting

results

Support auto refresh for

delegated mail files

High Priority

Upgrade Embedded

Sametime

Support for STARTTLS

protocol in Notes client

Support for incremental

overlay in federated

calendars for ICS files

Delegate Calendar and

ToDo’s option without

delegating Contacts

Increase limit for junk mail

in Notes client

Archiving with editor

access for delegates

Support for folder design

upgrades for large

number of folders

Forward invitation as an

invitation

Q1 2017 2H 2017

All roadmap information subject to change



Domino / App Dev Feature Pack Themen

Domino Feature Pack 8

Java 1.8 runtime upgrade

ExtLib upgrade from OpenNTF

Store database view indexes

outside of NSF

Document en-/decryption for Web

Backend LotusScript / JavaScript /

Java access to ID vault

Increase document summary limit

from 64k to 16MB

Domino Designer source control

extension point for Swiper integration

Pubnames template update

Support ADFS 3.0

New @ModifiedInThisFile ,

@AddedToThisFile

Domino Feature Pack 9

Upgrade Domino Designer

to Eclipse 4.x

Upgrade to Java 1.8

(Designer compile time)

Upgrade OSGi on

Domino Server

NIF concurrency

enhancements & in-line

view update

Domino policy to restrict

mail from forwarding to an

internet forwarding address

Support RFC 2231 (the

current standard for

specifying non-ASCII

headers, now default for

many mail clients)

High Priority

Performance and

Scalability

improvements for IBM

Verse On Premises

Q1 2017 2H 2017




Co

gn

itiv

e s

ho

wn

in

wh

ite

IBM Verse – zukünftige Themen


Midterm 2017

Verse • Suggested recipients

• Cognitive Organizer – eliminates clutter automatically,

intelligently brings inbox to manageable size

• Type-ahead improvements (directory searching)

• Extension point to add custom actions between send and delivery

• Extension point to add custom name picker for addressing mail

• Delegated calendar access

• Delegated mail access

• Multi-lingual search

• Mail quota indicator

• Verse intercept survey and NPS

• macOS Sierra and Safari 10 support

• Mail onboarding manager improvements (O365 and catch-up

replication)

• Promoted statement and messages, including

action support – system identifies key actions

from emails and helps users complete them;

partners can configure the system to identify

actions from 3rd party solutions.

• Improvements in extensibility through APIs

• Improvements in rich text editing

• Enabling infrastructure to support shared mailboxes

• Improvements to calendar such as overlaysand .ICS file support

• Single, consolidated Verse settings environment

• Antivirus / antispam improvements

Longterm 2017

Verse Mobile • iOS - Sync all mail and calendar navigation updates

• iOS - Improved app responsiveness

and background sync

• Certificate-based authentication

• Ability to support multiple accounts• Android - message threading

• Suggested recipients

• Cognitive Organizer• Calendar enhancements including Freetime Search,

Attachment, Alarms (iOS), Private (iOS)

• Remove from Inbox

• Action Center Integration



Was möchten Sie erreichen?

Modernere Benutzeroberflächen anbieten?

Akkzeptanz erhöhen?

Reichweite vergrößern / neue Benutzergruppen?

Ausgewählte Anwendungen oder Funktionen

auf Mobilgeräten nutzen?

Betriebs- und Supportkosten senken?

Einfacheres und schnelleres Deployment?

Integration mit oder in andere Anwendungen?

Desktopanwendungen durch

Browseranwendungen ersetzen?

…

“Establish purpose before action”



“Best-of-breed“

“All-in-one“

3rd partyLösungen

“Do nothing“



Aufteilung Frontend / Backend

Freie Wahl bei Entwicklungswerkzeugen, Deploymenttools, Frameworks, Runtimes

Zugriff auf Domino Anwendungen im Backend (Daten & Logik) über APIs

https://ibm.ent.box.com/v/Connect2017Presentations/file/143268853897

http://blog.texasswede.com/my-mwlug-presentation-2/

”Best-of-breed”

LotusScript agents

XPages agents (SSJS)

?ReadViewEntries

XPages Rest controls (ExtLib)

Custom servlets

Domino Access Services

SmartNSF

…



IBM Domino Data Service (DDS)

REST API zum Zugriff auf Domino Datenbanken Lesen und Schreiben (geschützt durch ACL)

Ansichten und Dokumente

JSON Format

Standard Protokolle (http/https)

Erlaubt den Zugriff auf Domino von native Mobile apps, FEB, u.v.m.

“Going from XPages mobile to native mobile applications” http://de.slideshare.net/MarkRoden/ibm-worklight-going-from-xpages-mobile-to-native-mobile-applications

“IBM Worklight for IBM Domino Developers” http://de.slideshare.net/MatNewman/ibm-connect-2014-ad-501-ibm-worklight-for-ibm-domino-developers



Die bestehenden REST Services werden überarbeitet und erweitert.

Für die Zukunft sind weitere REST Services geplant:

Directory service: Browse or search directory

Contacts service: Manage personal contacts in your mailfile

Mail Search service: Search your mailfile

Subscription service: Poll for changes or register for push (long poll) in an application

Management service: Register users and manage groups

REST Services in IBM Domino

Service Description Ships with

Domino

Available on

OpenNTF

Mail service Manage email content X

Calendar service Manage calendar content & send calendar

workflow

X X

Freebusy service View user availability, find available rooms X

Data service Manage views, document data, etc X X

https://speakerdeck.com/sbasegmez/ibm-connect-2017-your-data-in-the-major-leagues-a-practical-guide-to-rest-services

https://www.ibm.com/developerworks/community/files/app/folder/4169e144-eb58-4871-bbe8-b61ff286ff07



IBM beabsichtigt für alle REST Services YAML

Definitionen gemäß OpenAPI Specification zu

veröffentlichen.

Leichtere Integration mit 3rd party Tools

Definition des Freebusy Service bereits verfügbar

Definition der REST Services über OpenAPI Specification



SmartNSF

“Turn your Notes/Domino Application into a microservice and expose embedded

business logic via REST API within minutes.”

Einfache Konfiguration, integriert in Domino Designer

Entwickler definiert einen microservice für die Anwendung (domain-specific language)

Verfügbar auf OpenNTF (wird zukünftig in ExtLibX integriert, Kandidat für FP9)

Wie geht’s weiter?

Auto-generate Swagger definitionsfor your application’s APIs

Dialog based generation of REST APIsfor your applications

Vielen Dank an Christian Guedemann

https://www.openntf.org/main.nsf/project.xsp?r=project/SmartNSF

Extending IBM Verse

Agenda

• Introduction to Verse Extensibility

• Developing your First Verse Application

• Understanding Verse Extensibility

• Upcoming Verse Extension Points

• Finding More Information

• Questions

Introduction to Verse Extensibility

24 3/28/2017

Key concepts in Verse Extensibility

25 3/28/2017

ApplicationContributes new capabilities (extensions) to Verse.

Action

Allows user to invoke an

extension. Application can

contribute multiple actions.

ExtensionIntegrates Verse with a third party service or application.

Verse Extensibility Demo

Using the mail read extension point to allow users to share a mail into a work space

Using templated link extension point to allow users access more information about someone who is important to them

26 3/28/2017

Developing your First Verse Application

27 3/28/2017

Developing your First Verse Application

28 3/28/2017

• Introducing Verse Developer browser extension

• Installing the Verse Developer browser extension

• Getting started tutorial samples

Verse Developer Browser Extension

29 3/28/2017

• Tool to get developers started building Verse Applications

• Three steps to build a Verse Application

1. Download and unzip Verse Developer browser extensionAvailable here: https://github.com/ibmverse/verse-developer

2. Install in your browser (Chrome and Firefox supported)Using WebExtensions to support multiple browsers

3. Use Application Registry to deploy your application to an entire organization

Installing Verse Developer

• Download https://github.com/ibmverse/verse-developer/archive/master.zip

• Visit chrome://extensions in your browser

• Enable ‘Developer mode’

• Load unpacked extension…

30 3/28/2017

Adding a New Application

• Register the application using Verse Developer browser extension

• Add application definition to applications.json

• Provide implementation for your application

• HTML + JavaScript

• Will be loaded in browser window or an iframe

• Optionally send a message to Verse when it has loaded

• Can receive context information from Verse

31 3/28/2017

The Application Definition

32 3/28/2017

{

”app_id": "com.ibm.verse.sample.app.widget",

"name": "Mail Sample",

"title": "Mail Sample Title",

"description": "Mail Sample Description",

"extensions": [

{

"id": "com.ibm.verse.sample.ext.widget.mail.actions",

"name": "Mail Actions Sample",

"type": "com.ibm.verse.ext.widget",

"payload": {

"url": ”<location of implementation>",

"features": [ "core" ],

"actions": [

{

"id": "com.ibm.verse.ext.mail.compose.action",

"path": "mail.compose",

"text": "Mail Compose Action",

"title": "Mail Compose Action",

"location": "window",

"renderParams": { "width": "900", "height": "500" }

}

]

}

}

],

"services": [ "Verse" ]

}

Provide name and description for

your application

Each extension has a type which

indicates what it can do

https url’s can be opened in a

new browser window or tab

Path is used to specify were in

the Verse UI an action is

displayed

You can specify the initial size of

the window used to display your

extension

The Application Implementation

33 3/28/2017

<html>

<head>

<script>

window.addEventListener("message", function(event) {

if (event.origin != "<expected origin>") {

return;

}

if (eventData.verseApiType === "com.ibm.verse.ping.application.loaded") {

var loaded_message = {

verseApiType : "com.ibm.verse.application.loaded"

};

event.source.postMessage(loaded_message, event.origin);

}

}, false);

</script>

</head>

<body>

Hello World

</body>

</html>

Verse posts messages to your

application

You must check the origin of any

messages received

Each message has a type which

is used to determine its use and

the data it conveys

Getting Started Samples

• Live demo

34 3/28/2017

Demo

35 3/28/2017

Understanding Verse Extensibility

36 3/28/2017

Understanding Verse Extensibility

37 3/28/2017

• Verse Extension Points

• Sending and Receiving Data

• Security

• Deploying Your Applications

Verse Extension Points – Simple Link

Add a clickable URL into the Verse user interface

• Link will show for all business cards within Verse

• Images must be Base 64 encoded data URI’s

38 3/28/2017

{

"type": "com.ibm.appreg.ext.simpleLink",

"object": "com.ibm.appreg.object.person",

"payload": {

"text": "Click this sample link!",

"href": "https://sample.com/simple-link-target.html",

"icon": "data:image/png;base64,..."

}

}

Extensions can also be bound to

objects

Verse Extension Points – Templated Link

Link with support to receive data from Verse

Templating syntax

• Values with format ${property} are replace by the property from the context object

39 3/28/2017

{

"type": "com.ibm.appreg.ext.templatedLink",


"payload": {

"text": "Look up ${displayName} in the directory!",

"href": "https://sample.com/templated-link-target.html?user=${emails.work}",

"icon": "data:image/png;base64,...",

"locator": "profile"

}

}

Request

parameters are

one of the options

to receive data

from Verse

Verse Extension Points – Widget

Open a third party application from Verse

• Can associate multiple actions with a single widget

40 3/28/2017

{

"type": "com.ibm.verse.ext.widget",

"payload": {

"url": "https://sample.com/widget.html",

"features": ["core"],

"actions": [

{

"id": "com.ibm.verse.ext.mail.read.action",

"path": "mail.read",

"text": ”Mail Read Action",

"location": "window",

"renderParams": { "width": "800", "height": "800" }

}

]

}

}

Actions can share a

common

implementation

Sending and Receiving Data

41 3/28/2017

• We have seen that data can be passed to your application in two ways:

• Encode into the extension URL

• Using cross-document messaging

• Messages can be sent from extension to Verse

• Valid messages depend on the extension type

• Each extension point has an associated context

• Data is provided in JSON format

• Person associated with com.ibm.appreg.object.person

• Mail associated with mail.read and mail.compose

Security

42 3/28/2017

• Your responsibility to ensure your application is not vulnerable to a cross-site scripting attack

• Three things you MUST do:

When receiving message, always verify origin of the message

When sending message, always specify targetOrigin

Ensure data received is treated appropriately

Deploying Your Applications

43 3/28/2017

• Organization administrator can register an extension by uploading the applications.json

Upcoming Verse Extension Points

44 3/28/2017

Upcoming Verse Extension Points

Third Party Chat/Meeting Integration Live Text

45 3/28/2017

Custom Name Picker Hook Before Send

Third Party Chat/Meeting Integration

Integrate with Third party chat/meeting service

46 3/28/2017

"extensions": [

{

"title": "Chat",

"type": "com.ibm.appreg.ext.templatedLink",


...

},{

"ext_id": "com.ibm.verse.action.disableSametime",

"name": "Disable Sametime",

"type": "com.ibm.appreg.ext.disableSametime",

"title": "Disable Sametime"

} ,{

"ext_id": "com.ibm.verse.action.disableSTMeetings",

"name": "Disable Sametime Meetings",

"type": "com.ibm.appreg.ext.disableSTMeetings",

"title": "Disable Sametime Meetings"

}

]

You can add links to a new chat

or meeting service

You can disable the default

Sametime Chat services

And the default Sametime

Meetings service

Live Text

Recognize patterns in email content and run actions against those patterns

47 3/28/2017

{

"type": "com.ibm.verse.ext.liveText",

"payload": {

"text": "UPS",

"href":

"http://www.ups.com/etracking/tracking.cgi?tracknums_displayed=&TypeOfInquiryNumber=T&HTMLVersion=4.0&InquiryNumber1=${0}",

"recognizer": "1Z([A-Z0-9]{16})"

}

} Use regular expression to

identify pattern in email content

Custom Name Picker

Custom user interface to add email addresses when composing an email

48 3/28/2017

{

"type": "com.ibm.verse.ext.namePicker",

"ext_id": "com.ibm.verse.namepicker.sample.compose",

"name": "Custom name picker in mail compose",

"url": <Points to name picker implementation>",

"title": "Add Contact"

}

Name picker implementation can

call third party service to get

suggested email addresses

Custom Name Picker

Implementation receives com.ibm.verse.ext.action.namePicker

event which includes current mail as context data

49 3/28/2017

window.addEventListener('message', function(event) {

// check event origin

if (event.data.verseApiType ===

'com.ibm.verse.action.clicked') {

context = eventData.verseApiData.context;

namePickerEvent = event;

}

}, false);

Name picker event is dispatched

when user clicks To link

var add_contact_message = {

verseApiType: 'com.ibm.verse.add.contact',

userEmail: userEmail,

userName: userName

};

namePickerEvent.source.postMessage(add_contact_message,

namePickerEvent.origin);

You can also include a list of

emails addresses and names

Implementation can send com.ibm.verse.add.contact event with the email address to add

Hook Before Send

Confirm email content before mail is sent and optionally display message to the user

50 3/28/2017

{

"type": "com.ibm.verse.ext.beforeOnSend",

"ext_id": "com.ibm.verse.ext.sample.beforeOnSend",

"name": "Hook Before Send",

"url": "<Points to name picker implementation>",

"title": "Show TO and CC name list”

}

You cannot modify the

email before it is sent

Hook Before Send

Implementation receives com.ibm.verse.ext.action.beforeOnSend

event which includes current mail as context data

51 3/28/2017

window.addEventListener('message', function(event) {

// check event origin

if (event.data.verseApiType ===

'com.ibm.verse.action.clicked') {

context = eventData.verseApiData.context;

beforeOnSendEvent = event;

}

}, false);

Before on send event is

dispatched when user clicks the

Send button

var continue_send_message = {

verseApiType: 'com.ibm.verse.message.continue.send'

};

beforeOnSendEvent.source.postMessage(continue_send_message,

beforeOnSendEvent.origin);

Your extension can

programmatically allow the mail

to be sent or the user can click Send button, we don’t prevent

users sending emails

Implementation can send com.ibm.verse.message.continue.send event to notify Verse that it should continue sending the mail

Upcoming Verse Extension Points - Demoes

52 3/28/2017

Finding More Information

53 3/28/2017

Finding More Information

54 3/28/2017

• New IBM Verse Developer organization

https://github.com/ibmverse

• Providing Feedback

https://github.com/ibmverse/verse-developer/issues

https://github.com/ibmverse

https://github.com/ibmverse/verse-developer/issues

The Road Ahead

Future Vision for 2017

55 3/28/2017


Live Text Migration Widget

56 3/28/2017


Administration

57 3/28/2017

Anti-virus / Anti-spam Enhancements

• Report spam messages

• Administrative control to customize Antivirus/Anti-spam policies

• End-user notification for blocked messages

• Multi-layered approach to mitigate email spoofing (SPF, DKIM, DMARC)

• Whitelist/blacklist options

• Quarantine support

• Message tracking


Partner Integration

58 3/28/2017


Midterm 2017

Cognitiv

e s

how

n in w

hite

Verse • Suggested recipients

• Cognitive Organizer – eliminates clutter automatically,

intelligently brings inbox to manageable size

• Type-ahead improvements (directory searching)

• Extension point to add custom actions between send

and delivery

• Extension point to add custom name picker for

addressing mail

• Delegated calendar access

• Delegated mail access

• Multi-lingual search

• Mail quota indicator

• Verse intercept survey and NPS

• macOS Sierra and Safari 10 support

• Mail onboarding manager improvements (O365 and

catch-up replication)

• Promoted statement and messages, including action

support – system identifies key actions from emails

and helps users complete them; partners can configure

the system to identify actions from 3rd party solutions.

• Improvements in extensibility through APIs

• Improvements in rich text editing

• Enabling infrastructure to support shared mailboxes

• Improvements to calendar such as overlays and .ICS

file support

• Single, consolidated Verse settings environment

• Antivirus / antispam improvements

Future Themes

59

Longterm 2017

Verse Mobile • iOS - Sync all mail and calendar navigation updates

• iOS - Improved app responsiveness and background

sync

• Certificate-based authentication

• Ability to support multiple accounts

• Android - message threading

• Suggested recipients

• Cognitive Organizer

• Calendar enhancements including Freetime Search,

Attachment, Alarms (iOS), Private (iOS)

• Remove from Inbox

• Action Center Integration



Diskussion

ibm notes domino & verse update - entwicklercamp · contacts service: manage personal contacts...

Documents