groupdocs 1.5.8 → 1.5.9

data/examples/api-samples/samples/sample36.rb

@@ -1,23 +1,20 @@
-# GET request
+#GET request
 get '/sample36' do
   haml :sample36
 end
 
-
-
-
-# POST request
+#POST request
 post '/sample36' do
-  # Set variables
+  #Set variables
   set :client_id, params[:clientId]
   set :private_key, params[:privateKey]
   set :envelope, params[:envelopeGuid]
   set :base_path, params[:basePath]
 
-  # Set download path
+  #Set download path
   downloads_path = "#{File.dirname(__FILE__)}/../public/downloads"
 
-  # Remove all files from download directory or create folder if it not there
+  #Remove all files from download directory or create folder if it not there
   if File.directory?(downloads_path)
     Dir.foreach(downloads_path) { |f| fn = File.join(downloads_path, f); File.delete(fn) if f != '.' && f != '..' }
   else
@@ -26,20 +23,27 @@ post '/sample36' do
 
 
   begin
-    # Check required variables
+    #Check required variables
     raise 'Please enter all required parameters' if settings.client_id.empty? or settings.private_key.empty?
 
-    if settings.base_path.empty? then settings.base_path = 'https://api.groupdocs.com' end
+    #Prepare base path
+    if settings.base_path.empty?
+      base_path = 'https://api.groupdocs.com'
+    elsif settings.base_path.match('/v2.0')
+      base_path = settings.base_path.split('/v2.0')[0]
+    else
+      base_path = settings.base_path
+    end
 
-    # Configure your access to API server
+    #Configure your access to API server
     GroupDocs.configure do |groupdocs|
       groupdocs.client_id = settings.client_id
       groupdocs.private_key = settings.private_key
-      # Optionally specify API server and version
-      groupdocs.api_server = settings.base_path # default is 'https://api.groupdocs.com'
+      #Optionally specify API server and version
+      groupdocs.api_server = base_path # default is 'https://api.groupdocs.com'
     end
 
-    # Get envelope from GroupDocs Storage
+    #Get envelope from GroupDocs Storage
     envelope = GroupDocs::Signature::Envelope.get!(settings.envelope)
 
     #Download signed files
@@ -53,6 +57,6 @@ post '/sample36' do
     err = e.message
   end
 
-  # set variables for template
+  #Set variables for template
   haml :sample36, :locals => {:userId => settings.client_id, :privateKey => settings.private_key, :envelopeGuid => settings.envelope, :message => message, :err => err}
 end

data/examples/api-samples/samples/sample37.rb

@@ -1,72 +1,27 @@
-# Route the handler url "/sample37"
+#Route the handler url "/sample37"
 get '/sample37' do
   haml :sample37
 end
 
-# GET request
+#GET request
 
-# Route the handler url "/sample37/signature_callback". The block function for callback with server
+#Route the handler url "/sample37/signature_callback". The block function for callback with server
 post '/sample37/signature_callback' do
-  # Get data json from callback
-  data = JSON.parse(request.body.read)  
-  begin 
-    
-    raise 'Empty params!' if data.empty?
-
-  # Set variables from data json
-	source_id = data['SourceId']    
-  event_type = data['EventType']
-
-  # Set variables
-  client_id = nil
-  private_key = nil
-	
-	return if event_type != 'JobCompleted'
-	
-	# Set download path
-	downloads_path = "#{File.dirname(__FILE__)}/../public/downloads"
-	
-	 # Get private key and client_id from file user_info.txt
-	if File.exist?("#{File.dirname(__FILE__)}/../public/user_info.txt")
-	  contents = File.read("#{File.dirname(__FILE__)}/../public/user_info.txt")
-	  contents = contents.split(' ')
-	  client_id = contents[0]
-	  private_key = contents[1]
-	end
-
-    # Get Envelope instance
-    envelope = GroupDocs::Signature::Envelope.get!(source_id, {:client_id => client_id, :private_key => private_key})
-
-    # Get document by envelope
-    envelope.signed_documents!(downloads_path, {:client_id => client_id, :private_key => private_key})
-   
-
-  rescue Exception => e
-    err = e.message
-  end
-end
-
-
-# Route the handler url "/sample37/check"
-
-get '/sample37/check' do
-
-  # Check is there download directory
   unless File.directory?("#{File.dirname(__FILE__)}/../public/downloads")
     return 'Directory was not found.'
   end
 
