Integrations - Thinking outside the box - Presentation Engage 2023 in Amsterdam

© Copyright & proprietary Silverside B.V.
Integrations - Thinking outside the box
25-04-2023 – - Amsterdam

Your dedicated guide
to happiness and success
in the digital world +250
CUSTOMERS
3
PRODUCTS
28
EMPLOYEES
25 years
COLLABORATION SPECIALIST
As a specialist in the best collaboration hardware &
software (including Microsoft 365, HCL Software and Zoho
ONE), we ensure that users can collaborate smarter and
better in a secure modern digital world.
We guide organizations to the right destination based on
our experience with more than 250 customers. In addition
to our professional knowledge, we believe in happiness at
work and pleasant cooperation. This enables us to achieve
measurable results that will positively surprise you.
Are you joining us?
2

3
We are going to migrate to Microsoft 365. All problems solved!
No way! Let me show the comparison Ok … Lets update my LinkedIn profile
Ok … But … Never mind … Sure … Let’s make the best out of it!

4
It’s only 0.1 point!
NO WAY! LET ME SHOW THE COMPARISON

5
You can run …
OK … LETS UPDATE MY LINKEDIN PROFILE

6
I will wait …
OK … BUT … NEVER MIND …

7
Fight, Flight, Freeze
OPTIONS A, B AND C

8
OPTION D
Embrace Change
Hi <Name of Manager>,
From last conversation I understand we
are switching to Microsoft for e-mail &
documents.
I am happy to support in this migration.
Because afterwards I have the option to:
• Let go off standard functionality.
• More focus on our core collaboration
& workflow applications.
• Integrate our flexible HCL platform
with our fixed ERP system.
• Add value together with the different
key stakeholders.
Looking forward to be part of the project
team for this next step!
Cheers,
Roland

Our strategy
in 2 minutes:
USER ADOPTION STRATEGIES
9

P A C E
10
PACE Implementation Methodology
USER ADOPTION STRATEGIES
Propose a journey of
transformation and why
business change is essential.
Advise on the best tools, and
acquire / deploy. Assemble an
adoption framework.
Create new ways of working by
putting the adoption framework
into practice.
Enhance the journey, and
evaluate changing business,
technology and conditions.
Activate technology
for 1st group
Pilot
Capitalise on
momentum
Production
Continuous enhance
the journey
Perfect Prima!
Measure
Culture
Hapiness
Schadow IT
Chances
Risks
Start Small – selected groups
Assess, learn, adjust, improve
Find ambassadors (champions)
Scale out, Push to all
Train & communicate
based on preferences
Measure real usage
Facilitate continuous learning
Develop & Improve
Plan
3 year
3 months
Business Consultant Implementation Consultant Trainer Change Guide
Prepare your change
journey
Proof of Concept

11
1. Mental Health Care - EPD agenda
- Migrated Mail/Calendar to Microsoft 365
- Patient Information System (EPD) had no agenda integration for M365 yet
2. Producer of plastic additives - exchange data with Dynamics CRM
- Moved from simple Notes-CRM to Dynamics CRM
- Integration with Notes based QC-reports, Lab-data, Sample-requests apps.
- Changed existing integration to Dynamics
3. Company acquisition moves Domino apps into Microsoft environment
- Moved Domino into Azure VM
- e-mail domain rename
- Major user / license cleanup needed, less Domino knowledge
I will showcase three cases

12
1. Mental Health Care - EPD agenda
- Migrated Mail/Calendar to Microsoft 365
- Patient Information System (EPD) had no agenda integration for M365 yet
Case 1:3
- Custom Domino app that provides iCal feed with EPD appointments.
- Added to Outlook agenda gives the 'EPD appointments' as agenda overlay.
- Placed on existing Traveler servers that where accesible from internet.
- Access own agenda via long-code that links anonymous iCal request to profile with user-data.
- Restricted access to 365 Exchange server
- Used same solution on other project to provide data from a cloud app.

