26
Webkoppeling Versie 2 Versie: 2.7 Versiedatum: 01-03-2015

Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

  • Upload
    others

  • View
    1

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling Versie 2

Versie: 2.7

Versiedatum: 01-03-2015

Page 2: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

2

Inleiding

In UBplus kan een koppeling worden gemaakt tussen de aanvragen en beschikbare werknemers die zijn

ingevoerd en de eigen website van het uitzendbureau zodat (openstaande) aanvragen als vacatures en

beschikbare werknemers op die site kunnen worden getoond. Vanuit het Ubplus aanvragenscherm kunnen

aanvragen op de aanvraag site geplaatst worden, en worden reacties op deze aanvragen als nieuwe

werknemers geïmporteerd. Vanuit het Ubplus werknemerscherm kunnen werknemers op de werknemer

internetsite geplaatst worden. Aanvragen van bedrijven voor deze werknemers kunnen als nieuwe klanten

geïmporteerd worden, of de reactie op een werknemer kan bij een bestaande klant worden opgenomen.

Standaard zoekscherm Om de gegevens op uw website te tonen kunt u gebruik maken van het voorgedefinieerde scherm die

automatisch voor u wordt aangemaakt wanneer u zich aanmeldt voor de webkoppeling. De stijl van dit

scherm kunt u naar eigen wens indelen op basis van een stijl configuratie bestand (CSS StyleSheet).

XML data Het is ook mogelijk om de alle gegevens door uw webbouwer in uw website te laten verwerken. Dit geeft u

bijvoorbeeld de mogelijkheid om de recente tien aanvragen op uw site te publiceren. De gegevens die u

hiervoor nodig hebt, kunnen worden aangeleverd in een zogenaamde XML data bestand die een

webbouwer nodig heeft.

Page 3: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

3

Inhoudsopgave

Inleiding ...................................................................................................................................................................................... 2

Standaard zoekscherm .................................................................................................................................................................... 2

XML data ......................................................................................................................................................................................... 2

Stappenplan................................................................................................................................................................................ 4

Aanmelden bij Uitzend Software Diensten B.V. .............................................................................................................................. 4

Aanpassen parameters ................................................................................................................................................................... 4

Instellen internet teksten ................................................................................................................................................................ 4

Invoeren en versturen aanvragen naar server ................................................................................................................................ 4

Invoeren en versturen werknemers naar server ............................................................................................................................. 5

Verwerken nieuwe werknemers ...................................................................................................................................................... 6

Verwerken nieuwe aanvragen ........................................................................................................................................................ 6

Het gebruik van het standaard zoekscherm ................................................................................................................................ 7

Voorbeeld standaard zoekscherm ................................................................................................................................................... 7

Stylesheets ...................................................................................................................................................................................... 7

De zoekschermen ............................................................................................................................................................................ 8

De resultaat schermen .................................................................................................................................................................. 10

Het informatiescherm (alleen aanvraag site) ............................................................................................................................... 12

De gegevens schermen ................................................................................................................................................................. 13

Voorbeeld style-sheet ................................................................................................................................................................... 15

Extra configuratiemogelijkheden .................................................................................................................................................. 18

iframe parameters .................................................................................................................................................................... 20

XML data koppeling .................................................................................................................................................................. 21

Benodigde URLs ............................................................................................................................................................................ 21

Koppeling aanvragen XML en het iframe ...................................................................................................................................... 21

Reactieformulier aanvragen ......................................................................................................................................................... 22

Reactieformulier kandidaten ........................................................................................................................................................ 24

Overige informatie .................................................................................................................................................................... 24

Versturen POST data via cURL in PHP ........................................................................................................................................... 24

Functionaliteit cURL in verschillende PHP versies .................................................................................................................... 26

Informatie van een externe site .................................................................................................................................................... 26

Page 4: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

4

Stappenplan

Wat moet u doen om gebruik te kunnen maken van de Ubplus webkoppeling? De volgende stappen worden

voor u uitgelegd:

Aanmelden bij Uitzend Software Diensten B.V.

Aanpassen parameters

Instellen internet teksten

Invoeren en versturen naar server

Verwerken nieuwe reacties

