{"id":22089,"date":"2026-08-03T11:49:27","date_gmt":"2026-08-03T11:49:27","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=22089"},"modified":"2026-08-13T04:50:18","modified_gmt":"2026-08-13T04:50:18","slug":"how-to-configure-role-toolbar-button-access-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-role-toolbar-button-access-in-idempiere\/","title":{"rendered":"How to Configure Role Toolbar Button Access in iDempiere"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Role Toolbar Button Access controls which toolbar buttons appear for a Role on a specific Window and Tab in iDempiere. This impacts data integrity, audit compliance, and day-to-day transaction handling by hiding buttons without changing menu-level access or document security.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Process Flow<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"499\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-RoleToolBarAccessUpdate.drawio-3-1024x499.png\" alt=\"\" class=\"wp-image-22105\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-RoleToolBarAccessUpdate.drawio-3-1024x499.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-RoleToolBarAccessUpdate.drawio-3-300x146.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-RoleToolBarAccessUpdate.drawio-3-768x375.png 768w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-RoleToolBarAccessUpdate.drawio-3.png 1132w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Business Rules<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Active records are the only ones applied to toolbar restrictions.<\/li>\n\n\n\n<li>Exclude checkbox hides the selected button for the chosen Role.<\/li>\n\n\n\n<li>Rule applies only to the exact Role, Window, and Tab combination selected.<\/li>\n\n\n\n<li>Wildcard Organization (*) applies the restriction across all organizations.<\/li>\n\n\n\n<li>Restriction affects toolbar visibility only, not underlying document permissions.<\/li>\n\n\n\n<li>Each record controls a single ToolBar Button for a single Role and Tab.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Prerequisites<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Role configured in the Role window.<\/li>\n\n\n\n<li>Window and Tab already defined in the Application Dictionary.<\/li>\n\n\n\n<li>User assigned to the Role being restricted.<\/li>\n\n\n\n<li>Organization configured, or wildcard (*) confirmed for tenant-wide rules.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Navigation<\/strong><\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Menu \u2192 General Rules \u2192 Security \u2192 Role Toolbar Button Access<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Configuration Steps<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 1: Select the Role to Restrict<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Open Role Toolbar Button Access, click New, and select the Role from the list. Keep Active checked so the rule applies immediately.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"348\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-1-1024x348.png\" alt=\"\" class=\"wp-image-22096\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-1-1024x348.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-1-300x102.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-1-768x261.png 768w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-1-1536x522.png 1536w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-1-2048x696.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 2: Set the Organization Scope<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Choose a specific Organization for a single store, or leave the wildcard (*) to apply the rule tenant-wide.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 3: Choose the Action Type and Target Window<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Set Action to Window, then select the target Window and its corresponding Tab, for example Sales Invoice and Credit\/Debit Note.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Field Reference Table<\/strong><\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Sample Value<\/strong><\/td><td><strong>Description<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Action<\/td><td>Window<\/td><td>Type of dictionary entry the rule targets<\/td><\/tr><tr><td>Window<\/td><td>Sales Invoice and Credit\/Debit Note<\/td><td>Window where the button is restricted<\/td><\/tr><tr><td>Tab<\/td><td>Invoice_Sales Invoice and Credit\/Debit Note<\/td><td>Specific tab within the window<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 4: Select the ToolBar Button to Restrict<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">From the ToolBar Button dropdown, pick the button to control, for example Report &#8211; Attach.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 5: Enable Exclude to Hide the Button<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Check Exclude, then Save. Without this flag checked, the record has no restrictive effect.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Field Reference Table<\/strong><\/h3>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Sample Value<\/strong><\/td><td><strong>Description<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Role<\/td><td>POTS Admin<\/td><td>Role the restriction applies to<\/td><\/tr><tr><td>ToolBar Button<\/td><td>Report &#8211; Attach<\/td><td>Button being restricted<\/td><\/tr><tr><td>Exclude<\/td><td>Checked<\/td><td>Hides the button when checked<\/td><\/tr><tr><td>Active<\/td><td>Checked<\/td><td>Enables the rule for use<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 6: Verify by Logging in as the Restricted Role<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Log in with a user assigned to the restricted Role, open the target Window and Tab, and confirm the button is no longer visible.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"326\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-2-1024x326.png\" alt=\"\" class=\"wp-image-22097\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-2-1024x326.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-2-300x96.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-2-768x245.png 768w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-2-1536x490.png 1536w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-GeneralRules-RoleToolBarBUttonAccess-2-2048x653.png 2048w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Common Issues and Resolutions<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Issue<\/strong><\/td><td><strong>Cause<\/strong><\/td><td><strong>Resolution<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Button still visible after saving rule<\/td><td>Exclude checkbox left unchecked<\/td><td>Edit the record and enable Exclude<\/td><\/tr><tr><td>Rule not applied to any organization<\/td><td>Wrong Organization selected instead of wildcard<\/td><td>Set Organization to * for tenant-wide effect<\/td><\/tr><tr><td>Restriction affects wrong window<\/td><td>Incorrect Window or Tab selected<\/td><td>Verify Tab matches the exact window tab in use<\/td><\/tr><tr><td>Rule works for one store but not another<\/td><td>Organization set to a single store only<\/td><td>Add a separate record per organization, or use wildcard<\/td><\/tr><tr><td>Button missing for all roles unexpectedly<\/td><td>Rule created against a shared or default Role<\/td><td>Scope the rule to the specific Role only<\/td><\/tr><tr><td>Changes not visible to users<\/td><td>User session not refreshed<\/td><td>Ask users to log out and log back in<\/td><\/tr><tr><td>Cannot find ToolBar Button in dropdown<\/td><td>Button not available for selected Action or Window<\/td><td>Confirm Action is set to Window before selecting the button<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Next Steps<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Review Role window for broader permission settings.<\/li>\n\n\n\n<li>Configure Window Access to control full window visibility.<\/li>\n\n\n\n<li>Test toolbar behavior across all affected retail store organizations.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Role Toolbar Button Access controls which toolbar buttons appear for a Role on a specific Window and Tab in iDempiere. [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[91,10],"tags":[],"class_list":["post-22089","post","type-post","status-publish","format-standard","hentry","category-idempiere-general-rules","category-idempiere-product"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22089","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=22089"}],"version-history":[{"count":6,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22089\/revisions"}],"predecessor-version":[{"id":22106,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/22089\/revisions\/22106"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=22089"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=22089"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=22089"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}