groupdocs 2.2.0 → 2.3.0

data/lib/groupdocs/signature/contact.rb

@@ -1,181 +1,181 @@
-module GroupDocs
-  class Signature::Contact < Api::Entity
-
-    INTEGRATION_PROVIDERS = {
-      :local     => 0,
-      :groupdocs => 1,
-      :google    => 2,
-    }
-
-    #
-    # Returns a list of all contacts.
-    #
-    # @param [Hash] options Hash of options
-    # @option options [Integer] :page Page to start with
-    # @option options [Integer] :records How many items to list
-    # @option options [String] :firstName Filter by first name
-    # @option options [String] :lastName Filter by last name
-    # @option options [String] :email Filter by last name
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [Array<GroupDocs::Signature::Contact>]
-    #
-    def self.get!(options = {}, access = {})
-      api = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :GET
-        request[:path] = '/signature/{{client_id}}/contacts'
-      end
-      api.add_params(options)
-      json = api.execute!
-
-      json[:contacts].map do |contact|
-        new(contact)
-      end
-    end
-
-    #
-    # Imports array of contacts.
-    #
-    # @example
-    #   contact_one = GroupDocs::Signature::Contact.new
-    #   contact_one.first_name = 'John'
-    #   contact_one.last_name = 'Smith'
-    #   contact_one.email = 'john@smith.com'
-    #   contact_two = GroupDocs::Signature::Contact.new
-    #   contact_two.first_name = 'Carla'
-    #   contact_two.last_name = 'Smith'
-    #   contact_two.email = 'carla@smith.com'
-    #   GroupDocs::Signature::Contact.import!([contact_one, contact_two])
-    #
-    # @param [Array<GroupDocs::Signature::Contact>] contacts
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def self.import!(contacts, access = {})
-      contacts.is_a?(Array) or raise ArgumentError, "Contacts should be array, received: #{contacts.inspect}"
-      contacts.each do |contact|
-        contact.is_a?(GroupDocs::Signature::Contact) or raise ArgumentError, "Contact should be GroupDocs::Signature::Contact, received: #{contact.inspect}"
-      end
-
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :POST
-        request[:path] = '/signature/{{client_id}}/contacts'
-        request[:request_body] = contacts.map { |contact| contact.to_hash }
-      end.execute!
-    end
-
-    #
-    # Adds contact integration.
-    #
-    # @example Add Google contacts integration
-    #   integration = {
-    #     provider:                :google,
-    #     refresh_token:           'token',
-    #     access_token:            'token',
-    #     access_token_expiration: '2014-12-12'
-    #   }
-    #
-    # @param [Hash] integration
-    # @option integration [Symbol] provider One of :local, :groupdocs or :google
-    # @option integration [String] refresh_token
-    # @option integration [String] access_token
-    # @option integration [String] access_token_exipration
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def self.add_integration!(integration, access = {})
-      payload = {
-        :provider              => INTEGRATION_PROVIDERS[integration[:provider]],
-        :refreshToken          => integration[:refresh_token],
-        :accessToken           => integration[:access_token],
-        :accessTokenExpiration => integration[:access_token_expiration],
-      }
-
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :POST
-        request[:path] = '/signature/{{client_id}}/integration'
-        request[:request_body] = payload
-      end.execute!
-    end
-
-    # @attr [String] id
-    attr_accessor :id
-    # @attr [String] firstName
-    attr_accessor :firstName
-    # @attr [String] lastName
-    attr_accessor :lastName
-    # @attr [String] nickname
-    attr_accessor :nickname
-    # @attr [String] email
-    attr_accessor :email
-    # @attr [String] provider
-    attr_accessor :provider
-
-    # Human-readable accessors
-    alias_accessor :first_name, :firstName
-    alias_accessor :last_name,  :lastName
-
-    #
-    # Adds contact.
-    #
-    # @example
-    #   contact = GroupDocs::Signature::Contact.new
-    #   contact.first_name = 'John'
-    #   contact.last_name = 'Smith'
-    #   contact.email = 'john@smith.com'
-    #   contact.add!
-    #
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def add!(access = {})
-      json = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :POST
-        request[:path] = '/signature/{{client_id}}/contact'
-        request[:request_body] = to_hash
-      end.execute!
-
-      self.id = json[:contact][:id]
-    end
-
-    #
-    # Updates contact.
-    #
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def update!(access = {})
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :POST
-        request[:path] = "/signature/{{client_id}}/contacts/#{id}"
-        request[:request_body] = to_hash
-      end.execute!
-    end
-
-    #
-    # Deletes contact.
-    #
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def delete!(access = {})
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :DELETE
-        request[:path] = "/signature/{{client_id}}/contacts/#{id}"
-      end.execute!
-    end
-
-  end # Signature::Contact
-end # GroupDocs
+module GroupDocs
+  class Signature::Contact < Api::Entity
+
+    INTEGRATION_PROVIDERS = {
+      :local     => 0,
+      :groupdocs => 1,
+      :google    => 2,
+    }
+
+    #
+    # Returns a list of all contacts.
+    #
+    # @param [Hash] options Hash of options
+    # @option options [Integer] :page Page to start with
+    # @option options [Integer] :records How many items to list
+    # @option options [String] :firstName Filter by first name
+    # @option options [String] :lastName Filter by last name
+    # @option options [String] :email Filter by last name
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array<GroupDocs::Signature::Contact>]
+    #
+    def self.get!(options = {}, access = {})
+      api = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = '/signature/{{client_id}}/contacts'
+      end
+      api.add_params(options)
+      json = api.execute!
+
+      json[:contacts].map do |contact|
+        new(contact)
+      end
+    end
+
+    #
+    # Imports array of contacts.
+    #
+    # @example
+    #   contact_one = GroupDocs::Signature::Contact.new
+    #   contact_one.first_name = 'John'
+    #   contact_one.last_name = 'Smith'
+    #   contact_one.email = 'john@smith.com'
+    #   contact_two = GroupDocs::Signature::Contact.new
+    #   contact_two.first_name = 'Carla'
+    #   contact_two.last_name = 'Smith'
+    #   contact_two.email = 'carla@smith.com'
+    #   GroupDocs::Signature::Contact.import!([contact_one, contact_two])
+    #
+    # @param [Array<GroupDocs::Signature::Contact>] contacts
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def self.import!(contacts, access = {})
+      contacts.is_a?(Array) or raise ArgumentError, "Contacts should be array, received: #{contacts.inspect}"
+      contacts.each do |contact|
+        contact.is_a?(GroupDocs::Signature::Contact) or raise ArgumentError, "Contact should be GroupDocs::Signature::Contact, received: #{contact.inspect}"
+      end
+
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :POST
+        request[:path] = '/signature/{{client_id}}/contacts'
+        request[:request_body] = contacts.map { |contact| contact.to_hash }
+      end.execute!
+    end
+
+    #
+    # Adds contact integration.
+    #
+    # @example Add Google contacts integration
+    #   integration = {
+    #     provider:                :google,
+    #     refresh_token:           'token',
+    #     access_token:            'token',
+    #     access_token_expiration: '2014-12-12'
+    #   }
+    #
+    # @param [Hash] integration
+    # @option integration [Symbol] provider One of :local, :groupdocs or :google
+    # @option integration [String] refresh_token
+    # @option integration [String] access_token
+    # @option integration [String] access_token_exipration
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def self.add_integration!(integration, access = {})
+      payload = {
+        :provider              => INTEGRATION_PROVIDERS[integration[:provider]],
+        :refreshToken          => integration[:refresh_token],
+        :accessToken           => integration[:access_token],
+        :accessTokenExpiration => integration[:access_token_expiration],
+      }
+
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :POST
+        request[:path] = '/signature/{{client_id}}/integration'
+        request[:request_body] = payload
+      end.execute!
+    end
+
+    # @attr [String] id
+    attr_accessor :id
+    # @attr [String] firstName
+    attr_accessor :firstName
+    # @attr [String] lastName
+    attr_accessor :lastName
+    # @attr [String] nickname
+    attr_accessor :nickname
+    # @attr [String] email
+    attr_accessor :email
+    # @attr [String] provider
+    attr_accessor :provider
+
+    # Human-readable accessors
+    alias_accessor :first_name, :firstName
+    alias_accessor :last_name,  :lastName
+
+    #
+    # Adds contact.
+    #
+    # @example
+    #   contact = GroupDocs::Signature::Contact.new
+    #   contact.first_name = 'John'
+    #   contact.last_name = 'Smith'
+    #   contact.email = 'john@smith.com'
+    #   contact.add!
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def add!(access = {})
+      json = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :POST
+        request[:path] = '/signature/{{client_id}}/contact'
+        request[:request_body] = to_hash
+      end.execute!
+
+      self.id = json[:contact][:id]
+    end
+
+    #
+    # Updates contact.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def update!(access = {})
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :POST
+        request[:path] = "/signature/{{client_id}}/contacts/#{id}"
+        request[:request_body] = to_hash
+      end.execute!
+    end
+
+    #
+    # Deletes contact.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def delete!(access = {})
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :DELETE
+        request[:path] = "/signature/{{client_id}}/contacts/#{id}"
+      end.execute!
+    end
+
+  end # Signature::Contact
+end # GroupDocs