Aanmelden bij Uitzend Software Diensten B.V. Uitzend Software Diensten heeft een internet server met zoek-, selecteer- en reageer scripts waarop

aanvragen kunnen worden geplaatst. Deze scripts zijn vanaf uw eigen internet site te koppelen, en te

beheren vanuit Ubplus. Nieuwe gebruikers van dit systeem moeten eerst op de server bekend worden

gemaakt. Hiervoor kunt u contact op nemen met Uitzend Software Diensten B.V.

Aanpassen parameters Voordat aanvragen naar deze server kunnen worden gestuurd moet dit eerst worden aangegeven in de

basisgegevens internet koppeling, tab “Aanvraag site”, veld “Gebruik aanvraag internet site versie 3.07”.

De Ftp parameters moeten worden opgegeven via menu “Bestand”, submenu “Systeem functies”, keuze

“Ftp parameters”. Item “Verstuur internet aanvragen”. Gebruik de gegevens die zijn verstrekt door Uitzend

Software bij het aanmelden.

Instellen internet teksten De teksten welke op internet gebruikt worden kunnen worden aangegeven in de administratie

basisgegevens, tab “Internet”, Subtab “Jobsite” en “Aanvraag internet site”. Hierin staan reeds standaard

teksten die kunnen worden aangepast, bijvoorbeeld in een andere taal.

Verder is het mogelijk om gebruik te maken van een z.g.n. “StyleSheet” hierdoor is het mogelijk om het

uiterlijk van deze aanvraag site gelijk te houden aan de huisstijl van uw eigen internet site. Het gebruik

hiervan wordt in dit document beschreven.

Bij het inschrijfscherm op Internet kan een nieuwe werknemer zijn beroep en opleiding invullen, dit keuze

menu is vanuit Ubplus in te stellen. Via menu “Bestand”, “Systeem functies”, “Beroepen” en “Bestand”,

“Systeem functies”, “Opleidingen”. Indien geen beroepen of opleidingen de status “Op Internet” zullen alle

beroepen c.q. opleidingen in het keuze menu op Internet worden opgenomen.

Invoeren en versturen aanvragen naar server Nieuwe aanvragen kunnen worden ingevoerd in het aanvragen scherm.

In de aanvraag basisgegevens kan worden aangegeven dat een aanvraag moet worden geplaatst op de

eigen website, tab “Internet”, veld “Vacature uit aanvraag plaatsen op eigen internetsite”. Daarna kunnen

Page 5: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

5

de overige gegevens uit de tab “Internet” worden ingevoerd. De aanvragen kunnen op de server worden

geplaatst (via Ftp).

Bij een aanvraag is het mogelijk de volgende gegevens op internet te plaatsen:

• Omschrijving

• Provincie

• Branche

• Vestiging

• Aanvraag datum

• Begin datum

• Eind datum

• Plaats/locatie

• Postcode

• Rijbewijs

• Uren per week

• Loon

• Per tijdvak (loon)

• Functie omschrijving

• Gevraag wordt

• Geboden wordt

Invoeren en versturen werknemers naar server Nieuwe aanvragen kunnen worden ingevoerd in het werknemers scherm.

In de werknemer basisgegevens kan worden aangegeven dat een werknemer moet worden geplaatst op de

eigen website, tab “Overig”, veld “Op internet plaatsen”. Een selectie van de werknemers waarvan deze

optie is aangekruist kan worden gemaakt door met de button de groep “Internet werknemers” te kiezen.

De werknemers kunnen op de server worden geplaatst (via Ftp)

Bij een werknemers is het mogelijk de volgende gegevens op internet te plaatsen:

• Voornaam

• Woonplaats

• Geboorte datum

• Geslacht

• Beroep 1 t/m 6

• Opleiding 1 t/m 6

Page 6: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

6

Verwerken nieuwe werknemers Bij het plaatsen van de aanvragen op de server worden ook de nieuwe inschrijvingen opgehaald. Deze

nieuwe inschrijvingen kunnen worden opgenomen als nieuwe werknemers in het werknemer bestand, of

worden verwijderd. Bij het toevoegen aan het werknemer bestand wordt:

• De data van de werknemer gevuld met de opgegeven naam, adresgegevens, opleidingen en

