將 Aura 網站移轉至 Lightning Web 執行時期 (LWR) 之前的考量事項

一般

• 不同於包含特定網站功能之特定元件的 Aura 範本，LWR 範本提供更一般的元件，這些元件使用如資料繫結的概念來達成相同目標，但更快且更動態。

自訂 Aura 元件

• 識別您網站上的任何自訂 Aura 元件，並將其取代為 Lightning Web 元件 (LWC)。
  • 建立 LWC 時，使用新的 LWC 功能，例如 @slot、回應式內容和自訂內容編輯器。
  • 使用資料繫結在網站上顯示 CRM 資料和 CMS 內容 (若可能)，而非連接或 Apex 控制項。
• 請參閱瞭解 Experience Cloud 和 Github，以瞭解可用於參考的 LWC。

物件與網站頁面

• 我們建議您在 LWR 網站中使用與 Aura 網站中現有物件頁面相同的基礎 URL。例如,如果您在 Aura 網站中有現有頁面,例如 www.company.com/s/account/123456789/account-name,我們建議您為 LWR 中的物件頁面提供基底 URL /account。使用相同的基本 URL 讓您稍後能更輕鬆地設定重新導向。
• 我們建議您在 LWR 網站中，使用與 Aura 網站中反映現有網站頁面相同的基本 URL。例如,如果您有現有的產生器頁面 (例如 www.company.com/s/my-custom-page),請使用 /my-custom-page 作為 LWR 網站中的基本 URL。
• 在 LWR 中將您的 Aura 版面配置取代為彈性的版面配置。

自訂網域和自訂 URL

假設您的 Aura 網站 URL 使用自訂網域 (例如 www.company.com/s) 或 Salesforce 網域 (例如 company.my.site.com/s/),且相同的網域提供新的 LWR 網站,但不含 /s/。

• 建立不包含 /s/ 的 LWR 網站。
• 上線前,請先將 LWR 網站設定為使用 company.my.site.com/path,以便您可以測試重新導向。
• 在上線時，刪除 Aura 網站的自訂 URL。在「設定」中，為使用自訂網域的新 LWR 網站建立自訂 URL。
  • 若要讓舊 Aura 網站提供您尚無法在 LWR 中呈現的內容,請針對 Aura 網站新增包含路徑 (例如 /archive) 的自訂 URL。

主題

• 如果您的 Aura 網站使用具有自訂物件記錄的主題與主題指派，請以自訂物件取代主題與主題指派，例如 Topic__c 與 Topic_Assignment__c。
  • 若要驅動共用，請考慮設定 Topic_Assignment__c 和主題之間的主要-詳細資料關係，並考慮為主題指派的其他物件設定對應關係。
• 若要促進與網站使用者共用，請視需要在 Topic__c 物件上新增自訂欄位，例如「網站識別碼」選項清單欄位。
• 授與 LWR 網站來賓使用者的 Topic__c 和 Topic_Assignment__c 物件適當的物件權限。
• 建立來賓共用規則，以與來賓使用者記錄共用正確的 Topic__c 記錄。如果 Topic_Assignment__c 記錄與 Topic__c 有「主要 - 詳細資料」關係，則 Topic_Assignment__c 記錄也會顯示。

記錄資料擷取、轉換和載入 (ETL)

• 主題與主題指派
  • 匯出 Aura 網站上目前正在使用的物件的所有主題與主題指派。
  • 將主題匯入至新的自訂物件 Topic__c。
  • 將「主題指派」匯入新的自訂物件 Topic_Assignment__c，將新 Topic__c 記錄與主題指派相關的 EntityId 相關聯
• 包含 URL 欄位的記錄
  • 使用 URL 欄位匯出記錄。
  • 使用新的網站 URL 本機更新 URL 欄位值。 將檔案匯入回組織以更新記錄。

使用者共用和權限

• 來賓使用者
  • 當您建立 LWR 網站時，系統會自動建立新的來賓使用者。檢閱 Aura 網站來賓使用者的設定檔權限和權限集指派，並將任何必要組態移轉至 LWR 網站來賓使用者。
  • 如果現有且仍需要，Aura 網站的來賓使用者共用規則，請針對 LWR 網站的來賓使用者複製這些規則。
• 已驗證的使用者
  • 已驗證使用者的任何現有共用機制會從 Aura 網站移轉至 LWR 網站。
  • 針對您為新 LWR 網站建立的任何新自訂物件或元件建立共用機制。
  • 任何現有的設定檔、權限集和權限集指派都會從 Aura 網站移轉至 LWR 網站。

CSS

• Aura 中任何目標為標準標記的 CSS 覆寫皆不會套用至 LWR 中的標記。您必須更新 CSS 樣式表。
• LWR 網站在網站層級沒有專用的 CSS 編輯器。直接在標題標記中新增您的 CSS。LWR 網站上的元件在「樣式」索引標籤上具有「CSS 類別」區段，您可在該區段中新增元件層級的 CSS 類別。
• 如果樣式表是壓縮檔 (.zip) 一部分的檔案，則標記為

  • <link type="text/css" rel="stylesheet" href="{ basePath }/resource/<apiName>/<stylesheetFileName>.css?{ versionKey }" />

