0% found this document useful (0 votes)
137 views452 pages

CIH R39 On Demand Training Guide

The document provides a comprehensive guide for the Cloud Integration Hub Services, detailing the creation of an IICS account, installation of the IICS Secure Agent, and troubleshooting prerequisites. It includes step-by-step instructions, system requirements, and additional resources for users. The guide is intended for educational purposes and is subject to copyright and licensing restrictions from Informatica LLC.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
137 views452 pages

CIH R39 On Demand Training Guide

The document provides a comprehensive guide for the Cloud Integration Hub Services, detailing the creation of an IICS account, installation of the IICS Secure Agent, and troubleshooting prerequisites. It includes step-by-step instructions, system requirements, and additional resources for users. The guide is intended for educational purposes and is subject to copyright and licensing restrictions from Informatica LLC.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 452

Cloud Integration Hub

Services

onDemand Lab Guide


Version: CIHS-R39-OD-202205
Cloud Integration Hub Services

Version: CIHS-R39-OD-202205
May 2022
Copyright (c) 1998–2022 Informatica LLC. All rights reserved.
This educational service, materials, documentation and related software contain proprietary
information of Informatica LLC and are provided under a license agreement containing restrictions
on use and disclosure and are also protected by copyright law. Reverse engineering of the software
is prohibited. No part of the materials and documentation may be reproduced or transmitted in any
form, by any means (electronic, photocopying, recording or otherwise) without prior consent of
Informatica LLC. The related software is protected by U.S. and/or international Patents and other
Patents Pending.
Use, duplication, or disclosure of the related software by the U.S. Government is subject to the
restrictions set forth in the applicable software license agreement and as provided in DFARS
227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013(c)(1)(ii) (OCT 1988), FAR
12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14 (ALT III), as applicable.
The information in this educational service, materials, and documentation is subject to change
without notice. If you find any problems in this educational service, materials or documentation,
please report them to us in writing.
Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT,
PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange, PowerMart, Metadata
Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data
Transformation, Informatica B2B Data Exchange Informatica On Demand, Informatica Identity
Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event
Processing, Ultra Messaging and Informatica Master Data Management are trademarks or
registered trademarks of Informatica LLC in the United States and in jurisdictions throughout the
world. All other company and product names may be trade names or trademarks of their respective
owners.
Portions of this educational service, materials and/or documentation are subject to copyright held
by third parties, including without limitation: Copyright © Adobe Systems Incorporated. All rights
reserved. Copyright © Microsoft. All rights reserved. Copyright © Oracle. All rights reserved.
Copyright @ the CentOS Project.
This Software is protected by U.S. Patent Numbers 5,794,246; 6,014,670; 6,016,501; 6,029,178;
6,032,158; 6,035,307; 6,044,374; 6,092,086; 6,208,990; 6,339,775; 6,640,226; 6,789,096;
6,820,077; 6,823,373; 6,850,947; 6,895,471; 7,117,215; 7,162,643; 7,243,110, 7,254,590;
7,281,001; 7,421,458; 7,496,588; 7,523,121; 7,584,422, 7,720,842; 7,721,270; and 7,774,791,
international Patents and other Patents Pending.
DISCLAIMER: Informatica LLC provides this educational services, materials, and documentation
“as is” without warranty of any kind, either express or implied, including, but not limited to, the
implied warranties of non-infringement, merchantability, or use for a particular purpose. Informatica
LLC does not warrant that this educational service, materials, documentation or related software is
error free. The information provided in this educational service, materials, documentation and
related software may include technical inaccuracies or typographical errors. The information in this
educational service, materials, documentation and related software is subject to change at any time
without notice.
Document Conventions
This guide uses the following formatting conventions:

If you see… It means… Example


> Indicates a sub menu to navigate Click Repository > Connect.
to. In this example, you should click the
Repository menu or button and
choose Connect.
boldfaced text Indicates text you need to type or Click the Rename button and name
enter. the new source definition
S_EMPLOYEE.
UPPERCASE Database tables and column T_ITEM_SUMMARY
names are shown in all
UPPERCASE.
italicized text Indicates a variable you must Connect to the Repository using the
replace with specific information. assigned login_id.
Note: The following paragraph provides Note: You can select multiple objects
additional facts. to import by using the Ctrl key.
Tip: The following paragraph provides Tip: The m_ prefix for a mapping
suggested uses or a Velocity best name is…
practice.

ii
Other Informatica Resources
In addition to the student and lab guides, Informatica provides these other resources:
 Documentation and Knowledge Base
 Global Customer Support
 Professional Certification

Accessing Documentation and Knowledge Base


To get the latest documentation and Knowledge Base for your product, go to
https://network.informatica.com

Contacting Global Customer Support


You can contact a Customer Support Center by telephone or through the Online
Support. Online Support requires a username and password. You can request a
username and password at
https://www.informatica.com/services-and-training/support-services/contact-us.html

Obtaining Informatica Professional Certification


You can take, and pass, exams provided by Informatica to obtain Informatica
Professional Certification. For more information, go to
https://www.informatica.com/services-and-training/certification.html

iii
Table of Contents
Creating an IICS Account .......................................................................................................... 1
Installing IICS Agent .................................................................................................................. 7
Configuring Oracle DB ............................................................................................................ 23
Troubleshooting Prerequisite Installations .............................................................................. 33
Module 1: Introduction to Cloud Integration Hub
Lab 1-1: Lab Environment Setup ............................................................................................. 41
Module 2: Topics
Lab 2-1: Create a Topic Structure Manually ............................................................................ 47
Lab 2-2: Create a Topic Structure Using a Flat File ................................................................ 59
Lab 2-3: Create a Topic Structure Using Multiple Flat Files .................................................... 69
Lab 2-4: Create a Topic Structure Using a Relational Database Connection ......................... 77
Module 3: Applications
Lab 3-1: Create Applications ................................................................................................... 89
Module 4: Publications
Lab 4-1: Create Connections .................................................................................................. 97
Lab 4-2: Create a Data Synchronization (DSS) Task in IICS for Publication ........................ 137
Lab 4-3: Create a Publication in CIH using the DSS Task .................................................... 151
Lab 4-4: Create a Mapping Task in IICS for Publication ....................................................... 159
Lab 4-5: Create a Publication in CIH using the Mapping Task .............................................. 185
Lab 4-6: Create a Compound Publication Using Mapping Task ........................................... 193
Lab 4-7: Hub Overview .......................................................................................................... 219
Lab 4-8: Run a Publication using Publish Data API .............................................................. 223
Module 5: Subscriptions
Lab 5-1: Create a Subscription in CIH using the DSS Task .................................................. 237
Lab 5-2: Create a Mapping Task (MTT) in IICS for Subscription .......................................... 251
Lab 5-3: Create a Subscription in CIH using the MTT Task .................................................. 277
Lab 5-4: Create a Mapping Task (MTT) in IICS for Compound Subscriptions ...................... 287
Lab 5-5: Create a Compound Subscription in CIH using the MTT Task ............................... 315
Lab 5-6: Run a Subscription using Consume Data API ........................................................ 325
Module 6: Cloud Integration Hub REST APIs
Lab 6-1: Run Cloud Integration Hub REST APIs .................................................................. 349
Module 7: Asset Management
Lab 7-1: Export and Import Assets ........................................................................................ 369
Lab 7-2: Create and Manage Tags ....................................................................................... 379
Module 8: Events and Event Monitors
Lab 8-1: Manage Events ....................................................................................................... 389
Lab 8-2: Create Monitoring Rule ........................................................................................... 399
Module 10: Permissions
Lab 10-1: Permissions ........................................................................................................... 409
Module 11: Salesforce Accelerator Package
Lab 11-1: Deploy Salesforce Accelerator Package ............................................................... 431
Creating an IICS Account
Overview:
To use the different services available in the IICS platform, you must have a valid IICS account.
This document lists the steps to create an IICS trial account to use in the onDemand training
course. The course content and Labs are activated at the time of registration and are available
for 90 days or until all lab hours are consumed.
Objective:
 Create an IICS account
Important:
The screenshots used in this lab guide is for Cloud Data Integration course. The name of course
may differ depending upon the enrolled course. However, the steps for creating the IICS
account will remain the same.
Duration:
5 minutes

Creating an IICS account:


1. From CSOD (the page where you accessed the course), click on the ACCESS YOUR
CLOUD TRIAL ACCOUNT option.

Creating an IICS Account 1


2. From the drop-down, click Launch.

Note: If the option menu is labeled anything other than Launch, click the down arrow to
the right and click Launch.
3. A new University Trial window opens in a new tab. Use the new window to sign up for an
IICS trial account.
4. On the signup page, enter a valid email id and other required information.
Note: During account creation, you must select the Data Centre as North America.
And, for Connector Selection, select Salesforce.

5. Once the required information is entered, select the “I have read & agreed to the
Subscription Agreement” checkbox and click SUBMIT.
Note: If you are unable to register your email-id while creating the account, use the
CONTACT US button at the bottom of the page to contact Informatica Support.

2 Creating an IICS Account


6. After you submit the request, in a few seconds you will get an email from
[email protected] in your registered mailbox.
7. Open the email and to confirm the account creation, click on Confirm Account link.

Note: You can bookmark the URL link to access the IICS login page for future access.
8. In the password setup page, enter a suitable password and a security question for the
account.
9. Click Log In.

Creating an IICS Account 3


10. Click Continue.

11. In the User Marketing page, select Yes or No based on your preference.

Note: It is recommended to select Yes to receive regular updates about product and
other related information.

4 Creating an IICS Account


12. Click Continue.

13. In the Source and target systems window, click Don’t show this again.

Creating an IICS Account 5


In the My Services window, notice the list of available services.

For the CIH training, you will use the Integration Hub, Data Integration, and
Administrator services.
14. Bookmark your Informatica Cloud web page for ease of navigation while executing the
labs.

Thus, you have successfully created an IICS account.

This concludes the lab.

6 Creating an IICS Account


Installing IICS Secure Agent
Overview:
The secure agent is a lightweight, self-upgrading program that runs inside your network. It is
responsible for moving data from the source to a target.
IICS secure agent runs all tasks and enables secure communication between your organization
and Informatica Cloud.
Certain system requirements must be met to install the secure agent. This document lists the
system requirements and the installation steps.
Objective:
 List the system requirements for installing IICS secure agent
 Install the secure agent
 Provide Administrator Rights to Secure Agent
 Rename the secure agent
Duration:
60 minutes

System requirements for installing IICS secure agent:

You must have a multi-core CPU system (at least 2 cores and 4 CPUs/Logical
Processors).
It is recommended that your system has a minimum of 16 GB RAM.
Your system must have at least 100 GB of disk space to run tasks and store caches and
logs with success.
Your system must have a web browser.
Note: Supported browsers are – Internet Explorer version 11, Google Chrome version
62.0 and higher, and Mozilla Firefox (64-bit) version 56.0 and higher.
You can install the secure agent on a Windows 64-bit system or a Linux 64-bit system.
The secure agent uses the HTTPS port 443 to connect to the internet. You must
configure the firewall to allow traffic to pass over port 443.
Do not install the secure agent on the same system that is running the Informatica
PowerCenter Domain server, as it might cause LIB/PATH conflicts and performance
issues.
Do not install more than one secure agent on the same system, as this can cause agent
ID conflicts during its registration under Informatica Cloud Point of Deployments (PODs).
If your company uses a proxy server, you must configure proxy server settings when you
install the secure agent for the first time.

Installing IICS Secure Agent 7


Note: If you face any issues in installing the secure agent, refer to the Troubleshooting
Prerequisite Installations document provided with this lab. If the issue is not listed in
the document, contact the Informatica Support team on [email protected] and
include your organization ID and contact information.
Download the IICS Secure Agent:
In your browser, open the following link to log into IICS.
https://dm-us.informaticacloud.com/identity-service/home
Note: You can also use the link that you bookmarked earlier.
Enter your login credentials and click Log In.

8 Installing IICS Secure Agent


From the My Services window, select Administrator.

Note: The number of services that you can see in the list varies from Org to Org
depending upon the licenses and configuration enabled on the Org.
The Organization page appears.
From the Navigation pane, select Runtime Environments.

Note: If you get a pop-up message that states, “To begin using Integration At Scale,….”,
close the pop-up message.

Installing IICS Secure Agent 9


To download the secure agent, click Download Secure Agent.

From the Download the Secure agent window, select the desired platform, and from
the Install Token field, click Copy.

Paste the copied Install Token in a text file.

Click Download.

Note: Informatica Cloud Secure Agent for the selected platform will download on your
machine. In this lab, you will install the secure agent on a Windows platform.

10 Installing IICS Secure Agent


Install the Secure Agent on your local machine:
Navigate to the Downloads directory on your local machine and locate the agent
installation file.
To install the secure agent, double-click the executable file
agent64_install_ng_ext.exe.

Note: When the secure agent initiates the installation, it displays the InstallAnywhere
window.

From the Choose Installation Folder window, retain the default installation location,
and click Next.

Installing IICS Secure Agent 11


From the Pre-Installation Summary page, click Install.

Note: The following screen displays the steps in the installation process.

After the installation process is complete, the secure agent registration page appears
with the message - The Secure Agent has not been registered.
To register your secure agent, enter the IICS username and paste the copied Install
Token in the Install Token field.

12 Installing IICS Secure Agent


Click Register.

Note: After successful registration, the secure agent will download the necessary files
for the connectors. This process will take 5 to 10 minutes.
When the configuration of the secure agent services is in progress, it displays Secure
Agent Core is running. (Not all services are ready.) message.
After the secure agent configures all the services, the agent status message changes to
The Secure Agent and all services are up and running.

Note: You must provide Administrator rights to your secure agent.

Installing IICS Secure Agent 13


Setting Administrative rights for Secure Agent:
From the Windows Start menu, navigate to Services.

Note: The services window appears.


From the services page, locate Informatica Cloud Secure Agent.
Right-click on Informatica Cloud Secure Agent and select Properties.

Note: A new properties window appears.


Navigate to the Log On tab and select This account.

14 Installing IICS Secure Agent


To select the Administrator account, click Browse.

Note: The Select User window appears.


Click Advanced….

From the Select User window, select Find Now.


Note: A list of available users account appears. Indicative user account selected here for
reference.

Installing IICS Secure Agent 15


From the list, select Administrator, and click OK.

Note: Select your Windows system user from the select user window. In the screenshot
above, Administrator is the windows system user of the system used for the lab
exercise.
Click OK.

16 Installing IICS Secure Agent


In the Password and Confirm Password fields, enter your system’s or Administrator user
password.

Note: If you cannot find the Administrator user, or you do not have the Administrator
password, contact your organization's IT team.
Apply the changes and click OK.

Installing IICS Secure Agent 17


In the Services dialog box, click OK.

To close the properties window, click OK.

Note: After this, you must restart the secure agent and your system on which the secure
agent is installed.
To open the secure agent, right-click the secure agent from the desktop, and select Run
as administrator.

18 Installing IICS Secure Agent


Click Restart.

Note: You must wait for the secure agent to get back to the running state. This may take
up to 5 to 10 minutes.

View and Rename the Secure agent in IICS:


Back in the browser, navigate to IICS, and from the navigation pane (of the Administrator
service), select Runtime Environments.

Installing IICS Secure Agent 19


Note: By default, the secure agent takes the name of the computer it is installed on. It
takes some time for the secure agent to appear under the Runtime Environments
page.
To rename the secure agent group, hover over the drop-down, and select Rename
Secure Agent Group.

Note: The Rename Secure Agent Group window appears.


In the Name field, enter CIH-XX-FIRSTNAME, where XX can be your initials or your
birth date (DOB), and replace FIRSTNAME with your first name.
Note: CIH-XX-FIRSTNAME is an indicative name, you can provide a name of your
choice and remember the name.
Click OK.

To rename the secure agent, for the secure agent, hover over the drop-down and select
Edit Secure Agent.
In the Agent Name field, enter CIH-XX-FIRSTNAME.

On the top right corner, click Save.

To return to the Runtime Environments page, click .

Verify that the secure agent group name and the secure agent name are now set to CIH-
XX-FIRSTNAME. Also, verify that the status of the secure agent is Up and Running.

20 Installing IICS Secure Agent


To log out from the Org, click User and select Log Out.

Note: You must not close the secure agent window as it is the main component to
establish connectivity between your on-premise data and IICS services.

Download all the CIH Training files:


On your machine, create a folder named CIH Training in the following directory:
C:\CIH Training.
Download all the Lab Prep Files provided to you along with the labs and copy them to
the directory C:\CIH Training.
This folder contains the files required while executing the labs. It also contains the
Tables folder, which contains the tables that you will import into SQL Developer while
performing the Oracle DB Setup lab activity.
Close all the folders.

This concludes the lab.

Installing IICS Secure Agent 21


22 Installing IICS Secure Agent
Configuring Oracle DB
Overview:
Oracle, also known as Oracle Database, is a relational database management system. It is
commonly used for running online transaction processing (OLTP), data warehousing (DW), and
mixed (OLTP & DW) database workloads.
This document lists the steps to configure the Oracle database tables required for the training.
Objective:
 Create User
 Download SQL Developer
 Create Table
Duration:
90 minutes

Important:
1. It is presumed that the Oracle and SQL Developer are installed in your system. In case
your system doesn’t contain Oracle and SQL Developer, you must download them from
the browser before starting with the lab exercises. For any issues during the Oracle
download and installation, contact your organization’s IT team.
2. In the lab exercises for this course, the following lab guides are designed and
documented using Oracle database. We therefore recommend that you have Oracle
database installed on your system (Secure Agent machine) to execute the labs.
List of Oracle Dependent Labs
Lab 2-4: Create a Topic Structure Using a Relational Database Connection
Lab 4-7: Run a Publication Using Publish Data API
Lab 5-4: Create a Mapping task (MTT) in IICS for Compound Subscription
Lab 5-5: Create a Compound Subscription in CIH Using the MTT Task
Lab 5-6: Run subscriptions using Consume Data API
Lab 6-1: Run Cloud Integration Hub REST APIs
Lab 7-2: Create and Manage Tags
Lab 8-1: Manage Events

Note: If you do not have Oracle installed on your system, then you may skip the labs
that are database-dependent and continue with the rest of the course and lab exercises.

Configuring Oracle DB 23
Create User in SQL Plus:
From the Windows Start menu, navigate to SQL Plus.
Note: The SQL Plus command prompt appears.
To log into SQL Plus, enter user-name as sqlplus / as sysdba.
Press Enter.
In the Enter Password prompt, press Enter to log in without a password.
Note: The Connected to: message appears.

