You can send webhook notifications from easyDITA that may trigger various actions on external servers. The external servers may pull data from easyDITA.
Webhook notifications on publish
You can send webhook notifications automatically on successful publishing jobs or on any publishing job.
- Do not send
- Webhook notification is not sent.
- Send on success
- Webhook notification is sent after a publishing job is completed successfully.
- Send regardless of build result
- Webhook notification is sent for both successful and unsuccessful publishing jobs.
Webhook notifications on demand
You can manually send webhook notifications for past publishing jobs and resources in your content library.
Triggering Actions on External Servers with Webhooks (Notify)
Your easyDITA instance can be configured to send webhook notifications about publishing events to external servers. On a webhook notification, the external server can trigger various actions. For example, the external server can automatically send emails on successful publish jobs.
In the following example, a publishing job is initiated in easyDITA. The publishing job generates output in easyDITA and sends a webhook notification to the external server. The external server triggers actions based on the webhook notification.
Pulling Content from easyDITA to External Servers (NotifyPull)
External servers may be configured to pull content from easyDITA on a webhook notification.
The majority of output formats produced by the DITA Open Toolkit publishing engine1 can be pulled from easyDITA to an external server.
Publishing Content on External Servers with Webhooks (NotifyPull)
External servers may be configured to pull DITA content from easyDITA on a webhook notification and transform the pulled content.
Sending a webhook notification for source content is useful if you want to process DITA content by using a publishing engine hosted on an external server.
In the following example, a webhook notification is sent from easyDITA. The external server triggers a publishing engine that pulls and transforms the source content from easyDITA. The output is generated on the external server side.