-  # Get file name from download directory
+  #Get file name from download directory
   name = nil
- 
+
   i = 0
 
-  # Checking, if file exist
+  #Checking, if file exist
     while i<10 do
-      sleep(5)  	  
-    Dir.entries("#{File.dirname(__FILE__)}/../public/downloads").each do |file|	
-      name = file if file != '.' && file != '..'	
-    end	  
+      sleep(5)
+    Dir.entries("#{File.dirname(__FILE__)}/../public/downloads").each do |file|
+      name = file if file != '.' && file != '..'
+    end
       break if name
       i += 1
     end
@@ -74,15 +29,15 @@ get '/sample37/check' do
   name
 end
 
-# Route the handler url "/sample37/downloads"
+#Route the handler url "/sample37/downloads"
 get '/sample37/downloads/:filename' do |filename|
-  # Send file with header to download it
+  #Send file with header to download it
   send_file "#{File.dirname(__FILE__)}/../public/downloads/#{filename}", :filename => filename, :type => 'Application/octet-stream'
 end
 
-# Route the handler url "/sample37". The function block creates new envelope
+#Route the handler url "/sample37". The function block creates new envelope
 post '/sample37' do
-  # Set variables from form
+  #Set variables from form
   set :client_id, params[:clientId]
   set :private_key, params[:privateKey]
   set :email, params[:email]
@@ -94,10 +49,10 @@ post '/sample37' do
   set :url, params[:url]
   set :source, params[:source]
 
-  # Set download path
+  #Set download path
   downloads_path = "#{File.dirname(__FILE__)}/../public/downloads"
 
-  # Remove all files from download directory or create folder if it not there
+  #Remove all files from download directory or create folder if it not there
   if File.directory?(downloads_path)
     Dir.foreach(downloads_path) { |f| fn = File.join(downloads_path, f); File.delete(fn) if f != '.' && f != '..' }
   else
@@ -105,124 +60,131 @@ post '/sample37' do
   end
 
   begin
-    # Check required variables
+    #Check required variables
     raise 'Please enter all required parameters' if settings.client_id.empty? or settings.private_key.empty? or settings.email.empty? or settings.name.empty? or settings.lastName.empty?
 
-    if settings.base_path.empty? then settings.base_path = 'https://api.groupdocs.com' end
+    #Prepare base path
+    if settings.base_path.empty?
+      base_path = 'https://api.groupdocs.com'
+    elsif settings.base_path.match('/v2.0')
+      base_path = settings.base_path.split('/v2.0')[0]
+    else
+      base_path = settings.base_path
+    end
 
-    # Configure your access to API server
+    #Configure your access to API server
     GroupDocs.configure do |groupdocs|
       groupdocs.client_id = settings.client_id
       groupdocs.private_key = settings.private_key
       # Optionally specify API server and version
-      groupdocs.api_server = settings.base_path # default is 'https://api.groupdocs.com'
+      groupdocs.api_server = base_path # default is 'https://api.groupdocs.com'
     end
 
-    # Write client and private key to the file for callback job
+    #Write client and private key to the file for callback job
     if settings.callback
       out_file = File.new("#{File.dirname(__FILE__)}/../public/user_info.txt", 'w')
-      # white space is required
+      #White space is required
       out_file.write("#{settings.client_id} ")
       out_file.write("#{settings.private_key}")
       out_file.close
     end
 
     file = nil
-    # get document by file GUID
+    #Get document by file GUID
     case settings.source
       when 'guid'
