Salesforce Developers Blog

Publish Industry Data to Force.com Apps with Data Services on Heroku

Avatar for Lynn CohenLynn Cohen
Enable your Force.com app customers to subscribe to a centralized data repository powered by Heroku. Learn how to leverage Postgres, encrypted data at rest and process scheduling to secure your data, track subscribers and push data updates to Salesforce orgs.
Publish Industry Data to Force.com Apps with Data Services on Heroku
February 24, 2015
Listen to this article
0:00 / 0:00

Lynn Cohen (@slcohen) enables ISV partners in the Healthcare and Finance industry verticals to build awesome Salesforce1 apps. She has extensive experience in the Healthcare and Life Sciences industry and has worked with top finance firms in the NY, NJ, CT area.

Independent Software Vendors providing industry specific Force.com apps often have valuable data to distribute to their customers for utilization in their apps and other integrated solutions, such as Sales and Service Cloud, on the Salesforce.com platform. A hub and spoke architecture is an efficient approach to support this data-based business model: master data is curated and managed on a central system and customers subscribe to the data service and receive periodic refreshes of the data in their Salesforce.com orgs.

Reference Architecture

While the Force.com platform provides everything needed to build compelling mobile and desktop apps, Heroku supplies infrastructure for highly scalable and available services. As an illustration of applying Force.com and Heroku to the data subscription business model, an open-source reference architecture is available for download which implements a central repository of Physician data, a common use-case in the Healthcare industry. The reference architecture consists of 5 components:

On Heroku

  1. Web server for maintaining Physician records, registering Salesforce.com orgs with the subscription service, and responding to RESTful requests from Salesforce.com orgs.
  2. Refresh worker process to push updated Physician records to subscribed orgs.
  3. Heroku Scheduler, an optional Heroku add-on, similar to cron jobs on Unix. The Scheduler can be used for automatically running the Refresh worker process.
  4. Postgres database with encryption-at-rest extension.

On Salesforce.com

  1. Force.com app implementing the subscription workflow and maintaining a local copy of Physician records.

Image_2_wlgh5d

How Does the Data Flow?

The data flow of Physician records is illustrative of the general data subscription pattern:

  1. Users of the Force.com app search for Physicians, the data service returns matching records, and then the user selects which records meet their criteria and subscribes to those records.
  2. The data service tracks subscriptions to Physician records at an org-ID + Physician-record-ID level of granularity.
  3. Periodically, the data service scans the master list of Physician records for updates and distributes those updates to the subscribed orgs. This refresh process tracks the last update to each org for each Physician record to minimize the amount of data pushed to each org.

Image_1_wti6ka

Scalability

Web server processes run within a dyno (virtual Linux server) on Heroku, and the number of dynos can be scaled to match HTTP request load. The dyno manager, part of the Heroku platform, automatically spins web server processes up and down and load balances HTTP requests across dynos.

Web server applications should be written to be stateless, which is particularly important when process startup/shutdown and routing of requests is managed by the infrastructure. This reference architecture uses Postgres as the persistent store for all application state as well as the central repository of Physician records. By choosing from one of many Heroku Postgres plans and add-ons, the required level of availability and performance is also configurable.

The web server and refresh processes are both written in node.js using the Express framework as well as other open source modules for Salesforce.com API calls and Postgres interactions. Non-blocking I/O is a core-coding paradigm in node.js, which further leads to more responsive systems.

Searching

Searching and matching people information is a large body of knowledge in itself. The supplied reference architecture supports common search use cases (name, postal code), but Postgres add-ons are available for more sophisticated searching.  The pg_trgm add-on provides functions and operators for determining similarity of text based on trigrams (three consecutive characters).  Similarly, the fuzzystrmatch add-on provides functions for determining similarity of text using soundex, metaphone, and other methods.

How to Get the Reference Architecture

The reference architecture is available as open source on github. Using git, clone the following repository and follow the installation instructions in the README file:

https://github.com/lcohensf/heroku-datasub.git

Source code for the Force.com app is available in the following repository:

https://github.com/lcohensf/force-datasub.git

Get the latest Salesforce Developer blog posts and podcast episodes via Slack or RSS.

Add to Slack Subscribe to RSS

More Blog Posts

The Wait Is Over: The GraphQL Wire Adapter for LWC Is Now Generally Available

The Wait Is Over: The GraphQL Wire Adapter for LWC Is Now Generally Available

The GA release of the GraphQL Wire Adapter promises to make data management in LWCs not just possible, but a breeze.September 27, 2023

Introducing the BiometricsService Mobile Capability

Introducing the BiometricsService Mobile Capability

The BiometricsService mobile capability enables developers to add additional security measures to the data being stored on LWCs.April 30, 2024

How to Use the Amazon Kinesis Connector in Data Cloud

How to Use the Amazon Kinesis Connector in Data Cloud

Start ingesting event and profile data from Amazon Kinesis using the Amazon Kinesis Connector in Data Cloud.June 06, 2024