Class: DocuSign_eSign::Witness

Inherits:
Object
  • Object
show all
Defined in:
lib/docusign_esign/models/witness.rb

Overview

A complex type containing information about a witness recipient. Witnesses are recipients whose signatures affirm that the identified signers have signed the documents in the envelope.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(attributes = {}) ⇒ Witness

Initializes the object

Parameters:

  • attributes (Hash) (defaults to: {}) —

    Model attributes in the form of hash



531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
 
# File 'lib/docusign_esign/models/witness.rb', line 531

def initialize(attributes = {})
  return unless attributes.is_a?(Hash)

  # convert string to symbol for hash key
  attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }

  if attributes.has_key?(:'accessCode')
    self.access_code = attributes[:'accessCode']
  end

  if attributes.has_key?(:'accessCodeMetadata')
    self.access_code_metadata = attributes[:'accessCodeMetadata']
  end

  if attributes.has_key?(:'addAccessCodeToEmail')
    self.add_access_code_to_email = attributes[:'addAccessCodeToEmail']
  end

  if attributes.has_key?(:'additionalNotifications')
    if (value = attributes[:'additionalNotifications']).is_a?(Array)
      self.additional_notifications = value
    end
  end

  if attributes.has_key?(:'agentCanEditEmail')
    self.agent_can_edit_email = attributes[:'agentCanEditEmail']
  end

  if attributes.has_key?(:'agentCanEditName')
    self.agent_can_edit_name = attributes[:'agentCanEditName']
  end

  if attributes.has_key?(:'allowSystemOverrideForLockedRecipient')
    self.allow_system_override_for_locked_recipient = attributes[:'allowSystemOverrideForLockedRecipient']
  end

  if attributes.has_key?(:'autoNavigation')
    self.auto_navigation = attributes[:'autoNavigation']
  end

  if attributes.has_key?(:'autoRespondedReason')
    self.auto_responded_reason = attributes[:'autoRespondedReason']
  end

  if attributes.has_key?(:'bulkRecipientsUri')
    self.bulk_recipients_uri = attributes[:'bulkRecipientsUri']
  end

  if attributes.has_key?(:'bulkSendV2Recipient')
    self.bulk_send_v2_recipient = attributes[:'bulkSendV2Recipient']
  end

  if attributes.has_key?(:'canSignOffline')
    self.can_sign_offline = attributes[:'canSignOffline']
  end

  if attributes.has_key?(:'clientUserId')
    self.client_user_id = attributes[:'clientUserId']
  end

  if attributes.has_key?(:'completedCount')
    self.completed_count = attributes[:'completedCount']
  end

  if attributes.has_key?(:'consentDetailsList')
    if (value = attributes[:'consentDetailsList']).is_a?(Array)
      self.consent_details_list = value
    end
  end

  if attributes.has_key?(:'creationReason')
    self.creation_reason = attributes[:'creationReason']
  end

  if attributes.has_key?(:'customFields')
    if (value = attributes[:'customFields']).is_a?(Array)
      self.custom_fields = value
    end
  end

  if attributes.has_key?(:'declinedDateTime')
    self.declined_date_time = attributes[:'declinedDateTime']
  end

  if attributes.has_key?(:'declinedReason')
    self.declined_reason = attributes[:'declinedReason']
  end

  if attributes.has_key?(:'defaultRecipient')
    self.default_recipient = attributes[:'defaultRecipient']
  end

  if attributes.has_key?(:'delegatedBy')
    self.delegated_by = attributes[:'delegatedBy']
  end

  if attributes.has_key?(:'delegatedTo')
    if (value = attributes[:'delegatedTo']).is_a?(Array)
      self.delegated_to = value
    end
  end

  if attributes.has_key?(:'deliveredDateTime')
    self.delivered_date_time = attributes[:'deliveredDateTime']
  end

  if attributes.has_key?(:'deliveryMethod')
    self.delivery_method = attributes[:'deliveryMethod']
  end

  if attributes.has_key?(:'deliveryMethodMetadata')
    self.delivery_method_metadata = attributes[:'deliveryMethodMetadata']
  end

  if attributes.has_key?(:'designatorId')
    self.designator_id = attributes[:'designatorId']
  end

  if attributes.has_key?(:'designatorIdGuid')
    self.designator_id_guid = attributes[:'designatorIdGuid']
  end

  if attributes.has_key?(:'documentVisibility')
    if (value = attributes[:'documentVisibility']).is_a?(Array)
      self.document_visibility = value
    end
  end

  if attributes.has_key?(:'email')
    self.email = attributes[:'email']
  end

  if attributes.has_key?(:'emailMetadata')
    self.email_metadata = attributes[:'emailMetadata']
  end

  if attributes.has_key?(:'emailNotification')
    self.email_notification = attributes[:'emailNotification']
  end

  if attributes.has_key?(:'emailRecipientPostSigningURL')
    self.email_recipient_post_signing_url = attributes[:'emailRecipientPostSigningURL']
  end

  if attributes.has_key?(:'embeddedRecipientStartURL')
    self.embedded_recipient_start_url = attributes[:'embeddedRecipientStartURL']
  end

  if attributes.has_key?(:'errorDetails')
    self.error_details = attributes[:'errorDetails']
  end

  if attributes.has_key?(:'excludedDocuments')
    if (value = attributes[:'excludedDocuments']).is_a?(Array)
      self.excluded_documents = value
    end
  end

  if attributes.has_key?(:'faxNumber')
    self.fax_number = attributes[:'faxNumber']
  end

  if attributes.has_key?(:'faxNumberMetadata')
    self.fax_number_metadata = attributes[:'faxNumberMetadata']
  end

  if attributes.has_key?(:'firstName')
    self.first_name = attributes[:'firstName']
  end

  if attributes.has_key?(:'firstNameMetadata')
    self.first_name_metadata = attributes[:'firstNameMetadata']
  end

  if attributes.has_key?(:'fullName')
    self.full_name = attributes[:'fullName']
  end

  if attributes.has_key?(:'fullNameMetadata')
    self.full_name_metadata = attributes[:'fullNameMetadata']
  end

  if attributes.has_key?(:'idCheckConfigurationName')
    self.id_check_configuration_name = attributes[:'idCheckConfigurationName']
  end

  if attributes.has_key?(:'idCheckConfigurationNameMetadata')
    self.id_check_configuration_name_metadata = attributes[:'idCheckConfigurationNameMetadata']
  end

  if attributes.has_key?(:'idCheckInformationInput')
    self.id_check_information_input = attributes[:'idCheckInformationInput']
  end

  if attributes.has_key?(:'identityVerification')
    self.identity_verification = attributes[:'identityVerification']
  end

  if attributes.has_key?(:'inheritEmailNotificationConfiguration')
    self.inherit_email_notification_configuration = attributes[:'inheritEmailNotificationConfiguration']
  end

  if attributes.has_key?(:'isBulkRecipient')
    self.is_bulk_recipient = attributes[:'isBulkRecipient']
  end

  if attributes.has_key?(:'isBulkRecipientMetadata')
    self.is_bulk_recipient_metadata = attributes[:'isBulkRecipientMetadata']
  end

  if attributes.has_key?(:'lastName')
    self.last_name = attributes[:'lastName']
  end

  if attributes.has_key?(:'lastNameMetadata')
    self.last_name_metadata = attributes[:'lastNameMetadata']
  end

  if attributes.has_key?(:'lockedRecipientPhoneAuthEditable')
    self.locked_recipient_phone_auth_editable = attributes[:'lockedRecipientPhoneAuthEditable']
  end

  if attributes.has_key?(:'lockedRecipientSmsEditable')
    self.locked_recipient_sms_editable = attributes[:'lockedRecipientSmsEditable']
  end

  if attributes.has_key?(:'name')
    self.name = attributes[:'name']
  end

  if attributes.has_key?(:'nameMetadata')
    self.name_metadata = attributes[:'nameMetadata']
  end

  if attributes.has_key?(:'notaryId')
    self.notary_id = attributes[:'notaryId']
  end

  if attributes.has_key?(:'notarySignerEmailSent')
    self.notary_signer_email_sent = attributes[:'notarySignerEmailSent']
  end

  if attributes.has_key?(:'note')
    self.note = attributes[:'note']
  end

  if attributes.has_key?(:'noteMetadata')
    self.note_metadata = attributes[:'noteMetadata']
  end

  if attributes.has_key?(:'offlineAttributes')
    self.offline_attributes = attributes[:'offlineAttributes']
  end

  if attributes.has_key?(:'phoneAuthentication')
    self.phone_authentication = attributes[:'phoneAuthentication']
  end

  if attributes.has_key?(:'phoneNumber')
    self.phone_number = attributes[:'phoneNumber']
  end

  if attributes.has_key?(:'proofFile')
    self.proof_file = attributes[:'proofFile']
  end

  if attributes.has_key?(:'recipientAttachments')
    if (value = attributes[:'recipientAttachments']).is_a?(Array)
      self.recipient_attachments = value
    end
  end

  if attributes.has_key?(:'recipientAuthenticationStatus')
    self.recipient_authentication_status = attributes[:'recipientAuthenticationStatus']
  end

  if attributes.has_key?(:'recipientFeatureMetadata')
    if (value = attributes[:'recipientFeatureMetadata']).is_a?(Array)
      self.recipient_feature_metadata = value
    end
  end

  if attributes.has_key?(:'recipientId')
    self.recipient_id = attributes[:'recipientId']
  end

  if attributes.has_key?(:'recipientIdGuid')
    self.recipient_id_guid = attributes[:'recipientIdGuid']
  end

  if attributes.has_key?(:'recipientSignatureProviders')
    if (value = attributes[:'recipientSignatureProviders']).is_a?(Array)
      self.recipient_signature_providers = value
    end
  end

  if attributes.has_key?(:'recipientSuppliesTabs')
    self.recipient_supplies_tabs = attributes[:'recipientSuppliesTabs']
  end

  if attributes.has_key?(:'recipientType')
    self.recipient_type = attributes[:'recipientType']
  end

  if attributes.has_key?(:'recipientTypeMetadata')
    self.recipient_type_metadata = attributes[:'recipientTypeMetadata']
  end

  if attributes.has_key?(:'requireIdLookup')
    self.require_id_lookup = attributes[:'requireIdLookup']
  end

  if attributes.has_key?(:'requireIdLookupMetadata')
    self.require_id_lookup_metadata = attributes[:'requireIdLookupMetadata']
  end

  if attributes.has_key?(:'requireSignerCertificate')
    self.require_signer_certificate = attributes[:'requireSignerCertificate']
  end

  if attributes.has_key?(:'requireSignOnPaper')
    self.require_sign_on_paper = attributes[:'requireSignOnPaper']
  end

  if attributes.has_key?(:'requireUploadSignature')
    self.require_upload_signature = attributes[:'requireUploadSignature']
  end

  if attributes.has_key?(:'roleName')
    self.role_name = attributes[:'roleName']
  end

  if attributes.has_key?(:'routingOrder')
    self.routing_order = attributes[:'routingOrder']
  end

  if attributes.has_key?(:'routingOrderMetadata')
    self.routing_order_metadata = attributes[:'routingOrderMetadata']
  end

  if attributes.has_key?(:'sentDateTime')
    self.sent_date_time = attributes[:'sentDateTime']
  end

  if attributes.has_key?(:'signatureInfo')
    self.signature_info = attributes[:'signatureInfo']
  end

  if attributes.has_key?(:'signedDateTime')
    self.signed_date_time = attributes[:'signedDateTime']
  end

  if attributes.has_key?(:'signInEachLocation')
    self. = attributes[:'signInEachLocation']
  end

  if attributes.has_key?(:'signInEachLocationMetadata')
    self. = attributes[:'signInEachLocationMetadata']
  end

  if attributes.has_key?(:'signingGroupId')
    self.signing_group_id = attributes[:'signingGroupId']
  end

  if attributes.has_key?(:'signingGroupIdMetadata')
    self.signing_group_id_metadata = attributes[:'signingGroupIdMetadata']
  end

  if attributes.has_key?(:'signingGroupName')
    self.signing_group_name = attributes[:'signingGroupName']
  end

  if attributes.has_key?(:'signingGroupUsers')
    if (value = attributes[:'signingGroupUsers']).is_a?(Array)
      self.signing_group_users = value
    end
  end

  if attributes.has_key?(:'smsAuthentication')
    self.sms_authentication = attributes[:'smsAuthentication']
  end

  if attributes.has_key?(:'socialAuthentications')
    if (value = attributes[:'socialAuthentications']).is_a?(Array)
      self.social_authentications = value
    end
  end

  if attributes.has_key?(:'status')
    self.status = attributes[:'status']
  end

  if attributes.has_key?(:'statusCode')
    self.status_code = attributes[:'statusCode']
  end

  if attributes.has_key?(:'suppressEmails')
    self.suppress_emails = attributes[:'suppressEmails']
  end

  if attributes.has_key?(:'tabs')
    self.tabs = attributes[:'tabs']
  end

  if attributes.has_key?(:'templateLocked')
    self.template_locked = attributes[:'templateLocked']
  end

  if attributes.has_key?(:'templateRequired')
    self.template_required = attributes[:'templateRequired']
  end

  if attributes.has_key?(:'totalTabCount')
    self.total_tab_count = attributes[:'totalTabCount']
  end

  if attributes.has_key?(:'userId')
    self.user_id = attributes[:'userId']
  end

  if attributes.has_key?(:'witnessFor')
    self.witness_for = attributes[:'witnessFor']
  end

  if attributes.has_key?(:'witnessForGuid')
    self.witness_for_guid = attributes[:'witnessForGuid']
  end
