この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

UserRole

組織内のユーザロールを表します。

このオブジェクトは、以前のバージョンの API マニュアルでは「Role」となっています。

メモ

サポートされているコール

create()、delete()、describeSObjects()、getDeleted()、getUpdated()、query()、retrieve()、search()、update()、upsert()

特別なアクセスルール

Summer '20 以降、このオブジェクトにアクセスできるのは、「ロールおよびロール階層を表示」権限を持つユーザのみとなります。また、このオブジェクトを編集できるのは、「ロールを管理」権限を持つユーザのみとなります。

項目

項目	詳細
CaseAccessForAccountOwner	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort、Update 説明取引先所有者のケースのアクセスレベル。
ContactAccessForAccountOwner	型 picklist プロパティ Filter、Group、Nillable、Restricted picklist、Sort 説明取引先所有者の取引先責任者のアクセスレベル。 DefaultContactAccess が `Controlled by Parent` に設定されている場合、この項目は作成することも更新することもできません。メモ
DeveloperName	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明 API のオブジェクトの一意の名前。この名前は、アンダースコアと英数字のみを使用でき、組織内で一意にする必要があります。最初は文字であること、空白は使用しない、最後にアンダースコアを使用しない、2 つ続けてアンダースコアを使用しないという制約があります。管理パッケージでこの項目を使用することにより、パッケージインストール時の名前の競合を回避します。この項目を使用して、開発者は管理パッケージのオブジェクト名を変更し、変更は登録者の組織で反映されます。ユーザインターフェースの [ロール名] に対応します。この項目は、API バージョン 24.0 以降で使用できます。大規模データセットを作成する場合、必ず各レコードの一意の DeveloperName を指定してください。DeveloperName が指定されていないと、Salesforce で各レコードの DeveloperName を生成している間にパフォーマンスが低下する可能性があります。メモ
ForecastUserId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明このロールに関連付けられている売上予測マネージャの ID。表示ラベルは [ユーザ ID] です。
IsPartner	型 boolean プロパティ Defaulted on create、Filter 説明ユーザロールがパートナーポータルへのアクセス権を持つパートナーか (`true`)、否か (`false`) を示します。この項目はリリース 9.0 以降で使用できません。代わりに、値が `Partner` の PortalType を使用します。
MayForecastManagerShare	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明売上予測マネージャが手動で自身の売上予測を共有できるかどうかを示します。
Name	型 string プロパティ Create、Filter、Group、idLookup、Sort、Update 説明必須。ロールの名前。ユーザインターフェースの [表示ラベル] に対応します。
OpportunityAccessForAccountOwner	型 picklist プロパティ Create、Filter、Group、Restricted picklist、Sort、Update 説明必須。取引先所有者の商談のアクセスレベル。組織の共有設定で指定されているものより下位の商談アクセス権でユーザロールを設定することはできません。
ParentRoleId	型 reference プロパティ Create、Filter、Group、Nillable、Sort、Update 説明親ロールの ID。
PortalAccountId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明ロールの関連ポータル取引先の ID。この項目は参照のみです。
PortalAccountOwnerId	型 reference プロパティ Filter、Group、Nillable、Sort 説明ロールの関連ポータル取引先の所有者の ID。この項目は参照のみです。
PortalRole	型 picklist プロパティ Filter、Group、Nillable、Restricted picklist、Sort 説明ポータルロール: エグゼクティブ、マネージャ、ユーザ、または個人取引先。
PortalType	型 picklist プロパティ Create、Filter、Group、Nillable、Restricted picklist、Sort 説明この値は、ロールのポータルの種類を示します。 None: Salesforce アプリケーションロール。 CustomerPortal: カスタマーポータルのロール。 Partner: パートナーポータルロール。リリース 8.0 で使用されていた項目 IsPartner はこの値に対応付けます。この項目は、リリース 9.0 以降 IsPartner と置き換えられます。
RollupDescription	型 string プロパティ Create、Filter、Group、Nillable、Sort、Update 説明売上予測の積み上げに関する説明。表示ラベルは [説明] です。

使用方法

組織内に現在設定されているユーザロールのセットを照会するには、このオブジェクトを使用します。クライアントアプリケーションではこのオブジェクトにより、UserRole レコードのクエリや変更で使用する、有効な User ID を取得します。

「ロールおよびロール階層を表示」権限を持つユーザは、このオブジェクトをクエリおよび記述できます。クライアントアプリケーションが「ユーザの管理」権限でログインする場合、UserRole レコードをクエリ、作成、更新、または削除できます。

ポータルロールの項目を更新することはできません。

メモ

たとえば、次のコードはユーザに割り当てられていないすべてのロールを検出します。

1SELECT Id, Name, DeveloperName 
2FROM UserRole 
3WHERE Id NOT IN (SELECT UserRoleId 
4                 FROM User 
5                 WHERE UserRoleId !='000000000000000')

Salesforce および Lightning プラットフォームのオブジェクトリファレンス

UserRole

サポートされているコール

特別なアクセスルール

項目

使用方法

関連項目: