Mediasetaanvragen

De Server van het beeld verstrekt een mechanisme om een hiërarchische tekstreactie (xml of json) op te halen die alle middelen en meta-gegevens verbonden aan catalogus vertegenwoordigt::ImageSet voor een bepaald verslag.

De kijkers kunnen dit mechanisme gebruiken om reacties te produceren om de presentatie van eenvoudige beelden, video's, videoreeksen, monsterreeksen, spin reeksen, paginasets (e-catalogi), en media reeksen te informeren.

Aanvraagsyntaxis

De ingestelde reactie voor een catalog::ImageSet kan worden opgehaald met de req=set wijzigen en verwijzen naar de catalogusrecord-id in het netto pad. De afbeeldingsset kan ook rechtstreeks in de URL worden opgegeven met de opdracht imageset= modifier. Als de imageset= De bepaling wordt gebruikt om imageset te specificeren, zou de volledige waarde in krullende steunen moeten worden ingesloten om de beeld te ontsnappen vastgestelde waarde en ervoor te zorgen dat om het even welke inbegrepen bepalingen niet als deel van het URL vraagkoord worden geïnterpreteerd.

Typen ingestelde reacties

Het ingestelde mechanisme ondersteunt de volgende typen reacties:

eenvoudige afbeeldingen	Een afbeeldingsrecord zonder catalogus::ImageSet gedefinieerd.
eenvoudige video's	Een video-opname in de statische inhoudscatalogus.
stalensets	Een set items die bestaat uit een verwijzing naar een afbeeldingsrecord en een optionele aparte verwijzing naar een afbeeldingsrecord die als staal wordt gebruikt.
hiërarchische stalensets	Een set items die bestaat uit een standaardstaalitem of een verwijzing naar een record in een stalenset.
spin-sets	Een set items die bestaat uit een eenvoudige lijst met afbeeldings-id's.
tweedimensionale centrifuges	Een set items die bestaat uit een eenvoudige afbeelding of een verwijzing naar een elementaire reeks spinnen.
paginasets	Een reeks items die bestaat uit een lijst met maximaal drie pagina-afbeeldingen
mediasets	Een set items die bestaat uit eenvoudige afbeeldingen, videoreeksen, stalensets, hiërarchische stalensets, centrifuges, tweedimensionale centrifuges, paginasets en video-elementen. Elk mediaset-item kan ook een optioneel staal bevatten.
videosets	Een reeks items die bestaat uit een lijst met eenvoudige video's.

Typedetectie buiten instellen

Wanneer een req=set verzoek wordt ontvangen, wordt het type te produceren reactie bepaald door de waarde van catalog::AssetType. Indien catalog::AssetType niet wordt bepaald, dan wordt het reactietype bepaald door de volgende regels:

Indien record wordt gevonden in de afbeeldingscatalogus EN catalog::ImageSet is gedefinieerd
- Een e-catalogusset aannemen als ten minste één item in het veld Recordafbeeldingsset een dubbele punt bevat
- Mediaset aannemen als ten minste één item in het veld Afbeeldingsset record twee puntkomma's bevat.
- Afbeeldingsset aannemen als ten minste één item in het veld Afbeeldingsset record één puntkomma bevat.
- Er wordt aangenomen dat er een centrifuge is ingesteld als geen item dubbele punt of puntkomma bevat, maar ten minste één item een set waarnaar wordt verwezen of een in-line set bevat (dit is een 2D-centrifuge).
- Onbekende set veronderstellen als geen item dubbele punt of puntkomma bevat, noch als set of inline set waarnaar wordt verwezen (d.w.z. een door komma's gescheiden lijst met afbeeldingen).
Als record wordt gevonden in zowel afbeeldings- ALS statische inhoudcatalogi
- Video aannemen als de bestandsextensie zich in de volgende set bevindt: mp3, mp4, flv, f4v, swf, xml
- Anders de afbeelding aannemen
Als record wordt gevonden in statische inhoudscatalogus maar NIET in afbeeldingscatalogus
- Video aannemen als de bestandsextensie zich in de volgende set bevindt: mp3, mp4, flv, f4v, swf, xml
- Anders statisch aannemen
Indien opname is gevonden in de afbeeldingscatalogus maar NIET in de catalogus met statische inhoud
- Afbeelding aannemen
Als er geen record wordt gevonden in de afbeeldingscatalogus en NIET in de catalogus met statische inhoud
- Op bestanden gebaseerde video aannemen als de bestandsextensie zich in de volgende set bevindt: mp3, mp4, flv, f4v, swf, xml
- Anders wordt een op een bestand gebaseerde afbeelding aangenomen

In alle gevallen zal de resulterende xml-reactie overeenkomen met het opgegeven XML-document met het ingestelde hoofdknooppunt dat overeenkomt met het gedetecteerde type.

Typedetectie binnen

Wanneer de buitenste set wordt gedetecteerd als een mediaset, bevat de reactie een set mediasetitems die overeenkomen met elk mediaset-item in catalog::ImageSet. Als de optionele parameter type is opgegeven voor een bepaald mediaset-item, wordt deze toegewezen aan een uitvoertype volgens de volgende tabel:

Invoertype	Uitvoertype
`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`

Als de optionele parameter type voor een bepaald mediaset-item niet is opgegeven of overeenkomt met een niet-ondersteund type, wordt het mediaset-itemtype automatisch gedetecteerd volgens dezelfde regels als die welke op het buitenste setniveau zijn toegepast.

XML-specificatie

De geretourneerde xml-reactie voldoet aan de volgende specificatie:

http://crc.scene7.com/is-docs/examples/mediaset.dtd

LabelKey

De labelkey= modifier wordt gebruikt samen met de catalog::UserDataveld voor het genereren van labels voor afbeeldingen en stalen. De catalog:UserData veld wordt geparseerd als een set sleutel/waardeparen en de index van de labeltoets in deze set om de waarde voor de opgegeven toets op te halen. Deze waarde wordt vervolgens geretourneerd in het dialoogvenster l kenmerk voor de s en i.

Afgedwongen beperkingen

Om de grootte van de reactie te beperken en zelf-verwijzingskwesties te verhinderen, wordt de maximum het nesten diepte gecontroleerd door het serverbezit PS::fvctx.nestingLimit. Als deze limiet wordt overschreden, wordt een fout geretourneerd.

Om de grootte van de xml- reacties voor grote e-catalogusreeksen te beperken, worden de privé meta-gegevens onderdrukt voor brochure vastgestelde punten volgens het serverbezit PS::fvctx.brochureLimit. Alle persoonlijke metagegevens die aan de brochure zijn gekoppeld, worden geëxporteerd totdat de brochure-limiet is bereikt. Nadat de limiet is overschreden, worden privékaarten en gebruikersgegevens onderdrukt en wordt een bijbehorende markering ingesteld om aan te geven welk type gegevens is onderdrukt.

Geneste mediasets worden niet ondersteund. Een geneste mediaset wordt gedefinieerd als een mediaset die een mediaset-item van het type mediaset bevat. Als deze voorwaarde wordt gedetecteerd, wordt een fout geretourneerd.