Le modèle est un fichier à ajouter à votre projet. Il possède une extension edmx et est lié à un fichier cs (ou vb) dans lequel est généré le code. Ajoutez donc ce type de fichier à votre projet en le choisissant dans la liste sous la catégorie Data (Figure 1).

Figure 1

Un assistant se lance pour vous aider à paramétrer le modèle. Le premier écran vous propose de générer le modèle à partir d’une base de données ou de créer un modèle vide (Figure 2). Nous choisirons ici la première option.

Figure 2

Vient ensuite la configuration de la connexion à la base de données. Il s’agit de l’écran classique que l’on rencontre lorsque l’on configure une connexion (Figure 3). Vous devez donc sélectionner une connexion existante ou en créer une nouvelle en choisissant le serveur et la base de données. Cochez ou décochez la case permettant de conserver la connexion dans le fichier de configuration et cliquez sur le bouton Next.

Figure 3

Nous arrivons déjà à la dernière étape. L’écran vous affiche la liste des tables, vues et procédures stockées présentes dans la base de données choisie (Figure 4). Cochez les éléments que vous voulez inclure dans votre modèle Entity Framework. Deux autres options sont mises à disposition. La première vous permet de singulariser ou pluraliser les noms des entités et des tables de manière automatique. Qu’est-ce que cela signifie ? Prenons un exemple. Si vous avez une table People dans la base de données, l’EntitySet portera le nom People également. En revanche, le nom de la classe sera Person. On garde donc bien la logique de la programmation avec un nom singulier pour les classes et un nom pluriel pour les collections.

La seconde option vous propose simplement d’inclure les champs de clés étrangères dans votre modèle.

Figure 4

Une fois que tout est configure, cliquez sur le bouton Finish et attendez que la génération soit terminée.

Tout d’abord, il faut ouvrir le team explorer et vous connecter à la collection dans laquelle vous voulez créer un projet. Si vous ne savez pas comment faire, jetez un œil à mon article sur ce sujet : Connexion à Team Foundation Server

Une fois connecté, cliquez droit sur la collection et sélectionnez New Team Project (Figure 1)

Figure 1

L’assistant se lance afin de vous aider à configurer les bases du projet. Voyons ensemble les différentes étapes.

La première étape vous demande un nom pour votre projet et une description de celui-ci (Figure 2). Je pense qu’il n’est pas nécessaire de donner plus de détail sur cette étape J

Figure 2

On vous propose ensuite de choisir un process template, c’est-à-dire un modèle qui va définir la manière dont le projet doit s’organiser et évoluer. Le choix du template aura une influence sur les répertoires et les requêtes disponibles au départ du projet pour les work items, le reporting, les builds. Par défaut, deux templates sont déjà disponibles, à savoir des templates pour les méthodes Agile et CMMI (Figure 3). Mais un lien vous permet de télécharger d’autres templates si ceux-là ne vous conviennent pas. Il est également important de signaler que les templates sont en fait des fichiers xml et qu’il est donc possible de les personnaliser à votre sauce ou encore de créer vos propres templates.

Figure 3

Si la partie SharePoint de votre serveur TFS a été configurée, l’étape suivante consiste à préciser si vous voulez créer un portail pour votre projet ou pas (Figure 4). Si vous décidez d’en créer un, vous pouvez soit utiliser l’adresse proposée par défaut, soit la modifier vous-même en cliquant sur le bouton Configure.

Figure 4

La dernière étape configurable vous permet d’éventuellement créer votre projet à partir d’une branche existante dans votre source control (Figure 5). L’option par défaut crée simplement un nouveau répertoire dans le source control.

Figure 5

Vous accédez ensuite au récapitulatif de votre configuration (Figure 6). Cliquez sur le bouton Finish.

Figure 6

Attendez ensuite gentiment que le statut arrive au bout (Figure 7).

Figure 7

Vous arrivez enfin à la dernière étape confirmant la création de votre projet (Figure 8). Cliquez sur le bouton Close et le tour est joué.

Figure 8

Les classes partielles sont très utiles lorsque l’on veut répartir les méthodes d’une classe entre plusieurs développeurs, tout en évitant les risques engendrés par un merge lors d’un multiple check-out. La classe est donc divisée en plusieurs fichiers, chaque développeur ayant le sien. Imaginons par exemple une classe de requête dans laquelle nous séparons les selects, les inserts, les updates et les deletes. Nous voilons donc avec quatre fichiers mais une seule classe. Les classes partielles peuvent également être utilisées pour étendre une classe créée par un générateur de code, plutôt que de devoir hériter de celle-ci. Mais comment déclarer une classe partielle ? Pour cela, rien de plus simple : il suffit d’ajouter le mot clé partial dans la déclaration de la classe (Figure 1). Cette déclaration devra se retrouver dans chaque fichier qui fait partie de cette classe partielle.

Figure 1

Quant aux méthodes partielles, il est évident qu’il n’est pas envisageable de répartir leur implémentation à différents endroits. Une méthode partielle consiste à séparer sa déclaration de son implémentation, un peu comme quand on utilise une interface. L’utilité se réduit donc en grande partie aux méthodes créées par les générateurs de code. Ceux-ci déclarent la méthode (Figure 2) et les développeurs se chargent de l’implémenter (Figure 3).

Figure 2

Figure 3

Contrairement aux classes, les méthodes statiques sont soumises à certaines contraintes :

• Elles ne peuvent pas renvoyer de résultat
• Elles ne peuvent pas contenir de paramètre out
• Elles doivent être privées

