Qu’est-ce que CSMetal ? C’est un utilitaire pour Commerce Server qui génère des classes fortement typées utilisable à travers un provider LINQ basé sur l’API Commerce Foundation => ie, ça ne remplace pas l’API Commerce Foundation !

Kerry frappe fort avec CSMetal, car le développement sous Commerce Server devient un “jeu d’enfant”!

Avant de pouvoir utiliser le provider LINQ pour Commerce Server, il nous faut auparavant générer les entités. Pour cela, nous devons utiliser l’outil de commande en ligne CSMetal.

Pour que CSMetal entre en action, il vous faut:

• Le fichier ChannelConfiguration.config correctement configuré
  • Attention de bien mettre la valeur de l’attribut useSharedCommerceContexts à false.
  • Ajouter dans le noeud MessageHandler avec l’attribut name "CommerceQueryOperation_CommerceEntityDefinition" les noeuds enfant suivants:

   1: <!-- Note that RepositoryMetadataLoader is replaced by a slightly customized one -->

   2: <Component name="RepositoryMetadataLoader" type="Microsoft.Commerce.Metal.Generator.OperationSequenceComponents.RepositoryMetadataLoader, Microsoft.Commerce.Metal.Generator, Version=1.0.0.0, Culture=neutral" />

   3: <!-- Note that this is added to add overlay capability to the Metadata repository -->

   4: <Component name="MetadataOverlayProcessor" type="Microsoft.Commerce.Metal.Generator.OperationSequenceComponents.MetadataOverlayProcessor, Microsoft.Commerce.Metal.Generator, Version=1.0.0.0, Culture=neutral" />

• Notez que le dernier noeud permet en gros de pouvoir générer d’autres entités ou attributs sans toucher au fichier MetadataDefinitions.xml. Nous y revenons plus bas.
• Le fichier MetadataDefinitions.xml proprement mis à jour
  • Ajouter au noeud RelationshipTypes, un noeud enfant :
    • <RelationshipType name="Inherits"/>
  • Consultez le fichier “CSMetal_Beta2_ReadMe.rtf” pour ajouter à 2 entités:
    • Basket
      • les énumérations des status de commande
    • Ads
      • Les énumérations des tailles d’une publicité
• Les “traditionnels” OrderObjectMappings.xml et OrderPipelineMappings.xml, eux aussi mis à jour.

Une fois ces ingrédients sous la main, mettez-les par exemple dans un répertoire temporaire. Ajoutez les fichiers nécessaires à la bonne exécution de CSMetal:

• CSMetal.exe
• CSMetal.exe.config qui est une copie du web.config de votre application web
• GeneratorSettings.xml qui vous permet de définir les dossiers d’outputs pour les assemblies générées avec un namespace et un nom de context de votre choix!
• Microsoft.Commerce.Metal.Generator.dll pour la génération de code

Soit:

Afin de bénéficier pleinement du Linq provider pour Commerce Server, nous avons certaines metadatas à faire évoluer ou créer. Pour cela, Kerry a introduit un concept très pratique appellé “MetaDataOverlays”:

• Cela revient à étendre les metadatas via un fichier xml extérieur sans avoir à toucher à votre fichier MetadataDefinitions.xml. Dans le cas de notre provider Linq pour Commerce Server, nous avons un certains nombres d’entités à mettre à jour mais qui n’ont pas d’intéret à être dans le runtime de l’application web puisqu’utilisé uniquement par notre provider Linq.

