Convert PDF to Image in SharePoint

In this guide you’ll learn how to convert PDFs to images (BMP, GIF, JPG, PNG, TIFF) in SharePoint. For this particular guide we will convert a PDF file to a PNG but you can use this same example to convert other image formats like BMP, GIF, JPG, and TIFF by simply changing the file format from PNG.

This guide can be used in SharePoint Online and the legacy MS SharePoint 2007 / 2010 workflow engine is fully supported, as is the optional Workflow Manager that comes with MS SharePoint 2013 and later versions. For more details, refer to this post.

Before you start, ensure the Document Converter for SharePoint On-Premises has been installed, and you have access to a site collection with the appropriate rights to create workflows.

To convert PDF documents via a workflow using MS SharePoint Designer, you will need to configure the Document Library containing the PDF documents (if not already available) and then also configure the workflow as per the details given below:

Create and Configure the Document Library Containing PDF Documents

You can create and configure the Document Library containing PDF documents by performing the following steps, if this is not already available:

  1. Create a Document Library named Proposal Documents. You can use any name of your choice.

  2. Ensure you upload all the PDF documents you like to convert to this location.

  3. Once created, navigate to the library’s Settings →
    Document Library Settings → Versioning Settings screen and enable Requires content approval for submitted items.

  4. In the Document Library, create two folders (You can use any name of your choice): Confidential Proposals and
    Approved PDF Files.

Create and Configure MS SharePoint Designer Workflow

You can create and configure the MS SharePoint Designer Workflow by performing the following steps:

  1. Start MS SharePoint Designer and open the site collection that contains the Proposal Documents Document Library. This contains PDF Documents.

  2. Click Add Item and select List Workflow. Specify the following settings:

    • Name for the workflow: Convert Approved PDF to Images

    • Select the Document Library associated with the Workflow: Proposal Documents.

    • When creating a SharePoint Designer Workflow in SharePoint 2013 or later, select the appropriate Platform Type.

      list workflow

  3. Click Create button to proceed.

  4. We are now ready to create the workflow. From the ‘Conditions’ menu, select the ‘If value equals value’ condition.

  5. Click the first value followed by the display data binding (fx) button.

  6. Select ‘Current Item’ as the Source and select ‘Approval Status’ in the field.
    Click the OK button to continue.

  7. Click the second value and select ‘Approved’ from the list.

To avoid the same workflow being executed on the converted image file after the conversion has taken place, we need to specifically exclude image files as follows:

  1. Add another ‘If value equals value’ condition.

  2. Click the first value followed by the display data binding (fx) button.

  3. Select ‘Current Item’ as the Source and select ‘File Type’ in the Field. Click the OK button to continue.

  4. Select ‘equals’ and change it to ‘not equals’.

  5. Click the second ‘value’ and enter ‘PNG’, without a period ‘.’.

With the Conditions in place, we can now add the Actions, which is where the magic happens.

  1. From the Actions menu, select Convert Document. It may be hidden behind the All Actions option.

  2. The following action is inserted:
    Convert ‘this document’ to ‘this file’ as a ‘select file type’ , optionally use ‘this xsn or pdf’ as template, ‘include / exclude’ meta data and use ‘these optional parameters’ . Store the converted item details in List ID: ‘Variable: List ID’ , Item ID: ‘Variable: List Item ID’ then Log ‘File Converted’ to the workflow history list then Update item in ‘Proposal Documents’

  3. Let’s examine what the various options within the action mean:

    • this document: Specify which document to convert. Select the option
      and make sure Current Item is selected.

    • this file: Specify the location to which the converted file will be written. The following options are available:

      1. Leave it empty: When no value is specified then, the converted image file is written to the same folder as the source file.

      2. Site Relative URL: By specifying a URL relative to the current site, e.g. subsite/shared documents/Image Files, any folder location in the current site collection can be targeted. This is the option we want to use so enter ‘Proposal Documents/Approved Image Files’.

      3. Web Application relative URL: Using a URL that is relative to the entire web application, e.g. /sites/Press Office/Public Documents/To Distribute, any folder location in any site collection can be targeted.

    • Select file type: Select the file type to which you want to convert the file. We will select PNG in our case.

    • include / exclude metadata: In case of sensitive documents, we may want to strip out any custom SharePoint columns information from the file. Assuming that our document library contains a column Yearly sales forecast, and the Image file uploaded has information entered in that column, we want to select ‘Exclude’.

    • Variable: List ID: A new workflow variable named List ID is automatically created. After the file has been converted, this variable will contain the ID of the list the converted file was saved to. This can later be fed into another action in order to manipulate this file further.

    • Variable: List Item ID: A new workflow variable named ‘List Item ID’ is automatically created. After the file has been converted, this variable will contain the ID of the item the converted file was saved to. This can later be fed into another action in order to manipulate this file further.

  4. Insert a new action named ‘Log to History List’ and enter ‘File converted’.

  5. Insert a new action named ‘Update List Item’ and select ‘this list’. We are now going to automatically mark the converted PNG file as ‘approved’.

    • From the ‘List’ dropdown select ‘Confidential Proposals’.

    • Click Add button and set the field to ‘Approval Status’ and the value to ‘Approved’, and click OK.
      Note: Starting with MS SharePoint 2010, it is no longer possible to set the value of the ‘Approved’ field.

    • In the ‘Find the List Item’ area set the field to ‘ID’.

    • Click the fx button next to ‘Value’, specify ‘Workflow Variables and Parameters’ as the Source and set the field to ‘Variable: List Item ID’ and click the OK button.

    • Click OK again to return to the MS SharePoint Designer Workflow. It should look like the image below.
      update list item

  6. Click Publish button to deploy and activate the workflow.

Testing the Workflow

You can test the workflow created by performing the following steps:

  1. Create or upload a document in PDF file format to the ‘Confidential Proposals’ folder.

  2. From the context menu, select Approve / Reject and approve the file.

This will automatically start the workflow, and after a few seconds, the Workflow status should change to Completed.

Once the workflow has been completed, you will find the PNG version of the PDF document in the ‘Approved PDF Files’ folder.

If an error occurs during the execution of the workflow, you can perform the following to troubleshoot the same:

  1. Check the messages on the workflow status screen.

  2. Check for errors in the Windows Event log.

  3. Check for errors in the SharePoint trace log.