Attach converted PDF files to an email using Microsoft Flow and SharePoint Online

Posted at: 18:03 on 28 October 2016 by Muhimbi

Although at the time of writing (October 2016) Microsoft’s cool new Flow platform is not yet officially available, our support team is quickly turning into Flow junkies. Problems that are difficult to solve using regular SharePoint Designer workflows are absolutely trivial to crack using Flow.

Today we are describing a solution to what is a top 5 support request, at least for our support team, which is to automatically convert a file to PDF using a workflow and sending the result via email as an attachment. You’d think this is easy to achieve in a SharePoint Designer workflow as that comes with an e-mail action, however that action does not support attachments. Bummer!

 

Read on to find out how easy it is to solve this problem.

  1. If not already done so, sign up for Microsoft Flow (Free).
     
  2. If not already done so, in Flow navigate to My Connections and set up a SharePoint connection.
     
  3. Install the Muhimbi PDF Converter for SharePoint Online App (add-in) and separate Workflow Actions.
     
  4. In SharePoint Online (or on-premise if you have configured a gateway) make sure you have access to two different Document Libraries. This example can be combined to use only a single library, but things are slightly easier when using two. Let’s name our libraries Auto Convert Files and Email Files
     
  5. As at the time of writing Muhimbi’s workflow actions are not (yet) available in Flow, we need to create a SharePoint Designer workflow to carry out the conversion to PDF. Navigate to the Auto Convert Files Library and create a new SharePoint Designer Workflow (Library tab / Workflow Settings / Create a Workflow in SharePoint Designer).
     
  6. Name your workflow Convert to PDF, set it to automatically start when a new file is created, convert the Current Item to Email Files/ (including the trailing slash), in PDF format and Exclude metadata. Too cryptic, have a look at this demo video (that uses slightly different parameters, but illustrates the concept). 

    image 
  7. Close SharePoint Designer and check that the new workflow works by uploading a new file to Auto Convert Files. After a few seconds the PDF rendition should be placed in the Email Files Document Library.
     
  8. It is time to create the Flow that picks up the newly converted file and send it via email.  On the My Flows screen select the option to create a New flow from blank.
     
  9. The trigger that starts the flow must be defined first, enter SharePoint when a file is created and select the displayed trigger. Enter the site collection and Email Files document library (use the Library picker if needed).
     
  10. With the fields filled out, click New Step followed by Add an Action.
     
  11. There are several built in email related actions (Outlook, Office 365 Outlook, SMTP), but in this example we use the basic Mail – Send email action. Select it and accept the terms & conditions if needed.
     
  12. Fill out the recipient, subject etc and click Show Advanced options. Select the Attachment field and select File content from the Dynamic content picker. Similarly for the Attachment file name, select File name.

 

That is it, enter an appropriate name for the flow at the top of the screen and click the Create Flow option. You can later extend the flow by adding a SharePoint Delete File action to delete the original file if that is no longer needed.

On the My Flows screen make sure the newly created flow is enabled. Upload a file to Auto Convert Files and after a few seconds an email will be delivered with a copy of the converted file.
 

image

 

Naturally this is not limited to PDF Conversion, it works with any file generated by our various workflow actions including Merge, Watermark, Secure and OCR operations. The current flow always sends the email to the same recipient, this can easily be extended to take the recipient from a separate column by querying that column in Flow.

 

Any questions or remarks? Leave an update below or contact our friendly support team.

.

Labels: , , , , , ,

PDF Converter for SharePoint Online 9.8 - Site & Reusable Workflows & on-prem support

Posted at: 16:09 on 27 October 2016 by Muhimbi

sharepoint-online-logoDuring the previous 8+ years we have made it a habit to announce new software releases – for our on-premise software – at the time it became available for download. However, because releasing updates for an online service, where we maintain the entire back-end, doesn’t require any end-user involvement, we haven’t always done such a good job where it comes to announcing new versions of the Muhimbi PDF Converter for SharePoint Online / Office 365.

That changes today as we formally announce the availability of version 9.8, the 8th release since the product first became available in June 2015. An overview of all recent and historical changes can be found below.
 

Please note that all SharePoint Online versions are numbered in the 9.X range. At the time of writing the most recent version of the on-premise software is 8.1.
 

