BizTalk and around : WCF

WCF адаптер для очередей Oracle AQ

yaroslav — Thu, 20 Nov 2008 14:05:53 GMT

Продолжая предыдущий пост, поделюсь опытом разработки транзакционного WCF адаптера для очередей Oracle Advanced Queuing (AQ).

Предыстория

Перед нами (MCS) возникла задача показать возможность интеграции информационных систем построенных на Oracle с помощью BizTalk. В силу многих причин было принято решение не использовать хранимые процедуры и не подключаться к таблицам напрямую, а передавать данные в виде отдельных сообщений через очереди Oracle. Одним из требований была возможность гарантированной доставки, чтобы данные не удалялись из источника пока не попадут в следующее надежное хранилище, но и не попадали в следующие хранилище пока не удалятся из источника. Проще говоря, передача данных должна осуществляться в рамках транзакции.

Для решения этой задачи нужно было найти существующий или разработать собственный адаптер, который бы умел подсоединяться к AQ и забирать данные внутри транзакции объединяющей источник данных (в данном случае AQ) и BizTalk MessageBox. На момент выбора адаптера для Oracle AQ у партнеров Microsoft уже существовали адаптеры умеющие работать с Oracle AQ, но все они имели некоторые ограничения, например отсутствие поддержки транзакций. Поэтому было принято решение разработать свой адаптер с помощью WCF LOB Adapter SDK.

Разработка адаптера

Для решения задачи взаимодействия с AQ было рассмотрено множество вариантов, вот некоторые из них:

JMS – нужен адаптер для JMS, подтверждение возможности транзакционной передачи получено не было.
SOAP – дополнительное звено и необходимость развертывания веб-сервера на стороне базы данных. Транзакционность тоже под большим вопросом.
PL\SQL через ODP.NET – нужна установка Oracle Client и ODP.NET.

В итоге единственным приемлемым вариантом удовлетворявшим большинству требований оказался PL\SQL, который предоставляет простые команды для работы с очередями AQ, а ODP.NET предоставляет прозрачный интерфейс для работы с .NET транзакциями.

После выбора способа взаимодействия дальнейшая реализация WCF адаптера заняла минимальное кол-во времени, включая поддержку транзакций и выгрузку метаданных для использования в BizTalk решении. Это говорит не столько об опытности Microsoft Consulting Services :), сколько о простоте инструментария WCF LOB Adapter SDK. Так что если перед вами стоит задача подключения к одной из унаследованных систем, или системе для которой ни у Microsoft ни у партнеров нет адаптера, вы можете написать его самостоятельно, это не так сложно как может показаться.

Разработка транзакционных адаптеров для BizTalk с помощью WCF LOB Adapter SDK

yaroslav — Tue, 18 Nov 2008 11:57:00 GMT

Сегодня я расскажу о том, как разработать собственный адаптер для BizTalk с помощью WCF LOB Adapter SDK и сделать его транзакционным.

Перед началом разработки адаптера нужно убедиться, что у вас уже установлено:

· BizTalk Server 2006 R2

· Visual Studio 2005 SP1

· .NET Framework 3.0

· WCF LOB Adapter SDK 1.1

После этого, открыв Visual Studio 2005, вы увидите в списке шаблонов проектов WCF LOB Adapter.

Можно попробовать сразу начать писать адаптер с нуля, используя шаблон, но если нет опыта, рекомендую выполнить пошаговый пример разработки эхо-адаптера. Если времени совсем нет, можно посмотреть исходный код готового эхо-адаптера, он поставляется вместе с WCF LOB Adapter SDK. Его можно найти тут: C:\Program Files\WCF LOB Adapter SDK\Documents\Samples. Кстати в состав готового эхо-адаптера так же входит проект для сборки установочного msi пакета, позволяющий автоматизировано развертывать адаптер на других компьютерах.

Как мы уже писали ранее, большой плюс WCF адаптеров в том, что их можно вызывать не только из BizTalk, но и из любого .NET приложения. Во втором примере как раз демонстрируется, как это сделать.

Поддержка транзакций

После того как мы научились создавать WCF адаптер, можем усложнить задачу и сделать его транзакционным. Зачем это нужно. Например, если вы хотите быть уверены в том, что данные не удаляться из источника пока они не попадут в надежное хранилище, например BizTalk Message Box. Для этого нужно чтобы запись в Message Box и удаление уже считанных данных из источника производилось в одной транзакции. Сначала это может показаться сложной задачей, ведь прежде чем попасть в Message Box сообщение может проходить сложную обработку в receive pipeline, используя большое кол-во компонентов. Сразу возникает много вопросов, как создать транзакцию, как заставить BizTalk использовать эту же транзакцию при записи сообщения в Message Box, кто всем этим процессом будет управлять? Ответ прост, практически всю работу по созданию и управлению транзакцией берёт на себя WCF LOB Adapter Framework, нужно только указать, что мы хотим использовать транзакции.