beroepen

• Het veld “Bekend door” van de werknemer basisgegevens de waarde “AS” worden opgeslagen =

Via aanvraag site

• Een eventuele CV in de werknemer documenten geplaatst.

• Een eerste werknemer contact aangemaakt.

De status van nieuwe werknemers kan automatisch worden ingesteld, dit kan worden opgegeven via menu

“Bestand”, “Diversen”, “Werknemer status”. Hierbij kan bij een status, een event worden gekoppeld.

Wanneer event “I, Inschrijving via Internet” is gekoppeld aan een status, zal de nieuwe werknemer

automatisch deze status verkrijgen, bij het verwerken van nieuwe reacties.

Verwerken nieuwe aanvragen Bij het plaatsen van de werknemers op de server worden ook de nieuwe reacties opgehaald. Deze nieuwe

reacties kunnen worden opgenomen als nieuwe klanten, geïmporteerd bij bestaande klanten of worden

verwijderd uit het bestand. De nieuwe klanten welke dienen te worden opgenomen, kunnen worden

geselecteerd door de betreffende klant aan te klikken. Wanneer hierna op de opslaan knop wordt gedrukt

kan worden gekozen voor een nieuwe klant of importeren bij een bestaande klant.

Bij het overzicht ‘bekend door’ via menu ‘overzicht’ submenu ‘klanten’ item ‘bekend door’ kan er

geselecteerd worden op ‘via werknemer site’ waarbij alle klanten waarbij bekend door op ‘WS’ staat worden

getoond. Bij het opnemen van een nieuwe klant wordt tevens een eventuele bedrijfsprofiel in ‘documenten

van de klant’ geplaatst. Overige gegevens komen bij klant kontakten.

De status van nieuwe klanten kan automatisch worden ingesteld, dit kan worden opgegeven via menu

“Bestand”, “Diversen”, “Klant status”. Hierbij kan bij een status, een event worden gekoppeld. Wanneer

event “I”, Inschrijving via Internet” is gekoppeld aan een status, zal de nieuwe klant automatisch deze

status verkrijgen, bij het verwerken van nieuwe reacties.

Page 7: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

7

Het gebruik van het standaard

zoekscherm

Voorbeeld standaard zoekscherm

Bij dit voorbeeld is gebruik gemaakt van iframes, het is ook mogelijk om de applicatie in een nieuw window

te openen. Om de applicatie in de huisstijl te kunnen weergeven, is er gebruik gemaakt van stylesheets.

Voor de koppeling vanaf een internet pagina kunnen de volgende regels worden opgenomen in een HTML

bestand op uw eigen website:

Voor aanvragen:

(als inline frame)

<iframe src=”http://www.uitzendsoftware.com/<account>/jobsite/” height=500

width=520> </iframe>

of als pop-up window

<a href=”http://www.uitzendsoftware.com/<account>/jobsite/” target=”_new”>Zoek

aanvragen</a>

Voor werknemers:

(als inline frame)

<iframe src=”http://www.uitzendsoftware.com/<account>/perssite/” height=500

width=520> </iframe>

of als pop-up window

<a href=”http://www.uitzendsoftware.com/<account>/perssite/” target=”_new”>Zoek

werknemers</a>

Direct inschrijven (niet gekoppeld aan aanvraag):

(Als inline frame)

<iframe src=”http://www.uitzendsoftware.com/<account>/jobsite/inschrijven.php”

target=”_self” width=”500” height=”700”></iframe>

<account> is hierbij de door Uitzend Software Diensten aangemaakte specifieke klantdirectory; iedere

klantkoppeling heeft een eigen directory.

Stylesheets Een (Cascading) Style Sheet is een tekst document dat door een internet applicatie kan worden gebruikt en

waarin de grafische opmaak van een internet pagina kan worden beschreven. Het doel van een stylesheet

is het centraal opslaan van deze gegevens, zodat onderhoud en overzicht vergemakkelijkt wordt. Bij de

werknemers en aanvragen applicatie worden deze style sheets ook gebruikt om per aansluiting een bedrijf

huisstijl te koppelen.

Page 8: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

8

