沙箱工具

NOTE
沙箱工具是同時支援Real-Time Customer Data Platform和Journey Optimizer的基礎功能,可改善開發週期效率和設定準確性。

您必須擁有下列兩個角色型存取控制許可權,才能使用沙箱工具功能:
- manage-sandboxview-sandbox
- manage-package

提高沙箱之間的設定準確性,並利用沙箱工具功能順暢地匯出和匯入沙箱之間的沙箱設定。 使用沙箱工具來減少實作程式的價值實現時間,並跨沙箱移動成功的設定。

您可以使用沙箱工具功能來選取不同的物件,並將它們匯出到套件中。 套件可以包含單一物件或多個物件。 封裝中包含的任何物件都必須來自相同的沙箱。

沙箱工具支援的物件 supported-objects

沙箱工具功能可讓您將Adobe Real-Time Customer Data Platform和Adobe Journey Optimizer物件匯出至封裝。

Real-time Customer Data Platform物件 real-time-cdp-objects

下表列出目前沙箱工具支援的Adobe Real-Time Customer Data Platform物件:

平台
物件
詳細資料
客戶資料平台
來源
出於安全原因,不會將來源帳戶認證復寫到目標沙箱中,而是需要手動更新。 依照預設,來源資料流會以草稿狀態複製。
客戶資料平台
對象
僅支援​ 客戶對象 ​型別​ 細分服務。 用於同意和管理的現有標籤將複製到相同的匯入工作中。 檢查合併原則相依性時,系統將在具有相同XDM類別的目標沙箱中自動選取預設合併原則。
客戶資料平台
身分
在Adobe沙箱中建立時,系統會自動刪除重複的Target標準身分名稱空間。 對象規則中的所有屬性都已在聯合結構描述中啟用時,才能複製對象。 必須先移動並啟用統一設定檔的必要結構描述。
客戶資料平台
結構描述
用於同意和管理的現有標籤將複製到相同的匯入工作中。 使用者可靈活地匯入未啟用統一設定檔選項的結構描述。 封裝中不包含結構描述關聯邊緣案例。
客戶資料平台
資料集
資料集複製時會預設停用整合設定檔設定。
客戶資料平台
同意和治理原則
將使用者建立的自訂原則新增至套件,並橫跨沙箱移動這些原則。

下列物件已匯入,但處於草稿或已停用的狀態:

功能
物件
狀態
匯入狀態
Source資料流
草稿
匯入狀態
歷程
草稿
整合式設定檔
資料集
已停用整合式設定檔
原則
資料治理原則
停用

Adobe Journey Optimizer物件 abobe-journey-optimizer-objects

下表列出目前沙箱工具支援的Adobe Journey Optimizer物件與限制:

平台
物件
詳細資料
Adobe Journey Optimizer
對象
對象可以復製為歷程物件的相依物件。 您可以選取建立新受眾或重複使用目標沙箱中的現有受眾。
Adobe Journey Optimizer
綱要
歷程中使用的結構描述可以復製為相依物件。 您可以選取建立新結構描述,或重複使用目標沙箱中的現有結構描述。
Adobe Journey Optimizer
合併原則
歷程中使用的合併原則可以復製為相依物件。 在目標沙箱中,您​ 無法 ​建立新的合併原則,您只能利用現有的合併原則。
Adobe Journey Optimizer
歷程 — 畫布詳細資料
畫布上的歷程呈現方式包含歷程中的物件,例如條件、動作、事件、讀取對象等,這些物件均已複製。 跳轉活動會從複製中排除。
Adobe Journey Optimizer
活動
將會複製歷程中使用的事件和事件詳細資訊。 它一律會在目標沙箱中建立新版本。
Adobe Journey Optimizer
動作
歷程中使用的電子郵件和推播訊息可以復製為相依物件。 用於訊息個人化的歷程欄位中使用的管道動作活動不會檢查完整性。 不會複製內容區塊。

可以複製歷程中使用的更新設定檔動作。 也會複製歷程中使用的自訂動作和動作詳細資訊。 它一律會在目標沙箱中建立新版本。

不會複製曲面(例如預設集)。 系統會根據訊息型別和表面名稱,自動選取目標沙箱上最接近的相符專案。 如果在目標沙箱上找不到表面,則表面複製將失敗,導致訊息複製失敗,因為訊息需要表面才能用於設定。 在這種情況下,至少需要為訊息的正確通道建立一個表面,副本才能運作。