end

Instance Attribute Details

#access_code ⇒ Object

If a value is provided, the recipient must enter the value as the access code to view and sign the envelope. Maximum Length: 50 characters and it must conform to the account’s access code format setting. If blank, but the signer ‘accessCode` property is set in the envelope, then that value is used. If blank and the signer `accessCode` property is not set, then the access code is not required.



18
19
20
 
# File 'lib/docusign_esign/models/witness.rb', line 18

def access_code
  @access_code
end

#access_code_metadata ⇒ Object

Metadata that indicates whether the ‘accessCode` property is editable. This property is read-only.



21
22
23
 
# File 'lib/docusign_esign/models/witness.rb', line 21

def access_code_metadata
  @access_code_metadata
end

#add_access_code_to_email ⇒ Object

This Optional attribute indicates that the access code will be added to the email sent to the recipient; this nullifies the Security measure of Access Code on the recipient.



24
25
26
 
# File 'lib/docusign_esign/models/witness.rb', line 24

def add_access_code_to_email
  @add_access_code_to_email
end

#additional_notifications ⇒ Object

Returns the value of attribute additional_notifications.



27
28
29
 
# File 'lib/docusign_esign/models/witness.rb', line 27

def additional_notifications
  @additional_notifications
end

#agent_can_edit_email ⇒ Object

Returns the value of attribute agent_can_edit_email.



30
31
32
 
# File 'lib/docusign_esign/models/witness.rb', line 30

def agent_can_edit_email
  @agent_can_edit_email
end

#agent_can_edit_name ⇒ Object

Returns the value of attribute agent_can_edit_name.



33
34
35
 
# File 'lib/docusign_esign/models/witness.rb', line 33

def agent_can_edit_name
  @agent_can_edit_name
end

#allow_system_override_for_locked_recipient ⇒ Object

Returns the value of attribute allow_system_override_for_locked_recipient.



36
37
38
 
# File 'lib/docusign_esign/models/witness.rb', line 36

def allow_system_override_for_locked_recipient
  @allow_system_override_for_locked_recipient
end

#auto_navigation ⇒ Object

Returns the value of attribute auto_navigation.



39
40
41
 
# File 'lib/docusign_esign/models/witness.rb', line 39

def auto_navigation
  @auto_navigation
end

#auto_responded_reason ⇒ Object

