Saturday, December 15, 2007

Exposing a BTS orchestration as a WCF service

Hey everyone, I've learened recently few new technologies that were just released and so decided to share some of the stuff that was hard to find on the web.

I'll start with Exposing a BizTalk orchestration as a WCF service, it's really simple but there are some problems that happened along the way.

1. First publish your orchestration as a WCF service

- open the “BizTalk WCF Service Publishing Wizard”

-Select your Http Binding
-Browse for your BizTalk application



-Browse for your BTS application dll.

-Type the name of your namespace.
-Type the name of the Service on the IIS.


2. After you finish you will have a WCF service created in your IIS.



3. Now you can “Browse” your WCF service normally as any webService.


4. Consuming your WCF service in a client application:

a. Open VS Command Prompt and type:
“svcutil.exe http://server2003sql:81/WCF_Service/DemoBTS_OrderProcessing_Order_RecievePort.svc?wsdl”
b. This will generate two files at the directory you are on, a configuration file “Output.config”; which contains the endpoint for your WCF service and a code file “BizTalkServiceInstance.cs”; that contains the client class (objects for your receive port and objects for your schemas).
c. Add the two files to your client application and use the generated client class to call the Service.

5. Submitting data from InfoPath to WCF service:
It’s the same as submitting to WebService, you can find its steps here:
http://weblog.vb-tech.com/nick/archive/2007/01/17/2100.aspx




PROBLEMS:
  • Problem 1
Symptoms:
An error occurred while browsing your WCF service from IIS and you can’t view the error.
Resolution:
1. Open the “web.config” file at “C:\Inetpub\wwwroot\WCF_Service”.
2. Uncomment the tag, now you’ll be able to view your error
  • Problem 2

The SOAP Adapter fails to register


Or
The following error may occur when BizTalk Server attempts to register the SOAP (or HTTP) adapter.
"The Messaging Engine failed to register an adapter "SOAP" (Or "HTTP"). Details: "Registering multiple adapter types within the same process is not a supported scenario. For e.g. HTTP and SOAP receive adapters cannot co-exist in the same process".

Cause:
When running BizTalk Server on Windows Server 2003 / IIS 6.x, the SOAP and HTTP adapters cannot execute in the same process space or application pool.
Resolution:
If an installation requires using both the SOAP and HTTP adapters on the same Web server then separate application pools must be created for each adapter. Once created, the virtual directories for each adapter are each assigned to a different application pool.


  • Problem 3

Cause
You forgot to assign the receive port of the orchestration to the generated receive port of the WCF service.
Resolution
In the “BizTalk Server Administration” Tool >> Orchestration properties >> Bindings



Thursday, December 13, 2007

Code Snippets - Get the most out of them

Microsoft finally decided to help us remember some code using the code snippets, that was a new technique since Visual Studio 2005. Visual Studio 2005 came up with some built in code snippets too that I personally didn't find them as much useful as expected. However, later in October 2006, they produced a very nice and vast set of C# code snippets that you can download to integrate those already installed with Visual Studio 2005.
You can download it from this link: http://go.microsoft.com/fwlink/?linkid=57395&clcid=0x409

As you can see below, these snippets have a wide range of functionality that we need in our daily programming activities. You no longer have to know how to Read Data from a Serial port or even compute the hashcode of a password. It's really a great one from Microsoft.

How to Add them?

  1. Well, first of all install the msi file that you downloaded from the URL above
  2. From the Visual Studio menu, choose Tools > Code Snippets Manager.


  3. Press the Add button from the dialog box that will appear


  4. When installing the code snippets package, it will copy all the snippets to My Documents\MSDN\Visual C# 2005 Code Snippets.
    so add this URL in the Browse dialog and press open.


Here you are, and you are done. Right click, Insert Snippet, and you will find the new Visual C# code Snippets appear.


Enjoy and Happy Programming ;)

Sunday, December 9, 2007

Make Pasting into Visual Studio Easier

Don't be limited to plain text. You can paste strings into Visual Studio as comments, string, StringBuilders, and more.

SmartPaster is a plug-in for Visual Studio .NET 2003 that allows text on the clipboard to be pasted in a format compatible with C# and Visual Basic code. SmartPaster can be downloaded from http://www.papadimoulis.com/alex/SmartPaster1.1.zip.

After downloading and installing SmartPaster, you will see a new item on the right-click (context) menu

Paste as String/StringBuilder

