Skip to content

Commit ab69a05

Browse files
Added allow_form_view field to template response docs (#502)
1 parent fe97796 commit ab69a05

206 files changed

Lines changed: 448 additions & 197 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

openapi-raw.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11893,6 +11893,10 @@ components:
1189311893
type: array
1189411894
items:
1189511895
$ref: '#/components/schemas/SignatureRequestResponseAttachment'
11896+
allow_form_view:
11897+
description: '_t__TemplateResponse::ALLOW_FORM_VIEW'
11898+
type: boolean
11899+
nullable: false
1189611900
type: object
1189711901
x-internal-class: true
1189811902
TemplateResponseAccount:

openapi-sdk.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12644,6 +12644,10 @@ components:
1264412644
type: array
1264512645
items:
1264612646
$ref: '#/components/schemas/SignatureRequestResponseAttachment'
12647+
allow_form_view:
12648+
description: 'Allows signers to view the form fields before signing if set to `true`. Defaults to `false`.'
12649+
type: boolean
12650+
nullable: false
1264712651
type: object
1264812652
x-internal-class: true
1264912653
TemplateResponseAccount:

openapi.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12622,6 +12622,10 @@ components:
1262212622
type: array
1262312623
items:
1262412624
$ref: '#/components/schemas/SignatureRequestResponseAttachment'
12625+
allow_form_view:
12626+
description: 'Allows signers to view the form fields before signing if set to `true`. Defaults to `false`.'
12627+
type: boolean
12628+
nullable: false
1262512629
type: object
1262612630
x-internal-class: true
1262712631
TemplateResponseAccount:

sdks/dotnet/docs/TemplateResponse.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Contains information about the templates you and your team have created.
55

66
Name | Type | Description | Notes
77
------------ | ------------- | ------------- | -------------
8-
**TemplateId** | **string** | The id of the Template. | [optional] **Title** | **string** | The title of the Template. This will also be the default subject of the message sent to signers when using this Template to send a SignatureRequest. This can be overridden when sending the SignatureRequest. | [optional] **Message** | **string** | The default message that will be sent to signers when using this Template to send a SignatureRequest. This can be overridden when sending the SignatureRequest. | [optional] **UpdatedAt** | **int** | Time the template was last updated. | [optional] **IsEmbedded** | **bool?** | `true` if this template was created using an embedded flow, `false` if it was created on our website. Will be `null` when you are not the creator of the Template. | [optional] **IsCreator** | **bool** | `true` if you are the owner of this template, `false` if it's been shared with you by a team member. | [optional] **CanEdit** | **bool** | Indicates whether edit rights have been granted to you by the owner (always `true` if that's you). | [optional] **IsLocked** | **bool** | Indicates whether the template is locked. If `true`, then the template was created outside your quota and can only be used in `test_mode`. If `false`, then the template is within your quota and can be used to create signature requests. | [optional] **Metadata** | **Dictionary<string, Object>** | The metadata attached to the template. | [optional] **SignerRoles** | [**List<TemplateResponseSignerRole>**](TemplateResponseSignerRole.md) | An array of the designated signer roles that must be specified when sending a SignatureRequest using this Template. | [optional] **CcRoles** | [**List<TemplateResponseCCRole>**](TemplateResponseCCRole.md) | An array of the designated CC roles that must be specified when sending a SignatureRequest using this Template. | [optional] **Documents** | [**List<TemplateResponseDocument>**](TemplateResponseDocument.md) | An array describing each document associated with this Template. Includes form field data for each document. | [optional] **CustomFields** | [**List<TemplateResponseDocumentCustomFieldBase>**](TemplateResponseDocumentCustomFieldBase.md) | Deprecated. Use `custom_fields` inside the [documents](https://developers.hellosign.com/api/reference/operation/templateGet/#!c=200&path=template/documents&t=response) array instead. | [optional] **NamedFormFields** | [**List<TemplateResponseDocumentFormFieldBase>**](TemplateResponseDocumentFormFieldBase.md) | Deprecated. Use `form_fields` inside the [documents](https://developers.hellosign.com/api/reference/operation/templateGet/#!c=200&path=template/documents&t=response) array instead. | [optional] **Accounts** | [**List<TemplateResponseAccount>**](TemplateResponseAccount.md) | An array of the Accounts that can use this Template. | [optional] **Attachments** | [**List<SignatureRequestResponseAttachment>**](SignatureRequestResponseAttachment.md) | Signer attachments. | [optional]
8+
**TemplateId** | **string** | The id of the Template. | [optional] **Title** | **string** | The title of the Template. This will also be the default subject of the message sent to signers when using this Template to send a SignatureRequest. This can be overridden when sending the SignatureRequest. | [optional] **Message** | **string** | The default message that will be sent to signers when using this Template to send a SignatureRequest. This can be overridden when sending the SignatureRequest. | [optional] **UpdatedAt** | **int** | Time the template was last updated. | [optional] **IsEmbedded** | **bool?** | `true` if this template was created using an embedded flow, `false` if it was created on our website. Will be `null` when you are not the creator of the Template. | [optional] **IsCreator** | **bool** | `true` if you are the owner of this template, `false` if it's been shared with you by a team member. | [optional] **CanEdit** | **bool** | Indicates whether edit rights have been granted to you by the owner (always `true` if that's you). | [optional] **IsLocked** | **bool** | Indicates whether the template is locked. If `true`, then the template was created outside your quota and can only be used in `test_mode`. If `false`, then the template is within your quota and can be used to create signature requests. | [optional] **Metadata** | **Dictionary<string, Object>** | The metadata attached to the template. | [optional] **SignerRoles** | [**List<TemplateResponseSignerRole>**](TemplateResponseSignerRole.md) | An array of the designated signer roles that must be specified when sending a SignatureRequest using this Template. | [optional] **CcRoles** | [**List<TemplateResponseCCRole>**](TemplateResponseCCRole.md) | An array of the designated CC roles that must be specified when sending a SignatureRequest using this Template. | [optional] **Documents** | [**List<TemplateResponseDocument>**](TemplateResponseDocument.md) | An array describing each document associated with this Template. Includes form field data for each document. | [optional] **CustomFields** | [**List<TemplateResponseDocumentCustomFieldBase>**](TemplateResponseDocumentCustomFieldBase.md) | Deprecated. Use `custom_fields` inside the [documents](https://developers.hellosign.com/api/reference/operation/templateGet/#!c=200&path=template/documents&t=response) array instead. | [optional] **NamedFormFields** | [**List<TemplateResponseDocumentFormFieldBase>**](TemplateResponseDocumentFormFieldBase.md) | Deprecated. Use `form_fields` inside the [documents](https://developers.hellosign.com/api/reference/operation/templateGet/#!c=200&path=template/documents&t=response) array instead. | [optional] **Accounts** | [**List<TemplateResponseAccount>**](TemplateResponseAccount.md) | An array of the Accounts that can use this Template. | [optional] **Attachments** | [**List<SignatureRequestResponseAttachment>**](SignatureRequestResponseAttachment.md) | Signer attachments. | [optional] **AllowFormView** | **bool** | Allows signers to view the form fields before signing if set to `true`. Defaults to `false`. | [optional]
99

1010
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
1111

sdks/dotnet/src/Dropbox.Sign/Model/TemplateResponse.cs

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,8 @@ protected TemplateResponse() { }
5757
/// <param name="namedFormFields">Deprecated. Use &#x60;form_fields&#x60; inside the [documents](https://developers.hellosign.com/api/reference/operation/templateGet/#!c&#x3D;200&amp;path&#x3D;template/documents&amp;t&#x3D;response) array instead..</param>
5858
/// <param name="accounts">An array of the Accounts that can use this Template..</param>
5959
/// <param name="attachments">Signer attachments..</param>
60-
public TemplateResponse(string templateId = default(string), string title = default(string), string message = default(string), int updatedAt = default(int), bool? isEmbedded = default(bool?), bool isCreator = default(bool), bool canEdit = default(bool), bool isLocked = default(bool), Dictionary<string, Object> metadata = default(Dictionary<string, Object>), List<TemplateResponseSignerRole> signerRoles = default(List<TemplateResponseSignerRole>), List<TemplateResponseCCRole> ccRoles = default(List<TemplateResponseCCRole>), List<TemplateResponseDocument> documents = default(List<TemplateResponseDocument>), List<TemplateResponseDocumentCustomFieldBase> customFields = default(List<TemplateResponseDocumentCustomFieldBase>), List<TemplateResponseDocumentFormFieldBase> namedFormFields = default(List<TemplateResponseDocumentFormFieldBase>), List<TemplateResponseAccount> accounts = default(List<TemplateResponseAccount>), List<SignatureRequestResponseAttachment> attachments = default(List<SignatureRequestResponseAttachment>))
60+
/// <param name="allowFormView">Allows signers to view the form fields before signing if set to &#x60;true&#x60;. Defaults to &#x60;false&#x60;..</param>
61+
public TemplateResponse(string templateId = default(string), string title = default(string), string message = default(string), int updatedAt = default(int), bool? isEmbedded = default(bool?), bool isCreator = default(bool), bool canEdit = default(bool), bool isLocked = default(bool), Dictionary<string, Object> metadata = default(Dictionary<string, Object>), List<TemplateResponseSignerRole> signerRoles = default(List<TemplateResponseSignerRole>), List<TemplateResponseCCRole> ccRoles = default(List<TemplateResponseCCRole>), List<TemplateResponseDocument> documents = default(List<TemplateResponseDocument>), List<TemplateResponseDocumentCustomFieldBase> customFields = default(List<TemplateResponseDocumentCustomFieldBase>), List<TemplateResponseDocumentFormFieldBase> namedFormFields = default(List<TemplateResponseDocumentFormFieldBase>), List<TemplateResponseAccount> accounts = default(List<TemplateResponseAccount>), List<SignatureRequestResponseAttachment> attachments = default(List<SignatureRequestResponseAttachment>), bool allowFormView = default(bool))
6162
{
6263

6364
this.TemplateId = templateId;
@@ -76,6 +77,7 @@ protected TemplateResponse() { }
7677
this.NamedFormFields = namedFormFields;
7778
this.Accounts = accounts;
7879
this.Attachments = attachments;
80+
this.AllowFormView = allowFormView;
7981
}
8082

8183
/// <summary>
@@ -208,6 +210,13 @@ public static TemplateResponse Init(string jsonData)
208210
[DataMember(Name = "attachments", EmitDefaultValue = true)]
209211
public List<SignatureRequestResponseAttachment> Attachments { get; set; }
210212

213+
/// <summary>
214+
/// Allows signers to view the form fields before signing if set to &#x60;true&#x60;. Defaults to &#x60;false&#x60;.
215+
/// </summary>
216+
/// <value>Allows signers to view the form fields before signing if set to &#x60;true&#x60;. Defaults to &#x60;false&#x60;.</value>
217+
[DataMember(Name = "allow_form_view", EmitDefaultValue = true)]
218+
public bool AllowFormView { get; set; }
219+
211220
/// <summary>
212221
/// Returns the string presentation of the object
213222
/// </summary>
@@ -232,6 +241,7 @@ public override string ToString()
232241
sb.Append(" NamedFormFields: ").Append(NamedFormFields).Append("\n");
233242
sb.Append(" Accounts: ").Append(Accounts).Append("\n");
234243
sb.Append(" Attachments: ").Append(Attachments).Append("\n");
244+
sb.Append(" AllowFormView: ").Append(AllowFormView).Append("\n");
235245
sb.Append("}\n");
236246
return sb.ToString();
237247
}
@@ -350,6 +360,10 @@ public bool Equals(TemplateResponse input)
350360
this.Attachments != null &&
351361
input.Attachments != null &&
352362
this.Attachments.SequenceEqual(input.Attachments)
363+
) &&
364+
(
365+
this.AllowFormView == input.AllowFormView ||
366+
this.AllowFormView.Equals(input.AllowFormView)
353367
);
354368
}
355369

