groupdocs 1.5.7 → 1.5.8

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

@@ -0,0 +1,58 @@
+# GET request
+get '/sample36' do
+  haml :sample36
+end
+
+
+
+
+# POST request
+post '/sample36' do
+  # Set variables
+  set :client_id, params[:clientId]
+  set :private_key, params[:privateKey]
+  set :envelope, params[:envelopeGuid]
+  set :base_path, params[:basePath]
+
+  # Set download path
+  downloads_path = "#{File.dirname(__FILE__)}/../public/downloads"
+
+  # 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?
+
+    if settings.base_path.empty? then settings.base_path = 'https://api.groupdocs.com' end
+
+    # 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'
+    end
+
+    # Get envelope from GroupDocs Storage
+    envelope = GroupDocs::Signature::Envelope.get!(settings.envelope)
+
+    #Download signed files
+    path = envelope.signed_documents!(downloads_path)
+
+    #Get file name
+    file = path.split('/').last
+
+    message = "<span style=\"color:green\">Files from the envelope were downloaded to server's local folder. You can check them <a href=\"/downloads/#{file}\">here</a></span>"
+  rescue Exception => e
+    err = e.message
+  end
+
+  # 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

@@ -0,0 +1,229 @@
+# Route the handler url "/sample37"
+get '/sample37' do
+  haml :sample37
+end
+
+# GET request
+
+# 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
+  name = nil
+ 
+  i = 0
+
+  # 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	  
+      break if name
+      i += 1
+    end
+
+  name
+end
+
+# Route the handler url "/sample37/downloads"
+get '/sample37/downloads/:filename' do |filename|
+  # 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
+post '/sample37' do
+  # Set variables from form
+  set :client_id, params[:clientId]
+  set :private_key, params[:privateKey]
+  set :email, params[:email]
+  set :name, params[:name]
+  set :lastName, params[:lastName]
+  set :fileId, params[:fileId]
+  set :callback, params[:callback]
+  set :base_path, params[:basePath]
+  set :url, params[:url]
+  set :source, params[:source]
+
+  # Set download path
+  downloads_path = "#{File.dirname(__FILE__)}/../public/downloads"
+
+  # 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.name.empty? or settings.lastName.empty?
+
+    if settings.base_path.empty? then settings.base_path = 'https://api.groupdocs.com' end
+
+    # 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'
+    end
+
+    # 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
+      out_file.write("#{settings.client_id} ")
+      out_file.write("#{settings.private_key}")
+      out_file.close
+    end
+
+    file = nil
+    # get document by file GUID
+    case settings.source
+      when 'guid'
+        # 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
+        file_path = "#{Dir.tmpdir}/#{params[:file][:filename]}"
+
+        # 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
+      when '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
+    envelope = GroupDocs::Signature::Envelope.new
+    envelope.name = file.name
+    envelope.email_subject = 'Sing this!'
+    envelope.create!({})
+
+    # Add uploaded document to envelope
+    envelope.add_document!(file, {})
+
+    # Get role list for current user
+    roles = GroupDocs::Signature::Role.get!({})
+
+    # 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]
+
+    # Get document id
+    document = envelope.documents!
+
+
+    # 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
+    envelope.add_field!(field, document[0], recipient)
+
+
+
+    # Send envelop
+    envelope.send!({:callbackUrl => settings.callback})
+
+    # 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
+      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
+
+      when 'https://stage-api-groupdocs.dynabic.com'
+        url = "http://stage-apps-groupdocs.dynabic.com/signature/signembed/#{envelope.id}/#{recipient.id}"
+      when 'https://dev-api-groupdocs.dynabic.com'
+        url = "http://dev-apps-groupdocs.dynabic.com/signature/signembed/#{envelope.id}/#{recipient.id}"
+      else
+        url = "https://apps.groupdocs.com/signature/signembed/#{envelope.id}/#{recipient.id}"
+    end
+
+
+    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
+  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

