quickbase_client 1.0.17 → 1.0.18

data/CHANGES

@@ -1,5 +1,7 @@
 == Change History
 
+1.0.18 - 09/16/2011 - editRecord() now supports using optional key field as a record identifier.
+
 1.0.17 - 09/05/2011 - Added getFileDownloadURL().
 
 1.0.16 - 07/14/2011 - Added support for new API_CopyMasterDetail call.

data/README.rdoc

@@ -31,6 +31,10 @@ More information about the QuickBase Client is available here -
 
 == Change History
 
+1.0.18 - 09/16/2011 - editRecord() now supports using optional key field as a record identifier.
+
+1.0.17 - 09/05/2011 - Added getFileDownloadURL().
+
 1.0.16 - 07/14/2011 - Added support for new API_CopyMasterDetail call.
 
 1.0.15 - 06/02/2011 - Fixed downloadFile problem caused by httpclient update.

data/lib/QuickBaseClient.rb

@@ -41,7 +41,7 @@ class Client
    attr_reader :email, :errcode, :errdetail, :errtext, :excludeparents, :externalAuth, :fform
    attr_reader :fid, :fids, :field, :fields, :field_data, :field_data_list, :fieldTypeLabelMap, :fieldValue, :fileContents, :fileUploadToken, :firstName, :fmt, :fname, :fnames, :fvlist
    attr_reader :hours, :HTML, :httpConnection, :id, :ignoreError, :includeancestors 
-   attr_reader :jht, :jsa, :key_fid, :keepData, :label, :lastAccessTime
+   attr_reader :jht, :jsa, :key_fid, :key, :keepData, :label, :lastAccessTime
    attr_reader :lastError, :lastModifiedTime, :lastName, :lastPaymentDate, :lastRecModTime, :login
    attr_reader :mgrID, :mgrName, :mode, :modify, :name
    attr_reader :newappname, :newowner, :newdbdesc, :newdbid, :newdbname
@@ -2191,12 +2191,13 @@ class Client
    alias _downloadFile _downLoadFile
    
    # API_EditRecord
-   def editRecord( dbid, rid, fvlist, disprec = nil, fform = nil, ignoreError = nil, update_id = nil, msInUTC =nil )
+   def editRecord( dbid, rid, fvlist, disprec = nil, fform = nil, ignoreError = nil, update_id = nil, msInUTC =nil, key = nil )
 
-      @dbid, @rid, @fvlist, @disprec, @fform, @ignoreError, @update_id, @msInUTC = dbid, rid, fvlist, disprec, fform, ignoreError, update_id, msInUTC
+      @dbid, @rid, @fvlist, @disprec, @fform, @ignoreError, @update_id, @msInUTC, @key = dbid, rid, fvlist, disprec, fform, ignoreError, update_id, msInUTC, key
       setFieldValues( fvlist, false ) if fvlist.is_a?(Hash) 
 
-      xmlRequestData = toXML( :rid, @rid )
+      xmlRequestData = toXML( :rid, @rid ) if @rid
+      xmlRequestData = toXML( :key, @key ) if @key
       @fvlist.each{ |fv| xmlRequestData << fv } #see addFieldValuePair, clearFieldValuePairList, @fvlist
       xmlRequestData << toXML( :disprec, @disprec ) if @disprec
       xmlRequestData << toXML( :fform, @fform ) if @fform
@@ -3038,9 +3039,9 @@ class Client
    # -----------------------------------------------------------------------------------------------
    
    # Use this if you aren't sure whether a particular record already exists or not
-   def addOrEditRecord( dbid, fvlist, rid = nil, disprec = nil, fform = nil, ignoreError = nil, update_id = nil  )
-      if rid
-        editRecord( dbid, rid, fvlist, disprec, fform, ignoreError, update_id )
+   def addOrEditRecord( dbid, fvlist, rid = nil, disprec = nil, fform = nil, ignoreError = nil, update_id = nil, key = nil  )
+      if rid or key
+        editRecord( dbid, rid, fvlist, disprec, fform, ignoreError, update_id, key )
         if !@requestSucceeded
           addRecord( dbid, fvlist, disprec, fform, ignoreError, update_id )
         end
@@ -3159,13 +3160,14 @@ class Client
 
    # Change a named field's value in the active record.
    # e.g. setFieldValue( "Location", "Miami" )
-   def setFieldValue( fieldName, fieldValue, dbid = nil, rid = nil )
+   def setFieldValue( fieldName, fieldValue, dbid = nil, rid = nil, key =nil )
       @dbid ||= dbid
       @rid ||= rid
-      if @dbid and @rid
+      @key ||= key
+      if @dbid and (@rid or @key)
          clearFieldValuePairList
          addFieldValuePair( fieldName, nil, nil, fieldValue )
-         editRecord( @dbid, @rid, @fvlist )
+         editRecord( @dbid, @rid, @fvlist, nil, nil, nil, nil, nil, @key )
       end
    end
 
@@ -3177,8 +3179,8 @@ class Client
           fields.each{ |fieldName,fieldValue|
              addFieldValuePair( fieldName, nil, nil, fieldValue )
           }
-          if editRecord and @dbid and @rid
-            editRecord( @dbid, @rid, @fvlist )
+          if editRecord and @dbid and (@rid or @key)
+            editRecord( @dbid, @rid, @fvlist, nil, nil, nil, nil, nil, @key )
           end
       end
    end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: quickbase_client
 version: !ruby/object:Gem::Version
-  version: 1.0.17
+  version: 1.0.18
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-09-05 00:00:00.000000000Z
+date: 2011-09-16 00:00:00.000000000Z
 dependencies: []
 description: Wraps the QuickBase HTTP API and adds classes and methods to minimize
   the amount of code needed to get useful things done. This is a minimal subset of