docusign_rest 0.0.8 → 0.0.9

data/README.md

@@ -92,6 +92,8 @@ puts client.get_account_id
 
 **Creating an envelope from a document:**
 
+Note: In the example below there are two sign here tabs for the user with a role of 'Attorney'. There are also two documents attached to the envelope, however, this exact configuration would only allow for signature on the first document. If you need signature for a second document, you'll need to add further options, namely: `document_id: 2` in one of the sign_here_tabs so that DocuSign knows where to embed that signature tab.
+
 ```ruby
 client = DocusignRest::Client.new
 document_envelope_response = client.create_envelope_from_document(
@@ -104,14 +106,35 @@ document_envelope_response = client.create_envelope_from_document(
   # iFrame by using the client.get_recipient_view method
   signers: [
     {
-      #embedded: true,
+      embedded: true,
       name: 'Test Guy',
-      email: 'someone@gmail.com'
+      email: 'someone@gmail.com',
+      role_name: 'Issuer',
+      sign_here_tabs: [
+        {
+          anchor_string: 'sign_here_1',
+          anchor_x_offset: '140',
+          anchor_y_offset: '8'
+        }
+      ]
     },
     {
-      #embedded: true,
+      embedded: true,
       name: 'Test Girl',
-      email: 'someone+else@gmail.com'
+      email: 'someone+else@gmail.com',
+      role_name: 'Attorney',
+      sign_here_tabs: [
+        {
+          anchor_string: 'sign_here_2',
+          anchor_x_offset: '140',
+          anchor_y_offset: '8'
+        },
+        {
+          anchor_string: 'sign_here_3',
+          anchor_x_offset: '140',
+          anchor_y_offset: '8'
+        }
+      ]
     }
   ],
   files: [
@@ -136,14 +159,26 @@ client = DocusignRest::Client.new
       name: 'jon',
       email: 'someone@gmail.com',
       role_name: 'Issuer',
-      anchor_string: 'issuer_sig'
+      sign_here_tabs: [
+        {
+          anchor_string: 'issuer_sig',
+          anchor_x_offset: '140',
+          anchor_y_offset: '8'
+        }
+      ]
     },
     {
       embedded: true,
       name: 'tim',
       email: 'someone+else@gmail.com',
       role_name: 'Attorney',
-      anchor_string: 'attorney_sig'
+      sign_here_tabs: [
+        {
+          anchor_string: 'attorney_sig',
+          anchor_x_offset: '140',
+          anchor_y_offset: '8'
+        }
+      ]
     }
   ],
   files: [

data/lib/docusign_rest/client.rb

@@ -260,33 +260,36 @@ module DocusignRest
             \"numberTabs\":null,
             \"radioGroupTabs\":null,
             \"signHereTabs\":[
-              {
-                \"anchorString\":\"#{signer[:anchor_string]}\",
-                \"anchorXOffset\": \"#{signer[:anchor_x_offset] || '0'}\",
-                \"anchorYOffset\": \"#{signer[:anchor_y_offset] || '0'}\",
-                \"anchorIgnoreIfNotPresent\": #{signer[:ignore_anchor_if_not_present] || false},
-                \"anchorUnits\": \"pixels\",
-                \"conditionalParentLabel\": null,
-                \"conditionalParentValue\": null,
-                \"documentId\":\"#{signer[:document_id] || '1'}\",
-                \"pageNumber\":\"#{signer[:page_number] || '1'}\",
-                \"recipientId\":\"#{index+1}\",
-              "
-              if options[:template] == true
-                doc_signer << "
-                  \"templateLocked\":#{signer[:template_locked] || true},
-                  \"templateRequired\":#{signer[:template_required] || true},
-                "
-              end
+          "
+          signer[:sign_here_tabs].each do |sign_here_tab|
+            doc_signer << "{
+              \"anchorString\":\"#{sign_here_tab[:anchor_string]}\",
+              \"anchorXOffset\": \"#{sign_here_tab[:anchor_x_offset] || '0'}\",
+              \"anchorYOffset\": \"#{sign_here_tab[:anchor_y_offset] || '0'}\",
+              \"anchorIgnoreIfNotPresent\": #{sign_here_tab[:ignore_anchor_if_not_present] || false},
+              \"anchorUnits\": \"pixels\",
+              \"conditionalParentLabel\": null,
+              \"conditionalParentValue\": null,
+              \"documentId\":\"#{sign_here_tab[:document_id] || '1'}\",
+              \"pageNumber\":\"#{sign_here_tab[:page_number] || '1'}\",
+              \"recipientId\":\"#{index+1}\",
+            "
+            if options[:template] == true
               doc_signer << "
-                \"xPosition\":\"#{signer[:x_position] || '0'}\",
-                \"yPosition\":\"#{signer[:y_position] || '0'}\",
-                \"name\":\"#{signer[:sign_here_tab_text] || 'Sign Here'}\",
-                \"optional\":false,
-                \"scaleValue\":1,
-                \"tabLabel\":\"#{signer[:tab_label] || 'Signature 1'}\"
-              },
-            ],
+                \"templateLocked\":#{sign_here_tab[:template_locked] || true},
+                \"templateRequired\":#{sign_here_tab[:template_required] || true},
+              "
+            end
+            doc_signer << "
+              \"xPosition\":\"#{sign_here_tab[:x_position] || '0'}\",
+              \"yPosition\":\"#{sign_here_tab[:y_position] || '0'}\",
+              \"name\":\"#{sign_here_tab[:sign_here_tab_text] || 'Sign Here'}\",
+              \"optional\":false,
+              \"scaleValue\":1,
+              \"tabLabel\":\"#{sign_here_tab[:tab_label] || 'Signature 1'}\"
+            },"
+          end
+          doc_signer << "],
             \"signerAttachmentTabs\":null,
             \"ssnTabs\":null,
             \"textTabs\":null,

data/lib/docusign_rest/version.rb

@@ -1,3 +1,3 @@
 module DocusignRest
-  VERSION = "0.0.8"
+  VERSION = "0.0.9"
 end

data/test/docusign_rest/client_test.rb

@@ -97,18 +97,26 @@ describe DocusignRest::Client do
               name: 'Test Guy',
               email: 'testguy@gmail.com',
               role_name: 'Issuer',
-              anchor_string: 'sign here',
-              anchor_x_offset: '125',
-              anchor_y_offset: '-12'
+              sign_here_tabs: [
+                {
+                  anchor_string: 'sign here',
+                  anchor_x_offset: '125',
+                  anchor_y_offset: '-12'
+                }
+              ]
             },
             {
               embedded: true,
               name: 'Test Girl',
               email: 'testgirl@gmail.com',
               role_name: 'Attorney',
-              anchor_string: 'sign here',
-              anchor_x_offset: '140',
-              anchor_y_offset: '-12'
+              sign_here_tabs: [
+                {
+                  anchor_string: 'sign here',
+                  anchor_x_offset: '140',
+                  anchor_y_offset: '-12'
+                }
+              ]
             }
           ],
           files: [
@@ -134,10 +142,14 @@ describe DocusignRest::Client do
                 name: 'jon',
                 email: 'someone@gmail.com',
                 role_name: 'Issuer',
-                anchor_string: 'sign here',
-                template_locked: true, #doesn't seem to do anything
-                template_required: true, #doesn't seem to do anything
-                email_notification: false #FIXME if signer is setup as 'embedded' initial email notifications don't go out, but even when I set up a signer as non-embedded this setting didn't seem to make the email notifications actually stop...
+                sign_here_tabs: [
+                  {
+                    anchor_string: 'sign here',
+                    template_locked: true, #doesn't seem to do anything
+                    template_required: true, #doesn't seem to do anything
+                    email_notification: false #FIXME if signer is setup as 'embedded' initial email notifications don't go out, but even when I set up a signer as non-embedded this setting didn't seem to make the email notifications actually stop...
+                  }
+                ]
               }
             ],
             files: [

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: docusign_rest
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-07-03 00:00:00.000000000 Z
+date: 2012-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multipart-post