Skip to navigation

TabStatus

View as Markdown

The TabStatus element contains information on tabs in the document.

Schema

NameSchema TypeDescription
TabTypeTabTypeCodeReturns the tab type. This element is enumerator controlled and can have following values; InitialHere, SignHere, FullName, Company, Title, DateSigned, InitialHereOptional, EnvelopeID, Custom, SignerAttachment, SignHereOptional, Approve, or Decline. Note that FirstName, LastName, EmailAddress, and SignerAttachmentOptional tab types are not returned in this SOAP version.
StatusStringThe status of individual tabs. It can have the enumeration values; Active, Signed, Declined and N/A
XPosition/YPositionDoubleX position and Y position of the field. The X and Y positions originate at the upper left of the page and indicate the bottom left-most point of the field. For text fields, this is the upper left of the first letter of the text string. For signature fields, this is the upper left of the first letter of the signature stamp and does NOT include signature stamp image decoration which can surround the signature text.
SigneddateTimeNote: The Signed information is not returned in the response, even though it is included in the SOAP WSDL.Date and time when the document was signed by the recipient.
TabLabelStringThis would be the label of the custom tab.
TabNameStringThis would be the name of the custom tab.
TabValueStringThis element contains the value of the custom tab.
DocumentIDPositiveIntegerOnly returned when calling RequestStatusEx and RequestStatusesEx. Returns the originating document ID.
PageNumberPositiveIntegerOnly returned when calling RequestStatusEx and RequestStatusesEx. Returns the page number the tab is on.
OriginalValueStringOnly returned when calling RequestStatusEx and RequestStatusesEx. Original value before signing.
ValidationPatternStringOnly returned when calling RequestStatusEx and RequestStatusesEx. Validation pattern that was originally passed in, if any.
RoleNameStringOnly returned when calling RequestStatusEx and RequestStatusesEx. Only returned when the envelope originated from CreateEnvelopeFromTemplates. RoleName that this tab is associated with in the originating template.
ListValuesStringOnly returned when calling RequestStatusEx and RequestStatusesEx. Returns the list values passed in when the envelope was created.
ListSelectedValueStringOnly returned when calling RequestStatusEx and RequestStatusesEx. Returns the selected value from ListValues.
ScaleValueDecimalRepresents a decimal value of 0.0 to 1.0 position of the webcontrol scaling slider. A value of 1.0 represents full size.
CustomTabTypeCustomTabTypeReturns the custom tab type.