Aura Deprecation Upgrade Guide

what's happening? starting with recent versions of the nue managed package, pages that load through the older aura component layer display a yellow deprecation banner deprecation notice this page uses a deprecated aura component that may cause slow load times and compatibility issues please update your button or link url to use the newer lightning web component instead contact nue if you're not sure how to handle this this banner appears when a page is accessed through a legacy url that references one of the old aura wrapper components the nue managed package has migrated its core ui to lightning web components (lwc), which are faster and more reliable the old aura wrappers still work but add an unnecessary loading layer on top of the lwc — resulting in slower page loads am i affected? you are affected if you see the yellow deprecation banner on any nue page this typically happens when you reach a nue page through bookmarks saved with older urls custom buttons or links that were manually created or copied from older documentation shared urls in wikis, slack messages, emails, or internal docs browser history auto completing to an older url you are not affected if you navigate to nue pages using the standard buttons provided by the managed package (e g , "edit line items" on a quote, "manage customer lifecycle" on an account, or the lifecycle manager tab) these already use the correct lwc path how to tell if you're using a deprecated url look at your browser's address bar after the page loads the banner only appears when the url references one of the old aura wrapper component names deprecated aura url (shows banner) replacement lwc component /lightning/cmp/ruby lifecyclemanager? ruby lifecyclemanagercontainer /lightning/cmp/ruby quotebuilder? ruby createquotescreencontainer /lightning/cmp/ruby quotelineeditor? ruby quotelineeditorcontainer /lightning/cmp/ruby orderlineeditor? ruby orderlineeditorcontainer /lightning/cmp/ruby orderbuilder? ruby orderbuildercontainer /lightning/cmp/ruby quotelinesplitter? ruby quotelinesplittercontainer /lightning/cmp/ruby orderlinesplitter? ruby orderlinesplittercontainer if your url already references the lwc name (right column), such as /lightning/cmp/ruby quotelineeditorcontainer? , you are not affected — that loads the lwc directly and does not show the banner how to fix it option 1 use the built in buttons (recommended) the simplest fix is to navigate using the buttons nue already provides on your salesforce record pages these buttons use salesforce's programmatic navigation, which routes directly to the lwc — no url changes needed action where to find the button manage customer lifecycle account record page → "manage customer lifecycle" quick action button edit line items (quote) quote record page → "edit line items" quick action button edit order products (order) order record page → "edit order products" quick action button create new quote opportunity record page → "new quote" quick action button finalize order quote record page → "finalize order" quick action button if these buttons are not visible on your record pages, a salesforce admin can add them via edit page in lightning app builder the quick actions are included in the nue managed package ruby account viewcustomer — "manage customer lifecycle" ruby quote edit line items — "edit line items" ruby order edit order products — "edit order products" ruby opportunity createquote — "new quote" ruby quote generate order — "finalize order" option 2 update custom urls to use the lwc component name if your org has custom buttons, links, or formula fields that reference the old aura wrapper names, update them to use the lwc component name instead the url structure stays the same — only the component name changes lifecycle manager old /lightning/cmp/ruby lifecyclemanager?c customerid={!account id} new /lightning/cmp/ruby lifecyclemanagercontainer?c customerid={!account id} quote line editor old /lightning/cmp/ruby quotelineeditor?c quoteid={!quote id} new /lightning/cmp/ruby quotelineeditorcontainer?c mode=edit quote lines\&c quoteid={!quote id} order line editor old /lightning/cmp/ruby orderlineeditor?c orderid={!order id} new /lightning/cmp/ruby orderlineeditorcontainer?c orderid={!order id} quote builder (create quote) old /lightning/cmp/ruby quotebuilder?c mode=create\&c opportunityid={!opportunity id} new /lightning/cmp/ruby createquotescreencontainer?c mode=create\&c opportunityid={!opportunity id} order builder (generate order) old /lightning/cmp/ruby orderbuilder?c orderid={!order id} new /lightning/cmp/ruby orderbuildercontainer?c orderid={!order id} quote line splitter old /lightning/cmp/ruby quotelinesplitter?c quoteid={!quote id} new /lightning/cmp/ruby quotelinesplittercontainer?c quoteid={!quote id} order line splitter old /lightning/cmp/ruby orderlinesplitter?c orderid={!order id} new /lightning/cmp/ruby orderlinesplittercontainer?c orderid={!order id} update bookmarks if you have browser bookmarks pointing to nue pages, simply delete them and re bookmark after navigating through the correct path (using the buttons or tabs described above) faq q will the old aura urls stop working? a not immediately the old aura components are still included in the managed package for backward compatibility however, they add unnecessary load time and will eventually be removed in a future release we recommend migrating as soon as practical however, they add unnecessary load time and will eventually be removed in a future release we recommend migrating as soon as practical q does this affect any data or functionality? a no the deprecation is purely about how the ui is loaded all features, data, and functionality are identical whether you use the old aura path or the new lwc path the only differences are load time and the deprecation banner q i see the banner but i'm using the standard nue buttons what should i do? a this shouldn't happen with the standard quick action buttons if it does, please contact nue support with a screenshot showing the url in your browser's address bar so we can investigate q my org has custom automation or integrations that generate nue urls what should i do? a search your org for any references to the deprecated aura component names in custom buttons and links (setup → object manager → \[object] → buttons, links, and actions) formula fields flows and process builder apex code or visualforce pages external systems that link into salesforce replace the old aura component names with the corresponding lwc container names (see the mapping table above), or where possible, switch to the managed package quick action buttons need help? if you're unsure which buttons or links need updating, or if you need assistance configuring your page layouts, contact nue support