> ## Documentation Index
> Fetch the complete documentation index at: https://decilia.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# FocusSpecific

> Advanced bookmark that highlights North America in the clustered bar chart with Gender = Male and Year = 2019. Behavior is state-dependent: the visible chart changes based on which bookmark was active before.

# 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

| Visual ID            | Display Name          | Type              | Group | Visibility               |
| -------------------- | --------------------- | ----------------- | ----- | ------------------------ |
| bf11a6fb91dc9f853419 | (Gender Slicer)       | slicer            | None  | Visible (filtered)       |
| 34f97140074284eaa8de | (Clustered Bar Chart) | clusteredBarChart | None  | Visible (with highlight) |

**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