自訂係數對應 (預覽版)

免費試用

重要

這其中部分或所有的功能會做為預覽版本的一部分來提供。 內容和功能隨時可能變更。

Microsoft Sustainability Manager 在係數對應中使用內建參考資料。 您可以使用自訂係數對應來擴充可用的係數對應集。 例如，您可能需要依據會計年度或自訂區域等係數來透視活動計算結果。 本文會引導您完成此進階設定，而此設定必須使用 Power Platform 系統管理中心來完成。

注意

本文中的程序需要 Microsoft Dataverse 管理和 API 中的進階專業知識。 本文並未詳細說明常見的平台作業。 只有擁有 Power Platform 系統管理中心完整存取權的授權系統管理員才能完成這些設定步驟。

若要擴充 Sustainability Manager 以使用自訂係數對應，請執行下列步驟：

• 創建自訂參考數據
• 連結因數到 Sustainability Manager 因子的映射
• 連結 Sustainability Manager 參考數據到新因素
• 授權 Sustainability Manager 訪問外部表
• 授權使用者訪問表
• 測試自定義參考數據和因數映射之間的連結
• 在計算模型中使用擴展因數

創建自訂參考數據

建立新表格

1. 在 Power Apps 門戶中，創建要在因數映射中用作參考數據的新表。

2. 將主要欄重新命名為名稱。

   下列範例顯示自訂區域的新資料表。

   

   在此範例中，我們也為會計年度建立了新的自訂係數資料表。

3. 將名稱欄設定為名為 naturalkey 的其他索引鍵。

   

將表添加到 Sustainability Manager

當你在中 Power Apps添加新的表時，你還需要將其添加到 Sustainability Manager app 模組中。

1. 在 Power Apps 門戶中，選擇 Sustainability Manager 。

2. 在 Sustainability Manager 磁貼上，選擇省略號 (...)，然後選擇 OPEN IN APP DESIGNER。

   

3. 在應用程式設計器中，選擇 Data (資料 )，然後選擇 Find table name (查找表名稱)。

4. 選擇省略號 (...)，選擇添加到應用程式 ，選擇保存 ，然後選擇發佈 。

   

該表將添加到 Sustainability Manager 中，並顯示在參考數據清單和導航中。

如果要將其從導航中刪除，請選擇 左側導航窗格中的 Pages 。 選擇表，選擇 從導航中刪除，選擇 保存，然後選擇 發佈。

創建自訂解決方案

由於預設實體位於受管理的解決方案中，因此您必須創建一個新的解決方案，並將活動實體和新的自定義引用數據實體導入到其中。

1. 在解決方案頁面上，選取新增解決方案。 輸入新解決方案的資訊，然後選取建立。

   

2. 在物件頁面上，選取新增現有的，然後選取資料表。

   

3. 在 Add existing tables 頁面上，選擇您創建的活動和自定義參考數據表。 在我們的示例中，我們添加了 Purchased energy activity (購買的能源 活動) 表和 Custom Region reference (自定義區域 ) 參考數據表。

   

   

使用查詢擴充活動資料表

1. 新增新的從活動資料表至擴充係數資料表的多對一關聯。 在我們的示例中，我們將從 Purchased energy activity (購買的能源 ) 活動表 添加到 Custom Region (自定義區域 ) 參考數據表的多對一關係 。

   

將自訂參考數據表添加到應用程式

注意

這是必需的步驟。 即使您不想將自定義參考數據表包含在導航功能表中，仍需要將表添加到應用程式中。 如果跳過此步驟，則參考數據在因數對應導入或手動輸入體驗中將不可用。

1. 將 Sustainability Manager App 物件添加到新解決方案中。

   

   下列範例顯示新的解決方案及其資源。

   

2. 選擇 Sustainability Manager，在編輯模式中打開它，然後選擇 新建。 在新增頁面視窗中，選取 Dataverse 資料表。

   

3. 選擇選取現有資料表。 在 Select a table（選擇表 ） 窗格中，選擇要用於因數映射的每個自訂參考數據表。 選取新增。

   注意

   如果您不希望自定義參考表格顯示在導航功能表中，請取消選中 Show in navigation 複選框。

   

   在所有其他頁面下，新加入的自訂資料表會出現。

4. 儲存並發佈變更。

將係數連結至 Sustainability Manager 係數對應

由於此程序只能透過 Dataverse API 使用，因此需要開發人員專業知識。

