沙箱工具
您必須擁有下列兩個角色型存取控制許可權，才能使用沙箱工具功能：
-
manage-sandbox或view-sandbox-
manage-package提高沙箱之間的設定準確性，並利用沙箱工具功能順暢地匯出和匯入沙箱之間的沙箱設定。 使用沙箱工具來減少實作程式的價值實現時間，並跨沙箱移動成功的設定。
您可以使用沙箱工具功能來選取不同的物件，並將它們匯出到套件中。 套件可以包含單一物件或多個物件。 封裝中包含的任何物件都必須來自相同的沙箱。
沙箱工具支援的物件 supported-objects
沙箱工具功能可讓您將Adobe Real-Time Customer Data Platform和Adobe Journey Optimizer物件匯出至封裝。
即時客戶資料平台物件 real-time-cdp-objects
下表列出目前沙箱工具支援的Adobe Real-Time Customer Data Platform物件：
下列物件已匯入，但處於草稿或已停用的狀態：
Adobe Journey Optimizer物件 abobe-journey-optimizer-objects
下表列出目前沙箱工具支援的Adobe Journey Optimizer物件與限制：
歷程中使用的下列物件會復製為相依物件。 在匯入工作流程期間，您可以選取 建立新的 或 使用現有的：
- 客群
- 結構描述
- 自訂動作
- 活動
- 片段
- 內容範本
- 畫布詳細資訊
- 自訂動作：將歷程複製到另一個沙箱時，在匯入程式中選取 使用現有 時，您選取的現有自訂動作 必須 與來源自訂動作相同。 如果兩者不同，新歷程將有無法解決的錯誤。
- 將會複製歷程中使用的事件和事件詳細資訊。 它一律會在目標沙箱中建立新版本。
可以複製歷程中使用的更新設定檔動作。 自訂動作可獨立新增至套件。 歷程中使用的動作詳細資料也會複製。 它一律會在目標沙箱中建立新版本。
自訂動作可獨立新增至套件。 將自訂動作指派給歷程後，就無法再編輯它。 若要更新自訂動作，您應：
- 在移轉歷程之前移動自訂動作
- 更新移轉後自訂動作的設定（例如請求標頭、查詢引數和驗證）
- 使用您在第一個步驟中新增的自訂動作移轉歷程物件
促銷活動中使用的下列物件會復製為相依物件：
- 行銷活動
- 客群
- 結構描述
- 內容範本
- 片段
- 訊息/內容
- 管道設定
- 統一的決定物件
- 實驗設定/變體
- 行銷活動可與所有與設定檔、對象、結構、內嵌訊息和相依物件相關的專案一起複製。 有些專案不會複製，例如資料使用標籤和語言設定。 如需無法複製的物件完整清單，請參閱將物件匯出至另一個沙箱指南。
- 如果存在相同的設定，系統將自動檢測並重新使用目標沙箱中的現有通道設定物件。 如果找不到相符的設定，則在匯入期間會跳過頻道設定，使用者必須手動更新此歷程的目標沙箱中的頻道設定。
- 使用者可重複使用目標沙箱中的現有實驗與對象，作為所選行銷活動的相依物件。
不會複製曲面（例如預設集）。 系統會根據訊息型別和表面名稱，自動選取目標沙箱上最接近的相符專案。 如果在目標沙箱上找不到表面，則表面複製將失敗，導致訊息複製失敗，因為訊息需要表面才能用於設定。 在這種情況下，至少需要為訊息的正確通道建立一個表面，副本才能運作。
匯出歷程時，不支援將自訂身分型別當做相依物件使用。
將物件匯出到套件中 export-objects
此範例會記錄匯出結構描述並將其新增到封裝的程式。 您可以使用相同的程式匯出其他物件，例如資料集、歷程等等。
將物件加入至新封裝 add-object-to-new-package
從左側導覽選取 結構描述，然後選取 瀏覽 標籤，其中會列出可用的結構描述。 接著，選取所選結構描述旁邊的省略符號(...)，下拉式清單就會顯示控制項。 從下拉式清單中選取 新增到封裝。
從 新增至封裝 對話方塊中，選取 建立新封裝 選項。 提供封裝的Name和選用的描述，然後選取 新增。
您返回到 結構描述 環境。 您現在可以依照下列的後續步驟，將其他物件加入您建立的封裝。
將物件新增至現有封裝並發佈 add-object-to-existing-package
若要檢視可用的結構描述清單，請從左側導覽選取 結構描述，然後選取 瀏覽 索引標籤。 接著，選取選取的結構描述旁邊的省略符號(...)，在下拉式功能表中檢視控制選項。 從下拉式清單中選取 新增到封裝。
新增至封裝 對話方塊就會顯示。 選取「現有封裝」選項，然後選取「封裝名稱」下拉式清單，並選取所需的封裝。 最後，選取 新增 以確認您的選擇。
會列出加入封裝的物件清單。 若要發佈封裝並使其可匯入沙箱，請選取 發佈。
選取 發佈 以確認發佈封裝。
您會回到沙箱環境中的 套件 索引標籤，您可以在其中看到新發佈的套件。
將套件匯入目標沙箱 import-package-to-target-sandbox
若要將套件匯入目標沙箱，請導覽至沙箱 瀏覽 標籤，並選取沙箱名稱旁邊的加號(+)選項。
使用下拉式功能表，選取您要匯入目標沙箱的 封裝名稱。 新增將用於未來監視的 工作名稱。 依預設，在匯入套件的結構描述時，統一設定檔將會停用。 切換 為設定檔 啟用結構描述以啟用此設定，然後選取 下一步。
封裝物件與相依性頁面提供此封裝中包含的所有資產清單。 系統會自動偵測成功匯入所選父物件所需的相依物件。 任何遺失的屬性都會顯示在頁面頂端。 選取「檢視詳細資料」以取得更詳細的劃分。
若要使用現有物件，請選取相依物件旁的鉛筆圖示。
![封裝物件與相依性]頁面會顯示包含在封裝中的資產清單。(https://experienceleague.adobe.com/images/ui/sandbox-tooling/package-objects-and-dependencies.png?lang=zh-Hant)
隨即顯示建立新或使用現有專案的選項。 選取 使用現有的。
欄位群組 對話方塊會顯示物件可用的欄位群組清單。 選取所需的欄位群組，然後選取 儲存。
您返回到封裝物件和相依性頁面。 從這裡，選取 完成 以完成封裝匯入。
![封裝物件和相依性頁面會顯示包含在封裝中的資產清單，並醒目提示完成。]
匯出和匯入整個沙箱
您可以將所有支援的物件型別匯出至完整的沙箱套件，然後跨各種沙箱匯入套件以複製物件設定。 例如，此功能可讓您：
- 如果您需要重設沙箱，請重新匯入沙箱以重新產生物件的所有設定
- 將套件匯入其他沙箱，並將其用作Blueprint沙箱以加快開發流程。
匯出整個沙箱 export-entire-sandbox
若要匯出整個沙箱，請瀏覽至沙箱 套件 索引標籤，並選取 建立套件。
在建立封裝對話方塊中，選取封裝的 整個沙箱。 為您的新封裝提供封裝名稱，並從下拉式清單中選取 沙箱。 最後，選取 建立 以確認您的專案。
已成功建立封裝，請選取 發佈 以發佈封裝。
您會回到沙箱環境中的 套件 索引標籤，您可以在其中看到新發佈的套件。
匯入整個沙箱套件 import-entire-sandbox-package
若要將套件匯入目標沙箱，請瀏覽至沙箱 瀏覽 標籤，並選取沙箱名稱旁的加號(+)選項。
使用下拉式功能表，使用 封裝名稱 下拉式功能表選取完整沙箱。 新增將用於未來監視的 工作名稱 和選用的 工作描述，然後選取 下一步。
您會進入封裝物件與相依性頁面，您可以在此頁面檢視匯入和排除物件的物件與相依性數目。 從這裡，選取 匯入 以完成封裝匯入。
留出一些時間讓匯入完成。 完成時間會因封裝中的物件數目而異。 您可以從沙箱 工作 索引標籤監視匯入工作。
監視匯入詳細資料 view-import-details
若要檢視匯入的詳細資料，請瀏覽至沙箱 工作 標籤，然後從清單中選取封裝。 或者，使用搜尋列來搜尋套件。
在沙箱環境的 工作 索引標籤中，從右邊的詳細資料窗格中選取 檢視匯入摘要。
匯入摘要 對話方塊會顯示匯入的劃分以及進度百分比。
匯入完成時，會在Experience Platform UI中收到通知。 您可以從警示圖示存取這些通知。 如果工作失敗，您可以從這裡導覽至疑難排解。
透過沙箱工具傳輸沙箱間的反複物件設定更新 move-configs
您可以使用沙箱工具在不同沙箱之間傳輸物件設定。 先前，您必須手動重新建立或重新匯入物件（例如結構描述、欄位群組和資料型別）的設定更新，才能傳輸到其他沙箱。 透過此功能，您可以使用沙箱工具來加速工作流程，並透過在不同沙箱之間順暢傳輸您的設定更新來減少潛在的錯誤。
- 存取沙箱工具的適當許可權。
- 在您的來源沙箱中新建立或更新後的物件（例如結構描述）。
支援的更新作業物件型別
以下是支援更新的物件型別：
- 結構描述
- 欄位群組
- 資料類型
- 將新欄位/欄位群組新增至資源。
- 將必填欄位設為選用。
- 引入新的必填欄位。
- 引入新的關係欄位。
- 引入新的身分欄位。
- 變更資源的顯示名稱和說明。
- 移除先前定義的欄位。
- 在針對Real-time Customer Profile啟用結構描述時，重新定義現有欄位。
- 移除或限制先前支援的欄位值。
- 將現有欄位移動到結構樹中的不同位置 — 這將在目標沙箱中建立一個新欄位，但不會移除上一個欄位。
- 啟用或停用結構描述以參與設定檔 — 比較時將略過此操作。
- 存取控制標籤。
請依照下列步驟瞭解如何使用沙箱工具來將您的物件設定傳輸到不同的沙箱。
先前匯入的物件
如果您的使用案例涉及來源沙箱中需要設定更新的現有物件，請在已封裝並匯入其他沙箱後，按照以下步驟操作。
首先，更新來源沙箱中的物件。 例如，導覽至 結構描述 工作區，選取您的結構描述，然後新增欄位群組。
更新結構描述後，請導覽至 沙箱，選取 封裝，然後找出您現有的封裝。
使用套件介面來驗證您的變更。 選取 檢查更新 以檢視封裝中成品的任何變更。 接著，選取 檢視diff 以接收針對成品進行的所有變更的詳細摘要。
檢視diff介面出現。 如需來源和目標成品的相關資訊，以及套用至這些成品的變更，請參閱此收費專案。
在此步驟中，您也可以選取使用AI摘要，以取得所有變更的逐步摘要。
準備就緒後，請選取 更新封裝，然後在出現的快顯視窗中選取 確認。 工作完成後，您可以重新整理頁面，並選取 檢視歷程記錄 以驗證封裝的版本。
若要匯入您的變更，請導覽回套件目錄，並選取套件旁邊的省略符號(...)，然後選取 匯入套件。 Experience Platform自動選取更新現有物件。 驗證變更，然後選取 完成。
若要進一步驗證匯入程式，請導覽至您的目標沙箱，並從該沙箱中手動檢視更新的物件。
在目標沙箱中手動建立的物件
如果您的使用案例涉及將設定變更套用至在不同沙箱中手動建立的物件，請按照以下步驟操作。
首先，使用更新後的物件建立並發佈新套件。
接下來，將您的套件匯入至目標沙箱，其中包含您也要更新的物件。 在匯入程式期間，選取 更新現有物件，然後使用物件導覽器手動選取要套用更新的目標物件。
- 可選擇在不同的沙箱中為相依物件選取目標對應。 如果未選取任何專案，則會建立新的專案。
- 對於身分名稱空間，如果需要在目標沙箱中重複使用現有身分，系統會自動偵測是否需要建立新身分。
識別要更新的目標物件之後，請選取 完成。
教學課程影片
以下影片旨在協助您瞭解沙箱工具，並概述如何建立新套件、發佈套件和匯入套件。
後續步驟
本檔案會示範如何使用Experience Platform UI中的沙箱工具功能。 如需沙箱的相關資訊，請參閱沙箱使用手冊。
如需使用沙箱API執行不同作業的步驟，請參閱沙箱開發人員指南。 如需Experience Platform中沙箱的整體概觀，請參閱概觀檔案。