In een stylesheet staan verschillende items waarbij instellingen als lettertype (puntgrootte, kleur, vet,

cursief, afstanden, uitlijning etc.), lijnen, invul en selectie vakken en algemene instellingen zoals

bijvoorbeeld de schuifbalken, kleuren, achtergronden en plaatjes.

In een webpagina kunnen namen worden gegeven aan verschillende elementen. Aan deze namen kan

vervolgens een stijl worden gekoppeld. In de hoofdstukken 2 t/m 5 worden de namen aangegeven in de

schermen, en in hoofdstuk 6 staat een voorbeeld waarbij stijlen zijn gedefinieerd bij deze namen. Achter de

naam staat de stijl tussen accolades {} per stijl kunnen verschillende instellingen staan, deze zijn

gescheiden door een puntkomma ;

Kleuren kunnen als naam of als hexadecimale rgb code worden opgegeven. Om deze makkelijk te kunnen

bepalen is het aan te raden om hiervoor een internet ontwerp programma te gebruiken, zoals: Macromedia

Dreamweaver of MS-Frontpage of een uitgebreid tekenprogramma zoals Adobe Photoshop of Jasc

Paintshop.

Via Ubplus is een default stylesheet beschikbaar, deze kan worden aangepast naar de huisstijl van uw

bedrijf.

De zoekschermen

Page 9: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

9

Page 10: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

10

De resultaat schermen

Page 11: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

11

Page 12: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

12

Het informatiescherm (alleen aanvraag site)

Page 13: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

13

De gegevens schermen

Page 14: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

14

Page 15: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

15

Voorbeeld style-sheet body {

font-family: Verdana, Arial, Helvetica, sans-serif;

font-size: 11px;

color: #666666;

font-style: normal;

scrollbar-face-color: #545454;

scrollbar-highlight-color: #5C8CCE;

scrollbar-shadow-color: #5C8CCE;

scrollbar-3dlight-color: #5C8CCE;

scrollbar-arrow-color: #FFFFFF;

scrollbar-track-color: #5C8CCE;

scrollbar-darkshadow-color: #000000;

}

.title{

font-family: Verdana, Arial, Helvetica, sans-serif;

font-size: 12px;

font-weight: bold;

color: #555555;

}

.subtitle{

font-family: Verdana, Arial, Helvetica, sans-serif;

font-size: 10px;

color: #666666;

line-height: 15px;

}

.border{

border-style: inset;

border-width: 3px;

}

.combo{

color: #000000;

font: normal 10px Verdana, Arial, Helvetica, sans-serif;

background-color: #F9F9F9;

border-top: 1px groove #383431;

border-right: 1px groove #A1938C;

border-bottom: 1px groove #A1938C;

border-left: 1px groove #383431;

}

.main{

background-color: #FFFFFF;

border-style: inset;

border-width: 0px;

padding: 3px;

spacing: 0px;

}

INPUT.button {

Page 16: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

16

font-family: Verdana, Arial, Helvetica, sans-serif;

font-size: 10px;

font-weight: bold;

color: #FFFFFF;

border-color: #8A8476;

border-top-width: 0px;

border-right-width: 1px;

border-bottom-width: 1px;

border-left-width: 0px;

background-color: #E52C35;

height: 14px;

cursor: hand;

}

INPUT.button2 {

width: 60px;

font-family: Verdana, Arial, Helvetica, sans-serif;

font-size: 10px;

font-weight: bold;

color: #666666;

border-color: #8A8476;

border-top-width: 0px;

border-right-width: 1px;

border-bottom-width: 1px;

border-left-width: 0px;

background-color: #DEDEDE;

height: 14px;

cursor: hand;

}

INPUT.button3 {

width: 60px;

font-family: Verdana, Arial, Helvetica, sans-serif;

font-size: 10px;

font-weight: bold;

color: #FFFFFF;

border-color: #8A8476;

border-top-width: 0px;

border-right-width: 1px;

border-bottom-width: 1px;

border-left-width: 0px;

background-color: #E52C35;

height: 14px;

cursor: hand;

}

.plattetekst{

font-family: Verdana, Arial, Helvetica, sans-serif;

font-size: 10px;

color: #666666;

line-height: 15px;

}

Page 17: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

17

