quickbase_client 1.0.21 → 1.0.22

data/CHANGES

@@ -1,5 +1,9 @@
 == Change History
 
+1.0.22 - 11/17/2012 - Added downloadAndSaveFile, uploadFileContents.
+
+1.0.21 - 05/28/2012 - Changed gem homepage to github.
+
 1.0.20 - 11/18/2011 - Added optional dfid param to getRecordAsHTML.
 
 1.0.19 - 11/13/2011 - Accommodate Net::HTTP changes in Ruby 1.9.3.

data/README.rdoc

@@ -28,6 +28,8 @@ More information about the QuickBase Client is available here -
 
 == Change History
 
+1.0.22 - 11/17/2012 - Added downloadAndSaveFile, uploadFileContents.
+
 1.0.21 - 05/28/2012 - Changed gem homepage to github.
 
 1.0.20 - 11/18/2011 - Added optional dfid param to getRecordAsHTML.
@@ -55,7 +57,7 @@ See CHANGES file for earlier updates.
 
 == Questions?
 
-Please submit questions, feedback, suggestions on Intuit's Community Forum at http://community.intuit.com/categories/contents/10298?content_view_type=ALL&sort=2 .
+Please submit questions, feedback, suggestions on Intuit's Community Forum at https://quickbase-community-e2e.intuit.com .
 
 == License
 

data/lib/QuickBaseClient.rb

@@ -2196,6 +2196,24 @@ class Client
    alias downloadFile downLoadFile
    alias _downloadFile _downLoadFile
    
+   # Download and save a file from a file attachment field in QuickBase.
+   # Use the filename parameter to override the file name from QuickBase.
+   def downloadAndSaveFile( dbid, rid, fid, filename = nil, vid = "0"  )
+      response, fileContents = downLoadFile( dbid, rid, fid, vid )
+      if fileContents and fileContents.length > 0
+         if filename and filename.length > 0
+            Misc.save_file( filename, fileContents )
+         else
+            record = getRecord( rid, dbid, [fid] )
+            if record and record[fid] and record[fid].length > 0
+               Misc.save_file( record[fid], fileContents )
+            else
+               Misc.save_file( "#{dbid}_#{rid}_#{fid}", fileContents )
+            end
+         end
+      end
+   end
+   
    # API_EditRecord
    def editRecord( dbid, rid, fvlist, disprec = nil, fform = nil, ignoreError = nil, update_id = nil, msInUTC =nil, key = nil )
 
@@ -4535,6 +4553,23 @@ class Client
       nil
    end
    
+   # Add a File Attachment into a new record in a table, using a string containing the file contents.
+   # Additional field values can optionally be set.
+   # e.g. uploadFile( "dhnju5y7", "contacts.txt", "fred: 1-222-333-4444", "Contacts File", { "Notes" => "#{Time.now}" }
+   def uploadFileContents( dbid, filename, fileContents, fileAttachmentFieldName, additionalFieldsToSet = nil )
+      if dbid and filename and fileAttachmentFieldName
+         clearFieldValuePairList
+         addFieldValuePair( fileAttachmentFieldName, nil, filename, fileContents )
+         if additionalFieldsToSet and additionalFieldsToSet.is_a?( Hash )
+            additionalFieldsToSet.each{ |fieldName,fieldValue|
+               addFieldValuePair( fieldName, nil, nil, fieldValue )
+            }
+         end
+         return addRecord( dbid, @fvlist )
+      end
+      nil
+   end
+   
    # Upload a file into a new record in the active table.
    # e.g. uploadFile( "contacts.txt", "Contacts File" )
    def _uploadFile( filename, fileAttachmentFieldName )

data/lib/QuickBaseMisc.rb

@@ -94,11 +94,24 @@ module QuickBase
     
     def Misc.listUserToArray(listUser)
       listUser.split(/;/)
-    end	    
+    end
     
     def Misc.arrayToListUser(array)
       array.join(";")
-    end	    
+    end
+    
+   def Misc.save_file(filename, contents, mode="wb")
+      File.open(filename, mode){|f|
+         f.write(contents)
+         f.flush
+      }
+      rescue StandardError => error
+      new_filename = filename.gsub(/\W/,"_")
+      File.open(new_filename, mode){|f|
+         f.write(contents)
+         f.flush
+      }
+   end
        
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: quickbase_client
 version: !ruby/object:Gem::Version
-  version: 1.0.21
+  version: 1.0.22
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-28 00:00:00.000000000 Z
+date: 2012-11-17 00:00:00.000000000 Z
 dependencies: []
 description: Wraps the QuickBase HTTP API and adds classes and methods to minimize
   the amount of code needed to get useful things done.