匯出歷程時,不支援將自訂身分型別當做相依物件使用。

將物件匯出到套件中 export-objects

NOTE
所有匯出動作都會記錄在稽核記錄中。
NOTE
只有當您擁有存取物件的許可權時,才能匯入套件。

此範例會記錄匯出結構描述並將其新增到封裝的程式。 您可以使用相同的程式匯出其他物件,例如資料集、歷程等等。

將物件加入至新封裝 add-object-to-new-package

從左側導覽選取​ 結構描述,然後選取​ 瀏覽 ​標籤,其中會列出可用的結構描述。 接著,選取所選結構描述旁邊的省略符號(...),下拉式清單就會顯示控制項。 從下拉式清單中選取​ 新增到封裝

結構描述清單,顯示反白顯示新增至封裝控制項的下拉式功能表。

從​ 新增至封裝 ​對話方塊中,選取​ 建立新封裝 ​選項。 提供封裝的Name和選用的描述,然後選取​ 新增

已選取建立新封裝並醒目提示新增的新增至封裝對話方塊。

您返回到​ 結構描述 ​環境。 您現在可以依照下列的後續步驟,將其他物件加入您建立的封裝。

將物件新增至現有封裝並發佈 add-object-to-existing-package

若要檢視可用的結構描述清單,請從左側導覽選取​ 結構描述,然後選取​ 瀏覽 ​索引標籤。 接著,選取選取的結構描述旁邊的省略符號(...),在下拉式功能表中檢視控制選項。 從下拉式清單中選取​ 新增到封裝

結構描述清單,顯示反白顯示新增至封裝控制項的下拉式功能表。

新增至封裝 ​對話方塊就會顯示。 選取「現有封裝」選項,然後選取「封裝名稱」下拉式清單,並選取所需的封裝。 最後,選取​ 新增 ​以確認您的選擇。

新增到封裝對話方塊,顯示下拉式清單中選取的封裝。

會列出加入封裝的物件清單。 若要發佈套件並使其可匯入沙箱,請選取​ Publish

封裝中的物件清單,醒目提示Publish選項。

選取​ Publish ​以確認發佈封裝。

Publish封裝確認對話方塊,醒目提示Publish選項。

NOTE
發佈後,無法變更套件的內容。 為避免相容性問題,請確保已選取所有必要的資產。 如果必須進行變更,您必須建立新封裝。

您會回到沙箱環境中的​ 套件 ​索引標籤,您可以在其中看到新發佈的套件。

醒目提示新發佈封裝的沙箱封裝清單。

將套件匯入目標沙箱 import-package-to-target-sandbox

NOTE
所有匯入動作都會記錄在稽核記錄中。

若要將套件匯入目標沙箱,請導覽至沙箱​ 瀏覽 ​標籤,並選取沙箱名稱旁邊的加號(+)選項。

沙箱瀏覽索引標籤醒目提示匯入封裝選取專案。

使用下拉式功能表,選取您要匯入目標沙箱的​ 封裝名稱。 新增將用於未來監視的​ 工作名稱。 依預設,在匯入套件的結構描述時,統一設定檔將會停用。 切換​ 為設定檔 ​啟用結構描述以啟用此設定,然後選取​ 下一步

匯入詳細資訊頁面顯示封裝名稱下拉式清單選項

封裝物件與相依性頁面提供此封裝中包含的所有資產清單。 系統會自動偵測成功匯入所選父物件所需的相依物件。 任何遺失的屬性都會顯示在頁面頂端。 選取「檢視詳細資料」以取得更詳細的劃分。

封裝物件和相依性頁面顯示遺漏的屬性。

NOTE
相依物件可以用目標沙箱中的現有物件取代,這可讓您重複使用現有物件,而不是建立新版本。 例如,當您匯入包含方案的套件時,可以重複使用目標沙箱中現有的自訂欄位群組和身分名稱空間。 或者,當您匯入包含歷程的套件時,可以重複使用目標沙箱中的現有區段。

若要使用現有物件,請選取相依物件旁的鉛筆圖示。

