カスタム因子マッピング (プレビュー)

[アーティクル]
12/19/2024

重要

この機能の一部またはすべては、プレビューリリースの一部として利用できます。コンテンツおよび機能は変更される場合があります。

Microsoft Sustainability Manager 要素マッピングで組み込みの参照データを使用します。カスタム要素マッピングを使用して、利用可能な要素マッピングのセットを拡張できます。たとえば、会計年度やカスタムリージョンなどの要素に基づいてアクティビティの計算をピボットすることができます。この記事では、この高度な構成について説明します。この構成は、Power Platform 管理センターで完了しておく必要があります。

注意

この記事の手順は、Microsoft Dataverse 管理と API に関する高度な専門知識が必要となります。この記事では、一般的なプラットフォームの操作については詳しく説明しません。 Power Platform 管理センターへのフルアクセスを持つ認可された管理者のみが、これらの設定ステップを完了することができます。

Sustainability Manager を拡張してカスタム要素マッピングを使用するには、次の手順に従います:

カスタム参照データを作成する
リンク因子からSustainability Manager因子へのマッピング
リンクSustainability Manager新しい要因への参照データ
Sustainability Managerに外部テーブルへのアクセスを許可する
ユーザーにテーブルへのアクセスを許可する
カスタム参照データと因子マッピング間のリンクをテストします
計算モデルで拡張係数を使用する

カスタム参照データを作成する

新しいテーブルの作成

Power Apps ポータルで、因子マッピングで参照データとして使用する新しいテーブルを作成します。
主カラム名を Name に変更します。

次の例は、カスタムリージョン の新しいテーブルを示しています。

この例では、会計年度 の新しいカスタム係数テーブルも作成しました。
Name 列を、 naturalkey という名前の代替キーとして設定します。

Sustainability Managerにテーブルを追加

Power Appsに新しいテーブルを追加する場合は、Sustainability Managerアプリモジュールにも追加する必要があります。

Power Apps ポータルでは、選択 Sustainability Managerです。
Sustainability Manager tile, 選択省略記号 (...) をクリックし、次に選択 [アプリデザイナーで開く] をクリックします。
アプリデザイナーで、選択 データ 、次に選択 テーブル名の検索 を選択します。
選択で省略記号 (...) を削除し、選択 アプリに追加、選択保存してから、選択公開します。

テーブルはSustainability Managerに追加され、参照データリストとナビゲーションに表示されます。

ナビゲーションから削除する場合は、左側のナビゲーションペインで選択 ページ をクリックします。テーブルを選択し、選択 ナビゲーションから削除、選択保存して、選択公開します。

ナビゲーションからテーブルを削除するスクリーンショット。

カスタマイズのためのソリューションを作成する

既定のエンティティは管理ソリューションにあるため、新しいソリューションを作成し、アクティビティエンティティと新しいカスタム参照データエンティティをそこにインポートする必要があります。

ソリューション ページで、新しいソリューション を選択します。新しいソリューションの情報を入力し、作成を選択します。
オブジェクト ページで 既存の追加 を選択し、テーブル を選択します。
既存のテーブルの追加 ページで、アクティビティと作成したカスタム参照データテーブルを選択します。この例では、 購入したエネルギー アクティビティテーブルと カスタムリージョン 参照データテーブルを追加しました。

ルックアップを使用してアクティビティテーブルを拡張する

新しい多対一の関係をアクティビティテーブルから拡張要素テーブルに追加します。この例では、 購入したエネルギー アクティビティテーブルから カスタムリージョン 参照データテーブルに多対1のリレーションシップを追加しています。

アプリにカスタム参照データテーブルを追加する

ヒント

これは必須の手順です。カスタム参照データテーブルをナビゲーションメニューに含めたくない場合でも、テーブルをアプリに追加する必要があります。この手順をスキップすると、ファクターマッピングのインポートまたは手動入力エクスペリエンスで参照データを利用できなくなります。

Sustainability Manager Appオブジェクトを新しいソリューションに追加します。

次の例は、新しいソリューションとそのリソースを示しています。
選択 Sustainability Manager で開き、編集モードで開いてから、選択 New を選択します。 ページの追加 ウィンドウで Dataverse テーブル を選択します。
既存のテーブルを選択する を選択します。 選択テーブル ペインで、因子マッピングに使用する各カスタム参照データテーブルを選択します。追加を選択します。

