The following conditions must exist before you create a publication:
An application from which to publish data must exist. You can either use an existing application, or create and save a new application.
A topic must exist to publish data to. You can either use an existing topic, or create and save a new topic.
For publications that trigger a Data Integration task, a publication Data Integration task must exist.
You can also create publications on the topic page. For more information, see
Creating a topic.
In the Navigator, click
New
Publication
.
The
New Publication
page appears.
Enter the publication name. Optionally, enter a description for the publication.
Choose the publication mode, enabled or disabled.
A disabled publication does not run according to schedule or by an external API. You can only run a disabled publication from the
Explore
page or from the topic page of the topic that the publication publishes to.
Select the publication method:
Publish data with a Data Integration task
. The publication process triggers a Data Integration task to retrieve the data from the publishing application and write the data to the topic on the
Cloud Integration Hub
publication repository.
Publish files with a file ingestion task
. The publication process triggers a file ingestion task to retrieve the files from the publishing application and write the files to a specific topic on the
Cloud Integration Hub
publication repository.
Publish data with an API
. Use the Publish Data REST API to publish the data to a specific topic in the
Cloud Integration Hub
publication repository. Select this option for high-frequency publications of small transactions.
After you configure the publication properties, you can copy the following URLs from the publication page:
URL of the REST API. Use this URL to publish the data.
URL of the Swagger structure for the topic that the publication publishes data to. Use the structure in the publication request.
You use the URLs when you create the request that runs the publication.
Choose the application that publishes the data.
Choose the topic that the application publishes the data to.
For publications that trigger a
Data Integration
task, perform the following tasks:
Select the task that defines the publication mapping.
If the publication publishes large amounts of data, increase the write batch size to optimize the performance of the publication.
Increasing the batch size increases the memory consumption of the Secure Agent and might impact the performance of the Secure Agent machine.
Select the method and the frequency of data publishing.
Manually or by an external trigger
No schedule. You can use the following methods to run the publication:
Run manually from the
Cloud Integration Hub
explorer.
Run by an API. Call a REST API that starts the publication.
For file publications that use this scheduling option and that publish multiple files, all the files must be present in the source location when the publication starts.
By schedule
Runs the publication according to the defined schedule. Select one of the following options:
Every n minutes. Runs the publication in intervals of up to 60 minutes. You select the number of minutes from the list.
Hourly. Runs the publication in intervals of up to 24 hours. You select the number of hours from the list. The publication runs at the beginning of the hour. For example, if you enter 2, the publication runs at 00:00, 02:00, and at consecutive two-hour intervals.
Daily. Runs the publication at the same hour every day.
Weekly. Runs the publication every week on one or more days at the same hour. Select the check boxes of the days of the week that the publication runs on. For example, select Saturday and Sunday to schedule the publication to run on weekends.
Monthly. Runs the publication every month on a specific date or a specific day at the same hour.
For minutes and hourly intervals, you can define a period of the day when the publication runs. For example, schedule the publication to run during nighttime hours.
Select a time zone for the schedule. The schedule runs the publication in the selected time zone. You can change the default time zone in the user profile.