Create, disable, and enable publications, and run publications manually, including disabled publications.
Creating a publication that triggers a Data Integration task
Use the Navigator to create publications that trigger a Data Integration task to retrieve the data from the publishing application and write the data to the topic on the Cloud Integration Hub relational publication repository.
The following conditions must exist before you create a publication:
•An application to publish the data from must exist. You can either use an existing application, or create and save a new application.
•A relational topic to publish data to must exist. You can either use an existing topic, or create and save a new topic.
2Enter the publication name. Optionally, enter a description for the publication.
3Select 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.
4Select Publish data with a Data Integration task.
5Select the application that publishes the data.
6Select a topic that stores published data in a relational database. If you use a Data Integration mapping task for the publication, you can select multiple topics to publish the data to.
7Select the task that defines the publication mapping.
8If the publication publishes large amounts of data, increase the write batch size to optimize the performance of the publication.
Note: Increasing the batch size increases the memory consumption of the Secure Agent and might impact the performance of the Secure Agent machine.
9Select 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.
Define the publication intervals in the Repeat running area.
10Click Save.
Creating a publication that triggers a file ingestion task
Use the Navigator to create publications that trigger 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 file store publication repository.
The following conditions must exist before you create a publication:
•An application to publish the files from must exist. You can either use an existing application, or create and save a new application.
•A file store topic to publish files to must exist. You can either use an existing topic, or create and save a new topic
•A publication file ingestion task must exist.
1In the Navigator, click New > Publication.
The New Publication page appears.
2Enter the publication name. Optionally, enter a description for the publication.
3Select 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.
4Select Publish files with a file ingestion task.
5Select the application that publishes the files.
6Select a topic that stores files in a file store to publish the files to.
7Select the file ingestion task that defines the publication mapping.
8Select the method and the frequency of files 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 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.
Define the publication intervals in the Repeat running area.
9Click Save.
Creating a publication that publishes data with an API
Use the Navigator to create publications that use the Publish Data REST API to publish the data to a specific topic in the Cloud Integration Hub relational publication repository.
The following conditions must exist before you create a publication:
•An application to publish the data from must exist. You can either use an existing application, or create and save a new application.
•A relational topic to publish data to must exist. You can either use an existing topic, or create and save a new topic.
1In the Navigator, click New > Publication.
The New Publication page appears.
2Enter the publication name. Optionally, enter a description for the publication.
3Select 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.
4Select Publish data with an API.
5Select the application that publishes the data.
6Select a topic that stores published data in a relational database. If you use a Data Integration mapping task for the publication, you can select multiple topics to publish the data to.
7Click Save.
You can copy the following URLs and use them in the request that runs the publication:
- 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. If a Swagger structure base URL is configured for the organization, Cloud Integration Hub appends the base URL to the topic Swagger structure URL. For more information, see System Properties.
Running a publication manually
Use the Explore page to manually run publications that trigger Data Integration tasks.
Tip: You can also run publications manually on the topic page. For more information, see Topic properties.
1In the Navigator, click Explore. Click the All Assets list and then select Hub Management > Publications.
The Explore page shows all existing publications. You can sort the display by name, description, mode, topic, or last modified.
2Rest on the publication and click the Actions menu at the right end of the line. From the menu select Run.
Disabling and enabling a publication
Use the Explore page to disable and enable publications. 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.
Tip: You can also disable and enable publications on the topic page. For more information, see Publications properties.
1In the Navigator, click Explore. Click the All Assets list and then select Hub Management > Publications.
The Explore page shows all existing publications. You can sort the display by name, description, mode, topic, or last modified.
2Rest on the publication click the Actions menu at the right end of the line. From the menu select Disable or Enable, as required.