Follow

Nedap ONS live tile

Quick reference:
Settings -> App store
Quick reference:
Settings -> Integrations -> Nedap ONS connections

Table of Contents

 

Request certificate

In order to use the Nedap ONS tile, submit a support request with the following information:

  • Customer name
  • Customer code (from Nedap ONS, example MF**** or TE****)
  • Type (Production or Testing)
  • Nedap ONS web URL

Back to top

 

Overview 

It is now possible to add the Nedap ONS live tile to your Workspace.

Nedap_ONS_Week_View.gif

This live tile is divided into two categories: Clients & Planning.

mceclip0.png

Clients will give you an overview of the clients in your Nedap ONS company. Click on a client from the live tile and you’ll be taken to the Nedap ONS website. Use the search bar to search for more clients and choose ‘Load more’ to load more clients into the live tile overview.

My planning is a representation of appointments with clients. You can navigate through dates, using the arrows pointing left and right.

mceclip1.png

Click on an appointment from the live tile and you’ll be redirected to the Nedap ONS website.

Here's an example of the "my schedule live tile - week view":

mceclip0.png

Hover your mouse over an appointment to view more information. Some appointments are presented in a different color, depending on the state (type of event/urgency). 

Back to top

 

Configuration

When setting up the Nedap ONS connection, a client certificate configuration is used. To set up the connection, go to:
Settings > Nedap ONS connections > New.

mceclip0.png

Nedap ONS has two different environments.

Environment Use  URL
STAGING Test your connector on a customer’s test environment https://api-staging.ons.io
PRODUCTION Run your connector on a customer’s production environment https://api.ons.io


Important: Due to security reasons, you will have to fill in the information from top to bottom. You cannot upload the certificate first, before filling in the name and Api url first. If you do, the fields will be cleared after clicking on 'Add'. 
After you filled in the correct information, click on 'Add' and Choose 'Save'. Now you're ready to add the Nedap ONS live tile to you Workspace.  

Important note from NEDAP ONS:

Our certificates are standard valid for 1 year. Put a reminder in your calendar to request a new certificate 1 month before the expiration date of the certificate. It is your responsibility to make sure this happens on time. We do not send reminders.

Back to top

 

Deep links

In addition to the Nedap ONS MicroApp, you can also configure shortcuts with deep links to specific sections of Nedap ONS. These deep links can be configured as shortcuts in the Workspace and provide a seamless user experience via Single Sign-On (SSO).

Based on customer feedback we provide the below three examples, but there are also other Nedap ONS components which could be made accessible via deep links and work in the same way.

A deep link contains two sections:

  1. Customer environment URL
  2. Generic URL to Nedap ONS component

Both sections are customer domain specific. Please replace "klantomgeving" with your specific Nedap ONS customer domain.

 

Validated examples

Overdrachtsrapportages
https://klantomgeving.startmetons.nl/?jump=https://klantomgeving.ioservice.net/report/transferreport

 

Overdrachtsagenda
https://klantomgeving.startmetons.nl/?jump=https://klantomgeving.onsagenda.nl/transfer/

 

Kwaliteitsmonitor
https://klantomgeving.startmetons.nl/?jump=https://klantomgeving.ons-taken.nl/overview

 

Using SSO login

If you are using an external identity provider like Okta or HelloID, please use the format of the URL below:

https://klantomgeving.startmetons.nl/auth/oidc/9e4ad0d3-6941-56ad-85f5-81184c5894f3?jump=https://klantomgeving.ioservice.net/report/transferreport

The first section refers to the link behind the blue SSO button in the ONS login window shown below:

nedap_ons.jpg

https://klantomgeving.startmetons.nl/auth/oidc/a77852f1-065f-5466-8e2a-ad3361106c32

The second section contains the generic URL to the desired Nedap ONS component.

Back to top

 

Activate the app

Navigate to the App store by clicking on the waffle-icon to add the Nedap ONS tile to your Workspace.

mceclip0.png

You can configurate the app settings, manage who has access to the app and assign app owners as shown in the example below.

Note: you will not be able to add the app to your Workspace, without having configured the Nedap ONS connection first.

mceclip3.png

To add the app to your Workspace, in the upper left corner click on: mceclip6.png

Once added to your Workspace, right-click on the tile to configure (edit) the desired app settings. Use the arrows pointing up or downwards to change position of the tabs (clients and planning), which will determine what you see first from the live tile overview.

Tip: Add the Nedap ONS tile twice to your Workspace, one for clients and the other one for the planning overview. 

mceclip4.png

Back to top

 


New feature and missing data?

When you are in production, it can happen that the overview doesn't load or data is missing. It could be the case that these features are only accessible in the staging environment. 

This concerns the staging/production environment from Nedap ONS and not the Workspace. 

When new features become available, a certificate has to be requested for the staging environment first. A new feature needs to be approved first, before we can move it into production.
Would you like to help us to make this data available a.s.a.p. in production environment? Request a staging certificate and provide us with the relevant information. In collaboration with Nedap ONS, we will make sure these new features will integrate within our live tile. 

Back to top