-        # Create instance of File
+        #Create instance of File
         file = GroupDocs::Storage::File.new({:guid => settings.fileId}).to_document.metadata!()
         file = file.last_view.document.file.to_document
       when 'local'
-        # construct path
+        #Construct path
         file_path = "#{Dir.tmpdir}/#{params[:file][:filename]}"
 
-        # open file
+        #Open file
         File.open(file_path, 'wb') { |f| f.write(params[:file][:tempfile].read) }
-        # make a request to API using client_id and private_key
-        file = GroupDocs::Storage::File.upload!(file_path, {}).to_document
+        #Make a request to API using client_id and private_key
+        file = GroupDocs::Storage::File.upload!(file_path).to_document
+
       when 'url'
-        # Upload file from defined url
+        #Upload file from defined url
         file = GroupDocs::Storage::File.upload_web!(settings.url).to_document
       else
         raise 'Wrong GUID source.'
     end
 
     name = file.name
-    # create envelope using user id and entered by user name
+    #Create envelope using user id and entered by user name
     envelope = GroupDocs::Signature::Envelope.new
     envelope.name = file.name
     envelope.email_subject = 'Sing this!'
     envelope.create!({})
 
-    # Add uploaded document to envelope
+    #Add uploaded document to envelope
     envelope.add_document!(file, {})
 
-    # Get role list for current user
+    #Get role list for current user
     roles = GroupDocs::Signature::Role.get!({})
 
-    # Create new recipient
+    #Create new recipient
     recipient = GroupDocs::Signature::Recipient.new
     recipient.email = settings.email
     recipient.first_name = settings.name
     recipient.last_name = settings.lastName
     recipient.role_id = roles.detect { |role| role.name == 'Signer' }.id
 
-    # Add recipient to envelope
-    add = envelope.add_recipient!(recipient)
-
-    # Get recipient id
-    recipient.id = add[:recipient][:id]
+    #Add recipient to envelope
+    recipient = envelope.add_recipient!(recipient)
 
-    # Get document id
+    #Get document id
     document = envelope.documents!
 
 
-    # Get field and add the location to field
+    #Get field and add the location to field
     field = GroupDocs::Signature::Field.get!.detect { |f| f.type == :signature }
     field.location = {:location_x => 0.15, :location_y => 0.73, :location_w => 150, :location_h => 50, :page => 1}
     field.name = 'EMPLOYEE SIGNATURE'
 
-    # Add field to envelope
+    #Add field to envelope
     envelope.add_field!(field, document[0], recipient)
 
 
 
-    # Send envelop
+    #Send envelop
     envelope.send!({:callbackUrl => settings.callback})
 
-    # Write client and private key to the file for callback job
+    #Write client and private key to the file for callback job
     if settings.callback
       out_file = File.new("#{File.dirname(__FILE__)}/../public/user_info.txt", 'w')
-      # white space is required
+      #White space is required
       out_file.write("#{settings.client_id} ")
       out_file.write("#{settings.private_key}")
       out_file.write("#{envelope.id}")
       out_file.close
     end
 
-    #Get url from request
-    case settings.base_path
-
+    #Prepare to sign url
+    iframe = "/signature2/signembed/#{envelope.id}/#{recipient.id}"
+    # Construct result string
+    url = GroupDocs::Api::Request.new(:path => iframe).prepare_and_sign_url
+    #Generate iframe URL
+    case base_path
       when 'https://stage-api-groupdocs.dynabic.com'
-        url = "http://stage-apps-groupdocs.dynabic.com/signature/signembed/#{envelope.id}/#{recipient.id}"
+        iframe = "https://stage-api-groupdocs.dynabic.com#{url}"
       when 'https://dev-api-groupdocs.dynabic.com'
-        url = "http://dev-apps-groupdocs.dynabic.com/signature/signembed/#{envelope.id}/#{recipient.id}"
+        iframe = "https://dev-apps.groupdocs.com#{url}"
       else
-        url = "https://apps.groupdocs.com/signature/signembed/#{envelope.id}/#{recipient.id}"
+        iframe = "https://apps.groupdocs.com#{url}"
     end
 