Pour cela, dans le répertoire CSMetal ajouter un nouveau dossier enfant appellé MetadataOverlays et ajoutez-y le fichier xml Metadata_CSMetal.xml

   1: <?xml version="1.0" encoding="utf-8" ?>

   2: <!-- 

   3: This file contains the Metadata Repository

   4: -->

   5: <MetadataDefinitions xmlns="urn:schemas-microsoft-multi-channel-commerce-foundation-metadata">

   6:     <DefaultChannel>

   7:         <CommerceEntities>

   8:             <!-- Added for Linq based Search -->

   9:             <CommerceEntity name="CatalogEntity">

  10:                 <DisplayName value="Catalog Entity" />

  11:                 <Properties>

  12:                     <Property name="Phrase"    dataType="String">

  13:                         <DisplayName value="Phrase"/>

  14:                     </Property>

  15:                     <Property name="ReturnTypes"    dataType="Integer">

  16:                         <DisplayName value="Return Types"/>

  17:                     </Property>

  18:                     <Property name="FirstItem"    dataType="Integer">

  19:                         <DisplayName value="First Item"/>

  20:                     </Property>

  21:                     <Property name="WhereClause"    dataType="String">

  22:                         <DisplayName value="Where Clause"/>

  23:                     </Property>

  24:                     <Property name="TotalItemCount"    dataType="Integer">

  25:                         <DisplayName value="Total Item Count"/>

  26:                     </Property>

  27:                     <Property name="ResultsPerPage"    dataType="Integer">

  28:                         <DisplayName value="Results Per Page"/>

  29:                     </Property>

  30:                 </Properties>

  31:             </CommerceEntity>

  32:             <!-- Added for Linq based Search -->

  33:  

  34:             <!-- Catalog Start -->

  35:             <CommerceEntity name="Catalog">

  36:                 <Relationships>

  37:                     <Relationship name="DependantCatalogs" type="Relationship" modelName="Catalog" isMultipleItems="true" >

  38:                         <DisplayName value="Dependant Catalogs" />

  39:                     </Relationship>

  40:                     <Relationship name="SourceCatalogs" type="Relationship" modelName="Catalog" isMultipleItems="true" >

  41:                         <DisplayName value="Source Catalogs" />

  42:                     </Relationship>

  43:                 </Relationships>

  44:             </CommerceEntity>

  45:  

  46:             <!-- CreditCard Start -->

  47:             <CommerceEntity name="CreditCard">

  48:                 <Relationships>

  49:                     <Relationship name="PaymentAccount" type="Inherits" modelName="PaymentAccount" isMultipleItems="false">

  50:                     </Relationship>

  51:                 </Relationships>

  52:             </CommerceEntity>

  53:  

  54:             <!-- Basket Start -->

  55:             <CommerceEntity name="Basket">

  56:                 <Relationships>

  57:                     <Relationship name="LineItems" modelName="LineItem" type="Relationship" isMultipleItems="true" />

  58:                     <Relationship name="Addresses" modelName="Address" type="Relationship" isMultipleItems="true" />

  59:                     <Relationship name="Payments" modelName="Payment" type="Relationship" isMultipleItems="true" />

  60:                     <Relationship name="Shipments" modelName="Shipment" type="Relationship" isMultipleItems="true" />

  61:                     <Relationship name="RequestedPromoCodes" modelName="RequestedPromoCode" type="Relationship" isMultipleItems="true" />

  62:                 </Relationships>

  63:             </CommerceEntity>

  64:  

  65:             <!-- ShopperList Start -->

  66:             <CommerceEntity name="ShopperList">

  67:                 <Relationships>

  68:                     <Relationship name="LineItems" modelName="LineItem" type="Relationship" isMultipleItems="true" />

  69:                 </Relationships>

  70:             </CommerceEntity>

  71:  

  72:             <!-- LineItem Start -->

  73:             <CommerceEntity name="LineItem">

  74:                 <Relationships>

  75:                     <Relationship name="ItemLevelDiscounts" modelName="Discount" type="Relationship" isMultipleItems="true" />

  76:                 </Relationships>

  77:             </CommerceEntity>

  78:  

  79:             <!-- CashCard Start -->

  80:             <CommerceEntity name="CashCard">

  81:                 <Relationships>

  82:                     <Relationship name="PaymentAccount" type="Inherits" modelName="PaymentAccount" isMultipleItems="false">

  83:                     </Relationship>

  84:                 </Relationships>

  85:             </CommerceEntity>

  86:  

  87:             <!-- GiftCertificate Start -->

  88:             <CommerceEntity name="GiftCertificate">

  89:                 <Relationships>

  90:                     <Relationship name="PaymentAccount" type="Inherits" modelName="PaymentAccount" isMultipleItems="false">

  91:                     </Relationship>

  92:                 </Relationships>

  93:             </CommerceEntity>

  94:  

  95:             <!-- Shipment Start -->

  96:             <CommerceEntity name="Shipment">

  97:                 <Relationships>

  98:                     <Relationship name="ShippingMethod" modelName="ShippingMethod" type="Relationship" isMultipleItems="false" />

  99:                 </Relationships>

 100:             </CommerceEntity>

 101:  

 102:             <!-- Payment Start -->

 103:  

 104:             <!-- PaymentAccount Start -->

 105:             <CommerceEntity name="PaymentAccount">

 106:                 <Properties>

 107:                     <Property name="Id" dataType="String">

 108:                         <DisplayName value="Id"/>

 109:                         <Description value="Unique ID of the payment." />

 110:                     </Property>

 111:                     <Property name="CustomerName" dataType="String">

 112:                         <DisplayName value="CustomerName"/>

 113:                         <Description value="Name of Customer." />

 114:                     </Property>

 115:                     <Property name="BillingAddressId" dataType="String">

 116:                         <DisplayName value="BillingAddressId"/>

 117:                         <Description value="Id of billing address" />

 118:                     </Property>

 119:                     <Property name="DisplayName" dataType="String">

 120:                         <DisplayName value="DisplayName"/>

 121:                         <Description value="DisplayName." />

 122:                     </Property>

 123:                 </Properties>

 124:                 <Relationships>

 125:                     <Relationship name="PaymentMethod" modelName="PaymentMethod" type="Relationship" isMultipleItems="false" />

 126:                 </Relationships>

 127:             </CommerceEntity>

 128:             

 129:             <CommerceEntity name="Payment">

 130:                 <Relationships>

 131:                     <Relationship name="PaymentAccount" modelName="PaymentAccount" type="Relationship" isMultipleItems="false" />

 132:                 </Relationships>

 133:             </CommerceEntity>

 134:         </CommerceEntities>

 135:     </DefaultChannel>

 136: </MetadataDefinitions>

