Documentation

Ataytis BOM documentation.

Explore multi-level, multi-parent bills of materials from Parent–Child data with the Ataytis BOM Power BI visual.

Ataytis BOM

Conditional formatting

Colouring cards, rows and table columns in Ataytis BOM: quick rules, conditions, colour by value and colour scales, the built-in BOM fields, rule order and the legend.

Quick rules

The Formatting tab starts with quick rules that need no data preparation, because the visual already knows these things about every position. Each one adds an ordinary rule to the list below it, which can then be changed like any other.

Quick ruleAdds
Mark shared partsAn orange status dot on parts shared by two or more parents.
Accent assembliesA blue accent bar on assemblies.
Flag circular referencesA light red background on positions in a circular reference.
Shade by levelAn accent bar coloured on a scale from the top level down.
Colour by your first text detailA status dot in a different colour for each value, such as each status or supplier.

The last one is offered only when Details holds a text column other than the description, and is named after it, such as Colour by Supplier. The description is shown beside the part number rather than as a detail, so a table whose only detail is its description has the first four quick rules.

Three kinds of rule

RuleColours
ConditionOne colour wherever a comparison holds, such as Status is Obsolete.
Colour by valueA colour for each distinct value, taken from the report theme, with any value given a colour of your own.
Colour scaleA range between a low and a high colour, over a number. Leave the low or high value blank to take it from the data.

Adding and arranging rules

Under Rules, the buttons Condition, Colour by value and Colour scale add a rule of that kind to the end of the list. Each rule is a card headed with its number and kind, such as 1. Condition, with a switch to turn it off, arrows to move it up or down, and a button to delete it. The Formatting tab shows the number of rules beside its name.

The Formatting tab of the Ataytis BOM editor with one condition rule, Item number is screw-m6, colouring the background of both SCREW-M6 cards.
One condition rule: Field Item number, Colours Background, Apply to Whole card or row, Condition is, Value screw-m6. Both positions of SCREW-M6 are coloured, because text is compared without regard to case.

A new condition rule starts on your first text detail, or on Level when there is none, colouring the background in a pale yellow. A new colour by value rule colours the status dot, and a new colour scale shades the accent bar by level from light to dark blue.

Example: status dots by criticality

A Criticality column in Details holds High, Medium or Low for each part. Three condition rules put a coloured dot on every card and row, and the legend explains them:

  1. Add a condition rule

    Open the editor, select the Formatting tab, and under Rules select Condition.

  2. Set it to High

    Set Field to Criticality, Colours to Status dot, Apply to to Whole card or row, Condition to is and Value to High, and choose a red Colour.

  3. Add Medium and Low

    Add two more condition rules the same way, with Medium in orange and Low in green.

  4. Show the legend

    Under Legend, turn on Show legend and set Position to Top right. With Legend label left blank, each entry describes its rule, such as Criticality is High.

A Colour by value rule on Criticality does the same in one rule, with a theme colour for each value that you can change beside it. Condition rules are the better choice when only some values need a colour, or when the legend should use your own wording.

The parts of a rule

PartOptions
FieldA built-in field, or a column from Description, Quantity, Sort order, Details or Tooltips.
ColoursBackground, Accent bar, Text, Status dot.
Apply toWhole card or row, or one table column.
Conditionis, is not, contains, does not contain, starts with, >, ≥, <, ≤, between, is blank, is not blank. For a yes-or-no built-in field, is or is not, with Yes or No.
ValueThe value to compare with, or From and To for between.
Colour and Legend labelThe colour, and optional wording for the legend.

How values are compared

The value isCompared
TextWithout regard to case, so screw-m6 matches SCREW-M6. Greater than, less than and between follow alphabetical order, reading numbers inside the text as numbers, so BOLT-2 comes before BOLT-10.
A numberAs a number, so 10 is greater than 9.
A dateAs a date. Type the date to compare with, such as 2026-01-31.
Yes or noA built-in field such as Is an assembly offers Yes and No. A true or false column also accepts true, yes or 1, and false, no or 0.
BlankMatches only is blank. Every other condition is false for a blank value, including is not.

Contains, does not contain and starts with always compare as text, also without regard to case.

Built-in fields

FieldValue
Item number, DescriptionText.
LevelThe level of the position, 0 for a top-level product.
Quantity per, Extended quantityThe quantities of the position.
OccurrencesHow many places the part is used.
ComponentsHow many direct components it has.
Used by (parents)How many parents use it.
Is an assemblyYes when it has components.
Is shared by 2+ parentsYes when more than one parent uses it.
Is a circular referenceYes where a branch loops back on itself.

Which rule wins

Rules are checked in order, and the first rule to colour something wins it. Put specific rules above general ones. Rules on different parts, such as a background rule and a status dot rule, can both apply to the same position. A rule on a column that has left the visual says so and does nothing until the column returns.

Legend

SettingOptionsDefault
Show legendOn or offOff
PositionTop left, Top right, Bottom left, Bottom rightBottom left
TitleOptional wordingBlank

The legend is built from the rules, so it always matches the colours on the BOM. In Power BI's high contrast mode the host's colours replace the rules, and the legend is not shown.

Ataytis BOM cards with status dots coloured by criticality, and a legend at the top right.
Rules on a Criticality column colour the status dots, and the legend at the top right is built from them.
Conditional formatting — Ataytis BOM | AtaytisTech