groupdocs 1.5.5 → 1.5.6

data/lib/groupdocs/signature.rb

@@ -51,7 +51,7 @@ module GroupDocs
       json = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :PUT
-        request[:path] = "/signature/public/envelopes/#{envelope}/documents/#{document}/recipient/#{recipient}/field/#{field}"
+        request[:path] = "/signature/public/envelopes/#{envelope.guid}/documents/#{document.guid}/recipient/#{recipient.guid}/field/#{field.guid}"
         request[:request_body] = post_data
       end.execute!
 
@@ -69,13 +69,11 @@ module GroupDocs
     # @return [Array]
     #
     def sign_envelope!(envelope, recipient, access = {})
-      json = Api::Request.new do |request|
+      Api::Request.new do |request|
         request[:access] = access
         request[:method] = :PUT
-        request[:path] = "/signature/public/envelopes/#{envelope}/recipient/#{recipient}/sign"
+        request[:path] = "/signature/public/envelopes/#{envelope.guid}/recipient/#{recipient.id}/sign"
       end.execute!
-
-      new(json)
     end
 
     #
@@ -91,7 +89,7 @@ module GroupDocs
       json = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
-        request[:path] = "/signature/public/envelopes/#{envelope}/recipient/"
+        request[:path] = "/signature/public/envelopes/#{envelope.guid}/recipient/"
       end.execute!
 
       json[:recipient]
@@ -102,8 +100,8 @@ module GroupDocs
     #
     # @param [String] envelope Envelope GUID
     # @param [Hash] options
-    # @option [String] document Document GUID
-    # @option [String] recipient Recipient GUID
+    # @option options [String] :document Document GUID
+    # @option options [String] :recipient Recipient GUID
     # @param [Hash] access Access credentials
     # @option access [String] :client_id
     # @option access [String] :private_key
@@ -113,7 +111,7 @@ module GroupDocs
       api = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
-        request[:path] = "/signature/public/envelopes/#{envelope}/fields"
+        request[:path] = "/signature/public/envelopes/#{envelope.guid}/fields"
       end
       api.add_params(options)
       json = api.execute!
@@ -136,7 +134,7 @@ module GroupDocs
       Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
-        request[:path] = "/signature/public/envelopes/#{envelope}/fields/recipient/#{recipient}/field/#{field}"
+        request[:path] = "/signature/public/envelopes/#{envelope.guid}/fields/recipient/#{recipient.id}/field/#{field.id}"
       end.execute!
 
     end
@@ -155,7 +153,7 @@ module GroupDocs
       json = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
-        request[:path] = "/signature/public/envelopes/#{envelope}/recipient/#{recipient}"
+        request[:path] = "/signature/public/envelopes/#{envelope.guid}/recipient/#{recipient.id}"
       end.execute!
 
       json[:envelope]
@@ -175,10 +173,8 @@ module GroupDocs
       json = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
-        request[:path] = "/signature/public/envelopes/#{envelope}/recipient/#{recipient}/documents/get"
+        request[:path] = "/signature/public/envelopes/#{envelope.guid}/recipient/#{recipient.id}/documents/get"
       end.execute!
-
-      new(json)
     end
 
     #
@@ -194,7 +190,7 @@ module GroupDocs
       json = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
-        request[:path] = "/signature/public/forms/#{form}/fill"
+        request[:path] = "/signature/public/forms/#{form.id}/fill"
       end.execute!
 
       json[:participant]
@@ -217,7 +213,7 @@ module GroupDocs
       api = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :PUT
-        request[:path] = "/signature/public/forms/#{form}/documents/#{document}/participant/#{participant}/field/#{field}"
+        request[:path] = "/signature/public/forms/#{form.id}/documents/#{document.guid}/participant/#{participant.id}/field/#{field.id}"
       end
       api.add_params(:participantAuthSignature => authentication)
       json = api.execute!
@@ -264,7 +260,7 @@ module GroupDocs
       api = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
-        request[:path] = "/signature/public/forms/#{form}/fields"
+        request[:path] = "/signature/public/forms/#{form.id}/fields"
       end
       api.add_params(options)
       json = api.execute!
@@ -282,14 +278,19 @@ module GroupDocs
     # @option access [String] :private_key
     # @return [Array]
     #
-    def get_signed_documents_form!(form, participant, access = {})
-      json = Api::Request.new do |request|
+    def get_signed_documents_form!(path, name, form, participant, access = {})
+      response = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
-        request[:path] = "/signature/public/forms/#{form}/participant/#{participant}/documents/get"
+        request[:path] = "/signature/public/forms/#{form.id}/participant/#{participant.id}/documents/get"
       end.execute!
 