Exécutez maintenant CSMetal.exe:

Dans le répertoire configuré dans le GeneratorSettings.xml, vous trouverez 3 fichiers .cs correspondant à vos entités Commerce Server :

Vous noterez un fichier odata généré qui sera particulièrement utile pour exposer nos données Commerce Server, mais cela fera l’objet de plusieurs autres posts

Copiez les fichiers GeneratedContexts.cs et GeneratedTypes.cs générés par CSMetal dans le repertoire GeneratedTypes du projet CSMetalLinqProvider (ou mettez les dans les paramètres output de CSMetal, ie le fichier GeneratorSettings.xml, pour ne pas avoir à les copier) et relancez une compilation du projet CSMetalLinqProvider.

Vos entités sont maintenant générées et le provider Linq disponible

Récuperer une catégorie reviens maintenant à:

var category = new CategoryContext(commerceServiceProxy)
                  .IncludeChildCategories()
                  .Single(o => o.Id=="Departments" && o.CatalogId==DefaultCatalog);
var childCategories = category.ChildCategories;

ou pour un produit :

var product = new ProductContext(commerceServiceProxy)
                 .Single(o=>o.CatalogId==DefaultCatalog && o.Id=="AW200-12")
var productCode = product.ProductCode;

Ce n’est qu’un petit échantillon de ce que l’on peut faire, et d’autres posts viendront bientôt vous montrer la puissance de ce provider => Pour vos développeurs, plus besoin de connaitre en profondeur CS pour pouvoir l’attaquer et donc faciliter l’adoption de Commerce Server.

Ci-dessous, la session que j’ai animé avec René Lefebure. Pour le powerpoint, c’est ici

Rendez-vous incontournable des développeurs, décideurs et professionnels de l’informatique, les Microsoft TechDays rassemblent depuis bientôt 5 ans et pendant 3 jours, au Palais des Congrès de Paris, plus de :

• 17 000 visiteurs
• 140 partenaires écosystème Microsoft sur une exposition de plus de 5 500m2
• 150 journalistes et influenceurs
• 300 experts techniques conférenciers et démonstrateurs
• Un programme de 330 conférences offrant un véritable parcours à la carte.

Cette année est une année spéciale pour Altima car nous aurons pour la première année un stand . Je ne vais rien dévoiler, mais il risque d’y avoir quelques surprises… Passez donc nous voir et discuter avec les différents collaborateurs de l’agence.

