Skip to main content

Bookmark: FocusSpecific

Status: Active Development - Complex Example Created: 2024 (estimated) Last Updated: 2025-12-24 Author: Alexandru BADIU

Business Purpose

This bookmark serves as a complex demonstration of advanced bookmark behaviors and illustrates:
  • How intricate bookmarks can become in real-world scenarios
  • The criticality of documenting business intent for complex interactive patterns
  • Cross-highlighting capabilities in Power BI
  • State-dependent bookmark behavior (results differ based on previous bookmark state)
Critical Insight: This bookmark demonstrates state-dependent behavior - the visual result depends on which bookmark was activated before it:
  • Navigating from “Ribon Chart”“Focus Specific” shows a different chart than
  • Navigating from “Reset Filters”“Focus Specific”
This is precisely why documenting the underlying business intent is so important - without documentation, users cannot understand these subtle but significant behaviors.

User Scenario

When to use:
  • To demonstrate advanced Power BI bookmark capabilities in training
  • To show how cross-highlighting focuses user attention on specific data points
  • To illustrate the importance of bookmark state management
  • As an example of why thorough documentation is essential for complex reports
Expected behavior:
  • Highlights North America in the Clustered Bar Chart
  • Sets Gender slicer to “Male” (exact match)
  • Maintains 2019 year filter
  • State-dependent: Chart type (Clustered vs Ribbon) depends on previous bookmark
⚠️ Important: The visual outcome is NOT deterministic without knowing the prior bookmark state!

Technical Overview

Bookmark ID: a87d1123fc3c1c928935 Parent Group: None Page: Page 4cb813ea0b6a5c8296b0

Settings

  • Data: Yes - Stores filter states and highlight selection
  • Display: No suppression - Captures full data state
  • Current Page: Yes - Maintains active page state
  • Scope: Selected Visuals - Targets 2 specific visuals

Affected Visuals

Notable: This bookmark does NOT control the visibility of visual ed774ceec96dd040ac19 (Ribbon Chart), which means:
  • If Ribbon Chart was visible before, it may remain visible
  • This creates state-dependent behavior based on previous bookmark

Filter States

Report-Level Filters

  • Date[Year]: Categorical = 2019

Visual-Level Filters and Highlights

Visual 34f97140074284eaa8de (Clustered Bar Chart):
  • Customer[Continent]: Categorical filter
  • Customer[Country]: Categorical filter
  • Sales[Sales]: Advanced filter
  • Sales[Sales PY]: Advanced filter
  • Highlight Applied: North America (Customer.Continent = ‘North America’)
  • Highlight Context: Applied to Sales.Sales PY measure
  • Order By: Sales[Sales] (Descending)
Visual bf11a6fb91dc9f853419 (Gender Slicer):
  • Customer[Gender]: In [‘Male’] (exact match, not “Contains”)
  • Slicer Mode: Basic
Additional Visuals in Exploration State:
  • a5dbb271c8b93debaa5e - Bookmark Navigator
  • 621534302dec46c4557a - Age Slicer (Dropdown mode)
  • a4a1181b341466474c49 - Scatter Chart (Margin vs Sales by City)
  • ed774ceec96dd040ac19 - Ribbon Chart (state depends on previous bookmark)

Behavior Description

When this bookmark is activated:
  1. North America is highlighted in the Clustered Bar Chart:
    • All continents remain visible but dimmed
    • North America is emphasized/highlighted
    • The highlight is applied in the context of the Sales PY measure
    • Users can see North America’s performance relative to other regions
  2. Gender slicer is set to exact match “Male” (different from other bookmarks that use “Contains ‘Ma’”)
  3. Year filter is maintained at 2019
  4. State-Dependent Chart Visibility:
    • If coming from “Clustered Chart” bookmark → Clustered Bar Chart visible, Ribbon hidden
    • If coming from “Ribon Chart” bookmark → Both charts may be visible, or different state
    • This creates different user experiences depending on navigation path
  5. Multiple other visuals are present in the state (scatter chart, age slicer, bookmark navigator) indicating this captures a fuller page state than the toggle bookmarks

Important Notes

