DocumentatieDynamic Media-API voor beeldbeheer en renderen

Mediasetaanvragen media-set-requests

Last update: Sat Nov 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar
  • Gebruiker

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 section-d72b1d95e4ce4bb1b332ce096c2b99f1

De ingestelde reactie voor een catalog::ImageSet kan worden opgehaald met het gereedschap 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 section-93eb0a1f70344da2a888e56372ad3896

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 section-3dd6e453528d46898e559d31458a59ba

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 de volgende set heeft: mp3, mp4, flv, f4v, swf, xml
    • Anders wordt een op een bestand gebaseerde afbeelding aangenomen

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

Typedetectie binnen section-8f46490e467247e69ce284704def06f3

Wanneer de buitenste set wordt gedetecteerd als een mediaset, bevat de reactie een set mediasetitems die overeenkomen met elk mediasetitem 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 section-c1bd60948ef545759a16885bb6fcc607

De geretourneerde xml-reactie voldoet aan de volgende specificatie:

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

LabelKey section-bf565de6f7294cf89620343c9071f415

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 section-b9f042873bee45a5ae11b69fd42f2bca

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.

Voorbeelden section-588c9d33aa05482c86cd2b1936887228

Voor voorbeeld-XML-reacties voor req=set verzoek, verwijs naar de pagina van Eigenschappen onder de kopbal van de Voorbeelden van de HTML.

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

Zie ook section-625ec466c948476e800dc0c52a4532d3

req= , imageset=, catalogus::ImageSet, Referentie afbeeldingscatalogus

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