Mehmet AYDIN

While configuring your Biztalk Server and if you are getting;

SSO AUDIT
Error Code: 0xC0002A1F, Cannot perform encryption or decryption because the secret is not available from the master secret server. See the event log for related errors.

or

something else including “because the secret is not available from the master secret server“

then
you must restore your master password

1. Open Command Promt, go to “C:\Program Files\Common Files\Enterprise Single Sign-On\”
2. Enter “ssoConfig -restoresecret SSOxxxx.bak”; SSOxxxx.bak is your latest .bak file
3. Enter the password that was set on BizTalk installation,

That’s it.

Regeditde yapacağımız küçük bir değişiklik ile, DLL imizin üzerine sağ tıklayıp, şekildeki gibi GAC-IT dediğimizde Global Assembly Cache(GAC)’e otomatik olarak dll’imizi yükleyebiliriz.

Yapmamız gerekenler :

1. Yeni bir txt dosyası oluşturuyoruz.
2. Dosyanın içine aşağıdaki kodları yazıyoruz

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\dllfile\shell\GAC-It\command]
@=”c:\\windows\\Microsoft.NET\\Framework\\v1.1.4322\\gacutil.exe /i \”%1\”"

3. Dosyayı .reg uzantılı olarak kaydediyoruz ve herşey tamamladıktan sonra çift tıklamamız yeterli…

..source..

Hata : “The context of the message associated with this instance contains all the promoted properties at the time of the routing failure”

Tanım : Hata genellikle (en azından bende ) aynı URI içeren birden fazla schema mevcutsa ortaya çıkmakta. Özellikle bir web service vb… yerden gelen xml’leri kullanarak, otomatik şema üretilirse oluşan XSD’lerin Namespace URI’leri yanı olacaktır. Bu yüzden XSD üretmeden önce mutlaka XML içine müdahelede bulunarak namespace’e bir prefix veya postfix verilebilir.

Çözüm : BizTalk Administration Console’a girilir, oradan schemalara tıklanılır ve Namespace URI’leri aynı olan birden fazla schema mevcutsa manuel müdahelede bulunmak suretiyle çözüm üretilir

Bu hata da bundan iki mesaj önce yazdığımın tam tersi. Genellikle Send Portlardan bir xml mesajını dosyaya yazmak istenildiğinde karşımıza çıkar.

Hata : There was a failure executing the Send Pipeline, This Assembler cannot retrieve a document specification using this type ‘blabla’.

Tanım : Mesajımız XML formatında olduğunda ve Send Pipelineımızı XmlTransmit tanımlamışsak, BizTalk bunu belirli bir şekilde cicili bicili yazmaya çalışacaktır. Muhtemelende başarılı olamıyacaktır. Bunu söylerken verinin Web Service gibi bir yerden geldiğini düşünüyorum. Çünkü asla istediğimiz formatta gelmez.

Çözüm : BizTalk Administration Console a girilir, İlgili Send Portun Pipeline’ı ReceiveTransmitten PassThruTransmite çekilir.

Yani -> ReceiveTransmit to PassThruTransmit…

Biztalkda SQL adapter kullanarak stored procedure veya updategram kullanıyorsanız ve yukarıdaki hataya benzer bir hata mesajı alıyorsanız bilin ki :

Sorun : “Inner exception: Received unexpected message type ‘ ‘ does not match expected type ‘http://blabla’.

Tanım : BizTalk Server, send veya receive adapterlerinden birinde boş mesaj tipi almakta.

Çözüm : BizTalk Administration Console’a girip ilgili adapterin Send Pipeline ve Receive Pipeline’larını PassThruTransmit’den XML Transmite çevirin.

Yani,  PassThruTransmit to XML Transmit

Dehydration’ın sözlük anlamına bakarsanız “suyu çıkmış” gibi bir meale geldiğini görebilirsiniz. Bunu gördükten sonra sakın ha “ne ulen projemin .oku mu çıktı yani?” diye sinirlenmeyin Adamlar düzgün çeviremiyor işte…

Genel olarak;

1. Orchestration mesaj almayı beklerken ve beklenilen zaman belli bir eşik değerinden fazla olduğu zaman,
2. Listen şeklini kullandığınızda,

