groupdocs 1.5.7 → 1.5.8

data/examples/api-samples/public/docs/sample28.html

@@ -93,12 +93,14 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-5">&#182;</a>
               </div>
-              <p>make a request to API using client_id and private_key</p>
+              <p>Configure your access to API server.</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    files_list = <span class="constant">GroupDocs::Storage::Folder</span>.list!(<span class="string">'/'</span>, {}, {<span class="symbol">:client_id</span> =&gt; settings.client_id, <span class="symbol">:private_key</span> =&gt; settings.private_key})
-    document = <span class="string">''</span></pre></div></div>
+            <div class="content"><div class='highlight'><pre>    <span class="constant">GroupDocs</span>.configure <span class="keyword">do</span> |groupdocs|
+      groupdocs.client_id = settings.client_id
+      groupdocs.private_key = settings.private_key
+    <span class="keyword">end</span></pre></div></div>
             
         </li>
         
@@ -109,6 +111,22 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-6">&#182;</a>
               </div>
+              <p>make a request to API using client_id and private_key</p>
+
+            </div>
+            
+            <div class="content"><div class='highlight'><pre>    files_list = <span class="constant">GroupDocs::Storage::Folder</span>.list!(<span class="string">'/'</span>, {})
+    document = <span class="string">''</span></pre></div></div>
+            
+        </li>
+        
+        
+        <li id="section-7">
+            <div class="annotation">
+              
+              <div class="pilwrap ">
+                <a class="pilcrow" href="#section-7">&#182;</a>
+              </div>
               <p>get document by file ID</p>
 
             </div>
@@ -125,11 +143,11 @@
         </li>
         
         
-        <li id="section-7">
+        <li id="section-8">
             <div class="annotation">
               
               <div class="pilwrap ">
-                <a class="pilcrow" href="#section-7">&#182;</a>
+                <a class="pilcrow" href="#section-8">&#182;</a>
               </div>
               <p>get list of annotations</p>
 
@@ -140,11 +158,11 @@
         </li>
         
         
-        <li id="section-8">
+        <li id="section-9">
             <div class="annotation">
               
               <div class="pilwrap ">
-                <a class="pilcrow" href="#section-8">&#182;</a>
+                <a class="pilcrow" href="#section-9">&#182;</a>
               </div>
               <p>delete all annotations from document</p>
 
@@ -164,11 +182,11 @@
         </li>
         
         
-        <li id="section-9">
+        <li id="section-10">
             <div class="annotation">
               
               <div class="pilwrap ">
-                <a class="pilcrow" href="#section-9">&#182;</a>
+                <a class="pilcrow" href="#section-10">&#182;</a>
               </div>
               <p>set variables for template</p>
 

data/examples/api-samples/public/docs/sample29.html

@@ -63,7 +63,7 @@
             </div>
             
             <div class="content"><div class='highlight'><pre>  set <span class="symbol">:client_id</span>, params[<span class="symbol">:clientId</span>]
-  set <span class="symbol">:base_path</span>, params[<span class="symbol">:basePath</span>]
+  set <span class="symbol">:base_path</span>, params[<span class="symbol">:serverType</span>]
   set <span class="symbol">:url</span>, params[<span class="symbol">:url</span>]
 
   url = settings.url
@@ -102,9 +102,9 @@
             
             <div class="content"><div class='highlight'><pre>    <span class="keyword">if</span> (!url.empty?)
 
-       <span class="keyword">if</span> (base_path == <span class="string">"https://api.groupdocs.com/v2.0"</span>)
-         iframe = <span class="string">"https://apps.groupdocs.com/document-viewer/embed?url=<span class="subst">#{url}</span> + '&amp;user_id=<span class="subst">#{client_id}</span>"</span>
-       <span class="keyword">elsif</span> (base_path == <span class="string">"https://dev-api.groupdocs.com/v2.0"</span>)</pre></div></div>
+      <span class="keyword">if</span> (base_path == <span class="string">"https://api.groupdocs.com/v2.0"</span>)
+        iframe = <span class="string">"https://apps.groupdocs.com/document-viewer/embed?url=<span class="subst">#{url}</span> &amp;user_id=<span class="subst">#{client_id}</span>"</span>
+      <span class="keyword">elsif</span> (base_path == <span class="string">"https://dev-api.groupdocs.com/v2.0"</span>)</pre></div></div>
             
         </li>
         