The number of new features and changes is almost too large to list, but include support for Site Workflows, Reusable workflows, the ability to install the App in SharePoint 2013 / 2016, support for the new Document Library experience, real-time watermarking, a brand new website for SharePoint Online and much much more. 

The following blog posts provide more detail:

 
If you are an existing customer, or installed a trial version before October 2016, then we recommend upgrading the App and installing the latest workflow actions. (Especially as Microsoft has deprecated certain types of sandbox solutions and caused some issues when they introduce the new Document Library experience)
 
 
 
For those not familiar with the product, the Muhimbi PDF Converter for SharePoint Online is a lightweight subscription based solution that allows end-users to merge, split, watermark, secure, OCR and convert common document types - including InfoPath, AutoCAD, MSG (email) MS-Office, HTML and images - to PDF using SharePoint Online through a friendly user interface or via workflows, without the need to install any client side software or Adobe Acrobat. More details can be found on the
product page. 
  

Muhimbi App StoreDeploy App Store Add-in to SharePoint Online or on-premise.


In addition to the changes listed above, some of the main changes and additions in the new version are as follows:

2751 Workflow Fix The 'Split' Workflow action does not recognise the default 'interval' value.
2781 Workflow Fix The List ID variable is not created by merge activity for some tenancies.
2677 Workflow Fix Workflow actions not displayed for SPD reusable workflow.
2580 Workflow Fix Workflow action error - String was not recognized as a valid DateTime.
2695 Workflow Improvement Improve support for reusable workflows.
2849 Workflow Improvement Remove unused DLL from the SPO Workflow actions WSP.
2300 Workflow Improvement Update ‘Created By’ and ‘Modified By’ field with current user name.
2688 Workflow Improvement Add support for Macros / Merge fields in watermarking workflows.
2771 Workflow New Add support for Site Scoped workflows.
2362 Workflow New Add support for the new QR code watermark activity.
2885 Watermarking Fix Date filter for on-open watermark is not working as expected.
2829 Watermarking Fix Invalid current time in PDC.
2878 Watermarking Fix Numerical and currency values not rendered correctly in watermark on sites that use a comma as a decimal separator
2889 Watermarking Fix Boolean filter doesn't work under all circumstances.
2870 Watermarking Fix Watermark does not show correct time for non-English sites.
2652 Watermarking Fix Filtering on Boolean does not work as expected
2679 Watermarking Fix REMOTE_HOST value is not displayed correctly.
2722 Watermarking Fix Watermark on-open fails for users having permission on library, but not on site.
2683 Watermarking Improvement Numerical values are not formatted as per user/web local settings.
2879 Watermarking Improvement Filtering settings are not displayed or stored in region independent format.
2869 Watermarking Improvement Watermarking does not show values as per regional settings of user and web.
2691 Watermarking Improvement Improve performance of real-time watermarking.
2697 Watermarking Improvement Add support for filtering on site groups.
2698 Watermarking Improvement Add support for filtering on managed metadata.
2553 Watermarking Improvement Add support for QRCode elements in composite watermarks.
2877 Watermarking New Add support for real-time watermarking for List Attachments.
2226 Watermarking New Add support for Real time watermarking / security.
2899 UI Fix Fix Convert Button in 'ribbon' of new doclib experience.
2756 UI Fix The 'Include SharePoint Meta-data' checkbox is not ticked when merging.
2759 UI Fix Watermarking Filter field names are duplicated after several post backs.
2768 UI Fix Leaving conversion screen open for a few minutes results in an error.
2873 UI Fix Convert to PDF 'ribbon' entry is present, but doesn't work in SharePoint's new Doclib Experience.
2766 UI Fix Folder picker stuck on 'please wait..' (when user has no access on parent site).
2714 UI Fix Occasional 'Object reference not set to an instance of an object' when merging.
2758 UI Fix Text is incorrect on PDF Security screen.
2761 UI Fix Browse button' doesn't work when specified path doesn't exist.
2760 UI Improvement Admin Links need to be displayed on all Muhimbi screens.
2763 UI Improvement The Error message for invalid filename needs fixing.
2676 UI Improvement Watermarking xml validation message text changes.
2680 UI Improvement Improve error messages around invalid XML Watermarks.
2692 UI Improvement Revise sorting mechanism in merge screen.
2668 UI Improvement Improve error message when unable to read file because of invalid url.
2573 UI Improvement Allow files to be sorted using dropdown menu.
2285 UI Improvement Show file icons in a merge screen.
2280 UI New Add support for friendly 'Browse folder' button.
2769 System Fix Random 'The given key was not present in the dictionary' error.
2770 System Fix Automatic check in behaviour is incorrect on libraries requiring check-out.
2876 System Fix Output to a sub folder doesn't always use the specified destination folder.
2607 System Fix Invalid folder error while converting file.
2693 System Fix Investigate issues with output paths.
2740 System Fix Error when converting: Microsoft.SharePoint.Client.ServerException: Column 'ServerRedirectedEmbedUrl' does not exist. It may have been deleted by another user.
2745 System Fix 'PDF Converter no longer installed' when it actually is (via App catalog).
2602 System Fix Unexpected error while converting large (>50mb) files.
2550 System Fix Error while converting on libraries with required columns AND require check out.
2709 System Improvement Maintain 'Modified by' and 'Created by' values when file is added or edited.
2687 System Improvement Encrypt settings.
2463 System Improvement Optimise Table of Content (TOC) facility for SharePoint Online.
2533 System Improvement '+' character is allowed in SharePoint file names, but not in the PDF Converter.
2705 System New Add support for grouping Prod, Dev and Test Tenancies.
2689 System New Add support for reading regional settings from current user profile.
2777 Subscription Fix When out of monthly operations users can’t go to the ‘info’ or admin screens.
2752 Subscription Fix When WM On open file size exceeds subscription, no error is displayed.
2614 Subscription Fix Activation page blank screen.
2686 Subscription Improvement Improve messaging in emails when 100% of monthly allowance has been used.
2574 Subscription Improvement Subscription activation email was not sent because of socket error.
2541 Subscription Improvement Change the message shown when subscription activation link clicked twice.
2453 Subscription New Send email alerts to customer when usage reaches 75% & 100%.
2733 Setup Fix User cannot activate watermarking feature on French sites.
2303 Setup Improvement Ribbon button cannot be deployed using Tenancy scope app deployment
2322 Setup New Allow PDF Converter APP / Add-in to be installed in on-premise environments.
2701 Setup New Add feature to enable ribbon control on deployments made via App Catalog.
2673 Security New Add support for blocking access to PDF on Open / Filter by IP.
2702 Metadata Improvement Add support for copying Enterprise Keyword metadata.
2699 Metadata Improvement Add support for copying InfoPath based metadata.
2765 Merging Improvement Change 'File format not supported' when converting / merging multiple files.
2364 Documentation New Create a KB article for 'settings link' under remote web.
2635 Documentation New Add KB Entry about elevating App permissions & real-time watermarking.
2568 Conversion New Add PS files to Professional and Higher level Subscriptions.
2290 Conversion New Add support for converting InfoPath & Formotus forms.


