Hi ,
Welcome to the Support Portal. How can we help?
Follow

Nedap ONS live tile

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

Table of Contents

 

Request certificate

Do the following in order to use the Nedap ONS tile:

  • Submit a Request
  • Choose Change request
  • Select CR-04 - Nedap ONS Certificate request
  • Fill in the corresponding fields:
    • Customer name
    • Customer code (from Nedap ONS, example MF**** or TE****)
    • Type (Production or Testing)
    • Nedap ONS web URL
  • Click on Submit

Back to top

 

Overview 

In order for Nedap ONS to work, make sure the UPN in Workspace matches exactly with the corresponding email address in Nedap ONS. 

It is 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 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.

mceclip0.png
mceclip1.png

Here's an example of the "my schedule live tile - week view". 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). Click on an appointment from the live tile and you’ll be redirected to the Nedap ONS website.

mceclip0.png

Back to top

 

Configuration

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

 

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

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

Go to the App store (or click on "+ Add tiles"). Make sure Manage apps is selected. 

manage_apps.PNG

Click on Add new app to add the Nedap ONS tile to your Workspace.

nedap.PNG

nedap2.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.

When you're done configuring the app, click Save. The tile is then ready to be added to Workspace from the App store. Once added to your Workspace, right-click 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