@@ -0,0 +1,128 @@
+# GET request
+get '/sample38' do
+  haml :sample38
+end
+
+
+
+
+# POST request
+post '/sample38' do
+  # Set variables
+  set :client_id, params[:clientId]
+  set :private_key, params[:privateKey]
+  set :email, params[:email]
+  set :source, params[:source]
+  set :file_id, params[:fileId]
+  set :url, params[:url]
+  set :first_name, params[:firstName]
+  set :last_name, params[:lastName]
+  set :base_path, params[:basePath]
+  #raise params.to_yaml
+  # Set download path
+  downloads_path = "#{File.dirname(__FILE__)}/../public/downloads"
+
+  # 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?
+
+    if settings.base_path.empty? then settings.base_path = 'https://api.groupdocs.com' end
+
+    # 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'
+    end
+
+    # Get document by file GUID
+    case settings.source
+      when 'guid'
+        # Create instance of File
+        file = GroupDocs::Storage::File.new({:guid => settings.file_id})
+      when 'local'
+        # Construct path
+        file_path = "#{Dir.tmpdir}/#{params[:file][:filename]}"
+        # 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, {})
+      when 'url'
+        # Upload file from defined url
+        file = GroupDocs::Storage::File.upload_web!(settings.url)
+      else
+        raise 'Wrong GUID source.'
+    end
+
+    #Get all users from accaunt
+    user = GroupDocs::User.get!
+    userGuid = nil
+    users = user.users!
+    users.map do |user|
+      email = user.primary_email
+      # Check whether there is a user with entered email
+      if settings.email == email
+        # 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
+    if userGuid.nil?
+      userNew = GroupDocs::User.new
+      # Set email as entered email
+      userNew.primary_email = settings.email
+      # Set nick name as entered first name
+      userNew.nickname = settings.email
+      # Set first name as entered first name
+      userNew.firstname = settings.first_name
+      # Set last name as entered last name
+      userNew.lastname = settings.last_name
+      # Set roles
+      userNew.roles = [{:id => '3', :name => 'User'}]
+
+      # Update account
+      new_user = GroupDocs::User.update_account!(userNew)
+
+      guid = new_user.guid
+      # 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
+      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
+          when 'https://stage-api-groupdocs.dynabic.com'
+            iframe = "https://stage-api-groupdocs.dynabic.com/document-annotation2/embed/#{file.guid}?&uid=#{guid}&download=true"
+          when 'https://dev-api-groupdocs.dynabic.com'
+            iframe = "https://dev-apps.groupdocs.com//document-annotation2/embed/#{file.guid}?&uid=#{guid}&download=true"
+          else
+            iframe = "https://apps.groupdocs.com//document-annotation2/embed/#{file.guid}?&uid=#{guid}&download=true"
+        end
+        # Construct result string
+        url = GroupDocs::Api::Request.new(:path => iframe).prepare_and_sign_url
+        iframe = "<iframe src='#{url}' width='800' height='1000'></iframe>"
+      end
+    end
+
+  rescue Exception => e
+    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}
+end

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