@@ -414,6 +428,7 @@ public override int GetHashCode()
414428
{
415429
hashCode = (hashCode * 59) + this.Attachments.GetHashCode();
416430
}
431+
hashCode = (hashCode * 59) + this.AllowFormView.GetHashCode();
417432
return hashCode;
418433
}
419434
}
@@ -542,6 +557,13 @@ public List<OpenApiType> GetOpenApiTypes()
542557
Type = "List<SignatureRequestResponseAttachment>",
543558
Value = Attachments,
544559
});
560+
types.Add(new OpenApiType()
561+
{
562+
Name = "allow_form_view",
563+
Property = "AllowFormView",
564+
Type = "bool",
565+
Value = AllowFormView,
566+
});
545567

546568
return types;
547569
}

sdks/java-v1/docs/TemplateResponse.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ Contains information about the templates you and your team have created.
2424
| `namedFormFields` | [```List<TemplateResponseDocumentFormFieldBase>```](TemplateResponseDocumentFormFieldBase.md) | Deprecated. Use `form_fields` inside the [documents](https://developers.hellosign.com/api/reference/operation/templateGet/#!c&#x3D;200&amp;path&#x3D;template/documents&amp;t&#x3D;response) array instead. | |
2525
| `accounts` | [```List<TemplateResponseAccount>```](TemplateResponseAccount.md) | An array of the Accounts that can use this Template. | |
2626
| `attachments` | [```List<SignatureRequestResponseAttachment>```](SignatureRequestResponseAttachment.md) | Signer attachments. | |
27+
| `allowFormView` | ```Boolean``` | Allows signers to view the form fields before signing if set to `true`. Defaults to `false`. | |
2728

2829

2930

sdks/java-v1/src/main/java/com/dropbox/sign/model/TemplateResponse.java

Lines changed: 53 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,8 @@
4242
TemplateResponse.JSON_PROPERTY_CUSTOM_FIELDS,
4343
TemplateResponse.JSON_PROPERTY_NAMED_FORM_FIELDS,
4444
TemplateResponse.JSON_PROPERTY_ACCOUNTS,
45-
TemplateResponse.JSON_PROPERTY_ATTACHMENTS
45+
TemplateResponse.JSON_PROPERTY_ATTACHMENTS,
46+
TemplateResponse.JSON_PROPERTY_ALLOW_FORM_VIEW
4647
})
4748
@javax.annotation.Generated(
4849
value = "org.openapitools.codegen.languages.JavaClientCodegen",
@@ -99,6 +100,9 @@ public class TemplateResponse {
99100
public static final String JSON_PROPERTY_ATTACHMENTS = "attachments";
100101
@javax.annotation.Nullable private List<SignatureRequestResponseAttachment> attachments = null;
101102

103+
public static final String JSON_PROPERTY_ALLOW_FORM_VIEW = "allow_form_view";
104+
@javax.annotation.Nullable private Boolean allowFormView;
105+
102106
public TemplateResponse() {}
103107

104108
/**
@@ -568,6 +572,29 @@ public void setAttachments(
568572
this.attachments = attachments;
569573
}
570574

575+
public TemplateResponse allowFormView(@javax.annotation.Nullable Boolean allowFormView) {
576+
this.allowFormView = allowFormView;
577+
return this;
578+
}
579+
580+
/**
581+
* Allows signers to view the form fields before signing if set to &#x60;true&#x60;. Defaults to
582+
* &#x60;false&#x60;.
583+
*
584+
* @return allowFormView
585+
*/
586+
@javax.annotation.Nullable @JsonProperty(JSON_PROPERTY_ALLOW_FORM_VIEW)
587+
@JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
588+
public Boolean getAllowFormView() {
589+
return allowFormView;
590+
}
591+
592+
@JsonProperty(JSON_PROPERTY_ALLOW_FORM_VIEW)
593+
@JsonInclude(value = JsonInclude.Include.USE_DEFAULTS)
594+
public void setAllowFormView(@javax.annotation.Nullable Boolean allowFormView) {
595+
this.allowFormView = allowFormView;
596+
}
597+
571598
/** Return true if this TemplateResponse object is equal to o. */
572599
@Override
573600
public boolean equals(Object o) {
@@ -593,7 +620,8 @@ public boolean equals(Object o) {
593620
&& Objects.equals(this.customFields, templateResponse.customFields)
594621
&& Objects.equals(this.namedFormFields, templateResponse.namedFormFields)
595622
&& Objects.equals(this.accounts, templateResponse.accounts)
596-
&& Objects.equals(this.attachments, templateResponse.attachments);
623+
&& Objects.equals(this.attachments, templateResponse.attachments)
624+
&& Objects.equals(this.allowFormView, templateResponse.allowFormView);
597625
}
598626

599627
@Override
@@ -614,7 +642,8 @@ public int hashCode() {
614642
customFields,
615643
namedFormFields,
616644
accounts,
617-
attachments);
645+
attachments,
646+
allowFormView);
618647
}
619648

620649
@Override
@@ -637,6 +666,7 @@ public String toString() {
637666
sb.append(" namedFormFields: ").append(toIndentedString(namedFormFields)).append("\n");
638667
sb.append(" accounts: ").append(toIndentedString(accounts)).append("\n");
639668
sb.append(" attachments: ").append(toIndentedString(attachments)).append("\n");
669+
sb.append(" allowFormView: ").append(toIndentedString(allowFormView)).append("\n");
640670
sb.append("}");
641671
return sb.toString();
642672
}
@@ -953,6 +983,26 @@ public Map<String, Object> createFormData() throws ApiException {
953983
JSON.getDefault().getMapper().writeValueAsString(attachments));
954984
}
955985
}
986+
if (allowFormView != null) {
987+
if (isFileTypeOrListOfFiles(allowFormView)) {
988+
fileTypeFound = true;
989+
}
990+
991+
if (allowFormView.getClass().equals(java.io.File.class)
992+
|| allowFormView.getClass().equals(Integer.class)
993+
|| allowFormView.getClass().equals(String.class)
994+
|| allowFormView.getClass().isEnum()) {
995+
map.put("allow_form_view", allowFormView);
996+
} else if (isListOfFile(allowFormView)) {
997+
for (int i = 0; i < getListSize(allowFormView); i++) {
998+
map.put("allow_form_view[" + i + "]", getFromList(allowFormView, i));
999+
}
1000+
} else {
1001+
map.put(
1002+
"allow_form_view",
1003+
JSON.getDefault().getMapper().writeValueAsString(allowFormView));
1004+
}
1005+
}
9561006
} catch (Exception e) {
9571007
throw new ApiException(e);
9581008
}

sdks/java-v2/docs/TemplateResponse.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ Contains information about the templates you and your team have created.
2424
| `namedFormFields` | [```List<TemplateResponseDocumentFormFieldBase>```](TemplateResponseDocumentFormFieldBase.md) | Deprecated. Use `form_fields` inside the [documents](https://developers.hellosign.com/api/reference/operation/templateGet/#!c&#x3D;200&amp;path&#x3D;template/documents&amp;t&#x3D;response) array instead. | |
2525
| `accounts` | [```List<TemplateResponseAccount>```](TemplateResponseAccount.md) | An array of the Accounts that can use this Template. | |
2626
| `attachments` | [```List<SignatureRequestResponseAttachment>```](SignatureRequestResponseAttachment.md) | Signer attachments. | |
27+
| `allowFormView` | ```Boolean``` | Allows signers to view the form fields before signing if set to `true`. Defaults to `false`. | |
2728

2829

2930

0 commit comments

Comments
 (0)