您必須自訂多資料表查詢以取得自訂資料表的係數對應。 您可以將 Power Apps Web API 與 Insomnia 等工具或慣用 API 用戶端搭配使用。 如需有關透過 Insomnia 傳送已驗證 POST 要求的詳細資料，請前往將 Insomnia 與 Dataverse Web API 搭配使用。

對於每個自訂資料表，您必須在計算中啟用係數對應。 在本範例中，我們必須對自訂區域和會計年度資料表執行該動作。 您需要每個資料表的邏輯名稱。 例如，自訂區域的邏輯名稱是 cr040_newtable，而會計年度的邏輯名稱是 cr040_newtable1。

對於每個自訂資料表，我們需要更新每個用於係數對應的多型查詢，而這是邏輯名稱為 msdyn_emissionlookup 的資料表。 這些查詢的邏輯名稱如下：

• msdyn_referencedataid
• msdyn_referencedata2id
• msdyn_referencedata3id
• msdyn_referencedata4id

對於單一自訂資料表，您需要傳送四個 POST 要求，係數對應中所用四個查詢中的每個查詢各一個要求。 使用進階工具 (例如 Insomnia) 或您慣用的 API 用戶端，向組織的 RelationshipDefinitions API 發出 POST 要求。

在本案例中，端點是 https://<orgurl>/api/data/v9.2/RelationshipDefinitions。 我們對八個 POST 要求中的每一個都使用了下列範例承載 (兩個資料表，每個資料表各有四個要求)：

注意

“SchemaName” 在您的 Dataverse 環境中必須是唯一的。

{
  "SchemaName": "msdyn_msdyn_emissionlookup_<custom factor table name>",
  "@odata.type": "Microsoft.Dynamics.CRM.OneToManyRelationshipMetadata",
  "CascadeConfiguration": {
    "Assign": "NoCascade",
    "Delete": "RemoveLink",
    "Merge": "NoCascade",
    "Reparent": "NoCascade",
    "Share": "NoCascade",
    "Unshare": "NoCascade"
  },
  "ReferencedEntity": "<custom factor table logical name>",
  "ReferencingEntity": "msdyn_emissionlookup",
  "ReferencingAttribute": "<polymorphic lookup name>",
  "Lookup": {
    "AttributeType": "Lookup",
    "AttributeTypeName": {
      "Value": "LookupType"
    },
    "SchemaName": "<polymorphic lookup name>",
    "@odata.type": "Microsoft.Dynamics.CRM.LookupAttributeMetadata"
  }
}

下表顯示八個 POST 要求用於 <自訂係數資料表名稱>、<自訂係數資料表邏輯名稱> 和 <多型查詢名稱> 的值。

要求	自訂係數資料表名稱	自訂係數資料表邏輯名稱	多型查詢名稱
1	FiscalYear_RDId	cr040_newtable1	msdyn_referencedataid
2	FiscalYear_RDId2	cr040_newtable1	msdyn_referencedata2id
3	FiscalYear_RDId3	cr040_newtable1	msdyn_referencedata3id
4	FiscalYear_RDId4	cr040_newtable1	msdyn_referencedata4id
5	CustomRegion_RDId	cr040_newtable	msdyn_referencedataid
6	CustomRegion_RDId2	cr040_newtable	msdyn_referencedata2id
7	CustomRegion_RDId3	cr040_newtable	msdyn_referencedata3id
8	CustomRegion_RDId4	cr040_newtable	msdyn_referencedata4id

成功的 POST 要求向您提供 HTTP 204 回應。

您可以檢查係數對應資料表的關聯來驗證這些作業。

如果您要將變更匯出至不同的環境，則可以將先前新增的關聯加入解決方案中，並將其匯出。

將 Sustainability Manager 參考資料連結至新係數

1. 在資料表中，選取全部索引標籤，然後選取參考資料 (msdyn_referencedata)。

2. 為每個新的係數類型新增下列資訊：

   欄位	描述
   名稱	資料表的複數名稱。 例如，自訂區域或會計年度。
   類別	參考資料
   實體名稱	資料表的邏輯名稱，全部小寫 (不是資料表的結構描述名稱)。 例如， cr040_newtable 或 cr040_newtable1。

授權 Sustainability Manager 存取外部資料表

如果尚未提供，則 Sustainability Manager 必須獲得外部資料表的存取權，這樣才能在計算中使用這些資料表。

1. 移至解決方案 > Microsoft Sustainability Manager 應用程式。

2. 選取資訊安全角色，然後選取永續性服務應用程式角色 – 自訂。 新的瀏覽器索引標籤會開啟。

3. 在新的瀏覽器索引標籤中，選取自訂實體索引標籤。

