Ajout de la prise en charge Management Center pour un widget Commerce Composer

• target_folder\LOBTools\WebContent\WEB-INF\src\xml\vendor\pagelayout\widgetDefinitions\UIObjectName\WidgetObjectDefinition.xml
• target_folder\LOBTools\WebContent\WEB-INF\src\xml\vendor\pagelayout\widgetDefinitions\UIObjectName\WidgetPropertiesView.xml
• target_folder\LOBTools\WebContent\WEB-INF\src\xml\vendor\pagelayout\widgetDefinitions\WidgetGroupIdentifier\WidgetGroup.xml
• target_folder\LOBTools\src\com\vendor\commerce\pagelayout\client\lobtools\properties\PageLayoutLOB_en_US.properties
• target_folder\LOBTools\src\com\vendor\commerce\pagelayout\client\lobtools\properties\PageLayoutLOB.properties

vendor

La valeur du paramètre vendor dans le fichier XML d'entrée du modèle.

UIObjectName

La valeur du paramètre UIObjectName dans le fichier XML d'entrée de modèle.

target_folder

Le dossier ou le projet que vous avez spécifié comme valeur pour le paramètre targetFolder dans le fichier XML d'entrée du modèle. Si vous n'avez pas spécifié de valeur pour le paramètre targetFolder, il s'agit du dossier ou du projet target_folder où se trouve le fichier XML d'entrée du modèle.

WidgetGroupIdentifier

La valeur de l'élément identifier dans l'élément widgetGroup du fichier XML d'entrée du modèle.

<?xml version="1.0" encoding="UTF-8"?>

<!-- The following code is created as example. Modify the generated code and add any additional required code.  -->

<Definitions>
  <WidgetObjectDefinition package="CMC/pagelayout"
1  
  definitionName="cmc/pagelayout/LayoutWidget_UIObjectName" 
2
  parentDefinition="cmc/pagelayout/BasePageLayoutPrimaryObjectDefinition"
  baseDefinition="cmc/pagelayout/BaseLayoutWidget"
3
  objectType="UIObjectName"
  gridPropertiesDefinition="plmWidgetProperties_UIObjectName"
4
    widgetDisplayGroups="Search"
5
  iconPath="/images/pagelayouts/widgetIcons/identifier.png"
6
    <CreateService baseDefinition="plmBaseCreateLayoutWidget" />
    <UpdateService baseDefinition="plmBaseUpdateLayoutWidget" />
    <Xml name="template">
      <sequence>0</sequence>
    </Xml>		
  </WidgetObjectDefinition>
</Definitions>

UIObjectName

La valeur du paramètre UIObjectName dans le fichier XML d'entrée du modèle.

identifier

La valeur du paramètre identifier dans le fichier XML d'entrée de modèle.

• 1 Le nom de la définition de votre définition d'objet widget personnalisée. Le nom par défaut est cmc/pagelayout/LayoutWidget_UIObjectName.
• 2 Les noms des définitions d'objet parent et de base. Les noms des définitions doivent être inclus pour que Management Center puisse récupérer la définition d'objet de votre widget personnalisé. La transformation JET inclut la définition cmc/pagelayout/BasePageLayoutPrimaryObjectDefinition par défaut comme valeur de la zone parentDefinition et inclut le nom de définition cmc/pagelayout/BaseLayoutWidget comme valeur par défaut pour la zone baseDefinition.
• 3 Le type d'objet widget et le nom de la définition des propriétés de votre widget personnalisé. Par défaut, le type d'objet widget est la valeur que vous définissez pour le paramètre UIObjectName dans le fichier XML d'entrée du modèle. Par défaut, gridPropertiesDefinition est cmc/pagelayout/LayoutWidget_UIObjectName..
• 4 Le ou les groupes d'affichage de widgets dans lesquels le widget est inclus.
• 5 Le chemin d'accès du fichier vers l'icône à afficher pour votre widget personnalisé dans la fenêtre Ajout de widgets dans des emplacements. Par défaut, la transformation JET définit l'icône du widget sur /images/pagelayouts/widgetIcons/identifier.png. Aucun fichier d'image réel n'est créé. Vous devez modifier la valeur pour que iconPath pointe vers un fichier d'image réel ou renommer un fichier image en identifier.png.
• 6 Les services de création et de mise à jour nécessaires pour que les utilisateurs du Centre de gestion utilisent votre widget dans l'outil Commerce Composer.