Для исходящих (outbound) операций, транзакция создается автоматически. То есть метод Execute в IOutboundHandler, будет выполняться внутри TransactionScope, созданного WCF LOB Adapter Framework и если проверить значение переменной Transaction.Current, то мы увидим, что оно не null.

Для входящих (inbound) операций включить транзакции немного сложнее, существует 2 способа, для одностороннего (oneway) типа канала и канала запрос-ответ (request-reply). Реализовать 1й намного проще, начнем с него.

Односторонний (OneWay):

1. В конструкторе вашего адаптера установите свойство SupportsTransactedInbound в true

2. В методе CreateBindingElements вашего Binding класса, добавьте в начало коллекции BindingElements элемент OneWayBindingElement. Обратите внимание, что его нужно добавлять только во время работы адаптера, то есть в случаях когда адаптер выполняет выгрузку метаданных этот элемент добавлять нельзя. Для этой цели можно добавить к списку свойств адаптера дополнительную булевою переменную. Её мы будем устанавливать только когда адптер выполняется, например, когда настраиваем параметры адаптера в свойствах BizTalk Receive location.

3. После этого WCF будет самостоятельно создавать транзакцию и вызывать ваш метод TryReceive внутри неё. Так же он самостоятельно выполнит фиксацию транзакции после того как ваше сообщение попадет в MessageBox. Если же при обработке сообщения в pipeline произойдет исключение, то выполниться откат транзакции.

Примечание: В BizTalk нужно создать OneWay receive порт.

Запрос-ответ (Request-Reply):

1. В конструкторе вашего адаптера установите свойство SupportsTransactedInbound в false

2. В методе TryReceive создайте транзакцию самостоятельно.

3. Присвойте сообщению созданную транзакцию с помощью TransactionMessageProperty.Set

4. В методе Reply вашей реализации IInboundReply зафиксируйте транзакцию.

Примечание: В BizTalk нужно создать Request-Reply receive порт.

Поддержка транзакций источником данных

Если ваш источник данных транзакционный и его SDK умеет работать с механизмом транзакций .NET, то вам, скорее всего, ничего не придется делать. Например, Oracle провайдер ODP.NET такую поддержку имеет, и если открыть соединение внутри .NET транзакции (TransactionScope) то все операции с базой данных Oracle будут выполняться в этой транзакции.

Заключение

Если вы всё сделали правильно, то вы получили WCF адаптер, который вы можете использовать в своих решениях построенных на BizTalk Server или в любых других .NET приложениях.

P.S. В следующей версии WCF LOB Adapter SDK реализация односторонних операций станет ещё проще, достаточно будет установить одно свойство. О выходе новой версии мы обязательно сообщим, так что заходите на наш блог почаще, либо получайте обновления автоматически через RSS.

Июньские MSDN веб-касты о WCF/WF

stas — Wed, 11 Jun 2008 17:04:00 GMT

Начиная со следующей среды (18.06) наши коллеги из Редмонда организуют серию MSDN веб-кастов о WCF и WF.

Ссылки на касты доступны здесь: : http://www.microsoft.com/events/series/msdnnetframework35.aspx?tab=webcasts&id=liveall

Программа следующая:

Webcast Title	Date/ Time	Presenter
Beyond the Endpoints with Windows Communication Foundation	6/18/2008 10:00 AM PST	Juval Lowy
geekSpeak: Workflow Services in .NET 3.5 with Jon Flanders	6/18/2008 12:00 PM PST	Jon Flanders
Calling Services from Silverlight 2.0	6/23/2008 09:00 AM PST	Jon Flanders
Windows Communication Foundation and Windows Workflow Foundation Integration in Depth	6/25/2008 10:00 AM PST	Jesus Rodriguez
Windows Workflow Communication in Depth	6/26/2008 09:00 AM PST	Matt Milner

Поддержка транзакций в WCF Oracle adapter

stas — Thu, 08 May 2008 11:21:00 GMT

Недавно мне прислали вопрос о том, как обновить две таблицы в БД Oracle в одной транзакции, отправив два соответствующих сообщения из BizTalk через WCF Oracle адаптер.

Казалось бы, интутитивно, заключение двух Send форм в Atomic transaction scope должно привести к желаемому результату. Однако, такие транзакции выполняются на уровне MessageBox.

Как всегда, решение имеет несколько вариантов. Стандартные варианты в таких случаях - иметь хранимую процедуру, выполняющую обновление двух таблиц и вызывать ее через адаптер, либо воспользовать Expression формой, где через средства .NET выполнить обновление в транзакции.