4. 對於每個要用於係數對應的自訂資料表，提供組織層級的讀取及附加至權限。

   注意

   對於每個自訂資料表，您也必須將全組織範圍的讀取權限授與任何透過查詢指向的資料表。 例如，如果自訂區域有 Contoso SKU 資料表的查詢，就必須將讀取權限授與 Contoso SKU 資料表。

5. 儲存後關閉。

授權使用者存取這些資料表

對於每個自訂資料表 (例如自訂區域或會計年度)，確定擷取係數對應或執行計算的 Power Apps 使用者對資料表擁有下列全組織權限：

• Append To 用於攝取

• 讀取 以創建因數映射或在使用自定義表的計算中使用因數映射

測試自定義參考數據和因數映射之間的連結

1. 確保在門戶中 Power Apps 發佈所有自定義項。

2. 填充自定義參考數據表 (在我們的示例中為 Custom Regions 和 會計年度 )。

   

3. 使用 Sustainability Manager Power Apps 或入口導入或輸入因數映射。

   

4. 使用 Sustainability Manager 導入或輸入活動數據。

下圖顯示了一個名為 Extended Factors Library 的係數庫示例，其中包含使用自定義參考數據 (自定義區域 和 會計年度) 的映射。

在計算模型中使用擴充係數

在 Power Apps 入口網站中，設計計算模型，並在計算設定檔中使用此模型。

注意

您可在計算設定檔中使用篩選，以確保查詢含有值。

您可以視需要在計算設定檔中使用擴充屬性。

常見問題

當我手動創建新因數對應時，我沒有看到我的自定義表作為 Reference data (參考數據) 的選項

1. 請確定使用者有自訂資料表的適當權限。

2. 請確定自訂資料表至少有一個記錄。

3. 確保您在 msdyn_referencedata 中添加了自訂表的架構名稱 (區分大小寫)。

4. 確保將自定義表添加到 Sustainability Manager App 物件中，如本文前面所述。

5. 從瀏覽器硬刷新頁面。

導入因數映射時，我在 Field 對應 Experience 中沒有看到我的自定義參考數據表作為選項

1. 請確定使用者有自訂資料表的適當權限。

2. 確保您在 msdyn_referencedata 中添加了自訂表的架構名稱 (區分大小寫)。

3. 確保將自定義表添加到 Sustainability Manager App 物件中，如本文前面所述。

4. 從瀏覽器硬刷新頁面。

若要將自訂資料表的記錄用於資料核准，這些記錄應視為「已核准」還是「待處理」？

自訂資料表的所有記錄都會視為「已核准」，以便在計算係數對應的內容下用於資料核准。

我的因數映射導入失敗，缺少使用者的許可權 prvAppendTo_[您的自定義表]

Sustainability Manager 應用程式使用者或目前使用者未獲授與自訂資料表的附加至權限。 請確定 Sustainability Manager 和使用者都有適當的權限，然後重新嘗試匯入。

在計算模型中，報表節點的 [排放係數] 或估計係數節點的 [估計係數] 下拉式清單中沒有看到我的自訂資料表成為選項

請確定您已為自訂資料表新增 msdyn_referencedata 記錄。

檢查以確認您的自訂資料表 msdyn_referencedata 記錄中的實體名稱值含有的是資料表的邏輯名稱 (區分大小寫)，而不是結構描述名稱。 移至資料表 > 屬性、展開進階選項，然後檢視邏輯名稱。

請確定計算來源的活動資料有一個指向自訂資料表的查詢欄位。 例如，如果為了查詢自訂區域進行自訂的是固定燃燒源，而不是移動燃燒源，則對移動燃燒源 的計算無法使用根據 Contoso 區域進行的係數對應。

自訂多個環境

您可能需要對一個環境進行這些自訂，然後將這些自訂套用至另一個環境。 例如，您可以在開發環境中進行所有自訂，然後需要將這些自訂匯入至生產環境。 在這種情況下，您可以依照下列步驟，將重複工作減至最少。

1. 對於任何用來將變更從一個環境匯出至另一個環境的解決方案，您必須將這些自訂加入該解決方案中：

   • 將自訂資料表新增至 Sustainability Manager。

   • 將更多關聯新增至係數對應的多型查詢。

   然後就可以匯入應用程式生命週期管理 (ALM) 的解決方案。

2. 針對每個環境，執行下列動作：

   • 新增 msdyn_referencedata 記錄。

   • 自訂 Sustainability Manager 應用程式資訊安全角色。

📄 培訓產品頁面
🎓

✅ 免費試用
🎥 YouTube 頻道

💻 社區
LinkedIn 組