To create a user, enter the following command in the SQL> field:


CREATE USER GMT_CRM IDENTIFIED BY GMT_CRM DEFAULT tablespace users
TEMPORARY tablespace temp quota unlimited ON users;
Press Enter.

Note: “User created” message appears.


a. If you get ORA-65096: invalid common user or role name error while creating a
user, then run the following command to reset the session:
alter session set “_ORACLE_SCRIPT”=true;

b. After the session is altered, run the command in the step-27 again to create the user.
To grant access to the created user, enter the following command in the SQL> field:
GRANT CONNECT, resource, DBA TO GMT_CRM;
Press Enter.

Note:” Grant succeeded” message appears.


Close the SQL Plus application.

24 Configuring Oracle DB
Finding Oracle SID:
From the Windows Start menu, open SQL Plus again.
To log into SQL Plus, enter the user-name and password as GMT_CRM.
Note: The Oracle SID changes from user to user. Thus, to create a connection for the
GMT_CRM user, you must log in with the GMT_CRM user to find the SID.
Press Enter.
Note: The “Connected to:” message appears.

To know the service name, enter the following command in the SQL> field:
select instance from v$thread;

Note: The service name varies from screenshot above. Here, the oracle service name is
infaorcl. Make a note of your Oracle’s service name as you will need this detail later in
the lab.
Configure the Oracle DB Tables
From your system, launch SQL Developer.
To create a new connection, click the plus icon and select New Connection.

Note: The screenshots of SQL Developer may vary according to its version. However,
the steps remain the same.
In the Name field, enter GMT.

Configuring Oracle DB 25
In the Username and Password field, enter GMT_CRM.

Select Service name, enter the oracle service name identified earlier, and click Test.

Notes:
a. The service name can change from one user to another.
b. If the port number is not valid, then check to see if Oracle is already set up on your
system.

26 Configuring Oracle DB
When the test is successful, click Connect.

If prompted, enter the Username and Password as GMT_CRM and click OK.

Create Tables:
To create the tables in GMT, expand GMT, right-click Tables, and select Import Data.

Configuring Oracle DB 27
Browse to the directory where you download the Tables folder: C:\CIH Training\Tables,
select Customers.csv file, and click Open.

The Data Import Wizard window appears.


In step 1 of Data Import Wizard, click Next.

28 Configuring Oracle DB
In step 2, enter the Table Name as Customers and click Next.

In step 3, verify that all the columns are selected and click Next.

Configuring Oracle DB 29
In step 4, select the column Customer_Id, and change the Data Type to VARCHAR2.

Similarly, change the Data Type for the rest of all columns to VARCHAR2.
Note: Few columns might already have their data type as VARCHAR2. Make sure that all
the columns for all the tables that you import have the same data type as VARCHAR2.
After changing all the columns data type to VARCHAR2, click Next.

30 Configuring Oracle DB
In step 5, click Finish.

Once the data is imported successfully, in the Import Data window, click OK.

Observe that the Customers table is imported successfully.

Configuring Oracle DB 31
Similarly, follow the steps 49 to 56 and import all the other 4 tables (Employees, Orders,
product_sales, and Products) present in the Tables folder on your machine as per the
table below:

Table Table Name in step 2 of Import Data Wizard

Employees Employees

Orders Order_Details

product_sales Product_Sales

Products Products (DO NOT FORGET TO MAKE SURE THAT IN


STEP 4 OF DATA IMPORT WINDOW, ALL THE
COLUMNS SHOULD BE OF SAME DATA TYPE:
VARCHAR2)
You must see all the 5 tables listed under the connection GMT.

Close all the opened applications.


Note: If you don’t see the tables under GMT, right-click Tables and click Refresh.
Thus, you have successfully installed Oracle, SQL Developer, and created a database
connection and added tables to it.

This concludes the lab.

32 Configuring Oracle DB
Troubleshooting Prerequisite Installations
Contents
Oracle: ........................................................................................................................................................ 34
Issue: Oracle connection test fails with the following error: .................................................................... 34
Secure Agent ............................................................................................................................................. 36
Issue: Secure Agent Service status is disabled ...................................................................................... 36
Issue: ‘Not all the services are running’ .................................................................................................. 36
Commonly seen errors in agentcore.log file: .......................................................................................... 36
Uninstalling the Secure Agent ................................................................................................................. 39
Important points for secure agent installation: ........................................................................................ 39

Troubleshooting Prerequisite Installations 33


Oracle:
Issue: Oracle connection test fails with the following error:
“The connection test failed because of following error: [Informatica] [Oracle JBDC Driver] Error
establishing socket to host and port: 0.0.0.0.0.0:1:1521. Reason: Connection refused: connect.”

OR
ORA-12505, TNS: listener does not currently know of SID given in connect descriptor.

Solution: Check the status of the Oracle services.

a. From the windows start menu, search Services.

34 Troubleshooting Prerequisite Installations


b. In the services window, verify that the following services are running. If not, start the following
services:
OracleOraDB12Home1MTSRecoveryService
OracleOraDB12Home1TNSListener
OracleServiceORCL
OracleVssWriterORCL
Note: To start a service, right-click the service, and select Start.

Troubleshooting Prerequisite Installations 35


Secure Agent
Issue: Secure Agent Service status is disabled

Solution: The disabled status of the Informatica Cloud Secure Agent indicates an issue in installation and
that the files required for starting the services are missing. You must uninstall and re-install the secure
agent to fix this issue. To uninstall the Secure Agent, refer to the section on Uninstalling the Secure
Agent.

Issue: ‘Not all the services are running’


Solution: There are many reasons why the agent does not come up. The best method to find the reason
is to check the agent audit logs and agentcore.log files.

 To view the audit logs for a secure agent, navigate to Administrator > Runtime Environments
> Secure Agent > Audit Log.
 The agentcore.log file is located in the following location: C:\Program Files\Informatica Cloud
Secure Agent\apps\agentcore

You will then have to go through the log files and look for the errors. A few commonly seen errors are
listed below.

Commonly seen errors in agentcore.log file:


1. The following error message can be seen in the agentcore.log while registering the secure agent
with proxy information.
2018-08-11 11:58:05,127 MST ERROR
[com.informatica.saas.rest.client.spring.RestTemplateExtended] - HTTP request to URL
https://dm-us.informaticacloud.com/ma/api/v3/InternalLogin failed with HTTP status
[PROXY_AUTHENTICATION_REQUIRED AuthenticationRequired] and response body []
2018-08-11 11:58:05,127 MST ERROR
[com.informatica.saas.infaagent.agentcore.AgentCoreStateMachine] - Unable to create
metadata file due to the following [407 AuthenticationRequired]."

Solution: Navigate to file proxy.ini located at C:\Program Files\Informatica Cloud Secure


Agent\apps\agentcore\conf and provide the proxy details. Save the file and restart the agent.

A sample entry in proxy.ini:

InfaAgent.ProxyHost=ProxyHostName
InfaAgent.ProxyPort=3128
InfaAgent.ProxyUser=testuser
InfaAgent.ProxyPassword=infa12345

2. The secure agent keeps restarting or the Data Integration service is getting restarted. The
following message is seen in agentcore.log:
[LCM_10012] Administrator-1.0.1 is restarting due to an error encountered while
running: [Administrator-1.0.1]

36 Troubleshooting Prerequisite Installations


or its Data Integration Server:
[LCM_10012] Data_Integration_Server-52.0.3 is restarting due to an error encountered
while running: [Data_Integration_Server-52.0.3]

Solution: This can have different causes. The most likely are:

a. Missing licenses i.e. the SDK license: Check with the Informatica support team
([email protected]) regarding the licenses.
b. Corrupted Secure Agent files: Re-install the secure agent.

3. Secure agent status stuck at “Not all the services are running”. The following message is seen in
the log file.

2018-09-25 06:01:40,438 EDT INFO


[com.informatica.saas.lcm.lcmnative.ProcessSupervisor] - >>> OutOfMemoryError:
Metaspace
2018-09-25 06:01:41,342 EDT INFO
[com.informatica.saas.lcm.lcmnative.ProcessSupervisor] - ProcessMonitor
[CommandSpec command[E:\csapps\Informatica Secure
Agent\apps\Data_Integration_Server\52.0.3\.lcm\stop-wrapper.bat] args[]
dir[E:\csapps\Informatica Secure Agent\apps\Data_Integration_Server\52.0.3]
timeout[600000] waitForever[false]] state[EXITED] tmpFile[E:\csapps\Informatica Secure
Agent\apps\agentcore\logs\temp\ProcessSupervisor4001252731309672350.tmp] completed
exit code: 1 output:
2018-09-25 06:01:41,342 EDT INFO
[com.informatica.saas.lcm.lcmnative.ProcessSupervisor] - >>> E:\csapps\Informatica
Secure Agent\apps\Data_Integration_Server\52.0.3>ics_stop.bat

Solution: To fix the outOfMemory issue, make the following changes in the server where the
secure agent is installed:

a. Right-click on My computer > Properties.


b. Go to Advanced system settings.

Troubleshooting Prerequisite Installations 37


c. From the Performance section, click Settings.

d. Click the Advanced tab. In the Virtual Memory section, select Change.

e. Select Automatically managed paging file size for all Drives.


f. Apply the changes and restart the server.

38 Troubleshooting Prerequisite Installations


Uninstalling the Secure Agent
To re-install the Secure Agent, you must first uninstall it. Perform the following steps to uninstall the
Secure Agent.

a. From the File Explorer, navigate to C:\Program Files\Informatica Cloud Secure


Agent\Uninstall_Informatica Cloud Secure Agent.
Note: The agent installation path may vary from user to user.
b. Run the Uninstall Informatica Cloud Secure Agent.exe application.

c. Verify that the Informatica Cloud Secure Agent folder is removed from the C:\Program Files
location. If not, manually delete all the remaining files in the installation directory.
d. After the Informatica Cloud Secure Agent folder is removed, re-install the secure agent.

Important points for secure agent installation:


1. Always use the latest secure agent installer downloaded from the IICS Org.
2. Always run the secure agent as an ‘Administrator’.

3. After providing the org details and the install token in the secure agent registration window, the
secure agent downloads the necessary files for the connectors. This process takes 20-30 minutes
(depending upon the internet speed). You must not stop or restart the secure agent until the secure
agent status changes to “Up and running”.
4. You must provide Administrator rights to your secure agent.

This concludes the lab

Troubleshooting Prerequisite Installations 39


40 Troubleshooting Prerequisite Installations
Module 1: Introduction to Cloud Integration Hub
Lab 1-1: Lab Environment Setup
Overview:
In this lab, you will log in to IICS, and verify that the Cloud Integration Hub components are
enabled. If enabled, you will configure the Cloud Integration Hub console.

Objectives:
 Log in to Informatica Cloud
 Verify Cloud Integration Hub license in IICS
 Configure Cloud Integration Hub Console
Duration:
10 minutes

Tasks

Log in to Informatica Cloud


You will work in the Integration Hub service of IICS. For this, you must first have valid
credentials to log in to IICS. You must also have the Integration Hub license – either trial or
subscription version, to work with CIH.

1. In the Chrome browser, click the Informatica Cloud bookmark.

Module 1: Introduction to Cloud Integration Hub 41


2. Log in to IICS.

Verify Cloud Integration Hub License in IICS


3. Go to the Administrator tab.

42 Module 1: Introduction to Cloud Integration Hub


4. To check the license, go to the Licenses tab.

5. Under the Licensing section, verify that Integration Hub is listed.

Configure Cloud Integration Hub Console


6. To switch between the services, click on Administrator, and select the Integration Hub
service.

Module 1: Introduction to Cloud Integration Hub 43


Note: If you are prompted for the CIH License Agreement window, accept it.

The Organization Cloud Setup window opens.

44 Module 1: Introduction to Cloud Integration Hub


Note: If the Organization Cloud Setup window does not appear automatically, click the
Setup hyperlink on the Cloud Integration Hub Console and provide the details.

7. Enter your Informatica Cloud username and password.


8. From the Runtime Environment drop-down, select your Secure Agent and click Save.

The Cloud Integration Hub console setup is now complete.


9. The moment you setup your Hub, the Cloud Integration Hub connector package will be
installed in your Org. To verify the connection in IICS, switch to the Administrator
service.

Module 1: Introduction to Cloud Integration Hub 45


10. Go to the Connections page. A new connection named Cloud Integration Hub of type
Cloud Integration Hub is created.

The connections in your image will differ from that of the screenshot. Ignore all the other
connections in the screenshot above.
Now that you have successfully set up the environment for Cloud Integration Hub labs,
continue with the next lab exercise.

This concludes the lab.

46 Module 1: Introduction to Cloud Integration Hub


Module 2: Topics
Lab 2-1: Create a Topic Structure Manually
Overview:
A topic is an entity that represents a data domain that is published and consumed in Cloud
Integration Hub. A topic defines the data structure and additional data definitions, such as the
data retention period.

In this lab, you will create a topic and define its structure manually by creating a new table.
Scenario:
Luci identifies that a topic needs to be created to share the data (with other applications). To
store the objects in Cloud Integration Hub, she must create a Topic, which works as a
placeholder for data in Cloud Integration Hub. She will create an Account topic to store the
account details in the hub.

Objectives:
 Create your training project and folder
 Create a Topic
 Create a table in a topic structure manually
Duration:
15 minutes

Tasks
In this lab, you will create your own training folder and save your assets there. After which, you
will create your first asset – Topic in CIH to store the account details. In the later labs, you will
use this asset to publish the accounts data. Once publishing is done, you also consume the
data from the topic in the subsequent labs.

Module 2: Topics 47
1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

48 Module 2: Topics
2. To create your training project, go to the Explore page and click New Project.

3. Specify the project name as CIH Project and click Save.

4. To create a new training folder, click CIH Project.

Module 2: Topics 49
5. Click New Folder.

6. Specify the folder name as CIH_XX_FIRSTNAME and give a Description as CIH


training folder. Click Save.

Note: If your DOB is 02 and your name is Bob Smith, then the folder name should be
CIH_02_BOB.
A new folder is created.

Henceforth, ensure that all your assets created in CIH are saved to your training folder.

50 Module 2: Topics
7. To create a topic, from the Navigator pane, click New.

8. To create a topic in the Cloud Integration Hub, from the list click Topic.

Module 2: Topics 51
A New Topic page appears. The New Topic tab is added to the Navigator pane.

9. Under the General Details section, enter the Topic Name as Account.

10. To select the location of the topic, for the Location field, click Browse.

52 Module 2: Topics
11. From the list, select your training folder and click Select.

12. In the General Details section, retain all other default values.

Module 2: Topics 53
Observe that the Save option is not enabled yet. This means it is still missing out on an
important configuration – Topic Structure. You must define the topic structure, that is,
add tables, to make a topic valid and save it. You can create a new table or add tables
from a flat file, connection, or metadata.

13. To create a table in a topic structure manually, click the Create Table From option and
select New Table.

14. In the Create New Table window, enter Table Name as Account, from the Number of
columns drop-down, select 7, and click Create.

A list of columns appears under the Topic Structure section.

54 Module 2: Topics
15. Click on the column names and rename them as follows:
From To
field1 ACCOUNT_ID
field2 ACCOUNT_NAME
field3 BILLINGCITY
field4 BILLINGSTATE
field5 BILLINGPOSTALCODE
field6 BILLINGCOUNTRY
field7 PHONE

Hover the mouse over any row and from the actions menu that appears at the right end
of the row, select Add Row.

Module 2: Topics 55
A row for field1 is added.

16. Rename field1 as WEBSITE.

17. Save the topic.

56 Module 2: Topics
18. Once the topic is saved, you can view its topic diagram and details.

19. Close the topic.

In this way, you can create a Topic structure manually.

This concludes the lab.

Module 2: Topics 57
58 Module 2: Topics
Module 2: Topics
Lab 2-2: Create a Topic Structure Using a Flat File
Overview:
You have seen how to define a topic structure manually. In this lab, you will learn how to create
a topic and define its structure using a flat file.

Scenario:
To store the Salesforce data into the hub, Luci creates a topic called Salesforce_Data to share
the Account object details with different applications.

Objectives:
 Create a topic
 Create a table in a topic structure from a flat file
Duration:
10 minutes

Tasks
1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

Module 2: Topics 59
2. You have created a topic in the previous lab, hence, this time a Hub-Overview diagram
appears instead of a Welcome page.

3. To create a topic, from the navigator pane, click New.

60 Module 2: Topics
4. To create a topic in the Cloud Integration Hub, from the list click Topic.

A New Topic page appears. The New Topic tab is added to the Navigator pane.

Module 2: Topics 61
5. Under the General Details section, enter the Topic Name as Salesforce_Data.

6. To select the location of the topic, from the Location field, click Browse.

62 Module 2: Topics
7. From the list, select your training folder and click Select.

8. In the General Details section, retain all other default values.

Module 2: Topics 63
9. To create a table from an existing flat file, click the Create Table From option and select
Flat File.

A window ‘Add Table from flat file’ appears.

You will configure the basic flat file settings in this window. After selecting the flat file,
you can preview the data under Preview section.

64 Module 2: Topics
10. To select a flat file from your system, click Choose File.

11. Browse to the location C:\CIH Training and select the file ACCOUNT_1.csv. Click
Open.

12. Enter the Table Name as Account_1. Retain other details to their default values.

Module 2: Topics 65
13. To load and preview the file, click Load File.

14. The preview section allows to view all rows and columns. To load the table in the Topic,
click Create.

66 Module 2: Topics
The list of columns appears.

15. Save the topic.

A message ‘Topic created successfully’ appears.

Module 2: Topics 67
16. Close the Topic page by clicking the icon for Salesforce_Data.

In this way, you can create a Topic structure using a flat file.

This concludes the lab.

68 Module 2: Topics
Module 2: Topics
Lab 2-3: Create a Topic Structure Using Multiple Flat Files
Overview:
Now that you have seen how to define a topic structure using a single flat file, in this lab, you will
create a topic and define its structure using multiple flat files.

Scenario:
Luci wants to store the Contact object details of Salesforce. Instead of creating a new topic in
the hub, she will add the contact details to the existing Salesforce_Data topic’s structure.

Objectives:
 Edit an existing topic
 Create a table in topic structure from a flat file
Duration:
10 minutes

Tasks
You do not have to create new topics whenever you need to store data. Instead, you are
allowed to new tables to an existing topic as a topic can have multiple tables in it. In this lab
exercise, you will add a new table that has the contact details to an existing topic from a flat file.

1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

Module 2: Topics 69
2. From the Navigator Pane, go to Explore.

