セキュリティ ロールとテンプレート
使用すべき対象 Microsoft Dataverse セキュリティ ロールを検索または処理する場合は RoleTemplateId。 これらのロール テンプレート ID は、すべての環境で一意かつ不変です。 ロール ID は特定のセキュリティ ロールに対して一意でないため、ロール ID を使用すると障害が発生する可能性があります。
重要
セキュリティ ロールはルート部署 (BU) に存在し、異なる BU に複製できます。したがって、ロール ID は環境間で一意ではありません。
詳細情報: Dataverse データベースのある環境
標準ロール テンプレート
以下は、すべての環境に存在する標準ロール テンプレート GUID のリストです。
public const string SystemAdmin = "{627090FF-40A3-4053-8790-584EDC5BE201}";
public const string Customizer = "{119F245C-3CC8-4b62-B31C-D1A046CED15D}";
public const string Support = "{2D101BB3-5CED-4122-83F1-94D5EFDE4E3B}";
public const string Proxy = "{D892CC0B-28C7-4e88-BD92-72F2C366BAED}";
public const string CDSUser = "{236750CD-45AE-4939-AB12-B24B920CED93}";
public const string BizMgr = "{85937B6B-91A1-46ED-9778-929FC9F61812}";
public const string VPSales = "{29123793-6AE5-4955-9F1A-F10CEB9705F1}";
public const string SalesMgr = "{C0ED2F4F-6F92-4691-92BA-78F2931E8FBA}";
public const string SalesRep = "{A4BE89FF-7C35-4D69-9900-999C3F603E6F}";
public const string CSR = "{ECFD0B44-5720-45E3-AE68-417DDB0FB654}";
public const string CSRMgr = "{1808B939-DD07-4CA7-AA99-DDD2734378F1}";
public const string MarketingProfessional = "{09A25608-D28B-4D47-B57C-79271FE6A525}";
public const string ScheduleMgr = "{DEBEC338-BCA7-4882-AE04-84E6DDDA2984}";
public const string VPMarketing = "{6CABA073-59A8-4D6B-8E7B-4CCB50C5166B}";
public const string MarketingMgr = "{D9D602DB-2761-4170-877F-983494567C08}";
public const string Scheduler = "{DCD60B89-421C-44ae-BFF0-DD6323DF885C}";
public const string KnowledgeMgr = "{B4B40B17-CF37-4EA8-B2C5-B580F2F48654}";
ロール テンプレートを使用する
ロール テンプレートの使用法を示すサンプル コードをいくつか確認しましょう。
この Web API 要求は、テンプレートを使用してシステム管理者ロールを返します。 <> が含むパラメーターは独自に入力するために残されています。
http://<env-name>.api.<region>.dynamics.com/api/data/v9.1/roles(_roletemplateid_value=627090FF-40A3-4053-8790-584EDC5BE201,_businessunitid_value=<bu-ID>,componentstate=0,overwritetime=1900-01-01T00:00:00Z)
この HTTP 要求は、EnvironmentMaker ロールのように不変なロール ID を持つロールを返します。 ロール テンプレートがないロールには、この要求を使用します。
http://<env-name>.api.<region>.dynamics.com/api/data/v9.1/roles(_parentrootroleid_value=<role-ID>,_businessunitid_value=<bu-ID>,componentstate=0,overwritetime=1900-01-01T00:00:00Z)
関連情報
Web API リファレンス
roletemplate EntityType
テーブル/エンティティ参照
セキュリティ ロール (Role)
フィードバック
フィードバックの送信と表示