def setFieldProperties( dbid, properties, fid )

      @dbid, @properties, @fid = dbid, properties, fid

      if @properties and @properties.is_a?( Hash )

         xmlRequestData = toXML( :fid, @fid )

         @properties.each{ |key, value|
                              if isValidFieldProperty?( key )
                                 xmlRequestData << toXML( key, value )
                              else
                                 raise "setFieldProperties: Invalid field property '#{key}'.  Valid properties are " + @validFieldProperties.join( "," )
                              end
                         }

         sendRequest( :setFieldProperties, xmlRequestData )
      else
         raise "setFieldProperties: @properties is not a Hash of key/value pairs"
      end

      return self if @chainAPIcalls
      @requestSucceeded
   end
def setFieldProperties( dbid, properties, fid )

      @dbid, @properties, @fid = dbid, properties, fid

      if @properties and @properties.is_a?( Hash )

         xmlRequestData = toXML( :fid, @fid )

         @properties.each{ |key, value|
                              if isValidFieldProperty?( key )
                                 xmlRequestData << toXML( key, value )
                              else
                                 raise "setFieldProperties: Invalid field property '#{key}'.  Valid properties are " + @validFieldProperties.join( "," )
                              end
                         }

         sendRequest( :setFieldProperties, xmlRequestData )
      else
         raise "setFieldProperties: @properties is not a Hash of key/value pairs"
      end

      return self if @chainAPIcalls
      @requestSucceeded
   end
API_SetFieldProperties