@@ -0,0 +1,252 @@
+ # GET request
+get '/sample39' do
+  haml :sample39
+end
+
+ # GET request
+get '/popup' do
+  haml :popup
+end
+
+ # POST request
+post '/sample39/signature_callback' do
+  begin
+     # Get callback request
+    data = JSON.parse(request.body.read)
+
+    raise 'Empty params!' if data.empty?
+    source_id = nil
+    client_id = nil
+    private_key = nil
+
+     # Get value of SourceId
+    data.each do |key, value|
+      if key == 'SourceId'
+        source_id = value
+      end
+    end
+
+     # 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.first
+      private_key = contents.last
+    end
+
+     # Create Job instance
+    job = GroupDocs::Signature::Envelope.new({:id => source_id})
+
+     # Get document by job id
+    documents = job.documents!({}, {:client_id => client_id, :private_key => private_key}).first
+
+     # Get guid from file
+    guid = documents.file.guid
+
+     # Create new file callback_info.txt and write the guid document
+    out_file = File.new("#{File.dirname(__FILE__)}/../public/callback_info.txt", 'w')
+     # White space is required
+    out_file.write("#{guid}")
+    out_file.close
+
+  rescue Exception => e
+    err = e.message
+  end
+end
+
+ # POST request
+post '/sample39/check' do
+  begin
+    result = nil
+    i = 0
+    for i in 1..10
+      i +=1
+
+       # Check is downloads folder exist
+      if File.exist?("#{File.dirname(__FILE__)}/../public/callback_info.txt")
+        result = File.read("#{File.dirname(__FILE__)}/../public/callback_info.txt")
+        if result.nil? then break  end
+      end
+      sleep(5)
+    end
+
+    # Check result
+    if result == 'Error'
+      result = "File was not found. Looks like something went wrong."
+    else
+      result
+    end
+
+  rescue Exception => e
+    err = e.message
+  end
+end
+
+
+# POST request
+post '/sample39/postdata' do
+
+  data = request.body.read
+   # Decode ajax data
+  json_post_data = JSON.parse(data);
+   # Get Client ID
+  clientId = json_post_data['userId'];
+   # Get Private Key
+  privateKey = json_post_data['privateKey'];
+   #Get document for sign
+  documents = json_post_data['documents'];
+   # Get signature file
+  signers = json_post_data['signers'];
+  def strict_decode64(str)
+    str.unpack("m0").first
+  end
+   # Documents local path
+  document_path = "#{File.dirname(__FILE__)}/../public/downloads/#{documents[0]['name']}"
+  signer_path = "#{File.dirname(__FILE__)}/../public/downloads/#{signers[0]['name']}.png"
+
+   # Get base64 string
+  base64_documents = documents[0]['data'].split(',').last
+  base64_signers = signers[0]['data'].split(',').last
+
+   # Write to the files decode base64 strings
+  File.open(document_path, 'wb') do |f|
+    f.write(Base64.strict_decode64(base64_documents))
+  end
+
+  File.open(signer_path, 'wb') do |f|
+    f.write(Base64.strict_decode64(base64_signers))
+  end
+
+   # Set document for signing
+  documents = GroupDocs::Storage::File.new(:name=>documents[0]['name'], :local_path=>document_path).to_document
+   # Set signature
+  signers = GroupDocs::Signature.new(:name=>signers[0]['name'], :image_path=>signer_path)
+  signers.position = {top: 0.83319, left: 0.72171, width: 100, height: 40}
+
+   # Make request to sign documnet
+  signDocument = GroupDocs::Document.sign_documents!([documents], [signers], {}, {:client_id=>clientId, :private_key=>privateKey})
+  sleep(5)
+   # Get the document guid
+  document = GroupDocs::Signature.sign_document_status!(signDocument, {:client_id=>clientId, :private_key=>privateKey})
+   # Get file GUID
+  guid = document.guid
+   # Create array with result data
+  result = ['guid' => guid,'clientId' => clientId,'privateKey' => privateKey]
+   # Decode array to json and return json string to ajax request
+  result.to_json
+end
+
+
+# POST request
+post '/sample39' do
+  # set variables
+  set :client_id, params[:clientId]
+  set :private_key, params[:privateKey]
+  set :name, params[:name]
+  set :email, params[:email]
+  set :callback, params[:callbackUrl]
+  set :last_name, params[:lastName]
+
+   # Set download path
+  downloads_path = "#{File.dirname(__FILE__)}/../public/downloads"
+
+   # 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.name.empty? or settings.email.empty? or settings.last_name.empty?
+
+     # Configure your access to API server
+    GroupDocs.configure do |groupdocs|
+      groupdocs.client_id = settings.client_id
+      groupdocs.private_key = settings.private_key
+    end
+
+     # Write client and private key to the file for callback job
+    if settings.callback[0]
+      out_file = File.new("#{File.dirname(__FILE__)}/../public/user_info.txt", 'w')
+       # white space is required
+      out_file.write("#{settings.client_id} ")
+      out_file.write("#{settings.private_key}")
+      out_file.close
+    end
+
+     # Construct path
+    file_path = "#{Dir.tmpdir}/#{params[:file][:filename]}"
+     # 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)
+    document = file.to_document
+
+
+    # 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
+    envelope.add_document!(document)
+
+    # Get role list for current user
+    roles = GroupDocs::Signature::Role.get!
+
+    # Create new recipient
+    recipient = GroupDocs::Signature::Recipient.new
+    recipient.email = settings.email
+    recipient.first_name = settings.name
+    recipient.last_name = settings.last_name
+    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]
+
+    # Get document id
+    document = envelope.documents!()
+
+
+    # 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
+    envelope.add_field!(field, document[0], recipient, {})
+
+
+    # Send envelop
+    envelope.send!({:callbackUrl => settings.callback})
+
+
+     #Get url from request
+    url = "https://apps.groupdocs.com/signature/signembed/#{envelope.id}/#{recipient.id}"
+
+    iframe = GroupDocs::Api::Request.new(:path => url).prepare_and_sign_url
+    # Make iframe
+    iframe = "<iframe id='downloadframe' src='#{iframe}' width='800' height='1000'></iframe>"
+
+
+  rescue Exception => e
+    err = e.message
+  end
+
+  # set variables for template
+  haml :sample39, :locals => {:userId => settings.client_id,
+                              :privateKey => settings.private_key,
+                              :callback => settings.callback,
+                              :email => settings.email,
+                              :name => settings.name,
+                              :lastName => settings.last_name,
+                              :iframe => iframe,
+                              :err => err}
+end
+