• 如果樣式表是直接上載為靜態資源的唯一檔案，而不是壓縮檔 (.zip) 的一部分，則標記為

  • <link type="text/css" rel="stylesheet" href="{ basePath }/resource/<apiName>?{ versionKey }" />

• 測試並確認 LWC 中的 CSS 可正常運作。
• LWR 網站中的設計權杖與 Aura 網站中的設計權杖不同。若要更新元件和樣式表中使用的權杖，請參閱 –dxp 樣式勾點文件。

Google Analytics 和其他標題標記指令檔與樣式表

• Google Analytics
  • 如果您使用 Google Analytics 的標準整合，則必須在 LWR 中重新設定。只要 LWR 網站使用 Aura 網站的網域名稱，您便可以使用相同的 Google Analytics 識別碼。
  • 如果您在標題標記中使用指令檔，請將指令檔貼到 LWR 網站。只要 LWR 網站使用 Aura 網站的網域名稱，則指令檔就會運作。
• 樣式表和其他靜態資源
  • 在 LWR 網站的標題標記中包含任何樣式表、JavaScript 檔案或其他靜態資源。

網站對應和快照產生

• 網站對應與快照會使用 my.site.com 網域產生,這表示您可以在將自訂網域從 Aura 移轉至 LWR 網站之前進行測試。若要儘量降低 SEO 影響，請確定網站對應與快照已正確填入。
• 請考慮將重新導向從 /s/sitemap.xml 放置到 /sitemap.xml。如此一來，您就可以將您擁有的任何網站對應提交重新導向至新的網站對應，而無須在所有位置更新這些網站對應。

檔案資產影像

• 如果您將任何檔案資產參照為 /file-asset/<fileAssetAPIName>,則必須將其更新為 /sfsites/c/file-asset/<fileAssetAPIName>。

CMS

• 透過 Winter ’24，您可以將所有 CMS 工作區中的內容發佈至 LWR 網站。
• LWR 網站中沒有 CMS 元件。使用資料繫結在 LWR 網站中顯示 CMS 內容。

重新導向

請考慮新增這些重新導向 (使用 CSV 格式)。

• /s、/ 和 /s/、/：將 Aura 首頁 URL 重新導向至 LWR 首頁 URL。
• /s/sitemap.xml、/sitemap.xml：將 Aura 網站對應 URL 重新導向至 LWR 網站對應 URL，而不是重新提交至搜尋引擎編目器。 
• /s/(customPage)、/(customPage)：將所有頁面分類，以將一層級頁面重新導向至 LWR 中的相等一層級頁面。
• /s/article/(articleAlias)、/article/(articleAlias)：知識文章重新導向。/s/contact/(contactId)、/contact/(contactId)：物件詳細資料頁面重新導向。(在此，連絡人會作為範例使用，但可將相同的結構套用至任何標準或自訂物件。)
• 不支援外部 URL 重新導向。如果您需要外部 URL 重新導向，請設定可重新導向至 Visualforce 頁面的解決方案，該頁面會進而導向至外部。

多國語言網站

• 新的 LWR 語言 URL 建構是路徑，而非查詢參數，這與在 Aura 中相同。請參閱建立多國語言 LWR 網站。

Visualforce 頁面

• 如果您在 Aura 網站中執行任何 Visualforce 頁面，例如自訂 robots.txt 檔案、自訂網站對應或其他自訂 Visualforce 頁面，請注意執行 Visualforce 頁面時，Aura 與 LWR 之間 URL 結構的差異。
• 在 Aura 中，網站在 /s 路徑後提供服務，Visualforce 頁面則在更高一層提供服務。
  • 範例：mycompany.my.site.com/helpcenter/s/ 的 Aura 網站會從 mycompany.my.site.com/helpcenter/apex/myVisualforcePage 提供 Visualforce 頁面。
  • 範例：helpcenter.mycompany.com/s/ 的 Aura 網站會從 helpcenter.mycompany.com/apex/myVisualforcePage 提供 Visualforce 頁面。
• LWR 網站會在網站路徑之後的根目錄中 (如果有的話) 提供，且 Visualforce 頁面會從自動建立為該網站預設的路徑提供。Visualforce 頁面自動建立的路徑是網站路徑 +「vforce 網站」的組合。您可以視需要在「設定」的「自訂 URL」區段中自訂和修改此路徑。
  • 範例：mycompany.my.site.com/helpcenter/ 的 LWR 網站會從 mycompany.my.site.com/helpcenter/helpcentervforcesite 提供 Visualforce 頁面。
  • 範例：helpcenter.mycompany.com 的 LWR 網站會從 helpcenter.mycompany.com/vforcesite 提供 Visualforce 頁面。

Mobile Publisher 應用程式

• Mobile Publisher 為 LWR 網站提供 Beta 版支援。
  • Playground 應用程式允許包含或不包含「/s」的 LWR 網站
  • 請參閱 LWR (Beta 版) 限制 
• 我們強烈建議您在建立和要求 Beta 版應用程式之前，在 Playground 應用程式中測試應用程式。

備註 此功能是 Beta 版服務。客戶可自行決定是否試用此 Beta 版服務。對於此 Beta 版服務的任何使用，皆適用 Beta 版服務條款 (由契約與條款所提供) 的約束。