• ALLOWEDVALUES : spécifie une liste de valeurs possibles pour le champ.
• ALLOWEXISTINGVALUE : indique que la valeur actuelle est autorisée.
• CANNOTLOSEVALUE : une fois que le champ reçoit une valeur, il ne peut plus être vidé.
• COPY : copie une valeur à partie d’un autre champ ou d’une valeur système.
• DEFAULT : indique une valeur par défaut à placer dans le champ.
• EMPTY : le champ est vidé et grisé.
• FROZEN : rend le champ non modifiable dès qu’on lui donne une valeur non nulle.
• MATCH : indique un format que la valeur doit respecter. Cette règle s’applique uniquement aux champs de type string. Les lettres A, N, X sont interprétées respectivement pour des caractères alphabétiques, numériques et alphanumériques. Tous les autres caractères sont traités comme de simples littéraux.
• NOTSAMEAS : indique que la valeur doit être différente de celle d’un autre champ.
• PROHIBITEDVALUES : spécifie une liste de valeurs interdites pour le champ.
• READONLY : le champ n’est pas modifiable et est grisé.
• REQUIRED : le champ est obligatoire.
• SERVERDEFAULT : remplit le champ avec la valeur donnée par le serveur au moment de la sauvegarde. Le champ apparaît en lecture seule.
• SUGGESTEDVALUES : spécifie une liste de valeurs recommandées mais sans interdire l’encodage d’autres valeurs.
• VALIDUSER : la valeur doit correspondre à un utilisateur valide.
• WHEN : spécifie une liste de règles à appliquer lorsqu’un champ possède la valeur indiquée
• WHENNOT : spécifie une liste de règles à appliquer lorsqu’un champ possède une valeur différente de la valeur indiquée.
• WHENCHANGED : spécifie une liste de règles à appliquer lorsqu’un champ change de valeur.
• WHENNOTCHANGED : spécifie une liste de règles à appliquer lorsqu’un champ ne change pas de valeur.

A first window opens up asking you to select a Team Foundation Server (Figure 2). If no server was configured before, then you will have to configure one by clicking the Servers button in the top right corner of the window. Otherwise you just have to choose the server from the list and check the collection and projects you want to connect to.

A second window opens up listing all configured Team Foundation Servers with their names and addresses (Figure 3). To configure a new server, click the Add button in the top right corner of the window.

Here comes the configuration window that will allow you to find your Team Foundation Server. As you can see in Figure 4, different parameters are available to find it. You can either enter the full URL or specify all parameters separately, that is the name, path, port number and protocol. When you are done, click the OK button. If the server cannot be found, then an error message will be displayed.

You now see that the newly configured server mapping has been added to the list of the previous window (Figure 5). Select it if it is not done yet and click the Close button.

You are now one step away from the end of the process. The server you have just configured now appears in the list. Once you select it, you will see the list of all Team Project Collections present on the server along with all their associated Team Projects (Figure 6). All you have to do is to select the collection you want to work on and, if you want to work with existing projects, you might want to select them too. When you are ready, click the Connect button. Congratulations! Your Visual Studio is now connected to a Team Foundation Server.

– Tout d’abord, veillez à sélectionner les procédures que vous voulez importer lorsque vous créez ou mettez à jour votre modèle à partir de la base de données :

– Une fois les procédures dans le SSDL, il suffit de les importer dans le CSDL. Pour cela, on peut passer directement par le designer :

– Vous pouvez vérifier dans le Model Browser que votre fonction a bien été créée :

Et le tour est joué. Il ne vous reste plus qu’à appeler cette fonction directement à partir de votre contexte pour en obtenir le résultat.

Petite remarque cependant, les Complex Types ne sont pas supportés dans le mapping de fonctions.

On peut considérer que les champs Firstname et Lastname sont très liés et pourraient être regroupés dans un champ Name. C’est ce que l’on appelle un Complex Type.

Autrefois, la création de Complex Types n’était pas supportée par l’Entity Model Designer, nous obligeant donc à passer par le mode XML dans lequel il est parfois difficile de s’y retrouver. Le problème est maintenant réglé avec la version 4.0.
Voyons tout de suite comment procéder en reprenant notre exemple :

Avant tout, il faut sélectionner les différents champs de l’entité qui formeront le Complex Type. Dans notre cas, il s’agit de Firstname et Lastname. Ensuite, dans le menu contextuel, nous pouvons trouver la nouvelle action permettant de regrouper nos champs :

Il ne reste plus qu’à renommer le Complex Type et le tour est joué. Le nouveau champ apparaît dans le Model Browser et les deux propriétés scalaires sont bien remplacées par le Complex Type dans l’entité :

Le mapping est également impacté comme on peut le voir ici :

Le Complex Type devient en fait une classe contenant nos deux propriétés d’origine. Lorsque l’on créera une nouvelle entité Person, il sera donc nécessaire de créer une instance de cette classe si l’on veut accéder aux valeurs des champs.
Pour terminer, voyons comment utiliser cette nouvelle propriété.

A savoir qu’il est tout à fait possible de donner des noms différents à la classe et à la propriété.

Si cette case n’a pas été cochée lors de la création de l’association, il est malgré tout toujours possible de marquer une propriété comme étant une clé étrangère. Pour cela, il suffit de double-cliquer sur l’association en mode design, ce qui fait apparaître la fenêtre suivante :

Il ne vous reste plus qu’à spécifier les tables et propriétés qui entrent en jeu dans cette relation.

Rendez-vous pour cela dans les propriétés de votre projet dans l’onglet « Build ». Tout en bas, la section « Output » contient un bouton « Advanced ».

Cliquez dessus pour ouvrir une nouvelle popup. Le paramètre qui nous intéresse est « Debug Info ». Celui-ci possède 3 options : none, pdb-only et full.

Choisissez « none » et sauvegardez vos modifications. Vous voilà débarrassé des fichiers PDB !