Using the wildcard key map feature
To use wildcard feature in a key map archive:
-
Create the key map archive. See the instructions on Using the EngageOne Key Map Generator.
Note that you do not need all images in the input directory when creating the key map archive, but you must have at least one.
- After creating the key map archive, open the archive and edit the key map XML file using an XML editor.
-
Locate the first
<KeyEntry>
element, and note the values for the attributes highlighted in this example:<KeyEntry
Key="Samaritn"
>
<Image Width="354" Height="325" Resolution="72" >
<EOImageDeviceInfo Device="DOC1InteractiveEditor" DeviceType="DOC1INTERACTIVEEDITOR" Resolution="72" ImageType="PNG"
FileName="Samaritn.PNG"
/>
<EOImageDeviceInfo Device="PDFNC" DeviceType="PDF" Resolution="72" ImageType="BMP"
FileName="Samaritn.BMP"
/>
</Image>
</KeyEntry>
-
Modify the first
<KeyEntry>
element:KeyEntry
Wildcard=
"
%
"
FileName="
%.PNG
"
FileName="
%.BMP
"
-
Add the
ResourceName
attribute to the<EOImageDeviceInfo>
element for each device:ResourceName="%"
-
Each device has an
<EOImageDeviceInfo>
element in the<Image>
element. For each<EOImageDeviceInfo>
element, theFileName
andResourceName
attribute, as shown in steps 4ii, 4iii, and 5i.If you are targeting a PDF device and using JPEGs, you must also add the
ColorSpace
attribute to the PDF<EOImageDeviceInfo>
element. Without this keyword in the key map file, the PDF will contain the incorrect value/ColorSpace /DeviceRGB
in the PDF output file. Value2
indicatesDeviceRGB
, and3
indicatesDeviceGray
. For example,<EOImageDeviceInfo Device="Default PDF" DeviceType="PDF"
ColorSpace="2"
Embed="true" Disposal="Retain" ImageType="JPEG" ResourceName="%" FileName="%.JPG" PDFPixelWidth="364" PDFPixelHeight="480" />
-
Search for all remaining
<KeyEntry>
elements, and delete them.The resulting key map XML file should be similar to this example:
<KeyEntry
Wildcard="%"
>
<Image Width="354" Height="325" Resolution="72" >
<EOImageDeviceInfo Device="DOC1InteractiveEditor" DeviceType="DOC1INTERACTIVEEDITOR" Resolution="72" ImageType="PNG"
FileName="%.PNG"
ResourceName="%"
/>
<EOImageDeviceInfo Device="PDFNC" DeviceType="PDF"
ColorSpace="2"
Resolution="72" ImageType="BMP"
FileName="%.BMP"
ResourceName="%"
/>
</Image>
</KeyEntry>
- Save the key map XML file.
- Update the key map archive with the modified key map XML file.
- Import the key map archive in EngageOne Administration. For more information, see Using key maps.