Sitecore Item Web API & Mobile SDK

Presentatie over: "Sitecore Item Web API & Mobile SDK"— Transcript van de presentatie:

1 Sitecore Item Web API & Mobile SDK
11 september 2013 Martijn van der Put

2 Inhoud Sitecore Item Web Api Sitecore Mobile SDK
Demo ParTech Blog Reader App

3 Wat is de Sitecore Item Web API
HTTP request Bewerken van content dmv item path, ID of query Response in JSON formaat

4 Installatie / configuratie
Sitecore 6.5 update 5 of hoger Web API Package Sitecore.ItemWebApi.dll Sitecore.ItemWebApi.config

5 Installatie / configuratie (2)
Site definitie uitbreiden in sitedefinitions.config

6 Sitecore.ItemWebApi.config
Installatie / configuratie (3) Sitecore.ItemWebApi.config Definitie van een nieuw veld in de Security Editor Default zijn de lees rechten “denied”

7 Query string parameters
string params> sc_itemid= sc_itemversion= sc_database= language= fields= extractblob=1 payload= scope= query= page= / pagezise=

8 Mogelijke item bewerkingen
Ophalen van items (HTTP Get) Op basis van item ID Query: item path:

9 Mogelijke item bewerkingen (2)
JSON result

10 Querystring parameters:
Mogelijke item bewerkingen (3) Aanmaken nieuwe items HTTP Post Querystring parameters: template name OF BranchID name=MyItem&template=Sample/Sample Item&sc_database=master

11 HTTP Request header: Content-Type=application/x-www-formurlencoded
Mogelijke item bewerkingen (4) Items bewerken HTTP Put HTTP Request header: Content-Type=application/x-www-formurlencoded Url aanmaken nieuwe items uitbreiden <fieldName1>=<fieldValue1>&<fieldName2>=<fieldValue2>&<fieldNameN>=<fieldValueN> <fieldID1>=<fieldValue1>&<fieldID2>=<fieldValue2>&<fieldIDN>=<fieldValueN>

12 Heeft invloed op alle items in de scope
Mogelijke item bewerkingen (5) Item verwijderen HTTP Delete Heeft invloed op alle items in de scope Response toont aantal verwijderde items + ID

13 HTTP Request header Content-Type=multipart/form-data
Mogelijke item bewerkingen (6) Media items aanmaken HTTP Post HTTP Request header Content-Type=multipart/form-data Scope wordt niet gebruikt Context item is parent

14 Special requests GetRenderingHtml - sc_database - renderingId - sc_itemId &renderingId={493B3A83-0FA FC CF743}&sc_itemid={110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9}&a=1&b=2&c=3

15 Uitbreidbaarheid Item Web Api functies gebruiken pipelines
Pipelines zijn uit te breiden of toe te voegen

16 Wanneer te gebruiken Vanuit andere applicaties content tonen of bewerken Mobile Apps -> directe aanroep -> via Sitecore Mobile SDK

17 Item Web API vs Sitecore Visual Service
overlap HTTP request SOAP Uitbreidbaarheid door pipelines override of eigen pipelines toevoegen Uitbreidbaarheid door nieuwe webservice* of huidige service overriden Uitgebreidere authorisatie mogelijk Standaard Sitecore authorisatie Sitecore query Item ID

18 Sitecore Mobile SDK

19 Wat is de Mobile SDK Framework iOS based applicaties
Server: Item Web Api Client: SitecoreMobileSDK.framework met Objective-C Api

20 Benodigdheden Sitecore 6.5 (update-5) of later Sitecore Item Web Api
Sitecore Mobile SDK framework bundle OS X met Xcode software

21 Installatie / Configuratie
Item Web Api Framework bundle toevoegen Linken van extra Frameworks Linken van extra libraries

22 4 soorten apps Embedded Browser Item Web Api Hybrid Custom approach
“inframen” mobiele website variant Item Web Api Native objective-C code icm Sitecore Mobile SDK Framework Hybrid Combinatie embedded browser en Native objective-C Custom approach met eigen Objective-C Api

23 Communicatie SDK <> Item Web API

24 ParTech Blog Reader app

25 Datacontroller

26 Code explanation Ophalen van een lijst met blogItems (titel, datum, introductie, tekst, auteur) SCApiContext

27 Code explanation (2) SCAsyncOp block request callback

28 Code explanation (3) SCItem object

29 Code explanation (4) Veld uitlezen uit target-item

30 Code explanation (5) Result object vullen

31 Code explanation (6) Item aanmaken

32 Code explanation (7) Item aanmaken en bewerken

33 Caching en Request merging
Hergebruik van items indien in de cache Sitecore query altijd gelezen uit backend SCItemsReaderRequestIgnoreCache flag Mergen van requests: aantal calls verminderd

34 Andere mogelijkheden Mobile SDK
Ophalen van paged items Verwijderen van items Uploaden van Media Files Html ophalen van Renderings Analytics integratie

35 Korte demo

36 Nuttige resources iOS Developer Library http://developer.apple.com
Sitecore GitHub Alexander Dodatko Developer Sitecore Mobile Team

37 Conclusie

38 Mail: martijn@partechit.nl Twitter: @Martijnvdput