-      new(json)
+      filepath = "#{path}/#{name}."
+      Object::File.open(filepath, 'wb') do |file|
+        file.write(response)
+      end
+
+      filepath
     end
 
     #
@@ -326,32 +327,48 @@ module GroupDocs
       json = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :POST
-        request[:path] = "/signature/public/documents/#{document}/sign"
+        request[:path] = "/signature/public/documents/#{document.guid}/sign"
         request[:request_body] = settings
       end.execute!
 
       json[:jobId]
     end
+	
+	 #
+    #  Get document fields
+    #
+    # @param [String] document Document GUID
+    # @param [Hash] settings Settings of the signing document
+    # @param [Hash] access Access credentials
+    # @option access [String] :client_id
+    # @option access [String] :private_key
+    # @return [Array]
+    #
+    def self.get_document_fields!(document, access = {})
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :GET
+        request[:path] = "/signature/public/documents/#{document}/fields"
+      end.execute!
+    end
 
     #
     #  Verify to document
     #
-    # @param [String] document Document GUID
+    # @param [String] path Path to document GUID
     # @param [Hash] settings Settings of the signing document
     # @param [Hash] access Access credentials
     # @option access [String] :client_id
     # @option access [String] :private_key
     # @return [Array]
     #
-    def self.verify!(access = {})
-      json = Api::Request.new do |request|
+    def self.verify!(path, access = {})
+      Api::Request.new do |request|
         request[:access] = access
         request[:method] = :POST
         request[:path] = "/signature/public/verify"
-        request[:request_body] = streem
+        request[:request_body] = path
       end.execute!
-
-      nev(json)
     end
 
     #
@@ -363,14 +380,14 @@ module GroupDocs
     # @option access [String] :private_key
     # @return [Array]
     #
-    def sign_document_status!(job, access = {})
+    def self.sign_document_status!(job, access = {})
       json = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
         request[:path] = "/signature/public/documents/#{job}/status"
       end.execute!
 
-       new(json)
+      Storage::File.new(:guid => json[:documents][0][:documentId])
     end
 
 

data/lib/groupdocs/signature/envelope.rb

@@ -424,10 +424,7 @@ module GroupDocs
         request[:access] = access
         request[:method] = :PUT
         request[:path] = "/signature/{{client_id}}/envelopes/#{id}/send"
-        if webhook
-          request[:request_body] = webhook
-          request[:plain] = true
-        end
+        request[:request_body] = webhook
       end.execute!
     end
 
@@ -475,16 +472,28 @@ module GroupDocs
     # @option access [String] :private_key
     # @raise [ArgumentError] if document is not GroupDocs::Document
     #
-    def get_envelope!(document, access = {})
+    def get_envelope!(path, document, access = {})
       document.is_a?(GroupDocs::Document) or raise ArgumentError,
                                                    "Document should be GroupDocs::Document object, received: #{document.inspect}"
 
-      Api::Request.new do |request|
+      response = Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
-        request[:path] = "/signature/{{client_id}}/#{class_name.pluralize}/#{id}/document/#{document.file.guid}"
+        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
 
     #
@@ -515,6 +524,25 @@ module GroupDocs
         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
 
   end # Signature::Envelope

data/lib/groupdocs/signature/field.rb

@@ -91,6 +91,7 @@ module GroupDocs
     # @attr [Array<GroupDocs::Signature::Field::Location>] locations
     attr_accessor :locations
 
+
     # Human-readable accessors
     alias_accessor :template_id,        :templateId
     alias_accessor :recipient_id,       :recipientId

data/lib/groupdocs/signature/field/location.rb

@@ -29,6 +29,10 @@ module GroupDocs
     attr_accessor :fontItalic
     # @attr [Boolean] fontUnderline
     attr_accessor :fontUnderline
+    # @attr [Boolean] forceNewField
+    attr_accessor :forceNewField
+    # @attr [String] page
+    attr_accessor :page
 
     # Human-readable accessors
     alias_accessor :document_id,     :documentId
@@ -49,6 +53,8 @@ module GroupDocs
     alias_accessor :font_bold,       :fontBold
     alias_accessor :font_italic,     :fontItalic
     alias_accessor :font_underline,  :fontUnderline
+    alias_accessor :forceNewField,   :forceNewField
+    alias_accessor :page,            :page
 
   end # Signature::Field::Location
 end # GroupDocs

data/lib/groupdocs/signature/form.rb

@@ -411,10 +411,42 @@ module GroupDocs
       Api::Request.new do |request|
         request[:access] = access
         request[:method] = :PUT
-        request[:path] = "/signature/{{client_id}}/forms/#{form}/document/#{document.file.guid}/"
+        request[:path] = "/signature/{{client_id}}/forms/#{id}/document/#{document.file.guid}/"
         request[:request_body] = options
       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}}/forms/#{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
