Added upsert

Author: Pat Patterson

README.markdown

@@ -8,7 +8,7 @@ Background
 
 Due to the [same origin policy](http://en.wikipedia.org/wiki/Same_origin_policy), JavaScript running in Visualforce pages may not use [XmlHttpRequest](http://en.wikipedia.org/wiki/XMLHttpRequest) to directly invoke the REST API, since Visualforce pages have hostnames of the form abc.na1.visual.force.com, and the REST API endpoints are of the form na1.salesforce.com.
 
-The RemoteTK Visualforce Custom Component (comprising RemoteTK.component and RemoteTKController.cls) provides an abstraction very similar to the REST API, implemented via `@RemoteAction` methods in the component's controller. The advantage of this mechanism is that no API calls are consumed. A disadvantage is that upsert is not currently implemented.
+The RemoteTK Visualforce Custom Component (comprising RemoteTK.component and RemoteTKController.cls) provides an abstraction very similar to the REST API, implemented via `@RemoteAction` methods in the component's controller. The advantage of this mechanism is that no API calls are consumed.
 
 Alternatively, the ForceTK JavaScript library works around the same origin restriction by using the [AJAX Proxy](http://www.salesforce.com/us/developer/docs/ajax/Content/sforce_api_ajax_queryresultiterator.htm#ajax_proxy) to give full access to the REST API. Since the AJAX proxy is present on all
 Visualforce hosts with an endpoint of the form https://abc.na1.visual.force.com/services/proxy, our Visualforce-hosted JavaScript can invoke it, passing the desired resource URL in an HTTP header. A drawback here is that using the REST API, even from a Visualforce page, consumes API calls.

RemoteTK.component

@@ -83,7 +83,7 @@ if (remotetk.Client === undefined) {
      * Creates a new record of the given type.
      * @param objtype object type; e.g. "Account"
      * @param fields an object containing initial field names and values for 
-     *               the record, e.g. {:Name "salesforce.com", :TickerSymbol 
+     *               the record, e.g. {Name: "salesforce.com", TickerSymbol: 
      *               "CRM"}
      * @param callback function to which response will be passed
      * @param [error=null] function to which jqXHR will be passed in case of error
@@ -113,34 +113,32 @@ if (remotetk.Client === undefined) {
         });
     }
 
-    /* NOT YET IMPLEMENTED!!!
+    /* 
      * Upsert - creates or updates record of the given type, based on the 
      * given external Id.
      * @param objtype object type; e.g. "Account"
      * @param externalIdField external ID field name; e.g. "accountMaster__c"
      * @param externalId the record's external ID value
      * @param fields an object containing field names and values for 
-     *               the record, e.g. {:Name "salesforce.com", :TickerSymbol 
+     *               the record, e.g. {Name: "salesforce.com", TickerSymbol: 
      *               "CRM"}
      * @param callback function to which response will be passed
      * @param [error=null] function to which jqXHR will be passed in case of error
      */
-    /*
     remotetk.Client.prototype.upsert = function(objtype, externalIdField, externalId, fields, callback, error) {
         Visualforce.remoting.Manager.invokeAction('$RemoteAction.RemoteTKController.upser', objtype, externalIdField, externalId, JSON.stringify(fields), function(result){
             handleResult(result, callback, error, true);
         }, { 
                 escape: false
         });
     }
-    */
 
     /*
      * Updates field values on a record of the given type.
      * @param objtype object type; e.g. "Account"
      * @param id the record's object ID
      * @param fields an object containing initial field names and values for 
-     *               the record, e.g. {:Name "salesforce.com", :TickerSymbol 
+     *               the record, e.g. {Name: "salesforce.com", TickerSymbol: 
      *               "CRM"}
      * @param callback function to which response will be passed
      * @param [error=null] function to which jqXHR will be passed in case of error

RemoteTKController.cls

@@ -145,7 +145,6 @@ public class RemoteTKController {
         return JSON.serialize(records[0]);
     }
 
-    /*
     @remoteAction
     public static String upser(String objtype, String externalIdField, String externalId, String fields) {
         Schema.SObjectType targetType = Schema.getGlobalDescribe().get(objtype);
@@ -161,11 +160,10 @@ public class RemoteTKController {
 
         Schema.SObjectField sobjField = targetType.getDescribe().fields.getMap().get(externalIdField);
 
-        // Database.Upsert(obj, sobjField); // error - upsert requires a concrete sobject type
+        Database.Upsert(obj, sobjField);
 
         return null;
     }
-    */
 
     @remoteAction
     public static String updat(String objtype, String id, String fields) {