On-Premise API Gateway and Salesforce

#   _____           _              _____        __      
#  |  __ \         (_)            |_   _|      / _|     
#  | |__) |___  ___ _ _ __   ___    | |  _ __ | |_ ___  
#  |  _  // _ \/ __| | '_ \ / _ \   | | | '_ \|  _/ _ \ 
#  | | \ \  __/ (__| | |_) |  __/  _| |_| | | | || (_) |
#  |_|  \_\___|\___|_| .__/ \___| |_____|_| |_|_| \___/ 
#                    | |                                
#                    |_|

# Project Name -  ON-PREMISE API GATEWAY AND SALESFORCE

# Recipe URL - https://app.lingk.io/a/10932/tf/17469

# Description - # This recipe connects on-premise databases such as Oracle and MS SQL Server to Salesforce. 
# Using this recipe, you can pull data from ERPs like Ellucian Colleague, Ellucian Banner, Anthology Student, Oracle Campus Solutions, and more... 
# After configuring the on-premise gateway and the environment with Salesforce, click Run.

# Industry - Higher Ed
# Business Process - Graduate Reporting

# Systems - On-Premise, Salesforce
# Connectors - HTTP, Salesforce
# Data Flows - Single Direction
# Connection Type - API to API

# Salesforce Objects
#1. Contact

# Add Recipe notes / Change log information here!

#    _____                            _                 
#   / ____|                          | |                
#  | |     ___  _ __  _ __   ___  ___| |_ ___  _ __ ___ 
#  | |    / _ \| '_ \| '_ \ / _ \/ __| __/ _ \| '__/ __|
#  | |___| (_) | | | | | | |  __/ (__| || (_) | |  \__ \
#   \_____\___/|_| |_|_| |_|\___|\___|\__\___/|_|  |___/
#

# CONNECTORS specify what data will be pulled into the in-memory database during processing

connectors:

# Configure HTTP & Salesforce credentials in your Environment before running this recipe
  # HTTP Setup - https://help.lingk.io/en/articles/304-http-connector-setup-guide
  # Salesforce Setup - https://help.lingk.io/en/articles/267-salesforce-connector-setup-guide

###### Start - HTTP Reader connectors ######

- name: onPremEmployees
    type: httpReader
    properties: 
      url: https://onprem.somewhwere.com:2341/employees # replace url with the personalized one
      httpMethod: GET

###### End - HTTP Reader connectors ######

###### Start - Salesforce Reader connectors ######

- name: sfEmployees
    type: salesforceReader
    properties: 
      useBearerToken: true # use credentials from the environment
      query: |
          SELECT Id, FirstName, LastName, Email, Lingk_External_Id__c
          FROM Contact

###### End - Salesforce Reader connectors ######

###### Start - Salesforce Writer connectors ######

- name: sfEmployeeWriter
    type: salesforceBulkWriter
    properties: 
      onError: continue
      useBearerToken: true # use credentials from the environment
      sfObject: Contact
      upsert: true
      externalIdFieldName: Lingk_External_Id__c

###### End - Salesforce Writer connectors ######

#    _____ _        _                            _       
#   / ____| |      | |                          | |      
#  | (___ | |_ __ _| |_ ___ _ __ ___   ___ _ __ | |_ ___ 
#   \___ \| __/ _` | __/ _ \ '_ ` _ \ / _ \ '_ \| __/ __|
#   ____) | || (_| | ||  __/ | | | | |  __/ | | | |_\__ \
#  |_____/ \__\__,_|\__\___|_| |_| |_|\___|_| |_|\__|___/

# STATEMENTS specify how the data should be processed while in memory

statements:

#******************************************************************** D I S C L A I M E R ***********************************************************************************************
#                                                                                                                                                                                       * 
# Note that in an effort to keep recipes optimized for DPH (Data Processing Hours), print statements should be commented out after development has concluded for a recipe.              *
# For more information on DPH optimization, please visit the following help article - https://help.lingk.io/en/articles/212-minimizing-data-processing-hours-on-the-lingk-platform      *
#                                                                                                                                                                                       * 
#******************************************************************** D I S C L A I M E R ***********************************************************************************************

# NOTE: You can add trasformations into your

#- statement: print onPremEmployees

- statement: |
      (sfDataset) => SELECT	
          Email,
          EmployeeID  Lingk_External_Id__c,
          FirstName,
          LastName
          FROM onPremEmployees

#- statement: print sfDataset 
  #### Start - Insert Contact/Employee ####

- statement: (results, errors) => INSERT sfDataset INTO sfEmployeeWriter

#### End - Insert Contact/Employee ####

#- statement: print results   
  #- statement: print errors

# Add more statements to convert, join, aggregrate, transform, and integrate your data