2. TN19-TCI: Integration and API management using TIBCO Cloud™ Integration
Jeff Levetin - Customer Success Engineer
Serge Bagi - Sr. Director, Education Content

4. Agenda 2+ hours for slides and labs TCI Scribe - Functionality
Application overview
Integration and event services
Core concepts
TCI Scribe - Architecture
Cloud services
TCI Scribe platform API
Connectivity via the SDK

5. Agenda - continued Lab A - Setup and Overview of TCI Scribe
Connectivity, Configuration, and Security
Lab B - Build an Integration from MySQL to Salesforce
Use Query pattern and on demand Integration
Integrate two entities in a single process map
Lab C - Combine Mashery API Management with TCI Scribe
Use Request / Reply pattern
Add API management with Mashery
Test using Postman
Lab D/E - Build an Integration from Salesforce to MySQL
Use Message pattern
Configure in Salesforce

6. TCI Scribe - Overview
The Connect Capability of TIBCO Cloud Integration (TCI)
Manage, Connect, Integrate, Develop
HTML 5 Design Studio, Platform API, and SDK
Suitable for range of users from Citizen Integrator to Developer
Life Cycle Management
Execution history, notification, reprocess failed records
Export / Import maps as JSON for versioning, moving from dev to prod
Other Functionality
Local file storage with built in lookup, cloud hosted lookup tables
Debugging

7. Query and Event Based Integrations
Integration Solution
Query based integration process - data retrieved via outbound query
Triggered by: scheduler, UI, or call to Platform API (api.scribesoft.com)
Event Solutions
Event based integration process - data delivered via HTTPS / REST
Triggered by external system calling Event endpoint (endpoint.scribesoft.com/…)
Message Map
Asynchronous
Parallel execution with auto scaling
Request / Reply Map
Synchronous
HTTPS call returns JSON

8. TCI Scribe - Agents, Connections, Solutions, Maps
Organization
Cloud Agent (Metadata)
Map
Connection
Cloud Agent
(Solution)
Solution
SFDC
Map
Connection
On Premise Agent
Solution
Map
Marketo
Connection
Map
MSSQL
Solution
Connection
Map
.txt (local)

9. Key Concepts Organization Agent Connection
Account / Namespace for integration environment
Agent
Stand alone application that executes the integration
Local database stores integration logic
DLLs for each installed connector
Log files
Cloud Agent: hosted by TIBCO - connects to cloud endpoints
On premise Agent: self hosted - connects to local and cloud endpoints
Connection
Consists of Connector type (MySQL, Salesforce, etc.) and credentials
Layer of abstraction that standardizes metadata (schema, operations, etc.)
Points to a single data store

10. Key Concepts - continued
Solutions
An integration package containing one or more Maps
An Integration Solution runs a list of Maps sequentially
Event Solutions contain independently triggered Event maps
Maps
Distinct integration process, like a program module
Can contain multiple Connections
Advanced formula editor with built in functions (regex, parse, date, etc.)
"Query" is the start block for a Map in an Integration Solution
"Wait for Message" or "Wait for Request" is the start block for Event Maps
Blocks
Standard control blocks include: If / Else, For Each Result Loop, Continue, Exit
Connector blocks provide discrete operations for interfacing with connectors

11. TCI Scribe - Architecture
Salesforce
REST
API
Apps
SFTP
Hubspot
DLLs DB
SQL Azure
Cloud Agent
Telemetry
Data
Cloud Endpoints
TCI
Text Files
DLLs DB
Local Files
SQL Server
Events
On Premise Agent
ODBC
CRM On-prem
REST
Local Endpoints

12. TCI Scribe - API & SDK Platform API SDK
All functionality in the TCI Scribe application uses the API
Program in any language (JavaScript, Python, ROR, .NET, etc.)
Leverage TCI Scribe functionality: white label service, Scout, Google sheet, etc.
SDK
Program in .NET, interface to the core application
Develop, test, and deploy on any local agent - no developer key required
Fast Messaging Framework (FMF) - connector for custom inbound messaging
Fast Connector Framework (FCF) - advanced REST connector

13. Lab A - Setup TCI Scribe MySQL Workbench Salesforce SDK
Activate Connectivity in Marketplace
Created Salesforce Connection
Create MySQL Connection
Update security settings
MySQL Workbench
Create DB Connection
Salesforce
Confirm login
Review security settings
Activate MySQL Connector
SDK
Used to build Connectors
Written in .NET, appropriate programming skills required
Develop and test on local agent, no developer key required

14. Lab B - Integrate MySQL to Salesforce
Goals
Use an Upsert with relationships for key management strategy
Understand how related objects are retrieved in TCI Scribe
Integrate 2 related objects from MySQL to SFDC in a single map
Steps
Create Integration Solution
Create Map
Add Connections for MySQL and Salesforce
Implement logic using blocks

15. Lab B - Key Management Parent Records Query Parent / Upsert
Primary Key
External Id
Child Records
Loop Through Children
Upsert
Parent Upsert Id
Parent ID
Primary Key
External Id

16. Lab C - Mashery API Management and TCI Scribe
Goals
Understand how Event Maps work in TCI Scribe
Configure a Request / Reply process
Implement API management
Steps in TCI Scribe
Create Event Solution
Create a Request / Reply map in that solution
Generate endpoint URL
Test using Postman
Steps in Mashery
Create API
Create Package
Generate a Package Key

17. Lab D/E - Salesforce Event to MySQL
Goals
Create an Event triggered integration
Steps in TCI Scribe
Create a message map in existing event solution
Generate endpoint URL
Implement logic
Steps in Salesforce
Create and activate workflow
Create outbound message and add to workflow
Use endpoint generated in TCI Scribe event solution
Test by adding / changing account record
Validate in MySQL

18. TIBCO® Connected Intelligence helps businesses connect to their data wherever it is, augments their ability to gain insight from it, and take faster action.