Het verwerken van de Groupon API – Deel 3

In dit laatste artikel van de serie gaan we een stylesheet toepassen om de XML-gegevens, die we hebben gegenereerd op basis van onze mapping van de Groupon API, om te zetten naar HTML. Hier is een voorbeeld van de XML-uitvoer die we vorige keer hebben gegenereerd met onze datamapping:

Wijs een stylesheet toe om XML te transformeren Via het dialoogvenster "Componentinstellingen" voor het uitvoercomponent van de MapForce-mapping kunnen we een stylesheet toewijzen die is gemaakt met Altova StyleVision.

Het toewijzen van een stylesheet aan het component voor de uitvoer van de datamapping integreert de functionaliteit van MapForce en StyleVision, en er verschijnt een nieuwe reeks knoppen onderaan het MapForce-mappingvenster voor HTML-, RTF-, PDF- en Microsoft Word-formaten. (U moet zowel MapForce als StyleVision op uw computer geïnstalleerd hebben.)

Wanneer u op een van deze knoppen voor het uitvoerformaat klikt, voert MapForce de datatransformatie exact uit zoals we in de vorige post hebben gezien. MapForce transporteert de XML-uitvoer naadloos naar StyleVision, waar deze wordt omgezet naar het geselecteerde formaat. Vervolgens toont MapForce het opgemaakte document in het uitvoervenster. Hieronder ziet u het MapForce-uitvoer venster voor HTML, gebaseerd op het StyleVision-stijlblad dat hierboven is toegewezen:

Het MapForce-menu "Uitvoer" stelt u in staat om de XML-gegevensmapping op te slaan, of het HTML-document te exporteren, waarbij de opmaak wordt bepaald door het gebruikte stylesheet.

Hoe maak je een stylesheet

We hebben een stylesheet ontworpen voor de data-mapping van de Groupon API, met behulp van Altova StyleVision, gebaseerd op het XML-schema voor het MapForce-uitvoercomponent. De intuïtieve StyleVision-interface en de krachtige functies voor data-toegang en -manipulatie maken het eenvoudig om aantrekkelijke documenten te creëren in HTML, RTF, PDF en Microsoft Word-formaten, op basis van XML-bestanden. De onderstaande screenshot toont de ontwerpweergave van de Extreme Groupon-stylesheet in StyleVision. De blauwe, genummerde cirkels geven de locatie aan van elk ontwerpkenmerk, zoals beschreven onder de afbeelding.

Kenmerken van het SPS-bestand

1. Met behulp van door de gebruiker gedefinieerde HTML-code kunnen we de meta-tag voor de weergave (viewport) instellen voor mobiele apparaten. Hierdoor kunnen we één stylesheet ontwerpen om een enkel HTML-bestand te genereren dat geschikt is voor zowel computers als mobiele apparaten

2. Documenttitel met een aangepast lettertype, -grootte en -kleur

3. Een autocalc-element gebruikt de XPath-functie "count" om het aantal overeenkomsten in het XML-invoerdocument te tellen en voegt vervolgens het totaal toe

4. De datumstempel wordt bovenaan het document geplaatst, ook al komt het date-element aan het einde van het XML-invoerbestand

5. Afbeeldingen van de websites van Altova en Groupon worden via hyperlinks getoond, en niet als direct ingebedde afbeeldingen

6. Horizontale lijnen scheiden elke individuele aanbieding. Voor HTML-documenten passen deze lijnen automatisch aan de breedte van het browservenster

7. Aangepaste lettertypen en -groottes toegewezen aan verschillende elementen

8. Een tabel met twee kolommen presenteert de beschrijving van elke aanbieding

9. De URL's in het XML-bestand worden dynamisch toegewezen als hyperlinks voor ingebedde afbeeldingen, statische tekst en dynamische gegevens

StyleVision Power Stylesheets kunnen meerdere .xsd-bestanden, bestaande .css-stijlbladen, databaseschema's, XBRL-taxonomieën en meer combineren om uitgebreid opgemaakte rapporten te genereren, die zelfs automatisch gegenereerde grafieken in verschillende stijlen kunnen bevatten. U kunt StyleVision ook gebruiken om elektronische formulieren te definiëren met invoervelden, keuzelijsten, radiobuttons en andere geavanceerde functies.

Voorbeeldweergave van stijlbladtransformaties

StyleVision stelt u in staat om een XML-bestand te koppelen, zodat u de resultaten kunt bekijken terwijl u de opmaak definieert. De knoppen onderaan het ontwerpvenster maken het eenvoudig om het opgemaakte bestand weer te geven terwijl u uw ontwerp verfijnt. We hebben de XML-uitvoer van de MapForce-mapping opgeslagen en dit als ons werkdocument ingesteld. Zodra de opmaak voltooid was, kwam de HTML-voorvertoning in StyleVision overeen met het MapForce HTML-uitvoer venster dat hierboven wordt weergegeven. Om het document op een mobiel apparaat te bekijken, kunt u de HTML als een pagina op een website publiceren of het als een bijlage per e-mail verzenden.

Naast de stylesheet zelf en de opgemaakte versies van het werkdocument, stelt StyleVision u in staat om de gegenereerde XSLT-bestanden op te slaan, zodat u andere XML-bestanden kunt transformeren met behulp van uw stylesheet-ontwerp, en dat buiten de StyleVision-applicatie.

Automatisering, de volgende keer

In de toekomst, wanneer u een datamapping opnieuw wilt uitvoeren en het HTML-document wilt bijwerken met actuele gegevens, zijn er twee manieren om dit proces te automatiseren:

• U kunt MapForce uitvoeren via de opdrachtregel, met parameters om de naam van het mapping-definitiebestand te specificeren, en zelfs StyleVision aanroepen om gestructureerde uitvoer te genereren

• U kunt code genereren zonder royaltyverplichtingen voor de mapping in XSLT, Java, C++ of C#, die u kunt combineren met de XSLT-code van StyleVision om uw eigen applicatie van begin tot eind te bouwen

XMLSpy, MapForce en StyleVision zijn allemaal beschikbaar in de Altova MissionKit, een bundel met een speciale prijs. Ontdek zelf hoe eenvoudig het is om de MissionKit te gebruiken om gegevens van een web-API om te zetten – download een gratis proefversie van 30 dagen!

Redactienota: Onze oorspronkelijke serie over het verwerken van data van de Groupon API bestond uit drie delen. U kunt deze bekijken door op de links hieronder te klikken: Deel 1, "Het verwerken van de Groupon API met Altova MapForce", beschrijft hoe u dynamische invoer kunt creëren door data te verzamelen van meerdere URL's. Deel 2, "Het verwerken van de Groupon API met MapForce – Deel 2", beschrijft hoe we data uit de API hebben gefilterd en de uitvoer hebben gedefinieerd om alleen de meest interessante details te extraheren. Deel 3, "Het verwerken van de Groupon API – Deel 3", beschrijft hoe we de uitvoer hebben opgemaakt als een enkel HTML-document, geoptimaliseerd voor desktop- en mobiele apparaten, en bespreekt manieren om de herhaalde uitvoering te automatiseren.