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

UserRole

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

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

メモ

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

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

特別なアクセスルール

カスタマーポータルユーザはこのオブジェクトにアクセスできません。

項目

項目 詳細
CaseAccessForAccountOwner
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
取引先所有者のケースのアクセスレベル。
ContactAccessForAccountOwner
picklist
プロパティ
Filter、Group、Nillable、Restricted picklist、Sort
説明
取引先所有者の取引先責任者のアクセスレベル。

DefaultContactAccessControlled by Parent に設定されている場合、この項目は作成することも更新することもできません。

メモ

DeveloperName
string
プロパティ
Create、Defaulted on create、Filter、Group、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 以降で使用できません。代わりに、値が PartnerPortalType を使用します。
MayForecastManagerShare
boolean
プロパティ
Defaulted on create、Filter、Group、Sort
説明
売上予測マネージャが手動で自身の売上予測を共有できるかどうかを示します。
Name
string
プロパティ
Create、Filter、Group、Sort、Update
説明
必須。ロールの名前。ユーザインターフェースの [表示ラベル] に対応します。
OpportunityAccessForAccountOwner
picklist
プロパティ
Create、Filter、Group、Restricted picklist、Sort、Update
説明
必須。取引先所有者の商談のアクセスレベル。組織の共有設定で指定されているものより下位の商談ア��セス権でユーザロールを設定することはできません。
ParentRoleId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
親ロールの ID。
PortalRole
picklist
プロパティ
Filter、Nillable
説明
ポータルロール: エグゼクティブ、マネージャ、ユーザ、または個人取引先。
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 レコードをクエリ、作成、更新、または削除できます。

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

メモ

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