ビジュアル化に対するアクション (グラフ)

 

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

Microsoft Dynamics 365 SDK では、ビジュアル化エンティティの以下のアクションを実行できます。

組織所有のビジュアル化に対するアクション

組織所有のビジュアル化 (SavedQueryVisualization) にアクションを実行するには、システム管理者ロールまたはシステム カスタマイザー ロールが必要です。 組織所有のビジュアル化に対して以下のアクションを実行できます。

  • 組織所有のビジュアル化を作成、取得、更新、削除する。詳細:ビジュアル化の作成 (グラフ)

    注意

    組織所有のビジュアル化を更新したら、PublishAllXmlRequest メッセージを使用して、メタデータの変更を公開し、組織全体で参照できるようにする必要があります。 または、エンティティを公開するとき、そのエンティティに添付された未公開の組織所有のビジュアル化はすべて自動的に公開されます。

  • SavedQueryVisualization.PrimaryEntityTypeCode 属性を使用して、エンティティに添付されているすべての組織所有のビジュアル化を照会し、取得する。 複数の組織所有のビジュアル化を 1 つのエンティティに添付することができます。 ビジュアル化を添付できるエンティティの一覧については、「ビジュアル化がサポートされているエンティティ」を参照してください。 エンティティに添付されている組織所有のビジュアル化をすべて取得する方法を示すコード サンプルについては、「サンプル: エンティティに添付されているすべてのグラフの取得」を参照してください。

    注意

    ビジュアル化は、作成した後で変更または更新して、別のエンティティに添付することはできません。 つまりこれは、組織所有のビジュアル化の更新アクションについて SavedQueryVisualization.PrimaryEntityTypeCode 属性が有効ではないことを意味します。

  • SavedQueryVisualization.IsDefault 属性を true に設定して、組織所有のビジュアル化を、添付されているエンティティの既定のビジュアル化として指定する。 組織所有のビジュアル化をエンティティの既定のビジュアル化として設定すると、Microsoft Dynamics 365 でそのエンティティのビジュアル化の表示を選択したときに、そのビジュアル化が既定で表示されます。

    注意

    Microsoft Dynamics 365 SDK を使用して、すでに既定のビジュアル化が設定されているエンティティに対して、組織所有のビジュアル化を既定として設定すると、両方のビジュアル化がそのエンティティの既定のビジュアル化としてマークされます。 あるエンティティの既定のビジュアル化としてビジュアル化を設定する場合は、他のビジュアル化がいずれもがそのエンティティの既定のビジュアル化として設定されていないことを確認してください。

組織所有のビジュアル化エンティティでサポートされるメッセージの一覧については、「SavedQueryVisualization (システム グラフ) エンティティのメッセージおよびメソッド」を参照してください。

ユーザー所有のビジュアル化に対するアクション

ユーザー所有のビジュアル化 (UserQueryVisualization) に対して以下のアクションを実行できます。

  • ユーザー所有のビジュアル化を作成、取得、更新、削除する。詳細:ビジュアル化の作成 (グラフ)

  • UserQueryVisualization.PrimaryEntityTypeCode 属性を使用して、エンティティに添付されているすべてのユーザー所有のビジュアル化を照会し、取得します。 複数のユーザー所有のビジュアル化を 1 つのエンティティに添付することができます。 ビジュアル化を添付できるエンティティの一覧については、「ビジュアル化がサポートされているエンティティ」を参照してください。

    注意

    ビジュアル化は、作成した後で変更または更新して、別のエンティティに添付することはできません。 つまりこれは、ユーザー所有のビジュアル化の更新アクションについて UserQueryVisualization.PrimaryEntityTypeCode 属性が有効ではないことを意味します。

  • AssignRequest を使用してユーザー所有のビジュアル化を別のユーザーまたはチームに割り当てることにより、ユーザー所有のビジュアル化の所有権を変更する。

  • RetrievePrincipalAccessRequest を使用して、指定されたセキュリティ プリンシパル (ユーザーまたはチーム) がユーザー所有のビジュアル化に対して持っているアクセス権を取得する。 また、RetrieveSharedPrincipalsAndAccessRequest を使用して、ユーザー所有のビジュアル化に対するアクセス権を持つすべてのセキュリティ プリンシパル (ユーザーまたはチーム) と、そのアクセス権を取得することもできます。

  • GrantAccessRequestModifyAccessRequest、および RevokeAccessRequest の各メッセージを使用して、ユーザー所有のビジュアル化を特定領域の他のユーザーおよびチームと共有することにより、それらのユーザーおよびチームと共同作業する。

ユーザー所有のビジュアル化エンティティでサポートされるメッセージの一覧については、「UserQueryVisualization (ユーザー グラフ) エンティティのメッセージおよびメソッド」を参照してください。

関連項目

ビジュアル化を使用したデータの表示 (グラフ)
グラフの理解: 基盤となるデータとグラフ表現
ビジュアル化の作成 (グラフ)
サンプル グラフ
サンプル: グラフの作成、取得、更新、および削除
サンプル: エンティティに添付されているすべてのグラフの取得
サンプル: 他のユーザーへのグラフの割り当て
SavedQueryVisualization (システム グラフ) エンティティのメッセージおよびメソッド
UserQueryVisualization (ユーザー グラフ) エンティティのメッセージおよびメソッド

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権