3. To edit the existing topic, go to your training folder CIH Project > CIH_XX_FIRSTNAME.

4. In this lab, we will add multiple files for the existing topic Salesforce_Data, click the
Salesforce_Data topic that you created in Lab 2-2.

The Salesforce_Data tab appears on the Navigator Pane.

70 Module 2: Topics
5. On the Topic details page, go to the Topic Structure section and click the Create Table
From option.

6. Select Flat File.

A window ‘Add Table from Flat File’ appears.

Module 2: Topics 71
We can add multiple flat files to the same topic, in this way the file structure can be
loaded in a single topic only. So, in this topic, we can save the Contact and Account
details.
7. To select a flat file from your system, click Choose File….

8. Browse to the location C:\CIH Training and select the file CONTACT.csv. Click Open.

9. Enter Table Name as Contact. Retain other details to their default values.

72 Module 2: Topics
10. To load and preview the file, click Load File.

11. The preview option allows us to view all rows and all columns. To load the table in the
Topic, click Create.

Module 2: Topics 73
12. The columns of the Contact table are added in the Topic structure. You can click on the
arrow next to the table column to sort for a particular table.

13. Save the changes.

A message ‘Topic was updated successfully’ appears.

74 Module 2: Topics
14. Close the Salesforce_Data topic.

In this way, you can add tables using multiple flat files to an existing topic.

This concludes the lab.

Module 2: Topics 75
76 Module 2: Topics
Module 2: Topic
Lab 2-4: Create a Topic Structure Using a Relational Database
Connection
Overview:
You have seen how to create topic structures manually and using flat files in the hub. Now you
will learn how to create a topic structure using a connection.

In this lab, you will create a topic and define its structure using a connection.
Scenario:
As the Marketing department is maintaining its product details in an Oracle database, to store
the product data, Luci first creates connections to the database and then creates a topic called
Products in the hub.

Objectives:
 Create an Oracle connection in the Administrator service
 Create a topic
 Create a table in a topic structure using the oracle connection
Duration:
15 minutes

Tasks

So far, you have seen how to create topic structures manually by creating each column in a
table and also from a flat file. What if you have your data in a database? Let us see how to
create topic structures from database tables.
You must have a valid database connection in your Org. You will now create an Oracle
connection in the Administrator service.

Module 2: Topic 77
1. In the Chrome browser, log in to IICS and navigate to the Administrator service.

2. To create a new oracle connection, from the navigator pane, go to Connections.

78 Module 2: Topic
3. For connecting to Oracle create a connection, to create a new connection, click New
Connection.

4. Under the Connection Details section, enter the Connection Name as


FIRSTNAME_XX_Oracle and set the connection Type to Oracle.

5. For the Runtime Environment, select your Secure Agent.

Module 2: Topic 79
6. Enter the following values in the corresponding property fields:
Property Value
User Name GMT_CRM
Password GMT_CRM
Host localhost
Port 1521 (Default)
Service Name infaorcl
Code Page MS Windows Latin1

7. To validate the connection details, click Test Connection.

80 Module 2: Topic
A message ‘The test for this connection was successful’ appears.

8. To save the oracle connection, click Save.

Module 2: Topic 81
A confirmation message ‘Connection saved successfully’ appears.

9. Close the connection.


Note: You will use this connection to get the schema/database table details. Here, you
will use the Products table and create the topic structure.
10. For creating a Topic, we need to switch to Integration Hub, click the Down Arrow to
switch.

82 Module 2: Topic
11. To create a topic, from the Navigator pane, click New.

12. To create a topic in the Cloud Integration Hub, from the list click Topic.

Module 2: Topic 83
A New Topic page appears. The New Topic tab is added to the Navigator pane.

13. Under the General Details section, enter the Topic Name as Products.
14. Optionally, you can enter a Description as GMT Electronics product details.
15. To select the location of the topic, for the Location field, click Browse.
16. From the list, select your training folder and click Select.

84 Module 2: Topic
17. In the General Details section, retain all other default values.

18. To create a table in a topic structure using a connection, click the Create Table From
option and select the Connection option.

A window ‘Add Table From Connection’ appears.

Module 2: Topic 85
19. To specify the connection details, for the Connection field, click the drop-down and
select FIRSTNAME_XX_Oracle.
20. From the Source Object drop-down field, select PRODUCTS. Specify the Table Name
as Products.

21. After selecting the required details, click Create.

86 Module 2: Topic
22. A list of columns that are present in the schema appears under the Topic Structure
section.

23. Save the topic.

Module 2: Topic 87
A message ‘Topic created successfully’ appears.

If the Topic creation failed, refresh the page and retry again.
24. Close the topic.

In this way, you can create a Topic structure using a connection.

This concludes the lab.

88 Module 2: Topic
Module 3: Applications
Lab 3-1: Create Applications
Overview:
An application can publish data to a defined topic and can subscribe to data from a topic. For
example, a sales application can publish sales reports and subscribe to inventory updates from
an operations application. In Cloud Integration Hub, an application is a container for publications
and subscriptions.

In this lab, you will create Salesforce, NetSuite, Workday, and Oracle applications.

Scenario:
James, one of the developers in the company, will create an application to group publications
and subscriptions belonging to a department/system. Further, in later labs, he will create the
required publications and subscriptions in the applications.

Objectives:
 Create Applications
Duration:
10 minutes

Tasks
As you know that Applications are the containers for Publications and Subscriptions, you must
create applications either to read the data from the hub or write the data to the hub. In this lab
exercise, you will see how to create applications in CIH. In this lab, you will create multiple
applications and use them in the subsequent labs.

Module 3: Applications 89
1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).
The Hub Overview diagram appears.

Note: The view will differ depending on the number and type of entities defined in your
Informatica Cloud Integration Hub console.

Create Salesforce Application


2. In the Navigator pane, click New.

90 Module 3: Applications
3. To create an application in the Cloud Integration Hub, from the list click Application.

A New Application page appears.

Module 3: Applications 91
4. Under the General Details section, enter the Application Name as Salesforce.

Note: You can enter the Application Name according to your requirements and naming
conventions. It is not mandatory to enter the same name as that of a real application.
5. To select the location of the application entity, for the Location field, click Browse.
6. Select your training folder.

92 Module 3: Applications
7. Save the application.

A message ‘Application created successfully’ appears.

8. Close the application.

Salesforce application is used to store the details of Salesforce publications and


subscriptions.

Module 3: Applications 93
Create a Workday Application
9. To create a Workday application, repeat steps 2 - 8 and name the application as
Workday.

Create a NetSuite Application


10. To create a NetSuite application, repeat steps 2 - 8 and name the application as
NetSuite.

94 Module 3: Applications
Create Oracle Application
11. To create an Oracle application, repeat steps 2 - 8 and name the application as Oracle.

Create an application Oracle for storing the details of Oracle tables in it.
12. As we have created 4 applications, in the Hub Overview, you should see 4 entities in the
Applications overview diagram.

In this way, you create Applications to store the details for different publications and
subscriptions.

This concludes the lab.

Module 3: Applications 95
96 Module 3: Applications
Module 4: Publications
Lab 4-1: Create Connections
Overview:
Connections define the location and the credentials of the data source or the data target to
which Cloud Integration Hub connects when a source application publishes data, or when a
target application consumes published data.

In this lab, you will create Salesforce and Flat File connections. You will also load data into
Salesforce.

Scenario:
GMT electronics has various departments that use multiple databases. The product team is
maintaining their data in the Oracle database, whereas another department has its data in flat
files. Luci, the database administrator of GMT electronics, will use CIH to eliminate spaghetti
integration code by reducing point-to-point integrations. First, she will create connections in IICS
for all the databases in which data is residing.

Objectives:
 Create a Salesforce connection in IICS
 Create a Flat File connection in IICS
 Create Data Synchronization tasks to write the data into your Salesforce
Duration:
45 minutes

Tasks
In this lab exercise, you will create connections that will be used in the later labs of the training.
The first connection is a Salesforce connection – used to read/write the data from/to Salesforce.
The second connection is a Flat File connection – used to access the flat files folder on your
local machine. In the later labs, you will write the Salesforce data from your Salesforce account
into Hub. To do this, you just need to have some data in your salesforce account. Thus, we will
presume that you don’t have any data/delete the existing data, and using Synchronization tasks,
you will load some sample data into your Salesforce accounts (Contacts and Accounts assets).

Reset Salesforce Security Token:


It is assumed that you already have registered an account with Salesforce.com. If not, please go
to https://developer.salesforce.com/signup and create a Salesforce account.

To connect to Salesforce from Informatica Cloud, perform the following steps:


Note: Informatica Cloud does not allow you to create a Salesforce Connection without a
security token. So, you must reset your Security Token in Salesforce.com.

Module 4: Publications 97
1. In the browser, open a new tab and log in to Salesforce.com using your developer login:
https://login.salesforce.com/?locale=in

Note: The following instructions are based on the classic version of Salesforce. To
switch to the classic version, on the upper right corner, select the View Profile option.
And from the appeared menu, select the ‘Switch to Salesforce Classic’ option.

98 Module 4: Publications
2. In the upper right corner of the screen, click on your username and select My Settings.

3. In the navigation pane on the left side of the screen, click Personal > Reset My
Security Token.

Module 4: Publications 99
4. Click Reset Security Token.

5. After your security token is reset, the token is sent to the email that you have registered
with Salesforce. Check your email to find a mail from [email protected] and copy
your security token.
6. Close the Salesforce tab.

Create a Salesforce connection in IICS


7. Log in to IICS and navigate to the Administrator service.

100 Module 4: Publications


8. To create a new connection, click Connections.

9. Click New Connection.

10. In the Connection Name field, enter FIRSTNAME_XX_Salesforce. You can optionally
enter a description in the Description field.
11. Set the connection Type to Salesforce.

12. For the Runtime Environment, select your Secure Agent.

Module 4: Publications 101


13. Select the Salesforce Connection Type as Standard.

14. In the User Name field, enter your Salesforce account user name.
15. In the Password field, enter your Salesforce account password.
16. In the Security Token field, paste your Salesforce account security token (copied from
the email).

17. To test the connection before saving it, click Test Connection.

102 Module 4: Publications


A message ‘The test for this connection was successful’ appears.

If the test connection fails with an error saying Invalid API version, as shown below,

Then, under the Standard Connection Properties, for Service URL property, change the
API version to 48 in the URL, and test the connection again.

Module 4: Publications 103


18. Save the Connection.

A confirmation message ‘Connection saved successfully’ appears.

19. Close the connection.

Create a Flat File connection in IICS


20. On the machine where you have installed the Informatica Cloud Secure Agent, in the C
drive, create a new folder named IICSLabFiles (The directory should be
C:\IICSLabFiles).

21. Navigate back to IICS and go to the Administrator service tab.

104 Module 4: Publications


22. To create connections, click Connections.

23. Click New Connection.

24. In the Connection Name field, enter FIRSTNAME_XX_LocalCSVFiles. You can


optionally enter a description in the Description field.
25. Set the connection Type to Flat File.

Module 4: Publications 105


26. For the Runtime Environment, select your Secure Agent.
27. For the Directory field, click Browse.

28. Browse to the location C:\IICSLabFiles and click OK.

106 Module 4: Publications


29. From the Code Page drop-down menu, select MS Windows Latin1.

30. Test the connection.

A message ‘The test for this connection was successful’ appears.

If the test connection fails, check the connection details, and test it again.

Module 4: Publications 107


31. Save the connection.

A confirmation message ‘Connection saved successfully’ appears.


32. Close the connection.

Load the required data in Salesforce:


To load the required data to Salesforce, you must ensure that there is no existing data in the
selected Salesforce objects.

Delete the Salesforce records:

Notes:
 To delete all the existing data from the Salesforce object, use the Informatica Cloud Data
Synchronization task using task operation ‘Delete’. You can also delete the data from
Salesforce, using the Mass delete option.
 The following method is based on the Salesforce Mass Delete Option.
 The instructions are based on the classic version of Salesforce.
33. In the browser, log in to Salesforce.com using your developer login:
https://login.salesforce.com/?locale=in
34. On the upper right corner of the Salesforce page, click the Setup option.

108 Module 4: Publications


35. In the Quick Find/Search… textbox, enter Mass Delete. The option ‘Mass Delete
Records’ appears in the Salesforce setup page navigator.

36. Select the Mass Delete Records option.


37. From the appeared options, select the Mass Delete Accounts option.

Module 4: Publications 109


38. On the Mass Delete Accounts page, click Search.

39. Scroll down the page till the list of all the current records appears.

110 Module 4: Publications


40. Select the checkbox to select all the records. To delete the records, click Delete.

41. Similarly, delete all the data from your Salesforce Contacts object.

Create a Data Synchronization task to load data into your Salesforce Accounts object
42. To place the required files in your flat file directory, on your machine, navigate to the
folder C:\CIH Training and copy the CSV files - ACCOUNT_1 and CONTACT.

Module 4: Publications 111


43. Paste the files in your flat file directory C:\IICSLabFiles.

44. In the browser, log in to IICS and navigate to the Data Integration service.

112 Module 4: Publications


45. In the Navigator pane, click New.

46. In the New Asset window, select Tasks > Synchronization Task.

47. To create a synchronization task, click Create.


48. In the Definition step, enter the Task name as Load_Salesforce_Accounts.

Module 4: Publications 113


49. To select the location of the task, for the Location field, click Browse.

50. From the list, select your training folder and click Select.

114 Module 4: Publications


51. Select the Task Operation as Insert.

The Task Operation Insert will insert the entire data present in the source to the Target.
52. To go to the next page, that is, the Source page, click Next.

Module 4: Publications 115


53. In the Source step, for the Connection field, select your Flat File connection
FIRSTNAME_XX_LocalCSVFiles.

As you will load the data from a flat file into Salesforce, the source connection must be a
flat file connection and the target connection must be a Salesforce connection.
54. Retain the Source Type as Single and select the Source Object as ACCOUNT_1.csv.

Here the source file ACCOUNTS_1 csv, contains the Accounts details that will be loaded
into your Salesforce. If you want to view the data in the csv file, navigate to your flat file
directory, open, and view the ACCOUNT_1 csv file.

116 Module 4: Publications


55. Click Next.

Note: You might see the Data Preview section for the selected source or target based
on the user role and privileges.
56. In the Target step, for the Connection field, select your Salesforce connection
FIRSTNAME_XX_Salesforce.

Module 4: Publications 117


57. Select the Target Object as Account.

As you will load the Account details, here, you will select the target object as Account.
58. Click Next.

118 Module 4: Publications


59. As there are no filters required for the data, in the Data Filters step, click Next.

60. In the Field Mapping step, map the fields as per the table given below:
Note: Do not map the fields which are already auto-mapped correctly.
Property Value
ACCOUNT_NAME Account Name
BILLINGCITY Billing City
BILLINGSTATE Billing State/Province
BILLINGPOSTALCODE Billing Zip/Postal Code
BILLINGCOUNTRY Billing Country
PHONE Account Phone
WEBSITE Website
ACCOUNT_TYPE Account Type
INDUSTRY Industry

Module 4: Publications 119


61. To validate the mapping, click Validate Mapping.

A message ‘The field mapping is valid and has no errors’ appears.

120 Module 4: Publications


62. To save the Synchronization Task, click Save.

63. To complete the Synchronization Task, click Finish.

Module 4: Publications 121


64. For loading the data into the Salesforce Account, click Run.

65. To view the job status, in the Navigator pane, click My Jobs.

66. You can see the job listed here. From its details, you can see that the task has run
successfully, with 11 rows processed.

122 Module 4: Publications


67. Close the task from the navigator pane.

Create a Data Synchronization task to load data into your Salesforce Contacts object
68. In the Navigator pane, click New.

Module 4: Publications 123


69. In the New Asset window, select Tasks > Synchronization Task.

70. Click Create.


71. In the Definition step, enter the Task name as Load_Salesforce_Contacts.
72. To select the location of the task, for the Location field, click Browse.
Note: If the location is already set to your training folder, go to step 74.

124 Module 4: Publications


73. From the list, select your training folder and click Select.

74. Select the Task Operation as Insert.

75. Click Next.

Module 4: Publications 125


76. In the Source step, for the Connection field, select your Flat File connection
FIRSTNAME_XX_LocalCSVFiles.

77. Retain the Source Type as Single and select the Source Object as CONTACT.csv.

126 Module 4: Publications


78. Click Next.

79. In the Target step, for the Connection field, select your Salesforce connection
FIRSTNAME_XX_Salesforce.

Module 4: Publications 127


80. Select the Target Object as Contact.

81. Click Next.


82. In the Data Filters step, click Next.

128 Module 4: Publications


83. In the Field Mapping step, map the fields as per the table given below:
Property Value
Salutation Salutation
First_Name First Name
Last_Name Last Name
Title Title
Mailing_street Mailing Street
Mailing_city Mailing City
Mailing_state Mailing State/Province
Mailing_zip Mailing Zip/Postal Code
Mailing_country Mailing Country
Phone Business Phone
Mobile Mobile Phone
Fax Business Fax
Email Email
Note: Do not map the fields which are already auto-mapped correctly.

Module 4: Publications 129


84. For the Account ID field in the target, click the Lookup icon.

85. In the lookup field properties window, select the Lookup Connection as your Salesforce
connection FIRSTNAME_XX_Salesforce and Lookup Object as Account.

130 Module 4: Publications


86. In the Lookup Fields section, select the Source Fields as Account_Name and Lookup
Fields as Account Name.

87. In the Lookup Return Value section, select the Output Field as Account ID and click
OK.

Module 4: Publications 131


88. View the lookup condition and click Validate Mapping.

Note: If the validation fails with an error saying, ‘Cannot connect to the
Salesforce.com web service’, click on Refresh Fields and validate the mapping again.

132 Module 4: Publications


A message ‘The field mapping is valid and has no errors’ appears.

89. Click Save.

Module 4: Publications 133


90. Click Finish.

91. Run the task.

134 Module 4: Publications


92. In the Navigator pane, click My Jobs.

93. You can see that the task has run successfully with 17 success rows.

Note: If the task is still running, wait for 3-5 seconds. If you see the notification saying -
‘Updates available’, click the Refresh icon to refresh the status of the job.

Module 4: Publications 135


94. Close the task from the navigator pane.

In this lab, you have successfully created Flat File and Salesforce connections and
loaded the Accounts and Contacts data into Salesforce.

This concludes the lab.

136 Module 4: Publications


