Biztalk Server Application project : Set Up

Florian CAILLAUD
Published by Florian CAILLAUD
Category : BizTalk / DevOps
21/01/2019

With BizTalk 2016 (FP 2), a new BizTalk project type appeared in Visual Studio: The BizTalk Server Application project. This project type allows you to automatically deploy a BizTalk project through the various pipelines (Build, Release) provided in Azure DevOps.

 

Prerequisites

In order to reproduce the manipulations described in this article, a Visual Studio 2015 license is required, with BizTalk 2016 developer Tools (feature Pack 2).

 

Create an Empty BizTalk project

Let’s start from a Visual Studio solution that contains a simple BizTalk project.

empty BizTalk project

 

Create a BizTalk Server Application Projet

Within the same solution, we will add a BizTalk Server Application project. Compiling this project will provide a deployment package.

BizTalk Server Application Project

 

Inside this project, we will find two files, automatically generated:

  • BizTalkServerInventory.json
  • Binding.xml

The first file is used to list all the files to be included in the deployment package. The DeploymentSequence section is used to order the deployment of the listed files.

 


{
  "$schema": "C:\\Program Files (x86)\\Microsoft BizTalk Server 2016\\Developer Tools\\BizTalkServerAppplicationSchema.json",
  "BizTalkAssemblies": [
    {
      "Name": "TestVSTSBiztalk",
      "Path": "bin\\TestVSTSBizTalk.dll"
    }
  ],
  "BindingsFiles": [
    {
      "Name": "Binding",
      "Path": "bindings\\Binding.xml"
    }
  ],
  "Assemblies": [
  ],
  "PreProcessingScripts": [
  ],
  "PostProcessingScripts": [
  ],
  "Files": [
  ],
  "DeploymentSequence": [
    "TestVSTSBiztalk", "Binding"
  ]
}

As for the second file, this is the configuration of the BizTalk application to deploy, also called binding file. We can change the name of this file (don’t forget to change it in BizTalkServerInventory.json as well).

BizTalk Server Application Project Deployment Binding

 

Once these two files are completed according to your expectations, it is important to verify, in the project properties, that the application name matches the wanted BizTalk application name.

After compiling the project, a .zip file is created in the output directory (which is configurable). This file will be our deployment package.