Esempi di schemi di configurazione personalizzati per gli adapter
In questa sezione vengono forniti gli esempi seguenti per illustrare come personalizzare gli schemi di configurazione per gli adapter.
L'esempio 1 mostra un file di schema XSD personalizzato completo che rappresenta una pagina delle proprietà dell'adapter usando le estensioni baf:designer e baf:description.
Nell'esempio 2 vengono usate anche le estensioni baf:designer e baf:description per illustrare come creare una finestra del valore della proprietà personalizzata per la proprietà BatchSize che accetta solo valori compresi tra 1 e 99 inclusi.
Nell'esempio 3 viene illustrato come limitare baf:Password a 8 caratteri. Per impostazione predefinita, sono consentiti 22 caratteri.
L'esempio 4 mostra come implementare vincoli di criteri di ricerca sui valori delle proprietà perché i modelli XSD non sono supportati.
Esempio 1
In questo esempio viene illustrato uno schema XSD personalizzato completo, che rappresenta una pagina delle proprietà di un adapter, utilizzando le estensioni baf:designer e baf:description.
<?xml version="1.0" encoding="utf-8" ?>
<xs:schema targetNamespace="http://tempuri.org/XMLSchema.xsd"
elementFormDefault="qualified" xmlns="http://tempuri.org/XMLSchema.xsd"
xmlns:baf="BiztalkAdapterFramework.xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
<xs:import namespace="BiztalkAdapterFramework.xsd" />
<xs:element name="Send">
<xs:complexType>
<xs:sequence>
<xs:element name="directory" type="xs:string" />
<xs:annotation>
<xs:appinfo>
<baf:designer>
<baf:description>Enter the directory that will receive sent files..
</baf:description>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element name="fileName" type="" />
<xs:element name="sendBatchSize" type="xs:int" />
<xs:element name="fileCopyMode" type="CopyMode" />
<xs:element name="uri" type="xs:string" >
<xs:annotation>
<xs:appinfo>
<baf:designer>
<baf:browsable show="false" />
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:simpleType name="CopyMode">
<xs:restriction base="xs:string">
<xs:enumeration value="Append">
<xs:annotation>
<xs:documentation>= 0</xs:documentation>
</xs:annotation>
<xs:enumeration value="Create">
<xs:annotation>
<xs:documentation>= 1</xs:documentation>
</xs:annotation>
<xs:enumeration value="CreateNew">
<xs:annotation>
<xs:documentation>= 2</xs:documentation>
</xs:annotation>
</xs:enumeration>
</xs:restriction>
</xs:simpleType>
</xs:schema>
Esempio 2
In questo esempio vengono usate le estensioni baf:designer e baf:description per illustrare come creare una finestra del valore della proprietà personalizzata per la proprietà BatchSize che accetta solo valori compresi tra 1 e 99 inclusi.
<xs:element name="BatchSize">
<xs:simpleType>
<xs:annotation>
<xs:appinfo>
<baf:designer>
<baf:displayname>Batch Size</baf:displayname>
<baf:description>Enter the batch size (1-99)</baf:description>
</baf:designer>
</xs:appinfo>
</xs:annotation>
<xs:restriction base="xs:int">
<xs:minInclusive value="1" />
<xs:maxInclusive value="99" />
</xs:restriction>
</xs:simpleType>
</xs:element>
Esempio 3
In questo esempio viene illustrato come limitare baf:Password a 8 caratteri. Per impostazione predefinita, sono consentiti 22 caratteri.
<xs:element name="AdapterPassword">
<xs:simpleType>
<xs:annotation>
<xs:appinfo>
<baf:designer>
<baf:displayname>Adapter Password</baf:displayname>
<baf:description>Enter the password (up to 8 characters)</baf:description>
<baf:editor assembly="%BTSROOT%\\Developer Tools\\Microsoft.BizTalk.Adapter.Framework.dll">Microsoft.BizTalk.Adapter.Framework.ComponentModel.PasswordUITypeEditor</baf:editor>
<baf:converter assembly="%BTSROOT%\\Developer Tools\\Microsoft.BizTalk.Adapter.Framework.dll">Microsoft.BizTalk.Adapter.Framework.ComponentModel.PasswordTypeConverter</baf:converter>
</baf:designer>
</xs:appinfo>
</xs:annotation>
<xs:restriction base="xs:string">
<xs:maxLength value="8" />
</xs:restriction>
</xs:simpleType>
</xs:element>
Esempio 4
In questo esempio viene illustrato come implementare vincoli dei criteri di ricerca sui valori delle proprietà nei casi in cui i modelli XSD non sono supportati.
I campi come ClientIdentifier sono sempre una stringa numerica a tre caratteri. Un valore di proprietà di 10 non è valido, mentre 010 è valido. Il frammento di schema di configurazione seguente definisce una proprietà ClientIdentifier . La classe ClientIdentifierConverter , implementata nell'assembly dell'adattatore, implementa la corrispondenza dei criteri. In questo caso, il convertitore di tipi personalizzato limita i valori a una stringa di tre cifre esatte (da 000 a 999). Nello schema di configurazione, assicurarsi che nel nodo baf:converter il nome completo di assembly e tipo sia impostato correttamente. Se l'utente tenta di immettere un valore non valido, viene visualizzato un messaggio di eccezione quando si verifica un errore di convalida nella pagina delle proprietà.
È possibile utilizzare il codice seguente negli schemi di configurazione delle pagine delle proprietà degli adapter.
<xs:element name="ClientIdentifier" type="xs:string">
<xs:annotation>
<xs:appinfo>
<baf:designer>
<baf:displayname>Adapter Client</baf:displayname>
<baf:description>Enter the Adapter Client (3 digit string)</baf:description>
<baf:converter assembly="%BTSROOT%\\Developer Tools\\Microsoft.BizTalk.TestAdapter.dll">Microsoft.BizTalk.TestAdapter.ClientIdentifierConverter</baf:converter>
</baf:designer>
</xs:appinfo>
</xs:annotation>
</xs:element>
È possibile inserire il codice seguente nell'assembly dell'adapter:
using System;
using System.ComponentModel;
using System.Globalization;
using System.Text.RegularExpressions;
namespace Microsoft.BizTalk.TestAdapter
{
/// <summary>
/// Summary description for ClientIdentifierConverter.
/// </summary>
public class ClientIdentifierConverter : System.ComponentModel.StringConverter
{
private void Validate(string value)
{
Regex regex = new Regex(@"^\d{3}$"); // ^=begin, \d=digit, {3}=exactly 3 occurrences, $=end
Match match = regex.Match((string)value);
if (!match.Success)
{
throw new ApplicationException("Value does not match pattern \"" + regex.ToString() + "\".");
}
}
public override object ConvertFrom(ITypeDescriptorContext context, CultureInfo culture, object value)
{
if (value is string)
{
this.Validate((string)value);
}
return base.ConvertFrom(context, culture, value);
}
public override object ConvertTo(ITypeDescriptorContext context, CultureInfo culture, object value, Type destinationType)
{
if (typeof(string) == destinationType && value is string)
{
this.Validate((string)value);
}
return base.ConvertTo(context, culture, value, destinationType);
}
}
}
Vedere anche
Estensioni dello schema di configurazione di Adapter Framework