Replacement variables in URL's

Bundeling ondersteunt het gebruik van vervangingsvariabelen in URL’s om gegevens van het Bundeling-platform te delen en te gebruiken in externe platforms. Vervangingsvariabelen kunnen worden gebruikt om een variabele in een URL te vervangen door gegevens van de ingelogde gebruiker. De gegevens die gedeeld kunnen worden, zijn gebaseerd op een whitelist en variabelen worden alleen vervangen binnen vertrouwde domeinen.

Hoe kan ik vertrouwde domeinen toevoegen voor vervangingsvariabelen?

Om de gegevensbeveiliging te waarborgen, worden variabelen alleen vervangen in URL’s die behoren tot vertrouwde domeinen. Je kunt vertrouwde domeinen toevoegen via het dashboard:

Ga in het dashboard naar Instellingen > Algemeen.
Ga naar het tabblad Algemeen.
Voeg het domein toe aan Vertrouwde domeinen voor vervangingsvariabelen (één per regel).
Klik op Opslaan om de wijzigingen te bewaren.

Hoe kan ik vervangingsvariabelen gebruiken?

Vervangingsvariabelen worden ondersteund in de volgende functionaliteiten:

Nieuwsartikelen: in de Inhoud en de Link voor meer informatie (URL).
Evenementen: in de Beschrijving.
AppCMS: in een Link, een In-app browser of een Pagina.

Een vervangingsvariabele kan worden toegevoegd aan een URL binnen een van de ondersteunde componenten. De URL kan worden ingevoerd in het veld Link of door een Link in de inhoud te plaatsen. Wanneer een gebruiker de URL in de (web)app bekijkt of aanklikt, wordt de variabele vervangen door gegevens uit zijn gebruikersprofiel of uit het profiel van het bedrijf of de afdeling waaraan de gebruiker is gekoppeld. Als het domein niet vertrouwd is of als de variabele onjuist is, wordt de waarde vervangen door INVALID.

Welke variabelen kan ik aan URL’s toevoegen?

De gegevens die gedeeld kunnen worden, zijn gebaseerd op een whitelist. De volgende variabelen voor gebruikersprofielvelden staan op de whitelist en kunnen worden gebruikt als vervangingsvariabelen:

user.username
user.firstname
user.surname
user.fullname
user.gender
user.function
user.birthday
user.telephone
user.mobilephone
user.facebook
user.twitter
user.linkedin
user.external_reference
user.email
user.uuid

Daarnaast kun je variabelen gebruiken voor profielvelden van het bedrijf of de afdeling waaraan de gebruiker is gekoppeld:

customer.uuid
customer.name

Voorbeeld van het gebruik van een vervangingsvariabele in een URL:

https://bundeling.com?user=

Voorbeeld van dezelfde URL met de variabele vervangen:

https://bundeling.com?user=johndoe