Aperçu des applications RESTful

Le cadre de services Web et le cadre de services REST peuvent tirer parti de l'utilisation de jetons d'aperçu pour permettre aux utilisateurs commerciaux de prévisualiser le contenu dans les applications RESTful en dehors du module Web du magasin. Par exemple, vous pouvez effectuer des personnalisations pour votre application mobile Android native pour prévisualiser les actions dans votre application avec les options d'aperçu spécifiées dans le jeton d'aperçu.

Pour plus d'informations sur les jetons d'aperçu, voir Jetons d'aperçu.
Remarque : En plus de personnaliser votre application RESTful pour obtenir un jeton d'aperçu, vous devez également Activer la prise en charge de la prévisualitsitanion pour les applications RESTful dans votre fichier de configuration de serveur HCL Commerce.

Aperçu du service BOD

Pour prendre en charge l'aperçu du service BOD, le cadre des services Web peut accepter un jeton d'aperçu généré en tant qu'élément de données contextuelle nommé previewToken dans l'élément contexte métier BOD. Lorsque le cadre de service Web appelle le service de contexte métier pour démarrer une demande, le jeton d'aperçu est décrypté et vérifié. S'il est vérifié avec succès, le contexte métier de l'utilisateur est temporairement mis à jour avec les options d'aperçu qui ont été spécifiées lors de la génération du jeton d'aperçu.

Exemple de requête de service BOD avec un jeton d'aperçu :
<_mkt:GetMarketingSpotData versionID="6.0.0.6" 
xmlns:_mkt="http://www.ibm.com/xmlns/prod/commerce/9/marketing" 
xmlns:_wcf="http://www.ibm.com/xmlns/prod/commerce/9/foundation" 
xmlns:oa="http://www.openapplications.org/oagis/9" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> 
	<oa:ApplicationArea xsi:type="_wcf:ApplicationAreaType"> 
		<oa:CreationDateTime></oa:CreationDateTime> 
		<oa:BODID></oa:BODID> 
		<_wcf:BusinessContext intent="Authoring"> 
			<_wcf:ContextData name="storeId">10001</_wcf:ContextData> 
			<_wcf:ContextData name="catalogId">10001</_wcf:ContextData> 
			<_wcf:ContextData name="langId">-1</_wcf:ContextData> 
			<_wcf:ContextData name="previewToken">iuJOiPLnTn0=</_wcf:ContextData> 
		</_wcf:BusinessContext> 
	</oa:ApplicationArea> 
	<_mkt:DataArea> 
		<oa:Get> 
			<oa:Expression expressionLanguage="_wcf:XPath">{_mkt.triggerParameters=&apos; 
			&amp;DM_EmsName=StoreHomePage_mkt.endTriggerParameters&ap os;}/MarketingSpotData</oa:Expression> 
		</oa:Get> 
	</_mkt:DataArea> 
</_mkt:GetMarketingSpotData>

Aperçu des services REST

Le cadre des services REST peut accepter un jeton d'aperçu via le champ d'en-tête HTTP WCPreviewToken. Au début de la requête, le jeton d'aperçu est vérifié pour confirmer si le jeton est envoyé via HTTPS. En cas de succès, le jeton d'aperçu est copié dans l'élément de contexte métier BOD et traité par le cadre de service Web. Si le jeton d'aperçu est envoyé via un canal non sécurisé, par exemple HTTP, le jeton d'aperçu est révoqué et ne peut pas être utilisé par les services REST.