Returns the value of attribute auto_responded_reason.



42
43
44
 
# File 'lib/docusign_esign/models/witness.rb', line 42

def auto_responded_reason
  @auto_responded_reason
end

#bulk_recipients_uri ⇒ Object

Contains a URI for an endpoint that allows you to easily retrieve bulk recipient information.



45
46
47
 
# File 'lib/docusign_esign/models/witness.rb', line 45

def bulk_recipients_uri
  @bulk_recipients_uri
end

#bulk_send_v2_recipient ⇒ Object

Returns the value of attribute bulk_send_v2_recipient.



48
49
50
 
# File 'lib/docusign_esign/models/witness.rb', line 48

def bulk_send_v2_recipient
  @bulk_send_v2_recipient
end

#can_sign_offline ⇒ Object

When set to true, specifies that the signer can perform the signing ceremony offline.



51
52
53
 
# File 'lib/docusign_esign/models/witness.rb', line 51

def can_sign_offline
  @can_sign_offline
end

#client_user_id ⇒ Object

Specifies whether the recipient is embedded or remote. If the ‘clientUserId` property is not null then the recipient is embedded. Note that if the `ClientUserId` property is set and either `SignerMustHaveAccount` or `SignerMustLoginToSign` property of the account settings is set to true, an error is generated on sending.ng. Maximum length: 100 characters.



54
55
56
 
# File 'lib/docusign_esign/models/witness.rb', line 54

def client_user_id
  @client_user_id
end

#completed_count ⇒ Object

Returns the value of attribute completed_count.



57
58
59
 
# File 'lib/docusign_esign/models/witness.rb', line 57

def completed_count
  @completed_count
end

#consent_details_list ⇒ Object

Returns the value of attribute consent_details_list.



60
61
62
 
# File 'lib/docusign_esign/models/witness.rb', line 60

def consent_details_list
  @consent_details_list
end

#creation_reason ⇒ Object

Returns the value of attribute creation_reason.



63
64
65
 
# File 'lib/docusign_esign/models/witness.rb', line 63

def creation_reason
  @creation_reason
end

#custom_fields ⇒ Object

An optional array of strings that allows the sender to provide custom data about the recipient. This information is returned in the envelope status but otherwise not used by DocuSign. Each customField string can be a maximum of 100 characters.



66
67
68
 
# File 'lib/docusign_esign/models/witness.rb', line 66

def custom_fields
  @custom_fields
end

#declined_date_time ⇒ Object

The date and time the recipient declined the document.



69
70
71
 
# File 'lib/docusign_esign/models/witness.rb', line 69

def declined_date_time
  @declined_date_time
end

#declined_reason ⇒ Object

The reason the recipient declined the document.



72
73
74
 
# File 'lib/docusign_esign/models/witness.rb', line 72

def declined_reason
  @declined_reason
end

#default_recipient ⇒ Object

Returns the value of attribute default_recipient.



75
76
77
 
# File 'lib/docusign_esign/models/witness.rb', line 75

def default_recipient
  @default_recipient
end

#delegated_by ⇒ Object

Returns the value of attribute delegated_by.



78
79
80
 
# File 'lib/docusign_esign/models/witness.rb', line 78

def delegated_by
  @delegated_by
end

#delegated_to ⇒ Object

Returns the value of attribute delegated_to.



81
82
83
 
# File 'lib/docusign_esign/models/witness.rb', line 81

def delegated_to
  @delegated_to
end

#delivered_date_time ⇒ Object

Reserved: For DocuSign use only.



84
85
86
 
# File 'lib/docusign_esign/models/witness.rb', line 84

def delivered_date_time
  @delivered_date_time
end

#delivery_method ⇒ Object

Reserved: For DocuSign use only.



87
88
89
 
# File 'lib/docusign_esign/models/witness.rb', line 87

def delivery_method
  @delivery_method
end

#delivery_method_metadata ⇒ Object

Reserved for DocuSign.



90
91
92
 
# File 'lib/docusign_esign/models/witness.rb', line 90

def delivery_method_metadata
  @delivery_method_metadata
end

#designator_id ⇒ Object

Returns the value of attribute designator_id.



93
94
95
 
# File 'lib/docusign_esign/models/witness.rb', line 93

def designator_id
  @designator_id
end

#designator_id_guid ⇒ Object

Returns the value of attribute designator_id_guid.



96
97
98
 
# File 'lib/docusign_esign/models/witness.rb', line 96

def designator_id_guid
  @designator_id_guid
end

#document_visibility ⇒ Object

Returns the value of attribute document_visibility.



99
100
101
 
# File 'lib/docusign_esign/models/witness.rb', line 99

def document_visibility
  @document_visibility
end

#email ⇒ Object

Returns the value of attribute email.



102
103
104
 
# File 'lib/docusign_esign/models/witness.rb', line 102

def email
  @email
end

#email_metadata ⇒ Object

Metadata that indicates whether the ‘email` property is editable. This property is read-only.



105
106
107
 
# File 'lib/docusign_esign/models/witness.rb', line 105

def email_metadata
  @email_metadata
end

#email_notification ⇒ Object

A complex type that contains information sets the language of the recipient’s email information. IMPORTANT: If you enable email notification for one recipient, you must enable email notification for all recipients as it overrides the Envelope Subject and ‘EmailBlurb` property settings.



108
109
110
 
# File 'lib/docusign_esign/models/witness.rb', line 108

def email_notification
  @email_notification
end

#email_recipient_post_signing_url ⇒ Object

Returns the value of attribute email_recipient_post_signing_url.



111
112
113
 
# File 'lib/docusign_esign/models/witness.rb', line 111

def email_recipient_post_signing_url
  @email_recipient_post_signing_url
end

#embedded_recipient_start_url ⇒ Object

Specifies a sender provided valid URL string for redirecting an embedded recipient. When using this option, the embedded recipient still receives an email from DocuSign, just as a remote recipient would. When the document link in the email is clicked the recipient is redirected, through DocuSign, to the supplied URL to complete their actions. When routing to the URL, the sender’s system (the server responding to the URL) must request a recipient token to launch a signing session. If set to ‘SIGN_AT_DOCUSIGN`, the recipient is directed to an embedded signing or viewing process directly at DocuSign. The signing or viewing action is initiated by the DocuSign system and the transaction activity and Certificate of Completion records will reflect this. In all other ways the process is identical to an embedded signing or viewing operation that is launched by any partner. It is important to remember that in a typical embedded workflow the authentication of an embedded recipient is the responsibility of the sending application, DocuSign expects that senders will follow their own process for establishing the recipient’s identity. In this workflow the recipient goes through the sending application before the embedded signing or viewing process in initiated. However, when the sending application sets ‘EmbeddedRecipientStartURL=SIGN_AT_DOCUSIGN`, the recipient goes directly to the embedded signing or viewing process bypassing the sending application and any authentication steps the sending application would use. In this case, DocuSign recommends that you use one of the normal DocuSign authentication features (Access Code, Phone Authentication, SMS Authentication, etc.) to verify the identity of the recipient. If the `clientUserId` property is NOT set, and the `embeddedRecipientStartURL` is set, DocuSign will ignore the redirect URL and launch the standard signing process for the email recipient. Information can be appended to the embedded recipient start URL using merge fields. The available merge fields items are: envelopeId, recipientId, recipientName, recipientEmail, and customFields. The `customFields` property must be set fort the recipient or envelope. The merge fields are enclosed in double brackets. Example: `senderHost/[[mergeField1]]/ beginSigningSession? [[mergeField2]]&[]`



114
115
116
 
# File 'lib/docusign_esign/models/witness.rb', line 114

def embedded_recipient_start_url
  @embedded_recipient_start_url
end

#error_details ⇒ Object

Array or errors.



117
118
119
 
# File 'lib/docusign_esign/models/witness.rb', line 117

def error_details
  @error_details
end

#excluded_documents ⇒ Object

Specifies the documents that are not visible to this recipient. Document Visibility must be enabled for the account and the ‘enforceSignerVisibility` property must be set to true for the envelope to use this. When enforce signer visibility is enabled, documents with tabs can only be viewed by signers that have a tab on that document. Recipients that have an administrative role (Agent, Editor, or Intermediaries) or informational role (Certified Deliveries or Carbon Copies) can always see all the documents in an envelope, unless they are specifically excluded using this setting when an envelope is sent. Documents that do not have tabs are always visible to all recipients, unless they are specifically excluded using this setting when an envelope is sent.



