=================================
Pdf Exports in Azure Websites
=================================
|
|

.. Warning::

	This is no longer applicable in Izenda versions after 3.0 as the exporting provider has changed from EvoPDF to Syncfusion. Please see the changes in the release notes `here <https://www.izenda.com/docs/release_notes.html#v3-0-0-april-2-2019>`_.

Introduction
------------------------------------------

Izenda utilizes the EVO HTML to PDF Converter for Azure to provide pdf exporting in Azure websites. This feature requires the use of an Azure Cloud Service. The high-level flow is illustrated below.

.. figure:: images/evo_azure_architecture.png


Installing and Configuring the Azure Service
----------------------------------------------------
|

Required Components
#####################

There are two components needed for the Azure cloud service. 

| *EvoHtmlToPdfAzureService.cspkg*
| *ServiceConfiguration.Cloud.cscfg*
|

These components as well as the installation guide this document is based on can be downloaded freely at the link below: 
https://izenda.sharefile.com/d-s3149eb329e04a15a (Please be sure to use this version)

Installation
#####################

#. Login into your Microsoft Azure portal and create a new Cloud Service.

	.. figure:: images/azure_cs1.png

	.. figure:: images/azure_cs2.png

#. In the first screen select a DNS name for your cloud service and then select a package. 
#. In the next screen choose a deployment label and choose the **EvoHtmlToPdfAzureService.cspkg** file for package option and **ServiceConfiguration.Cloud.cscfg** file for configuration option. Enable the **Deploy even if one or more roles contain a single instance** option and finish the wizard. The deployment process may take several minutes. 

	.. figure:: images/azure_cs3.png
	
#. When the deployment has completed, navigate to the cloud service dashboard. Under the Properties > Input Endpoints, you can find the service IP address and port number. You will use this information configure Azure exporting in Izenda.

	.. figure:: images/azure_cs4.png


Configuring the Izenda instance
----------------------------------------------------
After the service has been configured, you must configure the Izenda application to use the service. The settings below are in the web.config file.

.. code-block:: xml

	<configuration>
	  <configSections>
	    <section name="evoPdfSettings" type="Izenda.BI.Framework.Models.Exporting.EvopdfConfiguration" /> 
	  </configSections>
	  <evoPdfSettings cloudEnable="true">
	    <azureCloudService server="120.0.0.1" port="40001" servicePassword="" />
	  </evoPdfSettings>
	</configuration>