I find myself most frequently pasting text as a string or a StringBuilder. You can copy any sort of text from another application, then when you paste that text into Visual Studio, you can choose to paste it as a string or as a StringBuilder.

Many developers like to build a SQL statement using a tool such as Query Analyzer, for easy testing and debugging, or Microsoft Access, for quick, visual development. As simple as it is to build queries externally, putting them into code can often be a challenge, especially when the queries span multiple lines. SmartPaster eases the task of bringing external queries to code: simply copy your query to the clipboard and paste as a string or StringBuilder. For example, if you copied the following SQL to your clipboard:

SET ROWCOUNT 10

SELECT ProductName

FROM Products

ORDER BY Products.UnitPrice DESC

then paste the code into Visual Studio using Paste As String, you would see the following code:


@"SET ROWCOUNT 10" + Environment.NewLine +

@"SELECT ProductName" + Environment.NewLine +

@"FROM Products" + Environment.NewLine +

@"ORDER BY Products.UnitPrice DESC" + Environment.NewLine +

@""

You could also paste this code using Paste As StringBuilder and specify a StringBuilder name of "sqlBuilder," and this would result in the following code:

StringBuilder sqlBuilder = new StringBuilder(141);

sqlBuilder.AppendFormat(@"SET ROWCOUNT 10{0}", Environment.NewLine);

sqlBuilder.AppendFormat(@"SELECT ProductName{0}", Environment.NewLine);

sqlBuilder.AppendFormat(@"FROM Products{0}", Environment.NewLine);

sqlBuilder.AppendFormat(@"ORDER BY Products.UnitPrice DESC");

Like SQL statements, text displayed to the user is often developed externally, either by a copywriter, business analyst, or coder (such as myself), and requires the spellchecker within Microsoft Word. Usually, pasting such code would require going character by character, escaping quotes, and manually adding in line breaks. With SmartPaster, a quick right-click, paste-as, and your external copy is now internal without any of the normal hassle.

In an ideal world, all messages and dialogs would be stored in an external resource file and all SQL statements would be in views and stored procedures. But in a world of deadlines and disposable microapplications, doing it the right way is often trumped by "make sure it works."

As we've seen, SmartPaster offers the option of pasting your text as a string or a StringBuilder. While the difference may seem cosmetic, there are actually appropriate times to use one over the other. The reasoning behind this is that string literals (i.e., strings explicitly declared in your code, as opposed to those input by the user) are immutable. This means that every operation on a string, such as a concatenation or replacement, involves creating an in-memory buffer, performing the operation, creating a new string, and finally passing the old one to garbage collection.

Knowing that, it's fairly easy to decide whether to use a string or a StringBuilder. If the text will always be static, such as a tool tip, there will be no advantage to using a StringBuilder (even if string literals are concatenated across lines, the compiler joins them in memory). However, if the text will vary on conditions, such as a runtime error message, then there will definitely be a performance hit using a string as opposed to a StringBuilder.

Paste as Comment

Just as with strings, any text on the clipboard may be pasted as a block of comments. I've found this very helpful in many cases. Having instant blocks of comments makes development much easier because of the following reasons:

  • Business rule requirements may be pasted directly into the code for easier translation and to explain what is being done.

  • Documentation from MSDN or other sources may be pasted in, avoiding the need to switch between the code and a browser window.

  • When upgrading code from another platform, the legacy code can be pasted as a comment, making it easier to ensure the logic is the same.

To paste text as a comment, you simply need to copy text to your clipboard and then choose Paste As Comment. For example, if you copied the following piece of text to your clipboard:

Call the test method to walk through this scenario and test every part.

and then pasted it into your document using Paste As Comment, you would see the following comment added:

//Call the test method to walk through this scenario and test every part.

Paste as Region

When pasting as a region, the clipboard text will simply appear between #region and #endregion tags with a region name of your choice. This feature is often helpful when organizing code within your application or pasting regions of code developed by someone else.

First, copy a piece of code like this one to your clipboard:

private void DoSomething( )

{

//Write Code Here

}

Then select Paste As Region, and a small dialog will appear.

From this dialog, you specify the name of the region that you want to use; after you click OK, this code will be pasted into your document:

#region DoSomething Method

private void DoSomething( )

{

//Write Code Here

}

#endregion

Configuration

SmartPaster offers a number of configuration options to make the add-in work best for you. The SmartPaster configuration can be accessed through Paste As Configure.