--- title: "Document Converter for Microsoft Flow" canonical_url: "https://www.nutrient.io/guides/document-converter/power-automate/knowledge-base/microsoft-flow-core-concepts-used-by-the-pdf-converter/" md_url: "https://www.nutrient.io/guides/document-converter/power-automate/knowledge-base/microsoft-flow-core-concepts-used-by-the-pdf-converter.md" last_updated: "2026-06-19T09:21:00.213Z" description: "Explore features like document conversion, merging, and error handling in Microsoft Flow with our comprehensive guide." --- # Simplify document workflows with Microsoft Flow [Nutrient’s facilities for Microsoft Flow](https://www.nutrient.io/blog/muhimbis-pdf-conversion-facilities-now-available-for-flow-logicapps-and-powerapps/) cover a wide range of functionality ranging from Document Conversion, Merging, Watermarking Encryption and Optical Character recognition (OCR). We have made sure that each Flow action follows the same pattern to make life as easy as possible for our users. The fields in each action are largely self-describing. The facilities shared between most actions are described below. ## Return / Output variables Similar to other Flow actions, the output of each of our actions can be fed into subsequent actions. This allows for such operations as 'take the output (a PDF file) generated by the _Convert Document_ action and pass it into the _SharePoint.CreateFile_ action to write the PDF to SharePoint'. Or attach a processed file to an email as per the following screenshot.![](@/assets/guides/muhimbi/Flow_Return_Variables-opt-1920.webp) These Return variables are typically: - **Processed file content** — The most important field shared by almost all our Flow Actions as it contains the result of the operation. Depending on the Flow action, this contains typically a converted PDF file, a watermarked file, the results of a merge operations etc. This field can then be fed into other Nutrient, or third, party Flow actions to do something with that file (e.g. email it as an attachment, write it to OneDrive, place it in a SharePoint document library etc) - **Base file name** — This utility variable just contains the base file name, without extension, of the input file. A simple, but very useful variable that is typically used to construct the name of the output file. For example, let’s take an input file named 'Monthly Report.docx'. Once converted it is typically required to specify the file name when attaching it to an email / writing it to another service. By taking the returned _Base file name_ (in this case 'Monthly Report') you can add a simple suffix such as '.pdf' to generate the output file name. This may appear to be a trivial operation, but at the time of writing Microsoft Flow does not support a macro language to manipulate text. - **Result code** — This is typically used when the _Fail On Error_ option (under Advanced options) is set to _False_. For details see the section about _Error handling_ below. - **Result details** — Additional details that can be used in combination with the Result code. For more information see the _Error handling_ section below. ## Error handling An important concept in programming, including designing workflows, is how to deal with errors. You have tested your workflow, all works well and executes without problem, but what happens when something goes wrong? The document that is being converted is corrupt, your subscription has expired, Flow has internal problems, many things can go wrong and WILL go wrong eventually. Flow’s default behaviour is to abort the workflow when an error happens in any of the workflow actions. Depending on your point of view this may be desirable, but it means that when a problem happens in your _mission critical workflow_ you cannot take corrective action or even send out an alert. As we don’t like surprising our users, the default behaviour of our workflow actions fit in with Flow’s standard model. When a problem happens, a signal is sent to Flow that an error occurred resulting in the workflow being aborted. However, as our software is typically used in mission critical systems, we have also implemented a second 'optional' model for error handling. Each of our workflow actions contains a _Fail on error_ option in the 'Advanced options' area. By default, as you can see in the screenshot below, the workflow fails when an error occurs.![](@/assets/guides/muhimbi/Fail_on_error-opt-1920.webp) However, by setting this value to _False_, Flow will think our workflow action has succeeded, even if an error occurred. The person designing the workflow can insert a simple Flow condition after our workflow actions to check the _Result code_ returned by our software. The Result code will be set to one of the following values: - **Success** — The operation succeeded without error. - **ProcessingError** — An unexpected error has occurred. E.g. the input file is corrupt or there are connectivity problems. - **SubscriptionNotFound** — Your subscription was not found. - **SubscriptionExpired** — Your subscription was found, but has expired. - **ActivationPending** — Your subscription was found, but the activation link sent by email was not clicked. - **TrialExpired** — Your trial subscription has expired. - **OperationSizeExceeded** — The maximum operation size [for your subscription level](https://www.nutrient.io/low-code/pricing) has been exceeded. - **OperationsExceeded** — The maximum number of operations [for your subscription level](https://www.nutrient.io/low-code/pricing) has been exceeded. - **InputFileTypeNotSupported** — The specified input file type is either not supported by the Document Converter or [not supported by your subscription level](https://www.nutrient.io/low-code/pricing). - **OutputFileTypeNotSupported** — The specified output file type is either not supported by the Document Converter or [not supported by your subscription level](https://www.nutrient.io/low-code/pricing). - **OperationNotSupported** — The specified operation is [not supported by your subscription level](https://www.nutrient.io/low-code/pricing). - **Accepted** — (Not used by Flow, API only) The operation was accepted, and is running asynchronously. - **AccessDenied** — (Not used by Flow, API only) The specified credentials are incorrect. ## Logging When it comes to troubleshooting, especially when you are dealing with [our friendly support desk](https://www.nutrient.io/company/contact), it is essential that we can differentiate between the various operations that you are executing. For this reason it is recommended to always enter the 'source file name' field with the actual, or at least a unique, file name. This may appear obvious for Flow actions such as _Convert Document_, which require this field to be filled out. However, for other actions - specifically the various watermarking related actions - this field is optional and can be found under the _Advanced options_ section. ## Watermarking All watermarking facilities follow a similar pattern as well. Some fields are obviously unique to each action, but most share the following: - **Position** — The location where the watermark will be positioned on the page. - **Width** — The width of the watermark in pts (1/72nd of an inch). For example 144 is 2 inches wide. - **Height** — The height of the watermark. - **X Coordinate** — The x-coordinate of the watermark. Only used when _Position_ is set to _Absolute_. - **Y Coordinate** — The y-coordinate of the watermark. Only used when _Position_ is set to _Absolute_. - **Layer** — Position the watermark in front of the page’s content, or behind it. This is particularly important when dealing with images or PowerPoint content which always cover any content positioned in the background (So set it to _Foreground_ for those file types) - **Rotation** — Rotate the watermark, specify a value in degrees. Negative values are accepted. - **Opacity** — A value between 0 (completely transparent) and 100 (fully visible) - **Watermark start page** — The first page in the document the watermark applies to. - **Watermark end page** — The last page in the document the watermark applies to. - **Watermark page interval** — Which pages to apply the watermark on (1 = every page, 2 = every other page etc). This allows such functionality as having different watermarks on odd and even pages. - **Watermark page orientation** — The page orientation the watermark applies to. note that this does not change the orientation of the page, instead it allows different watermarks to be defined for landscape and portrait pages. If you have any further questions regarding this topic, or any topic, then [contact our friendly support desk](https://www.nutrient.io/company/contact), we are here to help. --- ## Related pages - [Ensuring PDF searchability with Nutrient Document Converter](/guides/document-converter/power-automate/knowledge-base/are-pdf-files-created-by-the-muhimbi-pdf-converter-searchable-indexable.md) - [How to resolve failure issues when generating Web Service proxies against a remote machine?](/guides/document-converter/power-automate/knowledge-base/generating-web-service-proxies-against-a-remote-machine-fails.md) - [Do I need to install software on my desktop or Acrobat/MS Word on the server?](/guides/document-converter/power-automate/knowledge-base/do-i-need-to-install-any-software-on-our-desktops-or-acrobat-ms-word-on-my-servers.md) - [Knowledge Base: Power Automate Document Converter](/guides/document-converter/power-automate/knowledge-base.md) - [Integrating third-party converters with Nutrient Document Converter](/guides/document-converter/power-automate/knowledge-base/integrating-3rd-party-converters-with-the-muhimbi-pdf-converter.md) - [Install Nutrient PDF integration in Power Automate](/guides/document-converter/power-automate/knowledge-base/power-automate-manually-installing-muhimbi-pdf-integration.md) - [Essential guide to reading document properties](/guides/document-converter/power-automate/knowledge-base/reading-document-properties.md) - [How and where can I get support?](/guides/document-converter/power-automate/knowledge-base/where-can-i-get-support.md) - [Comprehensive guide to watermarking documents](/guides/document-converter/power-automate/knowledge-base/where-can-i-find-details-about-watermarking.md) - [Guide to Microsoft Flow, Logic Apps, and PowerApps: tutorials, tips, and blog posts](/guides/document-converter/power-automate/knowledge-base/microsoft-flow-logic-apps-powerapps-tutorials-and-blog-posts.md) - [Help us help you - tips for technical support requests](/guides/document-converter/power-automate/knowledge-base/tips-for-technical-support-requests.md)