120
121
122
 
# File 'lib/docusign_esign/models/witness.rb', line 120

def excluded_documents
  @excluded_documents
end

#fax_number ⇒ Object

Reserved:



123
124
125
 
# File 'lib/docusign_esign/models/witness.rb', line 123

def fax_number
  @fax_number
end

#fax_number_metadata ⇒ Object

Reserved for DocuSign.



126
127
128
 
# File 'lib/docusign_esign/models/witness.rb', line 126

def fax_number_metadata
  @fax_number_metadata
end

#first_name ⇒ Object

The user’s first name. Maximum Length: 50 characters.



129
130
131
 
# File 'lib/docusign_esign/models/witness.rb', line 129

def first_name
  @first_name
end

#first_name_metadata ⇒ Object

Metadata that indicates whether the ‘firstName` property is editable. This property is read-only.



132
133
134
 
# File 'lib/docusign_esign/models/witness.rb', line 132

def first_name_metadata
  @first_name_metadata
end

#full_name ⇒ Object

Returns the value of attribute full_name.



135
136
137
 
# File 'lib/docusign_esign/models/witness.rb', line 135

def full_name
  @full_name
end

#full_name_metadata ⇒ Object

Reserved for DocuSign.



138
139
140
 
# File 'lib/docusign_esign/models/witness.rb', line 138

def full_name_metadata
  @full_name_metadata
end

#id_check_configuration_name ⇒ Object

Specifies authentication check by name. The names used here must be the same as the authentication type names used by the account (these name can also be found in the web console sending interface in the Identify list for a recipient,) This overrides any default authentication setting. Example: Your account has ID Check and SMS Authentication available and in the web console Identify list these appear as ‘ID Check $’ and ‘SMS Auth $’. To use ID check in an envelope, the idCheckConfigurationName should be ‘ID Check ’. If you wanted to use SMS, it would be ‘SMS Auth $’ and you would need to add you would need to add phone number information to the ‘smsAuthentication` node.



141
142
143
 
# File 'lib/docusign_esign/models/witness.rb', line 141

def id_check_configuration_name
  @id_check_configuration_name
end

#id_check_configuration_name_metadata ⇒ Object

Metadata that indicates whether the ‘idCheckConfigurationName` property is editable. This property is read-only.



144
145
146
 
# File 'lib/docusign_esign/models/witness.rb', line 144

def id_check_configuration_name_metadata
  @id_check_configuration_name_metadata
end

#id_check_information_input ⇒ Object

An object that contains input information related to a recipient ID check.



147
148
149
 
# File 'lib/docusign_esign/models/witness.rb', line 147

def id_check_information_input
  @id_check_information_input
end

#identity_verification ⇒ Object

Specifies the ID Verification workflow applied on an envelope by workflow ID. <br/>See the [list](/docs/esign-rest-api/reference/accounts/identityverifications/list/) method in the [IdentityVerifications](/docs/esign-rest-api/reference/accounts/identityverifications/) resource for more information on how to retrieve workflow IDs available for an account. <br/>This can be used in addition to other [recipient authentication](support.docusign.com/en/guides/ndse-user-guide-recipient-authentication) methods. <br/>Note that ID Verification and ID Check are two distinct methods. ID Verification checks recipients’ identity by verifying their ID while ID Check relies on data available on public records (such as current and former address).



150
151
152
 
# File 'lib/docusign_esign/models/witness.rb', line 150

def identity_verification
  @identity_verification
end

#inherit_email_notification_configuration ⇒ Object

When set to true and the envelope recipient creates a DocuSign account after signing, the Manage Account Email Notification settings are used as the default settings for the recipient’s account.



153
154
155
 
# File 'lib/docusign_esign/models/witness.rb', line 153

def inherit_email_notification_configuration
  @inherit_email_notification_configuration
end

#is_bulk_recipient ⇒ Object

Returns the value of attribute is_bulk_recipient.



156
157
158
 
# File 'lib/docusign_esign/models/witness.rb', line 156

def is_bulk_recipient
  @is_bulk_recipient
end

#is_bulk_recipient_metadata ⇒ Object

Reserved for DocuSign.



159
160
161
 
# File 'lib/docusign_esign/models/witness.rb', line 159

def is_bulk_recipient_metadata
  @is_bulk_recipient_metadata
end

#last_name ⇒ Object

Returns the value of attribute last_name.



162
163
164
 
# File 'lib/docusign_esign/models/witness.rb', line 162

def last_name
  @last_name
end

#last_name_metadata ⇒ Object

Metadata that indicates whether the ‘lastName` property is editable. This property is read-only.



165
166
167
 
# File 'lib/docusign_esign/models/witness.rb', line 165

def last_name_metadata
  @last_name_metadata
end

#locked_recipient_phone_auth_editable ⇒ Object

Returns the value of attribute locked_recipient_phone_auth_editable.



168
169
170
 
# File 'lib/docusign_esign/models/witness.rb', line 168

def locked_recipient_phone_auth_editable
  @locked_recipient_phone_auth_editable
end

#locked_recipient_sms_editable ⇒ Object

Returns the value of attribute locked_recipient_sms_editable.



171
172
173
 
# File 'lib/docusign_esign/models/witness.rb', line 171

def locked_recipient_sms_editable
  @locked_recipient_sms_editable
end

#name ⇒ Object

Returns the value of attribute name.



174
175
176
 
# File 'lib/docusign_esign/models/witness.rb', line 174

def name
  @name
end

#name_metadata ⇒ Object

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



177
178
179
 
# File 'lib/docusign_esign/models/witness.rb', line 177

def name_metadata
  @name_metadata
end

#notary_id ⇒ Object

Returns the value of attribute notary_id.



180
181
182
 
# File 'lib/docusign_esign/models/witness.rb', line 180

def notary_id
  @notary_id
end

#notary_signer_email_sent ⇒ Object

Returns the value of attribute notary_signer_email_sent.



183
184
185
 
# File 'lib/docusign_esign/models/witness.rb', line 183

def notary_signer_email_sent
  @notary_signer_email_sent
end

#note ⇒ Object

Specifies a note that is unique to this recipient. This note is sent to the recipient via the signing email. The note displays in the signing UI near the upper left corner of the document on the signing screen. Maximum Length: 1000 characters.



186
187
188
 
# File 'lib/docusign_esign/models/witness.rb', line 186

def note
  @note
end

#note_metadata ⇒ Object

Metadata that indicates whether the ‘note` property is editable. This property is read-only.



189
190
191
 
# File 'lib/docusign_esign/models/witness.rb', line 189

def note_metadata
  @note_metadata
end

#offline_attributes ⇒ Object

Reserved for DocuSign.



192
193
194
 
# File 'lib/docusign_esign/models/witness.rb', line 192

def offline_attributes
  @offline_attributes
end

#phone_authentication ⇒ Object

When ‘idCheckConfigurationName` is set to `Phone Auth $`, you use this complex type to provide the recipient authentication method details. It contains the following elements: * `recipMayProvideNumber`: Boolean. When **true,** the recipient can use whatever phone number they choose. * `senderProvidedNumbers`: ArrayOfStrings. A list of phone numbers the recipient can use. * `recordVoicePrint`: Reserved for DocuSign. * `validateRecipProvidedNumber`: Reserved for DocuSign.



195
196
197
 
# File 'lib/docusign_esign/models/witness.rb', line 195

def phone_authentication
  @phone_authentication
end

#phone_number ⇒ Object

Describes the recipient phone number.



198
199
200
 
# File 'lib/docusign_esign/models/witness.rb', line 198

def phone_number
  @phone_number
