Edge Delivery Services的路徑對應 path-mapping
瞭解如何將AEM編寫執行個體上使用的頁面路徑對應到網站上使用的公開頁面路徑，並控制要將哪些內容發佈到Edge Delivery Services。
概觀 overview
若要能夠使用AEM編寫WYSIWYG內容並將其發佈到Edge Delivery Services，您必須設定專案的路徑對應。 此對應有兩個用途。
- 它會對應並建立您AEM編寫執行個體上使用的頁面路徑，與您的網站上使用的公開頁面路徑之間的關係。
- 這可控制哪些內容（頁面、工作表、資產等） 發佈至Edge Delivery Services。
每個專案都必須個別地並根據專案的內容和URL結構設定路徑對應。 AEM在內容發佈期間以及在通用編輯器中編輯內容時，會使用它。
設定格式 configuration-format
路徑對應設定的格式包含兩個區段（mappings和includes），類似於以下範例。
{
"mappings": [
"/content/aem-boilerplate/:/",
"/content/aem-boilerplate/configuration:/.helix/config.json"
],
"includes:" [
"/content/aem-boilerplate/"
]
}
對映 mappings
mappings設定包含內部路徑(在AEM編寫執行個體上)和外部URL路徑（在公用網站上）的陣列。
格式為<internal paths>:<external path>。 通常至少包含兩個專案。
- 範例中的第一個專案是網站頁面的路徑對應。
- 第二個專案控制
.helix/config.json與AEM編寫存放庫中對應試算表頁面的對應。
在此範例中，所有儲存在/content/aem-boilerplate/...下的頁面將可以在Edge Delivery Services網站上直接在https://main--my-site--org.aem.live/....下公開存取。
.json API URL發佈。 要執行此操作，它們必須個別列在對應設定中。包含 includes
includes設定會控制哪些內容路徑實際復寫到Edge Delivery Services。 它也可以保留任何路徑陣列，且通常包含網站頂層根頁面。
Edge Delivery Services頁面上使用的Assets通常會與網頁一起發佈。 它們會自動從AEM編寫執行個體匯出至Edge Delivery Services。
includes區段。/assets/...公開存取包含一組PDF的資產根資料夾（例如/content/dam/my-site/documents），則必須將專案新增至設定的includes區段。如何設定 how-to-configure
您可以根據專案的設定，以兩種方式之一設定路徑對應。
-
如果專案是針對
aem.live設定，且使用設定服務進行集中設定，則每個網站的路徑對應會透過此設定服務進行設定。- 以下是設定路徑對應的範例cURL要求。
code language-text curl --request POST \ --url https://admin.hlx.page/config/{org}/sites/{site}/public.json \ --header 'Content-Type: application/json' \ --header 'x-auth-token: ......' \ --data '{ "paths": { "mappings": [ "/content/aem-boilerplate/:/", "/content/aem-boilerplate/configuration:/.helix/config.json" ], "includes": [ "/content/aem-boilerplate/" ] } }' -
如果專案未使用設定服務，則會透過您專案GitHub存放庫中的
paths.json檔案設定路徑對應。
在這兩種情況下，設定路徑對應後，您就可以透過可公開存取的設定URL https://<branch>--<site>--<org>.aem.page/config.json檢查設定。