Tangram software voor werving en selectie, executive search, interim management, detachering, management development en interne mobiliteit
Service & support site voor klanten

URL-encoding en -opbouw van vacaturepagina bij gebruik van XML/JSON interface (art. 2605)

Veelgestelde vragen > Tangram Internet Services (TIS)

Dit artikel is van toepassing wanneer u voor de vacaturepresentatie gebruik maakt van de Tangram XML/JSON interface. Om op correcte wijze een directe link te maken naar een vacaturedetailpagina, moet de URL juist geparameteriseerd en geëncodeerd zijn. U begint met de basis van de binary link van de Tangram XML/JSON interface:

http://webservices.tangram.nl/Aint/bin.dl

Aan deze basis URL worden query parameters toegevoegd:

  • pin=[PINCODE]: pincode die de klant op tangram-tis identificeert
  • bpid=[BAANPLEINID]: unieke Tangram sleutel van de vacature (Administratie-baanpleinid)
  • selection= Vacatures
  • field=[FIELDNAME] : de naam van het veld (dit is een samenstelling vanuit de XML).
Voorbeeld:
als het XML Path is /bpxml/Vacature/Document[@soort="functieomschrijving"]/Inhoud
dan moet als FIELDNAME worden opgegeven: Document_ functieomschrijving_Inhoud
  • filename=[FIELDFILENAME] : de naam van het veld waar de bestandsnaam in staat.
Voorbeeld:
Als het XML Path is : /bpxml/Vacature/Document[@soort="functieomschrijving"]/Naam
dan moet als FIELDNAME worden opgegeven: Document_ functieomschrijving_Naam

Alle parameters moeten url encoded zijn.

Als voorbeeld zou dan de volgende encoded link kunnen ontstaan (vanwege de lengte van de URL wordt deze op twee regels weergegeven):
http://webservices.tangram.nl/Aint/bin.dl?pin=10017&bpid=20017%2D%23000000207&selection=Kandidaten
&field=Document%5Fcvanoniem%5FInhoud&filename=Document%5Fcvanoniem%5FNaam