Medieuppsättningsbegäranden media-set-requests
Image Serving är ett sätt att hämta ett hierarkiskt textsvar (xml eller json) som representerar alla resurser och metadata som är associerade med katalogen::ImageSet för en viss post.
Visningsprogrammen kan använda den här funktionen för att generera svar som informerar presentationen av enkla bilder, videoklipp, videouppsättningar, färgruteuppsättningar, siduppsättningar (e-kataloger) och mediauppsättningar.
Syntax för begäran section-d72b1d95e4ce4bb1b332ce096c2b99f1
Uppsättningssvaret för en catalog::ImageSet kan hämtas med modifieraren req=set och med en referens till katalogpost-ID:t i nätsökvägen. Alternativt kan bilduppsättningen anges direkt i URL:en med modifieraren imageset=. Om modifieraren imageset= används för att ange bilduppsättningen bör hela värdet omges av klammerparenteser för att undvika bilduppsättningsvärdet och för att säkerställa att alla inkluderade modifierare inte tolkas som en del av URL-frågesträngen.
Typer av inställda svar section-93eb0a1f70344da2a888e56372ad3896
Mekanismen set har stöd för följande typer av svar:
Identifiering av typ för yttre uppsättning section-3dd6e453528d46898e559d31458a59ba
När en req=set-begäran tas emot bestäms typen av svar som ska genereras av värdet catalog::AssetType. Om catalog::AssetType inte definieras bestäms svarstypen av följande regler:
-
Om det finns poster i bildkatalogen, definieras AND
catalog::ImageSet- Anta att e-katalog har angetts om minst en post i fältet Imageset innehåller ett kolon
- Anta att medieuppsättningar finns om minst en post i fältet Imageset innehåller två semikolon.
- Anta att bilduppsättningen är om minst en post i fältet Imageset innehåller ett semikolon.
- Anta att snurra anges om ingen post innehåller kolon eller semikolon, men minst en post innehåller en referensuppsättning eller en intern uppsättning (detta är en 2D-snursuppsättning).
- Anta att en okänd uppsättning saknas om det inte finns någon post som innehåller kolon eller semikolon eller refererad uppsättning eller textbunden uppsättning (t.ex. en kommaseparerad lista med bilder).
-
Om post hittas i både bild OCH statiska innehållskataloger
- Anta video om filtillägget finns i följande uppsättning: mp3, mp4, flv, f4v, swf, xml
- Anta annars att bilden
-
Om en post hittas i en statisk innehållskatalog men INTE i bildkatalogen
- Anta video om filtillägget finns i följande uppsättning: mp3, mp4, flv, f4v, swf, xml
- Anta statiskt annars
-
Om en post hittades i bildkatalogen men INTE i den statiska innehållskatalogen
- Anta bild
-
Om posten INTE hittas i bildkatalogen och INTE hittas i den statiska innehållskatalogen
- Anta filbaserad video om filtillägget finns i följande uppsättning: mp3, mp4, flv, f4v, swf, xml
- Anta annars filbaserad bild
I samtliga fall överensstämmer det resulterande xml-svaret med det angivna XML-dokumentet med den angivna rotnoden som motsvarar den identifierade typen.
Identifiering av intern set-typ section-8f46490e467247e69ce284704def06f3
När den yttre uppsättningen identifieras som en typ av medieuppsättning innehåller svaret en uppsättning medieuppsättningsobjekt som motsvarar varje medieuppsättningspost i catalog::ImageSet. Om den valfria typparametern anges för en viss medieuppsättningspost mappas den till en utdatatyp enligt följande tabell:
imgimgbasicimgadvanced_imageimgimg_setimg_setadvanced_image_setimg_setadvanced_swatchsetimg_setspinspinvideovideovideo_setvideo_setstaticstaticecatecatOm den valfria typparametern för en viss medieuppsättningspost inte har angetts eller motsvarar en typ som inte stöds, identifieras medieuppsättningens objekttyp automatiskt med samma regler som tillämpades på den yttre uppsättningsnivån.
XML-specifikation section-c1bd60948ef545759a16885bb6fcc607
Det returnerade xml-svaret uppfyller följande specifikation:
http://crc.scene7.com/is-docs/examples/mediaset.dtd
LabelKey section-bf565de6f7294cf89620343c9071f415
Modifieraren labelkey= används tillsammans med fältet catalog::UserData för att generera etiketter för bilder och färgrutor. Fältet catalog:UserData tolkas som en uppsättning nyckel/värde-par och etikettnyckelindexen i den här uppsättningen för att hämta värdet för den angivna nyckeln. Värdet returneras sedan i attributet l för s och i.
Tvingade begränsningar section-b9f042873bee45a5ae11b69fd42f2bca
För att begränsa svarsstorleken och förhindra självrefererande problem styrs det maximala kapslingsdjupet av serveregenskapen PS::fvctx.nestingLimit. Om gränsen överskrids returneras ett fel.
För att begränsa storleken på xml-svaren för stora e-kataloguppsättningar, inaktiveras privata metadata för broschyruppsättningar enligt serveregenskapen PS::fvctx.brochureLimit. Alla privata metadata som är associerade med broschyren exporteras tills broschyrgränsen nås. När gränsen har överskridits ignoreras privata kartor och användardata och en motsvarande flagga ställs in för att ange vilken typ av data som har utelämnats.
Kapslade medieuppsättningar stöds inte. En kapslad medieuppsättning definieras som en medieuppsättning som innehåller en medieuppsättning av medietyp. Om det här tillståndet upptäcks returneras ett fel.
Exempel section-588c9d33aa05482c86cd2b1936887228
XML-exempelsvar för req=set-begäran finns på sidan Egenskaper under rubriken Exempel på HTML.
http://crc.scene7.com/is-docs/examples/properties.htm
Se även section-625ec466c948476e800dc0c52a4532d3
req= , imageset=, catalog::ImageSet, Image Catalog Reference