<?xml version="1.0" encoding="UTF-8"?>

<Definitions>
1
  <GridObjectProperties definitionName="cmc/pagelayout/WidgetProperties_UIObjectName">
    <dependency localName="pageLayoutResources" moduleName="cmc/pagelayout/PageLayoutResources"/>
    <dependency localName="customPageLayoutResources" moduleName="cmc/pagelayout/CustomPageLayoutResources"/>
    <PropertyPane>
2
      <PropertyGroup name="widgetProperties" collapsable="false" 
             groupTitle="${PageLayoutResources.widgetPropertiesPrompt}">
        <PropertyInputText name="${PageLayoutResources.widgetNamePrompt}" propertyName="widgetName"
        promptText="${PageLayoutResources.widgetNamePrompt}" />
        <PropertyInputText propertyName="xWidgetProp_widgetOrientation" 
          promptText="${customPageLayoutResources.widgetOrientationPrompt}" />
        <PropertyInputText propertyName="xWidgetProp_numberOfContentToDisplay" 
          promptText="${customPageLayoutResources.numberOfContentToDisplayPrompt}" />
      </PropertyGroup>
3
      <PropertyGroup name="contentProperties" collapsable="false" 
            groupTitle="${PageLayoutResources.widgetContentPrompt}">
        <PropertyStaticText text="${customPageLayoutResources.UIObjectNameContent}" />
      </PropertyGroup>
    </PropertyPane>
  </GridObjectProperties>
</Definitions>

• 1 L'élément GridObjectProperties définit la vue des propriétés pour inclure votre widget dans la table Widgets et emplacements de la présentation de l'onglet Conception de présentation dans Management Center. Cette vue des propriétés est définie comme une vue en réduction dans la table. La vue peut être ouverte et fermée en cliquant sur l'icône de triangle de chaque ligne de la table.
• 2 widgetPropeties PropertyGroup définit la section Propriétés du widget dans la vue des propriétés définie par l'élément GridObjectProperties. Les propriétés de cette section sont utilisées pour déterminer comment le widget s'affiche dans le magasin. Les utilisateurs du Centre de gestion utilisent ces propriétés pour déterminer le fournisseur d'interface utilisateur du widget lorsque les utilisateurs peuvent déterminer le style d'affichage.

  Pour obtenir des exemples de propriétés configurables que vous pouvez définir pour votre widget, examinez les propriétés configurables pour les widgets fournis par défaut avec HCL Commerce. Pour plus d'informations, consultez la rubrique Propriétés de widget Commerce Composer

  Vous pouvez définir ces propriétés à afficher aux utilisateurs dans Management Center de différentes manières. Par exemple, vous pouvez utiliser des boutons radio, des cases à cocher, des cases à combinaison, etc.

• 3 contentProperties PropertyGroup définit la section Contenu du widget dans la vue GridObjectProperties. Les utilisateurs Management Center utilisent ces propriétés pour déterminer le contenu réel du widget à afficher dans la page de magasin.

<?xml version="1.0" encoding="UTF-8"?>
<Definitions>
  <LayoutWidgetGroup package="CMC/pagelayout"
    definitionName="cmc/pagelayout/WidgetGroupIdentifierWidgetGroup"
    parentDefinition="cmc/pagelayout/NewPageLayoutWidgetDialog"
    identfider="WidgetGroupIdentifier" 
    displayName="${customPageLayoutResources.widgetGroupDisplayName_WidgetGroupIdentifier}">
  <dependency localName="customPageLayoutResources" moduleName="cmc/pagelayout/CustomPageLayoutResources"/>
  </LayoutWidgetGroup>
</Definitions>

Si vous n'avez pas spécifié l'élément widgetGroup dans le fichier XML d'entrée du modèle, vous devez créer ce fichier.

widgetGroupDisplayName_identifier=displayName

Si vous avez inclus le widget dans les groupes d'affichage de widgets, assurez-vous que votre widget s'affiche dans la liste des widgets pour les groupes d'affichage appropriés.

Si vous avez inclus le widget dans les groupes de restrictions de widgets, assurez-vous que le widget peut être inclus dans un modèle de présentation qui peut uniquement utiliser les widgets dans ce groupe de restrictions de widgets. Pour en savoir plus sur la création d'un modèle de présentation limité à un groupe de restrictions de widgets, voir Création de modèles d'agencement Commerce Composer.