預檢設定

通用編輯器

若要在通用編輯器中設定預檢，請依照以下步驟進行：

1. 在此開啟 Extension Manager：
   https://experience.adobe.com/#/@org/aem/extension-manager/universal-editor?lang=zh-hant
2. 找到 AEM Sites Optimizer Preflight 擴充功能。
3. 此擴充功能需要組織的系統管理員啟用。
4. 啟用擴充功能後，在 通用編輯器​中開啟一個頁面，例如：
   https://author-p12345-e123456.adobeaemcloud.com/ui#/@org/aem/universal-editor/canvas/author-p12345-e123456.adobeaemcloud.com/content/en/example/home.html
5. 預檢擴充功能​會顯示在​側邊欄。
6. 從側邊欄選取​預檢擴充功能，以開啟目前頁面的「預檢」。

文件型製作

若要設定對文件型製作進行預檢，請依照下列步驟進行：

1. 在 Edge Delivery Services 專案的 GitHub 存放庫中，將以下設定新增至 /tools/sidekick/config.json：

   code language-json
   { "plugins": [ { "id": "preflight", "titleI18n": { "en": "Preflight" }, "environments": ["preview"], "event": "preflight" } ] }

2. 建立新檔案 /tools/sidekick/aem-sites-optimizer-preflight.js 並新增以下內容：

   code language-javascript

   (function () { let isAEMSitesOptimizerPreflightAppLoaded = false; function loadAEMSitesOptimizerPreflightApp() { const script = document.createElement('script'); script.src = 'https://experience.adobe.com/solutions/OneAdobe-aem-sites-optimizer-preflight-mfe/static-assets/resources/sidekick/client.js?source=plugin'; script.onload = function () { isAEMSitesOptimizerPreflightAppLoaded = true; }; script.onerror = function () { console.error('Error loading AEMSitesOptimizerPreflightApp.'); }; document.head.appendChild(script); } function handlePluginButtonClick() { if (!isAEMSitesOptimizerPreflightAppLoaded) { loadAEMSitesOptimizerPreflightApp(); } } // Sidekick V1 extension support const sidekick = document.querySelector('helix-sidekick'); if (sidekick) { sidekick.addEventListener('custom:preflight', handlePluginButtonClick); } else { document.addEventListener('sidekick-ready', () => { document.querySelector('helix-sidekick') .addEventListener('custom:preflight', handlePluginButtonClick); }, { once: true }); } // Sidekick V2 extension support const sidekickV2 = document.querySelector('aem-sidekick'); if (sidekickV2) { sidekickV2.addEventListener('custom:preflight', handlePluginButtonClick); } else { document.addEventListener('sidekick-ready', () => { document.querySelector('aem-sidekick') .addEventListener('custom:preflight', handlePluginButtonClick); }, { once: true }); } }());

3. 更新 /scripts/scripts.js 中的函數 loadLazy() 以便匯入預覽 URL 的預檢指令碼：

   code language-javascript
   if (window.location.href.includes('.aem.page')) { import('../tools/sidekick/aem-sites-optimizer-preflight.js'); }

4. 開啟您要稽核的頁面之預覽 URL (*.aem.page)。

5. 在​ Sidekick ​中，按一下​ 預檢 ​按鈕以開啟目前頁面的預檢。

AEM Sites 頁面編輯器

如果您的作者環境正在執行AEM 2026.7.0 （發行版本27083）或更新版本，Preflight內建在AEM Sites頁面編輯器中，不需要書籤小程式。 請依照下列步驟操作：

1. 在 AEM Sites 頁面編輯器​中開啟您要稽核的頁面。

2. 在編輯器工具列中，選取​ 預檢 ​圖示（下面反白顯示的播放按鈕）以開啟目前頁面的「預檢」面板。

   {align="center"}

note
NOTE
在工具列中看不到​ 預檢 ​圖示？ 檢查下列專案：
支援的版本 — 整合式按鈕需要AEM 2026.7.0 （版本27083）或更新版本。 在舊版上，請使用下方的書籤小程式方法。 轉出 — 正在分階段為組織啟用整合按鈕，因此可能尚未觸及您的組織，即使在支援的版本上亦然。 在此之前，請使用下方的書籤小程式方法，或聯絡Adobe或您的管理員。 頁面存取 — 只有當您具有頁面的編輯存取權時，才會顯示按鈕。 使用者存取權 — 確認您的使用者已指派給​ AEM Sites Optimizer — 自動建議使用者 ​或​ AEM Sites Optimizer — 自動最佳化使用者 ​設定檔。 請參閱啟用使用者存取權。

若要在舊版AEM的AEM Sites頁面編輯器中使用Preflight，您可以在網頁瀏覽器中建立書籤小程式。 請依照下列步驟操作：

1. 在網頁瀏覽器中顯示您的​書籤列：

   • 按下 Ctrl+Shift+B (Windows) 或 Cmd+Shift+B (Mac)。

2. 在瀏覽器中建立新書籤：

   • 在書籤列上按一下右鍵，然後選取「新頁面」或「新增書籤」。
   • 在「位址 (URL)」欄位中，貼上以下程式碼：

   code language-javascript
   javascript:(function(){const script=document.createElement('script');script.src='https://experience.adobe.com/solutions/OneAdobe-aem-sites-optimizer-preflight-mfe/static-assets/resources/sidekick/client.js?source=bookmarklet&target-source=aem-cloud-service';document.head.appendChild(script);})();

3. 將書籤命名為「預檢」(或任何您喜歡的名稱)。

4. 在 AEM Sites 頁面編輯器​中開啟您要稽核的頁面之預覽 URL (*.aem.page)。

5. 按一下書籤列中的​ 預檢 ​書籤以開啟目前頁面的預檢。

Adobe Managed Services

note important
IMPORTANT
此功能僅支援使用 Adobe Identity Provider (IMS) 進行 AEM Author 驗證的 Adobe Managed Services (AMS) 環境。 如果您的組織使用任何其他身分識別提供者進行 AMS 驗證，預檢就無法運作。

將預檢內建至AEM Sites頁面編輯器工具列時，不需要書籤小程式。 請聯絡Adobe為您的組織安裝。 安裝後，請遵循下列步驟：

1. 在 AEM Sites 頁面編輯器​中開啟您要稽核的頁面。

2. 在編輯器工具列中，選取​ 預檢 ​圖示（下面反白顯示的播放按鈕）以開啟目前頁面的「預檢」面板。

   {align="center"}

note
NOTE
在工具列中看不到​ 預檢 ​圖示？ 您的組織可能尚未安裝整合式按鈕。 請聯絡Adobe以安裝它，或使用下方的書籤小程式方法。

若要在AMS環境的AEM Sites頁面編輯器中不使用工具列圖示使用Preflight，請在網頁瀏覽器中建立書籤小程式，請遵循下列步驟：

1. 在網頁瀏覽器中顯示您的​書籤列：

   • 按下 Ctrl+Shift+B (Windows) 或 Cmd+Shift+B (Mac)。

2. 在瀏覽器中建立新書籤：

   • 在書籤列上按一下右鍵，然後選取「新頁面」或「新增書籤」。
   • 在「位址 (URL)」欄位中，貼上以下程式碼：

   code language-javascript
   javascript:(function(){const script=document.createElement('script');script.src='https://experience.adobe.com/solutions/OneAdobe-aem-sites-optimizer-preflight-mfe/static-assets/resources/sidekick/client.js?source=bookmarklet&target-source=ams';document.head.appendChild(script);})();

3. 將書籤命名為「預檢」(或任何您喜歡的名稱)。

4. 在 AEM Sites 頁面編輯器​中開啟您要稽核的頁面。

5. 按一下書籤列中的​ 預檢 ​書籤以開啟目前頁面的預檢。