Dans la partie précédente, nous avons créé les services et les workflows nécessaires à notre opération de recrutement. Durant cette partie, nous ferons le reste : les applications clientes.
Etape 7 : Création de l’application candidat
L’objectif de cette étape est de créer l’application « Candidat » qui permettra à un postulant de soumettre une candidature. Cette application sera également serveur puisqu’elle hébergera un service de notification.
- Ouvrez Visual Studio dans une nouvelle fenêtre en mode administrateur
- Créez une nouvelle application WPF et appelez-la « CandidatApp »
- Ouvrez « MainWindow » en mode design
- Supprimez la grille
- Glissez un « DockPanel » sur la fenêtre principale avec les propriétés « HorizontalAlignment » et « VerticalAlignment » à « Stretch », supprimez les propriétés « Height » et « Width ». « LastChildFill » doit être «True »
- Glissez un « Label » sur le « StackPanel » avec la propriété « Content » à « Nom : » et « Margin » à 3 et « DockPanel.Dock » à « Top »
- Glissez un « TextBox » avec la propriété « Name » à « txtNom » et « Margin » à 3 et « DockPanel.Dock » à « Top »
- Glissez un deuxième « Label » en dessous de la « TextBox » avec la propriété « Content » à « Date de naissance : » et « Margin » à 3 et « DockPanel.Dock » à « Top »
- Glissez un « DatePicker » en dessous du deuxième « Label » avec les propriétés « Name » à « dpDate », « Margin » à 3 et « DockPanel.Dock » à « Top »
- Ajoutez un bouton en dessous du « Picker » avec « Name », « Margin », « Content » à « btnSoumettre », 3 et « Soumettre »
- Glissez un « TextBox » en dessous du bouton avec la propriété « Name » à « txtConsole », « Margin » à 3, « AcceptReturn » à « True »
- Le code XAML de la fenêtre principale doit être comme ceci :
<Window x:Class="CandidatApp.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Title="MainWindow" Height="350" Width="525">
<DockPanel HorizontalAlignment="Stretch" VerticalAlignment="Stretch" LastChildFill="True" >
<Label Content="Nom :" Margin="3" DockPanel.Dock="Top"/>
<TextBox Name="txtNom" Margin="3" DockPanel.Dock="Top"/>
<Label Content="Date de Naissance :" Margin="3" DockPanel.Dock="Top"/>
<DatePicker Name="dpDate" Margin="3" DockPanel.Dock="Top"/>
<Button Content="Soumettre" DockPanel.Dock="Top" Margin="3" Name="btnSoumettre"/>
<TextBox Name="txtConsole" Margin="3" AcceptsReturn="True" TextWrapping="Wrap" VerticalAlignment="Stretch"/>
</DockPanel>
</Window>
- Lancez la boîte de dialogue d’ajout de nouvel élément (au projet CandidatApp) à partir de l’explorateur de solutions
- Dans la zone de recherche, tapez « WCF »
- Sélectionnez « Service WCF »
- Dans la zone « Nom », entrez « NotificationService »
- Remarquez que VS crée une interface appelée « INotificationService » et son implémentation « NotificationService
- Ouvrez le fichier « INotificationService.cs »
- Supprimez la déclaration de méthode « DoWork »
- Ajoutez une méthode de type « void » appelée « Notifier » et qui a deux paramètres « Nom » et « Acceptation » de type « String » et « Boolean »
- Décorez la méthode par l’attribut « OperationContract » pour la rendre comme service
- Le listing de l’interface INotificationService devrait être comme ceci :
[ServiceContract]
public interface INotificationService
{ [OperationContract]
void Notifier(string Nom, bool Acceptation);
}
- Ouvrez le fichiez « NotificationService.cs »
- Supprimez le code de « DoWork »
- Implémentez la méthode « Notifier » comme ceci :
public void Notifier(string Nom, bool Acceptation)
{ string etat;
if (Acceptation)
etat = "accepté";
else
etat = "rejeté";
Console.WriteLine("Le candidat {0} a été {1} ", Nom, etat);
}
Compilez l’application.
- Ajoutez au projet la classe « TextBoxTextWriter » créé lors des tutoriaux précédents pour rediriger les sorties de la console sur la « TextBox » txtConsole
- Ouvrez « MainWindow.xaml.cs »
- Ajoutez un using sur l’esapce de nom de la classe « TextBoxTextWriter »
- Ajoutez un using sur « System.ServiceModel »
- Ajoutez un évènement de chargement « Loaded » sur le « DockPanel »
- Redirigez la sortie de la console
// rediriger la sortie de la console
Console.SetOut(new TextBoxTextWriter(txtConsole));
- Créez ensuite le hôte qui permettra d’herbeger le service WCF comme ceci :
// créer le hote wcf
var host = new ServiceHost(typeof(NotificationService));
// lancer le hote wcf
host.Open();
Console.WriteLine("service de notification démarré");
- Nous allons enfin affectez une valeur par défaut à la date de naissance qui est de 20 ans avant aujourd’hui
// date par défaut
dpDate.SelectedDate = DateTime.Now.AddYears(-20);
- Le listing complet de la méthode devrait être comme ceci :
private void DockPanel_Loaded(object sender, RoutedEventArgs e)
{ // rediriger la sortie de la console
Console.SetOut(new TextBoxTextWriter(txtConsole));
// créer le hote wcf
var host = new ServiceHost(typeof(NotificationService));
// lancer le hote wcf
host.Open();
Console.WriteLine("service de notification démarré"); // date par défaut
dpDate.SelectedDate = DateTime.Now.AddYears(-20);
}
- Ouvrez le fichier « App.Config »
- Changez la propriété « baseAddress » de l’hôte à http://localhost:7766/Notification
- Le listing de « App.Config » devrait être comme ceci :
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
</startup>
<system.serviceModel>
<behaviors>
<serviceBehaviors>
<behavior>
<serviceMetadata httpGetEnabled="true" httpsGetEnabled="true" />
<serviceDebug includeExceptionDetailInFaults="false" />
</behavior>
</serviceBehaviors>
</behaviors>
<services>
<service name="CandidatApp.NotificationService">
<endpoint address="" binding="basicHttpBinding" contract="CandidatApp.INotificationService">
<identity>
<dns value="localhost" />
</identity>
</endpoint>
<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange" />
<host>
<baseAddresses>
<add baseAddress="http://localhost:7766/Notification" />
</baseAddresses>
</host>
</service>
</services>
</system.serviceModel>
</configuration>
- Lancez l’application pour tester le service
- Appelez la méthode « Notifier » à partir du testeur « WCF »
- Remarquez que les messages de notifications sortent sur la console
Etape 8 : Création du proxy vers le workflow
Dans l’étape précédente, nous avons créé le serveur de notification qui permettra au workflow de notifier le candidat. Dans cette étape, nous allons nous connecter au service du workflow pour pouvoir soumettre le dossier du candidat.
- Revenez sur la fenêtre VS qui contient le projet « Tutoriel51 »
- Lancez l’application « WorkflowConsoleHost »
- Revenez sur le projet « CandidatApp »
- Dans l’explorateur de solutions, cliquez sur le bouton droit sur les références puis sur « ajouter une référence de service »
- Dans la zone « Adresse », entrez http://localhost:9988/EmbaucheSimple
- Cliquez sur « Go »
- Dans l’espace de noms, entrez « FormationWF »
- Dans les services, sélectionnez « EmbaucheSimpleService » puis « IEmbaucheService »
- Cliquez sur « OK »
- Ouvrez « MainWndow » en mode design
- Affectez un évènement « Click » au bouton
- Créons les informations à transmettre à partir du formulaire
// créer les informations
var info = new FormationWF.CandidatInfo()
{ Nom = txtNom.Text,
DateNaissance = dpDate.SelectedDate.Value
};
- Créons ensuite le proxy qui nous permettra de nous connecter au serveur
// créer le proxy
var client = new FormationWF.EmbaucheServiceClient();
- Nous allons ensuite créer les données à transmettre au serveur
// données à transmettre
var data = new FormationWF.RecevoirCandidature();
data.pInfo = new FormationWF.CandidatInfo()
{ Nom = txtNom.Text,
DateNaissance = dpDate.SelectedDate.Value
};
- Ensuite nous allons appeler le service et récupérer le résultat
// appel du service
var res = client.RecevoirCandidature(data);
if (res.HasValue && !res.Value)
Console.WriteLine("Candidature automatiquement rejetée");
- Le listing complet du gestionnaire de clic est comme suit :
private void btnSoumettre_Click(object sender, RoutedEventArgs e)
{ // créer les informations
var info = new FormationWF.CandidatInfo()
{ Nom = txtNom.Text,
DateNaissance = dpDate.SelectedDate.Value
};
// créer le proxy
var client = new FormationWF.EmbaucheServiceClient();
// données à transmettre
var data = new FormationWF.RecevoirCandidature();
data.pInfo = new FormationWF.CandidatInfo()
{ Nom = txtNom.Text,
DateNaissance = dpDate.SelectedDate.Value
};
// appel du service
var res = client.RecevoirCandidature(data);
// afficher résultat si rejet auto
if (res.HasValue && !res.Value)
Console.WriteLine("Candidature automatiquement rejetée");
}
- Exécutez l’application puis remarquez comment des candidatures de moins de 30 ans sont automatiquement rejetées
Etape 9 : Création de l’application de l’évaluateur
L’objectif de cette étape est de créer une application qui va être utilisée par l’évaluateur pour évaluer les candidatures.
- Ouvrez Visual Studio dans une nouvelle fenêtre
- Créez une nouvelle application WPF et appelez-la « EvaluateurApp »
- Ouvrez « MainWindow » en mode design
- Supprimez la grille
- Glissez un « StackPanel » sur la fenêtre principale avec les propriétés « HorizontalAlignment » et « VerticalAlignment » à « Stretch », supprimez les propriétés « Height » et « Width ».
- Glissez un « Label » sur le « StackPanel » avec la propriété « Content » à « Nom : » et « Margin » à 3
- Glissez un « TextBox » avec la propriété « Name » à « txtNom » et « Margin » à 3
- Glissez un deuxième « Label » en dessous de la « TextBox » avec la propriété « Content » à « Note : » et « Margin » à 3
- Glissez une « ComboBox » en dessous du deuxième « Label » avec les propriétés « Name » à « cbNote », « Margin » à 3. La combobox contient 5 notes de 1 à 5 et la propriété « SelectedIndex » à 0
- Ajoutez un bouton en dessous du « ComboBox » avec « Name », « Margin », « Content » à « btnEvaluer », 3 et « Evaluer »
- Le XAML de la fenêtre devrait être comme ceci :
<Window x:Class="EvaluateurApp.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Title="MainWindow" Height="350" Width="525">
<Grid>
<StackPanel>
<Label Content="Nom :" Margin="3"/>
<TextBox TextWrapping="Wrap" Name="txtNom" Margin="3"/>
<Label Content="Note :" Margin="3"/>
<ComboBox Name="cbNote" Margin="3" SelectedIndex="0">
<ListBoxItem Content="1"/>
<ListBoxItem Content="2"/>
<ListBoxItem Content="3"/>
<ListBoxItem Content="4"/>
<ListBoxItem Content="5"/>
</ComboBox>
<Button Content="Evaluer" Name="btnEvaluer"/>
</StackPanel>
</Grid>
</Window>
- Dans l’explorateur de solutions, cliquez sur le bouton droit sur les références puis sur « ajouter une référence de service »
- Dans la zone « Adresse », entrez http://localhost:9988/EmbaucheSimple
- Cliquez sur « Go »
- Dans l’espace de noms, entrez « FormationWF »
- Dans les services, sélectionnez « EmbaucheSimpleService » puis « IEmbaucheService »
- Cliquez sur « OK »
- Ajoutez un gestionnaire de clic au bouton « Evaluer » qui permet d’appeler la méthode « Evaluer » du service
private void btnEvaluer_Click(object sender, RoutedEventArgs e)
{ // créer le proxy
var proxy = new FormationWF.EmbaucheServiceClient();
// appeler le service
proxy.Evaluer(txtNom.Text, cbNote.SelectedIndex + 1);
}
- Compilez l’application pour vérifier d’éventuelles erreurs.
Etape 10 : Finalisation du workflow
L’objectif de cette étape est de finaliser le workflow de façon à ce qu’après l’évaluation, il envoie une notification au candidat.
- Revenez à la solution « Tutoriel51 »
- Si l’application console est en exécution, quittez-la
- Glissez une activité « Send » au workflow
- Connectez le dernier « Assign » avec l’activité « Send »
- Connectez le nouveau « Send » avec le côté « False » de l’activité de décision
- Dans la zone « OperationName », entrez « Notifier »
- Cliquez sur le bouton « Contenu »
- Ajoutez un paramètre appelé « Nom » de type « String » et dont la valeur est « info .Nom »
- Ajoutez un deuxième paramètre appelée « Acceptation », de type « Boolean » et dont la valeur est « Resultat »
- Cliquez sur « OK »
- Dans la propriété « EndPoint.AddressUri » de l’activité « Send », entrez http://localhost:7766/Notification. C’est l’adresse du service de notification.
- Dans la propriété « EndPoint.Binding », de l’activité « Send », sélectionnez « basicHttpBinding »
- Dans la propriété « ServiceContractName » entrez « INotificationService »
- Le workflow devrait être comme ceci :
Etape 11 : Mise en place de la corrélation
Le workflow dans l’étape précédente est fonctionnel mais il reste un problème : lorsque l'âge du candidat dépasse 30 ans, l’évaluateur doit lui donner une note. Le problème est qu’un instant donné, plusieurs instances peuvent s’exécuter en parallèle. Lorsqu’un évaluateur donne une note, on doit affecter cette note au bon candidat. La solution pour trouver la bonne instance du workflow est la corrélation. Nous établirons une corrélation sur le nom du candidat.
- Ouvrez le workflow « EmbaucheSimpleService.xamlx » en mode design
- Remarquez que notre workflow contient deux activités « Receive ». Pour assurer une cohérence d’exécution, nous relierons les deux « Receive » par une corrélation. Le premier « Receive » doit initialiser une corrélation tandis que le deuxième doit s’appliquer à cette corrélation.
- Cliquez sur l’activité organigramme (FlowChart) parente
- Examinez les variables
- Remarquez la présence d’une variable appelée « __handle » de type « CorrlationHandle »
- Si cette variable n’existe pas, créez-la
- Changez la portée de la variable (Scope) pour qu’elle soit sur tout l’organigramme
- Renommez cette variable en « dossier »
- Double-cliquez sur la première séquence du workflow
- Cliquez sur la propriété « CorrelationInitializers » de l’activité « Receive » de la séquence
- Dans la zone « Add initializer », entrez « dossier »
- Dans la liste déroulante au dessus de la grille « XPath Queries », sélectionnez « Query Correlation Initializer »
- Dans la grille, dans la colonne « Query », sélectionnez la propriété « Nom » du paramètre « pInfo »
- Remarquez que VS génère automatiquement le chemin « XPath » relatif à la propriété
- Laissez la colonne « Key » à « Key1 »
- Cliquez sur « OK »
- Nous allons maintenant corréler la deuxième activité « Receive » avec la première
- Dans la deuxième activité « Receive » (Recevoir Evaluation), cliquez sur le bouton de la propriété « CorrelateOn »
- Dans la zone « Correlates With », entrez « dossier »
- Dans la « XPath Queries », sélectionnez le paramètre « Nom ». Remarquez que le chemin « XPath » est automatiquement généré.
- Ce que nous avons fait c’est que nous utilierons le paramètre « Nom » fourni par l’évaluateur pour trouver la bonne instance du workflow.
- Cliquez sur « OK »
- Le workflow est maintenant prêt.
- Compilez pour vérifier l’absence d’erreurs.
Etape 12 : Exécution et Tests
L’objectif de cette étape est de tester nos services. Nous validerons les trois cas de figures :
- Si le candidat a moins de 30 ans, sa candidature est automatiquement rejetée. Il reçoit immédiatement une notification.
- Si le candidat a plus de 30 ans, l’évaluateur doit l’évaluer. Lorsque l’évaluateur lui attribue une note supérieure ou égale à 3, il est accepté, sinon il est rejeté.
Procédure :
- Lancez les trois applications
- Dans l’application « CandidatApp », entrez « Kamel » dans le nom et « 01/05/1986 » dans la date de naissance
- Cliquez sur « Soumettre »
- Remarquez que « Kamel » a été automatiquement rejeté
- Créez deux candidatures pour « Yazid » et pour « Racha » nés respectivement le « 25/03/1971 » et « 26/08/1978 »
- Remarquez que les candidatures n’ont pas été automatiquement rejetées
- Allez sur l’application « EvaluateurApp »
- Dans la zone « Nom » entrez « Racha » et sélectionnez « 4 » dans la note puis cliquez sur « Evaluer »
- Revenez à l’application « CandidatApp », remarquez qu’une notification indiquant que « Racha » a été acceptée. La corrélation a fait qu’on trouve le bon « Workflow » malgré que « Racha » a un dossier ultérieur à celui de « Yazid »
- Revenez à l’application « EvaluateurApp »
- Dans la zone « Nom » entrez « Yazid », dans la zone « Note » entrez « 2 » puis cliquez sur le bouton « Evaluer »
- Revenez sur l’application « CandidatApp »
- Remarquez une notification stipulant que « Yazid » a été rejetée
Le code source complet des applications de ce tutoriel est accessible ici.
Enjoy !