Webkoppeling Versie 2
Versie: 2.7 Versiedatum: 01-03-2015
Webkoppeling versie 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.
2
Webkoppeling versie 2 _______________________________________________________________________________________
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
3
Webkoppeling versie 2 _______________________________________________________________________________________
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 4
Webkoppeling versie 2 _______________________________________________________________________________________ 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
5
Webkoppeling versie 2 _______________________________________________________________________________________
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.
6
Webkoppeling versie 2 _______________________________________________________________________________________
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/
/jobsite/” height=500 width=520> of als pop-up window /jobsite/” target=”_new”>Zoek aanvragen Voor werknemers: (als inline frame) <iframe src=”http://www.uitzendsoftware.com//perssite/” height=500 width=520> of als pop-up window /perssite/” target=”_new”>Zoek werknemers Direct inschrijven (niet gekoppeld aan aanvraag): (Als inline frame) <iframe src=”http://www.uitzendsoftware.com//jobsite/inschrijven.php” target=”_self” width=”500” height=”700”>
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. 7
Webkoppeling versie 2 _______________________________________________________________________________________ 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
8
Webkoppeling versie 2 _______________________________________________________________________________________
9
Webkoppeling versie 2 _______________________________________________________________________________________
De resultaat schermen
10
Webkoppeling versie 2 _______________________________________________________________________________________
11
Webkoppeling versie 2 _______________________________________________________________________________________
Het informatiescherm (alleen aanvraag site)
12
Webkoppeling versie 2 _______________________________________________________________________________________
De gegevens schermen
13
Webkoppeling versie 2 _______________________________________________________________________________________
14
Webkoppeling versie 2 _______________________________________________________________________________________
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 {
15
Webkoppeling versie 2 _______________________________________________________________________________________ font-family: font-size: font-weight: color: border-color: border-top-width: border-right-width: border-bottom-width: border-left-width: background-color: height: cursor:
Verdana, Arial, Helvetica, sans-serif; 10px; bold; #FFFFFF; #8A8476; 0px; 1px; 1px; 0px; #E52C35; 14px; 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; } 16
Webkoppeling versie 2 _______________________________________________________________________________________ .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; } 17
Webkoppeling versie 2 _______________________________________________________________________________________
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.
18
Webkoppeling versie 2 _______________________________________________________________________________________ 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 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”
Target window
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).
5
Wachttijd voor tonen “bedankt pagina” en aanroepen van url_back
Wachttijd na inschrijving
19
Webkoppeling versie 2 _______________________________________________________________________________________ URL (script) op een externe server welke moet worden aangeroepen na een synchronisatie van Ubplus met de webkoppeling.
Trigger URL
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
20
Webkoppeling versie 2 _______________________________________________________________________________________
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//jobsite/xml.php
De werknemers:
http://www.uitzendsoftware.com//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//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//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//jobsite/index.php?JOBINQUIRE_ID=00513
21
Webkoppeling versie 2 _______________________________________________________________________________________
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)
22
Webkoppeling versie 2 _______________________________________________________________________________________ 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-mmjjjj)
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//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.
23
Webkoppeling versie 2 _______________________________________________________________________________________
Reactieformulier kandidaten Parameter naam
Beschrijving
PERSONINQUIRE_ID
ID van de kandidaat of 0
cInschrijf
Aanvraagdatum
cBedrijf
Bedrijfsnaam
cContact
Contactpersoon
cTelefoon
Telefoonnummer
cEmail cPlaats
Email adres 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//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:
24
Webkoppeling versie 2 _______________________________________________________________________________________ /* 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 = ''; $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 */
is hierbij de door Uitzend Software Diensten aangemaakte specifieke klantdirectory; iedere klantkoppeling heeft een eigen directory.
25
Webkoppeling versie 2 _______________________________________________________________________________________ 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.
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¶2=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.
Added in PHP 5.5.0 with FALSE as the default value. PHP 5.6.0 changes the default value 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.
26