Hoe stel je URL-parameters in voor de Plan-IT werkplaatsplanner in Datamotive?

Met URL-parameters kan de werkplaatsplanner voorgevuld worden gestart. Hierdoor hoeft een eindgebruiker minder stappen handmatig in te vullen, kan een afspraak sneller worden afgerond en kan een gebruiker gerichter vanuit campagnes of systemen instromen. URL-parameters worden vaak gebruikt voor:

• E-mailcampagnes
• Klantportalen
• Lease- of CRM-koppelingen
• Interne links vanuit websites

Voorwaarde: de beschikbaarheid van datum, tijd, werkzaamheden en vervangend vervoer blijft altijd afhankelijk van Plan-IT Online. Raadpleeg indien nodig de handleiding [Hoe installeer en configureer je de Datamotive Plan-IT Online app?] en de handleiding [Hoe stel je de instellingen van de werkplaatsplanner in binnen Datamotive?]

Voorbeeld van een URL met parameters

Een URL met meerdere parameters ziet er als volgt uit:

https://ignition-planner.uwwerkplaatsplanner.nl/validation?licensePlate=j543xx&mileage=41528&lease=1&fields[Email]=joost@datamotive.nl&terms=true&jobLabels[]=APK&remarks=Geen opmerkingen&waiting=false&firstDate=true&firstTime=true&fields[Name]=Joost Nieuwlaar&fields[ZipCode]=7771JA&fields[HouseNumber]=1&fields[Phone]=0612345678

In dit voorbeeld worden onder andere het kenteken, de kilometerstand, het leasetype, het e-mailadres en de contactgegevens van de eindgebruiker automatisch vooringevuld in de werkplaatsplanner.

Een URL met parameters samenstellen

Stap 1 – Bepaal de basis-URL
Gebruik als basis de URL van de werkplaatsplanner, bijvoorbeeld ignition-planner.uwwerkplaatsplanner.nl/validation.

Stap 2 – Voeg de eerste parameter toe
Voeg na een vraagteken (?) de eerste parameter toe in de vorm parameter=waarde, bijvoorbeeld licensePlate=j543xx.

Stap 3 – Voeg eventuele extra parameters toe
Voeg overige parameters toe, gescheiden door een &-teken, bijvoorbeeld &mileage=41528&lease=1. Raadpleeg het overzicht onderaan dit artikel voor alle beschikbare parameters.

Stap 4 – Codeer speciale tekens correct
Codeer spaties en andere speciale tekens correct, bijvoorbeeld een spatie als %20 of een plusteken (+), zodat de URL geldig blijft.

Stap 5 – Test de URL
Open de samengestelde URL in de browser en controleer of alle velden in de werkplaatsplanner correct worden vooringevuld.

Algemene werking

• Parameters worden automatisch toegepast bij het laden van de planner
• Niet-geldige of ontbrekende parameters worden genegeerd
• Wanneer meerdere parameters conflicteren, bepaalt de plannerlogica (en Plan-IT) het gedrag
• Parameters kunnen meerdere stappen tegelijk beïnvloeden

Belangrijke aandachtspunten

• jobLabels[] en extraJobIds[] mogen meerdere keren voorkomen
• Wanneer zowel firstDate=true als date zijn opgegeven, heeft de expliciete datum voorrang
• De beschikbaarheid van datum, tijd, werkzaamheden en vervangend vervoer blijft altijd afhankelijk van Plan-IT Online
• Lease-gerelateerde parameters worden beïnvloed door de leasekeuze in stap 1 van de planner en door een eventuele ROB-Net koppeling

Let op: raadpleeg voor de ROB-Net koppeling de handleiding [Hoe installeer en configureer je de Datamotive ROB-Net app?]

Best practices

• Gebruik jobLabels[] in plaats van ID's voor meer flexibiliteit
• Combineer firstDate=true en firstTime=true voor een snelle instroom
• Test URL's altijd met meerdere voertuigsituaties (lease / geen lease)
• Codeer speciale tekens correct, bijvoorbeeld %20 of + voor spaties

Overzicht URL-parameters