@@ -119,8 +119,8 @@
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>         iframe = <span class="string">"https://dev-apps.groupdocs.com/document-viewer/embed?url=<span class="subst">#{url}</span> + '&amp;user_id=<span class="subst">#{client_id}</span>"</span>
-       <span class="keyword">elsif</span> (base_path == <span class="string">"https://stage-api.groupdocs.com/v2.0"</span>)</pre></div></div>
+            <div class="content"><div class='highlight'><pre>        iframe = <span class="string">"https://dev-apps.groupdocs.com/document-viewer/embed?url=<span class="subst">#{url}</span> &amp;user_id=<span class="subst">#{client_id}</span>"</span>
+      <span class="keyword">elsif</span> (base_path == <span class="string">"https://stage-api.groupdocs.com/v2.0"</span>)</pre></div></div>
             
         </li>
         
@@ -135,10 +135,10 @@
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>         iframe = <span class="string">"https://stage-apps.groupdocs.com/document-viewer/embed?url=<span class="subst">#{url}</span> + '&amp;user_id=<span class="subst">#{client_id}</span>"</span>
-       <span class="keyword">elsif</span> (base_path == <span class="string">"http://realtime-api.groupdocs.com"</span>)
-         iframe = <span class="string">"http://realtime-apps.groupdocs.com/document-viewer/embed?url=<span class="subst">#{url}</span> + '&amp;user_id=<span class="subst">#{client_id}</span>"</span>
-       <span class="keyword">end</span>
+            <div class="content"><div class='highlight'><pre>        iframe = <span class="string">"https://stage-apps.groupdocs.com/document-viewer/embed?url=<span class="subst">#{url}</span> &amp;user_id=<span class="subst">#{client_id}</span>"</span>
+      <span class="keyword">elsif</span> (base_path == <span class="string">"http://realtime-api.groupdocs.com"</span>)
+        iframe = <span class="string">"http://realtime-apps.groupdocs.com/document-viewer/embed?url=<span class="subst">#{url}</span> &amp;user_id=<span class="subst">#{client_id}</span>"</span>
+      <span class="keyword">end</span>
 
 
     <span class="keyword">end</span>

data/examples/api-samples/public/docs/sample30.html

@@ -59,13 +59,14 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-3">&#182;</a>
               </div>
-              <p>set variables</p>
+              <p>Set variables</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>  set <span class="symbol">:client_id</span>, params[<span class="symbol">:client_id</span>]
-  set <span class="symbol">:private_key</span>, params[<span class="symbol">:private_key</span>]
-  set <span class="symbol">:file_id</span>, params[<span class="symbol">:fileId</span>]
+            <div class="content"><div class='highlight'><pre>  set <span class="symbol">:client_id</span>, params[<span class="symbol">:clientId</span>]
+  set <span class="symbol">:private_key</span>, params[<span class="symbol">:privateKey</span>]
+  set <span class="symbol">:name</span>, params[<span class="symbol">:fileName</span>]
+  set <span class="symbol">:base_path</span>, params[<span class="symbol">:basePath</span>]
 
   <span class="keyword">begin</span></pre></div></div>
             
@@ -82,7 +83,9 @@
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    raise <span class="string">'Please enter all required parameters'</span> <span class="keyword">if</span> settings.client_id.empty? <span class="keyword">or</span> settings.private_key.empty? <span class="keyword">or</span> settings.file_id.empty?</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    raise <span class="string">'Please enter all required parameters'</span> <span class="keyword">if</span> settings.client_id.empty? <span class="keyword">or</span> settings.private_key.empty? <span class="keyword">or</span> settings.name.empty?
+
+    <span class="keyword">if</span> settings.base_path.empty? <span class="keyword">then</span> settings.base_path = <span class="string">'https://api.groupdocs.com'</span> <span class="keyword">end</span></pre></div></div>
             
         </li>
         
@@ -93,11 +96,13 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-5">&#182;</a>
               </div>
-              <p>make a request to API using client_id and private_key</p>
+              <p>Configure your access to API server</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    file = <span class="constant">GroupDocs::Storage::File</span>.new({<span class="symbol">:guid</span> =&gt; settings.file_id})</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    <span class="constant">GroupDocs</span>.configure <span class="keyword">do</span> |groupdocs|
+      groupdocs.client_id = settings.client_id
+      groupdocs.private_key = settings.private_key</pre></div></div>
             
         </li>
         
@@ -108,13 +113,64 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-6">&#182;</a>
               </div>
