Biztalk and related

Transactional Adapters and Adapter Base Classes

2006-05-16T15:12:00.000-05:00

the BizTalk Adapter Development blog just published a whitepaper entitled "Developing a Transactional BizTalk Adapter Using the Microsoft Base Adapter Classes" you can download it from here. i think it is a must read for anyone serious about Biztalk server

Biztalk - Adding a ReceiveLocation

2006-04-06T11:13:00.000-05:00

the following code show how to create a ReceivePort and its corresponding receive Location using Microsoft.BizTalk.ExplorerOM:

private void CreateReceivePort(BtsCatalogExplorer catalog)
{
   Application app = catalog.Applications["FirstIntegration"];

   ReceivePort port = app.AddNewReceivePort(false);
   port.Name = "TestReceiveport";

   port.PrimaryReceiveLocation = port.AddNewReceiveLocation();
   port.PrimaryReceiveLocation.Name = "FileReceive";
   port.PrimaryReceiveLocation.TransportType = catalog.ProtocolTypes["FILE"];
   port.PrimaryReceiveLocation.ReceiveHandler = catalog.ReceiveHandlers[0];
   port.PrimaryReceiveLocation.Address = @"c:\infiles\*.xml";
   port.PrimaryReceiveLocation.ReceivePipeline = catalog.Pipelines["Microsoft.BizTalk.DefaultPipelines.XMLReceive"];

   catalog.SaveChanges();
}

remember to add Microsoft.BizTalk.ExplorerOM reference located under the developer tools folder of your biztalk folder and System.Management, if you want an easy way to get the connection string use Carlos Medina's Get the connection string to BizTalkMgmtDb

Avalon ResourceDictionary

2006-04-06T00:25:00.000-05:00

the following is a simple example on how to use resource dictionaries using just XAML for TextBlocks:

1) Create an empty WinFx solution

<2) Add a ResourceDictionary using add - new Item from the context menu, i'll name it testStyle.xaml but feel free to use any name:

3)Add the following description to your file
  <ResourceDictionaryxmlns:x="http://schemas.microsoft.com/
winfx/xaml/2005"
  xmlns="http://schemas.microsoft.com/winfx/avalon/2005">
      <Stylex:Key="myTestStyle" TargetType="{x:Type TextBlock}">
          <SetterProperty="Background" Value="Green" />
          <SetterProperty="Foreground" Value="White" />
          <SetterProperty="FontSize" Value="40"/>
      </Style>
  </ResourceDictionary>

4) Add the following XAML to the window1.xaml
  <ResourceDictionary
xmlns:x="http://schemas.microsoft.com/winfx/xaml/2005"
xmlns="http://schemas.microsoft.com/winfx/avalon/2005">
     <Style x:Key="myTestStyle" TargetType="{x:Type TextBlock}">
         <Setter Property="Background" Value="Green" />
         <Setter Property="Foreground" Value="White" />
         <Setter Property="FontSize" Value="40"/>
     </Style>
  </ResourceDictionary>

on these lines you see the resource include for the testStyle.xaml file.

now, the complete xaml you look like this:

1:  <Window x:Class="sample.Window1"
2:      xmlns="http://schemas.microsoft.com/winfx/avalon/2005"
3:      xmlns:x="http://schemas.microsoft.com/winfx/xaml/2005"
4:      Title="WPF sample"
5:      >
6:      <Window.Resources>
7:          <ResourceDictionary
          x:Name="testStyle" Source="testStyle.xaml">
          </ResourceDictionary>
8:      </Window.Resources>
9:      <Grid>
10:          <Grid VerticalAlignment="Center"
          HorizontalAlignment="Center" Width="200" Height="100">
11:              <Grid.ColumnDefinitions>
12:                  <ColumnDefinition/>
13:              </Grid.ColumnDefinitions>
14:              <Grid.RowDefinitions>
15:                  <RowDefinition/>
16:              </Grid.RowDefinitions>
17:              <TextBlock
18:                  Style="{StaticResource myTestStyle}"
19:                  Name="ValueLabel"
20:                  VerticalAlignment="Center"
21:                  HorizontalAlignment="Center"
22:                  Grid.Column="0"
23:                  Grid.Row="0">WPF rOck's
24:              </TextBlock>
25:          </Grid>
26:      </Grid>
27:  </Window>

as you can see, the style is applied using StaticResouce myTestStyle, it should be very straight forward.

5) prior to compilation is very important to modify testStyle.xaml's properties in order to identify it as a resource file, this is easily acomplished by right-clicking the file, selecting properties and changing the build action to resource, the following image shows the final result:

skipping this step willl result in a runtime error.

6) Run the application and play with it

WCF Channel Mode

2006-04-05T18:14:00.000-05:00