Pour moi aussi, c’est une année spéciale, car j’ai la chance de pouvoir animer une session avec René Lefebure sur le thème de la prospection et la fidélisation des clients de vos sites web. Ou comment le cross canal va vous faire devenir le houdini de la relation client . Pour vous inscrire, voici le lien direct vers notre session: SQL Server : Prospecter et Fideliser les clients de vos sites Web  (DBI303)

Je vous recommande aussi d’aller voir la session qu’animeront Amélie Boucher (Directrice Pôle Ergonomie) et Thomas Tonder (Directeur Pôle Optim) :

CONVERSION ANATOMY (DES205)

Quels sont les ingrédients d’un taux de conversion de champion ? Cette présentation illustrée de nombreux exemples et études de cas vous aidera à mieux comprendre les concepts et pépites qui feront bondir la performance de votre e-business. Un tandem Amélie Boucher et Thomas Tonder (Altima) pour vous présenter cette session et connecter optimisation marketing et ergonomie.

Chez Altima, nous sommes particulièrement fiers du résultat qui est la conclusion d’un travail d’équipe formidable. Je vous laisse contempler le résultat (n’oubliez pas vos cartes bleues)

Le 8 décembre 2010 se déroulera l’édition n°2 des Web Camps et j’ai l’honneur de pouvoir vous y présenter Commerce Server 2009.

Au programme de cet après-midi:

• Programmation d’une app “évènementielle” en JavaScript avec jQuery par Sébastien Doncker, un des hommes derrière cet excellent site full HTML5 : www.NevermindTheBullets.com
• Introduction à noSQL par notre collègue Pierre Couzy (Blog), que vous avez déjà vu – entre autres – au 1er WebCamp
• Présentation et retours d’expérience sur Microsoft Commerce Server 2009, par LE grand spécialiste Français de Microsoft Commerce Server, alias Gaël Duhamel de l’agence Altima.
• L’actu techno Microsoft, en 20 minutes max, par moi même.
• Questions/Réponses, et Networking

L’inscription se fait via FaceBook: http://www.facebook.com/event.php?eid=164584443568454&index=1

Pour en savoir plus sur les web camps, je vous invite à consulter le post de Chritophe

L’évènement aura lieu au Centre de Conférences Microsoft, à Issy les Moulineaux

Au plaisir de vous y rencontrer et discuter e-Commerce

Les Microsoft Days sont pour vous l’occasion de voir les dernières innovations et orientations stratégiques de Microsoft.

Au plaisir de vous y rencontrer et discuter de vos projets

Pour vous y rendre, c’est à :

LILLE EURATECHNOLOGIE
165 avenue de Bretagne
59044 Lille Cedex

Vous pouvez le télécharger à partir du site : the beauty of the web:

Pour voir les améliorations notables, allez sur le site ie test drive web site:

Pour nous, les développeurs, Microsoft a aussi sorti un guide : Internet Explorer 9 Beta Guide for Developers.

J’ai commencé à le lire et en ai profité pour mettre mon blog à niveau en vous proposant quelques features bien sympa comme les tâches et les listes :

Enjoy the beauty of the web !

Conférence Data Mining & Commerce Server

par René Lefébure, Directeur multicanal et datamining
& Gaël Duhamel, Expert Technique Microsoft – MVP Commerce Server

Découvrez comment utiliser les solutions Data Mining de Microsoft SQL Server dans l’analyse des "Parcours Clients" pour construire et anticiper la valeur des clients…

Au programme de ces 60 minutes :

• Analyse d’expert pour comprendre ce qu’est le Data Mining et comment le mettre à profit dans l’analyse client.
• Découverte de l’apport des algorithmes de Data Mining Microsoft par rapport au marché.
• Démonstration de quelques techniques : scores et association produits.
• Échanges avec René Lefébure et Gaël Duhamel sur vos problématiques spécifiques.

Programme de la matinée:

René Lefébure est directeur multicanal & datamining. Il met en place une offre dédiée à l’amélioration de la performance des actions marketing permettant de combiner stratégies d’acquisition et fidélisation autour de la valeur client et des systèmes d’éxécution de mesure des campagnes.

> voir son blog

Gaël Duhamel intervient en tant que référent conseil dans l’expertise .net. Il conseille et accompagne techniquement les clients dans le cadre de leurs projets interactifs pour développer l’efficacité des sites e-commerce de ses clients.