karşılaşabileceğiniz bir problemdir. Sistemdeki mantık şudur :

BizTalk belirli bir eşik değerine kadar mesajı dinlemeye devam eder. Bu zaman dilimi dolduğunda ve sistemden hala bir cevap mesajı gelmediği durumda, BizTalk o anki durumu(state) bilgisayarımıza kaydeder. Yani sistem kaynaklarını serbest bırakır. Örneğin; mesaj bir web serviceden gelecek olsun. Biz Requestimizi yaptıktan sonra, belirli bir sürede web service geri dönüş mesajı vermesse Orchestration Dehydration durumuna düşer. Web service response’u verdiğinde ise bu state’den çıkılır ve normal işlemlerin yapılmasına devam edilir.

Orchestration Dehydration state’indeyken, önceden ayarlanmış bir süre kadar bekler. Örn; 5 dk. Bu süre dolduğunda hala cevap gelmemişse durum Dehydration’dan Error’a döner.

Biztalkta en fazla karşılaşılan deploy problemlerinden biridir “Early Binding” olayı.

Hatadan kurtulmak için yapılması gerekenler:

1. Eğer bir restore işlemi gerçekleştiriyorsanız, bu işlemi SSO Administration’dan yapmanızı şiddetle tavsiye ederim. Yoksa bu hatayı almaya bol miktarda devam edebilirsiniz.
2. Sorun büyük ihtimalle Port tanımlamalarınızdadır. Şöyle ki; Mesaj çıkışını File seçmiş olabilirsiniz ve bu File’ın çıkış adresini de “c:\OUT\%MessageID%.XML” yerine “%MessageID%.XML” yapmış olabilirsiniz. Veya bir syntax hatası olabilir. Tavsiyem tüm port ayarlarınızı tekrar kontrol etmeniz yönündedir.

BizTalk Server 2006 kurulurken yararlanmanız gerek ve elinizde bir adet çıktısının bulunması gerek o mühim döküman. Tıklayın…

Türkçe google da BizTalk Kurulumu diye arattığımda sonuç çıkmamasını çok garipsedim Hiç mi kimse Türkiyede Biztalk bilmiyor? Ya da biliyor ama yazmıyor?

Neyse ben adım adım BizTalk’un kurulumunu anlatmaya çalışayım.

1. İlk önce kurulum için Windows 2003 kurulu bir makine lazım, (tercihen R2)
2. Daha sonra makinenin üzerine IIS kurulumu,
3. SQL Server 2005 kurulumu (tercihen SP 2′li),
4. VS.NeT 2005 Kurulumu (Maalesef BizTalk 2006 .NeT 2008 ile uyumlu çalışmamakta),
5. Administrative Tools (Yönetim Araçları)ndaki “Groups” lara aşağıdaki grupların eklenmesi gerekmekte. Neden, Niçin bilmiyorum. Microsoftun bir ürününün kurulumu sırasında bunun gibi bir şeyin otomatik oluşturulmasını beklerdim ama maalesef manuel oluşturmamız gerekmekte.
   • Administrators
   • BAS Enabled Hosts
   • BizTalk Application Users
   • BizTalk BAS Administrators
   • BizTalk BAS Managers
   • BizTalk BAS Users
   • BizTalk BAS Web Services Group
   • BizTalk Isolated Host Users
   • BizTalk Server Administrators
   • BizTalk Server Operators
   • Debugger Users
   • EDI Subsystem Users
   • SSO Administrators
   • SSO Affiliate Administrators
6. Oluşturduğumuz bu grupların hepsine, log in olduğunuz kullanıcıyı ekleyin.
7. BizTalk 2006 kurulumu,

Farkındayım, gereksiz yere çok zorlaştırılmış bir kurulum. Microsofttan çift tıklama ile kurulabilen bir setup beklerdim

Evet başlık doğru Elinizde bulunan herhangi bir XSD şemasını kullanarak otomatik olarak .net sınıfı oluşturabilirsiniz.

Hatta bu yöntemle, sınıf tasarımlarınızı XML ile kolayca hazırlayabilirsiniz.

Aşağıda basit bir xml dosyası görebilirsiniz.