⚠️ Key Behaviors:
  • NO Data Suppression: Unlike Ribon/Clustered bookmarks, this does NOT have suppressData: true, meaning it captures the full data state at bookmark creation time
  • Cross-Highlighting: This uses Power BI’s highlight feature (not filter) - all continents remain in the visual but North America is emphasized
  • State-Dependent Outcome: The actual visual result depends on which bookmark was active before this one - this is a critical complexity!
  • Gender Filter Difference: Uses exact match In ['Male'] instead of Contains 'Ma' like other bookmarks
  • Broader Scope: This bookmark captures state for more visuals (scatter chart, age slicer) than the toggle bookmarks
  • Highlight vs Filter: Highlighting keeps all data visible but emphasizes one element; filtering removes data entirely
🎯 Documentation Importance: This bookmark perfectly demonstrates why business intent documentation is critical:
  • Without documentation, users cannot know that results vary by navigation path
  • The technical JSON alone doesn’t reveal the state-dependency
  • Testing and understanding requires knowing the intended behavior

Dependencies

Model Measures:
  • Sales[Sales] - Current year sales measure
  • Sales[Sales PY] - Prior year sales measure (used in highlight context)
Model Dimensions:
  • Customer[Continent] - Used for highlighting North America
  • Customer[Gender] - Filtered to Male
  • Customer[Age] - Available in age slicer
  • Customer[City] - Used in scatter chart
Other Bookmarks:
  • Ribon Chart (3c04be006f1ebff4ddc5) - Different state when navigating from here
  • Clustered Chart (5977e1c788aabf285a32) - Different state when navigating from here
  • Reset Filters (77f6391b96f7c17022ed) - Another navigation path with different results
Visual References:
  • Clustered Bar Chart (34f97140074284eaa8de) - Primary target with highlight
  • Gender Slicer (bf11a6fb91dc9f853419) - Filtered to Male
  • Ribbon Chart (ed774ceec96dd040ac19) - State-dependent visibility
  • Scatter Chart (a4a1181b341466474c49) - Present in exploration state
  • Age Slicer (621534302dec46c4557a) - Present in exploration state
  • Bookmark Navigator (a5dbb271c8b93debaa5e) - Present in exploration state

Maintenance Notes

Performance Considerations:
  • Highlighting is generally more performant than filtering as it doesn’t require data re-aggregation
  • The broader state capture (multiple visuals) may make this bookmark slightly heavier than simple toggles
Known Limitations:
  • State-dependent behavior can confuse users if not documented and trained
  • Users may get different results and think the bookmark is “broken” when it’s actually working as designed
  • The bookmark does not explicitly control Ribbon Chart visibility, creating ambiguity
Testing Notes: When making changes, verify ALL navigation paths:
  1. From Reset Filters → Focus Specific: Document the visual state
  2. From Ribon Chart → Focus Specific: Document the visual state (likely different!)
  3. From Clustered Chart → Focus Specific: Document the visual state
  4. Verify North America highlight appears correctly in clustered bar chart
  5. Verify Gender slicer shows exact “Male” selection
  6. Verify Year=2019 filter is applied
  7. Test that highlight (not filter) is used - all continents should remain visible
  8. Confirm scatter chart, age slicer, and bookmark navigator are in expected states
Critical Testing: Always test this bookmark from multiple starting states to ensure state-dependent behavior is understood and documented.

Why This Bookmark Is Complex

This bookmark exemplifies complexity in several ways:
  1. State Dependency: Results vary based on navigation path - rare and confusing behavior
  2. Highlight vs Filter: Uses advanced cross-highlighting instead of simple filtering
  3. Partial Scope: Doesn’t control all relevant visuals, creating ambiguity
  4. Broader Context: Captures more page state than simple toggle bookmarks
  5. Filter Type Difference: Uses different Gender filter logic than other bookmarks
  6. No Data Suppression: Captures full state instead of just display properties
Educational Value: This bookmark is an excellent example of why documentation is not optional for production reports. Without it, maintenance becomes nearly impossible.

Change History

  • 2025-12-24: Initial documentation created with emphasis on state-dependent behavior and complexity analysis