Module 4: Publications
Lab 4-2: Create a Data Synchronization (DSS) Task in IICS for
Publication
Overview:
CIH uses the Data Integration synchronization task to publish data from source applications to
the Cloud Integration Hub publication repository and to consume data from the publication
repository into target applications.

In this lab, you will create a Data Synchronization task that will be used in later labs for
publishing data.

Scenario:
James, the Developer, creates a Data Synchronization task in IICS and publishes the Contacts
data from Salesforce to the hub using the Data Integration tasks.
Objectives:
 Create a Data Synchronization Task to move data from source to a topic
Duration:
15 minutes

Tasks
In this lab, you will create a synchronization task in the Data Integration service. You will
configure the synchronization task to write the Contacts details from Salesforce to Hub. You will
use this task in the subsequent labs in a publication to publish the data to the hub.

Module 4: Publications 137


1. In the Chrome browser, log in to IICS and navigate to the Data Integration service (if
navigated away).

2. To create a new Synchronization Task, in the Navigator pane, click New.

138 Module 4: Publications


3. In the New Asset window, select Tasks > Synchronization Task.

4. To create a synchronization task, click Create.


A New Synchronization Task wizard appears.

5. In the Definition step, enter the Task name as pub_Contact_SFDC_data.

Module 4: Publications 139


6. Ensure that the Location is set to your training folder CIH_XX_FIRSTNAME.

7. Select the Task Operation as Insert.

8. Click Next to go to the Source step.


9. In the Source step, for the Connection field, select your Salesforce connection
FIRSTNAME_XX_Salesforce.

140 Module 4: Publications


10. Retain the Source Type as Single and select the Source Object as Contact.

Note: You might see the Data Preview section for the selected source or target based
on the user role and privileges.
11. Click Next.
12. In the Target step, for the Connection field, select Cloud Integration Hub.

Module 4: Publications 141


13. To select the Target Object, click Select.

14. In the Select Target Object window, select the topic table Salesforce_Data/Contact and
click Select.

142 Module 4: Publications


15. Click Next.

16. In the Data Filters step, click Next.

Module 4: Publications 143


17. In the Field Mapping step, map the fields as per the table given below:
Note: Do not map the fields which are already auto-mapped correctly.
Source: Contact Target: Salesforce_Data/Contact
Salutation Salutation
First Name First_Name
Last Name Last_Name
Title Title
Mailing Street Mailing_street
Mailing City Mailing_city
Mailing State/Province Mailing_state
Mailing Zip/Postal Code Mailing_zip
Mailing Country Mailing_country
Business Phone Phone
Mobile Phone Mobile
Business Fax Fax
Email Email

144 Module 4: Publications


18. For the Account_Name field in the target, click the Lookup icon.

19. In the lookup field properties window, select the Lookup Connection as your Salesforce
connection FIRSTNAME_XX_Salesforce, and Lookup Object as Account.

Module 4: Publications 145


20. In the Lookup Fields section, select the Source Fields as Account ID, and Lookup
Fields as Account ID.

21. In the Lookup Return Value section, select the Output Field as Account Name and
click OK.

146 Module 4: Publications


22. To validate the mapping, click Validate Mapping.

Note: If the validation fails with an error saying, ‘Cannot connect to the
Salesforce.com web service’, click on Refresh Fields and validate the mapping again.
A message ‘The field mapping is valid and has no errors’ appears.

Module 4: Publications 147


23. To save the changes, click Save.

24. To complete the task and save it to your training folder, click Finish.

148 Module 4: Publications


25. Close the task.

Thus, you have created a Data Synchronization task that is ready to be used in the CIH
publication.

This concludes the lab.

Module 4: Publications 149


150 Module 4: Publications
Module 4: Publications
Lab 4-3: Create a Publication in CIH using the DSS Task
Overview:
Publications are entities that define how applications publish data to Cloud Integration Hub,
including the type, format, and schedule of data publication. Publications publish data to topics.
Multiple publications can publish to the same topic.

In this lab, you will create a Publication using the DSS task.

Scenario:
To achieve data federation across the organization, James creates publications in CIH and
publishes data to the topics using the DSS task.

Objectives:
 Create a Publication
 Verify Publication Event
Duration:
15 minutes

Tasks
Now that you have a task created in the Data Integration service (Synchronization task), you will
use this task in a publication and publish the contacts details from the salesforce application to
your hub.
1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

Module 4: Publications 151


2. To create a Publication, from the Navigator pane, click New.

152 Module 4: Publications


3. From the new asset type window, click Publication.

A New Publication page appears. The New Publication tab is added to the Navigator
pane.

Module 4: Publications 153


4. Set the following properties in the General Details section:
Property Value
Publication Name Contact_SFDC_DSS
Description This Publication is used to publish the Salesforce Contact
Data to a Topic.
Location CIH_XX_FIRSTNAME
Mode Enabled
Publication Method Publish with a Data Integration Task
Application Salesforce
Topic Salesforce_Data
Task pub_Contact_SFDC_data (DSS)

5. In the Scheduling section, select By Schedule.


6. From the drop-down, select Every n minutes and set ‘Repeat running’ to 5 minutes.

154 Module 4: Publications


7. Save the publication.

A message ‘Publication created successfully’ appears on the screen.

8. You need to wait for 5 minutes for the publication to start.


9. From the Navigator pane, go to the Events tab.

Module 4: Publications 155


10. The Publication task should be completed successfully.
Note: As you have scheduled it to run every 5 minutes, the publication event gets
triggered only after the whole 5 minutes.

Note: If the event is still in progress, the task status on the Events page will appear as
‘Processing’ instead of ‘Complete’. Click the Refresh icon periodically for the latest
updates.

11. Go to the Publication Contact_SFDC_DSS tab on the Navigator pane.

12. In the Scheduling section, set the publication to run ‘Manually or by an external
trigger’.

156 Module 4: Publications


13. Save the changes.

A message ‘Publication updated successfully.’ appears on the screen.

Module 4: Publications 157


Notes:
a. To run the Publication manually, go to the Explore tab.
b. Navigate to your training folder and locate your Publication.
c. You can either right-click on the selected task or select from the vertical ellipsis icon
drop-down to run it.

14. Close the Publication.

In this way, you can create a publication using a Data Synchronization task.

This concludes the lab.

158 Module 4: Publications


Module 4: Publications
Lab 4-4: Create a Mapping Task in IICS for Publication
Overview:
CIH uses the Data Integration Mapping task to publish data from source applications to the
Cloud Integration Hub publication repository and to consume data from the publication
repository into target applications.

In this lab, you will create a Mapping task in IICS using various transformations to transform the
data into the desired format. These will be used in later labs for publishing data.

Scenario:
To load the account details from multiple flat files into the hub, James creates a mapping task in
IICS and uses the task in CIH in later labs.

Objectives:
 Create a mapping in IICS
 Create a Mapping task
Duration:
40 minutes

Tasks
You’ve learned to publish data into the hub using a Synchronization task. Now, you will see how
to run a publication using a Mapping task. To accomplish this, you must have a valid mapping
task in IICS. In this lab, you will create a mapping and configure it to read the Accounts details
from Salesforce and write it to the hub.
1. To place the required file in your flat file directory, on your machine, navigate to the
folder C:\CIH Training and copy the CSV file Account_Type.

Module 4: Publications 159


2. Paste the files in your flat file directory C:\IICSLabFiles.

3. In the browser, log in to IICS and navigate to the Data Integration service.

160 Module 4: Publications


4. For creating a new mapping, in the Navigator pane, click New.

5. In the New Asset window, select Mappings > Mapping.

Module 4: Publications 161


6. Click Create.
A New Mapping wizard appears.

7. In the Properties pane, enter the mapping name as m_pub_SFDC_Acc_CIH.


8. Ensure that the location is set to your training folder CIH_XX_FIRSTNAME.

9. In the mapping canvas, select the Source transformation.

162 Module 4: Publications


10. On the General tab in the Source Properties pane, name the source transformation as
Src_Salesforce_Acc.

11. In the Source Properties pane, click the Source tab.

12. In the Connection field, from the drop-down, select your Salesforce connection
FIRSTNAME_XX_Salesforce.
13. Retain Source Type as Single Object.

Module 4: Publications 163


14. For the Object field, click Select… choose Account object, and click OK.

164 Module 4: Publications


15. Add a new Source transformation to the canvas.

Here, in this logic, you are adding two sources with different accounts details and you
will join them using the Joiner transformation and load the consolidated data to the
target.
16. On the General tab in the Source Properties pane, name the source transformation as
Src_FF_Acc_Type.

17. In the Source Properties pane, click the Source tab.

18. In the Connection field, from the drop-down, select your Flat File connection
FIRSTNAME_XX_LocalCSVFiles.
19. Retain Source Type as Single Object.

Module 4: Publications 165


20. For the Object field, click Select, choose Account_Type object, and click OK.

21. From the list of transformations, to join the multiple sources, add a Joiner transformation
to the canvas.

166 Module 4: Publications


22. Delete the link connecting Src_Salesforce_Acc and Target transformations.

23. Click on the Joiner transformation.

Module 4: Publications 167


24. Link Src_Salesforce_Acc to the Master and Src_FF_Acc_Type to the Detail.

25. On the mapping canvas, select the Joiner transformation, if it is not highlighted.

26. In the Properties pane General tab, name the transformation as jnr_Acc.

27. To define the join condition, in the Properties pane, select the Join Condition tab.

168 Module 4: Publications


28. A message saying “Field Name conflicts detected” is displayed. Click the Resolve Field
Name Conflicts link.

29. To rename the fields of the Detail source Src_FF_Acc_Type, from the Bulk Rename
Options drop-down, select Prefix. In the Specify field, enter FF_ and click OK.

30. Retain the Join Type as Normal.

31. To add a join condition, click icon.

Module 4: Publications 169


32. From the Master drop-down, select Name, and from the detail drop-down, select
FF_ACCOUNT_NAME.

33. Add an Expression transformation to the canvas.

34. On the General tab in the Expression Properties pane, name the expression
transformation as exp_phn_format.
35. Link jnr_Acc to the exp_phn_format.

170 Module 4: Publications


36. Select the exp_phn_format transformation, if it is not already selected.

37. In the Expression Properties pane, select the Expression tab.

38. To create a new field, click the New Field icon.

Module 4: Publications 171


39. In the New Field window, enter the following details and click OK:
Property Value
Field Type Output Field (default value)
Name NumberFormatting
Type string (default value)
Precision 10 (default value)

40. To configure the expression for the field, click Configure.

172 Module 4: Publications


41. In the Field Expression window for the NumberFormatting Output Field, enter the
following expression to clean the Phone number fields:
ReplaceChr(0, Phone, '( -)', NULL)

42. Validate the expression and click OK.

43. On the mapping canvas, select the Target transformation.

Module 4: Publications 173


44. On the General tab in the Target Properties pane, name the Target transformation as
Tgt.

45. Link exp_phn_format to Tgt.

46. Select the Tgt transformation and in the Target Properties pane, select the Target tab.

Note: For mappings to be used in Cloud Integration Hub, the target must be
parameterized.

174 Module 4: Publications


47. To create a parameterized connection, click New Parameter.

A New Input Parameter window appears.

48. Enter the Name as p_Tgt. Click OK.

Module 4: Publications 175


49. From the Target Type drop-down, select Parameter.

50. For the Parameter field, click New Parameter.

A New Input Parameter window appears.

176 Module 4: Publications


51. Enter the Name as p_CIH_Topic. Click OK.

52. In the Target Properties pane, select the Field Mapping tab.

53. Change the Field map options from Manual to Completely Parameterized

Module 4: Publications 177


54. To create a parameterized field mapping, click New Parameter.

A New Input Parameter window appears.


55. Enter the Name as p_CIH_Field. Click OK.

56. Validate the mapping.

178 Module 4: Publications


57. Save the mapping.

58. To create a New Mapping task, from the Actions menu, select the New Mapping
Task… option.

A New Mapping Task page appears.

59. Enter the Task Name as mct_pub_SFDC_Acc_CIH.

Module 4: Publications 179


60. From the Runtime Environment drop-down, select your secure agent.

61. Click Next.


62. In the Targets step, from the p_Tgt Connection drop-down, select Cloud Integration
Hub.
63. For p_CIH_Topic Object, click Select and choose Salesforce_Data/Account_1.

64. Click Next.

180 Module 4: Publications


65. In the Input Parameters step, map the fields as per the following table:
Incoming Fields Target Fields
Id ACCOUNT_ID
FF_ACCOUNT_NAME ACCOUNT_NAME
BillingCity BILLING_CITY
BillingState BILLING_STATE
BillingPostalCode BILLINGPOSTALCODE
BillingCountry BILLINGCOUNTRY
NumberFormatting PHONE
Website WEBSITE
FF_Type ACCOUNT_TYPE
FF_Industry INDUSTRY

Module 4: Publications 181


Note: Do not re-map if the fields are auto-mapped correctly. To clear any existing
mapping of a field, click the icon corresponding to it.

66. To validate the template and parameters, click Validate.

182 Module 4: Publications


A message “The template and parameters are valid” appears.

67. Save the task.

Module 4: Publications 183


A message “Saved Successfully” appears.

68. Click Finish.

69. Close the task.


Thus, you have created a Mapping task that is ready to be used in the CIH publication.

This concludes the lab.

184 Module 4: Publications


Module 4: Publications
Lab 4-5: Create a Publication in CIH using the Mapping Task
Overview:
You have seen how to publish data using a DSS task. You will now learn how to publish data
using a Mapping task.

In this lab, you will create a Publication using a mapping task and publish data.

Scenario:
James creates publications in CIH and publishes data to the topic using a mapping task that
was created in the previous lab.

Objectives:
 Create a Publication
 Verify Publication Event
Duration:
15 minutes

Tasks
In this lab, you will see how to publish data into the hub using a mapping task. Here, you will
publish the accounts data into the hub.
1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

Module 4: Publications 185


Note: The view differs depending on the number and type of entities defined in your
Cloud Integration Hub console.
2. To create a Publication, from the Navigator pane, click New.

186 Module 4: Publications


3. Select Publication.

A New Publication page appears. The New Publication tab is added to the Navigator
pane.

Module 4: Publications 187


4. Set the following properties with their values in the General Details section:
Property Value
Publication Name Account_SFDC_MTT
Description This Publication is used to publish the Salesforce
Account Data to a Topic.
Location CIH_XX_FIRSTNAME
Mode Enabled
Publication Method Publish with a Data Integration Task
Application Salesforce
Topic Salesforce_Data
Task mct_pub_SFDC_Acc_CIH (MTT)

5. In the Scheduling section, retain the default option Manually or by an external trigger.

188 Module 4: Publications


6. To save the changes made, click Save.

A message ‘Publication created successfully’ appears on the screen.


7. From the Navigator pane, go to the Explore tab.

8. Navigate to your training folder CIH_XX_FIRSTNAME.

Module 4: Publications 189


9. Right-click the publication Account_SFDC_MTT and select Run.

As you have set the publication scheduling option to run manually or by an external
trigger, you must open the publication and manually run it.
A message ‘Publication started successfully’ appears on the screen.

10. From the Navigator pane, go to the Events tab.

190 Module 4: Publications


11. Observe that the Event Status for the Publication task shows as Complete.

Note: If the event is still in progress, the task status on the Events page will appear as
‘Processing’ instead of ‘Complete’. Click the Refresh icon periodically for the latest
updates.
12. Close the Publication.

In this way, you can create a publication using a Mapping Task.

This concludes the lab.

Module 4: Publications 191


192 Module 4: Publications
Module 4: Publications
Lab 4-6: Create a Compound Publication Using Mapping Task
Overview:
A Compound Publication is a publication process that publishes single or multiple data sets to
multiple topics with a single Data Integration mapping task.

In this lab, you will first create the topics required for compound publication in CIH, then create a
Mapping task in IICS, and finally create a compound publication in CIH.

Scenario:
For any product manufacturing company, you will have a few products that will not qualify for
the quality check and hence be discarded. Now, you have mixed data of qualified and
unqualified products in a flatfile. Wherein, the products that have passed the quality checks
were given a status ‘1’ and the products that failed a status code ‘0’. James will now create a
mapping task in IICS that splits the products based on their quality check codes and publishes
the data into two different topic tables.

Objectives:
 Create topic tables in CIH
 Create a mapping in IICS
 Create a mapping task in IICS
 Create a compound publication in CIH
Duration:
45 minutes

Tasks

Module 4: Publications 193


Create topic tables in CIH
In this section, you will copy the required file into your flatfile directory and create a new topic
table to save the qualified products data.

1. To place the required file in your flat file directory, on your machine, navigate to the
folder C:\CIH Training and copy the CSV file Product_Quality.

2. Paste the files in your flat file directory C:\IICSLabFiles.

3. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

194 Module 4: Publications


4. Create a new Topic and specify the Topic Name as Product_Quality_Passed.
5. Set the asset Location to your working directory CIH_XX_FIRSTNAME.

6. To create a table in a topic structure manually, Under the Topic Structure section, click
the Create Table From option and select New Table.

7. In the Create New Table window, enter Table Name as Quality_Passed, from the
Number of columns drop-down, select 4, and click Create.

Module 4: Publications 195


8. Click on the column names and rename them as follows:
From To Data Type
field1 Product_Id DOUBLE
field2 Product STRING
field3 Brand STRING
field4 Quality_Check INT32

9. Save and close the Topic.

Self-Try Exercise (Mandatory)


In this section, you will create another topic table in CIH to save the unqualified products data.

10. Similarly, create another topic with the Topic Name as Product_Quality_Failed.
11. Configure a topic under with table name as Qualty_Faied and with other Topic Structure
details same as above (steps 6 and 7).

196 Module 4: Publications


12. Save and close the topic.

Module 4: Publications 197


Create a Mapping in IICS
In this section, you will create a Mapping in the Data Integration service. As you want to split the
product data that is present in a flatfile into two different tables, your source connection should
be a flatfile connection. As you are publishing the data to the hub, your target connection should
be the CIH connection. Also, you will need to write the qualified products data into one table and
the unqualified products data into another table, you need two targets in your mapping.

13. In the browser, log in to IICS and navigate to the Data Integration service.

14. For creating a new mapping, in the Navigator pane, click New.

198 Module 4: Publications


15. In the New Asset window, select Mappings > Mapping.

16. Click Create.


A New Mapping wizard appears.

17. In the Properties pane, enter the mapping name as m_compound_pub.

Module 4: Publications 199


18. Ensure that the location is set to your training folder CIH_XX_FIRSTNAME.

19. In the mapping canvas, select the Source transformation.


20. On the General tab in the Source Properties pane, name the source transformation as
Src_Product_Quality.