end

#proof_file ⇒ Object

The proof file of the recipient.



201
202
203
 
# File 'lib/docusign_esign/models/witness.rb', line 201

def proof_file
  @proof_file
end

#recipient_attachments ⇒ Object

Reserved:



204
205
206
 
# File 'lib/docusign_esign/models/witness.rb', line 204

def recipient_attachments
  @recipient_attachments
end

#recipient_authentication_status ⇒ Object

Information about the recipient’s authentication status. This property is read-only.



207
208
209
 
# File 'lib/docusign_esign/models/witness.rb', line 207

def recipient_authentication_status
  @recipient_authentication_status
end

#recipient_feature_metadata ⇒ Object

Returns the value of attribute recipient_feature_metadata.



210
211
212
 
# File 'lib/docusign_esign/models/witness.rb', line 210

def recipient_feature_metadata
  @recipient_feature_metadata
end

#recipient_id ⇒ Object

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



213
214
215
 
# File 'lib/docusign_esign/models/witness.rb', line 213

def recipient_id
  @recipient_id
end

#recipient_id_guid ⇒ Object

Returns the value of attribute recipient_id_guid.



216
217
218
 
# File 'lib/docusign_esign/models/witness.rb', line 216

def recipient_id_guid
  @recipient_id_guid
end

#recipient_signature_providers ⇒ Object

Returns the value of attribute recipient_signature_providers.



219
220
221
 
# File 'lib/docusign_esign/models/witness.rb', line 219

def recipient_signature_providers
  @recipient_signature_providers
end

#recipient_supplies_tabs ⇒ Object

Returns the value of attribute recipient_supplies_tabs.



222
223
224
 
# File 'lib/docusign_esign/models/witness.rb', line 222

def recipient_supplies_tabs
  @recipient_supplies_tabs
end

#recipient_type ⇒ Object

Returns the value of attribute recipient_type.



225
226
227
 
# File 'lib/docusign_esign/models/witness.rb', line 225

def recipient_type
  @recipient_type
end

#recipient_type_metadata ⇒ Object

Metadata that indicates whether the ‘recipientType` property is editable. This property is read-only.



228
229
230
 
# File 'lib/docusign_esign/models/witness.rb', line 228

def recipient_type_metadata
  @recipient_type_metadata
end

#require_id_lookup ⇒ Object

When set to true, the recipient is required to use the specified ID check method (including Phone and SMS authentication) to validate their identity.



231
232
233
 
# File 'lib/docusign_esign/models/witness.rb', line 231

def require_id_lookup
  @require_id_lookup
end

#require_id_lookup_metadata ⇒ Object

Metadata that indicates whether the ‘requireIdLookup` property is editable. This property is read-only.



234
235
236
 
# File 'lib/docusign_esign/models/witness.rb', line 234

def require_id_lookup_metadata
  @require_id_lookup_metadata
end

#require_sign_on_paper ⇒ Object

Returns the value of attribute require_sign_on_paper.



240
241
242
 
# File 'lib/docusign_esign/models/witness.rb', line 240

def require_sign_on_paper
  @require_sign_on_paper
end

#require_signer_certificate ⇒ Object

Returns the value of attribute require_signer_certificate.



237
238
239
 
# File 'lib/docusign_esign/models/witness.rb', line 237

def require_signer_certificate
  @require_signer_certificate
end

#require_upload_signature ⇒ Object

Returns the value of attribute require_upload_signature.



243
244
245
 
# File 'lib/docusign_esign/models/witness.rb', line 243

def require_upload_signature
  @require_upload_signature
end

#role_name ⇒ Object

Optional element. Specifies the role name associated with the recipient.<br/><br/>This is required when working with template recipients.



246
247
248
 
# File 'lib/docusign_esign/models/witness.rb', line 246

def role_name
  @role_name
end

#routing_order ⇒ Object

Specifies the routing order of the recipient in the envelope.



249
250
251
 
# File 'lib/docusign_esign/models/witness.rb', line 249

def routing_order
  @routing_order
end

#routing_order_metadata ⇒ Object

Metadata that indicates whether the ‘routingOrder` property is editable. This property is read-only.



252
253
254
 
# File 'lib/docusign_esign/models/witness.rb', line 252

def routing_order_metadata
  @routing_order_metadata
end

#sent_date_time ⇒ Object

The date and time the envelope was sent.



255
256
257
 
# File 'lib/docusign_esign/models/witness.rb', line 255

def sent_date_time
  @sent_date_time
end

#sign_in_each_location ⇒ Object

When set to true, specifies that the signer must sign in all locations.



264
265
266
 
# File 'lib/docusign_esign/models/witness.rb', line 264

def 
  @sign_in_each_location
end

#sign_in_each_location_metadata ⇒ Object

Metadata that indicates whether the ‘signInEachLocation` property is editable. This property is read-only.



267
268
269
 
# File 'lib/docusign_esign/models/witness.rb', line 267

def 
  @sign_in_each_location_metadata
end

#signature_info ⇒ Object

Allows the sender to pre-specify the signature name, signature initials and signature font used in the signature stamp for the recipient. Used only with recipient types In Person Signers and Signers.



258
259
260
 
# File 'lib/docusign_esign/models/witness.rb', line 258

def signature_info
  @signature_info
end

#signed_date_time ⇒ Object

Reserved: For DocuSign use only.



261
262
263
 
# File 'lib/docusign_esign/models/witness.rb', line 261

def signed_date_time
  @signed_date_time
end

#signing_group_id ⇒ Object

When set to true and the feature is enabled in the sender’s account, the signing recipient is required to draw signatures and initials at each signature/initial tab ( instead of adopting a signature/initial style or only drawing a signature/initial once).



270
271
272
 
# File 'lib/docusign_esign/models/witness.rb', line 270

def signing_group_id
  @signing_group_id
end

#signing_group_id_metadata ⇒ Object

Metadata that indicates whether the ‘signingGroupId` property is editable. This property is read-only.



273
274
275
 
# File 'lib/docusign_esign/models/witness.rb', line 273

def signing_group_id_metadata
  @signing_group_id_metadata
end

#signing_group_name ⇒ Object

The display name for the signing group. Maximum Length: 100 characters.



276
277
278
 
# File 'lib/docusign_esign/models/witness.rb', line 276

def signing_group_name
  @signing_group_name
end

#signing_group_users ⇒ Object

A complex type that contains information about users in the signing group.



279
280
281
 
# File 'lib/docusign_esign/models/witness.rb', line 279

def signing_group_users
  @signing_group_users
end

#sms_authentication ⇒ Object

When ‘idCheckConfigurationName` is set to `SMS Auth $`, you use this complex type to provide the recipient authentication method details. It contains the element `senderProvidedNumbers`, which is an array of phone numbers that the recipient can use for SMS text authentication.



282
283
284
 
# File 'lib/docusign_esign/models/witness.rb', line 282

def sms_authentication
  @sms_authentication
end

#social_authentications ⇒ Object

Lists the social ID type that can be used for recipient authentication.



285
286
287
 
# File 'lib/docusign_esign/models/witness.rb', line 285

def social_authentications
  @social_authentications
end

#status ⇒ Object

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.



288
289
290
 
# File 'lib/docusign_esign/models/witness.rb', line 288

def status
  @status
end

#status_code ⇒ Object

Returns the value of attribute status_code.



291
292
293
 
# File 'lib/docusign_esign/models/witness.rb', line 291

def status_code
  @status_code
end

#suppress_emails ⇒ Object

Returns the value of attribute suppress_emails.



294
295
296
 
# File 'lib/docusign_esign/models/witness.rb', line 294

def suppress_emails
  @suppress_emails
end

#tabs ⇒ Object

A list of tabs, which are represented graphically as symbols on documents at the time of signing. Tabs show recipients where to sign, initial, or enter data. They may also display data to the recipients.



297
298
299
 
# File 'lib/docusign_esign/models/witness.rb', line 297

def tabs
  @tabs
end

#template_locked ⇒ Object

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



300
301
302
 