+
   end # Signature::Form
 end # GroupDocs

data/lib/groupdocs/signature/shared/document_methods.rb

@@ -48,6 +48,7 @@ module GroupDocs
           file = Storage::File.new(:guid => id, :name => document[:name])
           Document.new(document.merge(:file => file))
         end
+
       end
 
       #

data/lib/groupdocs/storage/file.rb

@@ -57,21 +57,24 @@ module GroupDocs
       #
       # Get shared file.
       #
+      # @param [String] path  Path save new file which receive in response
+      # @param [String] name  Name new file
       # @param [String] file_path
       # @param [String] user_email
       #
-      def get_shared_file!(user_email, file_path)
+      def self.get_shared_file!(path, name, user_email, file_path)
         response = Api::Request.new do |request|
           request[:access] = access
           request[:method] = :GET
           request[:path] = "/storage/shared/#{user_email}/#{file_path}"
         end.execute!
 
-        Object::File.open(file_path, 'wb') do |file|
+        filepath = "#{path}/#{name}"
+        Object::File.open(filepath, 'wb') do |file|
           file.write(response)
         end
 
-        file_path
+        filepath
       end
 
       #
@@ -104,11 +107,11 @@ module GroupDocs
       # @option access [String] :private_key
       # @return [GroupDocs::Storage::File]
       #
-      def upload_google!(path, file_id, access = {})
+      def self.upload_google!(path, file_id, access = {})
         api = Api::Request.new do |request|
           request[:access] = access
           request[:method] = :POST
-          request[:path] = "/storage/{{client_id}}/google/files/#{path}/"
+          request[:path] = "/storage/{{client_id}}/google/files/#{path}"
         end
 
         api.add_params(:file_id => file_id)
@@ -129,17 +132,23 @@ module GroupDocs
       # @option access [String] :private_key
       # @return [GroupDocs::Storage::File]
       #
-      def decompress!(path, file_zip, options = {}, access = {})
+      def self.decompress!(filepath, options = {}, access = {})
+        options[:path] ||= ''
+        options[:name] ||= Object::File.basename(filepath)
+        path = prepare_path("#{options[:path]}/#{options[:name]}")
+
         api = Api::Request.new do |request|
           request[:access] = access
           request[:method] = :POST
           request[:path] = "/storage/{{client_id}}/decompress/#{path}/"
-          request[:request_body] = file_zip
+          request[:request_body] = Object::File.new(filepath, 'rb')
         end
-        api.add_params(options)
+        api.add_params(:archiveType => options[:archiveType]) if options[:archiveType]
         json = api.execute!
 
-        Storage::File.new(json)
+        json[:files].map do |file|
+          File.new(file)
+        end
       end
 
       # @attr [Integer] id
@@ -384,7 +393,7 @@ module GroupDocs
         Api::Request.new do |request|
           request[:access] = access
           request[:method] = :DELETE
-          request[:path] = "/storage/{{client_id}}/trash/#{path}/"
+          request[:path] = "/storage/{{client_id}}/trash/#{path}"
         end.execute!
       end
 

data/lib/groupdocs/subscription.rb

@@ -77,7 +77,6 @@ module GroupDocs
         request[:method] = :GET
         request[:path] = '/system/{{client_id}}/subscription'
       end.execute!
-
     end
 
     #
@@ -90,14 +89,12 @@ module GroupDocs
     # @return [GroupDocs::Subscription]
     #
     def self.set_subscription!(plan, product_id, access = {})
-      json = Api::Request.new do |request|
+      Api::Request.new do |request|
         request[:access] = access
         request[:method] = :PUT
         request[:path] = "/system/{{client_id}}/subscriptions/#{product_id}"
         request[:request_body] = plan
       end.execute!
-
-      new(json)
     end
 
     #
@@ -110,14 +107,12 @@ module GroupDocs
     # @return [GroupDocs::Subscription]
     #
     def self.update_subscription!(plan, product_id, access = {})
-      json = Api::Request.new do |request|
+      Api::Request.new do |request|
         request[:access] = access
         request[:method] = :POST
         request[:path] = "/system/{{client_id}}/subscriptions/#{product_id}"
         request[:request_body] = plan
       end.execute!
-
-      new(json)
     end
 
     #
@@ -208,13 +203,11 @@ module GroupDocs
     # @option access [String] :private_key
     #
     def self.get_plans!(access = {})
-      json = Api::Request.new do |request|
+      Api::Request.new do |request|
         request[:access] = access
         request[:method] = :GET
         request[:path] = "/system/{{client_id}}/usage"
       end
-
-      new(json)
     end
 
     #