AccountShare | Salesforce および Force.com のオブジェクトリファレンス

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

describeSObjects()、create()、delete()、query()、retrieve()、update()、upsert()

特別なアクセスルール

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

項目

一部の項目で使用可能なプロパティは、組織でデフォルトとなっている共有設定によって異なります。一覧表示されているプロパティは、それらの項目のデフォルト設定の場合に該当します。

項目	詳細
AccountAccessLevel	型 picklist プロパティ Filter、Group、Restricted picklist、Sort 説明 Account に対して割り当てる User または Group のアクセスのレベル。値は次のとおりです。 Read Edit All (この値は、create コールまたは update コールには使用できません)。この項目は、少なくとも組織のデフォルトである Account のアクセスレベルと同等のアクセスレベルに設定する必要があります。また、この項目、OpportunityAccessLevel 項目、CaseAccessLevel 項目のいずれかを、組織のデフォルトのアクセスレベルより高いレベルに設定する必要があります。
AccountId	型 reference プロパティ Filter、Group、Sort 説明この共有エントリに関連付けられた Account の ID。この項目は更新できません。
CaseAccessLevel	型 picklist プロパティ Filter、Group、Restricted picklist、Sort 説明取引先に関連するケースに対して割り当てる User または Group のアクセスのレベル。値は次のとおりです。 None Read Edit この項目は、少なくとも組織のデフォルトである CaseAccessLevel と同等のアクセスレベルに設定する必要があります。AccountAccessLevel 項目が「`All`」に設定されている場合、この項目を API を使用して更新することはできません。API を使用して、関連付けられている取引先所有者のこの項目を更新することはできません。Salesforce ユーザインターフェースを使用して、取引先所有者の CaseAccessLevel を更新する必要があります。
ContactAccessLevel	型 picklist プロパティ Filter、Group、Nillable、Restricted picklist、Sort 説明取引先に関連する取引先責任者に対して持つ User または Group のアクセスのレベル。値は次のとおりです。 None Read Edit この項目は、��なくとも組織のデフォルトである ContactAccessLevel と同等のアクセスレベルに設定する必要があります。ContactAccessLevel 項目が「Controlled by Parent」に設定されている場合、この項目を API を使用して更新することはできません。API を使用して、関連付けられている取引先所有者のこの項目を更新することはできません。Salesforce ユーザインターフェースを使用して、取引先所有者の ContactAccessLevel を更新する必要があります。
IsDeleted	型 boolean プロパティ Defaulted on create、Filter 説明オブジェクトがごみ箱に移動したか (`true`)、否か (`false`) を示します。表示ラベルは Deleted です。
OpportunityAccessLevel	型 picklist プロパティ Filter、Group、Restricted picklist、Sort 説明 Account に関連する商談に対して割り当てる User または Group のアクセスのレベル。値は次のとおりです。 None Read Edit この項目は、少なくとも組織のデフォルトの商談のアクセス権のレベルと同等のアクセスレベルに設定する必要があります。AccountAccessLevel 項目が「`All`」に設定されている場合、この項目を API を使用して更新することはできません。API を使用して、関連付けられている Account 所有者のこの項目を更新することはできません。Salesforce ユーザインターフェースを使用して、Account 所有者の opportunityAccessLevel を更新する必要があります。
RowCause	型 picklist プロパティ Filter、Group、Restricted picklist、Sort 説明共有エントリが存在する理由。この項目に書き込めるのは、その値が省略されているか、`Manual` (デフォルト) に設定されている場合のみです。正しい組織の共有設定を使用して、バージョン 32.0 以降でこの項目の値を作成できます。使用できる値は次のとおりです。 `Manual` —「All」のアクセス権を持つ User が手動で Account を共有していたため、User または Group にアクセス権が割り当てられています。 `Owner`: User は、Account の所有者です。 `Team`— User または Group には、チームアクセス権があります (AccountTeamMember です)。 `Rule`— User または Group には、Account 共有ルールを介したアクセス権が割り当てられています。
UserOrGroupId	型 reference プロパティ Filter、Group、Sort 説明 Account に対してアクセス権が割り当てられた User または Group の ID。この項目は更新できません。

使用方法

このオブジェクトを使用して、他のユーザが所有する Account レコードを参照および編集できるユーザやグループを指定できます。

既存のレコードに一致する AccountShare レコードを作成すると、要求は、変更された項目を更新し、既存のレコードを返します。

たとえば、次のコードは、ユーザが所有するすべての取引先を検索し、ポータルユーザに対してそれらの取引先の共有を直接設定します。

1QueryResult result = conn.query("SELECT Id FROM Account WHERE OwnerId = '005D0000001LPFB'");
2// Create a new AccountShare object
3List<AccountShare> shares = new ArrayList<AccountShare>();
4for (SObject rec : result.getRecords()) {  
5     AccountShare share = new AccountShare();
6    share.setAccountId(rec.getId());
7    //Set the portal user Id to share the accounts with
8    share.setUserOrGroupId("003D000000QA8Tl");
9    share.setAccountAccessLevel("Edit");
10    share.setOpportunityAccessLevel("Read");
11    share.setCaseAccessLevel("Edit");
12    shares.add(share);
13}
14conn.create(shares.toArray(new AccountShare[shares.size()]));

このコードは、ある時点でユーザが所有する取引先を共有しますが、その後所有することになった取引先は共有しません。このような共有では、AccountOwnerSharingRule のような所有者ベースの共有ルールを使用します。