+    #Make iframe
+    iframe = "<iframe id='downloadframe' src='#{iframe}' width='800' height='1000'></iframe>"
 
-    iframe = GroupDocs::Api::Request.new(:path => url).prepare_and_sign_url
-    # Make iframe
-    iframe = "<iframe src='#{iframe}' frameborder='0' width='720' height='600'></iframe>"
     message = "<p>File was uploaded to GroupDocs. Here you can see your <strong>#{name}</strong> file in the GroupDocs Embedded Viewer.</p>"
   rescue Exception => e
     err = e.message
   end
 
-  # Set variables for template
+  #Set variables for template
   haml :sample37, :locals => {:userId => settings.client_id, :privateKey => settings.private_key, :email => settings.email, :name => settings.name, :lastName => settings.lastName, :iframe => iframe, :massage => message, :err => err, :callback => settings.callback,}
 end
 

data/examples/api-samples/samples/sample38.rb

@@ -1,14 +1,11 @@
-# GET request
+#GET request
 get '/sample38' do
   haml :sample38
 end
 
-
-
-
-# POST request
+#POST request
 post '/sample38' do
-  # Set variables
+  #Set variables
   set :client_id, params[:clientId]
   set :private_key, params[:privateKey]
   set :email, params[:email]
@@ -18,46 +15,52 @@ post '/sample38' do
   set :first_name, params[:firstName]
   set :last_name, params[:lastName]
   set :base_path, params[:basePath]
-  #raise params.to_yaml
-  # Set download path
+
+  #Set download path
   downloads_path = "#{File.dirname(__FILE__)}/../public/downloads"
 
-  # Remove all files from download directory or create folder if it not there
+  #Remove all files from download directory or create folder if it not there
   if File.directory?(downloads_path)
     Dir.foreach(downloads_path) { |f| fn = File.join(downloads_path, f); File.delete(fn) if f != '.' && f != '..' }
   else
     Dir::mkdir(downloads_path)
   end
 
-
   begin
-    # Check required variables
-    #raise 'Please enter all required parameters' if settings.client_id.empty? or settings.private_key.empty? or settings.email.empty? or settings.first_name.empty? or settings.last_name?
+    #Check required variables
+    raise 'Please enter all required parameters' if settings.client_id.empty? or settings.private_key.empty? or settings.email.empty? or settings.first_name.empty? or settings.last_name.empty?
 
-    if settings.base_path.empty? then settings.base_path = 'https://api.groupdocs.com' end
+    #Prepare base path
+    if settings.base_path.empty?
+      base_path = 'https://api.groupdocs.com'
+    elsif settings.base_path.match('/v2.0')
+      base_path = settings.base_path.split('/v2.0')[0]
+    else
+      base_path = settings.base_path
+    end
 
-    # Configure your access to API server
+    #Configure your access to API server
     GroupDocs.configure do |groupdocs|
       groupdocs.client_id = settings.client_id
       groupdocs.private_key = settings.private_key
-      # Optionally specify API server and version
-      groupdocs.api_server = settings.base_path # default is 'https://api.groupdocs.com'
+      #Optionally specify API server and version
+      groupdocs.api_server = base_path # default is 'https://api.groupdocs.com'
     end
-
-    # Get document by file GUID
+    file = nil
+    #Get document by file GUID
     case settings.source
       when 'guid'
-        # Create instance of File
+        #Create instance of File
         file = GroupDocs::Storage::File.new({:guid => settings.file_id})
       when 'local'
-        # Construct path
+        #Construct path
         file_path = "#{Dir.tmpdir}/#{params[:file][:filename]}"
-        # Open file
+        #Open file
         File.open(file_path, 'wb') { |f| f.write(params[:file][:tempfile].read) }
-        # Make a request to API using client_id and private_key
+        #Make a request to API using client_id and private_key
         file = GroupDocs::Storage::File.upload!(file_path, {})
       when 'url'
