跳至主要內容
Adaptive Planning
上次更新時間 :2023-06-23
概念︰顯示名稱的層級、維度和屬性內容代碼

概念︰顯示名稱的層級、維度和屬性內容代碼

在 Workday Adaptive Planning 中啟用顯示名稱後,可將相同的標籤用於多個層級、自訂維度值或屬性內容值。此功能︰
  • 簡化從 Workday Financials、Workday Human Capital Management 或其他外部系統的載入結構。
  • 不必從 Workday 或其他匯入內容串連標籤和參照 ID,即可使標籤在 Adaptive Planning 中成為唯一。
  • 在標籤相符時提供簡化的中繼資料載入流程。

啟用顯示名稱

每個層級、自訂維度值和屬性內容值都會收到一個唯一的代碼。
代碼的作用就像是索引鍵。
對於包含層級、維度值或屬性內容值的公式,
code
取代
name
以免造成混淆。您的整合載入器將照常運作,並自動使用代碼來進行欄的對應。
啟用顯示名稱會將異常偵測閾值重設為 40%。

中繼資料代碼

在導入顯示名稱之前,層級、自訂維度或屬性內容中的名稱必須是唯一名稱。
對於既存的實例,我們會重複使用您已建立的名稱,為您自動產生代碼。
在 Workday Adaptive Planning 中,代碼一律顯示在方括號內,方便您識別。範例︰[westeu01]。

顯示名稱和顯示名稱格式

顯示名稱會為層級、維度值和屬性內容值導入唯讀的
顯示名稱
欄位。顯示名稱的作用一如使用者在整個 Workday Adaptive Planning 中看到的中繼資料元素 (原本的名稱欄位) 的標籤。只要有人挑選、選取或檢視中繼資料元素,就會出現顯示名稱。
對於既存的 Workday Adaptive Planing 實例,系統會使用顯示名稱格式自動填入
名稱
。您可以在層級、維度和屬性內容管理頁面選取以下任何顯示名稱格式︰
  • 名稱
  • 代碼
  • 名稱 [代碼]
  • [代碼] 名稱
您可以在維度的根節點為每個維度配置顯示名稱格式。顯示每個值的代碼。
顯示名稱和代碼各可包含 2048 個字元,合併使用時則為 4096 個字元。
保持排序狀態
已啟用時,對顯示名稱組成元素所作的任何變更,都可能改變「維度管理」或「屬性內容管理」中元素的排序順序。

在結構匯入中顯示名稱

透過在匯入範本中要求「顯示名稱格式」、「值代碼」和「值名稱」欄,以匯入層級結構、自訂維度和屬性內容支援代碼。「名稱」欄會被取代為「值代碼」和「值名稱」欄。
請一律下載新的匯入範本,並按照第一個工作表上的說明進行操作。導入顯示名稱會變更範本中必填欄和欄名稱。請勿重複使用舊版範本或沒有顯示名稱之實例的範本。
請勿使用匯入來變更層級的名稱或代碼。這些變更必須在應用程式中手動進行。
對於階層,您可以參照父系代碼以指出父系值。
結構匯入需要這些欄才能支援顯示名稱︰
層級匯入
  • 層級顯示名稱格式
  • 層級代碼
  • 屬性內容值代碼
  • 屬性內容值名稱
維度匯入
  • 維度顯示名稱格式
  • 維度值代碼
  • 維度值名稱
  • 屬性內容值代碼
  • 屬性內容值名稱
屬性內容匯入
  • 屬性內容顯示名稱格式
  • 屬性內容值代碼
  • 屬性內容值名稱
科目匯入
  • 屬性內容值代碼
  • 屬性內容值名稱
層級、維度和屬性內容的可列印檢視全都包含「顯示名稱」、「值代碼」和「值名稱」的欄。

在整合中顯示名稱元素

在 Workday Adaptive Planning 整合中導入中繼資料代碼有助於以下操作︰
  • 對應︰協助使用者在外部中繼資料元素與 Workday Adaptive Planning 內部元素之間建立關聯
  • 顯示資訊︰協助整合使用者區分重複的標籤
  • 搜尋︰協助使用者依據中繼資料代碼尋找特定元素