# File 'lib/docusign_esign/models/witness.rb', line 300

def template_locked
  @template_locked
end

#template_required ⇒ Object

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



303
304
305
 
# File 'lib/docusign_esign/models/witness.rb', line 303

def template_required
  @template_required
end

#total_tab_count ⇒ Object

Returns the value of attribute total_tab_count.



306
307
308
 
# File 'lib/docusign_esign/models/witness.rb', line 306

def total_tab_count
  @total_tab_count
end

#user_id ⇒ Object

Returns the value of attribute user_id.



309
310
311
 
# File 'lib/docusign_esign/models/witness.rb', line 309

def user_id
  @user_id
end

#witness_for ⇒ Object

Returns the value of attribute witness_for.



312
313
314
 
# File 'lib/docusign_esign/models/witness.rb', line 312

def witness_for
  @witness_for
end

#witness_for_guid ⇒ Object

Returns the value of attribute witness_for_guid.



315
316
317
 
# File 'lib/docusign_esign/models/witness.rb', line 315

def witness_for_guid
  @witness_for_guid
end

Class Method Details

.attribute_map ⇒ Object

Attribute mapping from ruby-style variable name to JSON key.



318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
 
# File 'lib/docusign_esign/models/witness.rb', line 318

def self.attribute_map
  {
    :'access_code' => :'accessCode',
    :'access_code_metadata' => :'accessCodeMetadata',
    :'add_access_code_to_email' => :'addAccessCodeToEmail',
    :'additional_notifications' => :'additionalNotifications',
    :'agent_can_edit_email' => :'agentCanEditEmail',
    :'agent_can_edit_name' => :'agentCanEditName',
    :'allow_system_override_for_locked_recipient' => :'allowSystemOverrideForLockedRecipient',
    :'auto_navigation' => :'autoNavigation',
    :'auto_responded_reason' => :'autoRespondedReason',
    :'bulk_recipients_uri' => :'bulkRecipientsUri',
    :'bulk_send_v2_recipient' => :'bulkSendV2Recipient',
    :'can_sign_offline' => :'canSignOffline',
    :'client_user_id' => :'clientUserId',
    :'completed_count' => :'completedCount',
    :'consent_details_list' => :'consentDetailsList',
    :'creation_reason' => :'creationReason',
    :'custom_fields' => :'customFields',
    :'declined_date_time' => :'declinedDateTime',
    :'declined_reason' => :'declinedReason',
    :'default_recipient' => :'defaultRecipient',
    :'delegated_by' => :'delegatedBy',
    :'delegated_to' => :'delegatedTo',
    :'delivered_date_time' => :'deliveredDateTime',
    :'delivery_method' => :'deliveryMethod',
    :'delivery_method_metadata' => :'deliveryMethodMetadata',
    :'designator_id' => :'designatorId',
    :'designator_id_guid' => :'designatorIdGuid',
    :'document_visibility' => :'documentVisibility',
    :'email' => :'email',
    :'email_metadata' => :'emailMetadata',
    :'email_notification' => :'emailNotification',
    :'email_recipient_post_signing_url' => :'emailRecipientPostSigningURL',
    :'embedded_recipient_start_url' => :'embeddedRecipientStartURL',
    :'error_details' => :'errorDetails',
    :'excluded_documents' => :'excludedDocuments',
    :'fax_number' => :'faxNumber',
    :'fax_number_metadata' => :'faxNumberMetadata',
    :'first_name' => :'firstName',
    :'first_name_metadata' => :'firstNameMetadata',
    :'full_name' => :'fullName',
    :'full_name_metadata' => :'fullNameMetadata',
    :'id_check_configuration_name' => :'idCheckConfigurationName',
    :'id_check_configuration_name_metadata' => :'idCheckConfigurationNameMetadata',
    :'id_check_information_input' => :'idCheckInformationInput',
    :'identity_verification' => :'identityVerification',
    :'inherit_email_notification_configuration' => :'inheritEmailNotificationConfiguration',
    :'is_bulk_recipient' => :'isBulkRecipient',
    :'is_bulk_recipient_metadata' => :'isBulkRecipientMetadata',
    :'last_name' => :'lastName',
    :'last_name_metadata' => :'lastNameMetadata',
    :'locked_recipient_phone_auth_editable' => :'lockedRecipientPhoneAuthEditable',
    :'locked_recipient_sms_editable' => :'lockedRecipientSmsEditable',
    :'name' => :'name',
    :'name_metadata' => :'nameMetadata',
    :'notary_id' => :'notaryId',
    :'notary_signer_email_sent' => :'notarySignerEmailSent',
    :'note' => :'note',
    :'note_metadata' => :'noteMetadata',
    :'offline_attributes' => :'offlineAttributes',
    :'phone_authentication' => :'phoneAuthentication',
    :'phone_number' => :'phoneNumber',
    :'proof_file' => :'proofFile',
    :'recipient_attachments' => :'recipientAttachments',
    :'recipient_authentication_status' => :'recipientAuthenticationStatus',
    :'recipient_feature_metadata' => :'recipientFeatureMetadata',
    :'recipient_id' => :'recipientId',
    :'recipient_id_guid' => :'recipientIdGuid',
    :'recipient_signature_providers' => :'recipientSignatureProviders',
    :'recipient_supplies_tabs' => :'recipientSuppliesTabs',
    :'recipient_type' => :'recipientType',
    :'recipient_type_metadata' => :'recipientTypeMetadata',
    :'require_id_lookup' => :'requireIdLookup',
    :'require_id_lookup_metadata' => :'requireIdLookupMetadata',
    :'require_signer_certificate' => :'requireSignerCertificate',
    :'require_sign_on_paper' => :'requireSignOnPaper',
    :'require_upload_signature' => :'requireUploadSignature',
    :'role_name' => :'roleName',
    :'routing_order' => :'routingOrder',
    :'routing_order_metadata' => :'routingOrderMetadata',
    :'sent_date_time' => :'sentDateTime',
    :'signature_info' => :'signatureInfo',
    :'signed_date_time' => :'signedDateTime',
    :'sign_in_each_location' => :'signInEachLocation',
    :'sign_in_each_location_metadata' => :'signInEachLocationMetadata',
    :'signing_group_id' => :'signingGroupId',
    :'signing_group_id_metadata' => :'signingGroupIdMetadata',
    :'signing_group_name' => :'signingGroupName',
    :'signing_group_users' => :'signingGroupUsers',
    :'sms_authentication' => :'smsAuthentication',
    :'social_authentications' => :'socialAuthentications',
    :'status' => :'status',
    :'status_code' => :'statusCode',
    :'suppress_emails' => :'suppressEmails',
    :'tabs' => :'tabs',
    :'template_locked' => :'templateLocked',
    :'template_required' => :'templateRequired',
    :'total_tab_count' => :'totalTabCount',
    :'user_id' => :'userId',
    :'witness_for' => :'witnessFor',
    :'witness_for_guid' => :'witnessForGuid'
  }
end

.swagger_types ⇒ Object

Attribute type mapping.



424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
 
# File 'lib/docusign_esign/models/witness.rb', line 424

