Outbound Integration Endpoints enable Digizuite to seamlessly integrate with external systems by pushing data (assets, metadata or just a notification) to any external system based on events occurring in the Digizuite DAM.
As a prerequisite, please run the DB Upgrade scripts from the exporter: DC 5.2.0 4.2.2 Exporter. The 'exportSearch' that will be introduced with those scripts are the recommended search to use in all endpoints.
Integration Endpoints are push-based as opposed to API integrations which are always pull. Integration Endpoints are built on top of an integration architecture that will always handle the foundation of exporting assets and their metadata but with the following variables:
- How should the metadata be pushed? Out of the box, a user can choose between Excel, XML, and JSON. Does the receiving system expect a certain format? If so then Digizuite must be involved to create the transformation component.
- How should data be pushed to the external system? Digizuite has all the assets and metadata ready but should this be pushed to FTP, to a REST endpoint, using a 3rd party API or something completely different. Digizuite can accommodate most.
- What events should trigger the data to be pushed? Metadata changes, folder changes and other events are optionable.
An overview of the architecture can be seen below:
An Integration Endpoint can be created via settings in the Media Manager 5 (there is a link from DC) or from the Sitecore administration portal.
Endpoint Configuration Options:
- Integration Endpoint Name
- Channel Folder ID that the endpoint should be connected to (In Digizuite, we work with Channels and you have one endpoint per channel)
- SearchName - you can use your own but the recommendation is to use the 'exportSearch' as introduced with the Exporter DB upgrade scripts as mentioned above.
- Define what events to subscribe
- Publish or Unpublish Event: Listens on Channel Folder changes based on the channel folder ID above.
- Asset Security Change Event: Rights management changed on the asset
- Asset Deleted Event: Indicates when assets are deleted from the DAM
- Metadata Change Event: A list of metadata fields IDs that should trigger an update. You can choose whether or not include or exclude the list of metadata ids. If excluded, then the events will ignore everything in the list and included the other way around.
- Asset Profile Published Event: A list of profile IDs that are reacting on Asset Profile Published events. This list is only included so if an ID has been defined and you receive an Asset Profile Published event for that ID, then the update will be sent.
- Should metadata be exported and how should it be transformed (As stated above, if not standard excel or XML, then Digizuite would have to create the transformation).
- Delivery Mechanism for the assets + metadata. Where and how should it be delivered?
- Examples could be Youtube, Sitecore, FTP or one of your own downstream systems (Digizuite would have to add the delivery mechanism as stated above if not out of box)