ヒント

カスタム参照テーブルをナビゲーションメニューに表示したくない場合は、 [ナビゲーションに表示] チェックボックスをオフにします。

他のすべてのページ に、新しく追加されたカスタムテーブルが表示されます。
変更を保存し、公開します。

要素を Sustainability Manager の要素マッピングにリンクする

この手順は Dataverse API 経由でのみ利用できるため、開発者の専門知識が必要です。

カスタムテーブルの要素マッピングの複数テーブルルックアップをカスタマイズする必要があります。 Power Apps Web API は、Insomnia などのツールや好みの API クライアントで使用できます。 Insomnia で認証済みの POST リクエストを送信する方法については、Dataverse Web API で Insomnia を使うを参照してください。

カスタムテーブルごとに、計算で要素マッピングを有効にする必要があります。この例では、カスタムリージョン と 会計年度 テーブルに対してこれを行う必要があります。各テーブルの論理名が必要です。たとえば、カスタムリージョン の論理名は cr040_newtable で、会計年度 の論理名は cr040_newtable1 です。

カスタムテーブルごとに、要素マッピングに使用される各多態性ルックアップ、つまり論理名 msdyn_emissionlookup を持つテーブルを更新する必要があります。これらのルックアップには、次の論理名があります:

msdyn_referencedataid
msdyn_referencedata2id
msdyn_referencedata3id
msdyn_referencedata4id

単一のカスタムテーブルの場合、要素マッピングで使用される 4 つのルックアップごとに 1 つずつ、計 4 つの POST リクエストを送信する必要があります。 Insomnia などの高度なツールまたは基本設定の API クライアントを使用して、組織の RelationshipDefinitions API に POST 要求を行います。

この場合、エンドポイントは https://<orgurl>/api/data/v9.2/RelationshipDefinitions です。 8 つの POST リクエストのそれぞれに次のサンプルペイロードを使用しました (それぞれ 4 つのリクエストを持つ 2 つのテーブル)。

メモ

「スキーマ名」 あなたの中でユニークでなければならない 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"
  }
}

次の表は、8 つの 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 の参照データを新しい要素にリンクする

テーブル で、すべて タブを選択し、参照データ (msdyn_referencedata) を選択します。

新しい要素タイプごとに以下の情報を追加します:

フィールド	説明
名前	テーブルの複数名。たとえば、カスタム領域または会計年度です。
カテゴリ	参照データ
エンティティ名	テーブルの論理名。すべて小文字です (テーブルのスキーマ名ではありません)。たとえば、 cr040_newtable または cr040_newtable1。

Sustainability Manager に外部テーブルへのアクセスを許可する

まだ提供されていない場合は、計算で使用できるように、Sustainability Manager に外部テーブルへのアクセス権を与える必要があります。

ソリューション > Microsoft Sustainability Manager アプリケーションApplication に移動します。
セキュリティロールを選択し、持続可能性サービスアプリケーションロール – カスタム を選択します。新しいブラウザータブが開きます。
新しいブラウザのタブで、カスタムエンティティ タブを選択します。
要素マッピングに使用するカスタムテーブルごとに、読み取り と追加権限を組織レベルで提供します。

メモ

カスタムテーブルごとに、ルックアップによって参照されるテーブルに対して組織全体の 読み取り 権限を与える必要もあります。たとえば、カスタムリージョン に Contoso SKU テーブルへのルックアップがある場合、Contoso SKU テーブルに 読み取り 権限を与える必要があります。
保存して閉じます。

ユーザーにテーブルへのアクセスを許可する

カスタムリージョン や 会計年度 などのカスタムテーブルごとに、Power Apps 要素マッピングを取り込むか計算を実行するユーザーには、テーブルに対する次の組織全体の権限があります。

追加先 摂取用
読む因子マッピングを作成したり、カスタムテーブルを使用する計算内で因子マッピングを使用する場合

カスタム参照データと因子マッピング間のリンクをテストします