-              <p>delete file from GroupDocs Storage</p>
+              <p>Optionally specify API server and version</p>
+
+            </div>
+            
+            <div class="content"><div class='highlight'><pre>      groupdocs.api_server = settings.base_path <span class="comment"># default is 'https://api.groupdocs.com'</span>
+    <span class="keyword">end</span></pre></div></div>
+            
+        </li>
+        
+        
+        <li id="section-7">
+            <div class="annotation">
+              
+              <div class="pilwrap ">
+                <a class="pilcrow" href="#section-7">&#182;</a>
+              </div>
+              <p>Make a request to API using client_id and private_key</p>
+
+            </div>
+            
+            <div class="content"><div class='highlight'><pre>    files_list = <span class="constant">GroupDocs::Storage::Folder</span>.list!(<span class="string">'/'</span>, {})
+    document = <span class="string">''</span></pre></div></div>
+            
+        </li>
+        
+        
+        <li id="section-8">
+            <div class="annotation">
+              
+              <div class="pilwrap ">
+                <a class="pilcrow" href="#section-8">&#182;</a>
+              </div>
+              <p>Get document by file ID</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    result = file.delete!({<span class="symbol">:client_id</span> =&gt; settings.client_id, <span class="symbol">:private_key</span> =&gt; settings.private_key})
+            <div class="content"><div class='highlight'><pre>    files_list.each <span class="keyword">do</span> |element|
+      <span class="keyword">if</span> element.respond_to?(<span class="string">'name'</span>) == <span class="keyword">true</span> <span class="keyword">and</span> element.name == settings.name
+        document = element
+      <span class="keyword">end</span>
+    <span class="keyword">end</span></pre></div></div>
+            
+        </li>
+        
+        
+        <li id="section-9">
+            <div class="annotation">
+              
+              <div class="pilwrap ">
+                <a class="pilcrow" href="#section-9">&#182;</a>
+              </div>
+              <p>Delete file from GroupDocs Storage</p>
+
+            </div>
+            
+            <div class="content"><div class='highlight'><pre>    document.delete!()
 
-    message = <span class="string">'File was deleted from GroupDocs Storage'</span>
+    message = <span class="string">'Done, file deleted from your GroupDocs Storage'</span>
 
   <span class="keyword">rescue</span> <span class="constant">Exception</span> =&gt; e
     err = e.message
@@ -123,17 +179,17 @@
         </li>
         
         
-        <li id="section-7">
+        <li id="section-10">
             <div class="annotation">
               
               <div class="pilwrap ">
-                <a class="pilcrow" href="#section-7">&#182;</a>
+                <a class="pilcrow" href="#section-10">&#182;</a>
               </div>
-              <p>set variables for template</p>
+              <p>Set variables for template</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>  haml <span class="symbol">:sample30</span>, <span class="symbol">:locals</span> =&gt; {<span class="symbol">:userId</span> =&gt; settings.client_id, <span class="symbol">:privateKey</span> =&gt; settings.private_key, <span class="symbol">:message</span> =&gt; message, <span class="symbol">:fileId</span> =&gt; settings.file_id, <span class="symbol">:err</span> =&gt; err}
+            <div class="content"><div class='highlight'><pre>  haml <span class="symbol">:sample30</span>, <span class="symbol">:locals</span> =&gt; {<span class="symbol">:userId</span> =&gt; settings.client_id, <span class="symbol">:privateKey</span> =&gt; settings.private_key, <span class="symbol">:message</span> =&gt; message, <span class="symbol">:name</span> =&gt; settings.name, <span class="symbol">:err</span> =&gt; err}
 <span class="keyword">end</span></pre></div></div>
             
         </li>

data/examples/api-samples/public/docs/sample31.html

@@ -286,16 +286,17 @@
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>  set <span class="symbol">:client_id</span>, params[<span class="symbol">:client_id</span>]
-  set <span class="symbol">:private_key</span>, params[<span class="symbol">:private_key</span>]
-  set <span class="symbol">:template_guid</span>, params[<span class="symbol">:template_guid</span>]
+            <div class="content"><div class='highlight'><pre>  set <span class="symbol">:client_id</span>, params[<span class="symbol">:clientId</span>]
+  set <span class="symbol">:private_key</span>, params[<span class="symbol">:privateKey</span>]
+  set <span class="symbol">:template_guid</span>, params[<span class="symbol">:templateGuid</span>]
   set <span class="symbol">:name</span>, params[<span class="symbol">:name</span>]
   set <span class="symbol">:country</span>, params[<span class="symbol">:country</span>]
   set <span class="symbol">:city</span>, params[<span class="symbol">:city</span>]
   set <span class="symbol">:street</span>, params[<span class="symbol">:street</span>]
   set <span class="symbol">:email</span>, params[<span class="symbol">:email</span>]
   set <span class="symbol">:callback</span>, params[<span class="symbol">:callback</span>]