13
2. Producer of plastic additives - data to/from cloud CRM
- Moved from simple self-build CRM to cloud based CRM
- Notes based QC-reports, Lab-data, Sample-requests linked to CRM
- Move info to/from cloud CRM
Cases 2:3 a
- Created Domino REST API service to let Cloud-CRM access Domino data
- Created pull/push service to sync Domino data with Cloud-CRM
- Created a signalling-app on Domino to notify Cloud-CRM of Notes/Domino events using REST
Added @MailSend() to existing forms/code to send signals to this 'signalling-app' . . .

14
Cases 2:3 b
@MailSend( "Signalling/Acme"; ""; "";
"TI2DYN.UNPLN - " + TiNummer + " - " + CompanyName;
"server:" + @Name([CN];@Subset(@DbName;1)) +@NewLine+
"database:" + @WebDbName +@NewLine+
"unid:" + @Text(@DocumentUniqueID) );
"");
Recipient: nsf - the event-handler app
Subject: Global event info / where to route event to
Body: event data to sent to cloud app
Added 'signalling' code to existing forms/code to signal events to CRM like:
2. Producer of plastic additives - data to/from cloud CRM
- Moved from simple self-build CRM to cloud based CRM
- Notes based QC-reports, Lab-data, Sample-requests linked to CRM
- Move info to/from cloud CRM

15
3. Company acquisition moves Domino apps into MS environment
- Moved Domino into Azure
- e-mail domain rename
- Major user / license cleanup needed, less Domino knowledge
Case 3:3
- Introduced "Domino tools for M365" product to sync M365 users to Domino (register/disable).
- Sync specific M365 groups to Domino groups.
- Sync data from Domino to Sharepoint lists
HCL Notes/Domino user-administration can now be done by 1st line helpdesk in M365.

16
Domino is a versatile Rapid Application Development platform
that is well capable of working in modern environments.
Keyword these days is REST api
Baseline

Make REST
No War!
17
Embrace, don't fight

18
Data exchange in the olden days
SQL / ODBC
TXT / CSV - files
RPC calls
Batch files / direct commands
http queries
Data exchange / integration

19
Data exchange in the olden days
Different vendors talking:
- SQL / ODBC
- TXT / CSV
- RPC calls
- Batch files / direct commands
Data exchange / integration
No, that is not possible in cloud.
Everything must be of vendor xyz.

20
Don’t ignore the clouds; talk to them!
They speak one language!
Data exchange in the clouds
REST

21
What's REST
- Simple https:// requests
- Generally available from all platforms with TCP/IP
- Supported by most server platforms/cloud
- Different kinds of implementations
- A bit similar to SQL, but without the driver hell
- Lots of public api's available (weather, geocoding, ...)
- It's "loosely defined" and mostly text-based (json)
- Simply build your own
REST - The basics

22
Expect differences in query-method, data and date/time format
- Selection usually done in url like: mail=jdoe@acme.com
- Date/time: Some use yyyymmddThhmmss, while others use mm-dd-yyyyThh:mm:ss, . . .
- Few datatypes: value, string, boolean, array
- Nested info supported; mostly json
- Larger sets can be returned in pages (data-set contains link to next page)
https://api.acme.com/userinfo?mail=jdoe@acme.com
gives:
{ "displayName": "John Doe", "givenName": "John", "surname": "Doe"}
REST - Loosely defined...

23
Expect different authentication methods
- Some public API's do not require authentication
- Basic Authentication Base64(username:password)
- Static-key authentication trough a registration process
- Grant-key / Refresh-keys
- Certificates
- Role based, different keys have different possibilities (like 'ECL')
Most authentication is done by some key in the HTTP Request Header
REST - Loosely defined...

24
The guts of a https:// request
A request to https://api.acme.org/GiveMeInfo consists of:
GET /GiveMeInfo HTTP/1.1
Host: api.acme.org:443
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; ...
Authorization: Basic 1x9Bo02rgvjs893verwfd...
...
{'json':'sample text'}
Empty line
Method Protocol
Resource
Request body (put, post, update)
Headers
REST - The basics
Authentication key