def self.swagger_types
  {
    :'access_code' => :'String',
    :'access_code_metadata' => :'PropertyMetadata',
    :'add_access_code_to_email' => :'String',
    :'additional_notifications' => :'Array<RecipientAdditionalNotification>',
    :'agent_can_edit_email' => :'String',
    :'agent_can_edit_name' => :'String',
    :'allow_system_override_for_locked_recipient' => :'String',
    :'auto_navigation' => :'String',
    :'auto_responded_reason' => :'String',
    :'bulk_recipients_uri' => :'String',
    :'bulk_send_v2_recipient' => :'String',
    :'can_sign_offline' => :'String',
    :'client_user_id' => :'String',
    :'completed_count' => :'String',
    :'consent_details_list' => :'Array<ConsentDetails>',
    :'creation_reason' => :'String',
    :'custom_fields' => :'Array<String>',
    :'declined_date_time' => :'String',
    :'declined_reason' => :'String',
    :'default_recipient' => :'String',
    :'delegated_by' => :'DelegationInfo',
    :'delegated_to' => :'Array<DelegationInfo>',
    :'delivered_date_time' => :'String',
    :'delivery_method' => :'String',
    :'delivery_method_metadata' => :'PropertyMetadata',
    :'designator_id' => :'String',
    :'designator_id_guid' => :'String',
    :'document_visibility' => :'Array<DocumentVisibility>',
    :'email' => :'String',
    :'email_metadata' => :'PropertyMetadata',
    :'email_notification' => :'RecipientEmailNotification',
    :'email_recipient_post_signing_url' => :'String',
    :'embedded_recipient_start_url' => :'String',
    :'error_details' => :'ErrorDetails',
    :'excluded_documents' => :'Array<String>',
    :'fax_number' => :'String',
    :'fax_number_metadata' => :'PropertyMetadata',
    :'first_name' => :'String',
    :'first_name_metadata' => :'PropertyMetadata',
    :'full_name' => :'String',
    :'full_name_metadata' => :'PropertyMetadata',
    :'id_check_configuration_name' => :'String',
    :'id_check_configuration_name_metadata' => :'PropertyMetadata',
    :'id_check_information_input' => :'IdCheckInformationInput',
    :'identity_verification' => :'RecipientIdentityVerification',
    :'inherit_email_notification_configuration' => :'String',
    :'is_bulk_recipient' => :'String',
    :'is_bulk_recipient_metadata' => :'PropertyMetadata',
    :'last_name' => :'String',
    :'last_name_metadata' => :'PropertyMetadata',
    :'locked_recipient_phone_auth_editable' => :'String',
    :'locked_recipient_sms_editable' => :'String',
    :'name' => :'String',
    :'name_metadata' => :'PropertyMetadata',
    :'notary_id' => :'String',
    :'notary_signer_email_sent' => :'String',
    :'note' => :'String',
    :'note_metadata' => :'PropertyMetadata',
    :'offline_attributes' => :'OfflineAttributes',
    :'phone_authentication' => :'RecipientPhoneAuthentication',
    :'phone_number' => :'RecipientPhoneNumber',
    :'proof_file' => :'RecipientProofFile',
    :'recipient_attachments' => :'Array<RecipientAttachment>',
    :'recipient_authentication_status' => :'AuthenticationStatus',
    :'recipient_feature_metadata' => :'Array<FeatureAvailableMetadata>',
    :'recipient_id' => :'String',
    :'recipient_id_guid' => :'String',
    :'recipient_signature_providers' => :'Array<RecipientSignatureProvider>',
    :'recipient_supplies_tabs' => :'String',
    :'recipient_type' => :'String',
    :'recipient_type_metadata' => :'PropertyMetadata',
    :'require_id_lookup' => :'String',
    :'require_id_lookup_metadata' => :'PropertyMetadata',
    :'require_signer_certificate' => :'String',
    :'require_sign_on_paper' => :'String',
    :'require_upload_signature' => :'String',
    :'role_name' => :'String',
    :'routing_order' => :'String',
    :'routing_order_metadata' => :'PropertyMetadata',
    :'sent_date_time' => :'String',
    :'signature_info' => :'RecipientSignatureInformation',
    :'signed_date_time' => :'String',
    :'sign_in_each_location' => :'String',
    :'sign_in_each_location_metadata' => :'PropertyMetadata',
    :'signing_group_id' => :'String',
    :'signing_group_id_metadata' => :'PropertyMetadata',
    :'signing_group_name' => :'String',
    :'signing_group_users' => :'Array<UserInfo>',
    :'sms_authentication' => :'RecipientSMSAuthentication',
    :'social_authentications' => :'Array<SocialAuthentication>',
    :'status' => :'String',
    :'status_code' => :'String',
    :'suppress_emails' => :'String',
    :'tabs' => :'Tabs',
    :'template_locked' => :'String',
    :'template_required' => :'String',
    :'total_tab_count' => :'String',
    :'user_id' => :'String',
    :'witness_for' => :'String',
    :'witness_for_guid' => :'String'
  }
end

Instance Method Details

#==(o) ⇒ Object

Checks equality by comparing each attribute.

Parameters:

  • Object (Object) —

    to be compared



975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
 
# File 'lib/docusign_esign/models/witness.rb', line 975

def ==(o)
  return true if self.equal?(o)
  self.class == o.class &&
      access_code == o.access_code &&
      access_code_metadata == o.access_code_metadata &&
      add_access_code_to_email == o.add_access_code_to_email &&
      additional_notifications == o.additional_notifications &&
      agent_can_edit_email == o.agent_can_edit_email &&
      agent_can_edit_name == o.agent_can_edit_name &&
      allow_system_override_for_locked_recipient == o.allow_system_override_for_locked_recipient &&
      auto_navigation == o.auto_navigation &&
      auto_responded_reason == o.auto_responded_reason &&
      bulk_recipients_uri == o.bulk_recipients_uri &&
      bulk_send_v2_recipient == o.bulk_send_v2_recipient &&
      can_sign_offline == o.can_sign_offline &&
      client_user_id == o.client_user_id &&
      completed_count == o.completed_count &&
      consent_details_list == o.consent_details_list &&
      creation_reason == o.creation_reason &&
      custom_fields == o.custom_fields &&
      declined_date_time == o.declined_date_time &&
      declined_reason == o.declined_reason &&
      default_recipient == o.default_recipient &&
      delegated_by == o.delegated_by &&
      delegated_to == o.delegated_to &&
      delivered_date_time == o.delivered_date_time &&
      delivery_method == o.delivery_method &&
      delivery_method_metadata == o.delivery_method_metadata &&
      designator_id == o.designator_id &&
      designator_id_guid == o.designator_id_guid &&
      document_visibility == o.document_visibility &&
      email == o.email &&
      email_metadata == o.email_metadata &&
      email_notification == o.email_notification &&
      email_recipient_post_signing_url == o.email_recipient_post_signing_url &&
      embedded_recipient_start_url == o.embedded_recipient_start_url &&
      error_details == o.error_details &&
      excluded_documents == o.excluded_documents &&
      fax_number == o.fax_number &&
      fax_number_metadata == o.fax_number_metadata &&
      first_name == o.first_name &&
      first_name_metadata == o.first_name_metadata &&
      full_name == o.full_name &&
      full_name_metadata == o.full_name_metadata &&
      id_check_configuration_name == o.id_check_configuration_name &&
      id_check_configuration_name_metadata == o.id_check_configuration_name_metadata &&
      id_check_information_input == o.id_check_information_input &&
      identity_verification == o.identity_verification &&
      inherit_email_notification_configuration == o.inherit_email_notification_configuration &&
      is_bulk_recipient == o.is_bulk_recipient &&
      is_bulk_recipient_metadata == o.is_bulk_recipient_metadata &&
      last_name == o.last_name &&
      last_name_metadata == o.last_name_metadata &&
      locked_recipient_phone_auth_editable == o.locked_recipient_phone_auth_editable &&
      locked_recipient_sms_editable == o.locked_recipient_sms_editable &&
      name == o.name &&
      name_metadata == o.name_metadata &&
      notary_id == o.notary_id &&
      notary_signer_email_sent == o.notary_signer_email_sent &&
      note == o.note &&
      note_metadata == o.note_metadata &&
      offline_attributes == o.offline_attributes &&
      phone_authentication == o.phone_authentication &&
      phone_number == o.phone_number &&
      proof_file == o.proof_file &&
      recipient_attachments == o.recipient_attachments &&
      recipient_authentication_status == o.recipient_authentication_status &&
      recipient_feature_metadata == o.recipient_feature_metadata &&
      recipient_id == o.recipient_id &&
      recipient_id_guid == o.recipient_id_guid &&
      recipient_signature_providers == o.recipient_signature_providers &&
      recipient_supplies_tabs == o.recipient_supplies_tabs &&
      recipient_type == o.recipient_type &&
      recipient_type_metadata == o.recipient_type_metadata &&
      require_id_lookup == o.require_id_lookup &&
      require_id_lookup_metadata == o.require_id_lookup_metadata &&
      require_signer_certificate == o.require_signer_certificate &&
      require_sign_on_paper == o.require_sign_on_paper &&
      require_upload_signature == o.require_upload_signature &&
      role_name == o.role_name &&
      routing_order == o.routing_order &&
      routing_order_metadata == o.routing_order_metadata &&
      sent_date_time == o.sent_date_time &&
      signature_info == o.signature_info &&
      signed_date_time == o.signed_date_time &&
       == o. &&
       == o. &&
      signing_group_id == o.signing_group_id &&
      signing_group_id_metadata == o.signing_group_id_metadata &&
      signing_group_name == o.signing_group_name &&
      signing_group_users == o.signing_group_users &&
      sms_authentication == o.sms_authentication &&
      social_authentications == o.social_authentications &&
      status == o.status &&
      status_code == o.status_code &&
      suppress_emails == o.suppress_emails &&
      tabs == o.tabs &&
      template_locked == o.template_locked &&
      template_required == o.template_required &&
      total_tab_count == o.total_tab_count &&
      user_id == o.user_id &&
      witness_for == o.witness_for &&
      witness_for_guid == o.witness_for_guid