For more information check out the following resources:


As always, feel free to contact us using Twitter, our Blog, regular email or subscribe to our newsletter.

Start your 30 day trial by installing the App and Workflow Actions. .

.

Labels: , , , ,

Installing The PDF Converter for SharePoint Online App in SharePoint on-premise

Posted at: 16:07 on 21 October 2016 by Muhimbi

One of the key advantages of deploying Apps in SharePoint Online, or at least App Store Apps, is the ease of installation, it is absolutely trivial. A quick search in the App Store followed by another click to install a complex product and you are done. No need to involve IT staff, plan capacity, assess risk, install dependencies, monitor servers and maintain systems. It doesn’t get much easier (for the customer, now we get to do all the hard work in our hosting environment :-)

Although we pride ourselves on the comprehensive installation experience, as well as the documentation we provide for our on-premise product (SP2007-2019), rolling out software to a typical on-premise SharePoint farm is still less than trivial. What if we could bring the same installation experience that our SharePoint Online customers enjoy to SharePoint on-premise?

Well, and I guess you can see where this is going, today we are doing exactly that. Providing your SharePoint 2013 / 2019 environment has been set up to integrate with the Office Store, you can install our SharePoint Online App on-premise using the click of a button. Brilliant! (Note that that this doesn't apply to workflow actions, that requires our full SharePoint installer, or the use of Microsoft Power Automate (Flow) in combination with Microsoft's on-premises data gateway.

 

While installation of the App is easy, please make sure that:

  1. Your SharePoint environment is configured for Apps.
  2. Server-to-server authentication has been set up between your on-premise and SharePoint Online servers. (See page 9 to 15 in this document, note that the module name on page 12 should be changed from 'MSOnlineExtended' to 'MSOnlineExt').
  3. ACS is configured properly as per this post.

 

None of these requirements are specific to Muhimbi’s Apps / Add-ins. Most Apps, at least the non-trivial ones, require the same one-time SharePoint configuration.
 

Muhimbi in the App Store

 

So, what else do you need to know?

  1. Although from a functional perspective the App is largely identical to the traditional on-premise product, the license is completely different. The App is subscription based, regardless of the environment it is installed in. For details about the various subscriptions, see this overview.
  2. Although we aim for full feature parity between the App and the traditional PDF Converter for SharePoint, there are some differences. The App does not directly integrate with Nintex Workflow (Nintex for Office 365 does not support 3rd party add-ins at the time of writing). An overview of the key differences and similarities can be found in this Knowledge Base article.
  3. App Store integration is only available in SharePoint 2013 and later. This does not work on older SharePoint versions such as 2007 or 2010. Please install our on-premise software in those environments.

   

With the modern App being available on-premise, you may think that we will no longer focus development on our traditional on-premise products. This is not the case, we have a very complete and actively developed roadmap for both products and will continue to develop each separately. We pride ourselves on never leaving any customers behind, which is why every new version of our on-premise products still supports SharePoint 2007 and Windows Server 2008. (Yes, many people still run that combination, and we don’t mind that they do)

    
Any questions or comments? Please leave a message below or contact us, we love talking to our customers.

.

Labels: , , , , , , , ,

Convert and move files between different SharePoint Online site collections using Flow

Posted at: 12:38 on 20 October 2016 by Muhimbi

FlowLogoFrom time to time our support desk is asked how to convert or move files to a different site collection in SharePoint Online / Office 365 in combination with our popular PDF Converter for SharePoint Online. Unfortunately the answer is always something along the lines of ‘this is not possible using SharePoint Designer Workflows as there are clear security boundaries between site collections’.

Although there are some hacky and difficult ways to achieve this by directly invoking a REST based interface or using SharePoint’s Content Organizer, there is a different route that fits in well with the workflow mind-set, Microsoft’s cool new Flow product.

A detailed description of Flow is beyond the scope of this post, but let’s just say that it is the spiritual successor to SharePoint Designer, at least from a workflow perspective, with the key differentiator being that it is all modern and web-based, and – more importantly – not tied into SharePoint. It can integrate with many systems (BaseCamp, DropBox, Onedrive, Dynamics CRM, SalesForce) SharePoint being just one of them.

Although our developers are working hard to directly integrate our existing SharePoint Online Workflow Actions with Microsoft Flow - basically creating Flow specific versions that can be used from any platform - for now the solution is to first create a SharePoint Designer workflow to convert a file to PDF, which in turn invokes Flow to move the file to the destination Site Collection.

Read on for details about how to achieve this. Naturally this same technique also works for copying ANY file between site collections, it doesn’t need to come out of our Converter. The same technique can be used to copy files to and from OneDrive, DropBox and any other supported system.

  1. If not already done so, sign up for Microsoft Flow (Free).
     
  2. If not already done so, in Flow navigate to My Connections and set up a SharePoint connection.
     
  3. In SharePoint Online make sure you have access to two different site collections. In this example we have named them SourceSite and DestinationSite.
     
  4. Determine the name of the source and destination Document Libraries and folders, in our example the source folder is the root of the TransferToOtherSite Document Library. The Destination folder is in the Shared Documents library, specifically the FromOtherSite folder.
     
  5. In this example we first create a SharePoint Designer Workflow (on the Source Site) that converts a file to PDF and writes the resulting file to the TransferToOtherSite Document Library. Your scenario may be different, but a short video about how to create such a workflow can be found in our Knowledge Base.
     
  6. With a process setup that automatically places files in the source location, it is time to create a new process in Flow. On the My Flows screen select the option to create a New flow from blank.
     
  7. The trigger that starts the flow must be defined first, enter SharePoint when a file is created and select the displayed trigger. Enter the source site collection and folder (use the Folder browser if needed)
     
  8. With the fields filled out, click New Step followed by Add an Action.
     
  9. Enter SharePoint create file and select the appropriate action. You may be tempted to use the SharePoint Copy File action, but that is limited to copying files within the SAME site collection.
     
  10. Fill in the blanks, for details see the screenshot below. Naturally substitute the sample site and folder names with your own.

 

That is it, enter an appropriate name for the flow at the top of the screen and click the Create Flow option. You can later extend the flow by adding a SharePoint Delete File action to delete the original file if that is no longer needed, in effect moving the source file.

On the My Flows screen make sure the newly created flow is enabled. Create a file in the source location, either by kicking off the SharePoint Designer workflow or manually placing a file in the source folder. After a few seconds a copy of the file should show up in the destination site collection.
 

Flow - Copy between site collections

 

This is just a start, using some very simple steps Flow allows very powerful integration scenarios. By just adding one more action I was able to also copy the source file to my OneDrive folder, which in turn synced the file to my local system.

This allowed me to create a cool Flow where I have a local OneDrive folder that I can drop any file in, which is then synced automatically to OneDrive, which kicks off a Flow that converts the file to PDF, write it to another OneDrive folder, which in turn is synced back to my local system. A universal Desktop PDF Converter using just a few Flow actions… awesome!

For more details about Muhimbi’s workflow actions for carrying our Conversion, Merging, Watermarking, Securing and OCR of files, have a look at our website.

 

Any questions or comments, leave a message below or contact our friendly support desk, we love to help.

.

Labels: , , , , , ,

Converting InfoPath to PDF is still important

Posted at: 17:32 on 14 October 2016 by Muhimbi

microsoft-infopathConverting InfoPath forms to PDF, was first introduced due to overwhelming customer requests and has been part of the Muhimbi Converter for SharePoint since 2009, back when we were only on version 3! Even though InfoPath is being retired, InfoPath to PDF conversion is still a feature we get asked about a lot. In fact, it’s so popular we completely overhauled the InfoPath Converter in the latest release!

There are plenty of reasons for InfoPath to PDF conversion, chief among them are data compliance, data storage, and data sharing.

Compliance needs are the most obvious reason for PDF conversion. SharePoint is one of the most popular platforms for professional organizations to manage their documents and once any organization gets large enough, or ventures into specific fields, they run into a slew of acronyms like SOX or HIPPAA. This means dealing with new data security and preservation regulations.

For example, HIPPAA mandates records be kept for at least six years, sometimes with very specific metadata requirements. Storing those records isn’t just about finding space for the 1’s and 0’s, but rather keeping it in a way that is useful, maintainable, and properly accessible.
 

InfoPath-Conversion-Front-Page

Download our InfoPath Archiving White Paper


This brings us to the second point on archiving InfoPath data: there are two separate files to be stored, and those files have to be kept in sync.

An InfoPath form itself is an XSN file, but the data that a user enters into it is stored as an XML file. If only the XML data is kept and the XSN file lost, the data is meaningless, as the XML has no context on its own. Even if both files are kept, there are still issues that can arise.

Re-creating a completed form requires a user to have privileges to access both files, which is uncommon. Over time storage servers housing the XML data may be changed or upgraded, so server naming conventions would have to be exactly the same so that file locations are maintained. Lastly, upgrading to newer versions of SharePoint (or moving to a cloud solution) means that URL locations of the form will make life much more difficult.

Since both files are needed to recreate a completed form, sharing information can be challenging. Either both files must be sent independently and recombined by the recipient (a complex task), or another type of file needs to encapsulate the data in a meaningful way.

The most obvious solution for the InfoPath preservation problem is to keep the data as a single file type that shows both the form and the data being entered. Of the different types of files that can do this, PDFs are clearly the best choice; it is accessible, and familiar to almost every user and device. Converting to a PDF can be done as part of a Nintex, K2, SharePoint Designer or Visual Studio workflow using Muhimbi’s range of server based PDF Converters, automatically archiving data for security. Plus, advanced features like watermarking, inserting QR codes and PDF/A make Muhimbi the default choice for Converting InfoPath to PDF.

If you haven’t yet used the Muhimbi PDF Converter it’s super easy, and if you already manage workflows you won’t have any issues getting it set up.

Details can be found in our Knowledge Base. We also have a short video demo of this process for SharePoint On-line using the online version of our tool, the PDF Converter for SharePoint Online.

Although support has officially been extended till 2026, Microsoft may be slowly discontinuing InfoPath, but as long as it’s useful to our customers you can bet we’ll keep supporting it.

.

Labels: , , , ,

New PDF Conversion Workflow Actions for SharePoint Online & Workflow Manager

Posted at: 18:12 on 07 October 2016 by Muhimbi

Workflow Manager LogoOne of the key reasons our customers love our popular range of server side PDF conversion and document automation products is the ability to automate processes. A friendly user interface to convert and merge files into a single PDF is nice and all, but being able to automate business processes using SharePoint workflows is where our products really shine.

Over the years we have created workflow actions for various environments; SharePoint Designer for the SP2007 & SP2010 workflow engine, Nintex Workflow 2007-2016, K2 blackpearl, the Workflow Manager included with SP2013/2016, and more recently the SharePoint Online / Office 365 workflow engine.

To keep everything consistent for our customers, we have always made sure that - regardless of the workflow platform used - all our workflow actions look and behave exactly the same. This has always worked well for us, but sometimes the underlying workflow platform throws a spanner in the works.

This post provides more details about recent changes that affect the SharePoint 2013-2016 Workflow Manager as well as SharePoint Online’s ‘SP2013’ workflow engine.

Workflow Actions
Look at all the cool workflow actions.

 
Before going into more detail, for the sake of simplicity and clarity let’s agree that the SharePoint 2013-2016 Workflow Manager and SharePoint Online’s ‘SP2013’ workflow engine are identical, and refer to both these workflow engines as the Workflow Manager. (They are based on the same technology, but the implementation is different.)

The previous version of our Workflow Manager actions worked well. However there was room for improvement in the following areas:

  • Reusable Workflows: In the ‘old style’ SP2007-2010 workflow engine, reusable workflows worked pretty much the same as regular list workflows. It was possible to create one generic workflow and assign them to any list with little additional effort. This behaviour was changed in the Workflow Manager, which makes it much more difficult to carry out a lookup against a list that is not fixed at design time. Our new workflow actions address this by allowing the path to the input file to be specified at run-time. Confused? Keep reading, examples are provided below.
     
  • Site Workflows: As Site Workflows are not associated with a specific List or Library item, Site Workflows were previously not supported. Fortunately, the same change that allows Reusable Workflows to work bettermakes it possible to integrate our software in Site Workflows.

 

So what has changed? Have a look at the old and new workflow sentences for the Convert Document action (the same change has been made to all other workflow actions)

Old Workflow SentenceOld Workflow Sentence

New Workflow Sentence New Workflow Sentence

   

As you can see, the change is simple. Previously it was a requirement to specify the document using a workflow look-up. Usually the workflow developer would specify ‘Current Item’ to refer to the document that started the workflow. However, it was also possible to carry out a lookup on a different, but always the same, list. Less than ideal when it comes to reusable workflows.

The new Workflow Sentence changes ‘this document’ to ‘this document or this source file’. As a result the new workflow actions are fully backwards compatible, any workflow created using the old actions will work just fine using the new ones. However, it is no longer necessary to always use a workflow lookup as this source file is a text field that accepts a file path.

Entering static text for the input file will rarely be the right solution as very few workflows always act on the same source file. The solution is to generate the path to the source file at run time, e.g. by storing it in a workflow variable. Alternatively you can carry out a lookup for the Encoded Absolute URL on the current item as per the screenshot below.
 

Workflow Lookup

 
This works particularly well for reusable workflows. Regardless of the list the workflow is associated with, this will always point to the item that the workflow was started on. For details about specifying paths using Muhimbi’s software, see this blog post.

 

A tutorial showing how to create re-usable workflows is outside the scope of this post, but please keep in mind that after publishing a reusable workflow it needs to be associated to a list or library using the ‘Add a Workflow’ option.

 

The SharePoint Online version of the new workflow actions can be found here. The new version of the on-premise Workflow Manager actions are included in version 8.2 of the Muhimbi PDF Converter for SharePoint.

 

If you have any questions, or suggestions for additional improvements, then leave a comment below or contact us.

.

Labels: , , , , , , ,

Subscribe to News feed