.line{

background-color: #000000;

height: 1;

}

.kolom{

font-family: Verdana, Arial, Helvetica, sans-serif;

color: #666666;

background-color: #F5F5F5;

font-style: normal;

}

.links{

font-family: Verdana, Arial, Helvetica, sans-serif;

font-size: 10px;

color: #666666;

line-height: 15px;

font-weight: bold;

}

.kolom2{

font-family: Verdana, Arial, Helvetica, sans-serif;

color: #666666;

background-color: #FFFFFF;

font-style: normal;

}

.links2{

font-family: Verdana, Arial, Helvetica, sans-serif;

font-size: 10px;

color: #666666;

line-height: 15px;

font-weight: bold;

}

SELECT{

background-color: #FFFFFF;

font-family: verdana;

color: #000000;

font-weight: normal;

font-size: 10px;

}

textarea{

background-color: #F9F9F9;

scrollbar-face-color: #5C8CCE;

scrollbar-highlight-color: #5C8CCE;

scrollbar-shadow-color: #5C8CCE;

scrollbar-3dlight-color: #5C8CCE;

scrollbar-arrow-color: #FFFFFF;

scrollbar-track-color: #5C8CCE;

scrollbar-darkshadow-color: #000000;

}

Page 18: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

18

Extra configuratiemogelijkheden Het is mogelijk om het zoekscherm van de webkoppeling aan te passen en onderdelen hiervan te

(de)activeren. Er is hiervoor een mogelijkheid om het gedrag van de iframe met extra parameters in te

stellen. Dit kan met behulp van Ubplus via menu Bestand->Koppelingen->Internet.

Wanneer hier parameters worden ingesteld, dan wordt in de data directory van de server een conf.txt

bestand aangemaakt waarin o.a. kan worden aangegeven welk onderdeel wordt gedeactiveerd.

Page 19: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

19

De configuratie-opties worden in de onderstaande tabel uitgelegd.

Id Default waarde Uitleg

Toon provincies in de

aanvragen Aan Toont provincie kolom in

jobsite

Toon Branches in de

aanvragen Aan Toont branche kolom in

jobsite

Toon vestigingen in de

aanvragen Aan Toont vestiging kolom in

jobsite

Toon werknemer detail

informatie Uit Toont detail werknemer info

in perssite (vervoer/

beschikbaarheid)

Toon werknemer

leeftijd

Aan Toont leeftijd van kandidaat

in perssite

Toon werknemer

geslacht Aan Toont man/vrouw gegevens

in perssite

Target window Toont zoekresultaten in

ander window. Geef de naam

van het target window op of

een combinatie van een URL

en een target window

gescheiden door een ‘’pipe’

taken. Voorbeelden: “_new”

http://mijnsite.nl | _self

Target window breedte 0 Breedte van zoekresultaten

in het nieuwe window

Target window hoogte 0 Hoogte van zoekresultaten in

nieuwe window

Accepteer incomplete

invulformulier

0 Negeer incompleet ingevulde

formulieren (geen

waarschuwing).

Wachttijd na

inschrijving

5 Wachttijd voor tonen

“bedankt pagina” en

aanroepen van url_back

Page 20: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

20

Trigger URL URL (script) op een externe

server welke moet worden

aangeroepen na een

synchronisatie van Ubplus

met de webkoppeling.

Id Default waarde Uitleg

Toon keuzes voor

vervoermiddelen

0 Toon checkbox voor

vervoersmiddelen (auto,

fiets, etc)

Toon keuzes voor

rijbewijzen

0 Toon checkbox voor

rijbewijstypen

Toon maximale

reistijd

0 Toon invoerveld voor

maximale reistijd in minuten

Toon parttime week

uren

0 Toon invoerveld voor

min/max aantal uren per

week

Toon salariswens 0 Toon invoerveld voor

salarisindicatie

Toon functiewens 0 Toon invoerveld voor

gewenste functie

Toon beschikbaarheid

datum

0 Toon invoerveld voor datum

waarop de kandidaat

beschikbaar komt.

iframe parameters

Naast het stylesheet kan aan het iframe parameters worden meegegeven om het iframe optimaal te

verwerken in een bestaande website. In de onderstaande tabel zijn de parameters die kunnen worden

