Hi Al,
At a high level, the Salesforce connector was designed to allow CA API Gateway customers to integrate their local systems with the SaaS data made available by Salesforce, via exposed Salesforce API's. The connector provides the ability for the Gateway to sign onto Salesforce, and perform a group of fundamental actions against Salesforce and the objects it provides. Users are additionally able to use the API Gateway policy language to further manipulate the data and make decisions based upon it.
Using the solution kit, you should be able to use the Gateway to connect to Salesforce and perform a variety of actions (create object, update object, search, retrieve, execute query, etc). From the use case that you describe above, I'm pretty sure that the Salesforce solution kit would provide what you need.
I had a look at our documentation, and you're right - there is content on how to install the solution kit and configure a connection, but very little additional documentation regarding its capabilities and uses. I will find out if we can expand the existing documentation to be more helpful.
- Aaron