![封裝物件與相依性]頁面會顯示包含在封裝中的資產清單。(https://experienceleague.adobe.com/images/ui/sandbox-tooling/package-objects-and-dependencies.png?lang=zh-Hant)

隨即顯示建立新或使用現有專案的選項。 選取​ 使用現有的

顯示相依物件選項建立新的和使用現有的的封裝物件和相依性頁面。

欄位群組 ​對話方塊會顯示物件可用的欄位群組清單。 選取所需的欄位群組,然後選取​ 儲存

欄位群組對話方塊上顯示的欄位清單,醒目顯示儲存選取專案。

您返回到封裝物件和相依性頁面。 從這裡,選取​ 完成 ​以完成封裝匯入。

![封裝物件和相依性頁面會顯示包含在封裝中的資產清單,並醒目提示完成。]

匯出和匯入整個沙箱

NOTE
目前,匯出或匯入整個沙箱時僅支援Real-time Customer Data Platform物件。 目前不支援歷程之類的Adobe Journey Optimizer物件。

您可以將所有支援的物件型別匯出至完整的沙箱套件,然後跨各種沙箱匯入套件以複製物件設定。 例如,此功能可讓您:

  • 如果您需要重設沙箱,請重新匯入沙箱以重新產生物件的所有設定
  • 將套件匯入其他沙箱,並將其用作Blueprint沙箱以加快開發流程。

匯出整個沙箱 export-entire-sandbox

若要匯出整個沙箱,請瀏覽至沙箱 套件 ​索引標籤,並選取​ 建立套件

沙箱 封裝索引標籤醒目提示建立封裝。

在建立封裝對話方塊中,選取封裝的​ 整個沙箱。 為您的新封裝提供封裝名稱,並從下拉式清單中選取​ 沙箱。 最後,選取​ 建立 ​以確認您的專案。

建立封裝對話方塊顯示已完成的欄位並醒目提示建立。

已成功建立封裝,請選取​ Publish ​以發佈封裝。

醒目提示新發佈封裝的沙箱封裝清單。

您會回到沙箱環境中的​ 套件 ​索引標籤,您可以在其中看到新發佈的套件。

匯入整個沙箱套件 import-entire-sandbox-package

NOTE
所有物件都會當作新物件匯入目標沙箱中。 最佳實務是將完整的沙箱套件匯入空的沙箱。

若要將套件匯入目標沙箱,請瀏覽至沙箱 瀏覽 ​標籤,並選取沙箱名稱旁的加號(+)選項。

沙箱瀏覽索引標籤醒目提示匯入封裝選取專案。

使用下拉式功能表,使用​ 封裝名稱 ​下拉式功能表選取完整沙箱。 新增將用於未來監視的​ 工作名稱 ​和選用的​ 工作描述,然後選取​ 下一步

匯入詳細資訊頁面顯示封裝名稱下拉式清單選項

NOTE
您必須擁有封裝中包含之所有物件的完整許可權。 如果您沒有許可權,匯入作業將會失敗並顯示錯誤訊息。

您會進入封裝物件與相依性頁面,您可以在此頁面檢視匯入和排除物件的物件與相依性數目。 從這裡,選取​ 匯入 ​以完成封裝匯入。

封裝物件與相依性頁面顯示不支援之物件型別的內嵌訊息,並醒目提示匯入。

留出一些時間讓匯入完成。 完成時間會因封裝中的物件數目而異。 您可以從沙箱 工作 ​索引標籤監視匯入工作。

監視匯入詳細資料 view-import-details

若要檢視匯入的詳細資料,請瀏覽至沙箱 工作 ​標籤,然後從清單中選取封裝。 或者,使用搜尋列來搜尋套件。

沙箱工作索引標籤會醒目提示匯入套件選項。

在沙箱環境的​ 工作 ​索引標籤中,從右邊的詳細資料窗格中選取​ 檢視匯入摘要

沙箱匯入索引標籤會在右窗格中反白顯示檢視匯入詳細資料選項。

匯入摘要 ​對話方塊會顯示匯入的劃分以及進度百分比。

NOTE
您可以導覽至特定的詳細目錄頁面,以檢視物件清單。

顯示匯入詳細資料的匯入詳細資料對話方塊。

匯入完成時,會在Platform UI中收到通知。 您可以從警示圖示存取這些通知。 如果工作失敗,您可以從這裡導覽至疑難排解。

教學課程影片

以下影片旨在協助您瞭解沙箱工具,並概述如何建立新套件、發佈套件和匯入套件。

後續步驟

本檔案會示範如何在Experience PlatformUI中使用沙箱工具功能。 如需沙箱的相關資訊,請參閱沙箱使用手冊

如需使用沙箱API執行不同作業的步驟,請參閱沙箱開發人員指南。 如需Experience Platform中沙箱的整體概觀,請參閱概觀檔案

recommendation-more-help
e243ad8f-a318-46b3-9930-159a80f82b42