200 Module 4: Publications


21. In the Source Properties pane, click the Source tab.
22. In the Connection field, from the drop-down, select your Flat File connection
FIRSTNAME_XX_LocalCSVFiles.
23. Retain Source Type as Single Object.
24. For the Object field, click Select, choose Account_Type object, and click OK.
25. From the list of transformations, to filter out the qualified and unqualified data into two
different groups, add a Router transformation to the canvas.
26. Delete the link connecting Src_Product_Quality and Target transformations and link
Src_Product_Quality to the Joiner transformation.

27. On the mapping canvas, select the Router transformation, if it is not highlighted.
28. To define the filter condition, in the Properties pane, select the Output Groups tab.

29. Add a new output group using the Add icon at the top-right corner of the Properties
panel.

Module 4: Publications 201


30. Specify the group name as Qualified_Products.

31. To configure the filter condition, click the Configure hyperlink next to the group name.

32. Add a new filter condition and set the following properties and click OK:
Field Name Operator Value
Quality_Check = 1

202 Module 4: Publications


33. From the mapping canvas, to view the output groups, under the Router transformation,
click the icon.

34. Link the Qualified_Products port group to Target.

35. From the mapping canvas, select Target and rename it to tgt_qualified.

Module 4: Publications 203


36. In the Target Properties pane, select the Target tab.
Note: For mappings to be used in Cloud Integration Hub, the target must be
parameterized.
37. To create a parameterized connection, click New Parameter.

A New Input Parameter window appears.

38. Enter the Name as p_tgt1. Click OK.


39. From the Target Type drop-down, select Parameter.

204 Module 4: Publications


40. For the Parameter field, click New Parameter.

A New Input Parameter window appears.

Module 4: Publications 205


41. Enter the Name as p_CIH_data1. Click OK.

42. In the Target Properties pane, select the Field Mapping tab.

43. Change the Field map options from Manual to Completely Parameterized

44. To create a parameterized field mapping, click New Parameter.

A New Input Parameter window appears.

206 Module 4: Publications


45. Enter the Name as p_CIH_fm1. Click OK.

46. Save the mapping.

47. From the mapping canvas, select the target tgt_qualified. Copy the target (Ctrl+C) and
paste it into the canvas (Ctrl+V).

Module 4: Publications 207


48. Select the new target tgt_qualified1 and rename it to tgt_unqualified.

49. Navigate to the Target tab. As the target connection is the CIH connection, retain the
Connection property value.

50. As the target topic table is different for storing the unqualified products data, to define a
new parameter, from the Parameter field, click the New Parameter button.

208 Module 4: Publications


51. Name the parameter as p_CIH_data2 and click OK.

52. Go to the Field Mapping tab and define a new parameter as p_CIH_fm2.

53. In the mapping canvas, connect the DEFAULT1 port group to the target
tgt_unqualified.
Note: All the records that do not belong to any of the defined groups will be stored in the
DEFAULT group. Thus, all the unqualified records will be captured in the default group.

Module 4: Publications 209


Tip: To arrange all the objects in the mapping canvas, use the Arrange All icon.

54. Save the mapping.

Create a mapping task


55. To create a New Mapping task, from the Actions menu, select the New Mapping
Task… option.

A New Mapping Task page appears.


56. Enter the Task Name as mct_compound_pub.

210 Module 4: Publications


57. From the Runtime Environment drop-down, select your secure agent.

58. Click Next.


59. In the Targets step, from the p_tgt1 Connection drop-down, select Cloud Integration
Hub.
60. For p_CIH_data1 Object, click Select and choose
Product_Quality_Passed/Quality_Passed.

Module 4: Publications 211


61. For p_CIH_data2 Object, click Select and choose
Product_Quality_Failed/Quality_Failed.

62. Click Next.


63. In the Input Parameters step, observe that all the Incoming Fields are already mapped
for both the p_CIH_fm1 and p_CIH_fm2 parameters.

212 Module 4: Publications


64. To validate the template and parameters, click Validate.

65. Save the task.

Module 4: Publications 213


66. Click Finish.

67. Close the task.


Thus, you have created a Mapping task that is ready to be used in the CIH publication.

Create a compound publication in CIH


Now that your Data Integration task is valid and ready, you will create a compound publication
and publish data to multiple topics.

68. From the services window, switch to the Integration Hub service.

214 Module 4: Publications


69. Create a new publication and set the following properties with their values in the General
Details section:
Property Value
Publication Name Compound_Publication
Description This Compound Publication is used to publish the
qualified and unqualified product details into multiple
topic tables.
Location CIH_XX_FIRSTNAME
Mode Enabled
Publication Method Publish with a Data Integration Task
Application Oracle
Topic Product_Quality_Passed, Product_Quality_Failed
Task mct_compound_pub (MTT)
Note: To select multiple topics, use the drop down available at the Topic property field.
After selecting one topic, click the drop down again to select the next topic.

70. In the Scheduling section, retain the default option Manually or by an external trigger.

Module 4: Publications 215


71. Save the publication.

72. From the Navigator pane, go to the Explore tab.

73. Navigate to your training folder CIH_XX_FIRSTNAME.

216 Module 4: Publications


74. Locate and right-click the publication Compound_Publication, and select Run.

75. From the Navigator pane, go to the Events tab.

76. Observe that the Event Status for the Publication task shows as Complete.

Note: If the event is still in progress, the task status on the Events page will appear as
‘Processing’ instead of ‘Complete’. Click the Refresh icon periodically for the latest
updates.
77. Close the Publication.

In this way, you can create a Compound Publication to publish data to multiple topics.

This concludes the lab.

Module 4: Publications 217


218 Module 4: Publications
Module 4: Publications
Lab 4-7: Hub Overview
Overview:
The Hub Overview diagram provides a visual overview of the existing assets, grouped into
categories. When you hover the mouse pointer over an asset in the diagram, all related assets
are highlighted. For example, when you hover the mouse pointer over a topic, the applications
and the publications that publish to the topic and the subscriptions that subscribe to the topic
are highlighted.

In this lab, you will see a pictorial overview and the interdependency of various entities created
till lab 4-6.

Scenario:
Before modifying or deleting any assets in the hub, James wants to view the dependency flow to
check if those assets are dependent on any other assets. He uses the Hub Overview diagram to
analyze the lineage between the assets.

Objectives:
 View the Hub Overview
Duration:
10 minutes

Tasks

Module 4: Publications 219


1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

If you are already logged into the Integration Hub service, from the Navigator pane, click
the Home tab to view the Hub Overview diagram.

2. On the Hub Overview page, from the Topic circle, hover the mouse over
Salesforce_Data.
Note: Hover the mouse over the topic to view the topic name.

220 Module 4: Publications


3. Observe that all entities related to the Salesforce_Data topic are highlighted.

4. From the Topic circle, click Salesforce_Data.


5. The Hub Overview will drill down to the Salesforce_Data topic.

Note: At a high level, you can understand the following points:


i. The Topic Salesforce_Data gets data from two publications in Cloud Integration Hub.
ii. The two publications publishing the data to this topic are Account_SFDC_MTT and
Contact_SFDC_DSS.
iii. Both the publications are coming from the Salesforce application in Cloud Integration
Hub.

Module 4: Publications 221


6. To go back to the normal view, click Hub Overview.

In this way, you can view the hub overview diagram for various entities in the hub.

This concludes the lab.

222 Module 4: Publications


Module 4: Publications
Lab 4-8: Run a Publication Using Publish Data API
Overview:
The Cloud Integration Hub Publish Data REST API publishes data transactions directly to a
topic on the Cloud Integration Hub publication repository. You cannot use the API with
publications that trigger a Data Integration task.

In this lab, you will create a publication, and run it using Publish Data REST API.

Scenario:
James wants to trigger a publication by external API since it does not require to be scheduled to
run at particular intervals of time. To achieve this, he will use the REST API to trigger the
desired publication.

Objectives:
 Create a Publication
 Verify Publication event
Duration:
20 minutes

Tasks

Module 4: Publications 223


Now that you have seen how to publish data using Data Integration tasks such as the
Synchronization task and Mapping task. You will now see how to publish data using APIs. In
this lab, you will publish the product details.
1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

224 Module 4: Publications


2. To create a Publication, from the Navigator pane, click New.

3. To create a publication in the Cloud Integration Hub, from the list click Publication.

Module 4: Publications 225


A New Publication page appears. The New Publication tab is added to the Navigator
pane.

4. Set the following properties in the General Details section:


Property Value
Publication Name Product_details
Description This Publication is used to publish the Product Data
to a Topic.
Location CIH_XX_FIRSTNAME
Mode Enabled
Publication Method Publish data with an API
Application Oracle
Topic Products

226 Module 4: Publications


5. Save the publication.

A message ‘Publication created successfully’ appears on the screen.

Module 4: Publications 227


6. To copy the publication URL, click Copy.

7. From the Windows Start menu, search, and open the Postman application.

Note: If you do not have the Postman client tool on your machine, download it from any
browser and install it.

228 Module 4: Publications


8. If you are prompted for updates, click Dismiss.

9. The Create New window opens. Close it.

Module 4: Publications 229


10. Change the request type to POST.

11. In the request URL field, paste the publication URL.

12. Click the Authorization tab.

230 Module 4: Publications


13. Set the authorization type as Basic Auth.

14. In the Username and Password fields, enter your IICS login credentials.

Note: You can verify the password by clicking on the Show Password option.

Module 4: Publications 231


15. Go to the Headers tab, and add the following headers:
Key Value
Accept application/json
Content-Type application/json

16. Go to the Body tab and select raw. Choose JSON (application/json) as the format.

232 Module 4: Publications


17. To paste the body structure, navigate to the C:\CIH Training folder, and open the
Lab13_Publish_Data_API.txt file.

18. Copy the structure from the file.

Module 4: Publications 233


19. Navigate back to Postman and paste the copied structure in the Body.

20. Now that you are all set to run the request, click Send.

234 Module 4: Publications


21. Observe the response to the request sent.

You can verify the event status from the CIH console as well.
22. In the browser, navigate to IICS > Integration Hub service.
23. From the Navigator pane, go to the Events tab.

24. The Publication task should be completed successfully.

Note: If the event is still in progress, the task status on the Events page will appear as
‘Processing’ instead of ‘Complete’. Click the Refresh icon periodically for the latest
updates.

Module 4: Publications 235


25. Close the publication.

26. Close the Postman application.


In this way, you can create a publication to publish data using API.

This concludes the lab.

236 Module 4: Publications


Module 5: Subscriptions
Lab 5-1: Create a Subscription in CIH Using the DSS Task
Overview:
You can create a subscription using a DSS task in two ways:

 Create a Data Integration DSS task in IICS and use it in a Subscription. This is just
similar to the way you created a DSS task for publication in lab 8.
 The other way is while creating a subscription in CIH, create a DSS task using the
option Create New Task. Here, by default CIH takes the source connection as Cloud
Integration Hub. So, you only have to configure the source table, target connection,
and target table details.
In this lab, we will follow the second method of creating a subscription using the DSS task in
CIH.

Scenario:
James will subscribe to the topics to which he published data in the previous labs and consume
the data by creating subscriptions to various topics. He will create a Subscription using the DSS
task.

Objectives:
 Create a Subscription
 Verify Subscription event
Duration:
15 minutes

Tasks
Till now, you have seen different ways of publishing data into the hub. In this lab, you will learn
how to read/consume data from the hub. Here, you will read the Contacts details from the hub
and write the data into a flat file.
First, place the required empty target file from your training folder to your flat files folder. By
doing this, the secure agent can access the target file.

Module 5: Subscriptions 237


1. To place the required file in your flat file directory, on your machine, navigate to the
folder C:\CIH Training, and copy the CSV file Contact_Sub.

2. Paste the files in your flat file directory “C:\IICSLabFiles”.

238 Module 5: Subscriptions


Now, you will log into CIH and create a subscription to consume data from the hub. You will
accomplish this using a Data Synchronization task. For subscriptions, you can create a DSS
task from the CIH console itself. Let us see how to create it.
3. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

4. To create a Subscription, from the Navigator pane, click New.

Module 5: Subscriptions 239


5. Select Subscription.

A New Subscription page appears. The New Subscription tab is added to the Navigator
pane.

240 Module 5: Subscriptions


6. Set the following properties in the General Details section:
Property Value
Subscription Name Contact_sub_DSS
Description This Subscription is used to subscribe to the Contact
data from the Salesforce_Data topic and load it to
the NetSuite application.
Location CIH_XX_FIRSTNAME
Mode Enabled
Consumption Method Consume data with a Data Integration task
Application NetSuite
Topics Salesforce_Data

Module 5: Subscriptions 241


7. For a subscription, to create a new DSS task from the CIH console, from the Task
property field, click Create New Task.

The Create New Task window opens.

8. Enter the Task Name as sub_Contact_SFDC_data.


9. For Source, click the drop-down, and select Salesforce_Data/Contact.
10. For Connection, click the drop-down, and select your flat file connection
FIRSTNAME_XX_LocalCSVFiles.
Note: This is your target connection. Here, by default CIH takes the source connection
as Cloud Integration Hub.

242 Module 5: Subscriptions


11. Retain all the other default values.

12. Select the Target as Contact_Sub.csv.

Module 5: Subscriptions 243


13. To create the task, click Create.

The DSS task will be saved to the auto-create Default folder. After creating the DSS
task from CIH, the fields will be automatically mapped. A message ‘15 fields mapped
successfully’ appears on the screen.

244 Module 5: Subscriptions


14. In the Scheduling section, retain the default selection, that is, ‘When published data is
ready’.

Note:
 You can also set it to ‘Manually or by an External Trigger’ or ‘By schedule’.
 In this case, since you have selected the option ‘When published data is ready’,
the subscription will run automatically as soon as the data is available for it to
consume from the hub repository. No data is published to the hub repository on
the specified topic, so you must run the corresponding publication again. This will
make data available for the subscription to consume.
15. Save the subscription.

Module 5: Subscriptions 245


A message ‘Subscription created successfully’ appears on the screen.

16. Go to the Explore tab.

17. Navigate to your training folder.

18. Right-click the publication task Contact_SFDC_DSS and select Run.

246 Module 5: Subscriptions


19. From the Navigator pane, go to the Events tab.

20. Wait for the publication task to complete.


Note: You can refresh the event status by clicking the Refresh icon on the Events tab.

21. After the publication task is completed successfully, it immediately triggers all the
subscription tasks associated with the topic (Salesforce_Data). To view the subscription
tasks, click the black arrow icon for the publication.

After all the subscriptions associated with the publication are completed successfully, the
consumption status is indicated by the green flag icon.

Module 5: Subscriptions 247


22. Verify that the output file ‘Contact_Sub.csv' has been updated successfully. The Output
file is located at C:\IICSLabFiles\Contact_Sub.csv.

Note:
1. To run the Subscription manually, go to the Explore tab.
2. Locate the Subscription.
3. You can either right-click on the selected task or select from the vertical ellipsis icon
dropdown to run it.

248 Module 5: Subscriptions


23. Back in the CIH console, close the subscription.

In this way, you can create a subscription using a Data Synchronization task.

This concludes the lab.

Module 5: Subscriptions 249


250 Module 5: Subscriptions
Module 5: Subscriptions
Lab 5-2: Create a Mapping Task (MTT) in IICS for Subscription
Overview:
Subscriptions are entities that define how applications consume data from the Data Integration
Hub. Subscriptions subscribe to topics. When you create a subscription, choose the topic(s) to
which the application subscribes.

In this lab, you will create a Mapping task that will be used by subscription in the later labs.

Scenario:
To load the Accounts data from Salesforce to a flat file, James creates a Mapping task in IICS,
which later can be used in CIH to write the data to the target.

Objectives:
 Create a mapping in IICS
 Create a Mapping task
Duration:
40 minutes

Tasks
You’ve seen how to consume data using a DSS task. You will see how to consume data using a
Mapping task. For this, you must create a mapping task in IICS. In this lab, you will configure a
mapping to read the accounts data from the hub and validate the website details/column values
in the accounts data. At last, you will write the accounts details having a valid website column
value to a flat file.

1. To place the required file in your flat file directory, on your machine, navigate to the
C:\CIH Training folder, and copy the CSV file valid_ acc_data.

Module 5: Subscriptions 251


2. Paste the files in your flat file directory “C:\IICSLabFiles”.

3. In the browser, log in to IICS and navigate to the Data Integration service.

252 Module 5: Subscriptions


4. In the Navigator pane, click New.

5. In the New Asset window, select Mappings > Mapping, and click Create.

A New Mapping wizard appears.

Module 5: Subscriptions 253


6. In the Properties pane, enter the mapping name as m_sub_valid_website.
7. Make sure the location is set to your training folder CIH_XX_FIRSTNAME.

8. In the mapping canvas, select Source transformation.


9. On the General tab in the Source Properties pane, name the source transformation as
Src.

254 Module 5: Subscriptions


10. In the Source Properties pane, click the Source tab.

11. To create a parameterized connection, for the Connection field, click the New
Parameter button.

Module 5: Subscriptions 255


12. In the New Input Parameter window, enter the name as p_src, and click OK.

13. Choose Parameter as the Source Type, and for the Parameter field, click the New
Parameter button.

256 Module 5: Subscriptions


14. In the name field, enter the name p_src_topic, and click OK.

15. To save the mapping, click Save.

Module 5: Subscriptions 257


16. Delete the link joining the source transformation Src and Target transformation.

17. Now, drag and drop an Expression transformation on the canvas.


18. Link the Source transformation Src to the expression transformation.

258 Module 5: Subscriptions


19. Under the new expression transformation Properties pane, in the General tab, name the
expression as exp_validation.

20. Go to the Expression tab, click the New Field icon.

21. In the New Field window, retain Field Type as Output Field, enter the name as
valid_not_valid, and select integer as the Type.

Module 5: Subscriptions 259


22. Click OK.
23. For the valid_not_valid field, under the Expression column, click the Configure option.

24. From the pop-up window, choose Expression as Parameterized from the dropdown.

25. At the Parameter field, click the New Parameter button.

260 Module 5: Subscriptions


26. In the New Input Parameter window, enter the name p_valid_exp, and click OK.

27. Click OK.

28. Add a Filter transformation onto the canvas and link the expression transformation
exp_validation to the New Filter transformation.

Module 5: Subscriptions 261


29. In the General properties tab, name the filter as flt_valid.

30. In the Filter properties pane, click the Filter tab.

31. Retain the Filter condition as Simple and click the Add icon to add a new filter.

32. From the Field Name dropdown, select valid_not_valid, select the Operator as =, and in
the Value field enter 1.

