Configure WFFM for deployment on the Azure App Service

Version:

From Sitecore 8.2.3, WFFM 8.2.3, and SAT 1.1 and later, you can install the Web Forms for Marketers (WFFM) module as part of the Sitecore XP installation on the Azure App Service. The WFFM module installation is fully integrated and supports the following Sitecore configurations: XP0, XP, and XDB.

Prepare to deploy WFFM

To prepare to deploy WFFM:

Download the Web Deploy Packages (WDPs) for WFFM.
After preparing the WDPs, upload the WDPs to a storage account.
Locate the WFFM template for your topology on Github.

Inject the WFFM module into Sitecore XP .parameters.json file for your topology

To inject WFFM into Sitecore XP:

Ensure you have a .parameters.jsonfile for your Sitecore environment.
Add the modules parameter to the .parameters.json file and configure the Bootloader module with your Sitecore deployment.
Insert the configuration snippet for the WFFM module to the modules parameter in the .parameters.json file for your Sitecore configuration from the sections below.
Run your Sitecore deployment as usual.

Integrate a WFFM deployment into a Sitecore XP0 environment

To integrate a WFFM deployment into a Sitecore XP0 environment deployment:

Add the following snippet to the modules parameter in the .parameters.json file.

{… ,"modules": {"value": {"items": [
… ,
{
"name" : "wffm",
"templateLink" : "<url of WFFM azuredeploy.json for XP0 topology>",
"parameters" : {
"singleMsDeployPackageUrl" : "<url of the WDP package>"
}
}]
}}
}

Populate the parameters for the WFFM module:
- For templateLink, go to Github and use the URL of the WFFM template for your selected topology, or your storage account.
- For singleMsDeployPackageUrl, go to the Sitecore Dev Portal and download the latest version of the single.scwdp.zip package for Web Forms for Marketers 8.2, and use the URL of the WDP package for WFFM for XP0 topology.

Populate the WFFM module parameters for XP

To integrate your WFFM deployment into the Sitecore XP environment deployment:

Add the following snippet to the modules parameter in the .parameters.json file.

{… ,"modules": {"value": {"items": [… ,
{
"name" : "wffm",
"templateLink" : "<url of WFFM azuredeploy.json for XP topology>",
"parameters" : {
"cdMsDeployPackageUrl" : "<url of the *_cd WDP package>",
"cmMsDeployPackageUrl": "<url of the *_cm WDP package>",
"prcMsDeployPackageUrl": "<url of the *_prc WDP package>",
"repMsDeployPackageUrl": "<url of the *_rep WDP package>"
}
}]}
}
}

Populate the parameters for the WFFM module:
- For the templateLink, go to Github and use the URL of the WFFM template for the selected topology, or your storage account.
- For cdMsDeployPackageUrl, go to the Sitecore Dev Portal and download the latest version of the cd.scwdp.zip, package for Marketers 8.2, and use the URL of the WDP package for CD Role Web Forms.
- For cmMsDeployPackageUrl, go to the Sitecore Dev Portal and download the latest version of the cm.scwdp.zip package for Marketers 8.2, and use the URL of the WDP package for CD Role Web Forms.
- For prcMsDeployPackageUrl, go to the Sitecore Dev Portal and download the latest version of the prc.scwdp.zip package for Marketers 8.2, and use the URL of the WDP package for CD Role Web Forms.
- For repMsDeployPackageUrl, go to Sitecore Dev Portal and download the latest version of the rep.scwdp.zip package for Marketers Reporting 8.2, and use the URL of the WDP package for CD Role Web Forms.

Populate the WFFM module parameters for XDB

To integrate your WFFM deployment into the Sitecore XDB environment deployment:

Add the following snippet to the modules parameter in the .parameters.json file.

{
… ,
"modules": {
"value": {
"items": [
… ,
{
"name" : "wffm",
"templateLink" : "<url of WFFM azuredeploy.json for XDB topology>",
"parameters" : {
"prcMsDeployPackageUrl": "<url of the *_prc WDP package>",
"repMsDeployPackageUrl": "<url of the *_rep WDP package>"
}
}
]
}
}
}

Populate the parameters for the WFFM module:
- For templateLink, go to Github and use the URL of the WFFM template for the selected topology, or your storage account.
- For prcMsDeployPackageUrl, go to the Sitecore Dev Portal and download the latest version of the prc.scwdp.zip package for Marketers 8.2, and use the URL of the WDP package for CD Role Web Forms.
- For repMsDeployPackageUrl, go to the Sitecore Dev Portal and download the latest version of the rep.scwdp.zip package for Marketers Reporting 8.2, and use the URL of the WDP package for CD Role Web Forms.

Deploying multiple CM servers

If you have multiple CM servers, in on all but one of the servers patch the Sitecore.Forms.config file to comment out these lines:

<handler type="Sitecore.Form.Core.WffmActionHandler, Sitecore.Forms.Core" method="OnWffmActionEventFired" >
     <param name="actionManager" ref="/sitecore/wffm/wffmActionExecutor" />
     <param name="settings" ref="/sitecore/wffm/settings" />
 </handler>

If you have suggestions for improving this article, let us know!