data/lib/groupdocs/signature/envelope.rb

@@ -1,747 +1,747 @@
-module GroupDocs
-  class Signature::Envelope < Api::Entity
-
-    require 'groupdocs/signature/envelope/log'
-
-    STATUSES = {
-      :draft       => -1,
-      :annotation  =>  0,
-      :in_progress =>  1,
-      :expired     =>  2,
-      :canceled    =>  3,
-      :failed      =>  4,
-      :completed   =>  5,
-      :archived    =>  6,
-      :scheduled   => 99,
-    }
-
-    include Api::Helpers::SignaturePublic
-    include Signature::DocumentMethods
-    include Signature::EntityFields
-    include Signature::EntityMethods
-    include Signature::FieldMethods
-    include Signature::RecipientMethods
-    extend  Signature::ResourceMethods
-
-    #
-    # Changed in release 1.7.0
-    #
-    #
-    # Returns a list of all envelopes.
-    #
-    # @param [Hash] options Hash of options
-    # @option options [Integer] :page Page to start with
-    # @option options [Integer] :records How many items to list
-    # @option options [Integer] :status_id Filter envelopes by status identifier
-    # @option options [String] :document Filter envelopes by document GUID
-    # @option options [String] :recipient Filter envelopes by recipient email
-    # @option options [String] :date Filter envelopes by date
-    # @option options [String] :name Filter envelopes by name
-    # @option options [String] :tag Filter envelopes by tag
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [Array<GroupDocs::Signature::Envelope>]
-    #
-    def self.all!(options = {}, access = {})
-      status_id = options.delete(:status_id)
-      options[:statusId] = status_id if status_id
-
-      api = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :GET
-        request[:path] = '/signature/{{client_id}}/envelopes'
-      end
-      api.add_params(options)
-      json = api.execute!
-
-      json[:envelopes].map do |envelope|
-        new(envelope)
-      end
-    end
-
-    #
-    # Returns a list of all envelopes where user is recipient.
-    #
-    # @param [Hash] options Hash of options
-    # @option options [Integer] :page Page to start with
-    # @option options [Integer] :records How many items to list
-    # @option options [Integer] :statusId Filter by status identifier
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [Array<GroupDocs::Signature::Envelope>]
-    #
-    def self.for_me!(options = {}, access = {})
-      api = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :GET
-        request[:path] = '/signature/{{client_id}}/envelopes/recipient'
-      end
-      api.add_params(options)
-      json = api.execute!
-
-      json[:envelopes].map do |envelope|
-        new(envelope)
-      end
-    end
-
-    # @attr [String] creationDateTime
-    attr_accessor :creationDateTime
-    # @attr [Symbol] status
-    attr_accessor :status
-    # @attr [String] statusDateTime
-    attr_accessor :statusDateTime
-    # @attr [Integer] envelopeExpireTime
-    attr_accessor :envelopeExpireTime
-    # @attr [Boolean] isDemo
-    attr_accessor :isDemo
-
-    # added in release 1.7.0
-    # @attr [String] updatedDateTime
-    attr_accessor :updatedDateTime
-    # @attr [Boolean] attachSignedDocument
-    attr_accessor :attachSignedDocument
-    # @attr [Boolean] includeViewLink
-    attr_accessor :includeViewLink
-    # @attr [Boolean] canBeCommented
-    attr_accessor :canBeCommented
-    # @attr [Boolean] inPersonSign
-    attr_accessor :inPersonSign
-    # @attr [String] ownerName
-    attr_accessor :ownerName
-    # @attr [Boolean] enableTypedSignature
-    attr_accessor :enableTypedSignature
-    # @attr [Boolean] enableUploadedSignature
-    attr_accessor :enableUploadedSignature
-    # @attr [Boolean] requireUserAuthForSign
-    attr_accessor :requireUserAuthForSign
-    # @attr [Boolean] requestUserAuthByPhoto
-    attr_accessor :requestUserAuthByPhoto
-    # @attr [Boolean] showRecipientCommentInSignedDocument
-    attr_accessor :showRecipientCommentInSignedDocument
-    # @attr [String] tags
-    attr_accessor :tags
-
-    # added in release 1.9.0
-    # @attr [Boolean] lockDuringSign
-    attr_accessor :lockDuringSign
-
-    # Human-readable accessors
-    alias_accessor :creation_date_time,   :creationDateTime
-    alias_accessor :status_date_time,     :statusDateTime
-    alias_accessor :envelope_expire_time, :envelopeExpireTime
-    alias_accessor :is_demo,              :isDemo
-
-    #
-    # Converts status to human-readable format.
-    # @return [Symbol]
-    #
-    def status
-      STATUSES.invert[@status]
-    end
-
-    #
-    # Changed in release 1.5.8
-    #
-    # Adds recipient to envelope.
-    #
-    # @example
-    #   roles = GroupDocs::Signature::Role.get!
-    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
-    #   recipient = GroupDocs::Signature::Recipient.new
-    #   recipient.email = 'john@smith.com'
-    #   recipient.first_name = 'John'
-    #   recipient.last_name = 'Smith'
-    #   recipient.role_id = roles.detect { |role| role.name == "Signer" }.id
-    #   envelope.add_recipient! recipient
-    #
-    # @param [GroupDocs::Signature::Recipient] recipient
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
-    #
-    def add_recipient!(recipient, access = {})
-      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-        "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
-
-      api = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :POST
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/recipient"
-      end
-      api.add_params(:email     => recipient.email,
-                     :firstname => recipient.first_name,
-                     :lastname  => recipient.last_name,
-                     :role      => recipient.role_id,
-                     :order     => recipient.order)
-      json = api.execute!
-      Signature::Recipient.new(json[:recipient])
-
-    end
-
-    #
-    # Modify recipient of envelope.
-    #
-    # @example
-    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
-    #   recipient = envelope.recipients!.first
-    #   recipient.first_name = 'Johnny'
-    #   envelope.modify_recipient! recipient
-    #
-    # @param [GroupDocs::Signature::Recipient] recipient
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
-    #
-    def modify_recipient!(recipient, access = {})
-      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-        "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
-
-      api = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/recipient/#{recipient.id}"
-      end
-      api.add_params(:email     => recipient.email,
-                     :firstname => recipient.first_name,
-                     :lastname  => recipient.last_name,
-                     :role      => recipient.role_id,
-                     :order     => recipient.order)
-      api.execute!
-    end
-
-    #
-    # Delegates recipient to another one.
-    #
-    # @example
-    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
-    #   old = envelope.recipients!.first
-    #   old.first_name = 'Johnny'
-    #   new = GroupDocs::Signature::Recipient.new
-    #   new.email = 'john@smith.com'
-    #   new.first_name = 'John'
-    #   new.last_name = 'Smith'
-    #   envelope.delegate_recipient! old, new
-    #
-    # @param [GroupDocs::Signature::Recipient] old
-    # @param [GroupDocs::Signature::Recipient] new
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @raise [ArgumentError] if old recipient is not GroupDocs::Signature::Recipient
-    # @raise [ArgumentError] if new recipient is not GroupDocs::Signature::Recipient
-    #
-    def delegate_recipient!(old, new, access = {})
-      old.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-        "Old recipient should be GroupDocs::Signature::Recipient object, received: #{old.inspect}"
-      new.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-        "New recipient should be GroupDocs::Signature::Recipient object, received: #{new.inspect}"
-
-      api = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :POST
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/recipient/#{old.id}/delegate"
-      end
-      api.add_params(:email     => new.email,
-                     :firstname => new.first_name,
-                     :lastname  => new.last_name)
-      api.execute!
-    end
-
-    #
-    # Fills field with value.
-    #
-    # Value differs depending on field type. See examples below.
-    #
-    # @example Fill single line field
-    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
-    #   document = envelope.documents!.first
-    #   recipient = envelope.recipients!.first
-    #   field = envelope.fields!(document, recipient).first
-    #   envelope.fill_field! "my_data", field, document, recipient
-    #
-    # @example Fill signature field
-    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
-    #   document = envelope.documents!.first
-    #   recipient = envelope.recipients!.first
-    #   field = envelope.fields!(document, recipient).first
-    #   signature = GroupDocs::Signature.get!.first
-    #   envelope.fill_field! signature, field, document, recipient
-    #
-    # @example Fill checkbox field
-    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
-    #   document = envelope.documents!.first
-    #   recipient = envelope.recipients!.first
-    #   field = envelope.fields!(document, recipient).first
-    #   envelope.fill_field! false, field, document, recipient
-    #
-    # @param [String, Boolean, GroupDocs::Signature] value
-    # @param [GroupDocs::Signature::Field] field
-    # @param [GroupDocs::Document] document
-    # @param [GroupDocs::Signature::Recipient] recipient
-    # @param [Hash] options
-    # @option options [Boolean] :public Defaults to false
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [GroupDocs::Signature::Field] filled field
-    # @raise [ArgumentError] if field is not GroupDocs::Signature::Field
-    # @raise [ArgumentError] if document is not GroupDocs::Document
-    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
-    #
-    def fill_field!(value, field, document, recipient, options = {}, access = {})
-      field.is_a?(GroupDocs::Signature::Field) or raise ArgumentError,
-        "Field should be GroupDocs::Signature::Field object, received: #{field.inspect}"
-      document.is_a?(GroupDocs::Document) or raise ArgumentError,
-        "Document should be GroupDocs::Document object, received: #{document.inspect}"
-      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-        "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
-
-      client_id = client_id(options[:public])
-      api = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/#{client_id}/envelopes/#{id}/documents/#{document.file.guid}/recipient/#{recipient.id}/field/#{field.id}"
-      end
-
-      type = field.field_type
-      if type == :signature && value.is_a?(GroupDocs::Signature)
-        api.add_params(:signatureId => value.id)
-      else
-        if type == :checkbox
-          value = (value ? 'on' : 'off')
-        end
-        api.options[:request_body] = value
-        api.options[:plain] = true
-      end
-
-      json = api.execute!
-      Signature::Field.new(json[:field])
-    end
-
-    #
-    # Changed in release 1.7.0
-    #
-    # Signs envelope.
-    #
-    # @param [GroupDocs::Signature::Recipient] recipient
-    # @param [Hash] settings
-    # @option settings [String] :authData (required)
-    # @option settings [String] :comment (required)
-    # @param [Hash] options
-    # @option options [Boolean] :public Defaults to false
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
-    #
-    def sign!(recipient, settings = {}, options = {}, access = {})
-      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-        "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
-
-      client_id = client_id(options[:public])
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/#{client_id}/envelopes/#{id}/recipient/#{recipient.id}/sign"
-        request[:request_body] = settings
-      end.execute!
-    end
-
-    #
-    # Declines envelope.
-    #
-    # @param [GroupDocs::Signature::Recipient] recipient
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
-    #
-    def decline!(recipient, access = {})
-      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-        "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
-
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/recipient/#{recipient.id}/decline"
-      end.execute!
-    end
-
-    #
-    # Downloads signed documents to given path.
-    # If there is only one file in envelope, it's saved as PDF.
-    # If there are two or more files in envelope, it's saved as ZIP.
-    #
-    # @param [String] path Directory to download file to
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [String] path to file
-    #
-    def signed_documents!(path, access = {})
-      response = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :DOWNLOAD
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/documents/get"
-      end.execute!
-
-      filepath = "#{path}/#{name}."
-      if documents!.size == 1
-        filepath << 'pdf'
-      else
-        filepath << 'zip'
-      end
-
-      Object::File.open(filepath, 'wb') do |file|
-        file.write(response)
-      end
-
-      filepath
-    end
-
-    #
-    # Changed in release 1.5.8
-	#
-	# Downloads signed document to given path.
-    #
-    # @param [GroupDocs::Document] document Signed document
-    # @param [String] path Directory to download file to
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [String] path to file
-    #
-    def signed_document!(document, path, access = {})
-      document.is_a?(GroupDocs::Document) or raise ArgumentError,
-        "Document should be GroupDocs::Document object, received: #{document.inspect}"
-
-      response = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :DOWNLOAD
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/document/#{document.file.guid}"
-      end.execute!
-
-      document.file.name ? filepath = "#{path}/#{document.file.name}" : filepath = "#{path}/#{name}.pdf"
-
-      Object::File.open(filepath, 'wb') do |file|
-        file.write(response)
-      end
-
-      filepath
-    end
-
-    #
-    # Returns a list of audit logs.
-    #
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [Array<GroupDocs::Signature::Envelope::Log>]
-    #
-    def logs!(access = {})
-      json = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :GET
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/logs"
-      end.execute!
-
-      json[:logs].map do |log|
-        Log.new(log)
-      end
-    end
-
-    #
-    # Sends envelope.
-    #
-    # @param [Hash] webhook URL to be hooked after envelope is completed
-    # @option webhook [String] :callbackUrl
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def send!(webhook = {}, access = {})
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/send"
-        request[:request_body] = webhook
-      end.execute!
-    end
-
-    #
-    # Archives completed envelope.
-    #
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def archive!(access = {})
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/archive"
-      end.execute!
-    end
-
-    #
-    # Restarts expired envelope.
-    #
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def restart!(access = {})
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/restart"
-      end.execute!
-    end
-
-    #
-    #  Get signed envelope document.
-    #
-    # @example
-    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
-    #   document = GroupDocs::Storage::Folder.list!.last.to_document
-    #   envelope.add_document! document
-    #
-    # @param [GroupDocs::Document] document
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @raise [ArgumentError] if document is not GroupDocs::Document
-    #
-    def get_envelope!(path, document, access = {})
-      document.is_a?(GroupDocs::Document) or raise ArgumentError,
-                                                   "Document should be GroupDocs::Document object, received: #{document.inspect}"
-
-      response = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :GET
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/document/#{document.file.guid}"
-      end.execute!
-
-      filepath = "#{path}/#{name}."
-
-      if documents!.size == 1
-        filepath << 'pdf'
-      else
-        filepath << 'zip'
-      end
-
-      Object::File.open(filepath, 'wb') do |file|
-        file.write(response)
-      end
-
-      filepath
-    end
-
-    #
-    # Cancel envelope.
-    #
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def cancel!( access = {})
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/cancel"
-      end.execute!
-    end
-
-    #
-    # Retry sign envelope.
-    #
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def retry!(access = {})
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/retry"
-      end.execute!
-    end
-	
-	#
-    # Update envelope.
-    #
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [Array]
-    #
-    def update_envelope!(template, access = {})
-      json = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :POST
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/templates/#{template}"
-      end.execute!
-
-      json[:envelope]
-
-    end
-
-    #
-    # Modify signature envelope field location.
-    #
-    # @example Modify field location in envelope
-    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
-    #   document = envelope.documents!.first
-    #   recipient = envelope.recipients!.first
-    #   field = envelope.fields!(document, recipient).first
-    #   location = field.locations.first
-    #   envelope.modify_field_location! location, field, document, recipient
-    #
-    # @param [GroupDocs::Signature::Field::Location] location
-    # @param [GroupDocs::Signature::Field] field
-    # @param [GroupDocs::Document] document
-    # @param [GroupDocs::Signature::Recipient] recipient
-    # @param [Integer] order  Location order
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @raise [ArgumentError] if location is not GroupDocs::Signature::Field::Location
-    # @raise [ArgumentError] if field is not GroupDocs::Signature::Field
-    # @raise [ArgumentError] if document is not GroupDocs::Document
-    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
-    #
-    def modify_field_location!(location, field, document, recipient, order, access = {})
-      location.is_a?(GroupDocs::Signature::Field::Location) or raise ArgumentError,
-                                                                     "Location should be GroupDocs::Signature::Field::Location object, received: #{location.inspect}"
-      field.is_a?(GroupDocs::Signature::Field) or raise ArgumentError,
-                                                        "Field should be GroupDocs::Signature::Field object, received: #{field.inspect}"
-      document.is_a?(GroupDocs::Document) or raise ArgumentError,
-                                                   "Document should be GroupDocs::Document object, received: #{document.inspect}"
-      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-                                                                "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
-
-     api = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/documents/#{document.file.guid}/recipient/#{recipient.id}/fields/#{field.id}/locations/#{location.id}"
-      end
-      api.add_params(:order => order)
-      api.execute!
-    end
-
-    #
-    # Changed in release 1.5.8
-    #
-    # Get signature envelope.
-    #
-    # @param [GroupDocs::Signature::Recipient] recipient Recipient GUID
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [Array]
-    #
-    def public_get!(recipient, access = {})
-      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-                                                                "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
-
-      json = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :GET
-        request[:path] = "/signature/public/envelopes/#{id}/recipient/#{recipient.id}"
-      end.execute!
-
-      Signature::Envelope.new(json[:envelope])
-    end
-
-    #
-    # Changed in release 1.5.8
-    #
-    # Public downloads signed documents to given path.
-    #
-    # If there is only one file in envelope, it's saved as PDF.
-    # If there are two or more files in envelope, it's saved as ZIP.
-    #
-    # @param [String] path Directory to download file to
-    # @param [GroupDocs::Signature::Recipient] recipient Recipient GUID
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [Array]
-    #
-    def public_signed_documents!(path, recipient, access = {})
-      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-                                                                "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
-      json = Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :DOWNLOAD
-        request[:path] = "/signature/public/envelopes/#{id}/recipient/#{recipient.id}/documents/get"
-      end.execute!
-      filepath = "#{path}/#{name}."
-      if documents!.size == 1
-        filepath << 'pdf'
-      else
-        filepath << 'zip'
-      end
-
-      Object::File.open(filepath, 'wb') do |file|
-        file.write(json)
-      end
-
-      filepath
-    end
-
-
-    #
-    # Changed in release 1.5.8
-    #
-    #
-    # Get signed envelope field data.
-    #
-    # @param [GroupDocs::Signature::Recipient] recipient Recipient GUID
-    # @param [GroupDocs::Signature::Field] field Field GUID
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    # @return [Array]
-    #
-    def date!(recipient, field, access = {})
-      field.is_a?(GroupDocs::Signature::Field) or raise ArgumentError,
-                                                        "Field should be GroupDocs::Signature::Field object, received: #{field.inspect}"
-      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
-                                                                "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
-
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :GET
-        request[:path] = "/signature/public/envelopes/#{id}/fields/recipient/#{recipient.id}/field/#{field.id}"
-      end.execute!
-    end
-
-
-    #
-    #  added in release 1.6.0
-    #
-    #
-    # Resend envelope email notification.
-    #
-    # @param [Hash] access Access credentials
-    # @option access [String] :client_id
-    # @option access [String] :private_key
-    #
-    def resend!(access = {})
-      Api::Request.new do |request|
-        request[:access] = access
-        request[:method] = :PUT
-        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/resend-notification"
-      end.execute!
-    end
-
-
-
-
-  end # Signature::Envelope
-end # GroupDocs
+module GroupDocs
+  class Signature::Envelope < Api::Entity
+
+    require 'groupdocs/signature/envelope/log'
+
+    STATUSES = {
+      :draft       => -1,
+      :annotation  =>  0,
+      :in_progress =>  1,
+      :expired     =>  2,
+      :canceled    =>  3,
+      :failed      =>  4,
+      :completed   =>  5,
+      :archived    =>  6,
+      :scheduled   => 99,
+    }
+
+    include Api::Helpers::SignaturePublic
+    include Signature::DocumentMethods
+    include Signature::EntityFields
+    include Signature::EntityMethods
+    include Signature::FieldMethods
+    include Signature::RecipientMethods
+    extend  Signature::ResourceMethods
+
+    #
+    # Changed in release 1.7.0
+    #
+    #
+    # Returns a list of all envelopes.
+    #
+    # @param [Hash] options Hash of options
+    # @option options [Integer] :page Page to start with
+    # @option options [Integer] :records How many items to list
+    # @option options [Integer] :status_id Filter envelopes by status identifier
+    # @option options [String] :document Filter envelopes by document GUID
+    # @option options [String] :recipient Filter envelopes by recipient email
+    # @option options [String] :date Filter envelopes by date
+    # @option options [String] :name Filter envelopes by name
+    # @option options [String] :tag Filter envelopes by tag
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array<GroupDocs::Signature::Envelope>]
+    #
+    def self.all!(options = {}, access = {})
+      status_id = options.delete(:status_id)
+      options[:statusId] = status_id if status_id
+
+      api = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = '/signature/{{client_id}}/envelopes'
+      end
+      api.add_params(options)
+      json = api.execute!
+
+      json[:envelopes].map do |envelope|
+        new(envelope)
+      end
+    end
+
+    #
+    # Returns a list of all envelopes where user is recipient.
+    #
+    # @param [Hash] options Hash of options
+    # @option options [Integer] :page Page to start with
+    # @option options [Integer] :records How many items to list
+    # @option options [Integer] :statusId Filter by status identifier
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array<GroupDocs::Signature::Envelope>]
+    #
+    def self.for_me!(options = {}, access = {})
+      api = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = '/signature/{{client_id}}/envelopes/recipient'
+      end
+      api.add_params(options)
+      json = api.execute!
+
+      json[:envelopes].map do |envelope|
+        new(envelope)
+      end
+    end
+
+    # @attr [String] creationDateTime
+    attr_accessor :creationDateTime
+    # @attr [Symbol] status
+    attr_accessor :status
+    # @attr [String] statusDateTime
+    attr_accessor :statusDateTime
+    # @attr [Integer] envelopeExpireTime
+    attr_accessor :envelopeExpireTime
+    # @attr [Boolean] isDemo
+    attr_accessor :isDemo
+
+    # added in release 1.7.0
+    # @attr [String] updatedDateTime
+    attr_accessor :updatedDateTime
+    # @attr [Boolean] attachSignedDocument
+    attr_accessor :attachSignedDocument
+    # @attr [Boolean] includeViewLink
+    attr_accessor :includeViewLink
+    # @attr [Boolean] canBeCommented
+    attr_accessor :canBeCommented
+    # @attr [Boolean] inPersonSign
+    attr_accessor :inPersonSign
+    # @attr [String] ownerName
+    attr_accessor :ownerName
+    # @attr [Boolean] enableTypedSignature
+    attr_accessor :enableTypedSignature
+    # @attr [Boolean] enableUploadedSignature
+    attr_accessor :enableUploadedSignature
+    # @attr [Boolean] requireUserAuthForSign
+    attr_accessor :requireUserAuthForSign
+    # @attr [Boolean] requestUserAuthByPhoto
+    attr_accessor :requestUserAuthByPhoto
+    # @attr [Boolean] showRecipientCommentInSignedDocument
+    attr_accessor :showRecipientCommentInSignedDocument
+    # @attr [String] tags
+    attr_accessor :tags
+
+    # added in release 1.9.0
+    # @attr [Boolean] lockDuringSign
+    attr_accessor :lockDuringSign
+
+    # Human-readable accessors
+    alias_accessor :creation_date_time,   :creationDateTime
+    alias_accessor :status_date_time,     :statusDateTime
+    alias_accessor :envelope_expire_time, :envelopeExpireTime
+    alias_accessor :is_demo,              :isDemo
+
+    #
+    # Converts status to human-readable format.
+    # @return [Symbol]
+    #
+    def status
+      STATUSES.invert[@status]
+    end
+
+    #
+    # Changed in release 1.5.8
+    #
+    # Adds recipient to envelope.
+    #
+    # @example
+    #   roles = GroupDocs::Signature::Role.get!
+    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
+    #   recipient = GroupDocs::Signature::Recipient.new
+    #   recipient.email = 'john@smith.com'
+    #   recipient.first_name = 'John'
+    #   recipient.last_name = 'Smith'
+    #   recipient.role_id = roles.detect { |role| role.name == "Signer" }.id
+    #   envelope.add_recipient! recipient
+    #
+    # @param [GroupDocs::Signature::Recipient] recipient
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
+    #
+    def add_recipient!(recipient, access = {})
+      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+        "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
+
+      api = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :POST
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/recipient"
+      end
+      api.add_params(:email     => recipient.email,
+                     :firstname => recipient.first_name,
+                     :lastname  => recipient.last_name,
+                     :role      => recipient.role_id,
+                     :order     => recipient.order)
+      json = api.execute!
+      Signature::Recipient.new(json[:recipient])
+
+    end
+
+    #
+    # Modify recipient of envelope.
+    #
+    # @example
+    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
+    #   recipient = envelope.recipients!.first
+    #   recipient.first_name = 'Johnny'
+    #   envelope.modify_recipient! recipient
+    #
+    # @param [GroupDocs::Signature::Recipient] recipient
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
+    #
+    def modify_recipient!(recipient, access = {})
+      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+        "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
+
+      api = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/recipient/#{recipient.id}"
+      end
+      api.add_params(:email     => recipient.email,
+                     :firstname => recipient.first_name,
+                     :lastname  => recipient.last_name,
+                     :role      => recipient.role_id,
+                     :order     => recipient.order)
+      api.execute!
+    end
+
+    #
+    # Delegates recipient to another one.
+    #
+    # @example
+    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
+    #   old = envelope.recipients!.first
+    #   old.first_name = 'Johnny'
+    #   new = GroupDocs::Signature::Recipient.new
+    #   new.email = 'john@smith.com'
+    #   new.first_name = 'John'
+    #   new.last_name = 'Smith'
+    #   envelope.delegate_recipient! old, new
+    #
+    # @param [GroupDocs::Signature::Recipient] old
+    # @param [GroupDocs::Signature::Recipient] new
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @raise [ArgumentError] if old recipient is not GroupDocs::Signature::Recipient
+    # @raise [ArgumentError] if new recipient is not GroupDocs::Signature::Recipient
+    #
+    def delegate_recipient!(old, new, access = {})
+      old.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+        "Old recipient should be GroupDocs::Signature::Recipient object, received: #{old.inspect}"
+      new.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+        "New recipient should be GroupDocs::Signature::Recipient object, received: #{new.inspect}"
+
+      api = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :POST
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/recipient/#{old.id}/delegate"
+      end
+      api.add_params(:email     => new.email,
+                     :firstname => new.first_name,
+                     :lastname  => new.last_name)
+      api.execute!
+    end
+
+    #
+    # Fills field with value.
+    #
+    # Value differs depending on field type. See examples below.
+    #
+    # @example Fill single line field
+    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
+    #   document = envelope.documents!.first
+    #   recipient = envelope.recipients!.first
+    #   field = envelope.fields!(document, recipient).first
+    #   envelope.fill_field! "my_data", field, document, recipient
+    #
+    # @example Fill signature field
+    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
+    #   document = envelope.documents!.first
+    #   recipient = envelope.recipients!.first
+    #   field = envelope.fields!(document, recipient).first
+    #   signature = GroupDocs::Signature.get!.first
+    #   envelope.fill_field! signature, field, document, recipient
+    #
+    # @example Fill checkbox field
+    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
+    #   document = envelope.documents!.first
+    #   recipient = envelope.recipients!.first
+    #   field = envelope.fields!(document, recipient).first
+    #   envelope.fill_field! false, field, document, recipient
+    #
+    # @param [String, Boolean, GroupDocs::Signature] value
+    # @param [GroupDocs::Signature::Field] field
+    # @param [GroupDocs::Document] document
+    # @param [GroupDocs::Signature::Recipient] recipient
+    # @param [Hash] options
+    # @option options [Boolean] :public Defaults to false
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [GroupDocs::Signature::Field] filled field
+    # @raise [ArgumentError] if field is not GroupDocs::Signature::Field
+    # @raise [ArgumentError] if document is not GroupDocs::Document
+    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
+    #
+    def fill_field!(value, field, document, recipient, options = {}, access = {})
+      field.is_a?(GroupDocs::Signature::Field) or raise ArgumentError,
+        "Field should be GroupDocs::Signature::Field object, received: #{field.inspect}"
+      document.is_a?(GroupDocs::Document) or raise ArgumentError,
+        "Document should be GroupDocs::Document object, received: #{document.inspect}"
+      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+        "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
+
+      client_id = client_id(options[:public])
+      api = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/#{client_id}/envelopes/#{id}/documents/#{document.file.guid}/recipient/#{recipient.id}/field/#{field.id}"
+      end
+
+      type = field.field_type
+      if type == :signature && value.is_a?(GroupDocs::Signature)
+        api.add_params(:signatureId => value.id)
+      else
+        if type == :checkbox
+          value = (value ? 'on' : 'off')
+        end
+        api.options[:request_body] = value
+        api.options[:plain] = true
+      end
+
+      json = api.execute!
+      Signature::Field.new(json[:field])
+    end
+
+    #
+    # Changed in release 1.7.0
+    #
+    # Signs envelope.
+    #
+    # @param [GroupDocs::Signature::Recipient] recipient
+    # @param [Hash] settings
+    # @option settings [String] :authData (required)
+    # @option settings [String] :comment (required)
+    # @param [Hash] options
+    # @option options [Boolean] :public Defaults to false
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
+    #
+    def sign!(recipient, settings = {}, options = {}, access = {})
+      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+        "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
+
+      client_id = client_id(options[:public])
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/#{client_id}/envelopes/#{id}/recipient/#{recipient.id}/sign"
+        request[:request_body] = settings
+      end.execute!
+    end
+
+    #
+    # Declines envelope.
+    #
+    # @param [GroupDocs::Signature::Recipient] recipient
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
+    #
+    def decline!(recipient, access = {})
+      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+        "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
+
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/recipient/#{recipient.id}/decline"
+      end.execute!
+    end
+
+    #
+    # Downloads signed documents to given path.
+    # If there is only one file in envelope, it's saved as PDF.
+    # If there are two or more files in envelope, it's saved as ZIP.
+    #
+    # @param [String] path Directory to download file to
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [String] path to file
+    #
+    def signed_documents!(path, access = {})
+      response = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :DOWNLOAD
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/documents/get"
+      end.execute!
+
+      filepath = "#{path}/#{name}."
+      if documents!.size == 1
+        filepath << 'pdf'
+      else
+        filepath << 'zip'
+      end
+
+      Object::File.open(filepath, 'wb') do |file|
+        file.write(response)
+      end
+
+      filepath
+    end
+
+    #
+    # Changed in release 1.5.8
+	#
+	# Downloads signed document to given path.
+    #
+    # @param [GroupDocs::Document] document Signed document
+    # @param [String] path Directory to download file to
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [String] path to file
+    #
+    def signed_document!(document, path, access = {})
+      document.is_a?(GroupDocs::Document) or raise ArgumentError,
+        "Document should be GroupDocs::Document object, received: #{document.inspect}"
+
+      response = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :DOWNLOAD
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/document/#{document.file.guid}"
+      end.execute!
+
+      document.file.name ? filepath = "#{path}/#{document.file.name}" : filepath = "#{path}/#{name}.pdf"
+
+      Object::File.open(filepath, 'wb') do |file|
+        file.write(response)
+      end
+
+      filepath
+    end
+
+    #
+    # Returns a list of audit logs.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array<GroupDocs::Signature::Envelope::Log>]
+    #
+    def logs!(access = {})
+      json = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/logs"
+      end.execute!
+
+      json[:logs].map do |log|
+        Log.new(log)
+      end
+    end
+
+    #
+    # Sends envelope.
+    #
+    # @param [Hash] webhook URL to be hooked after envelope is completed
+    # @option webhook [String] :callbackUrl
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def send!(webhook = {}, access = {})
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/send"
+        request[:request_body] = webhook
+      end.execute!
+    end
+
+    #
+    # Archives completed envelope.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def archive!(access = {})
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/archive"
+      end.execute!
+    end
+
+    #
+    # Restarts expired envelope.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def restart!(access = {})
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/restart"
+      end.execute!
+    end
+
+    #
+    #  Get signed envelope document.
+    #
+    # @example
+    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
+    #   document = GroupDocs::Storage::Folder.list!.last.to_document
+    #   envelope.add_document! document
+    #
+    # @param [GroupDocs::Document] document
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @raise [ArgumentError] if document is not GroupDocs::Document
+    #
+    def get_envelope!(path, document, access = {})
+      document.is_a?(GroupDocs::Document) or raise ArgumentError,
+                                                   "Document should be GroupDocs::Document object, received: #{document.inspect}"
+
+      response = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/document/#{document.file.guid}"
+      end.execute!
+
+      filepath = "#{path}/#{name}."
+
+      if documents!.size == 1
+        filepath << 'pdf'
+      else
+        filepath << 'zip'
+      end
+
+      Object::File.open(filepath, 'wb') do |file|
+        file.write(response)
+      end
+
+      filepath
+    end
+
+    #
+    # Cancel envelope.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def cancel!( access = {})
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/cancel"
+      end.execute!
+    end
+
+    #
+    # Retry sign envelope.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def retry!(access = {})
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/retry"
+      end.execute!
+    end
+	
+	#
+    # Update envelope.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array]
+    #
+    def update_envelope!(template, access = {})
+      json = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :POST
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/templates/#{template}"
+      end.execute!
+
+      json[:envelope]
+
+    end
+
+    #
+    # Modify signature envelope field location.
+    #
+    # @example Modify field location in envelope
+    #   envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
+    #   document = envelope.documents!.first
+    #   recipient = envelope.recipients!.first
+    #   field = envelope.fields!(document, recipient).first
+    #   location = field.locations.first
+    #   envelope.modify_field_location! location, field, document, recipient
+    #
+    # @param [GroupDocs::Signature::Field::Location] location
+    # @param [GroupDocs::Signature::Field] field
+    # @param [GroupDocs::Document] document
+    # @param [GroupDocs::Signature::Recipient] recipient
+    # @param [Integer] order  Location order
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @raise [ArgumentError] if location is not GroupDocs::Signature::Field::Location
+    # @raise [ArgumentError] if field is not GroupDocs::Signature::Field
+    # @raise [ArgumentError] if document is not GroupDocs::Document
+    # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
+    #
+    def modify_field_location!(location, field, document, recipient, order, access = {})
+      location.is_a?(GroupDocs::Signature::Field::Location) or raise ArgumentError,
+                                                                     "Location should be GroupDocs::Signature::Field::Location object, received: #{location.inspect}"
+      field.is_a?(GroupDocs::Signature::Field) or raise ArgumentError,
+                                                        "Field should be GroupDocs::Signature::Field object, received: #{field.inspect}"
+      document.is_a?(GroupDocs::Document) or raise ArgumentError,
+                                                   "Document should be GroupDocs::Document object, received: #{document.inspect}"
+      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+                                                                "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
+
+     api = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/documents/#{document.file.guid}/recipient/#{recipient.id}/fields/#{field.id}/locations/#{location.id}"
+      end
+      api.add_params(:order => order)
+      api.execute!
+    end
+
+    #
+    # Changed in release 1.5.8
+    #
+    # Get signature envelope.
+    #
+    # @param [GroupDocs::Signature::Recipient] recipient Recipient GUID
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array]
+    #
+    def public_get!(recipient, access = {})
+      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+                                                                "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
+
+      json = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = "/signature/public/envelopes/#{id}/recipient/#{recipient.id}"
+      end.execute!
+
+      Signature::Envelope.new(json[:envelope])
+    end
+
+    #
+    # Changed in release 1.5.8
+    #
+    # Public downloads signed documents to given path.
+    #
+    # If there is only one file in envelope, it's saved as PDF.
+    # If there are two or more files in envelope, it's saved as ZIP.
+    #
+    # @param [String] path Directory to download file to
+    # @param [GroupDocs::Signature::Recipient] recipient Recipient GUID
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array]
+    #
+    def public_signed_documents!(path, recipient, access = {})
+      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+                                                                "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
+      json = Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :DOWNLOAD
+        request[:path] = "/signature/public/envelopes/#{id}/recipient/#{recipient.id}/documents/get"
+      end.execute!
+      filepath = "#{path}/#{name}."
+      if documents!.size == 1
+        filepath << 'pdf'
+      else
+        filepath << 'zip'
+      end
+
+      Object::File.open(filepath, 'wb') do |file|
+        file.write(json)
+      end
+
+      filepath
+    end
+
+
+    #
+    # Changed in release 1.5.8
+    #
+    #
+    # Get signed envelope field data.
+    #
+    # @param [GroupDocs::Signature::Recipient] recipient Recipient GUID
+    # @param [GroupDocs::Signature::Field] field Field GUID
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array]
+    #
+    def date!(recipient, field, access = {})
+      field.is_a?(GroupDocs::Signature::Field) or raise ArgumentError,
+                                                        "Field should be GroupDocs::Signature::Field object, received: #{field.inspect}"
+      recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
+                                                                "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"
+
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = "/signature/public/envelopes/#{id}/fields/recipient/#{recipient.id}/field/#{field.id}"
+      end.execute!
+    end
+
+
+    #
+    #  added in release 1.6.0
+    #
+    #
+    # Resend envelope email notification.
+    #
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    #
+    def resend!(access = {})
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/{{client_id}}/envelopes/#{id}/resend-notification"
+      end.execute!
+    end
+
+
+
+
+  end # Signature::Envelope
+end # GroupDocs