-        # Upload file from defined url
+        #Upload file from defined url
         file = GroupDocs::Storage::File.upload_web!(settings.url)
       else
         raise 'Wrong GUID source.'
@@ -69,53 +72,58 @@ post '/sample38' do
     users = user.users!
     users.map do |user|
       email = user.primary_email
-      # Check whether there is a user with entered email
+      #Check whether there is a user with entered email
       if settings.email == email
-        # Get user GUID
+        #Get user GUID
         userGuid = user.guid
         break
       end
     end
-    # Check is user with entered email was founded in GroupDocs account, if not user will be created
+    #Check is user with entered email was founded in GroupDocs account, if not user will be created
     if userGuid.nil?
       userNew = GroupDocs::User.new
-      # Set email as entered email
+      #Set email as entered email
       userNew.primary_email = settings.email
-      # Set nick name as entered first name
+      #Set nick name as entered first name
       userNew.nickname = settings.email
-      # Set first name as entered first name
+      #Set first name as entered first name
       userNew.firstname = settings.first_name
-      # Set last name as entered last name
+      #Set last name as entered last name
       userNew.lastname = settings.last_name
-      # Set roles
+      #Set roles
       userNew.roles = [{:id => '3', :name => 'User'}]
 
-      # Update account
+      #Update account
       new_user = GroupDocs::User.update_account!(userNew)
 
       guid = new_user.guid
-      # Create array with entered email for set_collaborators! method
+      #Create array with entered email for set_collaborators! method
       emails = [settings.email]
       document = file.to_document
-      # Make request to Ant api for set new user as annotation collaborator
+      #Make request to Ant api for set new user as annotation collaborator
       addCollaborator = document.set_collaborators!(emails)
       getCollaborator = document.collaborators!
       getCollaborator.each do |reviewer|
         reviewer.access_rights = %w(view)
       end
       setReviewers = document.set_reviewers! getCollaborator
+
       if setReviewers
-        case settings.base_path
+        #Add user GUID as "uid" parameter to the iframe URL
+        iframe = "/document-annotation2/embed/#{file.guid}?&uid=#{guid}&download=true"
+        # Construct result string
+        url = GroupDocs::Api::Request.new(:path => iframe).prepare_and_sign_url
+        #Generate iframe URL
+        case base_path
           when 'https://stage-api-groupdocs.dynabic.com'
-            iframe = "https://stage-api-groupdocs.dynabic.com/document-annotation2/embed/#{file.guid}?&uid=#{guid}&download=true"
+            iframe = "https://stage-api-groupdocs.dynabic.com#{url}"
           when 'https://dev-api-groupdocs.dynabic.com'
-            iframe = "https://dev-apps.groupdocs.com//document-annotation2/embed/#{file.guid}?&uid=#{guid}&download=true"
+            iframe = "https://dev-apps.groupdocs.com#{url}"
           else
-            iframe = "https://apps.groupdocs.com//document-annotation2/embed/#{file.guid}?&uid=#{guid}&download=true"
+            iframe = "https://apps.groupdocs.com#{url}"
         end
-        # Construct result string
-        url = GroupDocs::Api::Request.new(:path => iframe).prepare_and_sign_url
-        iframe = "<iframe src='#{url}' width='800' height='1000'></iframe>"
+
+        iframe = "<iframe src='#{iframe}' width='800' height='1000'></iframe>"
       end
     end
 
@@ -123,6 +131,6 @@ post '/sample38' do
     err = e.message
   end
 
-  # set variables for template
-  haml :sample38, :locals => {:userId => settings.client_id, :fileId => file.guid, :privateKey => settings.private_key, :iframe => iframe, :email => settings.email, :firstName => settings.first_name, :lastName => settings.last_name, :err => err}
+  #Set variables for template
+  haml :sample38, :locals => {:userId => settings.client_id, :fileId => settings.file_id, :privateKey => settings.private_key, :iframe => iframe, :email => settings.email, :firstName => settings.first_name, :lastName => settings.last_name, :err => err}
 end