BizTalk Pipeline does not open with BizTalk Pipeline Editor! Instead it opens with the XML (Text) Editor!

BizTalk Pipeline does not open with BizTalk Pipeline Editor! Instead it opens with the XML (Text) Editor!

In the sequence of one of my last blog posts, I notice that in the same project also while trying to open a BizTalk pipeline inside Visual Studio, again, normally a simple and easy double-click operation to open this time the BizTalk Pipeline Editor, the resource didn’t open with the correct editor: BizTalk Pipeline Editor, instead, it opened with the XML (Text) Editor

BizTalk Pipeline does not open with BizTalk Pipeline Editor: Pipeline open with XML Text Editor

I’m used to seeing this behavior ins orchestration but it is the first time, that I can remember, to see the same happening with pipelines. Again, this has a quick workaround but it becomes annoying after a few times.

Cause

Well, again and similar to the orchestrations, I don’t know exactly what can cause this problem but I suspect that this behavior happens more often when we migrate projects, or when we try to open previous BizTalk Server versions projects in recent versions of Visual Studio, special if we skip one or more versions, for example: from BizTalk Server 2010 to 2013 R2.

And may happen because of different configurations inside the structure of the “<BizTalk>.btproj” file.

The cause of this strange behavior is without a doubt related to a mismatched setting inside the structure of the “<BizTalk>.btproj” file in the Pipeline nodes (each pipeline inside your project will reflect one Pipeline node specifying the name of the file, type name, and namespace. Normally it has this aspect in recent versions of BizTalk Server:

<ItemGroup>
   <Pipeline Include="SendOrReceivePipelineName.btp">
      <Namespace>MyProjectName.Pipelines</Namespace>
      <TypeName>SendOrReceivePipelineName</TypeName>
   </Pipeline>
</ItemGroup>

But sometimes we will find an additional element:

<ItemGroup>
   <Pipeline Include="SendOrReceivePipelineName.btp">
      <Namespace>MyProjectName.Pipelines</Namespace>
      <TypeName>SendOrReceivePipelineName</TypeName>
      <SubType>Designer</SubType>
   </Pipeline>
</ItemGroup>

When the SubType element is present, this strange behavior of automatically open the pipeline with the XML (Text) Editor.

Solution

First, once again let’s describe the easy workaround for this annoying problem/behavior:

  • On the solution explorer, right-click on the pipeline name and then select “Open With…” option

BizTalk Pipeline does not open with BizTalk Pipeline Editor: Visual Studio Pipeline open with

  • On the “Open with …” window, select “BizTalk Pipeline Editor” option and click “OK”.

BizTalk Pipeline does not open with BizTalk Pipeline Editor: Open with Pipeline-Editor

Once again, this will force Visual Studio to actually open the pipeline with the Pipeline Editor. But again, this will be a simple workaround because next time you try to open the pipeline inside Visual Studio it will open again with the XML (Text) Editor.

Similar to the orchestration behavior, force to “Set as Default” inside the “Open with …” window:

  • Select “BizTalk Pipeline Editor” option, click “Set as Default”
  • And then click “OK”.

It will not solve the problem, once again, if you notice in the picture above it is actually already configured as the default viewer.

So, to actually solve once and for all this annoying behavior, once again you need to adjust the configurations inside the btproj file, by:

  • Open the “<BizTalk>.btproj” (or project) file(s) that contain the pipeline(s) with this behavior with Notepad, Notepad++ or other text editors of your preference.
  • Remove the <SubType>Designer</SubType> line
  • Save the file and reload the project inside Visual Studio

If you then try to open the pipeline it will now open with the BizTalk Pipeline Editor.

Author: Sandro Pereira

Sandro Pereira lives in Portugal and works as a consultant at DevScope. In the past years, he has been working on implementing Integration scenarios both on-premises and cloud for various clients, each with different scenarios from a technical point of view, size, and criticality, using Microsoft Azure, Microsoft BizTalk Server and different technologies like AS2, EDI, RosettaNet, SAP, TIBCO etc.

He is a regular blogger, international speaker, and technical reviewer of several BizTalk books all focused on Integration. He is also the author of the book “BizTalk Mapping Patterns & Best Practices”. He has been awarded MVP since 2011 for his contributions to the integration community.

View all posts by Sandro Pereira

BizTalk Orchestration does not open with BizTalk Orchestration Designer! Instead it opens with the XML (Text) Editor!

BizTalk Orchestration does not open with BizTalk Orchestration Designer! Instead it opens with the XML (Text) Editor!

While trying to open a BizTalk Orchestration inside Visual Studio, normally a simple and easy double-click operation to open the BizTalk Orchestration Designer, I got a very famous behavior: BizTalk Orchestration didn’t open with the BizTalk Orchestration Designer, instead, it opened with the XML (Text) Editor

BizTalk Orchestration does not open with BizTalk Orchestration Designer: Intead opens with XML (Text) Editor

This behavior is happening to me a lot these last days. At first, I simply didn’t care because I know how to quickly workaround it, after a few times it just becomes annoying, after a few days and several orchestrations and different projects I got intrigued an entered in “Sherlock Holmes” mode.

Cause

Well, I don’t know exactly what can cause this problem but I suspect that this behavior happens more often when we migrate projects, or when we try to open previous BizTalk Server versions projects in recent versions of Visual Studio, special if we skip one or more versions, for example: from BizTalk Server 2010 to 2013 R2.

And may happen because of different configurations inside the structure of the “<BizTalk>.btproj” file.

The cause of this strange behavior, is without a doubt related with a mismatch setting inside the structure of the “<BizTalk>.btproj” file in the XLang nodes (each orchestration inside your project will reflect to one XLang node specifying the name of the file, type name and namespace. Normally it has this aspect in recent versions of BizTalk Server:

<ItemGroup>
   <XLang Include="MyOrchestrationName.odx">
      <TypeName> MyOrchestrationName </TypeName>
      <Namespace>MyProjectName.Orchestrations</Namespace>
   </XLang>
</ItemGroup>

But sometimes we will find an additional element:

<ItemGroup>
   <XLang Include="MyOrchestrationName.odx">
      <TypeName> MyOrchestrationName </TypeName>
      <Namespace>MyProjectName.Orchestrations</Namespace>
      <SubType>Designer</SubType>
   </XLang>
</ItemGroup>

When the SubType element is present, this strange behavior of automatically open the orchestration with the XML (Text) Editor.

Solution

First, let’s describe the easy workaround to this annoying problem:

  • On the solution explorer, right-click on the orchestration name and then select “Open With…” option

BizTalk Orchestration does not open with BizTalk Orchestration Designer: open with

  • On the “Open with …” window, select “BizTalk Orchestration Designer” option and click “OK”.

BizTalk Orchestration does not open with BizTalk Orchestration Designer: Orchestration Designer

This will force Visual Studio to actually open the orchestration with the Orchestration Design. But again, this will be a simple work around because next time you try to open the orchestration inside Visual Studio it will open again with the XML (Text) Editor.

You may think that inside the “Open with …” window if we:

  • Select “BizTalk Orchestration Designer” option, click “Set as Default”
  • And then click “OK”.

It will solve the problem, but you are wrong, actually, if you notice in the picture above it is already configured as the default viewer.

So, to actually solve once and for all this annoying behavior you need to:

  • Open the “<BizTalk>.btproj” (or project) file(s) that contain the orchestration(s) with this behavior with Notepad, Notepad++ or another text editor of your preference.
  • Remove the <SubType>Designer</SubType> line
  • Save the file and reload the project inside Visual Studio

If you then try to open the orchestration it will open with the BizTalk Orchestration Designer.

Author: Sandro Pereira

Sandro Pereira lives in Portugal and works as a consultant at DevScope. In the past years, he has been working on implementing Integration scenarios both on-premises and cloud for various clients, each with different scenarios from a technical point of view, size, and criticality, using Microsoft Azure, Microsoft BizTalk Server and different technologies like AS2, EDI, RosettaNet, SAP, TIBCO etc. He is a regular blogger, international speaker, and technical reviewer of several BizTalk books all focused on Integration. He is also the author of the book “BizTalk Mapping Patterns & Best Practices”. He has been awarded MVP since 2011 for his contributions to the integration community. View all posts by Sandro Pereira