A way to get dynamic assets (images) into CHILI publisher, is to call a (public) URL. Or, at least a URL that is reachable from the CHILI instance.
Steps to take
Define a DAP URL in the BackOffice
Create a variable in your document to add to your URL
Use an Image Frame in your document, containing the variable
DAP URL Definition
...
Go to Dynamic Asset Providers
...
Create a new Setting, and give it the name and settings for your setup.
Name: Name of the setting
Description: Here you can add a description of what this service will do, might be helpful for your colleagues.
Preview URL: You define the URL to the service that will provide a preview of the dynamic image generated by the service.
Use %data% to reference the Value field in your Dynamic Asset Provider config in your document (see later)High resolution URL: Define the URL to the service that will provide the high resolution file of the dynamic image generated by the service.
Use %data% to reference the Value field in your Dynamic Asset Provider config in your document.Asset Folder: Defines the location where the "high resolution" assets will stored when an output is made of the CHILI publisher document.
Provides file info / File info URL: A URL where information about the assets can be found (width, height, resolution). See example below.
If this information is not provided via a URL then it needs to be specified in the fields available when this checkbox is unchecked.Extension: Specify the image type generated by the service. This value is the default value for all images used. If the extension can differ from image to image a URL for the file info needs to be supplied via the file info URL.
Asset Width: Width of the high resolution image generated by the service. If the width differs from image to image a URL for the file info needs to be supplied via the file info URL.
Asset Height: Height of the high resolution image generated by the service. If the height differs from image to image a URL for the file info needs to be supplied via the file info URL.
Asset Resolution: Resolution of the high resolution image generated by the service. If the resolution differs from image to image a URL for the file info needs to be supplied via the file info URL.
FileInfo XML example
Code Block |
---|
<item name="dynamic-asset-name-here.jpg">
<fileInfo resolution="72" width="834" height="592">
<metaData>
<width>834</width>
<height>592</height>
<resolution>72</resolution>
</metaData>
</fileInfo>
</item> |
Using the Dynamic Asset Providers in a document
To use a Dynamic Asset image in a document, a variable of type image is created.
This variable is assigned to an image frame.
In the "Type Specific" settings" of the variable the source is set to "Dynamic Asset Provider".
...
Select the "Dynamic Asset Provider" settings you've created in the backoffice and specify which value you want to use to create personalised images.
To specify a specific variable to be used provide the name of the variable in between 2 "%" characters.
...
This way you can combine fixed text with a variable or combine several variables. So information for the service along with information from the document can be combined.
The images below show an example where GoogleMaps API Static Maps has been setup to create a map that uses information from variable fields in the document to update the image and send the result back to CHILI publisher to be shown in the document.
...