Java SDK release of the latest API version

Author: Majid Mallis

README.md

@@ -1,11 +1,11 @@
-# DocuSign Java Client 
+# DocuSign Java Client
 
 You can sign up for a free [developer sandbox](https://www.docusign.com/developer-center).
 
 Requirements
 ============
 
-Java 1.7 or later.  
+Java 1.6 or later.  
 
 Installation
 ============
@@ -18,7 +18,7 @@ Add this dependency to your project's POM:
 <dependency>
    <groupId>com.docusign</groupId>
    <artifactId>docusign-esign-java</artifactId>
-   <version>2.0.1</version>
+   <version>2.0.2</version>
 </dependency>
 ```
 
@@ -27,7 +27,7 @@ Add this dependency to your project's POM:
 Add this dependency to your project's build file:
 
 ```groovy
-compile "com.docusign:docusign-esign-java:2.0.1"
+compile "com.docusign:docusign-esign-java:2.0.2"
 ```
 
 #### Note for Android Developers 
@@ -53,14 +53,14 @@ android {
 
 This client is available through the following Java package managers:
 
-- [Nexus Repository Manager](https://oss.sonatype.org/#nexus-search;quick~docusign-esign-java) (oss.sonatype.org). You can search for com.docusign or docusign-esign-java. The current version is 2.0.1.
-- [JFrog Bintray](https://bintray.com/search?query=docusign-esign-java) (bintray.com). You can search for com.docusign or docusign-esign-java. The current version is 2.0.1.
+- [Nexus Repository Manager](https://oss.sonatype.org/#nexus-search;quick~docusign-esign-java) (oss.sonatype.org). You can search for com.docusign or docusign-esign-java. The current version is 2.0.2.
+- [JFrog Bintray](https://bintray.com/search?query=docusign-esign-java) (bintray.com). You can search for com.docusign or docusign-esign-java. The current version is 2.0.2.
 
 ### Others
 
 Or you can manually download and add the following JARs to your project:
 
-* The [docusign-esign-java-2.0.1](/target/docusign-esign-java-2.0.1.jar) JAR.
+* The [docusign-esign-java-2.0.2](/target/docusign-esign-java-2.0.2.jar) JAR.
 * The [Dependency JARs](/target/lib) in /lib folder.
 
 
@@ -116,20 +116,20 @@ public class DocuSignExample {
             tRole.setRoleName("[ROLE_NAME]");
             tRole.setName("[SIGNER_NAME]");
             tRole.setEmail("[SIGNER_EMAIL]");
-	        
+          
             // create a list of template roles and add our newly created role
             List<TemplateRole> templateRolesList = new ArrayList<TemplateRole>();
             templateRolesList.add(tRole);
-	        
+          
             // assign template role(s) to the envelope 
             envDef.setTemplateRoles(templateRolesList);
 
             // send the envelope by setting |status| to "sent". To save as a draft set to "created"
             envDef.setStatus("sent");
-	        
+          
             // instantiate a new EnvelopesApi object
             EnvelopesApi envelopesApi = new EnvelopesApi();
-	        
+          
             // call the createEnvelope() API
             EnvelopeSummary envelopeSummary = envelopesApi.createEnvelope(accountId, envDef);
         }
@@ -163,4 +163,4 @@ The DocuSign Java Client is licensed under the following [License](LICENSE).
 Notes
 =======
 
-This version of the client library does not implement all of the DocuSign REST API methods. The current client omits methods in the Accounts, Billing, Cloud Storage, Connect, Groups (Branding), and Templates (Bulk Recipients) categories. The client's methods support the core set of use cases that most integrations will encounter. For a complete list of omitted endpoints, see [Omitted Endpoints](./omitted_endpoints.md). 
+This version of the client library does not implement all of the DocuSign REST API methods. The current client omits methods in the Accounts, Billing, Cloud Storage, Connect, Groups (Branding), and Templates (Bulk Recipients) categories. The client's methods support the core set of use cases that most integrations will encounter. For a complete list of omitted endpoints, see [Omitted Endpoints](./omitted_endpoints.md).

build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'idea'
 apply plugin: 'eclipse'
 
 group = 'com.docusign'
-version = '2.0.1'
+version = '2.0.2'
 
 buildscript {
     repositories {

omitted_endpoints.md

@@ -45,6 +45,7 @@ The following endpoints are not currently included in the client libraries.
 | DELETE | {vx}/accounts/{accountId}/connect/failures/{failureId} |
 | GET | {vx}/accounts/{accountId}/connect/{connectId} |
 | DELETE | {vx}/accounts/{accountId}/connect/{connectId} |
+| GET | {vx}/accounts/{accountId}/connect/{connectId}/users |
 | GET | {vx}/accounts/{accountId}/connect |
 | PUT | {vx}/accounts/{accountId}/connect |
 | POST | {vx}/accounts/{accountId}/connect |

pom.xml

@@ -5,7 +5,7 @@
   <artifactId>docusign-esign-java</artifactId>
   <packaging>jar</packaging>
   <name>docusign-esign-java</name>
-  <version>2.0.1</version>
+  <version>2.0.2</version>
   <description>The official DocuSign eSignature JAVA client is based on version 2 of the DocuSign REST API and provides libraries for JAVA application integration. It is recommended that you use this version of the library for new development.</description>
   <url>https://www.docusign.com/developer-center</url>
 
@@ -191,11 +191,6 @@
       <artifactId>swagger-annotations</artifactId>
       <version>${swagger-annotations-version}</version>
     </dependency>
-    <dependency>
-      <groupId>javax.annotation</groupId>
-      <artifactId>jsr250-api</artifactId>
-      <version>1.0</version>
-    </dependency>
 
     <!-- HTTP client: jersey-client -->
     <dependency>

src/main/java/com/docusign/esign/api/AuthenticationApi.java

@@ -39,12 +39,36 @@ public void setApiClient(ApiClient apiClient) {
   public class LoginOptions
   {
 
+    private String loginSettings = null;
+    
+    private String embedAccountIdGuid = null;
+    
     private String apiPassword = null;
 
     private String includeAccountIdGuid = null;
 
-    private String loginSettings = null;
 
+    /*
+     * Determines whether login settings are returned in the response.\n\nValid Values:\n\n* all -  All the login settings are returned. \n* none - no login settings are returned. 
+     */
+    public void setLoginSettings(String loginSettings) {
+      this.loginSettings = loginSettings;
+    }
+
+    public String getLoginSettings() {
+      return this.loginSettings;
+    }
+    
+    /*
+     * 
+     */
+    public void setEmbedAccountIdGuid(String embedAccountIdGuid) {
+      this.embedAccountIdGuid = embedAccountIdGuid;
+    }
+
+    public String getEmbedAccountIdGuid() {
+      return this.embedAccountIdGuid;
+    }
 
     /*
      * When set to **true**, shows the account API password in the response. 
@@ -68,17 +92,6 @@ public String getIncludeAccountIdGuid() {
       return this.includeAccountIdGuid;
     }
 
-    /*
-     * Determines whether login settings are returned in the response.\n\nValid Values:\n\n* all -  All the login settings are returned. \n* none - no login settings are returned. 
-     */
-    public void setLoginSettings(String loginSettings) {
-      this.loginSettings = loginSettings;
-    }
-
-    public String getLoginSettings() {
-      return this.loginSettings;
-    }
-    
   }
 
   /**
@@ -112,12 +125,14 @@ public LoginInformation login(AuthenticationApi.LoginOptions options) throws Api
 
     if (options != null) {
 
+       localVarQueryParams.addAll(apiClient.parameterToPairs("", "login_settings", options.loginSettings));
+    
+       localVarQueryParams.addAll(apiClient.parameterToPairs("", "embed_account_id_guid", options.embedAccountIdGuid));
+    
        localVarQueryParams.addAll(apiClient.parameterToPairs("", "api_password", options.apiPassword));
 
        localVarQueryParams.addAll(apiClient.parameterToPairs("", "include_account_id_guid", options.includeAccountIdGuid));
 
-       localVarQueryParams.addAll(apiClient.parameterToPairs("", "login_settings", options.loginSettings));
-    
     }
 
 

src/main/java/com/docusign/esign/api/DefaultApi.java

@@ -0,0 +1,95 @@
+package com.docusign.esign.api;
+
+import com.sun.jersey.api.client.GenericType;
+
+import com.docusign.esign.client.ApiException;
+import com.docusign.esign.client.ApiClient;
+import com.docusign.esign.client.Configuration;
+import com.docusign.esign.client.Pair;
+
+import com.docusign.esign.model.ViewUrl;
+import com.docusign.esign.model.ErrorDetails;
+import com.docusign.esign.model.ReturnUrlRequest;
+
+
+public class DefaultApi {
+  private ApiClient apiClient;
+
+  public DefaultApi() {
+    this(Configuration.getDefaultApiClient());
+  }
+
+  public DefaultApi(ApiClient apiClient) {
+    this.apiClient = apiClient;
+  }
+
+  public ApiClient getApiClient() {
+    return apiClient;
+  }
+
+  public void setApiClient(ApiClient apiClient) {
+    this.apiClient = apiClient;
+  }
+
+  
+
+  
+
+  /**
+   * Provides a URL to start an edit view of the Template UI
+   * 
+      * @param accountId The external account number (int) or account ID Guid.
+      * @param templateId The ID of the template being accessed.
+   
+   * DefaultApi.TemplateEditViewOptions Options for modifying the method behavior.
+   * @return ViewUrl
+   * @throws ApiException if fails to make API call
+   */
+  public ViewUrl templateEditView(String accountId, String templateId, ReturnUrlRequest returnUrlRequest) throws ApiException {
+    Object localVarPostBody = returnUrlRequest;
+    
+    // verify the required parameter 'accountId' is set
+    if (accountId == null) {
+      throw new ApiException(400, "Missing the required parameter 'accountId' when calling templateEditView");
+    }
+    
+    // verify the required parameter 'templateId' is set
+    if (templateId == null) {
+      throw new ApiException(400, "Missing the required parameter 'templateId' when calling templateEditView");
+    }
+    
+    // create path and map variables
+    String localVarPath = "/v2/accounts/{accountId}/templates/{templateId}/views/edit".replaceAll("\\{format\\}","json")
+      .replaceAll("\\{" + "accountId" + "\\}", apiClient.escapeString(accountId.toString()))
+      .replaceAll("\\{" + "templateId" + "\\}", apiClient.escapeString(templateId.toString()));
+
+    // query params
+    java.util.List<Pair> localVarQueryParams = new java.util.ArrayList<Pair>();
+    java.util.Map<String, String> localVarHeaderParams = new java.util.HashMap<String, String>();
+    java.util.Map<String, Object> localVarFormParams = new java.util.HashMap<String, Object>();
+
+    
+
+    
+
+    
+
+    final String[] localVarAccepts = {
+      "application/json"
+    };
+    final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);
+
+    final String[] localVarContentTypes = {
+      
+    };
+    final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);
+
+    String[] localVarAuthNames = new String[] {  };
+
+    
+    GenericType<ViewUrl> localVarReturnType = new GenericType<ViewUrl>() {};
+    return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
+    
+  }
+  
+}

src/main/java/com/docusign/esign/api/DiagnosticsApi.java

@@ -356,7 +356,7 @@ public ApiRequestLogsResult listRequestLogs(DiagnosticsApi.ListRequestLogsOption
 
   /**
    * Enables or disables API request logging for troubleshooting.
-   * Enables or disables API request logging for troubleshooting.\n\nWhen enabled (`apiRequestLogging` is set to true), REST API requests and responses for the user are added to a log. A log can have up to 50 requests/responses and the current number of log entries can be determined by getting the settings. Logging is automatically disabled when the log limit of 50 is reached.\n\nYou can call [ML:GetRequestLog] or [ML:GetRequestLogs] to download the log files (individually or as a zip file). Call [ML:DeleteRequestLogs] to clear the log by deleting current entries.\n\nPrivate information, such as passwords and integrator key information, which is normally located in the call header is omitted from the request/response log.\n\n#### Note: API request logging only captures requests from the authenticated user. Any call that does not authenticate the user and resolve a userId isn't logged. Meaning that login_information, NewAccounts, or other distributor-credential calls are not logged.\n
+   * Enables or disables API request logging for troubleshooting.\n\nWhen enabled (`apiRequestLogging` is set to true), REST API requests and responses for the user are added to a log. A log can have up to 50 requests/responses and the current number of log entries can be determined by getting the settings. Logging is automatically disabled when the log limit of 50 is reached.\n\nYou can call [ML:GetRequestLog] or [ML:GetRequestLogs] to download the log files (individually or as a zip file). Call [ML:DeleteRequestLogs] to clear the log by deleting current entries.\n\nPrivate information, such as passwords and integrator key information, which is normally located in the call header is omitted from the request/response log.\n\n###### Note: API request logging only captures requests from the authenticated user. Any call that does not authenticate the user and resolve a userId isn't logged. Meaning that login_information, NewAccounts, or other distributor-credential calls are not logged.\n
    
    * DiagnosticsApi.UpdateRequestLogSettingsOptions Options for modifying the method behavior.
    * @return DiagnosticsSettingsInformation