Apex を使用したレコードの共有

1public class JobSharing {
2   
3   public static boolean manualShareRead(Id recordId, Id userOrGroupId){
4      // Create new sharing object for the custom object Job.
5      Job__Share jobShr  = new Job__Share();
6   
7      // Set the ID of record being shared.
8      jobShr.ParentId = recordId;
9        
10      // Set the ID of user or group being granted access.
11      jobShr.UserOrGroupId = userOrGroupId;
12        
13      // Set the access level.
14      jobShr.AccessLevel = 'Read';
15        
16      // Set rowCause to 'manual' for manual sharing.
17      // This line can be omitted as 'manual' is the default value for sharing objects.
18      jobShr.RowCause = Schema.Job__Share.RowCause.Manual;
19        
20      // Insert the sharing record and capture the save result. 
21      // The false parameter allows for partial processing if multiple records passed 
22      // into the operation.
23      Database.SaveResult sr = Database.insert(jobShr,false);
24
25      // Process the save results.
26      if(sr.isSuccess()){
27         // Indicates success
28         return true;
29      }
30      else {
31         // Get first save result error.
32         Database.Error err = sr.getErrors()[0];
33         
34         // Check if the error is related to trival access level.
35         // Access level must be more permissive than the object's default.
36         // These sharing records are not required and thus an insert exception is acceptable. 
37         if(err.getStatusCode() == StatusCode.FIELD_FILTER_VALIDATION_EXCEPTION  &&  
38                  err.getMessage().contains('AccessLevel')){
39            // Indicates success.
40            return true;
41         }
42         else{
43            // Indicates failure.
44            return false;
45         }
46       }
47   }
48   
49}

1@isTest
2private class JobSharingTest {
3   // Test for the manualShareRead method
4   static testMethod void testManualShareRead(){
5      // Select users for the test.
6      List<User> users = [SELECT Id FROM User WHERE IsActive = true LIMIT 2];
7      Id User1Id = users[0].Id;
8      Id User2Id = users[1].Id;
9   
10      // Create new job.
11      Job__c j = new Job__c();
12      j.Name = 'Test Job';
13      j.OwnerId = user1Id;
14      insert j;    
15                
16      // Insert manual share for user who is not record owner.
17      System.assertEquals(JobSharing.manualShareRead(j.Id, user2Id), true);
18   
19      // Query job sharing records.
20      List<Job__Share> jShrs = [SELECT Id, UserOrGroupId, AccessLevel, 
21         RowCause FROM job__share WHERE ParentId = :j.Id AND UserOrGroupId= :user2Id];
22      
23      // Test for only one manual share on job.
24      System.assertEquals(jShrs.size(), 1, 'Set the object\'s sharing model to Private.');
25      
26      // Test attributes of manual share.
27      System.assertEquals(jShrs[0].AccessLevel, 'Read');
28      System.assertEquals(jShrs[0].RowCause, 'Manual');
29      System.assertEquals(jShrs[0].UserOrGroupId, user2Id);
30      
31      // Test invalid job Id.
32      delete j;   
33   
34      // Insert manual share for deleted job id. 
35      System.assertEquals(JobSharing.manualShareRead(j.Id, user2Id), false);
36   }  
37}

1MyReasonName__c

1trigger JobApexSharing on Job__c (after insert) {
2    
3    if(trigger.isInsert){
4        // Create a new list of sharing objects for Job
5        List<Job__Share> jobShrs  = new List<Job__Share>();
6        
7        // Declare variables for recruiting and hiring manager sharing
8        Job__Share recruiterShr;
9        Job__Share hmShr;
10        
11        for(Job__c job : trigger.new){
12            // Instantiate the sharing objects
13            recruiterShr = new Job__Share();
14            hmShr = new Job__Share();
15            
16            // Set the ID of record being shared
17            recruiterShr.ParentId = job.Id;
18            hmShr.ParentId = job.Id;
19            
20            // Set the ID of user or group being granted access
21            recruiterShr.UserOrGroupId = job.Recruiter__c;
22            hmShr.UserOrGroupId = job.Hiring_Manager__c;
23            
24            // Set the access level
25            recruiterShr.AccessLevel = 'edit';
26            hmShr.AccessLevel = 'read';
27            
28            // Set the Apex sharing reason for hiring manager and recruiter
29            recruiterShr.RowCause = Schema.Job__Share.RowCause.Recruiter__c;
30            hmShr.RowCause = Schema.Job__Share.RowCause.Hiring_Manager__c;
31            
32            // Add objects to list for insert
33            jobShrs.add(recruiterShr);
34            jobShrs.add(hmShr);
35        }
36        
37        // Insert sharing records and capture save result 
38        // The false parameter allows for partial processing if multiple records are passed 
39        // into the operation 
40        Database.SaveResult[] lsr = Database.insert(jobShrs,false);
41        
42        // Create counter
43        Integer i=0;
44        
45        // Process the save results
46        for(Database.SaveResult sr : lsr){
47            if(!sr.isSuccess()){
48                // Get the first save result error
49                Database.Error err = sr.getErrors()[0];
50                
51                // Check if the error is related to a trivial access level
52                // Access levels equal or more permissive than the object's default 
53                // access level are not allowed. 
54                // These sharing records are not required and thus an insert exception is 
55                // acceptable. 
56                if(!(err.getStatusCode() == StatusCode.FIELD_FILTER_VALIDATION_EXCEPTION  
57                                               &&  err.getMessage().contains('AccessLevel'))){
58                    // Throw an error when the error is not related to trivial access level.
59                    trigger.newMap.get(jobShrs[i].ParentId).
60                      addError(
61                       'Unable to grant sharing access due to following exception: '
62                       + err.getMessage());
63                }
64            }
65            i++;
66        }   
67    }
68    
69}