すべてのカスタマイズが Power Apps ポータルに公開されていることを確認します。
カスタム参照データテーブル (この例では カスタムリージョン と 会計年度 ) に入力します。
Sustainability Managerまたは Power Apps ポータルを使用して因子マッピングをインポートまたは入力します。
Sustainability Managerを使用してアクティビティデータをインポートまたは入力します。

次の画像は、カスタム参照データ ( カスタム領域 および会計年度 ) を使用するマッピングを含む、 Extended Factors Library と呼ばれる係数ライブラリの例を示しています。

算定モデルで拡張係数を使用する

Power Apps ポータルで、算定モデルを設計し、算定プロファイルで使用します。

注意

算定プロファイルでフィルタリングを使用して、ルックアップに値があることを確認できます。

必要に応じて、算定プロファイルで拡張属性を使用できます。

よくあるご質問

新しい因子マッピングを手動で作成すると、カスタムテーブルが参照データのオプションとして表示されません。

ユーザーがカスタムテーブルに対する適切な権限を持っていることを確認してください。
カスタムテーブルに少なくとも 1 つのレコードがあることを確認してください。
msdyn_referencedataにカスタムテーブルのスキーマ名 (大文字と小文字が区別されます) を追加したことを確認します。
この記事の前半で説明したように、カスタムテーブルが Sustainability Manager Appオブジェクトに追加されていることを確認します。
ブラウザからページをハードリフレッシュします。

因子マッピングをインポートすると、カスタム参照データテーブルがフィールドのオプションとして表示されませんマッピングエクスペリエンス

ユーザーがカスタムテーブルに対する適切な権限を持っていることを確認してください。
msdyn_referencedataにカスタムテーブルのスキーマ名 (大文字と小文字が区別されます) を追加したことを確認します。
この記事の前半で説明したように、カスタムテーブルが Sustainability Manager Appオブジェクトに追加されていることを確認します。
ブラウザからページをハードリフレッシュします。

カスタムテーブルのレコードは、データ承認の目的で「承認済み」または「保留中」とみなされますか？

カスタムテーブルのすべてのレコードは、計算の要素マッピングのコンテキストでのデータ承認の目的で「承認済み」とみなされます。

ユーザーの権限prvAppendTo_[カスタムテーブル]が不足しているため、因子マッピングのインポートに失敗しました

Sustainability Managerアプリケーションユーザーまたは現在のユーザーには、カスタムテーブルに対する追加権限が付与されていませんでした。 Sustainability Manager とユーザーの両方が適切な権限を持っていることを確認してから、インポートを再試行してください。

カスタムテーブルに msdyn_referencedata レコードを追加したことを確認してください。

カスタムテーブルの msdyn_referencedata レコード内の エンティティ名 の値に、スキーマ名ではなくテーブルの論理名 (大文字と小文字が区別される) が含まれていることを確認してください。 テーブル > プロパティ に移動し、詳細オプション を展開して、論理名を表示します。

算定ソースのアクティビティデータに、カスタムテーブルを指すルックアップフィールドがあることを確認してください。たとえば、固定燃焼 を カスタムリージョン へのルックアップを持つようにカスタマイズし、移動燃焼 を持たないようにカスタマイズした場合、移動燃焼 の計算は Contoso リージョンに基づく係数マッピングを使用することができません。

複数の環境をカスタマイズする

ある環境でこれらのカスタマイズを行ってから、別の環境に適用することが必要になる場合があります。たとえば、すべてのカスタマイズを開発環境で行い、それを運用環境にインポートする必要がある場合があります。この場合、次の手順に従って作業の重複を最小限に抑えることができます。

ある環境から別の環境に変更をエクスポートするために使用したソリューションでは、そのソリューションに次のカスタマイズを含める必要があります。
- Sustainability Manager へのカスタムテーブルの追加。
- 要素マッピングの多態性検索へのリレーションシップの追加。
その後、アプリケーションライフサイクル管理 (ALM) 用のソリューションをインポートできます。
環境ごとに、次のアクションを実行します:
- msdyn_referencedata レコードを追加します。
- Sustainability Manager アプリケーションセキュリティロールをカスタマイズします。

📄 製品ページ
 🎓 トレーニング

✅ 無料トライアル
 🎥 YouTube チャンネル

💻 コミュニティ
 LinkedInグループ

次の方法で共有

カスタム因子マッピング (プレビュー)