groupdocs 1.2.3 → 1.2.6

data/lib/groupdocs/signature/envelope.rb

@@ -327,15 +327,20 @@ module GroupDocs
     #
     # Sends envelope.
     #
+    # @param [String] webhook URL to be hooked after envelope is completed
     # @param [Hash] access Access credentials
     # @option access [String] :client_id
     # @option access [String] :private_key
     #
-    def send!(access = {})
+    def send!(webhook = nil, access = {})
       Api::Request.new do |request|
         request[:access] = access
         request[:method] = :PUT
         request[:path] = "/signature/{{client_id}}/envelopes/#{id}/send"
+        if webhook
+          request[:request_body] = webhook
+          request[:plain] = true
+        end
       end.execute!
     end
 

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

@@ -72,6 +72,8 @@ module GroupDocs
       # @param [GroupDocs::Signature::Field] field
       # @param [GroupDocs::Document] document
       # @param [GroupDocs::Signature::Recipient] recipient
+      # @param [Hash] options
+      # @option options [Boolean] :force_new_field Set to true to force new field create
       # @param [Hash] access Access credentials
       # @option access [String] :client_id
       # @option access [String] :private_key
@@ -80,7 +82,7 @@ module GroupDocs
       # @raise [ArgumentError] if recipient is not GroupDocs::Signature::Recipient
       # @raise [ArgumentError] if field does not specify location
       #
-      def add_field!(field, document, recipient, access = {})
+      def add_field!(field, document, recipient, opts = {}, 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,
@@ -90,9 +92,10 @@ module GroupDocs
         field.location or raise ArgumentError,
           "You have to specify field location, received: #{field.location.inspect}"
 
+        opts[:force_new_field] = true if opts[:force_new_field].nil?
         payload = field.to_hash # field itself
         payload.merge!(field.location.to_hash) # location should added in plain view (i.e. not "location": {...})
-        payload.merge!(forceNewField: true) # create new field flag
+        payload.merge!(forceNewField: opts[:force_new_field]) # create new field flag
 
         Api::Request.new do |request|
           request[:access] = access

data/lib/groupdocs/version.rb

@@ -1,3 +1,3 @@
 module GroupDocs
-  VERSION = '1.2.3'
+  VERSION = '1.2.6'
 end # GroupDocs

data/spec/groupdocs/signature/envelope_spec.rb

@@ -257,9 +257,13 @@ describe GroupDocs::Signature::Envelope do
 
     it 'accepts access credentials hash' do
       lambda do
-        subject.send!(client_id: 'client_id', private_key: 'private_key')
+        subject.send!(nil, client_id: 'client_id', private_key: 'private_key')
       end.should_not raise_error(ArgumentError)
     end
+
+    it 'accepts webhook callback URL and sends it as plain text' do
+      subject.send! 'http://mywebsite.com'
+    end
   end
 
   describe '#archive!' do

data/spec/support/shared_examples/signature/shared/field_methods.rb

@@ -42,7 +42,7 @@ shared_examples_for GroupDocs::Signature::FieldMethods do
 
     it 'accepts access credentials hash' do
       lambda do
-        subject.add_field!(field, document, recipient, client_id: 'client_id', private_key: 'private_key')
+        subject.add_field!(field, document, recipient, { force_new_field: false }, client_id: 'client_id', private_key: 'private_key')
       end.should_not raise_error(ArgumentError)
     end
 
@@ -63,7 +63,7 @@ shared_examples_for GroupDocs::Signature::FieldMethods do
       -> { subject.add_field!(field, document, recipient) }.should raise_error(ArgumentError)
     end
 
-    it 'uses field, field location and forcedNewField flag as payload' do
+    it 'uses field and field locationas payload' do
       hash_one = {}
       payload = {}
       location = {}
@@ -73,6 +73,17 @@ shared_examples_for GroupDocs::Signature::FieldMethods do
       payload.should_receive(:merge!).with(forceNewField: true).and_return({})
       subject.add_field!(field, document, recipient)
     end
+
+    it 'allows overriding force new field flag' do
+      hash_one = {}
+      payload = {}
+      location = {}
+      field.should_receive(:to_hash).and_return(payload)
+      field.location.should_receive(:to_hash).and_return(location)
+      payload.should_receive(:merge!).with(location).and_return(payload)
+      payload.should_receive(:merge!).with(forceNewField: false).and_return({})
+      subject.add_field!(field, document, recipient, force_new_field: false)
+    end
   end
 
   describe '#modify_field!' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: groupdocs
 version: !ruby/object:Gem::Version
-  version: 1.2.3
+  version: 1.2.6
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-17 00:00:00.000000000 Z
+date: 2013-02-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -422,7 +422,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 568401921435177902
+      hash: -3953683120914117386
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -431,7 +431,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 568401921435177902
+      hash: -3953683120914117386
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24