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

Ange svar för en catalog::ImageSet kan hämtas med req=set modifierare och referera till katalogobjektets ID i nätsökvägen. Alternativt kan bilduppsättningen anges direkt i URL:en med hjälp av imageset= modifierare. Om imageset= modifierare används för att ange bilduppsättningen. Hela värdet ska omges av klammerparenteser för att undvika bilduppsättningsvärdet och 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:

enkla bilder
En bildpost utan katalog::ImageSet definierad.
enkla videoklipp
En videopost i katalogen med statiskt innehåll.
färgruteuppsättningar
En uppsättning objekt som består av en referens till en bildpost och en valfri separat referens till en bildpost som används som en färgruta.
hierarkiska färgrutor
En uppsättning objekt som består av ett grundläggande färgruteobjekt eller en referens till en post för färgruteuppsättning.
snurra uppsättningar
En uppsättning objekt som består av en enkel lista med bild-ID:n.
tvådimensionella snurruppsättningar
En uppsättning med objekt som består av en enkel bild eller en referens till en grundläggande snurruppsättning.
siduppsättningar
En uppsättning objekt som består av en lista med upp till tre sidbilder
medieuppsättningar
En uppsättning objekt som består av enkla bilder, videouppsättningar, färgruteuppsättningar, hierarkiska färgruteuppsättningar, snurruppsättningar, tvådimensionella snurruppsättningar, siduppsättningar och videoresurser. Varje medieuppsättningsobjekt kan också innehålla en valfri färgruta.
videouppsättningar
En uppsättning med objekt som består av en lista med enkla videoklipp.

Identifiering av typ för yttre uppsättning section-3dd6e453528d46898e559d31458a59ba

När en req=set begäran tas emot, vilken typ av svar som ska genereras bestäms av värdet för catalog::AssetType. If catalog::AssetType är inte definierad, bestäms svarstypen av följande regler:

  • Om post hittas i bildkatalogen OCH catalog::ImageSet är definierad

    • 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:

Indatatyp
Utdatatyp
img
img
basic
img
advanced_image
img
img_set
img_set
advanced_image_set
img_set
advanced_swatchset
img_set
spin
spin
video
video
video_set
video_set
static
static
ecat
ecat

Om 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

The labelkey= modifieraren används tillsammans med catalog::UserDataom du vill generera etiketter för bilder och färgrutor. The catalog:UserData fältet 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 l attributet 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 egenskapen server 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ättningsobjekt 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

Exempel på XML-svar för req=set Mer information finns på sidan Egenskaper under rubriken Exempel på HTML.

http://crc.scene7.com/is-docs/examples/properties.htm

Se även section-625ec466c948476e800dc0c52a4532d3

req= , imageset=, katalog::ImageSet, Referens för bildkatalog

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49