end

#_deserialize(type, value) ⇒ Object

Deserializes the data based on type

Parameters:

  • string —

    type Data type

  • string —

    value Value to be deserialized

Returns:

  • (Object) —

    Deserialized data



1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
 
# File 'lib/docusign_esign/models/witness.rb', line 1116

def _deserialize(type, value)
  case type.to_sym
  when :DateTime
    DateTime.parse(value)
  when :Date
    Date.parse(value)
  when :String
    value.to_s
  when :Integer
    value.to_i
  when :Float
    value.to_f
  when :BOOLEAN
    if value.to_s =~ /\A(true|t|yes|y|1)\z/i
      true
    else
      false
    end
  when :Object
    # generic object (usually a Hash), return directly
    value
  when /\AArray<(?<inner_type>.+)>\z/
    inner_type = Regexp.last_match[:inner_type]
    value.map { |v| _deserialize(inner_type, v) }
  when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
    k_type = Regexp.last_match[:k_type]
    v_type = Regexp.last_match[:v_type]
    {}.tap do |hash|
      value.each do |k, v|
        hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
      end
    end
  else # model
    temp_model = DocuSign_eSign.const_get(type).new
    temp_model.build_from_hash(value)
  end
end

#_to_hash(value) ⇒ Hash

Outputs non-array value in the form of hash For object, use to_hash. Otherwise, just return the value

Parameters:

  • value (Object) —

    Any valid value

Returns:

  • (Hash) —

    Returns the value in the form of hash



1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
 
# File 'lib/docusign_esign/models/witness.rb', line 1182

def _to_hash(value)
  if value.is_a?(Array)
    value.compact.map { |v| _to_hash(v) }
  elsif value.is_a?(Hash)
    {}.tap do |hash|
      value.each { |k, v| hash[k] = _to_hash(v) }
    end
  elsif value.respond_to? :to_hash
    value.to_hash
  else
    value
  end
end

#build_from_hash(attributes) ⇒ Object

Builds the object from hash

Parameters:

  • attributes (Hash) —

    Model attributes in the form of hash

Returns:

  • (Object) —

    Returns the model itself



1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
 
# File 'lib/docusign_esign/models/witness.rb', line 1095

def build_from_hash(attributes)
  return nil unless attributes.is_a?(Hash)
  self.class.swagger_types.each_pair do |key, type|
    if type =~ /\AArray<(.*)>/i
      # check to ensure the input is an array given that the attribute
      # is documented as an array but the input is not
      if attributes[self.class.attribute_map[key]].is_a?(Array)
        self.send("#{key}=", attributes[self.class.attribute_map[key]].map { |v| _deserialize($1, v) })
      end
    elsif !attributes[self.class.attribute_map[key]].nil?
      self.send("#{key}=", _deserialize(type, attributes[self.class.attribute_map[key]]))
    end # or else data not found in attributes(hash), not an issue as the data can be optional
  end

  self
end

#eql?(o) ⇒ Boolean

Parameters:

  • Object (Object) —

    to be compared

Returns:

  • (Boolean)

See Also:

  • `==` method


1082
1083
1084
 
# File 'lib/docusign_esign/models/witness.rb', line 1082

def eql?(o)
  self == o
end

#hash ⇒ Fixnum

Calculates hash code according to all attributes.

Returns:

  • (Fixnum) —

    Hash code



1088
1089
1090
 
# File 'lib/docusign_esign/models/witness.rb', line 1088

def hash
  [access_code, access_code_metadata, add_access_code_to_email, additional_notifications, agent_can_edit_email, agent_can_edit_name, allow_system_override_for_locked_recipient, auto_navigation, auto_responded_reason, bulk_recipients_uri, bulk_send_v2_recipient, can_sign_offline, client_user_id, completed_count, consent_details_list, creation_reason, custom_fields, declined_date_time, declined_reason, default_recipient, delegated_by, delegated_to, delivered_date_time, delivery_method, delivery_method_metadata, designator_id, designator_id_guid, document_visibility, email, email_metadata, email_notification, email_recipient_post_signing_url, embedded_recipient_start_url, error_details, excluded_documents, fax_number, fax_number_metadata, first_name, first_name_metadata, full_name, full_name_metadata, id_check_configuration_name, id_check_configuration_name_metadata, id_check_information_input, identity_verification, inherit_email_notification_configuration, is_bulk_recipient, is_bulk_recipient_metadata, last_name, last_name_metadata, locked_recipient_phone_auth_editable, locked_recipient_sms_editable, name, name_metadata, notary_id, notary_signer_email_sent, note, note_metadata, offline_attributes, phone_authentication, phone_number, proof_file, recipient_attachments, recipient_authentication_status, recipient_feature_metadata, recipient_id, recipient_id_guid, recipient_signature_providers, recipient_supplies_tabs, recipient_type, recipient_type_metadata, require_id_lookup, require_id_lookup_metadata, require_signer_certificate, require_sign_on_paper, require_upload_signature, role_name, routing_order, routing_order_metadata, sent_date_time, signature_info, signed_date_time, , , signing_group_id, signing_group_id_metadata, signing_group_name, signing_group_users, sms_authentication, social_authentications, status, status_code, suppress_emails, tabs, template_locked, template_required, total_tab_count, user_id, witness_for, witness_for_guid].hash
end

#list_invalid_properties ⇒ Object

Show invalid properties with the reasons. Usually used together with valid?

Returns:

  • Array for valid properties with the reasons



962
963
964
965
 
# File 'lib/docusign_esign/models/witness.rb', line 962

def list_invalid_properties
  invalid_properties = Array.new
  invalid_properties
end

#to_body ⇒ Hash

to_body is an alias to to_hash (backward compatibility)

Returns:

  • (Hash) —

    Returns the object in the form of hash



1162
1163
1164
 
# File 'lib/docusign_esign/models/witness.rb', line 1162

def to_body
  to_hash
end

#to_hash ⇒ Hash

Returns the object in the form of hash

Returns:

  • (Hash) —

    Returns the object in the form of hash



1168
1169
1170
1171
1172
1173
1174
1175
1176
 
# File 'lib/docusign_esign/models/witness.rb', line 1168

def to_hash
  hash = {}
  self.class.attribute_map.each_pair do |attr, param|
    value = self.send(attr)
    next if value.nil?
    hash[param] = _to_hash(value)
  end
  hash
end

#to_s ⇒ String

Returns the string representation of the object

Returns:

  • (String) —

    String presentation of the object



1156
1157
1158
 
# File 'lib/docusign_esign/models/witness.rb', line 1156

def to_s
  to_hash.to_s
end

#valid? ⇒ Boolean

Check to see if the all the properties in the model are valid

Returns:

  • (Boolean) —

    true if the model is valid



969
970
971
 
# File 'lib/docusign_esign/models/witness.rb', line 969

def valid?
  true
end