對應、顯示和搜尋是在資料來源、資料載入器和中繼資料載入器的建立與維護期間進行。

在 Planning 資料來源中顯示名稱元素

在 Planning 資料來源中建立共用參數時,您可以︰
  • 參閱層級、維度值和屬性內容值的顯示名稱和代碼
  • 按顯示名稱或代碼搜尋共用參數
包含受管理來源的代碼
導入現有實例的顯示名稱後,您可以按一下
管理來源
,並且為這些來源選取
包含代碼
,這些來源可包含層級、維度和屬性內容,也可依這些項目進行篩選︰
  • 自訂
  • Cube 工作表
  • 模型工作表
一旦選取
包含代碼
,便無法將其停用。
您在導入顯示名稱後新建的受管理來源,預設會自動選取
包含代碼

在整合載入器中顯示名稱元素

導入顯示名稱後,維度、屬性內容和層級載入器會自動對應至「欄對應」的「代碼」。需要自動對應欄時,可選取依代碼或名稱自動對應。
Planning 資料載入器欄對應
提交資料時,系統會依代碼而非名稱載入資料。使用
欄對應
分頁來對應欄時,請將來源 ID 欄對應至代碼。將來源顯示名稱欄對應至名稱。
Planning 資料載入器資料對應
按一下
資料對應
分頁時,您可以依下列方式自動對應所有或選取的欄︰
  • 來源 ID 欄
  • 來源顯示名稱欄
當您從
資料對應
分頁下載對應時,此範本會使用「來源 ID」欄的代碼。上傳對應時,此範本預期「來源 ID」欄會有代碼。
Planning 資料載入器資料來源設定
Planning 資料載入器的「資料來源設定」分頁包含自動對應區段。此區段可讓您選擇性地在載入器執行階段,自動對應任何新科目、層級或維度值。自動對應層級和自動對應維度可使用以下選項來支援代碼︰
  • 將來源 ID 自動對應至代碼
  • 將來源顯示名稱自動對應至代碼

在 API 中顯示名稱元素

導入顯示名稱後,您的 API 可支援中繼資料
code
如果︰
  • 您在呼叫中使用 API 30 版或更高版本
  • 您包含
    displayNameEnabled=1
    中的參數
    dimensions
    元素
    attributes
    元素,以及
    levels
    元素
包括
displayNameEnabled=0
for 元素會停用該元素的顯示名稱,從而阻止使用
code
和用途
name
這些大量 API 支援
code
當您啟用顯示名稱,但全部使用 ID 做為索引鍵時︰
  • updateAttributes
  • updateDimensions
  • updateLevels
  • importDimensionMapping
這些資料 API 支援
code
導入顯示名稱後︰
  • eraseData
  • exportConfigurableModelData
  • exportData
  • importConfigurableModeleData
  • importStandardData
  • importCubeData
  • importTransactions
如需有關在要求和回應中使用顯示名稱元素的更多詳細資料,請參閱每個 API 文件頁面。
API v32 和 v33 中的大量中繼資料 API 屬性內容標記
這些大量 API 支援
valueCode
valueName
適用於 API v32 和 API v33,且已導入顯示名稱和用途
displayNameEnabled=1
  • updateLevels
    支援
    valueCode
    valueName
    dimension
    attribute
    元素
  • updateAccounts
    支援
    valueCode
    valueName
    attribute
    元素
  • updateDimensions
    支援
    valueCode
    valueName
    attribute
    元素
  • exportLevels
    支援
    valueCode
    valueName
    dimension
    attribute
    元素
  • exportAccounts
    支援
    valueCode
    valueName
    attribute
    元素
  • exportDimensions
    支援
    valueCode
    valueName
    attribute
    元素