gebruikt, die als optie aan de URL moeten worden meegegeven. Dit is doorgaans een wijziging van de

bestaande website die door de web-bouwer moet worden doorgevoerd.

Search_result_target

popup_width

popup_height

Page 21: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

21

XML data koppeling

Zoals al eerder is uitgelegd is het standaard zoekscherm die wordt geboden via het iframe een eenvoudige

oplossing die ook eenvoudig te integreren is in een bestaande website. De oplossing is weliswaar volledig

maar als u de data op uw eigen manier wilt integreren met uw website, dan is het nodig om over de

volledige gegevens te kunnen beschikken. Als u de ontwikkeling aan een specialist heeft uitbesteed, dan

zal deze zeker vragen om informatie in XML data formaat.

Benodigde URLs

De XML data is ook beschikbaar nadat u heeft gesynchroniseerd met UBplus. De URL waarmee de XML

data kan worden gegenereerd is als volgt:

De aanvragen : http://www.uitzendsoftware.com/<account>/jobsite/xml.php

De werknemers: http://www.uitzendsoftware.com/<account>/perssite/xml.php

Aan de xml.php kan een argument worden meegegeven om een overzicht te krijgen van alle provincies,

branches, vestigingen en opleidingen. Dit gaat met de variabele SUBDATA:

http://www.uitzendsoftware.com/<account>/jobsite/xml.php?SUBDATA=1

Koppeling aanvragen XML en het iframe De XML van de aanvragen bevat twee ID’s die van belang zijn voor het terugkoppelen gegevens of

inschrijvingen met Ubplus. Deze ID’s zijn het JOBINQUIRE_ID en het JOBWEB_ID.

Wanneer het JOBWEB_ID wordt meegegeven aan het iframe, dan wordt detail informatie van de

betreffende aanvraag in het iframe geladen. Voorbeeld:

http://www.uitzendsoftware.com/<account>/jobsite/index.php?JOBWEB_ID=5

Wanneer het JOBINQUIRE_ID wordt meegegeven aan het iframe, dan wordt het reactieformulier van de

betreffende aanvraag in het iframe geladen. Voorbeeld:

http://www.uitzendsoftware.com/<account>/jobsite/index.php?JOBINQUIRE_ID=00513

Page 22: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

22

Reactieformulier aanvragen Wanneer u de XML data koppeling gebruikt, dan zult u zelf ook formulieren moeten maken waarmee op

een vacature gereageerd kan worden. In het formulier moeten specifieke velden worden gebruikt zodat de

gegevens weer geïmporteerd kunnen worden in Ubplus. De velden zijn:

Parameter naam Beschrijving

JOBINQUIRE_ID ID van de aanvraag of 0 (geen aanvraag)

nBeroep1, nBeroep2, nBeroep3 ID van beroep1 tm 3

nOpleiding1, nOpleiding2, nOpleiding3 ID van opleiding 1 tm3

cWerknId ID van werknemer (indien bestaand)

url_back URL van de retour-pagina

url_error URL van de pagina bij foutieve invoer

cVNaam Voornaam

cTussen Tussenvoegsel

cANaam Achternaam

cAdres Adres

cPostcode Postcode

cWoonplaats Woonplaats

cLand Land

cTelefoon Telefoonnummer

cTel06 Mobiele nummer

cEmail Email adres

cGebdat Geboorte datum (dd-mm-jjjj)

lGeslacht ‘Man’ of ‘Vrouw’

cBekendDoor Bekend door (omschrijving)

cOpm Opmerkingen

uploaded_file Naam van filename voor upload

cCustname Klantnaam (via Ubplus helpdesk)

Page 23: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

23

cKey Klantsleutel (via Ubplus helpdesk)

mail_from Email adres van verstuurder bevestiging

inschrijving.

mail_body Standaard tekst voor bevestiging inschrijving

saved_text Titel van de pagina na opslaan van aanmelding.

return_text Tekst getoond na het opslaan van de aanmelding

cBeschikbaar Datum waarop kandidaat beschikbaar is (dd-mm-

jjjj)

cBSN Burger Service Nummer

nWeekUrenMin Aantal uren per week minimaal inzetbaar