-  set <span class="symbol">:last_name</span>, params[<span class="symbol">:last_name</span>]</pre></div></div>
+  set <span class="symbol">:last_name</span>, params[<span class="symbol">:lastName</span>]
+  set <span class="symbol">:base_path</span>, params[<span class="symbol">:basePath</span>]</pre></div></div>
             
         </li>
         
@@ -346,7 +347,9 @@
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    raise <span class="string">'Please enter all required parameters'</span> <span class="keyword">if</span> settings.client_id.empty? <span class="keyword">or</span> settings.private_key.empty?</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    raise <span class="string">'Please enter all required parameters'</span> <span class="keyword">if</span> settings.client_id.empty? <span class="keyword">or</span> settings.private_key.empty?
+
+    <span class="keyword">if</span> settings.base_path.empty? <span class="keyword">then</span> settings.base_path = <span class="string">'https://api.groupdocs.com'</span> <span class="keyword">end</span></pre></div></div>
             
         </li>
         
@@ -357,12 +360,13 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-20">&#182;</a>
               </div>
-              <p>Write client and private key to the file for callback job</p>
+              <p>Configure your access to API server</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    <span class="keyword">if</span> settings.callback[<span class="number">0</span>]
-      out_file = <span class="constant">File</span>.new(<span class="string">"<span class="subst">#{<span class="constant">File</span>.dirname(__FILE_<span class="number">_</span>)}</span>/../public/user_info.txt"</span>, <span class="string">'w'</span>)</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    <span class="constant">GroupDocs</span>.configure <span class="keyword">do</span> |groupdocs|
+      groupdocs.client_id = settings.client_id
+      groupdocs.private_key = settings.private_key</pre></div></div>
             
         </li>
         
@@ -373,16 +377,12 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-21">&#182;</a>
               </div>
-              <p>white space is required</p>
+              <p>Optionally specify API server and version</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>      out_file.write(<span class="string">"<span class="subst">#{settings.client_id}</span> "</span>)
-      out_file.write(<span class="string">"<span class="subst">#{settings.private_key}</span>"</span>)
-      out_file.close
-    <span class="keyword">end</span>
-
-    file = <span class="keyword">nil</span></pre></div></div>
+            <div class="content"><div class='highlight'><pre>      groupdocs.api_server = settings.base_path <span class="comment"># default is 'https://api.groupdocs.com'</span>
+    <span class="keyword">end</span></pre></div></div>
             
         </li>
         
@@ -393,11 +393,12 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-22">&#182;</a>
               </div>
-              <p>Create instance of File</p>
+              <p>Write client and private key to the file for callback job</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    file = <span class="constant">GroupDocs::Storage::File</span>.new({<span class="symbol">:guid</span> =&gt; settings.template_guid})</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    <span class="keyword">if</span> settings.callback[<span class="number">0</span>]
+      out_file = <span class="constant">File</span>.new(<span class="string">"<span class="subst">#{<span class="constant">File</span>.dirname(__FILE_<span class="number">_</span>)}</span>/../public/user_info.txt"</span>, <span class="string">'w'</span>)</pre></div></div>
             
         </li>
         
@@ -408,11 +409,18 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-23">&#182;</a>
               </div>
-              <p>Raise exception if something went wrong</p>
+              <p>white space is required</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    raise <span class="string">'No such file'</span> <span class="keyword">unless</span> file.is_a?(<span class="constant">GroupDocs::Storage::File</span>)</pre></div></div>
+            <div class="content"><div class='highlight'><pre>      out_file.write(<span class="string">"<span class="subst">#{settings.client_id}</span> "</span>)
+      out_file.write(<span class="string">"<span class="subst">#{settings.private_key}</span>"</span>)
+      out_file.close
+    <span class="keyword">end</span>
+    <span class="keyword">if</span> settings.last_name.empty?
+      settings.last_name = <span class="string">'test'</span>
+    <span class="keyword">end</span>
+    file = <span class="keyword">nil</span></pre></div></div>
             
         </li>
         
