Metadata API Developer’s Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

Newer Version Available

This content describes an older version of this product. View Latest

SharingReason

Represents an Apex sharing reason, which is used to indicate why sharing was implemented for a custom object. Apex managed sharing allows developers to use Apex to programmatically share custom objects. When you use Apex managed sharing to share a custom object, only users with the “Modify All Data” permission can add or change the sharing on the custom object's record, and the sharing access is maintained across record owner changes. For more information, see “Sharing Settings Overview” in the Salesforce online help.

Use SharingReason to create, update, or delete sharing reason definitions for a custom object. It extends the Metadata metadata type and inherits its fullName field.

Version

Sharing reasons are available in API version 14.0 and later.

Fields

Field Field Type Description
fullName string Required. Sharing reason name. The __c suffix is appended to custom sharing reasons.

Inherited from Metadata, this field is not defined in the WSDL for this metadata type. It must be specified when creating, updating, or deleting. See create() to see an example of this field specified for a call.
label string Required. Descriptive label for the sharing reason. Maximum of 40 characters.

Declarative Metadata Sample Definition

The definition of a sharing reason in a custom object:

1<CustomObject xmlns="http://soap.sforce.com/2006/04/metadata">
2. . .
3    <sharingReasons>
4        <fullName>recruiter__c</fullName>
5        <label>Recruiter</label>
6    </sharingReasons>
7 . . .
8</CustomObject>