Interface IStaticAdapterConfig de l'adaptateur statique
Un adaptateur statique au moment de la conception doit implémenter l’interface IStaticAdapterConfig . Celle-ci lui permet de communiquer avec l'Assistant Ajouter les métadonnées de l'adaptateur et d'obtenir des organisations de service et des descriptions de service individuel à partir de l'adaptateur. L’Assistant appelle les méthodes GetServiceOrganization et GetServiceDescription pour extraire les informations de métadonnées avec lesquelles l’adaptateur interagit et les ajouter à un projet BizTalk dans Visual Studio.
La méthode GetServiceOrganization obtient un document XML instance qui représente la organization hiérarchique des services exposés de l’adaptateur. Cette structure génère l’arborescence organization de service que vous voyez dans la page Sélectionner les services à importer dans l’Assistant Ajout de métadonnées d’adaptateur.
Après avoir sélectionné les services à importer, l’Assistant appelle la méthode GetServiceDescription pour obtenir un tableau de fichiers WSDL (Web Services Description Language) correspondant aux catégories de service sélectionnées dans l’arborescence De l’Assistant Ajouter des métadonnées d’adaptateur. Les schémas représentant les services sont créés en tant que fichiers XSD et sont ajoutés à votre projet BizTalk une fois que vous avez terminé l'Assistant Ajouter les métadonnées de l'adaptateur.
Dans l’exemple d’adaptateur de fichier, les méthodes GetServiceOrganization et GetServiceDescription résident dans la classe StaticAdapterManagement dans le fichier de classe AdapterManagement.cs. L’Assistant appelle la méthode GetServiceOrganization pour obtenir l’arborescence à afficher dans la page Sélectionner les services à importer . Dans GetServicesOrganization , la valeur de retour codée en dur de AdapterManagement.CategorySchema.xml fichier est utilisée comme indiqué dans le fragment de code suivant. En tant que développeur d'adaptateur, vous devrez ajouter la logique pour renvoyer le fichier XML approprié.
public string GetServiceOrganization(IPropertyBag endPointConfiguration, string NodeIdentifier)
{
string result = GetResource("AdapterManagement.CategorySchema.xml");
return result;
}
Notes
Veillez à modifier la méthode GetServiceDescription de la classe StaticAdapterManagement , et non de la classe DynamicAdapterManagement , qui apparaît en premier dans le fichier.
Le code suivant provient de la méthode GetServiceDescription du fichier AdapterManagement.cs. Le fichier service1.wsdl est codé en dur en tant que fichier WSDL renvoyé. Il renvoie des schémas représentés en tant que fichiers WSDL. Le wsdls paramètre est un tableau de références WSDL uniques qui correspondent aux références WSDL dans le xml source chargé par GetServicesOrganization. Le jeu de descriptions WSDL retourné est utilisé pour générer les types de port et les types de messages pour le projet BizTalk. Si plusieurs types de schéma sont sélectionnables dans l'arborescence, plusieurs fichiers WSDL sont nécessaires. Si vous avez le choix entre plusieurs schémas et plusieurs fichiers WSDL, vous pouvez ajouter une consultation de base de données pour garantir le renvoi du fichier WSDL correct.
/// <summary>
/// Get the WSDL file name for the selected WSDL
/// </summary>
/// <param name="wsdls">place holder</param>
/// <returns>An empty string[]</returns>
public string[] GetServiceDescription(string[] wsdls)
{
string[] result = new string[1];
result[0] = GetResource("AdapterManagement.service1.wsdl");
return result;
}