module:model/FormulaTab

module:model/FormulaTab

new module:model/FormulaTab()

Source:

Constructs a new FormulaTab.
The value of a formula tab is calculated from the values of other number or date tabs in the document. When the recipient completes the underlying fields, the formula tab calculates and displays the result. The formula property of the tab contains the references to the underlying tabs. See [Calculated Fields][calculatedfields] in the DocuSign Support Center to learn more about formulas. If a formula tab contains a paymentDetails property, the tab is considered a payment item. See [Requesting Payments Along with Signatures][paymentguide] in the DocuSign Support Center to learn more about payments. [calculatedfields]: https://support.docusign.com/en/guides/ndse-user-guide-calculated-fields [paymentguide]: https://support.docusign.com/en/guides/requesting-payments-along-with-signatures

Members

(inner) anchorAllowWhiteSpaceInCharacters :String

Source:
Type:
  • String

(inner) anchorAllowWhiteSpaceInCharactersMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the anchorAllowWhiteSpaceInCharacters property is editable.

Type:

(inner) anchorCaseSensitive :String

Source:

When set to true, the anchor string does not consider case when matching strings in the document. The default value is true.

Type:
  • String

(inner) anchorCaseSensitiveMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the anchorCaseSensitive property is editable.

Type:

(inner) anchorHorizontalAlignment :String

Source:

Specifies the alignment of anchor tabs with anchor strings. Possible values are left or right. The default value is left.

Type:
  • String

(inner) anchorHorizontalAlignmentMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the anchorHorizontalAlignment property is editable.

Type:

(inner) anchorIgnoreIfNotPresent :String

Source:

When set to true, this tab is ignored if anchorString is not found in the document.

Type:
  • String

(inner) anchorIgnoreIfNotPresentMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the anchorIgnoreIfNotPresent property is editable.

Type:

(inner) anchorMatchWholeWord :String

Source:

When set to true, the anchor string in this tab matches whole words only (strings embedded in other strings are ignored.) The default value is true.

Type:
  • String

(inner) anchorMatchWholeWordMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the anchorMatchWholeWord property is editable.

Type:

(inner) anchorString :String

Source:

Anchor text information for a radio button.

Type:
  • String

(inner) anchorStringMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the anchorString property is editable.

Type:

(inner) anchorTabProcessorVersion :String

Source:
Type:
  • String

(inner) anchorTabProcessorVersionMetadata :module:model/PropertyMetadata

Source:

Reserved for DocuSign.

Type:

(inner) anchorUnits :String

Source:

Specifies units of the X and Y offset. Units could be pixels, millimeters, centimeters, or inches.

Type:
  • String

(inner) anchorUnitsMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the anchorUnits property is editable.

Type:

(inner) anchorXOffset :String

Source:

Specifies the X axis location of the tab, in anchorUnits, relative to the anchorString.

Type:
  • String

(inner) anchorXOffsetMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the anchorXOffset property is editable.

Type:

(inner) anchorYOffset :String

Source:

Specifies the Y axis location of the tab, in anchorUnits, relative to the anchorString.

Type:
  • String

(inner) anchorYOffsetMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the anchorYOffset property is editable.

Type:

(inner) bold :String

Source:

When set to true, the information in the tab is bold.

Type:
  • String

(inner) boldMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the bold property is editable.

Type:

(inner) caption :String

Source:
Type:
  • String

(inner) captionMetadata :module:model/PropertyMetadata

Source:
Type:

(inner) concealValueOnDocument :String

Source:

When set to true, the field appears normally while the recipient is adding or modifying the information in the field, but the data is not visible (the characters are hidden by asterisks) to any other signer or the sender. When an envelope is completed the information is available to the sender through the Form Data link in the DocuSign Console. This setting applies only to text boxes and does not affect list boxes, radio buttons, or check boxes.

Type:
  • String

(inner) concealValueOnDocumentMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the concealValueOnDocument property is editable.

Type:

(inner) conditionalParentLabel :String

Source:

For conditional fields this is the TabLabel of the parent tab that controls this tab's visibility.

Type:
  • String

(inner) conditionalParentLabelMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the conditionalParentLabel property is editable.

Type:

(inner) conditionalParentValue :String

Source:

For conditional fields, this is the value of the parent tab that controls the tab's visibility. If the parent tab is a Checkbox, Radio button, Optional Signature, or Optional Initial use "on" as the value to show that the parent tab is active.

Type:
  • String

(inner) conditionalParentValueMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the conditionalParentValue property is editable.

Type:

(inner) customTabId :String

Source:

The DocuSign generated custom tab ID for the custom tab to be applied. This can only be used when adding new tabs for a recipient. When used, the new tab inherits all the custom tab properties.

Type:
  • String

(inner) customTabIdMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the customTabId property is editable.

Type:

(inner) disableAutoSize :String

Source:

When set to true, disables the auto sizing of single line text boxes in the signing screen when the signer enters data. If disabled users will only be able enter as much data as the text box can hold. By default this is false. This property only affects single line text boxes.

Type:
  • String

(inner) disableAutoSizeMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the disableAutoSize property is editable.

Type:

(inner) documentId :String

Source:

Specifies the document ID number that the tab is placed on. This must refer to an existing Document's ID attribute.

Type:
  • String

(inner) documentIdMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the documentId property is editable.

Type:

(inner) errorDetails :module:model/ErrorDetails

Source:

Array or errors.

Type:

(inner) font :String

Source:

The font to be used for the tab value. Supported Fonts: Arial, Arial, ArialNarrow, Calibri, CourierNew, Garamond, Georgia, Helvetica, LucidaConsole, Tahoma, TimesNewRoman, Trebuchet, Verdana, MSGothic, MSMincho, Default.

Type:
  • String

(inner) fontColor :String

Source:

The font color used for the information in the tab. Possible values are: Black, BrightBlue, BrightRed, DarkGreen, DarkRed, Gold, Green, NavyBlue, Purple, or White.

Type:
  • String

(inner) fontColorMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the fontColor property is editable.

Type:

(inner) fontMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the font property is editable.

Type:

(inner) fontSize :String

Source:

The font size used for the information in the tab. Possible values are: Size7, Size8, Size9, Size10, Size11, Size12, Size14, Size16, Size18, Size20, Size22, Size24, Size26, Size28, Size36, Size48, or Size72.

Type:
  • String

(inner) fontSizeMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the fontSize property is editable.

Type:

(inner) formOrder :String

Source:
Type:
  • String

(inner) formOrderMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the formOrder property is editable.

Type:

(inner) formPageLabel :String

Source:
Type:
  • String

(inner) formPageLabelMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the formPageLabel property is editable.

Type:

(inner) formPageNumber :String

Source:
Type:
  • String

(inner) formPageNumberMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the fromPageNumber property is editable.

Type:

(inner) formula :String

Source:

The Formula string contains the TabLabel for the reference tabs used in the formula and calculation operators. Each TabLabel must be contained in brackets. Maximum Length: 2000 characters. Example: Three tabs (TabLabels: Line1, Line2, and Tax) need to be added together. The formula string would be: [Line1]+[Line2]+[Tax]

Type:
  • String

(inner) formulaMetadata :module:model/PropertyMetadata

Source:

Metadata indicating if the sender can edit the formula property.

Type:

(inner) height :String

Source:

Height of the tab in pixels.

Type:
  • String

(inner) heightMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the height property is editable.

Type:

(inner) hidden :String

Source:
Type:
  • String

(inner) hiddenMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the hidden property is editable.

Type:

(inner) isPaymentAmount :String

Source:

When set to true, sets this as a payment tab. Can only be used with Text, Number, Formula, or List tabs. The value of the tab must be a number.

Type:
  • String

(inner) isPaymentAmountMetadata :module:model/PropertyMetadata

Source:

Reserved for DocuSign.

Type:

(inner) italic :String

Source:

When set to true, the information in the tab is italic.

Type:
  • String

(inner) italicMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the italic property is editable.

Type:

(inner) localePolicy :module:model/LocalePolicyTab

Source:

Reserved for DocuSign.

Type:

(inner) locked :String

Source:

When set to true, the signer cannot change the data of the custom tab.

Type:
  • String

(inner) lockedMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the locked property is editable.

Type:

(inner) maxLength :String

Source:

An optional value that describes the maximum length of the property when the property is a string.

Type:
  • String

(inner) maxLengthMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the maxLength property is editable.

Type:

(inner) mergeField :module:model/MergeField

Source:

Contains the information necessary to map the tab to a field in SalesForce.

Type:

(inner) mergeFieldXml :String

Source:
Type:
  • String

(inner) name :String

Source:
Type:
  • String

(inner) nameMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the name property is editable. This property is read-only.

Type:

(inner) originalValue :String

Source:

The initial value of the tab when it was sent to the recipient.

Type:
  • String

(inner) originalValueMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the originalValue property is editable.

Type:

(inner) pageNumber :String

Source:

Specifies the page number on which the tab is located.

Type:
  • String

(inner) pageNumberMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the pageNumber property is editable.

Type:

(inner) paymentDetails :module:model/PaymentDetails

Source:

This property indicates that this formula tab is a payment item. See [Requesting Payments Along with Signatures][paymentguide] in the DocuSign Support Center to learn more about payments. [paymentguide]: https://support.docusign.com/en/guides/requesting-payments-along-with-signatures

Type:

(inner) recipientId :String

Source:

Unique for the recipient. It is used by the tab element to indicate which recipient is to sign the Document.

Type:
  • String

(inner) recipientIdGuid :String

Source:
Type:
  • String

(inner) recipientIdGuidMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the recipientIdGuid property is editable.

Type:

(inner) recipientIdMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the recipientId property is editable.

