レコードまたは他のユーザーをフォローしているユーザーのサブスクリプションを表します。このオブジェクトは、API バージョン 34.0 以降で使用できます。
ユーザーはレコードまたは他のユーザーを登録できます。レコードへの変更とユーザーからの更新は、ユーザーのホームページの Chatter フィードに表示されます。これは、Salesforce で他のユーザーやレコードに加えられた変更の最新状況を把握するのに役立ちます。フィードは、API バージョン 18.0 以降で使用できます。
サポートされているコール
create()、delete()、describeSObjects()、getDeleted()、getUpdated()、query()、retrieve()
項目
| NetworkId |
- 型
- reference
- プロパティ
- Create、Filter、Group、Nillable、Sort
- 説明
- ユーザーがレコードまたはユーザーをフォローしている Experience Cloud サイトの ID。組織でデジタルエクスペリエンスが有効化されている場合、この項目は API バージョン 26.0 以降で使用できます。
|
| ParentId |
- 型
- reference
- プロパティ
- Create、Filter、Group、Sort
- 説明
- 必須。ユーザーがフォローしているレコードまたはユーザーの ID。
- これは多態的なリレーション項目です。
- リレーション名
- Parent
- リレーション種別
- Lookup
- 参照先
- Account、Accreditation、ActivationTarget、ActivationTrgtIntOrgAccess、ApiAnomalyEventStore、AssessmentIndicatorDefinition、AssessmentTask、AssessmentTaskContentDocument、AssessmentTaskDefinition、AssessmentTaskIndDefinition、AssessmentTaskOrder、Asset、AssetRelationship、AssignedResource、Award、BoardCertification、BusinessLicense、BusinessMilestone、BusinessProfile、Campaign、CareBarrier、CareBarrierDeterminant、CareBarrierType、CareDeterminant、CareDeterminantType、CareDiagnosis、CareInterventionType、CareMetricTarget、CareObservation、CareObservationComponent、CarePgmProvHealthcareProvider、CarePreauth、CarePreauthItem、CareProgram、CareProgramCampaign、CareProgramEligibilityRule、CareProgramEnrollee、CareProgramEnrolleeProduct、CareProgramEnrollmentCard、CareProgramGoal、CareProgramProduct、CareProgramProvider、CareProgramTeamMember、CareProviderAdverseAction、CareProviderFacilitySpecialty、CareProviderSearchableField、CareRegisteredDevice、CareRequest、CareRequestDrug、CareRequestExtension、CareRequestItem、CareSpecialty、CareSpecialtyTaxonomy、CareTaxonomy、Case、CodeSet、CollaborationGroup、CommSubscription、CommSubscriptionChannelType、CommSubscriptionConsent、CommSubscriptionTiming、ConsumptionSchedule、Contact、ContactEncounter、ContactEncounterParticipant、ContentDocument、Contract、CoverageBenefit、CoverageBenefitItem、CredentialStuffingEventStore、CreditMemo、CreditMemoLine、Dashboard、DashboardComponent、DataStream、DelegatedAccount、DocumentChecklistItem、EngagementChannelType、EnhancedLetterhead、EnrollmentEligibilityCriteria、Event、HealthcareFacility、HealthcareFacilityNetwork、HealthcarePayerNetwork、HealthcarePractitionerFacility、HealthcareProvider、HealthcareProviderNpi、HealthcareProviderSpecialty、HealthcareProviderTaxonomy、Identifier、Image、IndividualApplication、Invoice、InvoiceLine、Lead、Location、MarketSegment、MarketSegmentActivation、MemberPlan、MessagingSession、MktCalculatedInsight、OperatingHours、Opportunity、Order、OrderItem、OtherComponentTask、PartyConsent、PersonEducation、PersonLanguage、PersonLifeEvent、PersonName、PlanBenefit、PlanBenefitItem、Product2、ProductFulfillmentLocation、ProductItem、ProductItemTransaction、ProductRequest、ProductRequestLineItem、ProductRequired、ProductTransfer、ProfileSkill、ProfileSkillEndorsement、ProfileSkillUser、ProviderSearchSyncLog、PurchaserPlan、PurchaserPlanAssn、ReceivedDocument、Report、ReportAnomalyEventStore、ResourceAbsence、ResourcePreference、ReturnOrder、ReturnOrderLineItem、ServiceAppointment、ServiceResource、ServiceResourceSkill、ServiceTerritory、ServiceTerritoryMember、ServiceTerritoryWorkType、SessionHijackingEventStore、Shift、Shipment、ShipmentItem、Site、SkillRequirement、SocialPost、Solution、Task、ThreatDetectionFeedback、Topic、User、Visit、VisitedParty、Visitor、VoiceCall、VolunteerProject、WorkBadgeDefinition、WorkOrder、WorkOrderLineItem、WorkType、WorkTypeGroup、WorkTypeGroupMember
|
| SubscriberId |
- 型
- reference
- プロパティ
- Create、Filter、Group、Sort
- 説明
- 必須。レコードまたはユーザーをフォローしているユーザーの ID。
- これはリレーション項目です。
- リレーション名
- Subscriber
- リレーション種別
- Lookup
- 参照先
- User
|
使用方法
レコードおよびユーザーをフォローしているときは、次の点に留意してください。
EntitySubscription を指定して query() を使用する場合
- 次の SOQL 制限に注意してください。ログインしたユーザーに「すべてのデータの参照」権限がある場合、SOQL の制限はありません。この権限がない場合は、LIMIT 句に 1,000 レコード以下を指定してください。
-
WHERE 句を使用したクエリでは、EntitySubscription オブジェクトに対して項目を基準に条件検索のみ実行できます。
- ユーザー共有が有効になっていて、クエリ実行ユーザーがシステム管理者でない場合、ParentId または SubscriberId で SOQL クエリを制限する必要があります。制限しないと、クエリの実行時の動作が不明確になります。つまり、結果セットが不完全、または呼び出しごとに異なる可能性があります。クエリを制限しない場合、結果セットの各行で親と対象の両方に対してアクセスチェックが実行されるため、クエリが完了する前に、非管理ユーザーに適用される共有チェック制限を超える可能性が高くなります。SOQL クエリを実行する代わりに、Connect REST API を使用して EntitySubscription データを照会することをお勧めします。
- 「すべてのデータの編集」権限のないユーザーの場合
- オブジェクトのレコードをフォローしているユーザーを表示するには、ParentId 項目に関連付けられているオブジェクトへの参照権限が必要です。
-
ORDER BY 句を使用したクエリは、EntitySubscription オブジェクトの項目で並べ替える場合にのみ使用できます。たとえば、サブスクリプションが Account レコードに関連する場合、クエリは ORDER BY ParentId を実行できますが、ORDER BY Account.Name は実行できません。
- クエリを実行するとき、一致するすべてのサブスクリプションを取得できない場合があります。これらのユーザーの場合、クエリは最大 500 件のレコードの表示基準を評価し、クエリが長時間実行される可能性を削減します。ユーザーが CEO のサブスクリプションを表示するクエリを実行する場合、クエリは大量のレコードをスキャンする可能性があります。クエリはスキャンされた最初の 500 件のレコードでの一致のみを返します。ユーザーに表示されているサブスクリプションより多くのサブスクリプションがある可能性がありますが、それらは返されません。この問題を解消するため、可能な場合、WHERE 句を使用して、クエリの範囲を絞ることをお勧めします。
サンプル — SOQL
次の SOQL クエリでは、サブスクライバーがフォローしているすべての取引先のうち、従業員数が 10 名を超える取引先のサブスクリプションを返します。
1SELECT Id
2FROM EntitySubscription
3WHERE SubscriberId = '005U0000000Rg2CIAS'
4AND ParentId IN (
5 SELECT Id FROM Account
6 WHERE NumberOfEmployees > 10
7)
8LIMIT 200
j