groupdocs 2.1.0 → 2.2.0

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+## v.2.2.0
+
+**Changes**
+*`Storage::File.upload_google!` changed the required parameters
+*`Storage.info!` added new parameters of response
+
+**New**
+*`Signature::Form#modify_form_field!` new method
+* Added new attribute `Signature::Field` - "page", "locationX", "locationY", "locationWidth", "locationHeight", "forceNewField"
+
+
 ## v.2.1.0
 
 **Changes**

data/lib/groupdocs/signature/field.rb

@@ -105,6 +105,21 @@ module GroupDocs
     # @attr [String] guidanceText
     attr_accessor :guidanceText
 
+    # added in realise 2.2.0
+    # @attr [Integer] page
+    attr_accessor :page
+    # @attr [Integer] locationX
+    attr_accessor :locationX
+    # @attr [Integer] locationY
+    attr_accessor :locationY
+    # @attr [Integer] locationWidth
+    attr_accessor :locationWidth
+    # @attr [Integer] locationHeight
+    attr_accessor :locationHeight
+    # @attr [Integer] forceNewField
+    attr_accessor :forceNewField
+
+
     # Human-readable accessors
     alias_accessor :template_id,        :templateId
     alias_accessor :recipient_id,       :recipientId

data/lib/groupdocs/signature/form.rb

@@ -337,7 +337,7 @@ module GroupDocs
     #
     # Modifies field location.
     #
-    # @example Modify field location in template
+    # @example Modify field location in form
     #   form = GroupDocs::Signature::Form.get!("g94h5g84hj9g4gf23i40j")
     #   document = form.documents!.first
     #   field = form.fields!(document).first
@@ -373,6 +373,43 @@ module GroupDocs
       end.execute!
     end
 
+    #
+    # Added in release 2.2.0
+    #
+    # Modifies field location.
+    #
+    # @example Modify field in form
+    #   form = GroupDocs::Signature::Form.get!("g94h5g84hj9g4gf23i40j")
+    #   document = form.documents!.first
+    #   field = form.get_fields!(document).first
+    #   field.name = "New name"
+    #   form.modify_field_location! location, field, document
+    #
+    # @param [GroupDocs::Signature::Field::Location] location
+    # @param [GroupDocs::Signature::Field] field
+    # @param [GroupDocs::Document] document
+    # @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
+    #
+    def modify_form_field!(field, document, 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}"
+
+      Api::Request.new do |request|
+        request[:access] = access
+        request[:method] = :PUT
+        request[:path] = "/signature/{{client_id}}/forms/#{id}/documents/#{document.file.guid}/field/#{field.id}"
+        request[:request_body] = field.to_hash
+      end.execute!
+    end
+
     #
     # Updates form adding fields from template.
     #
@@ -401,7 +438,7 @@ module GroupDocs
     #   document = form.documents!.first
     #   field = form.fields!(document).first
     #   field.name = "Field"
-    #   envelope.modify_field! field, document
+    #   form.modify_field! field, document
     #
     #
     # @param [GroupDocs::Document] document
@@ -429,8 +466,8 @@ module GroupDocs
     # Changed in release 1.5.8
     #
     # 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.
+    # If there is only one file in form, it's saved as PDF.
+    # If there are two or more files in form, it's saved as ZIP.
     #
     # @param [String] path Directory to download file to
     # @param [Hash] access Access credentials
@@ -485,7 +522,7 @@ module GroupDocs
     #   field = form.fields!(document).first
     #   fill_form = form.public_fill!
     #   participant = fill_form[:participant][:id]
-    #   envelope.fill_field! "my_data", field, document, participant
+    #   form.fill_field! "my_data", field, document, participant
     #
     # @example Fill signature field
     #   form = GroupDocs::Signature::Form.get!("g94h5g84hj9g4gf23i40j")

data/lib/groupdocs/storage.rb

@@ -8,7 +8,7 @@ module GroupDocs
   module Storage
 
     #
-    # Changed in release 1.5.8
+    # Changed in release 2.2.0
     #
     # Returns hash of information about user's storage.
     #
@@ -29,11 +29,14 @@ module GroupDocs
       end.execute!
 
       {
-        :total_space       => "#{json[:total_space] / 1048576} MB",
-        :available_space   => "#{json[:avail_space] / 1048576} MB",
-        :document_credits  => json[:doc_credits],
-        :available_credits => json[:avail_credits],
-        :maxViewingFileSize => json[:maxViewingFileSize]
+        :total_space         => "#{json[:total_space] / 1048576} MB",
+        :available_space     => "#{json[:avail_space] / 1048576} MB",
+        :document_credits    => json[:doc_credits],
+        :available_credits   => json[:avail_credits],
+        :maxViewingFileSize  => json[:maxViewingFileSize],
+        :total_documents     => json[:total_documents],
+        :available_documents => json[:avail_documents],
+        :used_documents      => json[:used_documents]
       }
     end
 

data/lib/groupdocs/storage/file.rb

@@ -97,23 +97,27 @@ module GroupDocs
         Storage::File.new(json)
       end
 
+      # Updated in release 2.2.0
       #
       # Uploads google page as file.
       #
-      # @param [String] path
+      # @param [Hash] options
+      # @option url [String]
+      # @option description [String]
+      # @option accessToken [String]
       # @param [Hash] access Access credentials
       # @option access [String] :client_id
       # @option access [String] :private_key
       # @return [GroupDocs::Storage::File]
       #
-      def self.upload_google!(path, file_id, access = {})
+      def self.upload_google!(options = {}, 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/"
         end
 
-        api.add_params(:file_id => file_id)
+        api.add_params(options)
         json = api.execute!
 
         Storage::File.new(json)

data/lib/groupdocs/version.rb

@@ -1,3 +1,3 @@
 module GroupDocs
-  VERSION = '2.1.0'
+  VERSION = '2.2.0'
 end # GroupDocs

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: groupdocs
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-26 00:00:00.000000000 Z
+date: 2015-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -639,7 +639,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.29
+rubygems_version: 1.8.30
 signing_key: 
 specification_version: 3
 summary: Ruby SDK for GroupDocs REST API