i strongly recommend checking Yasser Shohoud's channel mode posts, think they might come handy:

Meet the WCF Channel Model - Part 1
Meet the WCF Channel Model - Part 2
Meet the Channel Model: ICommunicationObject
WCF Architecture Overview

read on!!!!

Macs do Windows too

2006-04-05T18:08:00.000-05:00

i think this is worth mentioning:

"More and more people are buying and loving Macs. To make this choice simply irresistible, Apple will include technology in the next major release of Mac OS X, Leopard, that lets you install and run the Windows XP operating system on your Mac. Called Boot Camp (for now), you can download a public beta today."

of course you'll need an intel-based Mac but think of the market impact on this one.
read more

FxCop 1.5 RC

2006-04-05T17:52:00.000-05:00

FxCop 1.35 RC1 has just been released according to the information published on the FxCop blog. You can download the FxCop installer(s) from GotDotNet community website. it is important to Remember that FxCop 1.35 needs the .NET Framework 2.0.

i also recommend you to check FxCop Managed Code Analysis forum

WPF

2006-04-05T14:09:00.000-05:00

if you have been working with Windows Presentation Foundation -A.K.A Avalon- lately, i recommend reading the following articles/blogs so you are up to date with the changes introduced on the latest CTP bits:

ModelVisual3D -- Changes to WPF 3D
ModelVisual3D vs. Model3DGroup -- When to use which?

i also found this tutorial very helpful, it is already updated BTW

right now i'm re-writing my old apps -nothing fancy though-, hope all come together.

PS: i really recommend you guys adding Daniel Lehenbauer's blog to your aggregator

Biztalk clinic

2006-03-10T10:51:00.000-05:00

for those of you interested in learning biztalk server i recommend taking a look at First Look: Microsoft® BizTalk® Server 2006 for Developers

Workflow resources

2006-03-02T20:18:00.000-05:00

for all of you interested in Windows workflow the following are two well elaborated resources you all must read:

Introduction to the Windows Workflow Foundation Rules Engine
Managing Workflow’s Lifecycle

enjoy them

WS-Security 1.1 approved

2006-02-16T00:24:00.000-05:00

OASIS, the international e-business standards consortium, today announced that its members have approved WS-Security version 1.1 as an OASIS Standard, a status that signifies the highest level of ratification. Developed through an open process by the OASIS Web Services Security (WSS) Technical Committee, WS-Security delivers a technical foundation for implementing security functions such as integrity and confidentiality in messages implementing higher-level Web services applications

read more

BTS Easy reflector

2006-02-15T19:21:00.000-05:00

My good friend Carlos Medina has published a nice example demostrating how to use Microsoft's Microsoft.BizTalk.Deployment.dll unsupported assembly, you can find it here

Biztalk Message Encoding

2006-01-31T16:21:00.000-05:00

My good friend Tomas Restrepo has just posted a custom pipeline component sample showing how to fix the message encoding, simple yet very useful, you can read it here

technorati

2006-01-22T10:50:00.000-05:00

well, after some well-deserved vacation days i'm back, i've just added my profile and blog to technorati so feel free to use that site profile

ENTSSO

2006-01-05T11:54:00.000-05:00

mi buen amigo Tomas Restrepo ha publicado dos articulos excelentes acerca del Enterprise Single SignOn, recomiendo que los lean aqui

gacutil command shortcut

2005-12-27T16:49:00.000-05:00

the BIA - Biztalk Intelligence Agency has a very cool trick to shortcut the gacutil command.

Easier way to add a DLL to the GAC

Biztalk Server Interview Answers

2005-12-27T15:52:00.000-05:00

on recent days Stephen W Thomas posted on his blog Biztalk Server Interview Questions what a biztalk interview might contain, i´d like to provide the answers to those questions -at least try- gathered from different sources, any comments are welcome:

Development Focused Questions

What is BizTalk?
for this one i prefer the formal definition provided by webopedia:
"BizTalk Server is Microsoft's central platform for Enterprise Application Integration (EAI) and Business Process Management (BPM) and embodies the integration and automation capabilities of XML and Web Services technologies. BizTalk Server functions as a process execution engine and as a multi-transport hub for messaging and document transformations. It is a Windows Server System product that helps customers efficiently and effectively integrate systems, employees and trading partners"

in addition Microsoft provides a definition as well, What is BizTalk Server 2004?

In BizTalk 2002, schemas were DTD based and allowed Xml Elements to be in any order inside a record using the <Any> keyword. How is this different in BizTalk 2004?
Biztalk 2004 uses XSD in order to define the schemas, this helps addressing XML syntax, data typing and structured description of types

Dave Beauchemin (MVP) and Stuart Celarier have provided us with the main diferences:

- XML Schemas should be used for new development, unless you have a good reason not to; they are the current W3C specification (May 2001), not DTDs.

- Most XML parsers will read both DTDs and XML Schemas. Of note, however, is that MSXML 4 will not load DTDs asynchronously if you have the NewParser property set to true.

- DTDs are written in SGML (the parent language of XML), whereas XML Schemas are written in XML. Therefore, one could say that unless you are proficient with SGML, Schemas (XSD) are easier to use. - Of note, XDR (XML Data-Reduced) is a Microsoft-only implementation, and should be avoided, again, unless you have a good reason not to (e.g., if you use BizTalk 2001). Otherwise, if you select Schemas, make sure you use XSD.

- The XSD is far more expressive than DTD for document structure, such as being able to express that one element may occur zero, one or two times in a specified context. The DTD structure models are fairly limited.

- The DTD has an extremely weak type system, oriented towards describing textual documents. XSD has a strong type system which is well matched with the programmatic types found in modern programming languages. This, for example, allows the xsd.exe utility from .NET to generate a C# class from an XSD document, or an XSD document from a C# class - extremely handy for sending a class instance across a network as an XML document.

- The DTD grammar is not expressed using XML element and attribute markup, whereas an XSD document is an XML document. That makes programmatic generation or manipulation of an XSD document much easier than that of a DTD document.

- The DTD is not aware of XML namespaces. If you have XML documents which now - or may in the future - use namespaces, then create your metadata in XSD.

What is a Message Type (i.e. BTS.MessageType) and how is it used in BizTalk?
message types are basically message content properties (metadata) used for filter creation on send ports and orchestrations -subscription criteria is queried against this metadata-, these properties are promoted for the messaging engine. on this particular case BTS.MessageType is promoted by the dissasembler pipeline during message parsing and specifies the message type (defined as document schema namespace + document root node)

How do you call a Non-Serializable .Net helper class inside an Expression Shape?
What if the class is Serializable?
the answer to the previous two questions can be read on Mike holdorf's blog

What does the Value Mapping Functoid do?
value mapping and value mapping (flattening)

How do you use Auto Mapping in the BizTalk 2004 mapper?
the following was taken from Microsoft® BizTalk Server 2004 UNLEASHED and explains this capability:
"You can link entire substructures with one mouse-drag operation. If you hold the Shift key down while dragging between two records, the Mapper will create simple links between the records and all subordinate nodes if the content of the source and destination nodes is the same. This is a useful shortcut if you have identical structures contained within differing parent formats. If the two subtrees are slightly different, links will be created automatically only for those nodes with identical names. This can be changed by changing the setting of the grid's Autolink By property"

What is the default mapping for Auto Mapping?
the autolink by Controls how links are automatically generated when linking two records:

- Structure Links by identical or similar child content structure without regard to node names.
- Node Name Creates automatic links only if two names have the same name.

the default one is Structure

Step-by-step, how do you set up a basic, pure messaging solution taking in a flat file and send an Xml File out to 5 different places?
update: here is the answer:
- Create a Flat File schema
- Create a Custom Pipeline using the Flat File Disassembler
- Create a Receive Port
- Create 5 Send Ports
- Create a Send Port Group
- Add each Send Port to the Send Port Group
- Create a Filter on the Send Port Group using Bts.ReceivePortName (or something close to this)
- Additional: no map is required but it is ok to mention it

Design (Architecture) Focused Questions

What is the difference between a Distinguished field and a Promoted Property?
Basics of Promoted Properties Inside BizTalk Server 2004

How do you achieve First-In-First-Out message processing of messages received from multiple sources using an Orchestration?
FIFO processing would be achieved using convoys, on the following links you can find information about it:
- BizTalk Core Engine's WebLog
- BizTalk Server 2004 Convoy Deep Dive

something you must keep in mind is: "FIFO is only possible when using an "order-aware" adapter, such as one leveraging MSMQ protocols or the MQSeries adapter"

At high level, what do Receive Ports and Orchestration Send Port really do in terms of messaging? What about Send Ports and Orchestration Receive Ports?
Receive Ports and Orchestration Send Port = suscribe
Send Ports and Orchestration Receive Ports = publish

When working with Schemas, Maps, Pipelines, and Orchestrations how should the projects be structured?
in theory you must separate project assemblies by orchestations / schemas + maps / custom pipelines to reduce GAC dependency and future binding problems, Alan Smith has a very interesting article BizTalk Server - Modular Deployment worth reading.

What is direct binding?
port bindings:Your orchestration can communicate directly with another orchestration by using direct binding. In this case, the message is processed internally by the engine, and no external transport of the message takes place

Charles young has a great article aboud this topic BizTalk Server 2004: Direct Binding models in BizTalk , i recommend you to check it out