262 Module 5: Subscriptions


33. Select the Target transformation on the canvas.

34. In the Target Properties pane, on the General tab, name the Target as tgt_valid.

35. Link the filter transformation flt_valid to the target transformation tgt_valid.

Module 5: Subscriptions 263


36. On the Target tab, beside the Connection field, click the New Parameter button.

37. In the New Input Parameter window, enter the name p_tgt, and click OK.

38. Select the Target Type as Parameter.

264 Module 5: Subscriptions


39. For the Parameter field, click the New Parameter button.

40. In the pop-up window, enter the name as p_tgt_obj, and click OK.

41. Retain the Operation as Insert.

Module 5: Subscriptions 265


42. On the Field Mapping tab, change the Field map options from Manual to Completely
Parameterized.

43. For the Parameter field, click the New Parameter button.

44. In the New Input Parameter window, enter the name as p_field_map, and click OK.

266 Module 5: Subscriptions


45. To check the mapping for errors/validation, click the Validate icon.

46. See if the mapping is valid and to apply the changes, save the mapping.

47. To create a New Mapping task, from the Actions menu, select the New Mapping
Task… option.

Module 5: Subscriptions 267


A New Mapping Task page appears.

48. Enter the Task Name as mct_sub_valid_website.


49. From the Runtime Environment dropdown, select your secure agent.

50. Click Next.


51. In the Sources step, from the p_src connection dropdown, select the Cloud Integration
Hub connection.

268 Module 5: Subscriptions


52. To select the p_src_topic object, click the Select button.

53. From the Select Source Object window, select Salesforce_Data/Account_1 topic, and
click Select.

Module 5: Subscriptions 269


54. Click Next.

55. In the Targets step, from the p_tgt Connection dropdown, select your flat file
connection FIRSTNAME_XX_LocalCSVFiles.
56. For p_tgt_obj object, click the Select button.

270 Module 5: Subscriptions


57. From the Select Target Object window, select valid_acc_data.csv, and click Select.

58. Click Next.

Module 5: Subscriptions 271


59. In the p_valid_exp Parameter Details section, click the New button.

60. In the Field Expression window, enter the expression:


IIF(REG_MATCH(WEBSITE,'(^[_a-z0-9-]+(\.[_a-z0-9-]+)*.[a-z0-9-
]+(\.[a-z0-9-]+)*(\.[a-z]{2,4})$)'),1, 0)

272 Module 5: Subscriptions


61. Validate the expression and click OK when you see the message “The expression is
valid.” This expression will check if the website is valid or not.

62. To map the Incoming Fields to Target Fields of p_field Parameter, hover the mouse over
Automatch, and select the Exact Field Name button.
Note: If the fields are already mapped correctly, verify the mapping and leave it.

Module 5: Subscriptions 273


63. Validate the template and parameter values by clicking the Validate button.

64. Save the task.

274 Module 5: Subscriptions


65. Click Finish.

66. Close all open tasks.

Thus, you have created a Mapping task and is ready to be used in the CIH subscription.

This concludes the lab.

Module 5: Subscriptions 275


276 Module 5: Subscriptions
Module 5: Subscriptions
Lab 5-3: Create a Subscription in CIH Using the MTT Task
Overview:
You have seen how to create subscriptions using the DSS task. Now, you will learn to use a
Mapping task to write the data from the hub to target.

In this lab, you will create a Subscription using the mapping task which you created in the
previous lab.

Scenario:
James needs to subscribe to the topics to which he published data in the previous labs and
consume the data by creating subscriptions to various topics. He will create a Subscription
using the mapping task.

Objectives:
 Create a Subscription
 Verify Subscription Event
Duration:
15 minutes

Tasks
As you have created a mapping task in the previous lab, you will now create a subscription and
consume the accounts data from the hub using the mapping task.

Module 5: Subscriptions 277


1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

2. To create a subscription, from the Navigator pane, click New.

278 Module 5: Subscriptions


3. Select Subscription.

A New Subscription page appears. The New Subscription tab is added to the Navigator
pane.

Module 5: Subscriptions 279


4. Set the following properties in the General Details section:
Property Value
Subscription Name sub_sfdc_acc_Workday
Description This Subscription is used to subscribe to the Account
data from the Salesforce_Data topic and load it to
the Workday application.
Location CIH_XX_FIRSTNAME
Mode Enabled
Consumption Method Consume data with a Data Integration task
Application Workday
Topics Salesforce_Data

5. Select the task as mct_sub_valid_website (MTT) from the drop down.

280 Module 5: Subscriptions


6. In the Scheduling section, retain the default selection - ‘When published data is
ready’.

Note:
 You can also set it to ‘Manually or by an External Trigger’ or ‘By schedule’.
 In this case, since you have selected the option ‘When published data is ready’, the
subscription will run automatically as soon as the data is available for it to consume
from the hub repository. No data is published to the hub repository on the specified
topic, so you must run the corresponding publication again. This will make data
available for the subscription to consume.
7. Save the subscription.

Module 5: Subscriptions 281


8. A message ‘Subscription created successfully’ appears on the screen.

9. Go to the Explore tab.

10. Navigate to your training folder.

282 Module 5: Subscriptions


11. Right-click the publication task ‘Account_SFDC_MTT’, and from the dropdown, click
Run.

12. From the Navigation pane, go to the Events tab.

13. Wait for the publication task to complete.


Note: You can refresh the event status by clicking the Refresh icon on the Events tab.

Module 5: Subscriptions 283


14. After the publication task is completed successfully, it immediately triggers all the
subscription tasks associated with the topic (Salesforce_Data). To view the subscription
tasks, click the black down arrow icon for the publication.

15. After all the subscriptions associated with the publication are completed successfully, the
publication status ‘Final’ appears, shown by the green flag icon under the
Consumption Status column.

284 Module 5: Subscriptions


16. Verify that the output file ‘valid_acc_data.csv' has been updated successfully. Output
file location: C:\IICSLabFiles\valid_acc_data.csv.

Note:
1. To run the subscription manually, go to the Explore tab.
2. Locate your subscription.
3. You can either right-click the selected task or select from the vertical ellipsis icon
dropdown to run it.

Module 5: Subscriptions 285


17. Close the csv file.
18. Back in the CIH console, close the subscription.

In this way, you can create a subscription using a Mapping task.

This concludes the lab.

286 Module 5: Subscriptions


Module 5: Subscriptions
Lab 5-4: Create a Mapping task (MTT) in IICS for Compound
Subscription
Overview:
Compound Subscriptions can consume data from multiple topics. You must ensure that all the
topics are of the same type. Till now you have seen consuming data from a single topic. Now
you will learn to consume data from multiple topics.

In this lab, you will create a Mapping task that will be used by Compound Subscription
(Compound subscription means a subscription that consumes data from multiple topics at a
time) in later labs.

Scenario:
James creates a Mapping task to load the Salesforce Account data and Contact data into the
target using Joiner transformation, which further can be used in a subscription.

Objectives:
 Create a mapping in IICS
 Create a Mapping Task
Duration:
60 minutes

Pre-requisites:
You will use the Account topic in the mapping and consume data from it. But, the Account topic
has no data in it. You will load data into this topic from the Salesforce accounts data. You will
achieve this using the DSS task.
1. Publish Accounts data from Salesforce Developer org to Account Topic in Cloud
Integration Hub.

Module 5: Subscriptions 287


a. In the IICS, go to the Data Integration service and create a DSS task
DSS_Salesforce_Account, to load the Accounts data from Salesforce to
Informatica Cloud Integration Hub.

288 Module 5: Subscriptions


Module 5: Subscriptions 289
b. In the Field Mapping step, map the fields with the values in the table given below:
Source: Account Target: Account/Account
Account ID ACCOUNT_ID
Account Name ACCOUNT_NAME
Billing City BILLINGCITY
Billing State/Province BILLINGSTATE
Billing Zip/Postal Code BILLINGPOSTALCODE
Billing Country BILLINGCOUNTRY
Account Phone PHONE
Website WEBSITE

c. Save and close the DSS task after validating the field mappings.

290 Module 5: Subscriptions


d. In the Informatica Cloud Integration Hub, create a Publication pub_Account using
the above-created DSS task, and run the publication manually.
Property Value
Publication Name pub_Account
Description This Publication is used to load Accounts data
from Salesforce to Account topic in CIH.
Location CIH_XX_FIRSTNAME
Mode Enabled
Publication Method Publish with a Data Integration Task
Application Oracle
Topic Account
Task DSS_Salesforce_Account

Module 5: Subscriptions 291


To write the data from the hub into a database, you must have a table in the database. You will
use the script provided to you in the training folder and create an oracle table. Later, you will use
this table as a target in your mapping.
2. Create a table tgt_CompoundSubscription in Oracle using the SQL script.
a. Launch SQL Developer and connect to the connection GMT with credentials
GMT_CRM/GMT_CRM.
b. Navigate to the folder C:\CIH Training, is open the CompoundSub_script.txt file,
and the script in it.

c. In the GMT connection worksheet, paste the script and run it. You should see that
the new target table is created.

d. Close the SQL Developer tool.


e. Close the notepad.

292 Module 5: Subscriptions


Tasks
In this lab, you will configure a mapping that reads data from multiple topics at a time and write
the consolidated data into a database target table.

1. In the browser, log in to IICS, and navigate to the Data Integration service.

2. In the Navigator pane, click New.

Module 5: Subscriptions 293


3. In the New Asset window, select Mappings > Mapping.

4. Click Create.
A New Mapping wizard appears.

5. In the Properties pane, enter the mapping name as m_CompoundSubscription.


6. Make sure the Location is set to your training folder CIH_XX_FIRSTNAME.

294 Module 5: Subscriptions


7. Enter the description ‘This mapping is used to subscribe Account and Contact data
to Oracle Application using Compound Subscription.’.

8. In the mapping canvas, select Source transformation.


9. On the General tab in the Source Properties pane, name the source transformation as
src_Account.

Module 5: Subscriptions 295


10. In the Source Properties pane, click the Source tab.

11. To create a parameterized connection, for the Connection field, click the New
Parameter button.

296 Module 5: Subscriptions


12. In the New Input Parameter window, enter the name as p_CIH, and click OK.

13. Choose the Source Type as Parameter, and for the Parameter field, click the New
Parameter button.

Module 5: Subscriptions 297


14. In the Name field, enter p_Account, and click OK.

15. Save the mapping.

298 Module 5: Subscriptions


16. Delete the link joining the source transformation src_Account and Target
transformation.

17. Add another Source transformation to the canvas.


18. On the General tab in the Source Properties pane, name the source transformation as
src_Contact.

19. In the Source Properties pane, click the Source tab.

Module 5: Subscriptions 299


20. To create a parameterized connection, for the Connection field, click the New
Parameter button.

21. In the New Input Parameter window, enter the name as p_CIH_2, and click OK.

300 Module 5: Subscriptions


22. Choose the Source Type as Parameter, and for the Parameter field, click the New
Parameter button.

23. In the Name field, enter p_Contact, and click OK.

24. Save the mapping.


25. Add a Joiner transformation to the canvas.
26. Click on the Joiner transformation.

Module 5: Subscriptions 301


27. Link the source transformation src_Account to the Master in the joiner transformation,
and the source transformation src_Contact to the Detail in the joiner transformation.

28. On the General tab in the Joiner Properties, name the transformation as
jnr_CompoundSubscription.

29. From the Properties pane, select the Incoming Fields tab.
30. To avoid the field name conflicts, for Master, at All Fields, select Rename.

31. In the Configure Field Rules window, for the Bulk Rename Options field, select Prefix
and specify the prefix as acc_. Click OK.

302 Module 5: Subscriptions


32. From the Properties pane, select the Join Condition tab.
33. From the Join Type dropdown, select Full Outer join.
34. From the Join Condition dropdown, select the Completely Parameterized option.
35. For the parameter field, click the New Parameter button.

36. In the name field, enter the name Join_Condition, and click OK.

Module 5: Subscriptions 303


37. Select the Target transformation on the canvas.

38. In the Target Properties pane, on the General tab, name the Target as tgt_Oracle.

39. Link the joiner transformation jnr_CompoundSubscription to the target transformation


tgt_Oracle.

304 Module 5: Subscriptions


40. In the target properties pane, select the Target tab.

41. To create a parameterized connection, click the New Parameter… button.

42. In the New Input Parameter window, enter the name p_Target, and click OK.

43. Select the Target Type as Parameter.

Module 5: Subscriptions 305


44. For the Parameter field, click the New Parameter button.

45. In the pop-up window, enter the name as p_Oracle, and click OK.

46. In the Target Properties pane, select the Field Mapping tab.
47. Change the Field map options from Manual to Completely Parameterized.

306 Module 5: Subscriptions


48. For the Parameter field, click the New Parameter button.

49. In the New Input Parameter window, enter the name as p_fm_Target, and click OK.

50. Validate the mapping.

Module 5: Subscriptions 307


51. Save the mapping.

52. To create a New Mapping task, from the Actions menu, select the New Mapping
Task… option.

A New Mapping Task page appears.

53. Enter the Task Name as mct_CompoundSubscription.

308 Module 5: Subscriptions


54. From the Runtime Environment dropdown, select your secure agent.

55. Click Next.


56. In the Sources step, from the p_CIH connection dropdown, select the Cloud Integration
Hub connection.
57. Retain the Source Type as Single, and select p_Account Object as Account/Account.

58. From the p_CIH_2 connection dropdown, select the Cloud Integration Hub connection.

Module 5: Subscriptions 309


59. Retain the Source Type as Single, and select p_Contact Object as
Salesforce_Data/Contact.

60. Click Next.


61. In the Target step, from the p_Target Connection dropdown, select your Oracle
connection FIRSTNAME_XX_Oracle.
62. For p_Oracle Object, select TGT_COMPOUNDSUBSCRIPTION.

.
63. Click Next.

310 Module 5: Subscriptions


64. In the Join_Condition Parameter Details section, click the New button.

65. In the Field Expression window, enter the expression:


acc_ACCOUNT_NAME = Account_Name

Module 5: Subscriptions 311


66. Validate the expression and click OK when you see the message “The expression is
valid.” This expression will check if the website is valid or not.

67. Map the Incoming Fields to Target Fields of p_fm_Target Parameter as shown in the
table below:
Note: If the fields are already mapped correctly, verify the mapping and leave it.
Source Target
BillingSystemId BILLINGSYSTEMID
Salutation SALUTATION
First_Name FIRST_NAME
Last_Name LAST_NAME
Title TITLE
Mailing_street MAILING_STREET
Mailing_city MAILING_CITY
Mailing_state MAILING_STATE
Mailing_zip MAILING_ZIP
Mailing_country MAILING_COUNTRY
PHONE PHONE
Mobile MOBILE
Fax FAX
Email EMAIL
Account_Name ACCOUNT_NAME
WEBSITE WEBSITE

312 Module 5: Subscriptions


68. Validate the template and parameter values by clicking the Validate button.

69. Save the task.

Module 5: Subscriptions 313


70. Click Finish.

71. Close all open tasks.

Thus, you have created a Mapping task and is ready to be used in the CIH subscription.

This concludes the lab.

314 Module 5: Subscriptions


Module 5: Subscriptions
Lab 5-5: Create a Compound Subscription in CIH Using the MTT
Task
Overview:
Compound Subscriptions can consume data from multiple topics. You must ensure that all the
topics are of the same type. Till now you have seen consuming data from a single topic. Now,
you will learn to consume data from multiple topics.

In this lab, you will create a Compound Subscription using the Mapping task created in the
previous lab.

Scenario:
James needs to subscribe to the topics and consume Salesforce Account object’s data and
Contact data. He will achieve this by creating a Compound Subscription using the mapping task.

Objectives:
 Create a Compound subscription
 Verify Compound Subscription events
Duration:
15 minutes

Tasks
As you’ve created a mapping task in this lab, you now use it in a subscription and consume the
data from multiple topics into a database table.

Module 5: Subscriptions 315


1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

2. To create a Compound subscription, from the Navigator pane, click New.

316 Module 5: Subscriptions


3. Select Subscription.

A New Subscription page appears. The New Subscription tab is added to the Navigator
pane.

Module 5: Subscriptions 317


4. Set the following properties with their values in the General Details section:
Property Value
Subscription Name Compound_Subscription
Description This Compound Subscription is used to subscribe
to the data from the Account and Salesforce_Data
topics and write it to the Oracle application.
Location CIH_XX_FIRSTNAME
Mode Enabled
Consumption Method Consume data with a Data Integration task
Application Oracle

318 Module 5: Subscriptions


5. From the Topics field, click the drop-down, and select Salesforce_Data and Account.

6. Select the task as mct_CompoundSubscription (MTT).

7. In the Scheduling section, select Manually or by an external trigger.

Module 5: Subscriptions 319


8. Save the subscription.

A message ‘Subscription created successfully’ appears on the screen.

9. Go to the Explore tab.

Note: Before running the subscription, you must run all the publications associated with
its topics, that is, Contact_SFDC_DSS and pub_Account.

320 Module 5: Subscriptions


10. Navigate to your training folder.

11. Right-click on the publication task ‘pub_Account’, and from the dropdown, click Run.

Module 5: Subscriptions 321


12. Similarly, run the publication Contact_SFDC_DSS.

13. Go to the Events tab and wait till you see the event statuses as “Complete” for both the
publications.
Note: The event status for Compound_Subscription shows Delayed since it is not yet
run.
14. Now, back in the Explore tab, go to your training folder, and run the compound
subscription Compound_Subscription.

Note: If you get the Information tab, click OK.

15. Go to the Events tab. Click the Refresh icon periodically if the event statuses show
processing.

322 Module 5: Subscriptions


16. Observe that the Event status changes to “Complete”.

17. Back in the CIH console, close the subscription.

In this way, you can create a compound subscription using a Mapping task.

This concludes the lab.

Module 5: Subscriptions 323


324 Module 5: Subscriptions
Module 5: Subscriptions
Lab 5-6: Run subscriptions using Consume Data API
Overview:
The Cloud Integration Hub Consume Data REST API is used to consume data directly from a
topic on the Cloud Integration Hub publication repository.

In this lab, you will create a subscription using the CIH Consume Data API and consume the
data.

Scenario:
James needs to subscribe to the topics to which he published data in the previous labs and
consume the data by creating subscriptions to various topics. He creates a subscription and
runs it using the CIH Consume Data API.

He creates a subscription that consumes the data from all the publications.

Anil, from the James team, requires a subscription in which he wants to consume the data from
the oldest publication to a topic.