@@ -423,11 +431,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-24">&#182;</a>
               </div>
-              <p>Make GroupDocs::Storage::Document instance</p>
+              <p>Create instance of File</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    document = file.to_document</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    file = <span class="constant">GroupDocs::Storage::File</span>.new({<span class="symbol">:guid</span> =&gt; settings.template_guid})</pre></div></div>
             
         </li>
         
@@ -438,11 +446,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-25">&#182;</a>
               </div>
-              <p>Create datasource with fields</p>
+              <p>Raise exception if something went wrong</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    datasource = <span class="constant">GroupDocs::DataSource</span>.new</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    raise <span class="string">'No such file'</span> <span class="keyword">unless</span> file.is_a?(<span class="constant">GroupDocs::Storage::File</span>)</pre></div></div>
             
         </li>
         
@@ -453,11 +461,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-26">&#182;</a>
               </div>
-              <p>Get arry of document&#39;s fields</p>
+              <p>Make GroupDocs::Storage::Document instance</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    enteredData = {<span class="string">"email"</span> =&gt; settings.email, <span class="string">"name"</span> =&gt; settings.name, <span class="string">"last_name"</span> =&gt; settings.last_name, <span class="string">"country"</span>=&gt; settings.country, <span class="string">"city"</span> =&gt; settings.city, <span class="string">"street"</span> =&gt; settings.street}</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    document = file.to_document</pre></div></div>
             
         </li>
         
@@ -468,11 +476,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-27">&#182;</a>
               </div>
-              <p>Create Field instance and fill the fields</p>
+              <p>Create datasource with fields</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    datasource.fields = enteredData.map { |key, value| <span class="constant">GroupDocs::DataSource::Field</span>.new(<span class="symbol">name:</span> key, <span class="symbol">type:</span> <span class="symbol">:text</span>, <span class="symbol">values:</span> <span class="constant">Array</span>.new() &lt;&lt; value) }</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    datasource = <span class="constant">GroupDocs::DataSource</span>.new</pre></div></div>
             
         </li>
         
@@ -483,11 +491,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-28">&#182;</a>
               </div>
-              <p>Adds datasource.</p>
+              <p>Get arry of document&#39;s fields</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    datasource.add!({<span class="symbol">:client_id</span> =&gt; settings.client_id, <span class="symbol">:private_key</span> =&gt; settings.private_key})</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    enteredData = {<span class="string">"email"</span> =&gt; settings.email, <span class="string">"name"</span> =&gt; settings.name, <span class="string">"last_name"</span> =&gt; settings.last_name, <span class="string">"country"</span>=&gt; settings.country, <span class="string">"city"</span> =&gt; settings.city, <span class="string">"street"</span> =&gt; settings.street}</pre></div></div>
             
         </li>
         
@@ -498,12 +506,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-29">&#182;</a>
               </div>
-              <p>Creates new job to merge datasource into document.</p>
+              <p>Create Field instance and fill the fields</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    job = document.datasource!(datasource, {<span class="symbol">:new_type</span> =&gt; <span class="string">"pdf"</span>}, {<span class="symbol">:client_id</span> =&gt; settings.client_id, <span class="symbol">:private_key</span> =&gt; settings.private_key})
-    sleep <span class="number">10</span> <span class="comment"># wait for merge and convert</span></pre></div></div>
+            <div class="content"><div class='highlight'><pre>    datasource.fields = enteredData.map { |key, value| <span class="constant">GroupDocs::DataSource::Field</span>.new(<span class="symbol">name:</span> key, <span class="symbol">type:</span> <span class="symbol">:text</span>, <span class="symbol">values:</span> <span class="constant">Array</span>.new() &lt;&lt; value) }</pre></div></div>
             
         </li>
         
@@ -514,11 +521,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-30">&#182;</a>
               </div>
-              <p>Returns an hash of input and output documents associated to job.</p>
+              <p>Adds datasource.</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    jobInfo = job.documents!({<span class="symbol">:client_id</span> =&gt; settings.client_id, <span class="symbol">:private_key</span> =&gt; settings.private_key})</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    datasource.add!()</pre></div></div>
             
         </li>
         
@@ -529,13 +536,12 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-31">&#182;</a>
               </div>