What is BAM used for?
BAM -Business Activity Monitoring- is a general framework for tracking heterogeneous business processes regardless of insfraestructure, providing business users with real-time visibility.

here are some useful links:
- Kevin Smith posted BAM: Tracking Portal which explains how to create a BAM tracking portal, BAM can be very useful for developers and IT pros as well
- Microsoft.BizTalk.Bam.EventObservation Namespace
- Business Activity Monitoring (BizTalk Server Samples Folder)

What is the Rules Engine?
Orchestration Designer, together with BizTalk Editor and BizTalk Mapper, is an effective way to define a business process and the rules it uses. Over time, however, the rules specified in an orchestration can change. The decisions embedded in a business process—the business rules—are commonly the most volatile. For example, a manager's spending limit might change, or a customer's maximum allowed order might change. You need a way to define and change business rules. To meet this need, BizTalk Server 2004 provides the Business Rule Engine to enable you to directly create and modify sets of business rules. These rules are created by using a tool called the Business Rule Composer, and then executed directly by the engine. This technology is new in BizTalk Server 2004. Business Rule Engine

the following links will make clear how to define your business rules:
Defining Business Rules - What Are They Really?
The Business Rules Manifesto

Jon Flanders recorded a interesting webcast: Implementing a Business Rules Engine Solution Using BizTalk Server 2004

What are Persistence Points and what causes them?
The orchestration engine saves the state of a running orchestration instance at various points. If it needs to rehydrate the orchestration instance, start up from a controlled shutdown, or recover from an unexpected shutdown, it will run the orchestration instance from the last persistence point, as though nothing else had occurred

on the following link you can read more about persistence

What group does a user need to belong to in order to submit messages to the message box?
the user must be a member of at least one of the following groups:
- Biztalk host users
- Biztalk Isolated host users

on the following links you may read more about this topic:
Windows Group and User Accounts in BizTalk Server
About Host Groups

What user rights to you need to perform most actions in HAT?
You must manually grant permissions to BizTalk administrators group to access the Analysis Services Tracking database; by default, only OLAP administrators have permissions to it.

on Microsoft® BizTalk Server 2004 UNLEASHED you can find a good resource on biztalk tracking

When installing Biztalk in a multi-server configuration with a remote SQL and Analysis Services, what SQL components do you need on the Biztalk Server?
- SQL Server Analysis Services + Decision support objects (requeried for BAS)
- MS SQL SP3a
- MS SQL Update from Q831950 (SQL2000-KB810185-8.00.0878-ENU.exe)
- configure SQL Server DTC

you can read all the installation procedure on BizTalk Server 2004 Installation in a Multi-Server Environment

When installing Biztalk and SQL on a Windows XP SP2 Desktop, what pre-requests are required?
i couln't find an exact resource for this one, if anyone knows about it i'd appreciate your feedback, please refer to the biztalk server installation guide, there's a known issue about the SSO service after installing XP SP2 if you are interested it can be found here

Biztalk VNEXT wish list

2005-12-26T14:55:00.000-05:00

Stephen W. Thomas on his post BizTalk vNext (Biztalk 2008?) Wish List provided a list of what everyone is expecting from microsoft on his future realease of biztalk, summarizing:

- Convoy as a setting on the receive port
- Ability to suppress event log messages via a context property
- Better control over property promotion
- Checking a promoted property that does not exist does not throw an exception
- When a default value is set on a promoted property and it is associated with a schema the default value should always exist in the message context
- Support for multiple Acks and NAcks with send port groups

there are some interesting wishes posted like:

- Biztalk mapper can be definitely improved (looks like Microsoft is already working on this). some of the features which I would like are
a. Ability to somehow access the promoted properties context inside the mapper.
b. Search capabilities inside the map (not only on schema names)
c. Error Handling capabilities inside a map

Biztalk performance

2005-12-26T14:18:00.000-05:00

Darren Jefford has a list of performance tips for BizTalk Server 2004 implementations, from the blog:
"Another issue that came up recently which I didn’t fully appreciate is how “expensive” Atomic Scopes are, don’t get me wrong, they’re great and need to be there but I’m increasingly seeing customers using them where they don’t have to – For those of you with a COM+ background it’s analogous to running your code within a Transaction, most customers didn’t need them but turned it on anyway causing significant problems"...

Biztalk and windows workflow

2005-12-26T12:15:00.000-05:00

A lot has been said regarding Biztalk server and Windows worflow foundation, here are some references that might come handy:

BizTalk Server 2004/2006 and Windows Workflow Foundation by Brian Loesgen
Windows Workflow Foundation vs BizTalk Server by Lamont Harrington
Windows Workflow Foundation - Where does BizTalk fit in? by Darren Jefford
Introducing Microsoft Windows Workflow Foundation: An Early Look by David Chappell