Hieronder vindt u de veelgestelde vragen over DSP 2.0.
Deze FAQ lijst wordt bijgewerkt a.h.v. vragen die deelnemers inbrengen.
Onderwerp | Vraag | Antwoord | ||||
|---|---|---|---|---|---|---|
Berichten sturen naar DSP | Hoe zal authenticatie plaatsvinden met DSP 2.0? | DSP 2.0 authenticeert met OAuth2. Mijn Aansluiting zal een client_id en client_secret verstrekken waarmee geautoriseerd kan worden. | ||||
Hoe ga ik DSP berichten versturen naar DSP 2.0? | Uw HTTP client verstuurt berichten volgens de specificiaties op de swagger pagina. | |||||
Berichten ontvangen van DSP | Hoe ga ik DSP berichten ontvangen met DSP 2.0? | Het DSP pusht berichten richting een door u (de deelnemer) in te richten server. | ||||
Hoe gaat DSP authenticeren bij mij als deelnemer? | Verkeer vanuit het DSP richting de deelnemer gaat ook met OAuth2. Daarom moet er ook een Token URL, een Client ID en een Client Secret worden aangeleverd waarmee het DSP zich bij de deelnemer kan authoriseren. | |||||
Wat verwacht DSP verder van mijn inrichting? | Draag zorg voor een correct ingerichte TLS verbinding welke de volledige certificate chain aanlevert. Doe bijvoorbeeld eerst een controle met ssllabs.com op de eigen omgeving om vast te stellen dat dit inderdaad het geval is. | |||||
Bericht definities | Waar vind ik de bericht definities? | De 6 netbeheerdersberichten en de 6 aannemersberichten staan op de swagger pagina. | ||||
Bevindingen | Waar kan ik bevindingen melden m.b.t. de applicatie en/of 2.0 specificatie? | Bevindingen graag melden via dit service desk ticket: https://mijnaansluiting.atlassian.net/servicedesk/customer/portal/1/group/24/create/228 . | ||||
Wat is de werkwijze voor het oppakken van bevindingen? | Voorlopig houden we 2 á 3 werkdagen aan tussen de melding en het doorvoeren van bevindingen zodat we de impact in het geheel zo laag mogelijk houden. Vanaf de start van de ketentesten (2 december a.s.) voeren we slechts 2-wekelijks changes door. | |||||
Bijlage proces | Hoe gaan we om met bijlagen in DSP 2.0? | Zie
| ||||
Waar vind ik het bijlageproces in swagger? | Rechts bovenin op de Swagger-pagina staat 'Select a definition', kies hier 'Attachments'. Of gebruik de directe link. | |||||
In welke berichten mag er een bijlagereferentie meegestuurd worden? | Dit kan in alle berichten, met uitzondering van: Planning, Annulering, AnnuleringGereed en OpdrachtGereed. | |||||
Wat is de maximale grootte van een bijlage? | Er geldt een maximum van 50MB (51200 KB) per geüploade bijlage. | |||||
Met welke extensies mogen bijlagen verstuurd worden? | Alle extensies behalve .rar en .zip zijn toegestaan | |||||
Hoe lang blijven geüploade bijlagen bewaard op jullie server? | Op moment dat een opdracht wordt afgerond worden de onderliggende bijlagen verwijderd. Een bijlage onder een cluster blijft aanwezig totdat het cluster is afgerond, d.w.z. dat er geen actieve opdrachten onder dat clusterId meer bestaan). | |||||
Wat is een cluster bijlage en wat kan ik hiermee? | Met de cluster-bijlage functionaliteit kun je een bijlage toevoegen bij meerdere opdrachten. De beperking is dat de opdrachten hetzelfde clusterId moeten hebben. Een toelichting over de werking is te vinden in
| |||||
Business Rules | Waar dien ik als netbeheerder mijn scenario’s te publiceren? | Dit dient te gebeuren in de productie omgeving van de nieuwe beheer app: https://beheer.dsplatform.nl/ | ||||
Wanneer dien ik als netbeheerder mijn scenario’s te publiceren? | Dit dient elke netbeheerder op uiterlijk 1 november 2024 te hebben gedaan. | |||||
Welke ingangsdatum dien ik te kiezen wanneer ik mijn 2.0 scenario’s wil publiceren? | Ingangsdatum voor 2.0: | |||||
Wat moet ik doen met de 1.36 scenario’s die er ook tussen staan op het BRM scherm? | De 2.0 concept publiceren moet, 1.36 niet nodig. Alleen als u tussentijds wijzigingen heeft kunt u 1.36 opnieuw publiceren. Let er dan wel op dat u de 2.0 scenario’s hiervoor aanpast! | |||||
Worden de 2.0 scenario’s automatisch bijgewerkt wanneer ik tussentijds mijn 1.36 scenario’s wijzig? | Neen, de 2.0 scenario’s zijn een kopie van uw 1.36 scenario’s op 3 sep 2024. Tussentijdse aanpassingen aan uw 1.36 scenario's worden dan ook niet automatisch doorgevoerd in uw te publiceren 2.0 scenario’s. | |||||
Connectiviteit met de acceptatie omgeving (QAS) | Hoe kan ik connectie maken met de QAS van DSP 2.0? | Aansluiten op de QAS kan door uw authenticatie gegevens en end-points op te voeren via de configuratie functionaliteit in de beheertool. | ||||
Conversie | Hoe vindt de conversie plaats van DSP v1.36.2 naar DSP v2.0? | Zoals u dat gewend bent: de aannemer verstuurt een bijstellingsverzoek met de reden 'conversie'. | ||||
Dient een netbeheerder bij het converteren van een opdracht naar 2.0 opnieuw voor alle bijlagen een referentie mee te sturen? Of kan de netbeheerder ervan uitgaan dat de aannemer deze al heeft ontvangen/bewaard met het 1.36 bericht? | Net als bij andere major releases stuurt een netbeheerder niet opnieuw de bijlagen bij een te converteren opdracht. Reden: minder belasting van de deelnemer systemen. Let op: Indien een geconverteerde opdracht vervolgens een reguliere Bijstelling krijgt dient de netbeheerder wel weer alle bijlagen(referenties) toe te voegen conform het nieuwe bijlageproces m.i.v. DSP 2.0. | |||||
Dien ik de huidige SOAP koppelingen te blijven ondersteunen na de livegang datum van DSP 2.0? | Ja, zolang er na de livegang van DSP 2.0 nog 1.36 opdrachten zijn dienen de DSP berichten daarover via de huidige SOAP koppelingen verstuurd en ontvangen te kunnen worden. Gedurende deze conversieperiode, die van 24 mei '24 tot 31 dec. '24 loopt, ondersteunt u dus zowel de SOAP als de REST koppelingen. | |||||
DSP analytics | Waar vind ik nu de functionaliteiten van DSP analytics? | De functionaliteiten zijn sinds 22 oktober 2024 verspreid over meerdere applicaties (zie meer details en links de handleiding):
| ||||
Ketentesten | Waar kan ik het ketentestschema vinden? | Het ketentestschema staat in de teamsmap van DSP deelnemersoverleg, in het kanaal DSP 2.0, onder het tabblad bestanden, in de map planning. | ||||
Wanneer dien ik klaar te zijn voor het ketentesten met andere deelnemers? | Vanaf 2 december 2024. | |||||
Wanneer dien ik als deelnemer mijn ketentesten in te plannen? | Tussen 15 november en 30 november 2024. | |||||
Waar en wanneer deel ik de contactgegevens van onze contactpersoon voor het ketentesten? | Op het tabblad 'contactgegevens' van het ketentestschema op uiterlijk 1 oktober 2024. | |||||
Wanneer dien ik als netbeheerder mijn beschikbaarheid in te vullen voor het ketentesten? | Uiterlijk 1 november 2024. | |||||
Wanneer dien ik als aannemer mijn beschikbaarheid en schetsapplicatie in te vullen voor het ketentesten? | Uiterlijk 15 november 2024. | |||||
Tot wanneer duurt het ketentesten? | Afhankelijk van de uitslag van de testen tot in ieder geval 3 februari 2025 en mogelijk t/m 31 maart 2025. | |||||
Mijlpalen voorafgaand livegang naar productie | Wanneer dien ik connectiviteit te maken met de QAS omgeving van DSP 2.0? | Tussen het moment van publicatie op 24 mei en 1 oktober 2024, dus uiterlijk op 30 september 2024. | ||||
Opdracht ID | Mag ik een opdracht ID hergebruiken? | DSP 2.0 werkt alleen nog maar met unieke opdracht ID’s, ook na opdrachtgereed en annulering. | ||||
Welke restricties gelden er t.a.v. het OpdrachtID in DSP 2.0? | De pre-fix (eerste 3 letters) gaat afgedwongen worden. Daarnaast moet het Id uit minimaal 5 tekens totaal bestaan, maximaal 255. De leestekens die geaccepteerd worden zijn: “-” en “_”. | |||||
Samenwerkingsverbanden | Wat verandert er in DSP 2.0 voor samenwerkingsverbanden? | Samenwerkingsverbanden worden gerouteerd door DSP maar niet meer op basis van postcode. | ||||
Worden voor het 'samenwerkingsverband' aparte end-points verwacht of worden de berichten op de aannemers/netbeheerders-endpoints afgeleverd? | Er worden geen aparte end-points verwacht, het samenwerkingsverband wordt geimplementeerd als een ‘alias’ voor een deelnemer, het DSP routeert naar de ‘default’ aannemer en de daarbij behorende end-points. | |||||
Kunnen berichten voor een samenwerkingsverband met de netbeheerders/aannemers-credentials afgeleverd worden bij DSP 2.0? | Ja, de deelnemer onder het samenwerkingsverband mag de berichten verzenden voor het samenwerkingsverband. | |||||
Dient een samenwerkingsverband ook te ketentesten met de betreffende netbeheerder(s)? | Ja. Alhoewel de aliassen van samenwerkingsverbanden niet expliciet staan opgenomen in het ketentestschema, is het wel de bedoeling om ook de opdrachten voor een samenwerkingsverband te ketentesten met de betreffende netbeheerder(s). | |||||
Technische documentatie | Waar vind ik alle technische informatie over aansluiten op DSP 2.0? | Op de wiki pagina onder 'DSP Technische documentatie', onder 'Aansluiten'. Of gebruik de directe link. | ||||
Waar vind ik de technische documentatie over DSP 2.0? | De technische documentatie staat op deze Swagger pagina: https://qas-services.dsplatform.nl/opdracht/documentation/#/opdracht/opdracht . | |||||
Testtool | Waar is de testtool voor 2.0 opdrachten beschikbaar? | |||||
Waarom zie ik niet de berichten van mijn ketenpartner in de testtool? | De 2.0 testtool is om te testen met je eigen systeem. Om te ketentesten kan het CAPO opdrachtenscherm (acc.) geraadpleegd worden. Berichten vanuit de testtool worden ook in het CAPO opdrachtenscherm (acc.) getoond. | |||||
Mag ik ook gebruik maken van de testtool als implementatiepartner van een deelnemer (aannemer/netbeheerder)? | Credentials worden voornamelijk verstrekt aan users van de deelnemers. Het is sinds kort mogelijk om als implementatiepartner voor de QAS omgeving eigen credentials te krijgen, als eigen deelnemer. Dan geef je aan of je een aannemer of netbeheerder wilt zijn, en dan kan je a.d.h.v. die credentials je eigen configuratie livezetten (beheer app) en berichten sturen naar die configuratie (testtool). Hiertoe kun je een ticket indienen bij onze servicedesk. | |||||
Time out | Welke time out duur hanteert DSP 2.0? | DSP 2.0 hanteert een kortere time-out op de verwachting van de respons op de requests. Het DSP verwacht een reactie binnen 5 seconden (let op: in DSP 1.36 was dit 5 minuten). | ||||
Versiebeheer | Hoe gaan we straks om met een opvolgende versie, na 2.0? | Bij livegang van 2.0 hebben we in de nieuwe REST API geen conflicterende versie. Op moment dat we een nieuwe versie introduceren zullen we definiëren hoe we dat gaan doen. | ||||
Vragen indienen over DSP 2.0 | Waar kan ik algemeen inhoudelijke vragen stellen over DSP 2.0 en de bijhorende technische documentatie? | Inhoudelijk/technische vragen graag stellen via dit service desk ticket: https://mijnaansluiting.atlassian.net/servicedesk/customer/portal/1/group/24/create/80 . | ||||
Waar kan ik algemene vragen stellen zoals over DSP 2.0 planning, het ketentesten, support etc.? | Algemene vragen mag u stellen via een mail aan <bianca.baasriedijk@mijnaansluiting.org>. |