-              <p>Create envelope using user id and entered by user name</p>
+              <p>Creates new job to merge datasource into document.</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    envelope = <span class="constant">GroupDocs::Signature::Envelope</span>.new
-    envelope.name = jobInfo[<span class="symbol">:inputs</span>][<span class="number">0</span>].outputs[<span class="number">0</span>].name
-    envelope.create!({}, {<span class="symbol">:client_id</span> =&gt; settings.client_id, <span class="symbol">:private_key</span> =&gt; settings.private_key})</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    job = document.datasource!(datasource, {<span class="symbol">:new_type</span> =&gt; <span class="string">"pdf"</span>})
+    sleep <span class="number">10</span> <span class="comment"># wait for merge and convert</span></pre></div></div>
             
         </li>
         
@@ -546,11 +552,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-32">&#182;</a>
               </div>
-              <p>Add uploaded document to envelope</p>
+              <p>Returns an hash of input and output documents associated to job.</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    envelope.add_document!(document, {}, {<span class="symbol">:client_id</span> =&gt; settings.client_id, <span class="symbol">:private_key</span> =&gt; settings.private_key})</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    jobInfo = job.documents!()</pre></div></div>
             
         </li>
         
@@ -561,11 +567,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-33">&#182;</a>
               </div>
-              <p>Get role list for current user</p>
+              <p>Creates new document to envelope</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    roles = <span class="constant">GroupDocs::Signature::Role</span>.get!({}, {<span class="symbol">client_id:</span> settings.client_id, <span class="symbol">private_key:</span> settings.private_key})</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    document = jobInfo[<span class="symbol">:inputs</span>][<span class="number">0</span>].outputs[<span class="number">0</span>].to_document</pre></div></div>
             
         </li>
         
@@ -576,15 +582,13 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-34">&#182;</a>
               </div>
-              <p>Create new recipient</p>
+              <p>Creates envelope using user id and entered by user name</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    recipient = <span class="constant">GroupDocs::Signature::Recipient</span>.new
-    recipient.email = <span class="string">'test@test.com'</span>
-    recipient.first_name = <span class="string">'test'</span>
-    recipient.last_name = <span class="string">'test'</span>
-    recipient.role_id = roles.detect { |role| role.name == <span class="string">'Signer'</span> }.id</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    envelope = <span class="constant">GroupDocs::Signature::Envelope</span>.new
+    envelope.name = jobInfo[<span class="symbol">:inputs</span>][<span class="number">0</span>].outputs[<span class="number">0</span>].name
+    envelope.create!({})</pre></div></div>
             
         </li>
         
@@ -595,11 +599,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-35">&#182;</a>
               </div>
-              <p>Add recipient to envelope</p>
+              <p>Adds uploaded document to envelope</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    envelope.add_recipient!(recipient, {<span class="symbol">client_id:</span> settings.client_id, <span class="symbol">private_key:</span> settings.private_key})</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    envelope.add_document!(document, {})</pre></div></div>
             
         </li>
         
@@ -610,16 +614,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-36">&#182;</a>
               </div>
-              <p>Get field</p>
+              <p>Get role list for current user</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    fieldGet = <span class="constant">GroupDocs::Signature::Field</span>.get!({},{<span class="symbol">client_id:</span> settings.client_id, <span class="symbol">private_key:</span> settings.private_key}).detect { |f| f.type == <span class="symbol">:signature</span> }
-    fieldGet.location = { <span class="symbol">location_x:</span> <span class="number">0</span>.<span class="number">15</span>,
-                          <span class="symbol">location_y:</span> <span class="number">0</span>.<span class="number">73</span>,
-                          <span class="symbol">location_width:</span> <span class="number">150</span>,
-                          <span class="symbol">location_height:</span> <span class="number">50</span>,
-                          <span class="symbol">page:</span> <span class="number">1</span> }</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    roles = <span class="constant">GroupDocs::Signature::Role</span>.get!({})</pre></div></div>
             
         </li>
         
@@ -630,11 +629,15 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-37">&#182;</a>
               </div>
-              <p>Get document</p>
+              <p>Creates new recipient</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    documentGet = envelope.documents!({}, {<span class="symbol">client_id:</span> settings.client_id, <span class="symbol">private_key:</span> settings.private_key}).first</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    recipient = <span class="constant">GroupDocs::Signature::Recipient</span>.new
+    recipient.email = settings.email
+    recipient.first_name = settings.name
+    recipient.last_name = settings.last_name
+    recipient.role_id = roles.detect { |role| role.name == <span class="string">'Signer'</span> }.id</pre></div></div>
             
         </li>
         