David, from the James team, requires a subscription in which he wants to consume the data
from a particular publication from the list of available publications to the topic.

Objectives:
 Create a subscription
 Verify Subscription event
 Get the data of all the available publication events
 Get the data of the oldest publication event
 Get the data of a specific publication event
Duration:
35 minutes

Module 5: Subscriptions 325


Tasks
Create a Subscription to get the results based on API
1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service, if
navigated away.

326 Module 5: Subscriptions


2. To create a subscription, from the Navigator pane, click New.

3. Select Subscription.

Module 5: Subscriptions 327


A New Subscription page appears. The New Subscription tab is added to the Navigator
pane.

4. Set the following properties with their values in the General Details section:
Property Value
Subscription Name sub_product_details
Description This Subscription is used to consume data with
an API.
Location CIH_XX_FIRSTNAME
Mode Enabled
Consumption Method Consume data with an API
Application Oracle
Topic Products

328 Module 5: Subscriptions


5. Save the subscription.

A message ‘Subscription created successfully’ appears on the screen.

Module 5: Subscriptions 329


6. To run the subscription from the Postman, copy the subscription URL as shown below.

7. From the Windows Start menu, search, and open the Postman application.

8. If you are prompted for updates, click Dismiss.

330 Module 5: Subscriptions


9. The Create New window opens. Close it.

10. To open a new request tab, click the plus icon.

Module 5: Subscriptions 331


11. Change the request type to POST.

12. In the request URL field, paste the subscription URL copied earlier.

332 Module 5: Subscriptions


13. Go to the Authorization tab.

14. Set the authorization type as Basic Auth.

Module 5: Subscriptions 333


15. In the Username and Password fields, verify if the IICS login credentials are correct.

Note: You can verify the password by clicking on the Show Password option.
16. Go to the Headers tab and add the following headers:
Key Value
Accept application/json
Content-Type application/json

334 Module 5: Subscriptions


17. Go to the Body tab and select raw. Choose the format as JSON (application/json).

18. To paste the body structure, navigate to the C:\CIH Training folder, and open the
Lab19_Consume_Data_API_Getting_All_Records.txt file.

19. Copy the structure from the file.

Module 5: Subscriptions 335


20. Navigate back to Postman and paste the copied structure in the Body.

21. Close the notepad.


22. Now that you are all set to run the request, click Send.

336 Module 5: Subscriptions


23. Observe the response to the request sent.

Note: The response status shows “FAIL” since there is no pending data to consume. So,
you must make some data available for consumption. For this, trigger the publication
associated with that topic and re-send the subscription request.
24. In the Postman, click on the publication request tab which is already opened.

Module 5: Subscriptions 337


25. To paste the body structure, navigate to C:\CIH Training folder, and open the files
Lab13_Publish_Data_Test_Data1.txt, Lab13_Publish_Data_Test_Data2.txt, and
Lab13_Publish_Data_Test_Data3.txt.

26. You need to send the postman request with each test data. First, copy the data from the
Lab13_Publish_Data_Test_Data1.txt file.

338 Module 5: Subscriptions


27. Navigate back to Postman and paste the copied structure in the Body.

28. To run the request, click Send.

29. Now, copy the data from the Lab13_Publish_Data_Test_Data2.txt file.

Module 5: Subscriptions 339


30. Navigate back to Postman and paste the copied structure in the Body.

31. Send the request.


32. Now, copy the data from the Lab13_Publish_Data_Test_Data3.txt file.
33. Navigate back to Postman and paste the copied structure in the Body.

340 Module 5: Subscriptions


34. Click Send.

35. As the data is published successfully, navigate back to the subscription URL tab, and
send the subscription request.

36. Scroll down and observe that the data is consumed.

Module 5: Subscriptions 341


Getting the data of the oldest publication event
If you notice, in the above section when you run the subscription request with the aggregated
parameter as “true”, you have successfully consumed the data from all the available
publications (data from all the 3 publication events). Now, in this section, you will see what
happens if the aggregated parameter value is set to “false” (Hint: If you set the aggregated
value to false, then you fetch the data of the oldest publication – the data of only one publication
out of multiple available publications, that is, the oldest publication’s data).

37. In the same Subscription URL tab, modify the body structure.
38. To paste the body structure, navigate to C:\CIH Training folder, and open the
Lab19_Consume_Data_API_Getting_Old_Publish_Data.txt file.

39. Copy the structure from the file.

342 Module 5: Subscriptions


Note: Instead of copying the structure from the notepad file, you can change the value of
the aggregated parameter to false in the postman.
40. Navigate back to Postman and paste the copied structure in the Body.

41. Close the Notepad Lab19_Consume_Data_API_Getting_Old_Publish_Data.txt.


42. In the Postman, click on the publication request tab which is already opened.
43. Now run the publication URL using the 3 different test data structures by following steps
26 to 34.
44. As the publication request status shows “SUCCESS”, navigate back to the subscription
request tab.
45. Send the subscription request.

Module 5: Subscriptions 343


46. Observe that the data is consumed.

If you observe, only the data of one publication event is consumed, that is, the
publication data of the oldest event is consumed. Compare the Product Id of the data
published to identify the oldest publication’s data.

Getting specific published data details:


In the previous sections, you have seen the configuration details to be done to consume the
data of either the oldest publication or all the available publications. If you want to consume the
data of any other publication other than the oldest one, you will use the Publication Event ID of
the required event and consume the data.

47. To open a new request tab, click the plus icon.


48. Change the request type to POST.

344 Module 5: Subscriptions


49. In the request URL field, paste the subscription URL (copied at the step 6).
50. Go to the Authorization tab.
51. Set the authorization type as Basic Auth.
52. In the Username and Password fields, verify if the IICS login credentials are correct.

Note: You can verify the password by clicking on the Show Password option.
53. Go to the Headers tab and add the following headers:
Key Value
Accept application/json
Content-Type application/json
54. Go to the Body tab and select raw. Choose the format as JSON (application/json).
55. To paste the body structure, navigate to C:\CIH Training folder and open the
Lab19_Consume_Data_API_Getting_Specific_Publish_Data.txt file.

Module 5: Subscriptions 345


56. Copy the structure from the file.
Important: In the structure, you must provide the Publication Event Id of your publication
event as the event ID will vary from every single run.
To know your event ID, go to the IICS > Integration Hub service. Navigate to the Events
tab and copy the event ID for any of the publication event whose data is unconsumed. If
you do not have any unconsumed data, go to the publication tab in the postman and re-
run the publication with any test data.

57. Navigate back to Postman and paste the copied structure in the Body.

58. Now that you are all set to run the request, click Send.

Note: Remember to change the event ID with a valid ID in the body structure or else it
will fail.

346 Module 5: Subscriptions


59. Observe the response to the request sent.

Close all the open notepads.


60. In the browser, navigate to IICS > Integration Hub service.
61. From the Navigator pane, go to the Events tab.

62. The subscription task for which you copied the Event ID should be completed
successfully.

Note: If the event is still in progress, the task status on the Events page will appear as
‘Processing’ instead of ‘Complete’. Click the Refresh icon periodically for the latest
updates.

Module 5: Subscriptions 347


63. Close the subscription.

Note: In this way, we will subscribe to the applications and cosume data using API.

This concludes the lab.

348 Module 5: Subscriptions


Module 6: Cloud Integration Hub REST APIs
Lab 6-1: Run Cloud Integration Hub REST APIs
Overview:
The Cloud Integration Hub REST APIs are used to run publications and subscriptions, to publish
data directly to a specific topic and to consume data directly from a specific topic, to enable and
disable publications and subscriptions, to reprocess publication and subscription events, and to
query the status of publication and subscription events.

In this lab, you will run a publication, run a subscription, and reprocess an event using CIH
REST APIs.

Objectives:
 Run Cloud Integration Hub REST APIs
Duration:
40 minutes

Tasks
In this lab exercise, you will run different APIs available with CIH and view the results.

Module 6: Cloud Integration Hub REST APIs 349


Run Publication REST API Request
1. From the Windows Start menu, search and open the Postman application.

2. If you are prompted for updates, click Dismiss.

350 Module 6: Cloud Integration Hub REST APIs


3. The Create New window opens. Close it.

4. To open a new request tab, click the plus icon.

Module 6: Cloud Integration Hub REST APIs 351


5. Change the request type to POST.

6. In the request URL field, paste the following REST URL:


https://<pod>.<baseUrl>/dih-console/api/v1/publication/start
Note:
In the above URL, replace <pod> and <baseURL> with your IICS organization pod and
baseURL values.
You can get those values from your IICS login page.
In the screenshot below, pod is cih-pod1 and baseURL is dm-
us.informaticacloud.com

7. Go to the Authorization tab.

352 Module 6: Cloud Integration Hub REST APIs


8. Set the authorization type as Basic Auth, and in the Username and Password fields,
verify if the IICS login credentials are correct.

9. Go to the Body tab and select raw. Choose the format as JSON (application/json).

Module 6: Cloud Integration Hub REST APIs 353


10. In the request body, enter the following syntax:
{
“publicationName”: “pub_Account”,
“runDisabled”: “true”
}

Note: If you copy-paste the above syntax from the lab guide as some special characters
may get pasted in place of double quotes which may cause errors. In this case, re-do the
double-quotes.
11. To run the request, click Send.

354 Module 6: Cloud Integration Hub REST APIs


12. Observe the response to the request sent.

Note: The event ID changes for every single run.


13. In the Chrome browser, log in to IICS and navigate to the Integration Hub service, if
navigated away.

Module 6: Cloud Integration Hub REST APIs 355


14. From the navigator pane, go to the Events tab.

15. The publication task pub_Account should be completed successfully.

Note: If the event is still in progress, the task status on the Events page will appear as
‘Processing’ instead of ‘Complete’. Click the Refresh icon periodically for the latest
updates.

Run Subscription REST API Request


16. Navigate back to the Postman application and add a new request tab.

17. Change the Request Type to POST.


18. In the request URL field, paste the following REST URL:
https://<pod>.<baseUrl>/dih-console/api/v1/subscription/start
Note:
In the above URL, replace <pod> and <baseURL> with your IICS organization pod and
baseURL values.
You can get those values from your IICS login page.

356 Module 6: Cloud Integration Hub REST APIs


In the screenshot below, pod is cih-pod1 and baseURL is dm-
us.informaticacloud.com

19. Go to the Authorization tab.


20. Set the authorization type as Basic Auth, and in the Username and Password fields,
verify if the IICS login credentials are correct.

Module 6: Cloud Integration Hub REST APIs 357


21. Go to the Body tab and select raw. Choose the format as JSON (application/json).

22. In the request body, enter the following syntax:


{
“subscriptionName”: “Compound_Subscription”,
“runDisabled”: “true”
}

358 Module 6: Cloud Integration Hub REST APIs


23. In the CIH console, go to the Events tab, and observe that the consumption status
shows delayed.

24. In the Postman application, to send the request, click Send.

25. Observe the response.

Module 6: Cloud Integration Hub REST APIs 359


26. Navigate to the CIH console.
27. In the Events tab, refresh the page and observe that the consumption status is
complete. The status of the subscription Compound_Subscription is also complete.

Reprocess Event REST API


To Reprocess an event, it should be in the Error state. So, in this activity, we will introduce an
error and run the event. Once the event status shows as Error, we will rectify the error and
reprocess the event using Reprocess Event REST API.
28. On your machine, navigate to the C:\IICSLabFiles folder, and open the valid_acc_data
CSV file.

29. Minimize the CSV file and do not close it.


Note: Since the CSV is an output file for a subscription, the subscription will fail to write
the data to the CSV file since it is kept open.

360 Module 6: Cloud Integration Hub REST APIs


30. Navigate to IICS, and go to Integration Hub service.

31. From the navigator pane, go to the Explore page.

32. Navigate to your training folder.

Module 6: Cloud Integration Hub REST APIs 361


33. Right-click the publication Account_SFDC_MTT, and click Run.

34. Go to the Events tab and expand the publication event.

35. Observe that one of the associated subscriptions sub_sfdc_acc_Workday has failed
with Error event status, and hence the consumption status shows as Error.

36. Now, close the opened CSV file valid_acc_data.


37. Navigate to Postman, and open a new request tab.

362 Module 6: Cloud Integration Hub REST APIs


38. Change the Request Type to POST.
39. In the request URL field, paste the following REST URL:
https://<pod>.<baseUrl>/dih-console/api/v1/event/reprocess
Notes:
In the above URL, replace <pod> and <baseURL> with your IICS organization pod and
baseURL values.
You can get those values from your IICS login page.
In the screenshot below, pod is cih-pod1 and baseURL is dm-
us.informaticacloud.com

40. Go to the Authorization tab.

Module 6: Cloud Integration Hub REST APIs 363


41. Set the authorization type as Basic Auth, and in the Username and Password fields,
verify if the IICS login credentials are correct.

42. Go to the Body tab and select raw. Choose the format as JSON (application/json).

364 Module 6: Cloud Integration Hub REST APIs


43. In the request body, enter the following syntax:
{
“eventId”: “<eventId>”
}
Notes:
In the above syntax, replace the <eventId> with the evenId of the event that you want to
reprocess.
For example, in the screenshot below, the eventId of the failed subscription is 6560476.

44. To send the request, click Send.

Module 6: Cloud Integration Hub REST APIs 365


45. Observe the response.

46. Back in the CIH console, in the Events tab, refresh the page.

Note: Click the Refresh icon periodically to view the latest updates.
47. Observe that the subscription is now complete without any errors. Also, at the top of the
page, it shows 0 Error events.

366 Module 6: Cloud Integration Hub REST APIs


Note: Hover the mouse over the previous subscription’s Event Status, it shows that the
event is “Reprocessed”.

48. Close the Postman application.


In this way, you can run the Cloud Integration Hub REST APIs.

This concludes the lab.

Module 6: Cloud Integration Hub REST APIs 367


368 Module 6: Cloud Integration Hub REST APIs
Module 7: Asset Management
Lab 7-1: Export and Import Assets
Overview:
You can migrate Cloud Integration Hub assets from one organization to another organization.
Assets include applications, topics, publications, subscriptions, and monitoring rules.

In this lab, you will perform the export and import of CIH assets.

Scenario:
Luci, being the Administrator, wants to migrate all the assets to the Production environment
from the Development environment. She will achieve this by exporting all the assets from the
Development environment and importing them into the Production environment.

Objectives:
 Export assets from CIH
 Import assets into CIH
Duration:
15 minutes

Tasks
An asset needs to be exported for storing/using its structure in other organizations. Also, to
keep a backup, we can export the assets. You can import your assets back into your production
environment when required. Note that, the exported structures will be saved in an XML format.

In this lab, you will learn how to export and import assets in CIH.

1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

Module 7: Asset Management 369


2. In the upper-right corner of the Home page, click the Migration link.

The Migration window opens.

370 Module 7: Asset Management


3. To export the entities, you first have to select the entities. For that, in the Export tab,
click Select Entities.

4. From the Available Entities box, select the Salesforce application, and click >.

Module 7: Asset Management 371


Note:
 When you export a particular entity, all its dependent entities are also exported.
Here, all the entities related to the Salesforce application are also exported
(Topics/Publications/Subscriptions, and so on).
 You can filter the type of entity using the Entity Type drop-down.

5. Observe that, the Salesforce entity is now listed in the Selected Entities section. Click
OK.

372 Module 7: Asset Management


6. After selecting the entities, back in the Export tab, click Export.

7. A message ‘1 Entity was exported successfully’ appears on the screen.

Module 7: Asset Management 373


8. At the bottom of the page, observe that the exported file is download and it will be saved
to the Downloads folder.

9. On your Windows machine, go to the Downloads folder, and observe that the exported
file is present.

374 Module 7: Asset Management


10. Back in the CIH console, click on the Import tab.

11. In the Import tab, click Load File.

Module 7: Asset Management 375


12. Browse to the Downloads folder, select the exported file on your machine and, click
Open.

13. Scroll down and observe the dependencies.

376 Module 7: Asset Management


14. Scroll up for the Conflict Resolution Rules pane. For the entity Topic, set the conflict
resolution rule as Reuse.

15. To import the entities, click Import.

Module 7: Asset Management 377


16. Observe the Import Results. It says – 4 Entities successfully imported.

17. Click Done.

In this way, you can perform the export and import of CIH entities.

This concludes the lab.

378 Module 7: Asset Management


Module 7: Asset Management
Lab 7-2: Create and Manage Tags
Overview:
A tag is an asset property that you can use to list assets on the Explore page that share a
common attribute. Assign tags to assets so that you can easily view associated assets on the
Explore page. You can filter the Explore page to list assets that have a tag that you specify.

You can create tags that you want to use for an asset when you configure the asset properties,
or you can create multiple tags to be available for future use. In this lab, you will first create tags
and later assign them to the assets.
In this lab, you will create tags and assign them to CIH assets based on 4 regions North-East
region, North-West region, South-East region, and South-West region.

Scenario:
Robin, the regional officer wants to manage assets that only apply to their region. He will assign
tags to each of his organization's assets based on region, to identify them. Later, he will sort out
the assets based on his region.

Objectives:
 Create Tags
 Assign Tags
Duration:
15 minutes

Tasks
In this lab, you will create tags based on the regions/locations of the company branches and
assign tags to the assets belonging to a particular region.

Module 7: Asset Management 379


1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

2. From the Navigator pane, go to the Explore tab.

3. Navigate to your training folder.

380 Module 7: Asset Management


4. Click the Sort icon and choose Type.

5. For the Salesforce application, click the Actions menu and choose Properties.

The Properties window opens.

Module 7: Asset Management 381


6. To add a new tag, in the Tags field, enter NW region and press Enter on your keyboard.

7. Similarly, add the following tags. After entering each tag name, press Enter on your
keyboard.
Tags
SW region
NE region
SE region

8. Save the properties.

382 Module 7: Asset Management


9. Observe that the tags are associated with the Salesforce entity.

10. For the Product_details publication, click the Actions menu and select Properties.

11. For the Tags field, click the drop-down and select SW region.

Module 7: Asset Management 383


12. To save the changes in the product, click Save.

Note: Sometimes, the first tag in the drop-down list will be automatically added while
adding a tag to an entity. In that case, to remove a tag, click the cross icon on that tag.

13. View that the tag is added to the publication Product_details.

384 Module 7: Asset Management


14. Similarly, for the topic Products, add the SW region tag.

15. For the application NetSuite, add the NE region tag.

Module 7: Asset Management 385


16. From the Explore page, click on the SW region tag link for any entity.

17. Observe that it lists all the assets associated with the tag SW region.

