{"type":"doc","content":[{"type":"paragraph","content":[{"text":"First, learn about criteria at ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://pricefx.atlassian.net/wiki/spaces/KB/pages/3865280714"}},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"After populating a scope with variables, the next step is to describe criteria that apply to some of them if needed.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"7"}},"macroMetadata":{"macroId":{"value":"34e67d42f20c394e049850e37bcdae12"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"1bdad524-22a5-4239-9a33-a59f978c2d35"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"General Rules","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A criterion declared in the ","type":"text"},{"text":"criteria","type":"text","marks":[{"type":"code"}]},{"text":" section of one scope is instantiated for each set of coordinates within the scope. Their names act as keys for coordinates inside their space, thus ","type":"text"},{"text":"two criteria at the same coordinates cannot share the same name","type":"text","marks":[{"type":"strong"}]},{"text":". This means two mutually exclusive scopes can define the same criterion in two different ways. An example with variables is given in ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://pricefx.atlassian.net/wiki/spaces/KB/pages/3867312401"}},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Every parameter can either be set directly inline or through data.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"fedb0997-d014-47b7-bcc4-d2c68a17a13f"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the case of an ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"fedb0997-d014-47b7-bcc4-d2c68a17a13f"}}]},{"text":"inline","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"fedb0997-d014-47b7-bcc4-d2c68a17a13f"}},{"type":"em"}]},{"text":" type, the description provides a value. It is the way to provide a hard-coded value or a user-entry value.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"fedb0997-d014-47b7-bcc4-d2c68a17a13f"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the case of a ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"fedb0997-d014-47b7-bcc4-d2c68a17a13f"}}]},{"text":"data","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"fedb0997-d014-47b7-bcc4-d2c68a17a13f"}},{"type":"em"}]},{"text":" type, the description provides a field name. The instantiation will seek in the problem table corresponding to the scope, named ","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"fedb0997-d014-47b7-bcc4-d2c68a17a13f"}}]},{"text":"Problem__","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"fedb0997-d014-47b7-bcc4-d2c68a17a13f"}},{"type":"code"}]},{"text":" to get the values, which depend on the coordinates of the criteria.","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"fedb0997-d014-47b7-bcc4-d2c68a17a13f"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After (and during) an optimization run, a criterion is:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SATISFIED","type":"text","marks":[{"type":"code"}]},{"text":" if the constraint expressed by the criterion is met.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ACCEPTABLE","type":"text","marks":[{"type":"code"}]},{"text":" if it is within its acceptable margin of error.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"UNACCEPTABLE","type":"text","marks":[{"type":"code"}]},{"text":" otherwise.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can set priorities for criteria: low, medium, or high.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Higher priority unacceptable criteria","type":"text","marks":[{"type":"em"}]},{"text":" are treated first in case of conflict, but the system will always try to solve every criterion.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Criteria Types","type":"text"}]},{"type":"paragraph","content":[{"text":" There are several types of criteria, that can be sorted into two categories:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Single-Variable Criteria: sometimes called “simple criteria”. They apply to a single variable and go in the same space as said variable. They are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"target","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"lower_threshold","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"upper_threshold","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"maximization","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"minimization","type":"text","marks":[{"type":"strong"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Multi-Variable Criteria: they apply to a list of variables. They are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"alignment","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"equality","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Each criterion has its own set of parameters, but they all include the variable(s) to which the criterion applies. It is up to the person doing the configuration to make sure all the required variables are properly defined in the problem description.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Target","type":"text"}]},{"type":"paragraph","content":[{"text":"A target criterion applies to a single variable and expresses a value that this variable has to reach, within a given precision. It should be placed in the same space as its variable. Its parameters are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"on","type":"text","marks":[{"type":"code"}]},{"text":" – The variable it applies to.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"target","type":"text","marks":[{"type":"code"}]},{"text":" – The target value.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"precision","type":"text","marks":[{"type":"code"}]},{"text":" – The expected precision of the target. It should be set with ","type":"text"},{"text":"technical or domain-related limitations ","type":"text","marks":[{"type":"strong"}]},{"text":"in mind, it has nothing to do with a user being okay with a target not being exactly met.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A target to 0 with a precision of 0.1 will be considered satisfied if the value is in ","type":"text"},{"text":"]-0.1; 0.1[","type":"text","marks":[{"type":"code"}]},{"text":" (see the figure below).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Usually, we set the precision to half the smallest relevant amount of change for the variable.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"E.g. half a cent for a variable in Euros.","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"acceptable_delta","type":"text","marks":[{"type":"code"}]},{"text":" – The acceptable margin of error. It is related to the ","type":"text"},{"text":"end-users tolerance to error","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A target to 0 with an acceptable delta of 0.5 will be considered acceptable (but not satisfied) if the value is in ","type":"text"},{"text":"[-0.5,-precision[ U ]+precision, +0.5]","type":"text","marks":[{"type":"code"}]},{"text":" (see the figure below).","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"priority","type":"text","marks":[{"type":"code"}]},{"text":" – low, medium, or high.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":425,"id":"81a96fbe-70d1-4c59-8f16-7cb4e4c87257","collection":"contentId-3866755214","type":"file","height":192}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"appsplus-tabs-lite-macro","parameters":{"macroParams":{"data":{"value":"{\"theme\":\"custom\",\"features\":[\"titles\",\"active\",\"border\",\"rounded\",\"ripples\",\"fullscreen\"],\"padding\":10,\"height\":480,\"tabFont\":\"Atlassian\",\"tabSize\":15,\"tabBold\":true,\"tabItalic\":false,\"tabUnderline\":false,\"tabColor\":\"#ffffff\",\"tabColorBG\":\"#172b4d\",\"type\":\"scrollable\",\"opacity\":100,\"activeColor\":\"#ffffff\",\"activeColorBG\":\"#0052cc\",\"borderWidth\":1,\"borderColor\":\"#ebecf0\",\"radius\":5,\"hoverColor\":\"#ffffff\",\"hoverColorBG\":\"#0052cc\",\"iconSize\":\"medium\",\"iconInline\":true,\"iconPrimary\":\"#ffffff\",\"iconSecondary\":\"#172b4d\",\"separatorWidth\":1,\"separatorColor\":\"#42526E\",\"indicatorPercent\":5,\"indicatorColor\":\"#ff5630\",\"indicatorColorBG\":\"#0052cc\",\"hide\":false,\"vertical\":false,\"preload\":true,\"animate\":false,\"uuid\":\"-xZ9V6RPdk\",\"isNew\":false,\"loaded\":false,\"attachmentId\":\"att4242801174\"}"}},"macroMetadata":{"macroId":{"value":"623d4475-dba3-4c2f-a520-6ef6f9bc38fb"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://tabs.appsplus.co/confluence/img/lite.png"}}],"title":"Tabs+ Lite for Confluence"}},"localId":"142498c0-febb-4934-8817-611c329db93d"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Lower Threshold","type":"text"}]},{"type":"paragraph","content":[{"text":"A lower threshold criterion applies to a single variable and expresses a value above which this variable has to stay. It should be placed in the same space as its variable. Its parameters are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"on","type":"text","marks":[{"type":"code"}]},{"text":" – The variable it applies to.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"threshold","type":"text","marks":[{"type":"code"}]},{"text":" – The threshold value.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"acceptable_delta","type":"text","marks":[{"type":"code"}]},{"text":" – The acceptable margin of error. It is related to the end-users' tolerance to error.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A lower threshold at 0 with an acceptable delta of 0.5 will be considered acceptable (but not satisfied) if the value is in ","type":"text"},{"text":"[-0.5, 0]","type":"text","marks":[{"type":"code"}]},{"text":" (see the figure below).","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"priority","type":"text","marks":[{"type":"code"}]},{"text":" – low, medium, or high.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":425,"id":"4e5ec598-e420-4258-b073-66a252179f18","collection":"contentId-3866755214","type":"file","height":189}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"appsplus-tabs-lite-macro","parameters":{"macroParams":{"data":{"value":"{\"theme\":\"custom\",\"features\":[\"titles\",\"active\",\"border\",\"rounded\",\"ripples\",\"fullscreen\"],\"padding\":10,\"height\":400,\"tabFont\":\"Atlassian\",\"tabSize\":15,\"tabBold\":true,\"tabItalic\":false,\"tabUnderline\":false,\"tabColor\":\"#ffffff\",\"tabColorBG\":\"#172b4d\",\"type\":\"scrollable\",\"opacity\":100,\"activeColor\":\"#ffffff\",\"activeColorBG\":\"#0052cc\",\"borderWidth\":1,\"borderColor\":\"#ebecf0\",\"radius\":5,\"hoverColor\":\"#ffffff\",\"hoverColorBG\":\"#0052cc\",\"iconSize\":\"medium\",\"iconInline\":true,\"iconPrimary\":\"#ffffff\",\"iconSecondary\":\"#172b4d\",\"separatorWidth\":1,\"separatorColor\":\"#42526E\",\"indicatorPercent\":5,\"indicatorColor\":\"#ff5630\",\"indicatorColorBG\":\"#0052cc\",\"hide\":false,\"vertical\":false,\"preload\":true,\"animate\":false,\"uuid\":\"jAXrIYXS0j\",\"isNew\":false,\"loaded\":false,\"attachmentId\":\"att4245291028\"}"}},"macroMetadata":{"macroId":{"value":"b4e77abc-38b7-4e31-a207-3dcda09aa06b"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://tabs.appsplus.co/confluence/img/lite.png"}}],"title":"Tabs+ Lite for Confluence"}},"localId":"1f96e21a-a545-41e3-a449-521a3ebe7058"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upper Threshold","type":"text"}]},{"type":"paragraph","content":[{"text":"An upper threshold criterion applies to a single variable and expresses a value below which this variable has to stay. It should be placed in the same space as its variable. Its parameters are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"on","type":"text","marks":[{"type":"code"}]},{"text":" – The variable it applies to.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"threshold","type":"text","marks":[{"type":"code"}]},{"text":" – The threshold value.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"acceptable_delta","type":"text","marks":[{"type":"code"}]},{"text":" – The acceptable margin of error. It is related to the end-users' tolerance to error.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"An upper threshold at 0 with an acceptable delta of 0.5 will be considered acceptable (but not satisfied) if the value is in ","type":"text"},{"text":"[0, 0.5]","type":"text","marks":[{"type":"code"}]},{"text":" (see the figure below).","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"priority","type":"text","marks":[{"type":"code"}]},{"text":" – low, medium, or high.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":425,"id":"c8fa0f9c-c229-464d-bb7a-2434c31b70e1","collection":"contentId-3866755214","type":"file","height":188}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"appsplus-tabs-lite-macro","parameters":{"macroParams":{"data":{"value":"{\"theme\":\"custom\",\"features\":[\"titles\",\"active\",\"border\",\"rounded\",\"ripples\",\"fullscreen\"],\"padding\":10,\"height\":400,\"tabFont\":\"Atlassian\",\"tabSize\":15,\"tabBold\":true,\"tabItalic\":false,\"tabUnderline\":false,\"tabColor\":\"#ffffff\",\"tabColorBG\":\"#172b4d\",\"type\":\"scrollable\",\"opacity\":100,\"activeColor\":\"#ffffff\",\"activeColorBG\":\"#0052cc\",\"borderWidth\":1,\"borderColor\":\"#ebecf0\",\"radius\":5,\"hoverColor\":\"#ffffff\",\"hoverColorBG\":\"#0052cc\",\"iconSize\":\"medium\",\"iconInline\":true,\"iconPrimary\":\"#ffffff\",\"iconSecondary\":\"#172b4d\",\"separatorWidth\":1,\"separatorColor\":\"#42526E\",\"indicatorPercent\":5,\"indicatorColor\":\"#ff5630\",\"indicatorColorBG\":\"#0052cc\",\"hide\":false,\"vertical\":false,\"preload\":true,\"animate\":false,\"uuid\":\"6AwVajpAaS\",\"isNew\":false,\"loaded\":false,\"attachmentId\":\"att4242801194\"}"}},"macroMetadata":{"macroId":{"value":"01874d7b-27ba-4d8c-b32a-c7de279f1db7"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://tabs.appsplus.co/confluence/img/lite.png"}}],"title":"Tabs+ Lite for Confluence"}},"localId":"3d15af34-c5cc-4bd9-970d-2866b677808d"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Maximization","type":"text"}]},{"type":"paragraph","content":[{"text":"A maximization criterion applies to a single variable and expresses the need to make its value as high as possible (towards positive infinity). It should be placed in the same space as its variable. Its parameters are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"on","type":"text","marks":[{"type":"code"}]},{"text":" – The variable it applies to.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"acceptable_value","type":"text","marks":[{"type":"code"}]},{"text":" – The value above which the user considers that the criterion is acceptable. It can be a gross estimation because it has only a fringe impact on the optimization. It does not act as a threshold at all: once reached, the system will continue to try to go higher, but will lower the importance of the criterion.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"priority","type":"text","marks":[{"type":"code"}]},{"text":" – low, medium, or high.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Beware","type":"text","marks":[{"type":"strong"}]},{"text":": Nobody knows the actual global optimum and because of this a maximization can never be satisfied (see the figure below). Higher priority unacceptable criteria are treated first in the system, this is why it is ","type":"text"},{"text":"strongly advised to set a lower priority","type":"text","marks":[{"type":"em"}]},{"text":" for maximization criteria than for other criteria, except if you set an ","type":"text"},{"text":"acceptable_value","type":"text","marks":[{"type":"code"}]},{"text":" low enough to be sure it can be reached without impeding the other criteria too much.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":425,"id":"59aa8c2a-a8c6-4916-ba8c-ebe378bdbf61","collection":"contentId-3866755214","type":"file","height":183}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"appsplus-tabs-lite-macro","parameters":{"macroParams":{"data":{"value":"{\"theme\":\"custom\",\"features\":[\"titles\",\"active\",\"border\",\"rounded\",\"ripples\",\"fullscreen\"],\"padding\":10,\"height\":370,\"tabFont\":\"Atlassian\",\"tabSize\":15,\"tabBold\":true,\"tabItalic\":false,\"tabUnderline\":false,\"tabColor\":\"#ffffff\",\"tabColorBG\":\"#172b4d\",\"type\":\"scrollable\",\"opacity\":100,\"activeColor\":\"#ffffff\",\"activeColorBG\":\"#0052cc\",\"borderWidth\":1,\"borderColor\":\"#ebecf0\",\"radius\":5,\"hoverColor\":\"#ffffff\",\"hoverColorBG\":\"#0052cc\",\"iconSize\":\"medium\",\"iconInline\":true,\"iconPrimary\":\"#ffffff\",\"iconSecondary\":\"#172b4d\",\"separatorWidth\":1,\"separatorColor\":\"#42526E\",\"indicatorPercent\":5,\"indicatorColor\":\"#ff5630\",\"indicatorColorBG\":\"#0052cc\",\"hide\":false,\"vertical\":false,\"preload\":true,\"animate\":false,\"uuid\":\"Qr6QGBbK7R\",\"isNew\":false,\"loaded\":false,\"attachmentId\":\"att4244275299\"}"}},"macroMetadata":{"macroId":{"value":"d50c6eec-9857-4523-b611-367a708568f9"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://tabs.appsplus.co/confluence/img/lite.png"}}],"title":"Tabs+ Lite for Confluence"}},"localId":"0a1c70f1-5ec2-41da-b782-f24cc66cd4e6"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Minimization","type":"text"}]},{"type":"paragraph","content":[{"text":"A minimization criterion applies to a single variable and expresses the need to make its value as low as possible (towards negative infinity). It should be placed in the same space as its variable. Its parameters are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"on","type":"text","marks":[{"type":"code"}]},{"text":" – The variable it applies to.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"acceptable_value","type":"text","marks":[{"type":"code"}]},{"text":" – The value below which the user considers that the criterion is acceptable. It can be a gross estimation because it has only a fringe impact on the optimization. It does not act as a threshold at all: once reached, the system will continue to try to go lower, but will lower the importance of the criterion.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"priority","type":"text","marks":[{"type":"code"}]},{"text":" – low, medium, or high.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Beware","type":"text","marks":[{"type":"strong"}]},{"text":": Nobody knows the actual global optimum and because of this a minimization can never be satisfied (see the figure below). Higher priority unacceptable criteria are treated first in the system, this is why it is ","type":"text"},{"text":"strongly advised to set a lower priority","type":"text","marks":[{"type":"em"}]},{"text":" for maximization criteria than for other criteria, except if you set an ","type":"text"},{"text":"acceptable_value","type":"text","marks":[{"type":"code"}]},{"text":" low enough to be sure it can be reached without impeding the other criteria too much.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":559,"id":"f9cc84cb-4945-4faa-8dee-2a1317879b68","collection":"contentId-3866755214","type":"file","height":266}}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"appsplus-tabs-lite-macro","parameters":{"macroParams":{"data":{"value":"{\"theme\":\"custom\",\"features\":[\"titles\",\"active\",\"border\",\"rounded\",\"ripples\",\"fullscreen\"],\"padding\":10,\"height\":370,\"tabFont\":\"Atlassian\",\"tabSize\":15,\"tabBold\":true,\"tabItalic\":false,\"tabUnderline\":false,\"tabColor\":\"#ffffff\",\"tabColorBG\":\"#172b4d\",\"type\":\"scrollable\",\"opacity\":100,\"activeColor\":\"#ffffff\",\"activeColorBG\":\"#0052cc\",\"borderWidth\":1,\"borderColor\":\"#ebecf0\",\"radius\":5,\"hoverColor\":\"#ffffff\",\"hoverColorBG\":\"#0052cc\",\"iconSize\":\"medium\",\"iconInline\":true,\"iconPrimary\":\"#ffffff\",\"iconSecondary\":\"#172b4d\",\"separatorWidth\":1,\"separatorColor\":\"#42526E\",\"indicatorPercent\":5,\"indicatorColor\":\"#ff5630\",\"indicatorColorBG\":\"#0052cc\",\"hide\":false,\"vertical\":false,\"preload\":true,\"animate\":false,\"uuid\":\"AJOEiSQm7R\",\"isNew\":false,\"loaded\":false,\"attachmentId\":\"att4245192800\"}"}},"macroMetadata":{"macroId":{"value":"5b518f8a-6b6b-49fc-912a-8e676d6b6164"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://tabs.appsplus.co/confluence/img/lite.png"}}],"title":"Tabs+ Lite for Confluence"}},"localId":"e721bc9f-27e5-4de1-93e7-ecbb02b7a0ad"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Multi-Variable Criteria Rules","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"26a0","text":"⚠️","shortName":":warning:"}},{"text":" Multi-variable criteria are deprecated and will be removed from OE v5 onward.","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"A multi-variable criterion applies to a list of variables. They use the same way as computations to refer to the variables to which they apply (see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://pricefx.atlassian.net/wiki/spaces/KB/pages/3867312401"}},{"text":" to learn how to refer to variables from other spaces). For instance, If the user wants all variables of the same key to be equal, then the equality criterion should be placed in a “global” dimensionless space, using ","type":"text"},{"text":"all","type":"text","marks":[{"type":"code"}]},{"text":" as ","type":"text"},{"text":"on","type":"text","marks":[{"type":"code"}]},{"text":" type. If the user wants several variables of different keys to be equal, then the criterion should be in the same space as these variables and use ","type":"text"},{"text":"fixed","type":"text","marks":[{"type":"code"}]},{"text":" as ","type":"text"},{"text":"on","type":"text","marks":[{"type":"code"}]},{"text":" type.","type":"text"}]},{"type":"paragraph","content":[{"text":"Be aware that, in practice, a multi-variable criterion is a composite criterion: the OE will instantiate several single-variable criteria, applied on hidden computed variables. For instance, for an alignment criterion between A, B, and C, the OE creates two computed variables (A minus B, and B minus C), and applies a threshold to zero to each of them. When looking at the results, the state of a multi-variable criterion is the worst state among its single-variable criteria.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Alignment Criteria","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"26a0","text":"⚠️","shortName":":warning:"}},{"text":" Alignment criteria are deprecated and will be removed from OE v5 onward. The better solution is to explicitly describe alignments, with actual computed variables and threshold criteria, using spaces with dimensions sharing the same categories (see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://pricefx.atlassian.net/wiki/spaces/KB/pages/3867639907/Spaces+and+Scopes+Description#Spaces"}},{"text":" and ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://pricefx.atlassian.net/wiki/spaces/KB/pages/3867312401/Variables+Description#Reference-Disambiguation"}},{"text":"). ","type":"text"}]},{"type":"paragraph","content":[{"text":"For instance, a product price alignment would be described in a [reference: product, following: product] space containing: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A computed variable that is the difference between “reference product” price and “following product” price.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A threshold criteria on that difference that expresses the desired alignment between both prices.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This way it offers a lot more flexibility than using the built-in alignment criteria. ","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"text":"It is important to keep ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://pricefx.atlassian.net/wiki/spaces/KB/pages/3866755214/Criteria+Description#Multi-Variable-Criteria-Rules"}},{"text":" in mind.","type":"text"}]},{"type":"paragraph","content":[{"text":"An alignment criterion applies to several variables and expresses an order that must be respected by these variables. The general idea is “all other things being equal, please order these variables by this particular feature of theirs”. It works like this:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The alignment criterion should be placed in the Global space, i.e. a dimensionless root space.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The only exception is when different orders for different coordinates are needed: in this case, the alignment must be placed in a space whose dimensions are those differentiating the orders.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"E.g. prices by ","type":"text"},{"text":"color","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"product_category","type":"text","marks":[{"type":"code"}]},{"text":", the ","type":"text"},{"text":"color","type":"text","marks":[{"type":"code"}]},{"text":" order is ","type":"text"},{"text":"[blue, green, red]","type":"text","marks":[{"type":"code"}]},{"text":" for ","type":"text"},{"text":"product_category=shoes","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"[red, green]","type":"text","marks":[{"type":"code"}]},{"text":" for ","type":"text"},{"text":"product_category=cars","type":"text","marks":[{"type":"code"}]},{"text":", then the alignment has to be in a space with dimension ","type":"text"},{"text":"product_category","type":"text","marks":[{"type":"code"}]},{"text":" but not dimension ","type":"text"},{"text":"color","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"There are two examples below. ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The user specifies:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"how to group the variables, i.e. what other things are equal;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"how to order them within each group.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"E.g. if you group discounts by product family and order them by customer revenue in the natural order, it:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"implies that discounts are in the ","type":"text"},{"text":"[product family, customer]","type":"text","marks":[{"type":"code"}]},{"text":" space;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"means that each discount in the same product family should be ordered following the customer revenue (higher revenue, higher discount).","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Discounts in different product families are not ordered with each other.","type":"text"}]}]}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The parameters of an alignment criterion are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"on","type":"text","marks":[{"type":"code"}]},{"text":" – The variables it applies to. They can be selected using ","type":"text"},{"text":"all","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"fixed","type":"text","marks":[{"type":"code"}]},{"text":" in the same way ","type":"text"},{"text":"the inputs of computed variables are selected","type":"text","marks":[{"type":"link","attrs":{"href":"https://pricefx.atlassian.net/wiki/spaces/KB/pages/3867312401/Variables+Description#Inputs-Types"}}]},{"text":".","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"group","type":"text","marks":[{"type":"code"}]},{"text":" – Defines how to group the selected variables so each group can be ordered.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"type","type":"text","marks":[{"type":"code"}]},{"text":" – The way we decide things are equal (for grouping them); the options are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"strict","type":"text","marks":[{"type":"code"}]},{"text":" – The standard group by the operation that groups strictly equal things.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"by","type":"text","marks":[{"type":"code"}]},{"text":" – The list of dimensions or data fields to group by.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"custom","type":"text","marks":[{"type":"code"}]},{"text":" – This lets the user define for each feature how to decide if two elements are equal. It is useful to group things that are similar rather than strictly equal. It only works with doubles.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"by","type":"text","marks":[{"type":"code"}]},{"text":" – The list of dimensions or data fields to group by with instructions on how to group them.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"feature","type":"text","marks":[{"type":"code"}]},{"text":" – A dimension that is parsable to a double or a data field that contains a double.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"type","type":"text","marks":[{"type":"code"}]},{"text":" – The type of equality for this feature, either ","type":"text"},{"text":"strict","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"approximate","type":"text","marks":[{"type":"code"}]},{"text":" (strict will be used if no type is specified). In the case of ","type":"text"},{"text":"approximate","type":"text","marks":[{"type":"code"}]},{"text":", the user has to set the parameter ","type":"text"},{"text":"tolerance_as_amount","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"tolerance_as_rate","type":"text","marks":[{"type":"code"}]},{"text":" to define the approximation as needed.","type":"text"}]}]}]}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"comparator","type":"text","marks":[{"type":"code"}]},{"text":" – The comparator that defines the order.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"type","type":"text","marks":[{"type":"code"}]},{"text":" – There are three types currently available:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"inc_natural_order","type":"text","marks":[{"type":"code"}]},{"text":" – Increasing natural order over dimension or data field of any type.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"dec_natural order","type":"text","marks":[{"type":"code"}]},{"text":" – Decreasing natural order over strings dimension or data field of any type.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"explicit","type":"text","marks":[{"type":"code"}]},{"text":" – the user explicitly states the order within a list.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"E.g. if you want to order prices by their color where blue is the lowest and red is the highest, then state the following ","type":"text"},{"text":"order","type":"text","marks":[{"type":"code"}]},{"text":": ","type":"text"},{"text":"[\"blue\", \"red\"]","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This order can either be defined inline or through data in the alignment’s scope.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"By using data, you can specify partial orders with a different ","type":"text"},{"text":"min_gap","type":"text","marks":[{"type":"code"}]},{"text":" for each.","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Two other types of comparators exist but are deprecated:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"double_inc_natural_order","type":"text","marks":[{"type":"code"}]},{"text":" – Increasing natural order over string-typed dimension or data field that will be cast to double.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"double_dec_natural_order","type":"text","marks":[{"type":"code"}]},{"text":" – Decreasing natural order over string-typed dimension or data field that will be cast to double.","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"over","type":"text","marks":[{"type":"code"}]},{"text":" – The feature over which the comparator is applied. It is usually a dimension, but it can be any data field in the scope where the variables are selected.","type":"text"}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The minimum gap between two consecutive variables is required. There are two options:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"min_gap_as_amount","type":"text","marks":[{"type":"code"}]},{"text":" if the gap is expressed as a fixed amount.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"E.g. applied to ","type":"text"},{"text":"A

Browser not supported