Type:

(inner) requireAll :String

Source:

When set to true and shared is true, information must be entered in this field to complete the envelope.

Type:
  • String

(inner) requireAllMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the requireAll property is editable.

Type:

(inner) required :String

Source:

When set to true, the signer is required to fill out this tab

Type:
  • String

(inner) requiredMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the required property is editable.

Type:

(inner) requireInitialOnSharedChange :String

Source:

Optional element for field markup. When set to true, the signer is required to initial when they modify a shared field.

Type:
  • String

(inner) requireInitialOnSharedChangeMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the requireInitialOnSharedChange property is editable.

Type:

(inner) roundDecimalPlaces :String

Source:
Type:
  • String

(inner) roundDecimalPlacesMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the roundDecimalPlaces property is editable.

Type:

(inner) senderRequired :String

Source:

When set to true, the sender must populate the tab before an envelope can be sent using the template. This value tab can only be changed by modifying (PUT) the template. Tabs with a senderRequired value of true cannot be deleted from an envelope.

Type:
  • String

(inner) senderRequiredMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the senderRequired property is editable.

Type:

(inner) shared :String

Source:

When set to true, this custom tab is shared.

Type:
  • String

(inner) sharedMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the shared property is editable.

Type:

(inner) shareToRecipients :String

Source:
Type:
  • String

(inner) shareToRecipientsMetadata :module:model/PropertyMetadata

Source:

Reserved for DocuSign.

Type:

(inner) smartContractInformation :module:model/SmartContractInformation

Source:

Reserved for DocuSign.

Type:

(inner) source :String

Source:
Type:
  • String

(inner) status :String

Source:

Indicates the envelope status. Valid values are: * sent - The envelope is sent to the recipients. * created - The envelope is saved as a draft and can be modified and sent later.

Type:
  • String

(inner) statusMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the status property is editable.

Type:

(inner) tabGroupLabels :Array.<String>

Source:
Type:
  • Array.<String>

(inner) tabGroupLabelsMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the tabGroupLabels property is editable.

Type:

(inner) tabId :String

Source:

The unique identifier for the tab. The tabid can be retrieved with the [ML:GET call].

Type:
  • String

(inner) tabIdMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the tabId property is editable.

Type:

(inner) tabLabel :String

Source:

The label string associated with the tab.

Type:
  • String

(inner) tabLabelMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the tabLabel property is editable.

Type:

(inner) tabOrder :String

Source:
Type:
  • String

(inner) tabOrderMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the tabOrder property is editable.

Type:

(inner) tabType :String

Source:
Type:
  • String

(inner) tabTypeMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the tabType property is editable.

Type:

(inner) templateLocked :String

Source:

When set to true, the sender cannot change any attributes of the recipient. Used only when working with template recipients.

Type:
  • String

(inner) templateLockedMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the templateLocked property is editable.

Type:

(inner) templateRequired :String

Source:

When set to true, the sender may not remove the recipient. Used only when working with template recipients.

Type:
  • String

(inner) templateRequiredMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the templateRequired property is editable.

Type:

(inner) tooltip :String

Source:
Type:
  • String

(inner) toolTipMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the toolTip property is editable.

Type:

(inner) underline :String

Source:

When set to true, the information in the tab is underlined.

Type:
  • String

(inner) underlineMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the underline property is editable.

Type:

(inner) validationMessage :String

Source:

The message displayed if the custom tab fails input validation (either custom of embedded).

Type:
  • String

(inner) validationMessageMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the validationMessage property is editable.

Type:

(inner) validationPattern :String

Source:

A regular expression used to validate input for the tab.

Type:
  • String

(inner) validationPatternMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the validationPattern property is editable.

Type:

(inner) value :String

Source:

Specifies the value of the tab.

Type:
  • String

(inner) valueMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the value property is editable.

Type:

(inner) width :String

Source:

Width of the tab in pixels.

Type:
  • String

(inner) widthMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the width property is editable.

Type:

(inner) xPosition :String

Source:

This indicates the horizontal offset of the object on the page. DocuSign uses 72 DPI when determining position.

Type:
  • String

(inner) xPositionMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the xPosition property is editable.

Type:

(inner) yPosition :String

Source:

This indicates the vertical offset of the object on the page. DocuSign uses 72 DPI when determining position.

Type:
  • String

(inner) yPositionMetadata :module:model/PropertyMetadata

Source:

Metadata that indicates whether the yPosition property is editable.

Type:

Methods

(static) constructFromObject(data, obj) → {module:model/FormulaTab}

Source:

Constructs a FormulaTab from a plain JavaScript object, optionally creating a new instance.
Copies all relevant properties from data to obj if supplied or a new instance if not.

Parameters:
Name Type Description
data Object

The plain JavaScript object bearing properties of interest.

obj module:model/FormulaTab

Optional instance to populate.

Returns:

The populated FormulaTab instance.

Type
module:model/FormulaTab