{
    "api_version": "1",
    "kind": "dse_post",
    "self": "https://update.dsesecurity.com/api/v1/posts/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/",
    "item": {
        "id": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/",
        "slug": "dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice",
        "url": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/",
        "alternate_urls": {
            "markdown": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice.md",
            "json": "https://update.dsesecurity.com/api/v1/posts/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/"
        },
        "title": "Understand why a workbook refresh preserves the reader's dropdown choice",
        "summary": "Why does returning a new default from a workbook parameter query not replace the user's current selection?",
        "format": {
            "slug": "explainer",
            "name": "Explainer"
        },
        "priority": {
            "slug": "info",
            "name": "Information"
        },
        "featured": false,
        "image": {
            "theme": "physical-security",
            "label": "Physical security",
            "alt": "Integrated video surveillance and controlled entry at a modern commercial facility.",
            "card_url": "https://update.dsesecurity.com/assets/editorial/physical-security-card.webp?v=1.8.20",
            "hero_url": "https://update.dsesecurity.com/assets/editorial/physical-security-hero.webp?v=1.8.20",
            "social_url": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20",
            "width": 2400,
            "height": 1350
        },
        "topics": [
            {
                "slug": "it",
                "name": "IT",
                "url": "https://update.dsesecurity.com/topic/it/"
            }
        ],
        "author": {
            "name": "DSE Security Editorial Team",
            "url": "https://update.dsesecurity.com/#editorial-team",
            "type": "Organization"
        },
        "publisher": {
            "name": "Detection Systems & Engineering",
            "url": "https://dsesecurity.com/"
        },
        "published_at": "2026-09-10T00:25:42+00:00",
        "modified_at": "2026-09-10T02:01:56+00:00",
        "reviewed_on": "2026-09-09",
        "reading_minutes": 2,
        "word_count": 247,
        "potentially_affected": "Azure Monitor Workbooks using query-backed dropdown parameters.",
        "dse_recommendation": "Test initial defaults, user selections and disappearing values as separate dropdown states.",
        "primary_source": {
            "name": "Azure Monitor workbook dropdown parameters - Azure Monitor | Microsoft Learn",
            "url": "https://learn.microsoft.com/en-us/azure/azure-monitor/visualize/workbooks-dropdowns",
            "published_on": null,
            "authority": "Microsoft Learn"
        },
        "publishing_principles": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/",
        "usage_info": "https://update.dsesecurity.com/usage/",
        "copyright_notice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.",
        "content_html": "<h2>Source facts</h2>\n<p>A workbook dropdown&#8217;s default-selection field controls initial selection, not an override of later user choices. Once the user chooses values, a subsequent parameter query does not replace them with its new defaults. Default Items reruns the query and applies the defaults again. <a href=\"https://learn.microsoft.com/en-us/azure/azure-monitor/visualize/workbooks-dropdowns\" target=\"_blank\" rel=\"noopener noreferrer\">Microsoft Learn</a>.</p>\n<p>If refreshed results omit a previously selected value, that value is removed: selection becomes the intersection of the old selection and new results. The default-selection field is interpreted by its third-column position, and values such as false, zero, null or an empty string mean not selected. <a href=\"https://learn.microsoft.com/en-us/azure/azure-monitor/visualize/workbooks-dropdowns\" target=\"_blank\" rel=\"noopener noreferrer\">Microsoft Learn</a>.</p>\n<h2>Applicability</h2>\n<p>Review Azure Monitor Workbooks using query-backed dropdown parameters. This behavior concerns the parameter&#8217;s selected values, not the freshness of every chart or a pinned dashboard&#8217;s saved configuration.</p>\n<h2>DSE recommendation</h2>\n<p>DSE recommends defining the intended reader experience for first load, refresh and return to defaults before modifying the parameter query. Do not treat a persisted user choice as evidence that the new query failed. If the returned item set changes, decide how downstream visuals should respond to a smaller or empty selection. Make the default-reset action discoverable in the workbook&#8217;s instructions.</p>\n<h2>Verification</h2>\n<p>Start with no user selection and confirm the default. Choose another value, change the query&#8217;s defaults in an approved test, and refresh. Then remove one chosen item from the returned list and inspect the remaining selection. Finally use Default Items and confirm the newly queried default. Record these states alongside the query column order.</p>\n<h2>Official references</h2>\n<p><a href=\"https://learn.microsoft.com/en-us/azure/azure-monitor/visualize/workbooks-dropdowns\" target=\"_blank\" rel=\"noopener noreferrer\">Microsoft Learn: Workbook dropdown parameters</a>.</p>",
        "content_text": "Source facts\nA workbook dropdown’s default-selection field controls initial selection, not an override of later user choices. Once the user chooses values, a subsequent parameter query does not replace them with its new defaults. Default Items reruns the query and applies the defaults again. Microsoft Learn.\nIf refreshed results omit a previously selected value, that value is removed: selection becomes the intersection of the old selection and new results. The default-selection field is interpreted by its third-column position, and values such as false, zero, null or an empty string mean not selected. Microsoft Learn.\nApplicability\nReview Azure Monitor Workbooks using query-backed dropdown parameters. This behavior concerns the parameter’s selected values, not the freshness of every chart or a pinned dashboard’s saved configuration.\nDSE recommendation\nDSE recommends defining the intended reader experience for first load, refresh and return to defaults before modifying the parameter query. Do not treat a persisted user choice as evidence that the new query failed. If the returned item set changes, decide how downstream visuals should respond to a smaller or empty selection. Make the default-reset action discoverable in the workbook’s instructions.\nVerification\nStart with no user selection and confirm the default. Choose another value, change the query’s defaults in an approved test, and refresh. Then remove one chosen item from the returned list and inspect the remaining selection. Finally use Default Items and confirm the newly queried default. Record these states alongside the query column order.\nOfficial references\nMicrosoft Learn: Workbook dropdown parameters.",
        "content_markdown": "## Source facts\n\nA workbook dropdown’s default-selection field controls initial selection, not an override of later user choices. Once the user chooses values, a subsequent parameter query does not replace them with its new defaults. Default Items reruns the query and applies the defaults again. [Microsoft Learn](https://learn.microsoft.com/en-us/azure/azure-monitor/visualize/workbooks-dropdowns).\n\nIf refreshed results omit a previously selected value, that value is removed: selection becomes the intersection of the old selection and new results. The default-selection field is interpreted by its third-column position, and values such as false, zero, null or an empty string mean not selected. [Microsoft Learn](https://learn.microsoft.com/en-us/azure/azure-monitor/visualize/workbooks-dropdowns).\n\n## Applicability\n\nReview Azure Monitor Workbooks using query-backed dropdown parameters. This behavior concerns the parameter’s selected values, not the freshness of every chart or a pinned dashboard’s saved configuration.\n\n## DSE recommendation\n\nDSE recommends defining the intended reader experience for first load, refresh and return to defaults before modifying the parameter query. Do not treat a persisted user choice as evidence that the new query failed. If the returned item set changes, decide how downstream visuals should respond to a smaller or empty selection. Make the default-reset action discoverable in the workbook’s instructions.\n\n## Verification\n\nStart with no user selection and confirm the default. Choose another value, change the query’s defaults in an approved test, and refresh. Then remove one chosen item from the returned list and inspect the remaining selection. Finally use Default Items and confirm the newly queried default. Record these states alongside the query column order.\n\n## Official references\n\n[Microsoft Learn: Workbook dropdown parameters](https://learn.microsoft.com/en-us/azure/azure-monitor/visualize/workbooks-dropdowns)."
    },
    "json_ld": {
        "@context": "https://schema.org",
        "@graph": [
            {
                "@type": "Organization",
                "@id": "https://dsesecurity.com/#organization",
                "name": "Detection Systems & Engineering",
                "alternateName": "DSE Security",
                "url": "https://dsesecurity.com/",
                "logo": {
                    "@type": "ImageObject",
                    "url": "https://update.dsesecurity.com/assets/dse-logo-20260812.png?v=1.8.20"
                }
            },
            {
                "@type": "Organization",
                "@id": "https://update.dsesecurity.com/#editorial-team",
                "name": "DSE Security Editorial Team",
                "url": "https://update.dsesecurity.com/",
                "parentOrganization": {
                    "@id": "https://dsesecurity.com/#organization"
                }
            },
            {
                "@type": "WebSite",
                "@id": "https://update.dsesecurity.com/#website",
                "name": "DSE Updates",
                "alternateName": "DSE Security Knowledge Hub",
                "url": "https://update.dsesecurity.com/",
                "inLanguage": "en-US",
                "publisher": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "potentialAction": {
                    "@type": "SearchAction",
                    "target": {
                        "@type": "EntryPoint",
                        "urlTemplate": "https://update.dsesecurity.com/?q={search_term_string}"
                    },
                    "query-input": "required name=search_term_string"
                }
            },
            {
                "@type": "WebPage",
                "@id": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/",
                "url": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/",
                "isPartOf": {
                    "@id": "https://update.dsesecurity.com/#website"
                },
                "lastReviewed": "2026-09-09"
            },
            {
                "@type": "BreadcrumbList",
                "@id": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/#breadcrumbs",
                "itemListElement": [
                    {
                        "@type": "ListItem",
                        "position": 1,
                        "name": "DSE Updates",
                        "item": "https://update.dsesecurity.com/"
                    },
                    {
                        "@type": "ListItem",
                        "position": 2,
                        "name": "Understand why a workbook refresh preserves the reader's dropdown choice",
                        "item": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/"
                    }
                ]
            },
            {
                "@type": [
                    "Article",
                    "TechArticle"
                ],
                "@id": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/#article",
                "identifier": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/",
                "url": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/",
                "headline": "Understand why a workbook refresh preserves the reader's dropdown choice",
                "description": "Why does returning a new default from a workbook parameter query not replace the user's current selection?",
                "abstract": "Why does returning a new default from a workbook parameter query not replace the user's current selection?",
                "articleBody": "Source facts\nA workbook dropdown’s default-selection field controls initial selection, not an override of later user choices. Once the user chooses values, a subsequent parameter query does not replace them with its new defaults. Default Items reruns the query and applies the defaults again. Microsoft Learn.\nIf refreshed results omit a previously selected value, that value is removed: selection becomes the intersection of the old selection and new results. The default-selection field is interpreted by its third-column position, and values such as false, zero, null or an empty string mean not selected. Microsoft Learn.\nApplicability\nReview Azure Monitor Workbooks using query-backed dropdown parameters. This behavior concerns the parameter’s selected values, not the freshness of every chart or a pinned dashboard’s saved configuration.\nDSE recommendation\nDSE recommends defining the intended reader experience for first load, refresh and return to defaults before modifying the parameter query. Do not treat a persisted user choice as evidence that the new query failed. If the returned item set changes, decide how downstream visuals should respond to a smaller or empty selection. Make the default-reset action discoverable in the workbook’s instructions.\nVerification\nStart with no user selection and confirm the default. Choose another value, change the query’s defaults in an approved test, and refresh. Then remove one chosen item from the returned list and inspect the remaining selection. Finally use Default Items and confirm the newly queried default. Record these states alongside the query column order.\nOfficial references\nMicrosoft Learn: Workbook dropdown parameters.",
                "datePublished": "2026-09-10T00:25:42+00:00",
                "dateModified": "2026-09-10T02:01:56+00:00",
                "mainEntityOfPage": {
                    "@id": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/"
                },
                "inLanguage": "en-US",
                "isAccessibleForFree": true,
                "author": {
                    "@type": "Organization",
                    "name": "DSE Security Editorial Team",
                    "url": "https://update.dsesecurity.com/#editorial-team"
                },
                "publisher": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "image": {
                    "@type": "ImageObject",
                    "@id": "https://update.dsesecurity.com/updates/dse-20260909-374-understand-why-a-workbook-refresh-preserves-the-reader-s-dropdown-choice/#primaryimage",
                    "url": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20",
                    "contentUrl": "https://update.dsesecurity.com/assets/editorial/physical-security-social-v2.jpg?v=1.8.20",
                    "width": 1200,
                    "height": 630,
                    "caption": "Understand why a workbook refresh preserves the reader's dropdown choice"
                },
                "articleSection": [
                    "IT"
                ],
                "keywords": [
                    "IT",
                    "Explainer",
                    "Information priority"
                ],
                "genre": "Explainer",
                "about": [
                    {
                        "@type": "Thing",
                        "name": "IT",
                        "url": "https://update.dsesecurity.com/topic/it/"
                    }
                ],
                "wordCount": 247,
                "timeRequired": "PT2M",
                "publishingPrinciples": "https://update.dsesecurity.com/updates/dse-updates-editorial-methodology/",
                "usageInfo": "https://update.dsesecurity.com/usage/",
                "copyrightHolder": {
                    "@id": "https://dsesecurity.com/#organization"
                },
                "copyrightNotice": "Copyright © 2026 Detection Systems & Engineering. All rights reserved.",
                "citation": {
                    "@type": "CreativeWork",
                    "name": "Azure Monitor workbook dropdown parameters - Azure Monitor | Microsoft Learn",
                    "url": "https://learn.microsoft.com/en-us/azure/azure-monitor/visualize/workbooks-dropdowns"
                }
            }
        ]
    }
}