Merge pull request #100 from docusign/feature/shared-access

Added Shared access code example

Author: InbarGazit

pom.xml

@@ -23,7 +23,7 @@
         <java.version>11</java.version>
         <oauth2.version>2.5.6</oauth2.version>
         <commonsio.version>2.11.0</commonsio.version>
-        <esignature.version>4.1.0</esignature.version>
+        <esignature.version>4.2.0</esignature.version>
         <rooms.version>1.1.0</rooms.version>
         <click.version>	1.2.2</click.version>
         <monitor.version>1.1.0</monitor.version>

src/main/java/com/docusign/DSConfiguration.java

@@ -35,6 +35,12 @@ public class DSConfiguration {
 
     public Boolean isConsentRedirectActivated = false;
 
+    private boolean additionalRedirect;
+
+    private boolean shareAccessExampleScenario;
+
+    private String principalUserId;
+
     @Value("${DS_TARGET_ACCOUNT_ID}")
     private String targetAccountId;
 

src/main/java/com/docusign/EG001ControllerEmbeddedSigning.java

@@ -37,14 +37,10 @@ public class EG001ControllerEmbeddedSigning extends AbstractEsignatureController
     private static final int ANCHOR_OFFSET_Y = 20;
     private static final int ANCHOR_OFFSET_X = 10;
     private static final String SIGNER_CLIENT_ID = "1000";
-    private final Session session;
-    private final User user;
 
     @Autowired
     public EG001ControllerEmbeddedSigning(DSConfiguration config, Session session, User user){
-        super(config, Boolean.valueOf(config.getQuickACG()) ? "quickEmbeddedSigning" : "eg001");
-        this.session = session;
-        this.user = user;
+        super(config, Boolean.valueOf(config.getQuickACG()) ? "quickEmbeddedSigning" : "eg001", session, user);
     }
 
     @Override

src/main/java/com/docusign/common/WorkArguments.java

@@ -82,4 +82,7 @@ public class WorkArguments {
     private String managerName;
     private String jobTitle;
     private String salary;
+    private String agentEmail;
+    private String agentName;
+    private String activationCode;
 }

src/main/java/com/docusign/controller/eSignature/examples/AbstractEsignatureController.java

@@ -2,9 +2,12 @@
 
 import com.docusign.DSConfiguration;
 import com.docusign.core.controller.AbstractController;
+import com.docusign.core.model.Session;
+import com.docusign.core.model.User;
 import com.docusign.esign.api.AccountsApi;
 import com.docusign.esign.api.EnvelopesApi;
 import com.docusign.esign.api.TemplatesApi;
+import com.docusign.esign.api.UsersApi;
 import com.docusign.esign.client.ApiClient;
 import com.docusign.esign.client.ApiException;
 import com.docusign.esign.client.auth.OAuth;
@@ -20,10 +23,14 @@ public abstract class AbstractEsignatureController extends AbstractController {
 
     protected static final String MODEL_ENVELOPE_OK = "envelopeOk";
     protected static final String MODEL_TEMPLATE_OK = "templateOk";
+    protected final Session session;
+    protected final User user;
     private static final String EXAMPLE_PAGES_PATH = "pages/esignature/examples/";
 
-    public AbstractEsignatureController(DSConfiguration config, String exampleName) {
+    public AbstractEsignatureController(DSConfiguration config, String exampleName, Session session, User user) {
         super(config, exampleName);
+        this.session = session;
+        this.user = user;
     }
 
     protected String getExamplePagesPath() {
@@ -42,6 +49,17 @@ protected ApiClient createApiClient(String basePath, String userAccessToken) {
         return apiClient;
     }
 
+    /**
+     * Gets the information about the currently logged user.
+     * @param basePath        URL to eSignature REST API
+     * @param userAccessToken user's access token
+     * @return an instance of the {@link OAuth.UserInfo}
+     */
+    protected OAuth.UserInfo getCurrentUserInfo(String basePath, String userAccessToken) throws ApiException {
+        ApiClient apiClient = createApiClient(basePath, userAccessToken);
+        return apiClient.getUserInfo(userAccessToken);
+    }
+
     /**
      * Creates a new instance of the eSignature EnvelopesApi. This method
      * creates an instance of the ApiClient class silently.
@@ -54,6 +72,18 @@ protected EnvelopesApi createEnvelopesApi(String basePath, String userAccessToke
         return new EnvelopesApi(apiClient);
     }
 
+    /**
+     * Creates a new instance of the eSignature UsersApi. This method
+     * creates an instance of the ApiClient class silently.
+     * @param basePath URL to eSignature REST API
+     * @param userAccessToken user's access token
+     * @return an instance of the {@link UsersApi}
+     */
+    protected UsersApi createUsersApi(String basePath, String userAccessToken) {
+        ApiClient apiClient = createApiClient(basePath, userAccessToken);
+        return new UsersApi(apiClient);
+    }
+
     /**
      * Creates a new instance of the eSignature TemplatesApi. This method
      * creates an instance of the ApiClient class silently.

src/main/java/com/docusign/controller/eSignature/examples/EG002ControllerSigningViaEmail.java

@@ -28,14 +28,9 @@
 @RequestMapping("/eg002")
 public class EG002ControllerSigningViaEmail extends AbstractEsignatureController {
 
-    private final Session session;
-    private final User user;
-
     @Autowired
     public EG002ControllerSigningViaEmail(DSConfiguration config, Session session, User user) {
-        super(config, "eg002");
-        this.session = session;
-        this.user = user;
+        super(config, "eg002", session, user);
     }
 
     @Override

src/main/java/com/docusign/controller/eSignature/examples/EG003ControllerListEnvelopes.java

@@ -26,14 +26,9 @@
 @RequestMapping("/eg003")
 public class EG003ControllerListEnvelopes extends AbstractEsignatureController {
 
-    private final Session session;
-    private final User user;
-
     @Autowired
     public EG003ControllerListEnvelopes(DSConfiguration config, Session session, User user) {
-        super(config, "eg003");
-        this.session = session;
-        this.user = user;
+        super(config, "eg003", session, user);
     }
 
     @Override

src/main/java/com/docusign/controller/eSignature/examples/EG004ControllerEnvelopeInfo.java

@@ -30,14 +30,9 @@
 @RequestMapping("/eg004")
 public class EG004ControllerEnvelopeInfo extends AbstractEsignatureController {
 
-    private final Session session;
-    private final User user;
-
     @Autowired
     public EG004ControllerEnvelopeInfo(DSConfiguration config, Session session, User user) {
-        super(config, "eg004");
-        this.session = session;
-        this.user = user;
+        super(config, "eg004", session, user);
     }
 
     @Override

src/main/java/com/docusign/controller/eSignature/examples/EG005ControllerEnvelopeRecipients.java

@@ -26,14 +26,9 @@
 @RequestMapping("/eg005")
 public class EG005ControllerEnvelopeRecipients extends AbstractEsignatureController {
 
-    private final Session session;
-    private final User user;
-
     @Autowired
     public EG005ControllerEnvelopeRecipients(DSConfiguration config, Session session, User user) {
-        super(config, "eg005");
-        this.session = session;
-        this.user = user;
+        super(config, "eg005", session, user);
     }
 
     @Override

src/main/java/com/docusign/controller/eSignature/examples/EG006ControllerEnvelopeDocs.java

@@ -34,14 +34,9 @@
 @RequestMapping("/eg006")
 public class EG006ControllerEnvelopeDocs extends AbstractEsignatureController {
 
-    private final Session session;
-    private final User user;
-
     @Autowired
     public EG006ControllerEnvelopeDocs(DSConfiguration config, Session session, User user) {
-        super(config, "eg006");
-        this.session = session;
-        this.user = user;
+        super(config, "eg006", session, user);
     }
 
     @Override