{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"paragraph","content":[{"text":"When customizing Sana, often it is necessary to have slightly more information coming from ERP-System or maybe from the Add-On. The following sections will describe some extra information that can come from the Perfion AddOn that might be useful when customizing Sana.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Decorating Fields using attributes","type":"text"}]},{"type":"paragraph","content":[{"text":"In Sana a Field has a value. We saw how a Field could come from various sources, but it all ends up with something like this being output to Sana:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"The above example is taken from Table 8.","type":"text"}]},{"type":"paragraph","content":[{"text":"Now suppose that we have some extra information attached to that information, that this machine can brew up to 4 cups. Let us say that some machines brew bigger cups than others as suggested in below:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":353,"id":"c15c4d61-a390-4d7e-85d4-679a43ac9c93","collection":"contentId-244338639","type":"file","height":97}},{"type":"caption","content":[{"text":"Figure 1: Here we have added a cup size that contains the size of the cups brewed","type":"text"}]}]},{"type":"paragraph","content":[{"text":"This information can, of course, be parsed to Sana as another field:","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"That would just work as expected.","type":"text"}]},{"type":"paragraph","content":[{"text":"In some cases, however, you are not after yet another field to display on the Sana-site, but rather after some customization made on the Sana-side. Therefore, you are after some way of passing the information to Sana, without creating another field.","type":"text"}]},{"type":"paragraph","content":[{"text":"This extra-information can be utilized on Sana for various options, which are unknown for us here at Perfion.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the 3.0 connector, you can achieve that passing of data by passing an attribute to the field-element as shown in Table 1:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"55e8fb28-c677-422a-a6b4-7947f1f3cbaf"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":3,"background":"#a6a6a6","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Attributes","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"What can be output","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Supports","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Supported Entities","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"a Features","type":"text"}]},{"type":"paragraph","content":[{"text":"a Attributes","type":"text"}]},{"type":"paragraph","content":[{"text":"a Literals","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"r Multi value features","type":"text"}]},{"type":"paragraph","content":[{"text":"a Localizable features (See note)","type":"text"}]},{"type":"paragraph","content":[{"text":"r Merging of features","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"a ProductCategory","type":"text"}]},{"type":"paragraph","content":[{"text":"a Product","type":"text"}]},{"type":"paragraph","content":[{"text":"a Variant","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":3,"background":"#d9d9d9","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Sample Data","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":3,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":353,"id":"17ede68f-9e7c-49bf-acb7-9fc1aad6355f","collection":"contentId-244338639","type":"file","height":54}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":3,"background":"#d9d9d9","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Sample Mapping","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":3,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":66.0},"content":[{"type":"media","attrs":{"width":457,"id":"d699f2ed-8762-44c1-b38a-dc58c248be41","collection":"contentId-244338639","type":"file","height":81}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":3,"background":"#d9d9d9","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Sample output","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":3,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"\n \n 1\n \n \n\n\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Table 1: Using Output Kind Attribute to decorate field-elements with extra-information.","type":"text"}]},{"type":"paragraph","content":[{"text":"As can be seen from Table 1, we first use Output Kind ","type":"text"},{"text":"Attribute","type":"text","marks":[{"type":"em"}]},{"text":" to output the value of the feature ","type":"text"},{"text":"CupSize","type":"text","marks":[{"type":"em"}]},{"text":" to the attribute ","type":"text"},{"text":"size","type":"text","marks":[{"type":"em"}]},{"text":" on the field ","type":"text"},{"text":"NoOfCups","type":"text","marks":[{"type":"em"}]},{"text":". Indeed the result is that the field-element for ","type":"text"},{"text":"Perfion__NoOfCups","type":"text","marks":[{"type":"em"}]},{"text":" is added a ","type":"text"},{"text":"size","type":"text","marks":[{"type":"em"}]},{"text":"-attribute being given the value ","type":"text"},{"text":"Medium","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The next example is utilizing a feature introduced in Perfion 4.5 2019 R2, namely being able to output an attribute on a feature. In the example, we output the ","type":"text"},{"text":"unit","type":"text","marks":[{"type":"em"}]},{"text":"-attribute from the ","type":"text"},{"text":"VolumeL","type":"text","marks":[{"type":"em"}]},{"text":"-feature as an attribute named ","type":"text"},{"text":"unit","type":"text","marks":[{"type":"em"}]},{"text":" on the ","type":"text"},{"text":"Volume","type":"text","marks":[{"type":"em"}]},{"text":"-Field. Indeed we get a unit containing an “l” (small letter L), which is the abbreviation for liter and is the unit for the ","type":"text"},{"text":"VolumeL","type":"text","marks":[{"type":"em"}]},{"text":"-feature. All attributes on Feature-elements from the Perfion API result can be output using this. See ","type":"text"},{"text":"Perfion API-manual","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PIM/pages/244330744"}}]},{"text":" on which attributes you can output in addition to ","type":"text"},{"text":"unit","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Important:","type":"text","marks":[{"type":"strong"}]},{"text":" The above example combines the non-localizable feature ","type":"text"},{"text":"VolumeL ","type":"text","marks":[{"type":"em"}]},{"text":"with the localizable attribute ","type":"text"},{"text":"unit","type":"text","marks":[{"type":"em"}]},{"text":". This is generally ","type":"text"},{"text":"not","type":"text","marks":[{"type":"em"}]},{"text":" a good idea, since you only get the unit output in the default language (here English). The best solution is to make the ","type":"text"},{"text":"VolumeL","type":"text","marks":[{"type":"em"}]},{"text":"-feature localizable, meaning that you need to type the same value into that feature for all languages. As a rule: All data involved should all be either localizable or not localizable. Note that that unit on a feature is localizable, whether or not the feature is it or not. Combining localizable data with non-localizable data may not give the wanted result (above you only get the English unit, not the unit in other languages). The ECommerce API-manual will give you more information on how such data is output in case you combine localizable data with a non-localizable data.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"In Table 1, we have made an explicit mapping of both ","type":"text"},{"text":"NoOfCups","type":"text","marks":[{"type":"em"}]},{"text":"- and ","type":"text"},{"text":"VolumeL","type":"text","marks":[{"type":"em"}]},{"text":"-features. This is not necessary for decorating it with one or more attributes. Fields made using the wild card mapping work just as well.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Grouping information in GetEntityFields","type":"text"}]},{"type":"paragraph","content":[{"text":"This feature requires Connector 3.0.1 and Perfion 4.5 2019 R2","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Using the Sana Standard there is no way to pass groups of fields and have Sana react on that. A field is simply a Field.","type":"text"}]},{"type":"paragraph","content":[{"text":"The Perfion connector, however, add some more information to this call that can be utilized when customizing Sana.","type":"text"}]},{"type":"paragraph","content":[{"text":"In Perfion, two constructs help group features:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"View: A feature can be in 0 (zero) or more views. Perfion has 14 such views.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A feature can be in a Top View Group and/or in a View Group (and in an Information Group which cannot be sent to Sana). Perfion allows any number of groups to be created.","type":"text"}]}]}]},{"type":"table","attrs":{"layout":"default","localId":"e7180ef5-3f56-4c1a-8702-faabce3f35f1"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":"Sample Groups","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":525,"id":"4911e84b-7a2c-41a6-9d0f-bc9441ff78c6","collection":"contentId-244338639","type":"file","height":374}}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":525,"id":"5711af08-4d3e-4b51-9c02-1f963c5672d7","collection":"contentId-244338639","type":"file","height":372}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":"Sample Feature","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":558,"id":"9d45fb6e-b75f-4015-bdcd-1cd4b69fc539","collection":"contentId-244338639","type":"file","height":737}}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":"Sample output","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[869.0]},"content":[{"type":"codeBlock","content":[{"text":"\n\n \n \n ...\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n ...\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Table 2 shows the Feature ","type":"text"},{"text":"Manufacturer","type":"text","marks":[{"type":"em"}]},{"text":", which Views it is assigned to in the configuration of Product, and which Groups it is assigned to. Finally it shows how all this is output for the feature as part of the result of a GetEntityFields-call.","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"3a8cf931-eff2-4f29-89d9-806b2824446c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#a6a6a6","rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":"GetEntityFields","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":"Sample Views","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":83.0},"content":[{"type":"media","attrs":{"width":667,"id":"19c2c858-72c9-45ba-9765-dd2c4b80c016","collection":"contentId-244338639","type":"file","height":292}}]},{"type":"paragraph"}]}]}]},{"type":"table","attrs":{"layout":"default","localId":"6def01e8-6ce0-42cd-a594-be022785eeaf"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":"Sample Groups","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":66.0},"content":[{"type":"media","attrs":{"width":479,"id":"5824c31d-fd9b-4cba-a6fc-55703fd5caa6","collection":"contentId-244338639","type":"file","height":204}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":66.0},"content":[{"type":"media","attrs":{"width":477,"id":"1857ddd8-1885-4690-8e2e-d984393d516f","collection":"contentId-244338639","type":"file","height":205}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":"Sample Feature","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":558,"id":"9d45fb6e-b75f-4015-bdcd-1cd4b69fc539","collection":"contentId-244338639","type":"file","height":737}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"#d9d9d9","rowspan":1,"colwidth":[869.0]},"content":[{"type":"paragraph","content":[{"text":"Sample output","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[869.0]},"content":[{"type":"codeBlock","content":[{"text":"\n\n \n \n ...\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n ...\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Table 2: GetEntityFields-method returns information on Views and Groups from Perfion.","type":"text"}]},{"type":"paragraph","content":[{"text":"As can be seen in the Sample Views, we have multiple Top View Groups and View Groups. They can be considered groups and subgroups, respectively and are output as such. In addition, we see that the feature ","type":"text"},{"text":"CountryOfOrigin","type":"text","marks":[{"type":"em"}]},{"text":" is assigned the Top View Group ","type":"text"},{"text":"Marketing","type":"text","marks":[{"type":"em"}]},{"text":" and the View Group ","type":"text"},{"text":"Origin","type":"text","marks":[{"type":"em"}]},{"text":". In the output we see that the field ","type":"text"},{"text":"Perfion__GroupId","type":"text","marks":[{"type":"em"}]},{"text":" is assigned its unique id and that we for each lcid outputs its captions in fields named ","type":"text"},{"text":"Perfion__GroupCaption","type":"text","marks":[{"type":"em"}]},{"text":". Same goes for the View Group which is called a sub group.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that it is possible for a feature to have a Subgroup without having a group.","type":"text"}]},{"type":"paragraph","content":[{"text":"The views are different. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Table 2 that the ","type":"text"},{"text":"CountryOfOrigin","type":"text","marks":[{"type":"em"}]},{"text":"-feature in the Products-configuration is assigned to the views ","type":"text"},{"text":"Item","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Variant","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"WebDetail","type":"text","marks":[{"type":"em"}]},{"text":". These names are fixed in Perfion and in the Sana result output exactly these names in a comma-separated list in the field ","type":"text"},{"text":"Perfion__Views","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"One use in Sana of these fields could be to use two views to decide whether a Field is on the list- and detail-pages, respectively. The Views ","type":"text"},{"text":"WebList","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"WebDetail","type":"text","marks":[{"type":"em"}]},{"text":" seem obvious choices for two such views, although any two views would work.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"NOTE:","type":"text","marks":[{"type":"strong"}]},{"text":" See the ","type":"text"},{"text":"ECommerce-Manual","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/PIM/pages/244331086"}}]},{"text":" to see the exact names of all 14 available views.","type":"text"}]}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"b1abb25f-5e39-478a-b611-9f46437da263"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"5cc75179-2c6f-46f2-b8e4-0141c042f289"}}]}]}],"version":1}