nWeekUrenMax Aantal uren per week maximaal inzetbaar

cSalarisWens Salariswens (vrije tekst)

cBankGiro Bankrekeningnummer

cFunctieWens Gewenste functie (vrije tekst)

nMaxReistijd Maximale reistijd in minuten

aVervoer Array van mogelijke vervoersmiddelen (‘Auto’,

‘Motor’, ‘Brommer’, ‘Fiets’, ‘OV’)

aRijbewijs Array van mogelijke rijbewijzen (‘A’, ‘A < 26’, ‘A >

25’, ‘B’,’EB’, ‘C’, ‘EC’, ‘D’, ‘ED’)

Het formulier moet worden ge-post naar de volgende URL:

http://www.uitzendsoftware.com/<account>/jobsite/index.php

Het is belangrijk dat het CV in de vorm van MIME data wordt aangeleverd als ware het een aanroep van

een HTML formulier met het attribute enctype="multipart/form-data". Hierdoor wordt het CV op

een juiste manier met de “post” meegegeven.

Wanneer er een fout ontstaat, wordt een foutmelding gegeven en zal de error url worden aangeroepen.

Hierbij worden dezelfde input parameters weer meegegeven aan de url_error zodat dit eventueel weer kan

worden opgenomen in het webformulier.

Wanneer de transactie geslaagd is, wordt de return url aangeroepen (url_back).

Wanneer mail_from en mail_body zijn ingevuld, dan wordt er automatisch een bevestigingmail gestuurd

naar de inschrijver.

Page 24: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

24

Reactieformulier kandidaten

Parameter naam Beschrijving

PERSONINQUIRE_ID ID van de kandidaat of 0

cInschrijf Aanvraagdatum

cBedrijf Bedrijfsnaam

cContact Contactpersoon

cTelefoon Telefoonnummer

cEmail Email adres

cPlaats Plaats vestiging

cFunctie Functieomschrijving

cInfo Bedrijfsinformatie

uploaded_file Naam van filename voor upload

Dit formulier moet worden gepost naar de volgende URL:

http://www.uitzendsoftware.com/<account>/perssite/index.php

Het is belangrijk dat het bestand in de vorm van MIME data wordt aangeleverd als ware het een aanroep

van een HTML formulier met het attribute enctype="multipart/form-data". Hierdoor wordt het

bestand (bedrijfsprofiel) op een juiste manier met de “post” meegegeven.

Overige informatie

Versturen POST data via cURL in PHP In de uitleg tot nu toe ging om een directe formpost naar onze webservices. Maar soms is het wenselijk dat

de data eerst naar de eigen webserver wordt verstuurd en pas daarna moet worden doorgestuurd naar de

UBplus webservices. Dit is mogelijk met cURL en PHP. Omdat de verschillende versies van de cURL

bibliotheken in PHP verschillend functioneren, is het belangrijk dat u goed de volgende documentatie

doorneemt: http://php.net/manual/en/book.curl.php . De syntax die u nodig hebt kan verschillen met de

code die in deze handleiding staat beschreven.

Onderstaande code is een concept en moet worden ingebouwd in het systeem dat u gebruikt. Ik ga uit van

een html formulier zoals te vinden op

http://www.uitzendsoftware.com/inter/jobsite/index.php?JOBINQUIRE_ID=0

Hier volgt een conceptueel stuk PHP code waarin alle relevante functies staan beschreven:

Page 25: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

25

/* php code start */

