Resolve image references in source

XDP documents can contain images linked either through absolute or relative references. Assembler service, by default, retains the references to the images in the resultant XDP document.

You can specify how the Assembler service handles the images referenced in the source XDP documents when assembling. You can choose to have all the images embedded in the resultant PDF so that it contains no relative or absolute references. You define this by setting the value of the resolveAssets tag, which can take any of the following options:

Value

Description

none

Does not resolve any of references. All references are retained.

all

Embeds all the images referenced through absolute or relative references in the source XDP document.

relative

Embeds all the images referenced through relative references in the source XDP document.

absolute

Embeds all the images referenced through absolute references in the source XDP document.

You can specify the value of the resolveAssets attribute either in the XDP source tag or in the parent XDP result tag. The attribute specified for the XDP result tag is inherited by all the XDP source elements which are children of the XDP result. However, explicitly specifying the attribute for a source element overrides the setting of the result element for that source document alone.

Resolve all image references in a source XDP document

To convert all image references in the source XDP documents, specify the resolveAssets attribute for the result document to all, as in the example below:

<DDX xmlns="http://ns.adobe.com/DDX/1.0/"> 
    <XDP result="result.xdp" resolveAssets="all"> 
        <XDP source="input1.xdp" />     
        <XDP source="input2.xdp" /> 
        <XDP source="input3.xdp" /> 
    </XDP> 
</DDX>

You can also specify the attribute for all the source XDP documents independently to get the same result.

<DDX xmlns="http://ns.adobe.com/DDX/1.0/"> 
    <XDP result="result.xdp"> 
        <XDP source="input1.xdp" resolveAssets="all"/> 
        <XDP source="input2.xdp" resolveAssets="all"/> 
        <XDP source="input3.xdp" resolveAssets="all"/> 
    </XDP> 
</DDX>

Resolve specified image references in a source XDP document

You can selectively specify the image references that you want to resolve by specifying the resolveAssets attribute for them. The attributes for individual source documents override the resultant XDP document’s setting. In this example, the fragments included are also resolved.

<DDX xmlns="http://ns.adobe.com/DDX/1.0/"> 
    <XDP result="result.xdp"> 
        <XDP source="input1.xdp" resolveAssets="all"> 
            <XDPContent source="fragment.xdp" insertionPoint="MyInsertionPoint" 
            fragment="myFragment"/> 
        </XDP> 
        <XDP source="input2.xdp" /> 
    </XDP> 
</DDX>

Selectively resolve absolute or relative references

You can selectively resolve absolute or relative references in all or some of the source documents, as shown in the example below:

<DDX xmlns="http://ns.adobe.com/DDX/1.0/"> 
    <XDP result="result.xdp" resolveAssets="absolute"> 
        <XDP source="input1.xdp" resolveAssets="relative"/> 
        <XDP source="input2.xdp" resolveAssets="all"/> 
        <XDP source="input3.xdp" resolveAssets="absolute" /> 
    </XDP> 
</DDX>