> voir son blog

Musée de la piscine, Roubaix, France

• Opérations Commerciales
• Publicitaire

Ces modules sont tous horodatables. C’est à dire que vous allez pouvoir définir la date de début et date de fin d’affichage/application d’une opération commerciale ou d’une publicité.

Par défaut, le client riche Marketing, vous permets de visualiser une publicité pour vous donner une idée de son rendue:

Et là, comme la majorité de mes clients, vous allez me dire : “ok, je peux voir ma publicité, mais qu’est-ce que cela va donner sur mon site ? Comment m’assurer que le contenu et contenant soit correcte ? Et quid des opérations commerciales ?”

Si la publicité ou l’opération commerciale en question est prévue de s’afficher maintenant, il suffit d’ouvrir votre site pour voir les contenus publicitaires s’afficher et les opérations commerciales s’appliquer… ou non ! N’oubliez pas que vos contenus peuvent être soumis à condition, comme:

• la publicité ne s’affiche que sur une certaine catégorie de pages (home, produits, panier, …),
• la publicité ne s’affiche ou l’opération commerciale ne s’applique que si une caractéristique de l’utilisateur connecté remplis une condition (utilisateur est un homme ou une femme, …)
• etc, etc, … (si vous avez des questions n’hésitez pas à m’en parler )

Mais que faire lorsque vos opérations commerciales sont prévues pour dans 2 ou 3 mois ? Devez-vous attendre le jour J tout tremblant pour voir le résultat ? La réponse est non! (ouf… l’honneur est sauf).

Dans les solutions possibles, et fonction de la qualité de votre consultant Commerce Server, vous aurez comme réponse:

• “Ce n’est pas possible, Commerce Server ne sait pas gérer cela!”
  • Changez tout de suite de Consultant => Vous recherchez une expertise Commerce Server?
• “Changez la date de votre serveur et rafraîchissez votre cache pour voir le résultat” (véridique!)
  • Pratique si votre environnement de staging et sur la même machine que celui de production  
  • Oblige une intervention sur la plateforme d’hébergement par l’équipe IT
    • Pas idéal, si chaque prévisualisation demande le bien vouloir de l’IT qui en général à bien d’autres choses à faire (du moins j’espère )
    • Ne pas oubliez de revenir à la vrai date du jour…
• “Désactivez les opérations commerciales en cours puis n’activez que celles que vous souhaitez voir tout en changeant leurs dates d’application pour qu’elles s’appliquent sur le champ.”
  • Fastidieux, j’ai des clients qui ont quasi cent publicités à afficher et bien souvent autant d’opérations commerciales (voir plus)…
  • Risque de confusion sur les activations ou désactivations
    • Toutes celles désactivées sont-elles à réactiver? Ou comment oublier facilement celles activées…
  • Risque d’erreur en changeant les dates pour les remettre sur la période souhaitée
  • Certains diront qu’un petit développement custom pourrait très bien activé/désactivé une liste de publicité/opération commerciale et changer les dates d’application. Cela est vrai mais ça reste quand même un peu bancal…
• “Pas de soucis, nous avons la solution!”… et maintenant grâce à cet article nos précédents “experts” ont la solution grâce à la suite de ce post

La solution est en fait très simple. Lors du premier chargement de l’application web, le runtime de Commerce Server va charger de nombreuses informations dans son cache et context afin d’améliorer les performances d’exécution du site.

Ce remplissage du cache se fait via 2 procédures stockées (et une autre indirectement) situées dans la base de données marketing:

• mktg_spRuntimeLoadAdvertisements
• mktg_spRuntimeLoadDiscounts
• mktg_spRuntimeLoadReferenceTables

=> Ces procédures stockées sont exécutées par le runtime à chaque démarrage du site ou rafraichissement du cache.

L’équipe produit de Commerce Server ayant très bien fait les choses, il est possible de dire au runtime de Commerce Server de charger d’autres procédures stockées que celles-ci et donc d’y inclure notre propre logique.

L’idée ici, est d’avoir une application web de prévisualisation où nous viendrons faire charger par le runtime nos propres procédures stockées et une autre application web de production ou staging avec le comportement “par défaut”.

