Over de Nedap ONS live-tegel
We hebben een integratie met Nedap ONS. De Nedap ONS live-tegel is verdeeld in twee categorieën.
Klanten: Een overzicht van de klanten in uw Nedap ONS-bedrijf. Gebruik de zoekbalk om meer klanten te zoeken en kies 'Meer laden' om meer klanten in het live-tegeloverzicht te laden.
Mijn planning: Een weergave van afspraken met klanten. U kunt navigeren door datums met behulp van de pijlen naar links en rechts. U kunt met uw muis over een afspraak zweven om meer informatie te bekijken. Sommige afspraken worden in een andere kleur weergegeven, afhankelijk van de status (type evenement/dringendheid). Klik op een afspraak in de live-tegel en u wordt doorverwezen naar de Nedap ONS-website.
Configuratie
Stap 1. Vraag een certificaat aan
Om gebruik te maken van de Nedap ONS-integratie, moet u eerst een certificaat aanvragen. Nedap ONS-certificaten zijn geldig voor 1 jaar. Zet een herinnering in uw agenda om 1 maand voor de vervaldatum van het certificaat een nieuw certificaat aan te vragen. Het is uw verantwoordelijkheid om ervoor te zorgen dat dit op tijd gebeurt. Workspace stuurt geen herinneringen.
Om ervoor te zorgen dat Nedap ONS goed werkt, zorg ervoor dat de UPN (User Principal Name) in Workspace exact overeenkomt met het bijbehorende e-mailadres in Nedap ONS.
Om een certificaat aan te vragen, dient u een Change Request (CR-04 - Nedap ONS Certificate request) in en vult u de bijbehorende velden in voor:
Klantnaam
Klantcode (van Nedap ONS, bijvoorbeeld MF**** of TE****)
Type (Productie of Testen)
Nedap ONS web URL
Nedap ONS heeft twee verschillende omgevingen:
Omgeving | Gebruik | URL |
STAGING | Test uw connector in een klanttestomgeving | |
PRODUCTIE | Voer uw connector uit in een productieomgeving |
Nieuwe functie, maar ontbrekende gegevens?
Het kan voorkomen dat het overzicht niet laadt of dat gegevens ontbreken wanneer u in productie bent. Mogelijk zijn deze functies alleen toegankelijk in de staging-omgeving. Dit heeft betrekking op de staging-/productieomgeving van Nedap ONS en niet op Workspace.
Wanneer nieuwe functies beschikbaar komen, moet eerst een certificaat worden aangevraagd voor de staging-omgeving.
Nieuwe functies moeten worden goedgekeurd voordat we deze naar productie kunnen verplaatsen.
Wilt u ons helpen om deze gegevens zo snel mogelijk beschikbaar te maken in de productieomgeving? Vraag dan een staging-certificaat aan en geef ons de relevante informatie. In samenwerking met Nedap ONS zullen we bespreken of we deze functies kunnen integreren in de live-tegel.
Stap 2. Maak een Nedap ONS-verbinding
Bij het instellen van de Nedap ONS-verbinding wordt een clientcertificaatconfiguratie gebruikt.
Om de verbinding in te stellen, gaat u naar:
Workspace instellingenpagina.
Selecteer Integraties.
Selecteer Nedap ONS verbindingen.
Klik op Nieuw.
Vul de informatie van boven naar beneden in.
Let op: Het invullen van de informatie van boven naar beneden is vereist om veiligheidsredenen. U kunt het certificaat niet eerst uploaden, voordat u de naam en API URL heeft ingevuld. Als u dit doet, worden de velden leeggemaakt nadat u op 'Toevoegen' heeft geklikt.
Klik op Toevoegen wanneer de juiste informatie is ingevuld. Klik vervolgens op 'Opslaan'.
Als u een foutmelding krijgt over een ongeldige verbinding bij het toevoegen van de verbinding, heeft u mogelijk een onjuiste URL ingevoerd. Als u zelf host, ziet u de volgende fout in de logs:
Message:Test connection to Nedap ONS failed
NDAW.WebApp.Common.Workspace.LiveInformation.NedapOns.NedapOnsService+<CanConnectAsync>d__9.MoveNext(:0) (null)
NDAW.NedapOns.Exceptions.NedapOnsException: Request failed. Status code: Unauthorized
Stap 3. Voeg de Nedap ONS live-tegel toe aan Workspace
Nadat u de verbinding met Nedap ONS heeft ingesteld, bent u klaar om de Nedap ONS live-tegel toe te voegen aan uw Workspace.
Voeg de app toe vanuit de App Store (zorg ervoor dat 'Beheer apps' is geselecteerd).
Bewerk (rechtsklik) de tegel en gebruik de pijlen die omhoog of omlaag wijzen om de positie van de tabbladen ('klanten' vs. 'planning') te wijzigen om te bepalen wat u eerst ziet in het live-tegeloverzicht.
Tip: Voeg de Nedap ONS-tegel twee keer toe aan uw Workspace, eenmaal voor klanten en de andere voor het plannings overzicht.
Deep links
Naast de Nedap ONS Micro App kunt u ook snelkoppelingen configureren met deep links naar specifieke secties van Nedap ONS. Deze deep links kunnen worden geconfigureerd als snelkoppelingen in de Workspace en bieden een naadloze gebruikerservaring via Single Sign-On (SSO).
Op basis van klantenfeedback bieden we hieronder drie voorbeelden, maar er zijn ook andere Nedap ONS-componenten die toegankelijk kunnen worden gemaakt via deep links en op dezelfde manier werken.
Een deep link bevat twee secties en beide secties zijn specifiek voor het klantendomein:
Klantomgeving URL
Generieke URL naar Nedap ONS-component
Geverifieerde voorbeeld-URL's:
Vervang "klantomgeving" door uw specifieke Nedap ONS-klantendomein.
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
Gebruik van SSO-login
Als u een extern identiteitsprovider zoals Okta of HelloID gebruikt, gebruik dan het volgende URL-formaat. Vervang "klantomgeving" door uw specifieke Nedap ONS-klantendomein.
https://klantomgeving.startmetons.nl/auth/oidc/9e4ad0d3-6941-56ad-85f5-81184c5894f3?jump=https://klantomgeving.ioservice.net/report/transferreport
Het eerste gedeelte verwijst naar de link achter de blauwe SSO-knop in het ONS-aanmeldvenster zoals hieronder weergegeven:
https://klantomgeving.startmetons.nl/auth/oidc/a77852f1-065f-5466-8e2a-ad3361106c32
Het tweede gedeelte bevat de generieke URL naar het gewenste Nedap ONS-component.