Repository: incubator-unomi Updated Branches: refs/heads/master cb730a228 -> 45ed86e1b
UNOMI-208 Improve documentation - Clarify salesforce setup procedure Signed-off-by: Serge Huber <shu...@apache.org> Project: http://git-wip-us.apache.org/repos/asf/incubator-unomi/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-unomi/commit/45ed86e1 Tree: http://git-wip-us.apache.org/repos/asf/incubator-unomi/tree/45ed86e1 Diff: http://git-wip-us.apache.org/repos/asf/incubator-unomi/diff/45ed86e1 Branch: refs/heads/master Commit: 45ed86e1b2935fd07f95a4045e4e8e80d5438e7d Parents: cb730a2 Author: Serge Huber <shu...@apache.org> Authored: Thu Nov 15 19:55:52 2018 +0100 Committer: Serge Huber <shu...@apache.org> Committed: Thu Nov 15 19:55:52 2018 +0100 ---------------------------------------------------------------------- .../connectors/salesforce-connector.adoc | 24 ++++++++++++++++++-- 1 file changed, 22 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-unomi/blob/45ed86e1/manual/src/main/asciidoc/connectors/salesforce-connector.adoc ---------------------------------------------------------------------- diff --git a/manual/src/main/asciidoc/connectors/salesforce-connector.adoc b/manual/src/main/asciidoc/connectors/salesforce-connector.adoc index d200082..50c0332 100644 --- a/manual/src/main/asciidoc/connectors/salesforce-connector.adoc +++ b/manual/src/main/asciidoc/connectors/salesforce-connector.adoc @@ -18,6 +18,8 @@ Apache Unomi profiles and Salesforce Leads. ==== Getting started +===== Salesforce account setup + . Create a new developer account here: + [source] @@ -49,6 +51,8 @@ Consumer secret (click to see it) click on your user at the top right, select "Settings", the click on "Reset my security token". You will receive an email with the security token. +===== Apache Unomi setup + . You are now ready to configure the Apache Unomi Salesforce Connector. In the etc/org.apache.unomi.sfdc.cfg file change the following settings: + @@ -60,7 +64,12 @@ sfdc.user.securityToken=YOUR_USER_SECURITY_TOKEN sfdc.consumer.key=CONNECTED_APP_CONSUMER_KEY sfdc.consumer.secret=CONNECTED_APP_SECRET ---- -+ + +===== Deployment from Maven repository + +In this procedure we assume you have access to a Maven repository that contains a compiled version of the Salesforce connector. +If this is not the case or you prefer to deploy using a KAR bundle, see the KAR deployment instructions instead. + . Connect to the Apache Unomi Karaf Shell using : + [source] @@ -75,7 +84,18 @@ ssh -p 8102 karaf@localhost (default password is karaf) feature:repo-add mvn:org.apache.unomi/unomi-salesforce-connectors-karaf-kar/${project.version}/xml/features feature:install unomi-salesforce-connectors-karaf-kar ---- -+ + +===== Deployment using KAR bundle + +If you have a KAR bundle (for example after building from source in the `extensions/salesforce-connector/karaf-kar/target` directory), +you can follow these steps to install : + +. Ensure that Apache Karaf and Apache Unomi are started +. Execute the following command in karaf: `feature:install unomi-salesforce-connector-karaf-kar` +. The installation is done ! + +===== Testing the connector + . You can then test the connection to Salesforce by accessing the following URLs: + [source]