Şekildeki gibi basit bir XML dosyası hazırladıktan sonra, BizTalk 2006 da bulunan Schema Generatoru kullanarak XML dosyamızı otomatik olarak XSD schemasına dönüştürebiliriz. Tüm bunlarla uğraşmak istemiyorsanız ise XML veya generatoru kullanmadan, Boş bir XSD dosyası açarak istediğiniz schemayı manuel olarak oluşturabilirsiniz.

XML dosyasından XSD yi nasıl oluşturacağımıza gelince,

Aşağıdakinin aynısı yapılır,

Yukarıdaki yapıldıktan sonra ise aşağıdakinin aynısı yapılır,

Yukarıdaki yapıldıktan sonra ise aşağıdakinin aynısı yapılır,

Yukarıdaki yapıldıktan sonra ise aşağıdakinin aynısı yapılır,

Tüm işlemler yapıldıktan sonra üstteki gibi bir schema dosyamız oluşturulmul olacaktır. Daha sonra ise oluşturduğumuz bu XSD dosyasını kolaylık olması için C:\ dizinine kopyalayalım. Bu işlem command prompta yazılan komutun kısa ve kolay olmasını sağlayacaktır

Sonra “Visual Studio Command Prompt” çalıştırılır ve aşağıdaki komut yazılır.

XSD c:\kisiler.xsd /c /out:c:\

Bu komut işletildikten sonra “c:\kisiler.cs” aşağıdaki içerikle beraber oluşturulmuş olacaktır.

Kisiler.cs içeriği:

//——————————————————————————
// <auto-generated>
//     This code was generated by a tool.
//     Runtime Version:2.0.50727.42
//
//     Changes to this file may cause incorrect behavior and will be lost if
//     the code is regenerated.
// </auto-generated>
//——————————————————————————

using System.Xml.Serialization;

//
// This source code was auto-generated by xsd, Version=2.0.50727.42.
//

/// <remarks/>
[System.CodeDom.Compiler.GeneratedCodeAttribute("xsd", "2.0.50727.42")]
[System.SerializableAttribute()]
[System.Diagnostics.DebuggerStepThroughAttribute()]
[System.ComponentModel.DesignerCategoryAttribute("code")]
[System.Xml.Serialization.XmlTypeAttribute(AnonymousType=true)]
[System.Xml.Serialization.XmlRootAttribute(Namespace="", IsNullable=false)]
public partial class Kisiler {

private KisilerKisi kisiField;

/// <remarks/>
public KisilerKisi Kisi {
get {
return this.kisiField;
}
set {
this.kisiField = value;
}
}
}

/// <remarks/>
[System.CodeDom.Compiler.GeneratedCodeAttribute("xsd", "2.0.50727.42")]
[System.SerializableAttribute()]
[System.Diagnostics.DebuggerStepThroughAttribute()]
[System.ComponentModel.DesignerCategoryAttribute("code")]
[System.Xml.Serialization.XmlTypeAttribute(AnonymousType=true)]
public partial class KisilerKisi {

private string adField;

private string soyadField;

/// <remarks/>
public string Ad {
get {
return this.adField;
}
set {
this.adField = value;
}
}

/// <remarks/>
public string Soyad {
get {
return this.soyadField;
}
set {
this.soyadField = value;
}
}
}

Kisiler.XSD içeriği :

<?xml version=”1.0″ encoding=”utf-16″?>
<xs:schema attributeFormDefault=”unqualified” elementFormDefault=”qualified” xmlns:xs=”http://www.w3.org/2001/XMLSchema”>
<xs:element name=”Kisiler”>
<xs:complexType>
<xs:sequence>
<xs:element name=”Kisi”>
<xs:complexType>
<xs:sequence>
<xs:element name=”Ad” type=”xs:string” />
<xs:element name=”Soyad” type=”xs:string” />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

Görüldüğü gibi tüm sınıf içeriği çok basit bir şekilde otomatik olarak oluşturuldu. Bunu daha kompleks XML dosyaları veya XSD schemaları içinde yapabiliriz. Otomatik olarak oluşturulacak sınıfımız ona göre karmaşık olacaktır.