25
HCL LotusScript to query a MS Graph REST API
'// Query M365 user info
Set web = s.CreateHTTPRequest()
Call web.Setheaderfield("Authorization", "Bearer 832f29xkd89jg...")
Call web.Setheaderfield("X-ResponseFormat", "json")
sResult = webRequest.Get("https://graph.microsoft.com/v1.0/users/joe.doe@acme.org")
LotusScript - Consume a REST API
{ "displayName": "John Doe",
"givenName": "John",
"surname": "Doe",
"jobTitle": "Retail Manager",
"mail": "JohnDoe@acme.org",
"id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd" }
Request Headers
Resource
Authentication key
Reply (json)

26
LotusScript - Simple REST API service
Create a new database "RestApi.nsf". Add a new agent "dbInfo", Runtime: Trigger: "On Event > Agent List Selection", Target: "None"
Sub Initialize
Dim lstQuery As Variant
Dim db As NotesDatabase
Dim s As New NotesSession
'// Index url parametes
lstQuery = GetQueryParameters(s)
'// Return Response-Header
Print "Content-type: application/json"
Print ""
'// Return Response-Body
Set db = s.Getdatabase("", lstQuery("db"), false)
If (db Is Nothing) Then
Print |{"status":"error"}|
Else
Print |{"status":"ok","title":"| & db.title & |", "size":| & db.size & |}|
End If
End Sub
LotusScript - Create your own REST API
https://srv.acme.org/RestApi.nsf/dbInfo?OpenAgent&db=names.nsf
Result:
{
"status":"ok",
"title":"Acme's Directory",
"size":39583744
}

27
Microsoft 365 Graph REST API authentication
Example: Register a REST API client/user for Microsoft 365
1. A REST API client/user is called an "Application registration"
2. Navigate to https://portal.azure.com > Azure Active Directory > App registrations
3. Register new application > [YourAppName] > Single tenant
4. Save the Application (client) ID and Directory (tenant) ID
5. "Add a certificate or secret" > New Client Secret. Assign a descr. and period.
6. Save the Value key (only shown once)
7. In left pane click: API permissions > + Add Permission > Microsoft API's > Microsoft Graph
> Application permissions > add for example "User.Read.All" and/or other permissions.
8. Back in the "Configured permissions screen" click on "V Grant admin consent for ..."
9. Use the keys to get a Bearer token, that is to be used in the Authorisation Reqest header
Details and sample code will become available soon in my "Make REST no war" blog series.

28
Using REST API's we are able to
- Manage Notes/Domino users based on M365 groups
- Sync nsf-data to/from Teams/Sharepoint
- Exchange data/events between Domino apps and cloud apps
- Control/Query Cloud apps, microcontrollers, a/v systems, etc.
- The Cloud is not the limit . . .
Silverside Experience

The Engine
84% Happy
29
USER ADOPTION STRATEGIES FOR COLLABORATION PLATFORMS
The Journey

30
Planning
SOFTWARE IMPLEMENTATIONS

31
Planning - Realitity
SOFTWARE IMPLEMENTATIONS

Implement new technology!
How do we communicate it?
How do we learn? Where do we start?
according to our governance
What is our culture?
with a return on investment
How do we adopt change?

33
Technology
Communication
Learning Scope
Strategy
Culture
Results
Scenarios
Holistic
approach

Thank You!
45
WRAP-UP: ANY QUESTIONS?
Duco Bergsma Roland Driesen
Senior Consultant Managing Partner
d.bergsma@silverside.com r.driesen@silverside.com
+31 – 6 – 51242304
Silverside B.V.
Rivium Quadrant 75-5 Capelle aan den Ijssel The Netherlands
www.silverside.com

Integrations - Thinking outside the box - Presentation Engage 2023 in Amsterdam

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Integrations - Thinking outside the box - Presentation Engage 2023 in Amsterdam

Similar to Integrations - Thinking outside the box - Presentation Engage 2023 in Amsterdam (20)

More from Roland Driesen

More from Roland Driesen (20)

Recently uploaded

Recently uploaded (20)

Integrations - Thinking outside the box - Presentation Engage 2023 in Amsterdam