Gegevenskoppeling BoekenRoute 1. Inleiding Dit document beschrijft de koppeling van de gegevens op BoekenRoute met de website van een uitgever. Veel uitgevers die deelnemen aan BoekenRoute, hebben uiteraard ook zelf een website. Steeds meer uitgevers echter koppelen hun website aan de gegevens van BoekenRoute: zo hoeven ze de gegevens van een (nieuw) boek maar één keer in te voeren op BoekenRoute, en daarmee is de eigen website automatisch volledig bijgewerkt. Dit is vooral handig indien u zelf geen compleet z.g. content management systeem hebt om eenvoudig wijzigingen aan uw eigen website aan te brengen. Hierna leest u over de verschillende mogelijkheden. 2. Vormen van koppeling U kunt als uitgever op verschillende niveaus gebruik maken van BoekenRoute: Alleen de afhandeling van de verkopen: u wilt zelf geen betaalmodule gebruiken, en de financiële afhandeling overlaten aan BoekenRoute. De beschrijving van een uitgave van een fonds staat summier op uw website, voor de volledige beschrijving met figuren verwijst u naar de presentatie van uw boek op BoekenRoute. De gegevens van uw complete fondslijst haalt u uit de database van BoekenRoute. Zodra u een nieuw boek op BoekenRoute invult, staat het ook automatisch op het fondsoverzicht op uw website. 3. Technische uitwerking De tekst hieronder veronderstelt kennis van de bouw van websites, waarschijnlijk wilt u dit bespreken met uw webbouwer. De essentie is dat u zelf uw website ontwerpt of aanpast, in uw huisstijl en naar uw eisen. De gegevens voor wat betreft uw uitgaven haalt u echter geheel of gedeeltelijk uit de database van BoekenRoute. Indien u alleen een hyperlink aanbrengt, bijvoorbeeld naar de winkelwagen op BoekenRoute, heeft u alleen het BoekID nodig. U ziet dit als u met de muis over het desbetreffende boek gaat, of de presentatie van een boek bekijkt: in de url van dat boek staat aan het einde: aspx?boekid=12345. Op verzoek mailen wij u graag uw complete fondslijst, met de BoekID s. Voor de complete fondslijsten heeft u uw uitgeverid nodig, dit vindt u door op BoekenRoute in het overzicht met de uitgevers met de muis over uw naam te gaan, of uw uitgeverij aan te klikken. In de url staat aan het einde: UitgID=12345. Hierna werken wij de verschillende mogelijkheden uit, als bijlage treft u de codevoorbeelden aan die u in uw website kunt (laten) opnemen. Op de voorbeeldpagina op BoekenRoute (http://www.boekenroute.nl/uitgevers/voorbeelden.aspx ) ziet u hoe deze mogelijkheden er in het echt uitzien.
4. Linken naar de winkelwagen. Op uw website staan uw boeken uitgebreid beschreven. Alleen de verkoop zelf wilt u aan BoekenRoute overlaten. Het handigste is dan om een plaatje van een winkelwagen op te nemen, met een url die verwijst naar: https://www.boekenroute.nl/secure/kopen.aspx?boekid=12345 (let op de S in https!) Zorg er voor dat de gebruiker geen nieuw scherm krijgt te zien, in deze fase van de verkoop geen afleiding! 5. Linken naar de complete presentatie U heeft bijvoorbeeld zelf een summiere opsomming, en verwijst voor de uitgebreide presentatie naar BoekenRoute. Gebruik de titel en/of een afbeelding van het voorplat, met een url die verwijst naar: http://www.boekenroute.nl/gasten/gtn1boek.aspx?boekid=12345 Hier kunt u de bezoeker eventueel wel een nieuw scherm tonen ( target = _blank, of een java script). 6. Complete fondslijst gebruiken U kunt uw complete fondslijst (op titelvolgorde, of naar onderwerp, of per auteur) opvragen uit de database van BoekenRoute, en die naar eigen voorkeur opnemen in uw website. De gegevens uiteraard compleet bijgewerkt krijgt u als XML bestand, die uw website omzet in een HTML pagina. De gegevens zijn beschikbaar als webservice, via het adres: http://www.boekenroute.nl/ws/fondslijsten.asmx Als parameter geeft u uw Uitgever ID mee. U krijgt uw lijst terug met de basis gegevens van de boeken, voor zover u ze in het tabblad handelsinformatie zichtbaar hebt gehouden. Ook de beschikbaarheid, (tijdelijke) actie prijs etc zijn bijgewerkt. In de gegevens zit ook de link naar de duimnagel van het voorplat. 7. Vragen, wensen Met name de webservices kunnen relatief eenvoudig aangepast worden, dus als u specifieke wensen heeft, laat u dat dan weten. Voor opmerkingen en vragen: Reinier Rijke 030 214 55 30 e-mail: reinier@boekenroute.nl Versie: 6 mei 2009
Bijlage: Codevoorbeelden Hieronder geven wij u de HTML codes, die u kunt gebruiken in uw website. Dezelfde codes zijn gebruikt op de demonstratie pagina: http://www.boekenroute.nl/uitgevers/voorbeelden.htm 1. Links naar de winkelwagen van BoekenRoute: <p><strong>alleen tekst:</strong><br /> <a href="https://www.boekenroute.nl/secure/kopen.aspx?boekid=3523">bestellen</a></p> <p><strong>met plaatjes van winkelwagens:</strong><br /> Bestellen: <a href="https://www.boekenroute.nl/secure/kopen.aspx?boekid=3523"> <img border="0" src="http://www.boekenroute.nl/img/wagen.gif" alt="bestellen" /></a> </p> <p>koop dit boek: <a href="https://www.boekenroute.nl/secure/kopen.aspx?boekid=3523"> <img border="0" src="../img/shoppingcart.jpg" alt="kopen" /></a></p> 2. Linken naar de complete beschrijving op BoekenRoute: <p>nu staat op de pagina van de denkbeeldige uitgever een fondslijst, voor de gedetailleerde beschrijving van het boek verwijst de website naar BoekenRoute:</p> <p><strong>alleen tekst:</strong><br /> Andere auteur: <a href="voorbeelden.htm" title="details">het Boek</a><br /> Johan de Codeklopper: <a href="http://www.boekenroute.nl/gasten/gtn1boek.aspx?boekid=3523" target="_blank" title="details">testboek voor Webmasters</a><br /> Weer Andere Auteur: <a href="voorbeelden.htm">nog een boek</a></p> <p><strong>met afbeelding voorplat:</strong></p> <table border="0"> <tr>
<td> <a href="http://www.boekenroute.nl/gasten/gtn1boek.aspx?boekid=3523"> <img src="http://www.boekenroute.nl/boekcomps/dnafb.aspx?figuurid=1166" alt="testboek voor Webmasters - details" border="0" /></a> </td> <td> <a href="http://www.boekenroute.nl/gasten/gtn1boek.aspx?boekid=3523">testboek voor Webmasters</a><br /> <em>john de Codeklopper</em></td> </tr> <tr> <td> volgende voorplat</td> <td> titel<br /> <em>auteur</em></td> </tr> </table>
3. Complete fondslijst gebruiken : Hierbij zult u gebruik (laten) maken van java, php of dotnet. Hieronder de code die wij gebruikten op de voorbeeldpagina. Op de pagina zelf, de tabel met de fondslijst: <asp:gridview ID="gvTitels" runat="server" AutoGenerateColumns="False"> <Columns> <asp:imagefield DataImageUrlField="FiguurID" DataImageUrlFormatString="http://www.BoekenRoute.nl/BoekComps/dnAfb.aspx?FiguurID={0}"> </asp:imagefield> <asp:hyperlinkfield DataNavigateUrlFields="BoekID" DataNavigateUrlFormatString="http://www.boekenroute.nl/gasten/gtn1Boek.aspx?BoekID={0}" DataTextField="Titel" HeaderText="Titel:" Target="_blank" /> <asp:boundfield DataField="HoofdAuteur" HeaderText="Auteur:" /> <asp:templatefield HeaderText="Etcetera:"> <ItemTemplate> <asp:label ID="Label1" runat="server" Text='<%# FormatNumber(Eval("Prijs")/10000,2) %>'> </asp:label><br /> <asp:label ID="Label2" runat="server" Text='<%# Bind("BoekVorm") %>'></asp:label><br /> <asp:label ID="Label3" runat="server" Text='<%# Bind("Beschikbaarheid") %>'></asp:label> </ItemTemplate> </asp:templatefield> <asp:templatefield> <ItemTemplate> <asp:hyperlink ID="HyperLink1" runat="server" NavigateUrl='<%# Eval("BoekID", "https://www.boekenroute.nl/secure/kopen.aspx?boekid={0}") %>'> <img src="../img/shoppingcart.jpg" border="0"/></asp:hyperlink> </ItemTemplate> </asp:templatefield> </Columns> </asp:gridview>
De achterliggende code (hier: visual basic): In Visual Studio is de webservice naar BoekenRoute toegevoegd, met de naam BoekenRoute.FL.Fondslijsten. 'refereer aan de webservice: Dim wsfl As New Boekenroute.FL.FondsLijsten 'We gebruiken de Titellijst, haal die op: Dim Titels As XmlNode = wsfl.titellijst(uitgid.tostring) 'hebben we zinvolle gegevens opgehaald? If Not Titels Is Nothing Then If Titels.InnerXml.Length > 0 Then 'gebruik een XML reader: Dim Reader As XmlTextReader = _ New XmlTextReader(Titels.OuterXml, XmlNodeType.Element, Nothing) Dim dstitels As New DataSet dstitels.readxml(reader) 'let op, zie Service Description, neem juiste tabel: gvtitels.datasource = dstitels.tables("boek") gvtitels.databind() End If End If.