Version 3.17.0-v2.1-21.4.02.00 release (#225)

Co-authored-by: root <[email protected]>

Author: mmallis87

CHANGELOG.md

@@ -1,6 +1,11 @@
 # DocuSign Java Client Changelog
 See [DocuSign Support Center](https://support.docusign.com/en/releasenotes/) for Product Release Notes.
 
+## [v3.17.0] - eSignature API v2.1-21.4.02.00 - 2022-02-11
+### Changed
+- Added support for version v2.1-21.4.02.00 of the DocuSign ESignature API.
+- Updated the SDK release version.
+
 ## [v3.17.0-RC1] - eSignature API v2.1-21.4.01.00 - 2022-01-07
 ### Changed
 - Added support for version v2.1-21.4.01.00 of the DocuSign ESignature API.

pom.xml

@@ -30,10 +30,14 @@
         <artifactId>maven-surefire-plugin</artifactId>
         <version>3.0.0-M3</version>
         <configuration>
+          <runOrder>alphabetical</runOrder>
           <argLine>-Xms512m -Xmx1500m</argLine>
           <parallel>methods</parallel>
           <useUnlimitedThreads>true</useUnlimitedThreads>
-          <forkMode>pertest</forkMode>
+          <forkCount>1</forkCount>
+          <reuseForks>false</reuseForks>
+          <threadCount>1</threadCount>
+          <perCoreThreadCount>false</perCoreThreadCount>
           <includes>
             <include>**/*Tests.java</include>
           </includes>
@@ -141,7 +145,7 @@
           <serverId>ossrh</serverId>
           <nexusUrl>https://s01.oss.sonatype.org/</nexusUrl>
           <autoReleaseAfterClose>true</autoReleaseAfterClose>
-        </configuration>                        
+        </configuration>
       </plugin>
 
       <plugin>

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

@@ -813,6 +813,68 @@ public BulkSendingListSummaries getBulkSendLists(String accountId) throws ApiExc
     return apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
       }
 
+  /**
+   * Initiate a specific bulk send batch action.
+   * 
+   * @param accountId The external account number (int) or account ID Guid. (required)
+   * @param bulkSendBatchId  (required)
+   * @param bulkAction  (required)
+   * @param bulkSendBatchActionRequest  (optional)
+   * @return BulkSendBatchStatus
+   * @throws ApiException if fails to make API call
+   */
+  public BulkSendBatchStatus updateBulkSendBatchAction(String accountId, String bulkSendBatchId, String bulkAction, BulkSendBatchActionRequest bulkSendBatchActionRequest) throws ApiException {
+    Object localVarPostBody = bulkSendBatchActionRequest;
+    
+    // verify the required parameter 'accountId' is set
+    if (accountId == null) {
+      throw new ApiException(400, "Missing the required parameter 'accountId' when calling updateBulkSendBatchAction");
+    }
+    
+    // verify the required parameter 'bulkSendBatchId' is set
+    if (bulkSendBatchId == null) {
+      throw new ApiException(400, "Missing the required parameter 'bulkSendBatchId' when calling updateBulkSendBatchAction");
+    }
+    
+    // verify the required parameter 'bulkAction' is set
+    if (bulkAction == null) {
+      throw new ApiException(400, "Missing the required parameter 'bulkAction' when calling updateBulkSendBatchAction");
+    }
+    
+    // create path and map variables
+    String localVarPath = "/v2.1/accounts/{accountId}/bulk_send_batch/{bulkSendBatchId}/{bulkAction}"
+      .replaceAll("\\{" + "accountId" + "\\}", apiClient.escapeString(accountId.toString()))
+      .replaceAll("\\{" + "bulkSendBatchId" + "\\}", apiClient.escapeString(bulkSendBatchId.toString()))
+      .replaceAll("\\{" + "bulkAction" + "\\}", apiClient.escapeString(bulkAction.toString()));
+
+    // query params
+    java.util.List<Pair> localVarQueryParams = new java.util.ArrayList<Pair>();
+    java.util.List<Pair> localVarCollectionQueryParams = 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[] { "docusignAccessCode" };
+
+    GenericType<BulkSendBatchStatus> localVarReturnType = new GenericType<BulkSendBatchStatus>() {};
+    return apiClient.invokeAPI(localVarPath, "PUT", localVarQueryParams, localVarCollectionQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
+      }
+
   /**
    * Put/Update a specific bulk send batch status.
    * 

src/main/java/com/docusign/esign/client/ApiClient.java

@@ -94,7 +94,7 @@ public ApiClient() {
     this.dateFormat = new RFC3339DateFormat();
 
     // Set default User-Agent.
-    setUserAgent("Swagger-Codegen/3.17.0-RC1/java");
+    setUserAgent("Swagger-Codegen/3.17.0/java");
 
     // Setup authentications (key: authentication name, value: authentication).
     authentications = new HashMap<String, Authentication>();

src/main/java/com/docusign/esign/client/auth/JWTUtils.java

@@ -82,7 +82,7 @@ public static String generateJWTAssertionFromByteArray(
     }
     return builder.sign(algorithm);
   }
-  
+
   /**
    * Helper method to create a JWT token for the JWT flow.
    *
@@ -97,13 +97,41 @@ public static String generateJWTAssertionFromByteArray(
    * @throws JWTCreationException if not able to create a JWT token from the input parameters
    * @throws IOException if there is an issue with either the public or private file
    */
+  public static String generateJWTAssertion(
+          String publicKeyFilename,
+          String privateKeyFilename,
+          String oAuthBasePath,
+          String clientId,
+          String userId,
+          long expiresIn)
+          throws JWTCreationException, IOException {
+    return generateJWTAssertion(publicKeyFilename, privateKeyFilename, oAuthBasePath, clientId, userId, expiresIn, "signature");
+  }
+
+  /**
+   * Helper method to create a JWT token for the JWT flow.
+   *
+   * @param publicKeyFilename the filename of the RSA public key
+   * @param privateKeyFilename the filename of the RSA private key
+   * @param oAuthBasePath DocuSign OAuth base path (account-d.docusign.com for the developer sandbox
+   *     and account.docusign.com for the production platform)
+   * @param clientId DocuSign OAuth Client Id (AKA Integrator Key)
+   * @param userId DocuSign user Id to be impersonated (This is a UUID)
+   * @param expiresIn number of seconds remaining before the JWT assertion is considered as invalid
+   * @param scopes space-separated string that represents the list of scopes to grant to the OAuth
+   *    token.
+   * @return a fresh JWT token
+   * @throws JWTCreationException if not able to create a JWT token from the input parameters
+   * @throws IOException if there is an issue with either the public or private file
+   */
   public static String generateJWTAssertion(
       String publicKeyFilename,
       String privateKeyFilename,
       String oAuthBasePath,
       String clientId,
       String userId,
-      long expiresIn)
+      long expiresIn,
+      String scopes)
       throws JWTCreationException, IOException {
     String token = null;
     if (expiresIn <= 0L) {
@@ -134,7 +162,7 @@ public static String generateJWTAssertion(
               .withAudience(oAuthBasePath)
               .withNotBefore(new Date(now))
               .withExpiresAt(new Date(now + expiresIn * 1000))
-              .withClaim("scope", "signature")
+              .withClaim("scope", scopes)
               .sign(algorithm);
     } catch (JWTCreationException e) {
       throw e;

src/main/java/com/docusign/esign/model/AccountSettingsInformation.java

@@ -2908,10 +2908,10 @@ public AccountSettingsInformation allowDelayedRouting(String allowDelayedRouting
   }
 
   /**
-   * .
+   * \"true\" if the account has permission to use the delayed routing feature to insert delays before routing an envelope to a recipient, \"false\" otherwise..
    * @return allowDelayedRouting
    **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "\"true\" if the account has permission to use the delayed routing feature to insert delays before routing an envelope to a recipient, \"false\" otherwise.")
   public String getAllowDelayedRouting() {
     return allowDelayedRouting;
   }
@@ -5446,10 +5446,10 @@ public AccountSettingsInformation allowScheduledSending(String allowScheduledSen
   }
 
   /**
-   * .
+   * \"true\" if the account has permission to use the scheduled sending feature to send envelopes at a specified datetime in the future, \"false\" otherwise..
    * @return allowScheduledSending
    **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "\"true\" if the account has permission to use the scheduled sending feature to send envelopes at a specified datetime in the future, \"false\" otherwise.")
   public String getAllowScheduledSending() {
     return allowScheduledSending;
   }

src/main/java/com/docusign/esign/model/Agent.java

@@ -90,6 +90,9 @@ public class Agent {
   @JsonProperty("emailNotification")
   private RecipientEmailNotification emailNotification = null;
 
+  @JsonProperty("emailRecipientPostSigningURL")
+  private String emailRecipientPostSigningURL = null;
+
   @JsonProperty("embeddedRecipientStartURL")
   private String embeddedRecipientStartURL = null;
 
@@ -823,6 +826,33 @@ public void setEmailNotification(RecipientEmailNotification emailNotification) {
   }
 
 
+  /**
+   * emailRecipientPostSigningURL.
+   *
+   * @return Agent
+   **/
+  public Agent emailRecipientPostSigningURL(String emailRecipientPostSigningURL) {
+    this.emailRecipientPostSigningURL = emailRecipientPostSigningURL;
+    return this;
+  }
+
+  /**
+   * .
+   * @return emailRecipientPostSigningURL
+   **/
+  @ApiModelProperty(value = "")
+  public String getEmailRecipientPostSigningURL() {
+    return emailRecipientPostSigningURL;
+  }
+
+  /**
+   * setEmailRecipientPostSigningURL.
+   **/
+  public void setEmailRecipientPostSigningURL(String emailRecipientPostSigningURL) {
+    this.emailRecipientPostSigningURL = emailRecipientPostSigningURL;
+  }
+
+
   /**
    * embeddedRecipientStartURL.
    *
@@ -2299,6 +2329,7 @@ public boolean equals(java.lang.Object o) {
         Objects.equals(this.email, agent.email) &&
         Objects.equals(this.emailMetadata, agent.emailMetadata) &&
         Objects.equals(this.emailNotification, agent.emailNotification) &&
+        Objects.equals(this.emailRecipientPostSigningURL, agent.emailRecipientPostSigningURL) &&
         Objects.equals(this.embeddedRecipientStartURL, agent.embeddedRecipientStartURL) &&
         Objects.equals(this.errorDetails, agent.errorDetails) &&
         Objects.equals(this.excludedDocuments, agent.excludedDocuments) &&
@@ -2357,7 +2388,7 @@ public boolean equals(java.lang.Object o) {
    */
   @Override
   public int hashCode() {
-    return Objects.hash(accessCode, accessCodeMetadata, addAccessCodeToEmail, additionalNotifications, allowSystemOverrideForLockedRecipient, autoRespondedReason, clientUserId, completedCount, customFields, declinedDateTime, declinedReason, deliveredDateTime, deliveryMethod, deliveryMethodMetadata, designatorId, designatorIdGuid, documentVisibility, email, emailMetadata, emailNotification, embeddedRecipientStartURL, errorDetails, excludedDocuments, faxNumber, faxNumberMetadata, firstName, firstNameMetadata, fullName, fullNameMetadata, idCheckConfigurationName, idCheckConfigurationNameMetadata, idCheckInformationInput, identityVerification, inheritEmailNotificationConfiguration, lastName, lastNameMetadata, lockedRecipientPhoneAuthEditable, lockedRecipientSmsEditable, name, nameMetadata, note, noteMetadata, phoneAuthentication, phoneNumber, recipientAttachments, recipientAuthenticationStatus, recipientFeatureMetadata, recipientId, recipientIdGuid, recipientType, recipientTypeMetadata, requireIdLookup, requireIdLookupMetadata, roleName, routingOrder, routingOrderMetadata, sentDateTime, signedDateTime, signingGroupId, signingGroupIdMetadata, signingGroupName, signingGroupUsers, smsAuthentication, socialAuthentications, status, statusCode, suppressEmails, templateLocked, templateRequired, totalTabCount, userId);
+    return Objects.hash(accessCode, accessCodeMetadata, addAccessCodeToEmail, additionalNotifications, allowSystemOverrideForLockedRecipient, autoRespondedReason, clientUserId, completedCount, customFields, declinedDateTime, declinedReason, deliveredDateTime, deliveryMethod, deliveryMethodMetadata, designatorId, designatorIdGuid, documentVisibility, email, emailMetadata, emailNotification, emailRecipientPostSigningURL, embeddedRecipientStartURL, errorDetails, excludedDocuments, faxNumber, faxNumberMetadata, firstName, firstNameMetadata, fullName, fullNameMetadata, idCheckConfigurationName, idCheckConfigurationNameMetadata, idCheckInformationInput, identityVerification, inheritEmailNotificationConfiguration, lastName, lastNameMetadata, lockedRecipientPhoneAuthEditable, lockedRecipientSmsEditable, name, nameMetadata, note, noteMetadata, phoneAuthentication, phoneNumber, recipientAttachments, recipientAuthenticationStatus, recipientFeatureMetadata, recipientId, recipientIdGuid, recipientType, recipientTypeMetadata, requireIdLookup, requireIdLookupMetadata, roleName, routingOrder, routingOrderMetadata, sentDateTime, signedDateTime, signingGroupId, signingGroupIdMetadata, signingGroupName, signingGroupUsers, smsAuthentication, socialAuthentications, status, statusCode, suppressEmails, templateLocked, templateRequired, totalTabCount, userId);
   }
 
 
@@ -2389,6 +2420,7 @@ public String toString() {
     sb.append("    email: ").append(toIndentedString(email)).append("\n");
     sb.append("    emailMetadata: ").append(toIndentedString(emailMetadata)).append("\n");
     sb.append("    emailNotification: ").append(toIndentedString(emailNotification)).append("\n");
+    sb.append("    emailRecipientPostSigningURL: ").append(toIndentedString(emailRecipientPostSigningURL)).append("\n");
     sb.append("    embeddedRecipientStartURL: ").append(toIndentedString(embeddedRecipientStartURL)).append("\n");
     sb.append("    errorDetails: ").append(toIndentedString(errorDetails)).append("\n");
     sb.append("    excludedDocuments: ").append(toIndentedString(excludedDocuments)).append("\n");