С новым же WCF Oracle адаптером, у вас появилась возможность поддержки транзакций для серии отдельных сообщений. По этой ссылке можно прочитать про эту возможность. Далее я опишу, как это сделать своими словами.

Итак, у вас есть набор сообщений для Oracle, которые вы хотите отправить в единой транзакции. Первое, что нужно сделать это установить у таких сообщений следующие свойства:

http://schemas.microsoft.com/BizTalk/2003/system-properties#SPID

Это стандартное свойство, которое устанавливается адаптером в идентификатор исходящего порта (в нашем случае Oracle порта). Все сообщения в транзакции должны иметь единое значение этого свойства. Т.е. все такие сообщения должны отправляться через единый исходящий порт (возможно с различными операциями на каждое действие).

http://schemas.microsoft.com/BizTalk/2003/system-properties#InterchangeID

InterchangeID так же стандартное свойство и оно позволяет отнести сообщения с единым значением InterchangeID к единой сессии передачи сообщений (например, при дебатчинге входящего сообщения, все получившиеся сообщения имеют одинаковое значение InterchangeID). Итак, вам придется установить это свойство в оркестровке для серии транзакционных сообщений в единое значение - это может быть просто сгенерированный Guid или взятый InterchangeID из входящего сообщения.

http://Microsoft.LobServices.OracleDB/2007/03/OracleDBSendContextProperties#TransactionState

Третье свойство определено в сборке Microsoft.Adapters.OracleDB.BiztalkPropertySchema.dll, которая идет в поставке с BizTalk Adapter Pack (находится в папке bin, где установлен пакет). Добавьте эту сборку, как ресурс через административную консоль BizTalk (например, в стандартное приложение BizTalk Application 1). В ваш проект же добавьте на нее ссылку (через Add Reference).

TransactionState - это очень важное свойство, т.к. оно регулирует действия над транзакцией, и может принимать следующие значения:

BEGIN - сообщение, которое может быть либо данными или контрольным (об этом ниже) сообщением, иницирует транзакцию.
REUSE - сообщение включается в транзакцию.
COMMIT - контрольное сообщение подтверждает транзакцию.
ABORT - контрольное сообщение откатывает транзакцию.

Контрольное сообщение имеет следующий вид: <Oracle_Transaction xmlns="http://Microsoft.LobServices.OracleDB/2007/03/Oracle_Transaction"></Oracle_Transaction>. Операция отправляющая контрольное сообщение в адаптер должна мэпиться на SOAP action "http://Microsoft.LobServices.OracleDB/2007/03/Oracle_Transaction".

Схема контрольного сообщения (дабы не создавать его руками) находится в папке Schemas, где установлен BizTalk Adapter Pack.

Это все о свойствах.

Сам WCF-custom адаптер с байндингом oracleDBBinding должен иметь свойство enableBizTalkCompatibilityMode установленным в true (по умолчанию, это так).

Небольшой пример. Я получаю входящее сообщение, создаю два исходящих, каждое из которых обновляет различные таблицы Oracle и затем завершаю транзакцию.

Моя оркестровка выглядит так:

В форме MessageAssignment происходит самое интересное: я устанавливаю свойства всей серии Oracle сообщений:

doc = new System.Xml.XmlDocument();
doc.LoadXml("<ns0:Oracle_Transaction xmlns:ns0='http://Microsoft.LobServices.OracleDB/2007/03/Oracle_Transaction'></ns0:Oracle_Transaction>");

mCommit = doc;

mInsertProduct(Microsoft.Adapters.OracleDB.BiztalkPropertySchema.TransactionState) = "BEGIN";
mInsertProduct(BTS.InterchangeID) = mInbound(BTS.InterchangeID);
mInsertPO(Microsoft.Adapters.OracleDB.BiztalkPropertySchema.TransactionState) = "REUSE";
mInsertPO(BTS.InterchangeID) = mInbound(BTS.InterchangeID);
mCommit(Microsoft.Adapters.OracleDB.BiztalkPropertySchema.TransactionState) = "COMMIT";
mCommit(BTS.InterchangeID) = mInbound(BTS.InterchangeID);

Последовательность отправки сообщений: mInsertProduct, mInsertPO, mCommit.

Порт Oracle в консоли администратора имеет следующие настройки WCF-Custom для SOAP Action Header:

Вот пожалуй и все. Теперь вставка в две разные таблицы будет производится в единой транзакции.

Стас

Безопасность WCF в вопросах и ответах

stas — Mon, 28 Apr 2008 06:35:00 GMT

На CodePlex вышел большой список ответов на вопросы, связанных с моделями и способами обеспечения безопасности в WCF.

Сам список был сформирован исходя из реальных сценариев применения WCF у клиентов, запросов в техническую поддержку и часто возникающих вопросах на форумах.