SystemUser (ユーザー) エンティティのメッセージとメソッド
公開日: 2016年11月
対象: Dynamics CRM 2015
システム ユーザーは、設置型Microsoft Dynamics 365 または Microsoft Dynamics CRM Online にサインインするためのアクセス権を持っているユーザーです。 システム ユーザーの管理にはさまざまな活動が含まれます。 これには、レポート階層に対するシステム ユーザーの追加、セキュリティ ロールの設定、システム ユーザーの上下関係の設定などが含まれます。 これらの各機能へのアクセスは、システム ユーザーが保有しているセキュリティ特権によって保護されています。 セキュリティ特権の基になるのは、システム ユーザーのセキュリティ ロールです。 システム ユーザーにセキュリティ ロールを割り当てたり、ユーザーをチームに関連付けるには、システム ユーザー プロファイルを作成し、保存しておく必要があります。 このエンティティのスキーマ名は SystemUser です。組織のエンティティ メタデータを表示するには、「組織のメタデータの参照」で説明されているメタデータ ブラウザー ソリューションをインストールします。 カスタマイズされていない組織のメタデータを、EntityMetadata.xlsx という名前の Excel ファイルで見ることもできます。このファイルは、ダウンロードした SDK の最上位のフォルダーに含まれています。
Dynamics CRM システム ユーザー アカウントは、有効または無効のいずれかにすることができます。Dynamics CRM では、有料ライセンスを持つ有効なシステム ユーザーのみが、アプリケーションに対するサインインを許可されます。
たとえば退社した営業担当者のアカウントなど、有効なシステム ユーザーのアカウントを無効に設定することで、履歴情報を維持できます。 休暇中などは、システム ユーザーのアカウントを無効に設定すると、そのユーザーがワークフロー プロセスから削除されます。 システム ユーザーを無効にすると、そのユーザーは有料のライセンスにカウントされないので、使用可能なライセンスの数が増えます。
注意
設置型インスタンスの Microsoft Dynamics 365 でシステム ユーザー エンティティのインスタンスを作成するには、システム ユーザーが Active Directory に存在している必要があります。
Microsoft Dynamics CRM Online でシステム ユーザー エンティティのインスタンスを作成するには、ユーザーの Microsoft アカウント が必要です。 また、プログラムを使ってユーザーに Microsoft Dynamics CRM Online への招待状を送信することはできません。 招待状は、Web アプリケーションから送信する必要があります。
IOrganizationService.Execute メソッドで、このエンティティに関連して使用されるメッセージを次の表に示します。
メッセージ |
説明 |
|---|---|
関連付けに参加している一対一のレコード間または一対多のレコード間のリンクを作成します。IOrganizationService.Associate メソッドを使用することもできます。詳細については、「エンティティ レコードに対する操作」を参照してください。 このエンティティで使用する既定の関連付けの一覧については、SystemUser エンティティのメタデータを参照してください。この情報は、組織のメタデータ内にあります。 前述のメタデータ ブラウザー情報を確認してください。 |
|
システム ユーザーを作成します。IOrganizationService.Create メソッドを呼び出すこともできます。 |
|
関連付けに参加している一対一のレコード間または一対多のレコード間からリンクを削除します。IOrganizationService.Disassociate メソッドを使用することもできます。詳細については、「エンティティ レコードに対する操作」を参照してください。 このエンティティで使用する既定の関連付けの一覧については、SystemUser エンティティのメタデータを参照してください。この情報は、組織のメタデータ内にあります。 前述のメタデータ ブラウザー情報を確認してください。 |
|
2 つのエンティティに属性マップが定義されている場合に、既存のレコードに基づいて新しいレコードを初期化します。 詳細については、「エンティティ マッピングおよび属性マッピングのカスタマイズ」を参照してください。 |
|
重複データ検出が有効であり、エンティティ用の重複データ検出ルールが公開済みである場合に、指定されたレコードについて重複レコードを検出および取得します。 詳細については、「重複データの検出」を参照してください。 |
|
指定したシステム ユーザーが所有するすべてのエンティティを、別のシステム ユーザーまたはチームに再割り当てします。 |
|
システム ユーザーを取得します。IOrganizationService.Retrieve メソッドを呼び出すこともできます。 |
|
レコードの親を削除します。 |
|
指定したシステム ユーザーの部下であるシステム ユーザーのコレクションを取得します。 |
|
システム ユーザーのコレクションを取得します。IOrganizationService.RetrieveMultiple メソッドを呼び出すこともできます。 |
|
ユーザーまたはチームが FieldSecurityProfile エンティティとの直接または間接 (チーム メンバーシップ経由) の関連付けを通じて持つすべてのセキュリティ保護された属性特権を取得します。 |
|
削除されました。RetrieveMultipleRequest クラスが使用されます。 指定したシステム ユーザーがメンバーになっているチームのコレクションを取得します。 |
|
指定された部署におけるロールを通じて、システム ユーザー (ユーザー) が持つすべての特権を取得します。 |
|
削除されました。RetrieveMultipleRequest クラスが使用されます。 指定されたシステム ユーザーのシステム ユーザー設定を取得します。 |
|
指定されたシステム ユーザーの部署を設定します。 |
|
指定されたシステム ユーザーの上位ユーザー (上司) を設定します。 |
|
システム ユーザーの状態を設定します。 指定できる状態は、SystemUser.Statecode 属性で定義されます。 事前バインド型を使用している場合は、SystemUserState 列挙体を使用します。 状態値の一覧については、SystemUser エンティティのメタデータを参照してください。この情報は、組織のメタデータ内にあります。 前述のメタデータ ブラウザー情報を確認してください。 |
|
システム ユーザーを更新します。IOrganizationService.Update メソッドを呼び出すこともできます。 |
|
削除されました。UpdateRequest クラスが使用されます。 システム ユーザーのシステム ユーザー設定を更新します。 |
関連項目
ユーザーとチームのエンティティ
SystemUser (user) entity privileges
ユーザー設定 (UserSettings) エンティティのメッセージおよびメソッド
© 2017 Microsoft. All rights reserved. 著作権