Afin d’exécuter d’autres procédures stockées à charger par le runtime de Commerce Server, il nous faut modifier la gestion du cache via une section du fichier web.config > CommerceServer > Caches (voir MSDN: caches Element).

Dans le web.config  de notre application web de prévisualisation, nous allons donc spécifier ces configurations de caches avec ces valeurs:

<cache
    name="Advertising"
    type="Advertising" 
    refreshInterval="900" 
    retryInterval="30" 
    loaderProgId="Commerce.CSFLoadAdvertisements" 
    writerProgId="Commerce.CSFWriteEvents">
    <config
        key="LoadAdvertisementsProcedure" 
        value="spGael_staging_mktg_spRuntimeLoadAdvertisements" />
</cache>
<cache
    name="Discounts" 
    type="Discounts" 
    refreshInterval="0" 
    retryInterval="30" 
    loaderProgId="Commerce.CSFLoadDiscounts" 
    writerProgId="Commerce.CSFWriteEvents">
    <config 
        key="LoadDiscountsProcedure" 
        value="spGael_staging_mktg_spRuntimeLoadDiscounts" />
</cache>

Comme les différents composants de pipeline prennent tous comme axe de calcul la date et l’heure du moment de l’appel, vouloir changer cela reviendrait à en redévelopper l’intégralité… Fastidieux et risqué, surtout que pour beaucoup, les pipelines sont une espèce de boite noire qu’il ne faut pas toucher…

Afin de contourner cela, l’idée est de faire venir le futur à nous en calculant le nombre de jours qui nous sépare de la date de prévisualisation et de le retrancher à l’ensemble de nos dates de début et date de fin!

Reprenons la procédure stockée “mktg_spRuntimeLoadAdvertisements” qui charge les publicités actives dans le time frame du jour:

On se rend compte que l’on récupère l’ensemble des publicités  applicable à la date du 8 juillet 2010. Pour ma démonstration, j’ai créé une bannière publicitaire qui s’appliquera du 01/08/2010 au 31/08/2010:

En exécutant de nouveau ma procédure stockée mktg_spRuntimeLoadAdvertisements, j’obtiens les même résultats que précédemment. Etonnant? Non, puisque ma nouvelle publicité n’est pas éligible !Sa  date de début est au 1er août et nous sommes le 8 juillet 2010:

Comme expliqué précédemment, nous allons reprendre la procédure stockée précedente (“mktg_spRuntimeLoadAdvertisements”) pour en créer une nouvelle, que nous appellerons “spGael_staging_mktg_spRuntimeLoadAdvertisements”. Dans cette procédure, nous allons changer les dates de début et date de fin en retranchant le nombre de jour qui sépare la date de prévisualisation à celle d’aujourd’hui.

Vous noterez au passage que la date de prévisualisation est stockée dans une table appelée altima_doPreview qui ne contient qu’une seule colonne et une seule ligne.

Sur l’exécution de ma procédure stockée, j’obtiens ici qu’un seul résultat, puisque seule ma publicité est valide à la date du 15 août 2010:

Dans ce résultat, nous constatons bien que la date de début de ma publicité a basculé au 25 juin 2010 et la date de fin au 25 juillet 2010. En effet, 37 jours séparent le 08 juillet 2010 (date du jour) au 15 août 2010 (date de la prévisualisation). Soit sur ma publicité :

• Date de début: 1er août 2010 – 37 jours => 25 juin 2010
• Date de fin:, 31 août 2010 – 37 jours => 25 juillet 2010

Lançons maintenant notre application web de preview (n’oubliez pas de mettre à jour le web.config comme spécifié précédemment), et miracle…

Mon application “normale” affiche bien quant à elle, les publicités actives et applicables du moment

Pour terminer, je vous livre ci-dessous la procédure stockée qui vous chargera vos opérations commerciales en mode preview:

A vous maintenant la prévisualisation !

Me revoilà donc une nouvelle fois MVP et je profite de l’occasion pour remercier:

• mes collègues d’Altima qui travaillent de façon acharnés avec moi pour offrir des solutions Commerce Server de plus en plus performantes;
• mes clients qui nous font confiances et font du même coup le succès de Commerce Server en le plaçant ainsi dans les meilleurs framework eCommerce;
• Un merci spécial aussi aux équipes Microsoft Commerce Server pour cette confiance;