Configuring the PDF Tools Conversion Utility

You can configure the third-party tool 3-Heights™ PDF to Image Converter from PDF-Tools to support Collection Design and Development. When a user checks in a PDF or AI file, the system converts it into a JPG file and it shows in the Images category for the context object.

  1. Install the PDF utility:
    1. Locate the zip file at this directory path:

      Windows
      ..\server\Apps\ApparelAccelerator\<VERSION>\win_b64\PDFTools\
      UNIX
      ../server/Apps/ApparelAccelerator/<VERSION>/linux_a64/PDFTools/

    2. Unzip the zip or tar file to any location.

      Windows
      P2IS-R2-460x64.zip
      UNIX
      P2IS460Linux26GCC45x64.tar

    3. Make sure the utility folder has write access.
    4. Make sure the executable has execute access.
  2. Use the command line to test the utility:
    1. Open a command window.
    2. Go to the executable path for the utility (where you unzipped it above).
    3. Copy a PDF or AI file to the executable directory.
    4. Execute the following command:

      Windows
      pdf2imgR2 INPUT.pdf OUTPUT.jpg -pgs 1 -d 300 -lk LICENSE_KEY
      UNIX
      ./pdf2img INPUT.pdf OUTPUT.jpg -pgs 1 -d 300 -lk LICENSE_KEY

      where:

      • INPUT.pdf is the file you copied into the directory (PDF used as an example).
      • OUTPUT.jpg is the name of the JPG file to create.
      • LICENSE_KEY is the value in the license-key.txt file.

    5. View the OUTPUT.jpg file to verify the conversion.
  3. Create or update the emxComponents.properties page object. For more information, see Editing Properties Using MQL.
    1. Add or edit this line: 

      emxComponents.ImageManager.PDFImageUtility.Directory=

    2. Set the value for this property to the full directory path to the executable in the location where you unzipped the files above. Use the full path from the system root.

      For example:

      Windows:
      emxComponents.ImageManager.PDFImageUtility.Directory=D:/PDFTool/tool_24sep/bin
      Linux:
      emxComponents.ImageManager.PDFImageUtility.Directory=/home/data/P2IS460Linux26GCC45x64/bin

    3. Add or edit this line: 

      emxComponents.ImageManager.PDFImageUtility.SupportedFormats=pdf,ai

      If required, you can omit one of the formats.

    4. Add or edit this line: 

      emxComponents.ImageManager.PDFImageUtility.Arguments=-d,300,-lk, LICENSE_KEY,-pgs,1

      Replace LICENSE_KEY with the value in the license-key.txt file.

      For example:

      Windows:
      emxComponents.ImageManager.PDFImageUtility.Arguments=-d,300,-lk,0-CCA67-BMMNA-ST38K-2QDJA-8U25V-7GREF,-pgs,1
      Linux:
      emxComponents.ImageManager.PDFImageUtility.Arguments=-d,300,-lk,0-LLAAB-BKCN9-NB2ST-219J6-SU4CV-4L9EC,-pgs,1

    5. Add or edit this line: 

      emxComponents.ImageManager.PDFImageUtility.ExecutableName=

      Use the property value exactly as shown for your operating system.

      For example:

      Windows:
      emxComponents.ImageManager.PDFImageUtility.ExecutableName=pdf2imgR2
      Linux:
      emxComponents.ImageManager.PDFImageUtility.ExecutableName=pdf2img

    6. Add or edit this line: 

      emxComponents.ImageManager.PDFImageUtility.Name=PDF-Tool

      Use the property value exactly as shown.

    7. When finished updating the text file with all properties you want to modify, including the ones shown here, use the text file to modify the emxComponents.properties page object. For more information, see Editing Properties Using MQL.