@@ -645,11 +648,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-38">&#182;</a>
               </div>
-              <p>Get recipients</p>
+              <p>Adds recipient to envelope</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    recipientGet = envelope.recipients!({},{<span class="symbol">client_id:</span> settings.client_id, <span class="symbol">private_key:</span> settings.private_key}).first</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    envelope.add_recipient!(recipient)</pre></div></div>
             
         </li>
         
@@ -660,11 +663,11 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-39">&#182;</a>
               </div>
-              <p>Add field to envelope</p>
+              <p>Get recipients</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    addField = envelope.add_field!(fieldGet, documentGet, recipientGet, {}, {<span class="symbol">client_id:</span> settings.client_id, <span class="symbol">private_key:</span> settings.private_key})</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    recipientGet = envelope.recipients!({}).first</pre></div></div>
             
         </li>
         
@@ -679,7 +682,7 @@
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    envelope.send!(settings.callback, {<span class="symbol">client_id:</span> settings.client_id, <span class="symbol">private_key:</span> settings.private_key})</pre></div></div>
+            <div class="content"><div class='highlight'><pre>    envelope.send!({<span class="symbol">:callbackUrl</span> =&gt; settings.callback})</pre></div></div>
             
         </li>
         
@@ -690,11 +693,49 @@
               <div class="pilwrap ">
                 <a class="pilcrow" href="#section-41">&#182;</a>
               </div>
+              <p>Get url from request</p>
+
+            </div>
+            
+            <div class="content"><div class='highlight'><pre>    <span class="keyword">case</span> settings.base_path
+
+      <span class="keyword">when</span> <span class="string">'https://stage-api-groupdocs.dynabic.com'</span>
+        url = <span class="string">"http://stage-apps-groupdocs.dynabic.com/signature2/signembed/<span class="subst">#{envelope.id}</span>/<span class="subst">#{recipientGet.id}</span>"</span>
+      <span class="keyword">when</span> <span class="string">'https://dev-api-groupdocs.dynabic.com'</span>
+        url = <span class="string">"http://dev-apps-groupdocs.dynabic.com/signature2/signembed/<span class="subst">#{envelope.id}</span>/<span class="subst">#{recipientGet.id}</span>"</span>
+      <span class="keyword">else</span>
+        url = <span class="string">"https://apps.groupdocs.com/signature2/signembed/<span class="subst">#{envelope.id}</span>/<span class="subst">#{recipientGet.id}</span>"</span>
+    <span class="keyword">end</span></pre></div></div>
+            
+        </li>
+        
+        
+        <li id="section-42">
+            <div class="annotation">
+              
+              <div class="pilwrap ">
+                <a class="pilcrow" href="#section-42">&#182;</a>
+              </div>
+              <p>Add the signature in url</p>
+
+            </div>
+            
+            <div class="content"><div class='highlight'><pre>    iframe = <span class="constant">GroupDocs::Api::Request</span>.new(<span class="symbol">:path</span> =&gt; url).prepare_and_sign_url</pre></div></div>
+            
+        </li>
+        
+        
+        <li id="section-43">
+            <div class="annotation">
+              
+              <div class="pilwrap ">
+                <a class="pilcrow" href="#section-43">&#182;</a>
+              </div>
               <p>Make iframe</p>
 
             </div>
             
-            <div class="content"><div class='highlight'><pre>    iframe = <span class="string">"&lt;iframe src='https://apps.groupdocs.com/signature/signembed/<span class="subst">#{envelope.id}</span>/<span class="subst">#{recipientGet.id}</span>' frameborder='0' width='720' height='600'&gt;&lt;/iframe&gt;"</span>
+            <div class="content"><div class='highlight'><pre>    iframe = <span class="string">"&lt;iframe src='<span class="subst">#{iframe}</span>' frameborder='0' width='720' height='600'&gt;&lt;/iframe&gt;"</span>
 
 
   <span class="keyword">rescue</span> <span class="constant">Exception</span> =&gt; e
@@ -704,11 +745,11 @@
         </li>
         
         
-        <li id="section-42">
+        <li id="section-44">
             <div class="annotation">
               
               <div class="pilwrap ">
-                <a class="pilcrow" href="#section-42">&#182;</a>
+                <a class="pilcrow" href="#section-44">&#182;</a>
               </div>
               <p>set variables for template</p>