在您啟用顯示名稱並使用 API v32 或 API v33 後,這些 API 將不再支援
name
在屬性內容元素中
單一中繼資料 API
這些單一中繼資料 API 不支援顯示名稱︰
  • updateDimension
  • updateDimensionValue
  • updateLevel
  • createDimension
  • createDimensionValue
  • createLevel

在公式中顯示名稱元素

導入顯示名稱後,在公式中參照層級、自訂維度值或屬性內容值時,您必須使用代碼。公式小幫手中,您之前看到名稱的位置,無論在哪裡都會出現顯示名稱。
公式小幫手元素選擇器會同時依據顯示名稱和代碼來產生搜尋結果。只有元素的代碼會變成公式的一部分。
屬性的顯示名稱元素和公式標記法
導入顯示名稱會觸發
code
in 屬性的公式標記法使用屬性內容的標記法建構公式時,您可以透過以下方式參照層級、自訂維度值和屬性內容值。
code
對於標記法,您必須手動變更任何現有的
.name
參照
.code
並導入顯示名稱
您無法在標記法中使用顯示名稱,因為其無法確保計算期間的唯一性。
如果您在報告中使用公式進行自訂計算,之後又變更顯示名稱格式,請重新檢視這些公式以確保正確無誤。

在工作表中顯示名稱元素

導入顯示名稱後,您有 2 個選項可下載模型工作表資料︰
  • 「下載」︰匯出工作表上的層級、維度值和屬性內容值的代碼。
    如果您計畫將資料匯回模型工作表,請使用此選項。
  • 「可列印檢視」︰匯出層級、維度值和屬性內容值的已配置顯示名稱。
    如果您希望試算表符合您目前的
    顯示選項
    ,請使用此選項。您無法匯入此版本的試算表。
若要選取上述任一選項︰
  • 從「工作表總覽」開啟模型工作表時,請按一下
    下載
    按鈕旁邊的箭頭。
  • 從儀表板開啟模型工作表時,請按一下
    更多
    圖示。
對於標準和 Cube 工作表,
下載
選項會繼續匯出層級、維度值和屬性內容值的顯示名稱,也會繼續比對您在工作表中定義的
顯示選項

在報告中顯示名稱元素

報告建置器在以下位置使用您選取的顯示名稱格式,依顯示名稱呈現中繼資料元素︰
  • 矩陣報告
  • 模型報告
檢視報告時,元素會使用其顯示名稱載入。將元素拖放到建置器中來建置報告時,只會出現顯示名稱。
矩陣報告公式小幫手會依顯示名稱在選擇器中顯示元素。自訂計算中的公式一律會使用您選取的元素代碼。
模型報告篩選條件使用顯示名稱。

在連結的層級重新整理中的顯示名稱元素

由於在多重實例環境中導入了父系和子系實例的顯示名稱,連結的層級重新整理時會以顯示名稱取代名稱。

在 OfficeConnect 中顯示名稱

對於所有 OfficeConnect 報告元素,我們會在標籤定義中提供「顯示名稱」的標籤類型值。此標籤類型值在 Adaptive Planning 中支援重複的中繼資料名稱。

匯入範本

「整合
匯入資料」
中的匯入範本格式和說明指出,在以下項目的匯入中,需要使用代碼做為唯一 ID︰
  • 標準資料匯入
  • 模型工作表資料匯入
  • Cube 工作表資料匯入
  • 交易資料匯入
任何拆分為 2 欄的維度欄︰
  • 維度代碼
  • 維度名稱
「維度名稱」欄為選填欄。如果此欄不存在,則「維度代碼」將變成「維度名稱」。如果「維度代碼」不同,則可能存在重複的「維度名稱」值。
層級欄標頭指出︰
  • 層級代碼
科目欄標頭支援以下任一標籤︰
  • 科目代碼
  • 科目
You can select
Import without Code and Name columns for display names
to import templates without columns for Code and Name fields. This option also allows importing from older templates created before the introduction of display names. When you turn on
Enable Single Column Data Import/Export for Display Name
in
General Setup
, we apply
Import without Code and Name columns for display names
across the application and hide the option in the Import page.