18. Click the drop-down at All Tags and choose NE region.

386 Module 7: Asset Management


19. Observe that it lists all the assets associated with the tag NE region.

20. To navigate back to the assets page, click the drop-down at Explore and select Asset
Types.

In this way, you can create tags and assign them to the entities.

This concludes the lab.

Module 7: Asset Management 387


388 Module 7: Asset Management
Module 8: Events and Event Monitors
Lab 8-1: Manage Events
Overview:
Cloud Integration Hub generates events as it processes publications and subscriptions, and it
changes the status of the events as they go through the process. You can view all events on the
Events page. From the Events page, you can access the event history, session log, and
processing information, and reprocess events or change the event status. You can use filters to
search for specific events.

In this lab, you will explore various options that are available in CIH to manage an event.

Scenario:
Robin will manage events in CIH. He can check how many events ran on a particular
date/period and explore various search options available in CIH.

Objectives:
 Explore search options in CIH
 View the event properties
Duration:
15 minutes

Tasks
In this lab, you will use various options to manage your publication/subscription events.

1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

Module 8: Events and Event Monitors 389


2. From the Navigator pane, go to the Explore tab.

3. Navigate to your training folder.

4. Right-click the publication Account_SFDC_MTT and click Run.

390 Module 8: Events and Event Monitors


5. From the Navigator pane, go to the Events tab.

6. Observe that the event is now in the Processing state. To get updates about event
status, click the Refresh icon.

7. All events are processed completely, out of which 3 are successful and 1 is delayed.

Note: The number of Error events or Deplayed events may differ from the screenshot
above. However, the functionality or the steps remain same.
8. At the top of the page, click on the Delayed events link.

Module 8: Events and Event Monitors 391


9. When you click the Delayed events link, the search filter is automatically set to list all the
delayed events.

10. To clear the filter and restore the default results, click Restore Defaults.

11. To close the search filter, click the Cross icon at the top of the filter.

392 Module 8: Events and Event Monitors


12. To go back to the search bar, click the Filter icon.

13. Set the Status property to Reprocessed and click Apply Filter.

Note: You can perform a search based on Event ID, Type of the event, Status of the
event, Application, Time Frame, and so on.
14. You can now view all the events which are reprocessed.

Note: No. of reprocessed events might differ from the screenshot above and it depends
on the events reprocessed by you.
15. To close the search filter pane, click the Cross icon on top of the filter.

Module 8: Events and Event Monitors 393


16. For the subscription event Contact_sub_DSS, click the Actions menu and select
Reprocess.

17. Click OK.

A message ‘Reprocessed 1 events.’ appears on the screen.

18. Refresh the events page.

394 Module 8: Events and Event Monitors


19. Observe that Event Status of the new reprocessed event changes to “Complete”.

20. For the reprocessed subscription event Contact_sub_DSS, right-click, and select
Change Event Status.

21. In the Change Event Status window, for the New event status field, click the drop-down
and select Discarded.

22. Click OK.

Module 8: Events and Event Monitors 395


A message ‘Changed status of 1 events’ appears on the screen.

23. For the subscription event sub_sfdc_acc_Workday, right-click and select Session log.

24. The Session log opens in a new tab. You can use the session log of an event to look for
errors or event details.

396 Module 8: Events and Event Monitors


25. Close the session log tab.

26. For the subscription event sub_sfdc_acc_Workday, right-click and select Processing
Information.

27. The processing information of an event opens in the new tab. You can find the number
of target success rows and source success rows in the log.

Thus, you have explored various options present in the Events tab.

This concludes the lab.

Module 8: Events and Event Monitors 397


398 Module 8: Events and Event Monitors
Module 8: Events and Event Monitors
Lab 8-2: Create Monitoring Rule
Overview:
Monitoring rules are used to define which entities to monitor, what are the event statuses for
which to take action, and what actions Cloud Integration Hub takes when an event reaches the
defined status.

In this lab, you will create a monitoring rule to send email notifications if any subscription fails
with an error.

Scenario:
Robin, the IT Administrator, achieves the data integration governance across systems by
creating monitoring rules in CIH. He can create rules and perform actions on events, for
example, he can set to disable a subscription if the event shows an error status. He can
configure a rule to receive email notifications if any subscription event status shows as ‘Error’.

Objectives:
 Create Monitoring Rule
 Verify Results
Duration:
15 minutes

Tasks
In this lab, you will create a rule to monitor the subscription events in the hub, that is, you will
configure it to notify you via emails if any of the subscriptions fail to consume data.

1. In the Chrome browser, log in to IICS and navigate to the Integration Hub service (if
navigated away).

Module 8: Events and Event Monitors 399


2. To create a new Monitoring Rule, from the Navigator pane, click New.

3. To create a Monitoring Rule in the Cloud Integration Hub, from the list click Monitoring
Rule.

400 Module 8: Events and Event Monitors


A New Monitoring Rule window opens. A New Monitoring Rule tab is added to the
navigator pane.

4. Set the following properties with their values in the General Details section:
Property Value
Rule Name Notify_failed_sub
Description This Monitoring Rule sends out email notifications if any
subscription fails with Error.
Location CIH_XX_FIRSTNAME
Mode Enabled

Module 8: Events and Event Monitors 401


5. In the Affected Assets section, click the drop-down and select Subscription.

6. Select the Apply to all checkboxes. Selecting this checkbox applies the monitoring rule
to all the available subscriptions.

7. Scroll down to the Affected Statuses section and select Error.

402 Module 8: Events and Event Monitors


8. Scroll down to the Actions section.
9. In the Send email notification section, click Add.

The Username and Email fields are now editable.

10. Click Select User and select Non-existing User. In the email field, enter your active
email address (It can be any active personal/work email address).

Note: Optionally, you can also set to disable publications and subscriptions that are in
Rejected statuses (In this lab exercise, Rejected status is Error).

Module 8: Events and Event Monitors 403


11. To save the monitoring rule, click Save.

A message ‘Monitor created successfully’ appears on the screen.

404 Module 8: Events and Event Monitors


12. Before running a subscription, let us introduce an error so that the subscription fails. For
that, on your machine, navigate to the directory C:\IICSLabFiles and open the excel file
valid_acc_data.

Note: As the output file is kept open, CIH cannot access the file, and hence the
subscription fails to write the data, resulting in an error.
13. Back in the CIH console, from the Navigator pane, go to the Explore tab.

Module 8: Events and Event Monitors 405


14. Navigate to your training folder and run the publication Account_SFDC_MTT.

15. Go to the Events tab, refresh, and monitor the event status. Verify that the subscription
sub_sfdc_acc_Workday fails with event status ‘Error’.

16. You should get an email from the email address [email protected] to
your configured email Id.

406 Module 8: Events and Event Monitors


17. Navigate back to the CIH console and close the Monitoring rule.

18. Close the opened valid_acc_data.csv file.


In this way, you can configure Event Monitors to send email notifications.

This concludes the lab.

Module 8: Events and Event Monitors 407


408 Module 8: Events and Event Monitors
Module 10: Permissions
Lab 10-1: Permissions
Overview:
Permissions determine the access rights that a user has for a Secure Agent, Secure Agent
group, connection, schedule, or asset. Permissions add additional or custom security for an
object.

Permissions define which users and groups can read, update, delete, execute, and change
permissions on an object.

Scenario:
James wants few users to have restricted access to the assets created in his organization. He
will accomplish this task by assigning the asset level permissions that IICS supports throughout
all the services (IICS services like Integration Hub, Data Integration, and so on).

Objectives:
 Create a User
 Assign permissions to the assets in the cloud and access them using the user
Duration:
20 minutes

Tasks
To create a user or assign permissions, the user must have admin privileges. And, the users
whose access you want to restrict, must not have the Admin privilege. Else, he will have access
to change his permissions. In this lab, you will create a new user and restrict his access. After
restricting his access, you will verify the same by logging into IICS with his credentials (the
restricted user’s credentials). Instead of creating a new user, you can also use any of the
existing users for the purpose of demonstration.

Module 10: Permissions 409


1. Log in to IICS and navigate to the Administrator service
2. To create a new user in IICS, navigate to the Users page.

3. Locate and click Add User.

410 Module 10: Permissions


4. Under the User Information section, specify the details as per the table given below:
User Information Details
First Name John
Last Name Smith
Job Title Developer
Phone Number 1234567890
Email Provide your Email Id
Note: In the Email property field, specify any of your active email addresses as a
verification email would be sent to the email mentioned in the property field.

5. In the Login settings, enter the details as per the table given below:
Login Details Details
Authentication Native
User Name [email protected]
Max Login Attempts Default value (10)

Module 10: Permissions 411


6. In the Assigned User Groups and Roles section, select the roles as Deployer, Monitor,
and Designer.

Note: Do not select the Admin role as an admin is capable of changing or assigning
permissions.
7. To save the user, click Save.

412 Module 10: Permissions


A message ‘The user was created successfully’ appears.

8. Close the user window and log out of IICS.


Note: Make sure to log out of the IICS as it may conflict while setting up the password of
the new user.

Now, you will set a password to the user you just created.

9. In the browser, login into the email that you provided during the user creation. Check
your inbox or spam for an email from [email protected]

Module 10: Permissions 413


10. To confirm your account, click Confirm Account in the email.

11. In the new page, setup your password, and choose a security question with an answer.

414 Module 10: Permissions


12. To log in with the new user details, click Log In.

13. Click Continue.

Module 10: Permissions 415


14. To receive product updates, click Yes. Else if you choose not to receive product
updates, click No. In this case click Yes.

15. In the next step, click Don’t show this again.

416 Module 10: Permissions


16. Logout of IICS and log in back with the user having admin privilege (not the new user)
and navigate to Integration Hub.

17. From the Navigator pane, go to the Explore tab.

Module 10: Permissions 417


18. Navigate to your training folder.

Assign Permissions at an Asset level


19. From the list of assets, right-click the asset Contact_SFDC_DSS and select
Permissions.

418 Module 10: Permissions


20. To add permissions for users, click Add.

21. From the list of users, select the user using which you executed all the labs and click
Add.
Note: In the screenshot below, the CDIUser is the user with which the labs were
developed. Please use your training user in this step.

Module 10: Permissions 419


22. Follow the above steps and add one more user, [email protected].

23. For user Smith, give the permissions - Read and Execute.

420 Module 10: Permissions


24. To save the changes, click Save.

Note: A message “Permissions were saved successfully.” appears on the screen.


Also, observe that the current admin user (here it is CDIUser) will be given full
permissions automatically.
25. Log out from IICS.

Module 10: Permissions 421


Note: If you get a warning message, click OK.

26. Log in to IICS using the user [email protected] and the password you
provided. Navigate to the Integration Hub.

27. From the Navigator pane, go to the Explore tab.

422 Module 10: Permissions


28. Navigate to your training folder.

29. Open Contact_SFDC_DSS asset, observe that all the details are non-editable.

Note: In this way, you can assign privileges to the users on the assets.
30. Log out from the IICS as user [email protected].

Module 10: Permissions 423


Privileges on the Folders:
31. Log in to IICS and navigate to the Integration Service.

32. From the Navigator pane, go to the Explore tab.

33. Navigate to your training project - CIH Project.

424 Module 10: Permissions


34. For assigning permissions at a folder level, right-click your training folder and select
Permissions.

35. To assign permissions for users on the folder, click Add.

Module 10: Permissions 425


36. From the list of users, select your training user with admin privileges and click Add.

37. To add one more user, click Add.


38. From the list of users, select [email protected] and click Add.

426 Module 10: Permissions


39. Assign all the permissions for the User – CDIUser (your training user) and for the user
[email protected], assign only Read and execute permissions. Click Save.

Note: A message “Permissions were saved successfully.” appears on the screen.

40. Log out from IICS.

Module 10: Permissions 427


41. Log in to IICS using the user [email protected] and its password. Navigate
to the Integration Hub.

42. From the Navigator pane, go to the Explore tab.

43. Navigate to your training folder.

428 Module 10: Permissions


44. Open any asset of your choice and observe that you can only read the asset and it is
non-editable.

Note: In this way we can assign permissions to the folders, once the permissions are
applied at the folder level, those permissions will apply to the assets present under the
folder.
45. Log out of the IICS as the user [email protected].

This concludes the lab.

Module 10: Permissions 429


430 Module 10: Permissions
Module 11: Salesforce Accelerator Package
Lab 11-1: Deploy Salesforce Accelerator Package
Overview:
For rapid synchronization of data from Salesforce to other applications through Cloud
Integration Hub, deploy the Cloud Integration Hub Salesforce Accelerator package.

In this lab, you will deploy the Salesforce Accelerator package.

Scenario:
To save the developer time and effort, James deploys the Salesforce Accelerator package and
uses the Salesforce Accelerator components to publish the Contacts, Accounts, and
Opportunities tables from Salesforce to the topic in the hub and use the sample subscribing
application to consume the data and write it to a file.

Objectives:
 Log in to IICS
 Create CIH_Salesforce and CIH_FF_target connections
 Log in to Cloud Integration Hub
 Deploy Salesforce Accelerator Package
 Run a publication
 View results
Duration:
30 minutes

Tasks

Before deploying the Salesforce Accelerator package, there are TWO things to consider:

 You must have a salesforce connection named CIH_Salesforce in your org.


 You must have a flat file connection named CIH_FF_target in your org.

Module 11: Salesforce Accelerator Package 431


1. In the browser, open a new tab and log in to Salesforce.com using your developer login:
https://login.salesforce.com/?locale=in

Note: The following instructions are based on the classic version of Salesforce. To
switch to the classic version, on the upper right corner, select the View Profile option.
And from the appeared menu, select the ‘Switch to Salesforce Classic’ option.

432 Module 11: Salesforce Accelerator Package


2. In the upper right corner of the screen, click on your username and select My Settings.

3. In the navigator pane on the left side of the screen, click Personal > Reset My Security
Token.

Module 11: Salesforce Accelerator Package 433


4. Click Reset Security Token.

5. After your security token is reset, the token is sent to the email that you have registered
with Salesforce. Check your email to find a mail from [email protected] and copy
your security token.
6. Close the Salesforce tab.

Create a Salesforce connection in IICS


7. Log in to IICS and navigate to the Administrator service.

434 Module 11: Salesforce Accelerator Package


8. To create a new connection, go to the Connections page.

9. Click New Connection. The New Connection page is displayed.

10. In the Connection Name field, enter CIH_Salesforce. You can optionally enter a
description in the Description field.
11. Set the connection Type to Salesforce.
12. For the Runtime Environment, select your Secure Agent.
13. Select the Salesforce Connection Type as Standard.
14. In the User Name field, enter your Salesforce account user name.
15. In the Password field, enter your Salesforce account password.

Module 11: Salesforce Accelerator Package 435


16. In the Security Token field, paste your Salesforce account security token (copied from
the email).

17. Test the connection.

A message ‘The test for this connection was successful’ appears.

If the test connection fails, check the connection details, and test it again.
18. Save the connection.

A confirmation message ‘Connection saved successfully’ appears.

436 Module 11: Salesforce Accelerator Package


Note:
If the test connection fails with an Invalid API version error, as shown below,

then, under the Standard Connection Properties, for Service URL property, change the
API version to 48 in the URL, and test the connection again.

19. Close the connection.

Module 11: Salesforce Accelerator Package 437


Create a Flat File connection in IICS
20. Go to the Connections page.

21. Click New Connection.

22. In the Connection Name field, enter CIH_FF_target. You can optionally enter a
description in the Description field.
23. Set the connection Type to Flat File.
24. For the Runtime Environment, select your Secure Agent.
25. For the Directory field, click Browse.
26. Browse to the location C:\IICSLabFiles and click OK.

438 Module 11: Salesforce Accelerator Package


27. From the Code Page drop-down menu, select MS Windows Latin1.

28. Test the connection.

A message ‘The test for this connection was successful’ appears.

29. If the test connection fails, check the connection details, and test it again.
30. Save the connection.
A confirmation message ‘Connection saved successfully’ appears.
31. Close the connection.

Module 11: Salesforce Accelerator Package 439


32. Navigate to the Integration Hub service.

33. From the top-most right corner of the Home page, click the Salesforce Accelerator link.

34. On the Confirmation window, give Yes.

440 Module 11: Salesforce Accelerator Package


35. Wait for a few seconds. A message ‘Salesforce Accelerator package deployed
successfully’ appears on the screen.

36. Observe the Hub Overview diagram. New entities are added. Refresh the page if
required.

Module 11: Salesforce Accelerator Package 441


37. From the navigator pane, go to Explore.

38. The newly created objects will be saved to the Auto-generated Default folder. Go to the
Default folder.

39. Click on the subscription Sub_sfdc_Acct_Contact_Opp.

442 Module 11: Salesforce Accelerator Package


40. Observe and note the mapping task(mct_CIH_sub_Account_Contact_Opportunity)
that is being used by the subscription.

Note: Refresh the page and navigate back to the subscription if it is taking time to open
41. Navigate to the Data Integration service.

42. Go to Explore and open the Default folder.

Module 11: Salesforce Accelerator Package 443


43. In the search bar, enter mct_CIH and observe the results.

44. Open the mapping task mct_CIH_sub_Account_Contact_Opportunity.

45. Scroll down to the target details section and observe the selected objects.

Note: After running the publication, the subscription gets triggered and the target will
create 3 flat files – Accounts.csv, Contacts.csv, and Opportunities.csv to your flat file
directory. The data written to the files depends on the data present in your Salesforce
org.
46. Navigate back to the Integration Hub service and go to Explore > Default.

444 Module 11: Salesforce Accelerator Package


47. Run the publication Pub_sfdc_Acct_Contact_Opp.

48. The Publication has started successfully. Go to the Events tab. Refresh the events page
periodically to view the updated event status.

49. Once the publication and the subscription event statuses are updated to Complete,
switch on your Windows, navigate to the directory C:\IICSLabFiles. Observe that the
CSV files – Accounts, Contacts, Opportunities are created. Open each of the files
and view the data. Note that, the data written to the output files is from your Salesforce
account. If your Salesforce account does not contain any Accounts, Contacts, or
Opportunities data, their corresponding output file will be empty.

Note: Take some time and view all the deployed Salesforce objects. 5 objects are
deployed into the Cloud Integration Hub service – a topic, a publication application, a
publication, a subscription application, and a subscription.
Thus, you have successfully deployed Salesforce Accelerator Package in CIH.

Module 11: Salesforce Accelerator Package 445


Congratulations, you’ve completed all the labs!!!

This concludes the lab.

446 Module 11: Salesforce Accelerator Package

You might also like