if (isset($_POST['JOBINQUIRE_ID'])){

$post_data = array();

if (is_uploaded_file($_FILES['uploaded_file']['tmp_name'])){

$file = $_FILES['uploaded_file']['tmp_name'];

$name = $_FILES['uploaded_file']['name'];

$type = $_FILES['uploaded_file']['type'];

$post_data['uploaded_file'] = '@'.$file.';filename='.$name.';type='.$type;

}

$post_data['JOBINQUIRE_ID']=$_POST['JOBINQUIRE_ID'];

$post_data['cVNaam']=$_POST['cVNaam'];

$post_data['cRNaam']=$_POST['cRNaam'];

$post_data['cTussen']=$_POST['cTussen'];

$post_data['cANaam']=$_POST['cANaam'];

$post_data['cAdres']=$_POST['cAdres'];

$post_data['cPostcode']=$_POST['cPostcode'];

$post_data['cWoonplaats']=$_POST['cWoonplaats'];

$post_data['cLand']=$_POST['cLand'];

$post_data['cTelefoon']=$_POST['cTelefoon'];

$post_data['cTel06']=$_POST['cTel06'];

$post_data['cBekendDoor']=$_POST['cBekendDoor'];

$post_data['cEmail']=$_POST['cEmail'];

$post_data['cGebdat']=$_POST['cGebdat'];

$post_data['lGeslacht']=$_POST['lGeslacht'];

$post_data['cBSN']=$_POST['cBSN'];

$post_data['cBankGiro']=$_POST['cBankGiro'];

$post_data['nBeroep1']=$_POST['nBeroep1'];

$post_data['nBeroep2']=$_POST['nBeroep2'];

$post_data['nBeroep3']=$_POST['nBeroep3'];

$post_data['nOpleiding1']=$_POST['nOpleiding1'];

$post_data['nOpleiding2']=$_POST['nOpleiding2'];

$post_data['nOpleiding3']=$_POST['nOpleiding3'];

$post_data['cOpm']=$_POST['cOpm'];

// klant code

$customer_id = '<account>';

$url = 'http://www.uitzendsoftware.com/'.$customer_id.'/jobsite/index.php';

$handle = curl_init($url);

curl_setopt($handle, CURLOPT_POST, true);

curl_setopt($handle, CURLOPT_POSTFIELDS, $post_data);

curl_setopt($handle, CURLOPT_RETURNTRANSFER, true);

curl_setopt($handle, CURLOPT_FOLLOWLOCATION, true);

$server_output = curl_exec($handle);

// if you want log $server_output per example

curl_close($handle);

}

/* php code end */

<account> is hierbij de door Uitzend Software Diensten aangemaakte specifieke klantdirectory; iedere

klantkoppeling heeft een eigen directory.

Page 26: Webkoppeling Versie 2...Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE. CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation

Webkoppeling versie 2

_______________________________________________________________________________________

26

Functionaliteit cURL in verschillende PHP versies

Eén van de grootste verschillen in hoe cURL werkt in verschillende versies van PHP is het versturen van

bestanden. Vanaf PHP versie 5.5.0 is een nieuwe PHP class beschikbaar gekomen om bestanden te

versturen met cURL, genaamd CURLFile (http://php.net/manual/en/class.curlfile.php) .

Hieronder volgen de belangrijkste configuratie instellingen te vinden op http://php.net/manual/en/book.curl.php die te maken hebben met het versturen van bestanden. De verschillen in code zijn hieruit op te maken.

CURLOPT_SAFE_UPLOAD TRUE to disable support for the @ prefix for uploading files in CURLOPT_POSTFIELDS, which means that values starting with @ can be safely passed as fields. CURLFile may be used for uploads instead.

Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value to TRUE.

CURLOPT_POSTFIELDS The full data to post in a HTTP "POST" operation. To post a file, prepend a filename with @ and use the full path. The filetype can be explicitly specified by following the filename with the type in the format ';type=mimetype'. This parameter can either be passed as a urlencoded string like 'para1=val1&para2=val2&...' or as an array with the field name as key and field data as value. If value is an array, the Content-Type header will be set to multipart/form-data. As of PHP 5.2.0, value must be an array if files are passed to this option with the @ prefix. As of PHP 5.5.0, the @ prefix is deprecated and files can be sent using CURLFile. The @ prefix can be disabled for safe passing of values beginning with @ by setting the CURLOPT_SAFE_UPLOAD option to TRUE.

Informatie van een externe site

Het is mogelijk om in de vacature of werknemer informatie te verwijzen naar informatie op een externe

site. Met behulp van UBplus kan in het info veld een link worden geplaatst. De syntax hiervan is als volgt

(voorbeeld externe video CV):

[link http://youtube.com,klik hier voor een video CV]

De tekst die na “[link “ komt, kan met behulp van de internetbrowser worden gekopieerd. De tekst na

de komma is een vrije tekst van de link zelf.