Xavier VANNESTE : Billets http://blog.xvanneste.com/Lists/Billets/AllPosts.aspx Flux RSS pour la liste Billets. Sat, 19 May 2012 13:40:10 GMT Générateur RSS Microsoft SharePoint Foundation 60 fr-FR Xavier VANNESTE : Billets http://blog.xvanneste.com/_layouts/images/siteIcon.png http://blog.xvanneste.com/Lists/Billets/AllPosts.aspx [Divers] Ma vision du moteur de recherche en entreprise http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=81 Corps:

Le moteur de recherche dans l'entreprise

Avant tout il y a le contenu, c'est par lui que tout commence. Telle une infection dans le système d'information, il se multiplie, s'étale, envahie toutes les parties du système. Puis il s'incruste, se déplace et quand on pense qu'il a disparu on s'aperçoit qu'il ne meurt jamais. Très vite les utilisateurs sont atteints d'une maladie : la « fouillonite » aigue. Ils fouillent, inlassablement, continuellement, mais ne trouvent pas ou peu ce qu'ils cherchent. Et ce temps passé à fouiller et parcourir le dédale des répertoires est une perte colossale pour l'entreprise, un gâchis. Tant bien même que le sésame est enfin repéré, l'utilisateur n'a pas la certitude d'avoir la dernière version de ce contenu. Pour palier cette aberration il existe des outils : « les moteurs de recherche ».
Cet article a pour but de dresser un état des lieux de l'utilisation du moteur de recherche en Entreprise, mais aussi ma vision pour le futur de celui-ci. (Même si certains aspects ne sont pas si futuristes qu'on pourrait le croire).
Nous verrons dans un premier temps l'historique de la gestion de l'information, avec trois étapes importantes, avant l'informatique, au début avec les répertoires partagés et maintenant avec la GED, enfin nous verrons l'utilité d'un moteur de recherche et son futur possible.
 

L'historique de la gestion de l'information

Il y a 30 ans, avant la démocratisation de l'informatique (limite avant l'informatique), la gestion de l'information est déjà un casse-tête pour les Entreprises. L'information est mise sur des documents papier et le rangement de ceux-ci consiste à les classer dans des pochettes cartonnées. Ces pochettes cartonnées étant à leur tour classées dans des casiers. Lors de l'archivage on déplace des casiers (ou du moins leur contenu) dans une autre salle: la salle des archives.
S'y retrouver et retrouver l'information est un travail à part entière : celui de l'archiviste.
 
La communication et l'échange de document passe par des tubes pneumatiques ou des coursiers et permet d'échanger des informations rapidement au sein de la société.
 
Il y a 15 ans, dans les années 90, avec la démocratisation de l'informatique, le document papier fait lentement place au document électronique et le système d'information de l'entreprise est souvent basé sur un répertoire partagé où se trouve l'ensemble de l'information. La masse de document est, à l'époque, limitée par les capacités techniques. En effet il y a 15 ans le coût de stockage était sans commune mesure avec ce qu'il est aujourd'hui.
 
Le document électronique, frère jumeau du document papier, hérite des mêmes caractéristiques génétiques, il est non structuré, souvent mal organisé, et prend vite beaucoup de place. Son classement représente le même casse-tête que celui de son frère. On le place dans des fiches cartonnées virtuelles (qu'on appelle dossier) elles-mêmes classées dans un casier (qu'on appelle disque dur) qui lui-même est entreposé dans un bâtiment (qu'on appelle serveur). La différence majeure entre ces deux frères jumeaux se situe dans l'espace qu'ils occupent... Néanmoins la situation en termes de rangement reste la même qu'avec le document papier, ceci afin de reproduire ce que connaît l'utilisateur pour son confort.
 
Avec l'émergence d'internet dans les années 90 et l'utilisation croissante des emails, l'échange d'information va prendre une autre forme
 
Aujourd'hui, tout s'est accéléré, la quantité de documents électroniques stockée croisse de manière exponentielle. Avec les lois sur l'archivage électronique légal, l'avènement des nouveaux médias comme le son ou la vidéo , ainsi que les réseaux sociaux, il n'y a jamais eu autant d'informations stockées.
Le coût du stockage étant si faible que le gâchis d'espace disque n'est plus source de culpabilité, ouvrant ainsi la voie à une forte redondance de l'information.
Mon premier ordinateur, en 1996, possédait 1,6 Go d'espace disque, chaque journée s'apparentait à une bataille pour ne pas remplir ce disque. Aujourd'hui, mon ordinateur possède 465 Go, et la bataille consisterait plutôt à réussir à le remplir.
Dans les Entreprises on assiste au même scénario ; la profusion de documents et la duplication de ceux-ci sont immenses et ne cessent de croître. Le problème qui se pose désormais n'est plus de stocker l'information mais plutôt de la retrouver et surtout la dernière version valide de celle-ci.
Combien de fois n'est-il pas arrivé à un utilisateur de passer un temps monumental à rechercher un document, pour au final renoncer à le chercher en sollicitant son auteur s'il a la chance de le connaître, afin que celui-ci lui envoi ?
Moralité on stocke cette énième copie à un autre endroit, rendant ainsi le système d'information encore plus nébuleux.
Prenons un exemple, si j'envoie un document à 5 personnes pour validation. J'envoie le document qui est dans le répertoire « Mes documents », ce même document se trouve dans ma boite d'envoi, il arrive dans les 5 boites de réception de mes collègues, qui le stockent eux même dans le répertoire « Mes documents », puis me le renvoient validé, il se retrouve donc à nouveau dans 5 boites d'envoi avant d'arriver dans ma boite de réception en 5 exemplaires, pour le fusionner je copie les 5 documents dans le répertoire « Mes documents » et en sort un nouveau.
Récapitulons :
1 document original dans « mes documents »
1 document dans ma boite d'envoi
5 documents dans les boites de réception de mes collègues
5 documents dans « mes documents » sur l'ordinateur de mes collègues
5 documents dans leur boite d'envoi
5 documents dans ma boite de réception
5 documents dans « mes documents »
1 document fusionné
 
Soit 28 exemplaires du même document. Dans trois semaines, si vous le recherchez lequel prendrez-vous ?
Alors on invente des solutions, les GED qui imitent lamentablement le système de classement par répertoire et ne font que déplacer le problème.
Cependant ils offrent les avantages de :
  • s'échanger des liens plutôt que du document directement
  • La taxonomie qui permet à un même document d'être catégorisé dans plusieurs « répertoires » qu'on appelle tags, si cela est respecté par les personnes utilisant la GED
  • La folksonomie qui permet à n'importe qui de créer ses propres tags n'importe comment et on se retrouve avec des tags comme (SharePoint, CherePoint, SharePont) bref tout ce qui peut exister comme faute de frappe et notation phonétique.
Ensuite certains outils sont très mal utilisés. Combien de fois j'ai vu une migration répertoire partagé vers SharePoint qui consistait en un gros copier-coller, et l'utilisateur de dire avec une pointe d'ironie « je ne comprends pas car je suis toujours aussi perdu alors qu'on a payé cher pour un nouvel outil ».
En fait, depuis 30 ans, peu de choses ont réellement changées.
 
Bien entendu les traits sont volontairement grossis et tout n'est pas si noir.
Ce qui fait peur c'est qu'une des causes de l'explosion du contenu sur internet est le Social Networking, Social Networking qui arrive à grand pas dans les entreprises. La profusion de contenu et d'information sera donc logarithmique dans les entreprises déployant un RSE (Réseau social d'Entreprise).

Le paradoxe privé/professionnel

Dans l'entreprise il devient donc très difficile de trouver des informations et surtout d'obtenir les dernières informations à jours.
La confiance des utilisateurs est souvent mise à rudes épreuves lorsqu'ils ne trouvent pas d'information somme toute nécessaire.
Pire la plupart du temps l'information est dispersée dans différentes applications (document stocké dans un répertoire partagé, information client dans le CRM, sans compter la GED, l'ERP, le mail).
Dans le meilleur des cas, ces applications proviennent du même éditeur et peuvent donc communiquer et s'intégrer facilement l'une avec l'autre. Mais dans la réalité, le choix des applications est fonction des choix qui ont été fait à l'époque du déploiement, et des affinités, pour ne pas dire intérêt, à travailler avec tel ou tel éditeur, si bien qu'au final les applications ne sont pas du tout intégrables et les consultants/développeurs montent des rustines d'interopérabilité et d'ingéniosité dans tous les sens.
Si bien que dans l'entreprise, en tant que collaborateur, on cherche, on passe notre temps à chercher et à demander après l'information aux différentes personnes de la société. Différentes études montrent qu'un collaborateur perd jusqu'à 8 heures par semaine à chercher l'information dans l'entreprise :
 
Mais en tant qu'internaute comment fait-on pour trouver une information ? Comment fait-on lorsqu'on veut trouver un article qui parle des centrales nucléaires, des tremblements de terre ou encore de la famine en Afrique ? On se rend simplement sur Google ou Bing.  Pire de plus en plus de personnes tapent directement l'adresse qu'elles recherchent (ou souhaitent consulter) dans le moteur de recherche. Les favoris ne sont presque plus utilisés. Le schéma ci-dessous montre bien l'explosion du nombre de requêtes :
 
Comme on peut le voir si l'utilisateur a à sa disposition plus d'une zone de saisie il a alors l'impression d'être noyé dans l'information voire d'être agressé (je viens de penser à certain intranet ou certains content manager s'obstinent à tout mettre sur la première page noyant l'utilisateur sous le flux d'information).
On en arrive au paradoxe suivant : il est plus simple de trouver des informations sur internet, un système générique par définition puisqu'il se doit de convenir à tout le monde mais surtout plus vaste et encore moins structuré que le système d'information de l'entreprise.
Maison :
 
Entreprise :
 
La raison de ce paradoxe est simple : sur internet il existe ce que l'on appelle des moteurs de recherche qui permettent de trouver l'information. Ces moteurs de recherche indexent nuit et jour le contenu de n'importe quel site et, de plus en plus, de n'importe quel format de fichier (HTML, PDF, WORD, POWERPOINT…..). Ces moteurs de recherche travaillent sur des algorithmes de pertinence ce qui permet à l'utilisateur d'obtenir ce qu'il recherche en fonction d'un mot clé en haut du résultat de recherche. Afin de rendre l'expérience utilisateur meilleure, notamment pour les fonctions de filtre, les moteurs de recherche modernes s'équipent en barres d'affinage.
Google 24/07/2011 :
 
Bing 24/07/2011 :
 
En entreprise, jusqu'à il y a peu, on en était loin. Les entreprises qui déploient un moteur de recherche sont rares. De plus, la plupart des moteurs de recherche ne sont pas réellement adaptés à l'entreprise, ou juste à un métier particulier.

Le moteur de recherche dans l'entreprise

On le voit de VRAIES solutions existent sur internet et peuvent être adaptée à l'entreprise. Bien entendu beaucoup de personnes me rétorqueront « j'ai un moteur de recherche dans ma GED » la réponse sera rapide « Oui mais si elles ne cherchent que ce qui est stocké dans votre GED alors jetezle !».
En entreprise le gros avantage réside en la maitrise plus ou moins poussée du système d'information mais surtout celle du Métier de l'entreprise. En effet, prenons le terme Fond, dans une banque il représente un placement financier, dans une fabrique de meuble au contraire il représentera une pièce de meuble. Le moteur de recherche peut entièrement être adapté à l'entreprise et personnalisé en fonction de son métier et de ses termes inhérents. On peut donc avoir des règles différentes pour le mot Fond de notre banque et le mot Fond de notre fabricant de meubles.
Vu l'hétérogénéité des types de fichiers dans l'entreprise, le moteur de recherche en entreprise doit connaitre un maximum de format, l'idéal étant l'ensemble des formats utilisés par l'entreprise.
A l'heure de la mondialisation, l'internationalisation du système d'information se généralise, le moteur de recherche doit donc aussi reconnaitre les langues utilisées au sein de l'entreprise, par exemple le mot « CAR » :
-en anglais cela signifie une voiture ce qui peut être très utile chez un constructeur de voiture
-en français il doit être considéré comme un stop Word et ne pas être pris en compte.
Le moteur de recherche d'entreprise doit aussi s'adapter à son utilisateur et à sa fonction ou son rôle dans l'entreprise. En effet un commercial n'a pas du tout besoin du même résultat sur la recherche « SharePoint » qu'un technicien ou un développeur, si la recherche s'adapte à l'utilisateur cela est un plus.
La recherche doit aussi pouvoir être filtrée et permettre d'être triée simplement. Cela doit pouvoir être personnalisé. Trié la recherche par la date de création, au lieu de la pertinence, permet par exemple d'effectué la recherche sur les derniers documents créé.
La recherche dans l'entreprise doit aussi prendre en compte TOUT le système d'information de l'entreprise et pas uniquement les logiciels de l'éditeur du moteur de recherche. Ainsi si l'entreprise possède un Filenet, Documentum, un répertoire partagé, ou encore SharePoint, alors une recherche sur un mot clé devra retourner tout ce qui se trouve dans tous les conteneurs d'informations, et si les mails sont indexés aussi, on atteint le paradis.
La fédération est aussi très importante ; à l'heure des réseaux sociaux interconnectés entre eux, il est inconcevable d'avoir des moteurs de recherche qui recherchent sans s'appuyer sur d'autres. Si une recherche est infructueuse dans le système d'information de l'entreprise, le moteur de recherche se doit d'afficher automatiquement le résultant de la même recherche dans d'autre moteur comme Bing ou Google :
 
SharePoint et Bing fédération.
La recherche peut aussi être fusionnée directement dans la recherche du poste utilisateur. Ainsi dans son poste utilisateur, en faisant une recherche sur un terme précis, l'utilisateur peut avoir l'ensemble du résultat, en fédérant les mails, le système d'information de l'entreprise et son poste local :
 
 
L'affichage en miniature de ce que l'on recherche est aussi un plus : sans les miniatures, on télécharge, on ouvre le document, on se rend compte que ce n'est pas le bon, on le referme et le détruit en local avant d'en télécharger un autre dans le moteur de recherche. Avec les miniatures on dispos d'un aperçu sur celui-ci, ( http://thumbextsp.codeplex.com/ ) le moteur Google l'a très bien compris :
 
Cependant, les moteurs de recherche comme il y a sur internet ne sont pas du tout adaptés à l'entreprise, mais à internet. Le cycle de vie et de mise à jour du contenu sur internet n'est pas le même qu'en entreprise. Ainsi il est peut être acceptable qu'un blog voyant le jour en janvier n'apparaisse dans le moteur de recherche qu'en juin. Maintenant imaginez la même chose avec la note de service de votre patron !!! Vous comprenez ce que je veux dire...
De plus, les moteurs de recherche sur internet sont basés sur le contenu, comme beaucoup de moteurs de recherche vendus en entreprise. Ainsi la recherche sur le mot-clé « Molière » remonte 8 830 000 résultats dans Google alors que la recherche sur « Jean Baptiste Poquelin » remonte elle 495 000 résultats malgré le fait que ce soit la même personne. Cela est dû au fait que l'on parle plus souvent de Jean Baptiste Poquelin par l'alias Molière et donc, comme Google est basé sur le contenu, il ne fait pas la relation entre les deux.
Le moteur de recherche en entreprise doit être plus intelligent et avoir la possibilité « d'apprendre » à utiliser les informations dans l'entreprise, c'est ici qu'intervient la notion de web sémantique.

L'avenir du moteur de recherche

La recherche sémantique ou web 3.0

Définition de Wikipédia :
 
Le Web sémantique désigne un ensemble de technologies visant à rendre le contenu des ressources du World Wide Web accessible 
et utilisable par les programmes et agents logiciels, grâce à un système de métadonnées formelles, 
utilisant notamment la famille de langages développés par le W3C.
 
 
Actuellement il y a encore du travail. Cependant il y a des avancés évidentes. Certains moteurs de recherche permettent d'extraire dans « un espace fermé comme celui de l'entreprise » les dites métadonnées.
Un exemple, au Luxembourg les banques anonymisent de plus en plus les documents, ainsi dans beaucoup de documents clients, le nom du client n'est pas mentionné mais plutôt sa référence.
Un moteur de recherche, comme les moteurs de recherche d'internet, se base sur le contenu du document. Ainsi les documents du client John Doe ne contenant pas les mots « John Doe » car anonymisés, mais contenant la référence « 1234 » ne seront pas remontés par le moteur de recherche en cas de recherche sur les mots clé « John Doe », il faudrait effectuer à la place une recherche par la référence du client pour obtenir le résultat désiré, un peu comme avec Molière et Jean Baptiste Poquelin.
Un moteur de recherche intelligent et sémantique, identifiera la référence « 1234 » et interrogera une base de données clients effectuant le mapping entre le client et sa référence. Ainsi la recherche John Doe remontera les documents contenant John Doe mais aussi la référence « 1234 ».
Recherche basée sur le contenu
 
Recherche avec extraction d'informations dans une source de données
 
Cette intégration complète dans le système d'information permet d'avoir une transparence pour l'utilisateur. En effet, pour lui, peu importe que l'information soit dans le dernier SQL Server, dans la meilleur GED du monde ou dans le dernier portail collaboratif. Ce qu'il désire est accéder à l'information et de manière aussi simple que sur internet.
Prenons un autre exemple :
Une liste de documents qui parlent de fond dans une banque.
Si vous avez la liste des fonds et le nom des administrateurs des fonds vous pouvez « enseigner » à votre moteur de recherche le nom de ces fonds et des administrateurs, voire le lien entre chacun d'eux. Ainsi si le nom d'un administrateur du fond A est présent dans un document alors vous pouvez taguer automatiquement le document avec le nom du fond ET le nom de l'administrateur. Ensuite, la communication avec d'autres machines et logiciels sera très simple.
La recherche sémantique inclut aussi la recherche en langage naturel.
Prenons un exemple, vous êtes sur une place dans une ville et vous tapez sur votre téléphone, lui-même connecté à votre moteur de recherche, « Où puis-je manger ? ». Si vous dites cela a n'importe quelle personne elle saura vous répondre, mais comment un moteur de recherche peut faire le lien entre manger avec restaurant, brasserie, friterie, gîte etc…. On est très loin du moteur de recherche de contenu qu'on connait naturellement sur internet, à cela s'ajoute le fait que le moteur de recherche doive connaitre votre profil, savoir ce que vous aimez comme plat, si vous avez des allergies alimentaires ou des régimes spéciaux (Ducan par exemple J ) et pour finir il doit savoir où vous êtes.
Mais la recherche en langage naturel est la clé de voute du Web 3.0, dans l'entreprise les questions seraient différentes.
Imaginons qu'on soit dans un cabinet d'avocat et que la question soit :
« Affichage des articles de lois concernant l'accident de voiture de mon client qui, roulant sur un parking, s'est fait rentrer dedans par une personne venant de droite avec au volant une fille de 15 ans n'ayant pas son permis et apprenant à conduire avec son père » (fait divers qui m'est arrivé)
Il est clair qu'un moteur de recherche basé sur le contenu est perdu dès les premiers mots. Un moteur de recherche sémantique avec langage naturel reconnaitra la demande et saura en sortir l'information.
Le langage naturel n'en est qu'à ses débuts, cependant Bing a déjà commencé et des recherches du style « Air jordan under $100 » fonctionnent dès à présent :
Le Web 3.0 vient aussi avec ses standards :
 
Malgré tout, dire qu'un simple moteur de recherche puisse, à lui seul, se targuer de faire du web sémantique relève encore de l'utopie à l'heure actuelle.

Un moteur de recherche sans recherche J

On peut ajouter la recherche suggestive. Quand fait-on une recherche à l'aide d'un moteur de recherche ? Quand a-t-on besoin d'informations ? Lorsqu'on réalise une tâche dans le cadre de notre travail.
Imaginez que votre manager vous assigne la tâche « Sortir tous les textes de loi sur l'adoption en France ». Vous lisez cette tâche et votre premier réflexe est de chercher dans le système d'information de l'entreprise puis sur internet les textes de lois en question.
Imaginez maintenant que lorsque vous ouvrez la tâche, une zone de l'écran a déjà effectué la recherche à votre place car cette zone est prévue pour afficher les résultats de la recherche inhérente au titre de la tâche. Le gain de temps est énorme !
 
La recherche peut aller beaucoup plus loin, comme on l'a vu précédemment on peut lier au système d'information le moteur de recherche. Si le moteur de recherche est lié à la base des projets, des employés et des clients, il connait donc les trois entités. Ainsi, pendant l'indexation il pourra lier les trois entités entre elles en fonction de leur apparition dans les documents.
Quand le moteur de recherche aura indexé:
  • les CV comportant les connaissances et nom des consultants 
  • Les Fiches de mission comportant le nom des projets, clients, consultants 
  • Les offres commerciales 
  • Les cahiers des charges
  • etc….
Il sera à même de lier le contenu et de savoir quel projet est lié à quel client et à quel consultant.
 
Imaginez maintenant avec beaucoup plus d'entités liées comme les commerciaux, les produits, les incidents etc….
Ceci offre des possibilités et des scénarios d'utilisation énormes et que nous n'avions même pas imaginés possibles il y a quelques années.

La recherche sur les nouveaux médias

Indexer du texte, voilà ce que les moteurs de recherche font depuis des années, mais maintenant, avec les réseaux sociaux, les nouveaux moyens de communication utilisés en entreprise, en résumé les nouveaux types de fichiers comme le son, la vidéo et les images, indexer des documents n'est plus forcément pertinent.
En effet si vous indexez une vidéo et que les seules informations que vous en ressortez sont le nom de la vidéo, sa résolution, sa durée, et le nombre d'images par seconde cela ne vous aidera pas forcement, prenons une image, les données EXIF sont peut être intéressantes mais pas forcément pertinentes non plus.
 
Maintenant les technologies de reconnaissance vocale, faciale et d'objets sont au point et abordables (Picassa par exemple le prouve). Inclue dans un moteur de recherche vous pourriez retrouver toutes les images de la personne (Megan Fox) sans que la photo n'apparaissent sur une page contenant le mot Megan Fox ou ne s'appelle Megan_Fox.jpg par exemple.
Certains sites comme Facebook intègrent désormais un moteur de reconnaissance faciale, cela permet d'indexer très facilement les photos (fini le long tagging des photos), d'autres comme Google ont acquis des technologies de reconnaissance faciale pour la suite :
Ainsi, si vous recherchez dans votre entreprise le nom d'une personne vous retrouverez tous les documents qu'il a rédigé, mais aussi toutes les images et vidéos où il apparait, et les sons où son nom est prononcé. Cela donne une nouvelle dimension à la recherche.

La recherche, cerveau de votre contenu (Content Intelligence)

Le logiciel qui connait le mieux le système d'information de votre entreprise ou du moins l'information qui y réside est le moteur de recherche. Ce dernier peut indexer les informations à intervalle de quelques minutes, permettant d'obtenir une pertinence des résultats assez rapide.
Connaissant votre système d'information et donc le contenu et les documents, le moteur de recherche pourrait ressortir l'ensemble des documents de type « bon de commande » d'un client particulier, comparer à votre système de Business intelligence vous pourrez en ressortir (5 bons de commande dans le système d'information contre 6 commandes effectives par le client) cela peut mettre en exergue certains problèmes. On pourrait aussi imaginer ressortir les bons de commande en comparaison des offres et des factures, en donnant un cliché à un instant T du suivi du client. En quoi cela change de la Business Intelligence ?
Je dirais l'absence de la base de données. Le moteur de recherche puise le contenu directement dans les documents, la réception d'un email suffit à pouvoir mettre à jour l'ensemble de l'information après indexation de celui-ci.
Bien entendu cela est possible avec des moteurs de recherche permettant d'effectuer des requêtes sur l'ensemble de l'index de manière aussi simple qu'avec le langage SQL. Des langages comme Fast Query Langage ou Google Query Language permettent d'imaginer ce genre d'application :
Contrairement à la base de données, la configuration du moteur de recherche est des plus importantes en Content Intelligence, mais, à la différence de la base de données les requêtes sont plus simples, certains diront plus simpliste.
Avec ce genre de langage qui permet de faire des requêtes directement dans le contenu de l'index, on peut faire de la Content Intelligence, qui contrairement à la Business intelligence se base sur le contenu du système d'information, le moteur de recherche étant le cerveau du système d'information c'est le plus apte à répondre à cette demande.

Search Driven Application (Content Intelligence II)

Probablement le concept autour du moteur de recherche le moins aboutis actuellement, mais paradoxalement celui qui pourrait voir le jour le plus vite.
Voici un exemple réalisé par Microsoft :
 
Les applications de nos jours sont des Data Driven Application, elles sont basées sur une base de données, un fichier XML, ou un web services, bref elles sont basées sur une source de données structurées.
Les Search Driven Application sont des applications basées sur le moteur de recherche, la source de données est le moteur de recherche et les demandes passent par des langages de Query complets comme le Fast Query Language ou le Google Query Language.
A partir de là, des Dashboard (Tableau de bord) peuvent être créés et affichés (comme ci-dessus).

Conclusion

Le moteur de recherche n'a pas réellement évolué depuis la sortie de Google et le taux de pénétration du moteur de recherche en entreprise n'est pas très élevé. A l'heure où les entreprises commencent à faire entrer les réseaux sociaux, où les medias commencent à faire partie du contenu et où le nombre de documents croit de manière exponentielle, la recherche va devenir la clé de voute du système d'information, car un système d'information réussi n'est pas un système qui a beaucoup de contenu de différent types mais c'est un système qui permet de trouver l'information tout simplement.
Je suis en train de coder certain exemple de ces concepts en utilisant le moteur de recherche Fast Search For SharePoint (aka fs4sp). Wait and See !
Merci à Nicolas Esprit et à mon épouse pour la relecture.
Catégorie: SharePoint 2010
Publié: 04/08/2011 15:21
]]> Xavier VANNESTE SharePoint 2010 Thu, 04 Aug 2011 14:21:12 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=81 [SharePoint 2010] La Core Result WebPart Votre meilleur source d’informations http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=105 Corps:

Introduction

Lorsqu'on parle de la Core Result Web Part ou la webpart de résultat de recherche, la première chose qui vient en tête c'est la webpart qui se trouve dans le centre de recherche SharePoint et qui affiche le résultat de recherche. Elle est assez rarement utilisée, voire jamais, ailleurs que dans le centre de recherche. Cependant elle peut véritablement servir à beaucoup plus qu'afficher juste le résultat de la recherche dans le centre de recherche.

Imaginez que vous vouliez afficher les derniers documents du site, les documents écris par telle personne mais aussi pouvoir filtrer par site, afficher que les PDF ou les documents Word ? Qu'allez-vous faire ? En discutant avec des développeurs SharePoint la première chose qui vient en tête c'est une requête CAML avec l'utilisation de la classe SPSiteDataQuery. Etes-vous sûr qu'il faille développer quelque chose ? On le verra il y a beaucoup plus simple.

Mise en place

Commençons par le début, on va créer une page qui accueillera notre recherche d'information, pour cela on va sur « Site Actions » à « More option » à « Web Part Page » :

Et on clique sur Create, pour l'exemple on va appeler notre page VerticalSearch avec le layout « Header, Left Column, Body » et notre page dans Site Pages:

On va ajouter les Core Result WebPart dans les trois zones :

Maintenant on peut les paramétrer et afficher les informations sur une page.

Quelques cas concret

Les documents du mois

La première chose que je souhaite c'est avoir tous les documents qui ont été écris ce mois-ci. Pour cela si je suis dans le centre de recherche je peux taper [write="this month"]

Cela est intéressant mais ce que je veux c'est uniquement les documents, soit la Managed Property IsDocument avec la valeur true :

J'ai cependant encore des parasites dans mon résultat, en effet les pages ne m'intéresse pas du tout et encore moins la page que j'ai créé pour l'exemple, il suffit d'enlever l'extension « aspx » de mon résultat :

Voilà maintenant dans mon résultat j'ai mes deux documents créent ce mois-ci et pas les pages du site. Mais ce qui m'intéresse c'est de les mettre dans ma page VerticalSearch. Pour cela je customise ma page (Site ActionàEdit page) et sur la webpart de la zone body je clique sur « Edit Web Part » :

Le but ici est de mettre la query quelque en prédéfinie dans la webpart. C'est le rôle de la propriété « Fixed Keyword Query » qui est dans la zone Result Query Option :

J'entre donc ma requête précédemment faite :

Et voila le résultat :

Après avoir mis le titre et changer le chrome type :

 

 

Les évènements

Je souhaite ajouter une vue sur les évènements inscrits dans le site. Pour cela je vais demander tous les items dont le Content Type est équivalent à event soit [contenttype= « event »]

Si j'ajoute comme je l'ai fait la query a ma webpart dans la zone Left Column :

Voici ce que j'obtiens :

Les deux webparts ont changé, en fait il faut cloisonner les requêtes des webparts sinon le QueryManager transmettra la même information de résultat à toutes les webparts. On va changer le Cross-Web Part query ID en Query2 :

Le résultat escompté est maintenant atteint :

On pourrait les trier par date :

Ici le résultat par page sera le nombre maximum d'items qui apparaitront car la webpart de paginations n'a pas été mise.

Comme on a accés a toutes les managed properties on peut récupérer les liste vide par exemple :

Ou alors tous les fichiers qui sont superieur a 1mb (soit 1048576 octets)

Si on ajoute cela a notre page en Query 3 et qu'on change l'affichage:

Voici le résultat :

On pourrait aussi modifier le XSLT qui fait le rendu du résultat de recherche pour personnaliser encore plus l'affichage.

Référence

http://msdn.microsoft.com/en-us/library/hh644280(v=office.14).aspx

Catégorie: SharePoint 2010 Server
Publié: 27/03/2012 13:03
]]> Xavier VANNESTE SharePoint 2010 Server Tue, 27 Mar 2012 12:03:12 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=105 [Techdays 2012] WebCast de ma session au techdays http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=104 Corps:

Retrouvez le webcast de ma session au techdays, mais aussi toutes les sessions des techdays sur :

http://www.microsoft.com/fr-fr/showcase/details.aspx?uuid=4d6176b3-fff7-481e-8c81-971b23c0964f​

Catégorie: Fast Search for SharePoint
Publié: 09/03/2012 09:41
Tags: Evenement
]]> Xavier VANNESTE Fast Search for SharePoint Fri, 09 Mar 2012 08:42:22 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=104 [Techdays 2012]Retrouvez moi avec Nicolas Schmitt et Geoffrey Lalanne http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=102 Corps:

Une personne passe encore en moyenne 8 heures par semaine à chercher une information (http://www.amplexor.com/ecm-bulletin/ecm-articles/enterprise-search-where-do-we-go-here). Un moteur de recherche d'entreprise, dit "à facettes", fait bien plus qu'un simple moteur de recherche Web, car vos besoins sont spécifiques : taxonomie, folksonomie, sécurité, intégration à la GED, social search et interopérabilité. Venez découvrir ce qu'un vrai moteur de recherche d'entreprise peut faire pour vous, en accroissant votre productivité au quotidien, à travers 5 cas d'usages déployés chez nos clients : jusqu'où pourrez-vous aller grâce à Fast for SharePoint 2010?

Jeudi 9 février de 11h00 a 12h00.

http://www.microsoft.com/france/mstechdays/programmes/parcours.aspx#SessionID=62191f19-06e3-4093-90a6-2e5f7ffa0264

Catégorie: Fast Search for SharePoint
Publié: 05/02/2012 20:44
]]> Xavier VANNESTE Fast Search for SharePoint Sun, 05 Feb 2012 19:44:20 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=102 [SharePoint 2010] BCS Partie 6: Visual Studio 2010 et le Streamer (StreamAccessor) http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=101 Corps:

Introduction

Jusque maintenant on ne peut pas dire que ce qu'on a fait avec Visual Studio soit simple, et on ne peut pas dire qu'on ait un résultat plus probant qu'avec SharePoint Designer.

Jusque maintenant aussi, on ne peut pas dire qu'on ait autre chose qu'une liste, alors que la plupart du temps on utilise les library dans SharePoint, dans lequel des documents sont stockés.

Dans notre exemple on indexe une GED, hors on n'a pas encore remonté les documents. C'est le but du StreamAccessor.

Dans cet article on verra comment remonter les documents stockés dans notre base de données.

Avec Rise les documents sont stockés directement dans la base de données on va donc apporter quelque modification au code pour utiliser ReadItem afin de récupérer le contenu des documents, ensuite nous créerons notre Method Instance StreamAccessor.

Le BCS Designer

On ajoute une méthode à l'entité RiseDocument dans le BCS Designer :

On ajoute deux paramètres, DocID et returnParameter, DocID est de direction in et returnParameter est de direction Return, le type descriptor sera DocIDTypeDescriptor et DocRise:

Les Paramètres pour DocIDTypeDescriptor sont

Le type correspond au type de l'identifier DocID.

Pour DocRise les paramétres vont être un peu plus complexe, on reprendra l'entité DocRise de ReadItem auquel on va ajouter Content de Type System.IO.Stream :

Maintenant on a les fondations pour notre BDC, il nous reste à ajouter notre méthode instance de type StreamAccessor :

Le return parameter name sera le typedescriptor returnParameter qui contient toutes les informations de RiseDocument, mais le return type descriptor sera content car c'est cette propriété qui contient le contenu qui doit être retourné.

Si on en reste là, le téléchargement ne sera pas terrible car il y'aura pas de nom de fichier, pas d'extension et pas de mimetype.

Pour cela on doit rajouter le lien vers les propriétés titre et mimetype du fichier. Dans les custom properties de la méthode instance on ajoute :

MimeTypeField prend en valeur le nom du type descriptor qui contient le nom du fichier, et FileNameField contient le nom du document qui sera téléchargé.

Suite à ces changements le Service a été modifié et il nous reste à mettre le code dans notre assemblie .net

Changement du code

On va changer le code de RiseDocument, afin de refléter le retour du contenu.

Pour cela on va ajouter une propriété de type Stream s'appelant Content :

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.IO;

 

namespace BDCRiseCMS.BdcModel1

{

/// <summary>

/// This class contains the properties for Entity1. The properties keep the data for Entity1.

/// If you want to rename the class, don't forget to rename the entity in the model xml as well.

/// </summary>

public partial class RiseDocument

{

//TODO: Implement additional properties here. The property Message is just a sample how a property could look like.

public long DocID { get; set; }

public string MimeType { get; set; }

public string Title { get; set; }

public string Description { get; set; }

public string Langue { get; set; }

public Stream Content { get; set; }

}

}

 

 

Maintenant on va modifier le Service RiseDocumentService pour remplir la propriété Content :

 

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.Data.SqlClient;

using System.Data;

using System.IO;

 

namespace BDCRiseCMS.BdcModel1

{

/// <summary>

/// All the methods for retrieving, updating and deleting data are implemented in this class file.

/// The samples below show the finder and specific finder method for Entity1.

/// </summary>

public class RiseDocumentService

{

/// <summary>

/// This is a sample specific finder method for Entity1.

/// If you want to delete or rename the method think about changing the xml in the BDC model file as well.

/// </summary>

/// <param name="id"></param>

/// <returns>Entity1</returns>

///

 

 

private static SqlConnection getSQLConnection()

{

SqlConnection _cnData;

_cnData = new SqlConnection("Data Source=srvsql; Initial Catalog=CMSRise;User ID=SA; Password=P@ssw0rd;");

_cnData.Open();

return _cnData;

}

public static RiseDocument ReadItem(long docID)

{

RiseDocument rd = new RiseDocument();

MemoryStream ms = new MemoryStream();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT t_cms_u_Document.c_id, t_cms_u_Document.c_u_MimeType, " +

"t_cms_u_Document.c_u_Data, t_cms_u_Content.c_u_Title, t_cms_u_Content.c_u_Description, " +

"t_cms_u_Content.c_u_Language " +

"FROM t_cms_u_Content INNER JOIN t_cms_u_Document ON t_cms_u_Content.c_id = t_cms_u_Document.c_r_Content " +

"where t_cms_u_Document.c_id=@docID";

cmdata.Parameters.AddWithValue("@docID", docID);

SqlDataReader drData = cmdata.ExecuteReader();

if (drData.Read())

{

rd.DocID = drData.GetInt64(0);

rd.MimeType = drData.GetString(1);

byte[] bContent = (byte[])drData.GetValue(2);

 

ms.Write(bContent, 0, bContent.Length);

ms.Flush();

ms.Position = 0;

rd.Content = ms;

rd.Title = drData.GetString(3);

rd.Description = drData.GetString(4);

rd.Langue = drData.GetString(5);

}

else

{

rd.DocID = -1;

rd.MimeType = "";

rd.Content = null;

rd.Title = "";

rd.Description = "";

rd.Langue = "";

 

}

 

 

}

}

return rd;

}

/// <summary>

/// This is a sample finder method for Entity1.

/// If you want to delete or rename the method think about changing the xml in the BDC model file as well.

/// </summary>

/// <returns>IEnumerable of Entities</returns>

public static IEnumerable<RiseDocument> ReadList()

{

List<RiseDocument> rds = new List<RiseDocument>();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT t_cms_u_Document.c_id, t_cms_u_Document.c_u_MimeType, " +

"t_cms_u_Document.c_u_Data, t_cms_u_Content.c_u_Title, t_cms_u_Content.c_u_Description, " +

"t_cms_u_Content.c_u_Language " +

"FROM t_cms_u_Content INNER JOIN t_cms_u_Document ON t_cms_u_Content.c_id = t_cms_u_Document.c_r_Content ";

SqlDataReader drData = cmdata.ExecuteReader();

while (drData.Read())

{

RiseDocument rd = new RiseDocument();

rd.DocID = drData.GetInt64(0);

rd.MimeType = drData.GetString(1);

rd.Title = drData.GetString(3);

rd.Description = drData.GetString(4);

rd.Langue = drData.GetString(5);

rds.Add(rd);

}

 

}

}

return rds;

}

 

public static IEnumerable<RiseSite> RiseDocumentToSite(long docID)

{

List<RiseSite> lstRs = new List<RiseSite>();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT t_cms_u_Site.c_id, t_cms_u_Site.c_u_Name "+

"FROM t_cms_u_Content INNER JOIN "+

"t_cms_u_Document ON t_cms_u_Content.c_id = t_cms_u_Document.c_r_Content INNER JOIN "+

"t_cms_u_Site ON t_cms_u_Content.c_r_Site = t_cms_u_Site.c_id WHERE (t_cms_u_Document.c_id = @docID) ";

cmdata.Parameters.AddWithValue("@docID", docID);

SqlDataReader drData = cmdata.ExecuteReader();

while (drData.Read())

{

RiseSite rs = new RiseSite();

rs.SiteID = (int)drData.GetInt64(0);

rs.SiteName = drData.GetString(1);

lstRs.Add(rs);

}

 

}

}

return lstRs;

}

 

public static Stream GetContentForDocID(long DocID)

{

return ReadItem(DocID).Content;

}

 

}

}

 

 

On a ajouté une méthode GetDocumentForDocID qui retournera le stream pour le StreamAccessor et on a modifié ReadItem pour remplir la propriété Content.

Cependant on a vu que le Mimetype et le nom du document est important aussi pour le download du document toutes les propriétés doivent donc être remplis.

 

Le résultat

Le résultat est le suivant :

Le lien Click here to download est créé automatiquement si on clique dessus il récupére le nom du fichier et le mimetype et revoit le fichier stocké dans la base de données :

Si on clique sur open le document s'ouvre automatiquement.

Maintenant on obtient quelque chose de plus proche de ce que SharePoint peut faire.

Avec la webpart Business Data list on obtient ce qui se rapproche le plus d'une document library :

Catégorie: SharePoint 2010
Publié: 01/02/2012 16:50
]]> Xavier VANNESTE SharePoint 2010 Wed, 01 Feb 2012 15:50:09 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=101 [SharePoint 2010] Bonne année et MVP une année de plus http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=98 Corps:

Bonjour à tous je vous souhaite une très bonne année 2012.

Mon année démarre rapidement puisque je viens d'être renouvelé MVP pour un an de plusJ.

Le programme pour 2012 n'est pas encore définit clairement comme l'année dernière mais beaucoup de choses sont prévu, un ensemble d'article sur les BCS et deux release majeur pour le Pivot Viewer for SharePoint et le Thumbnail extender for SharePoint mais aussi deux autres projets en cours, Pivot Viewer for Office 365 et un quatrième en cours d'analyse.

Xavier VANNESTE

Catégorie: SharePoint 2010
Publié: 01/01/2012 16:36
]]> Xavier VANNESTE SharePoint 2010 Sun, 01 Jan 2012 15:36:22 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=98 [SharePoint 2010] BCS Partie 3: Les Associations http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=90 Corps:

Série D'articles:

Introduction

Faire un BCS pour une table sera relativement rare quand même, la plupart du temps vous utiliserez le BCS avec plusieurs tables et des associations entre elle.

L'avantage avec les BCS et qu'ils fournissent une vue master détail assez facilement. On le verra, avec SharePoint Designer on peut facilement créer les liens et faire des pages Master Details.

Préparation.

On va créer deux external content type comme vu précédemment un pour ProductSubCategory et un pour ProductCategory :

Create All Operation sur la table SubCat :

Name en Show in DataPicker

On n'oublie pas la création de la profile page:

Pareil pour la catégorie :

Comme on peut le voir les External Content Type sont regroupé par Namespace :

Comme dans cet article on n'a pas réécrit les namespaces l'url du site est prise par défaut pour faire les External Content Type.

Les relations

On va ré-ouvrir notre external content type Adventure Works.

Et cliquez sur

On revient sur le design de notre external content type.

On fait un clic avec le bouton droit sur la table qui a servie à faire l'external content type à savoir product et on clique sur new association :

On va le lier a un external content type en cliquant sur browse :

On selection sub cat car dans la DB on a un lien entre product et subcategorie.

SharePoint designer découvre de lui-même la relation.

On selectionne ProductSubCategoryID comme identifier :

On continue jusque la fin avec Next sans rien modifier.

On fait pareil avec SubCategory en faisant une relation avec Catégorie.

Une fois les relations faites il faut refaire les Profile page des Categorie et SubCategorie car leur page fera un Master Details (on sélectionne une catégorie on a les sourcategories et on sélectionne une sous-catégorie on a les produits).

Après avoir refait les profils pages on obtient :

La même chose avec les sous catégories :

Petite déception pas de liens actifs pour naviguer sur les produits ou les sous catégories à partir de la page parente.

XSLT

Pas grave on va éditer le XSLT :

On édite la page avec les catégories et on édite la webpart de navigation :

On clique sur XSL Editor :

Et on change la partie suivante :

<td class="ms-vb">

<xsl:attribute name="style">

<xsl:choose>

<xsl:when test="$dvt_1_form_selectkey = @*[name()=$ColumnKey]">color:blue</xsl:when>

<xsl:otherwise />

</xsl:choose>

</xsl:attribute>

<xsl:value-of select="@ProductSubcategoryID" />

</td>

   

Avec celle la :

   

<td class="ms-vb">

<xsl:attribute name="style">

<xsl:choose>

<xsl:when test="$dvt_1_form_selectkey = @*[name()=$ColumnKey]">color:blue</xsl:when>

<xsl:otherwise />

</xsl:choose>

</xsl:attribute>

<a>

<xsl:attribute name="href">

<![CDATA[http://srvmoss:80/_bdc/http___srvmoss/AdventureWorksSubCat_1.aspx?ProductSubcategoryID=]]><xsl:value-of select="@ProductSubcategoryID" />

</xsl:attribute>

<xsl:value-of select="@ProductSubcategoryID" />

</a>

</td>

   

Bien entendu la page profil doit être adaptée.

Le résultat est le suivant :

Il suffit de cliquer dessus pour naviguer sur la page de la sous-catégorie. Il suffira de faire de même avec la page des sous catégories pour naviguer vers produits.

Catégorie: SharePoint 2010
Publié: 16/12/2011 08:37
]]> Xavier VANNESTE SharePoint 2010 Fri, 16 Dec 2011 07:37:24 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=90 [SharePoint 2010] BCS Partie 5: Visual Studio 2010 les associations http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=100 Corps:

Série D'articles:

Introduction

Comme on a vu avec SharePoint designer on peut faire les associations entre les entités de votre BCS afin de mettre en place des vues Master/Details sur des associations. On va reprendre la création de notre BCS fait avec Visual Studio, on va lui ajouter une entité Site et on va faire les changements permettant de l'exploiter, on verra que suite à ces changements, on aura le même comportement qu'avec SharePoint Designer, pour l'instant on recherche le même comportement on verra par la suite les avantages à utiliser Visual Studio.

Avant de continuer on va se pencher sur la description de méthode et de méthode instance :

Modification de l'existant 

Premièrement on va supprimer le type descriptor « Site » dans le BDC Explorer.

Puis on va modifier le code des classes pour ne plus retourner « Site » :

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

 

namespace BDCRiseCMS.BdcModel1

{

/// <summary>

/// This class contains the properties for Entity1. The properties keep the data for Entity1.

/// If you want to rename the class, don't forget to rename the entity in the model xml as well.

/// </summary>

public partial class RiseDocument

{

//TODO: Implement additional properties here. The property Message is just a sample how a property could look like.

public long DocID { get; set; }

public string MimeType { get; set; }

public string Title { get; set; }

public string Description { get; set; }

public string Langue { get; set; }

public byte[] Content { get; set; }

}

}

 

 

 

 

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.Data.SqlClient;

using System.Data;

 

namespace BDCRiseCMS.BdcModel1

{

/// <summary>

/// All the methods for retrieving, updating and deleting data are implemented in this class file.

/// The samples below show the finder and specific finder method for Entity1.

/// </summary>

public class RiseDocumentService

{

/// <summary>

/// This is a sample specific finder method for Entity1.

/// If you want to delete or rename the method think about changing the xml in the BDC model file as well.

/// </summary>

/// <param name="id"></param>

/// <returns>Entity1</returns>

///

 

 

private static SqlConnection getSQLConnection()

{

SqlConnection _cnData;

_cnData = new SqlConnection("Data Source=srvsql; Initial Catalog=CMSRise;User ID=SA; Password=P@ssw0rd;");

_cnData.Open();

return _cnData;

}

public static RiseDocument ReadItem(long docID)

{

RiseDocument rd = new RiseDocument();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT t_cms_u_Document.c_id, t_cms_u_Document.c_u_MimeType, " +

"t_cms_u_Document.c_u_Data, t_cms_u_Content.c_u_Title, t_cms_u_Content.c_u_Description, " +

"t_cms_u_Content.c_u_Language " +

"FROM t_cms_u_Content INNER JOIN t_cms_u_Document ON t_cms_u_Content.c_id = t_cms_u_Document.c_r_Content " +

"where t_cms_u_Document.c_id=@docID";

cmdata.Parameters.AddWithValue("@docID", docID);

SqlDataReader drData = cmdata.ExecuteReader();

if (drData.Read())

{

rd.DocID = drData.GetInt64(0);

rd.MimeType = drData.GetString(1);

rd.Content = (byte[])drData.GetValue(2);

rd.Title = drData.GetString(3);

rd.Description = drData.GetString(4);

rd.Langue = drData.GetString(5);

}

else

{

rd.DocID = -1;

rd.MimeType = "";

rd.Content = null;

rd.Title = "";

rd.Description = "";

rd.Langue = "";

 

}

 

 

}

}

return rd;

}

/// <summary>

/// This is a sample finder method for Entity1.

/// If you want to delete or rename the method think about changing the xml in the BDC model file as well.

/// </summary>

/// <returns>IEnumerable of Entities</returns>

public static IEnumerable<RiseDocument> ReadList()

{

List<RiseDocument> rds = new List<RiseDocument>();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT t_cms_u_Document.c_id, t_cms_u_Document.c_u_MimeType, " +

"t_cms_u_Document.c_u_Data, t_cms_u_Content.c_u_Title, t_cms_u_Content.c_u_Description, " +

"t_cms_u_Content.c_u_Language " +

"FROM t_cms_u_Content INNER JOIN t_cms_u_Document ON t_cms_u_Content.c_id = t_cms_u_Document.c_r_Content ";

SqlDataReader drData = cmdata.ExecuteReader();

while (drData.Read())

{

RiseDocument rd = new RiseDocument();

rd.DocID = drData.GetInt64(0);

rd.MimeType = drData.GetString(1);

rd.Content = (byte[])drData.GetValue(2);

rd.Title = drData.GetString(3);

rd.Description = drData.GetString(4);

rd.Langue = drData.GetString(5);

rds.Add(rd);

}

 

}

}

return rds;

}

 

}

}

 

 

Maintenant on peut passer à la création de notre entité <Site>

Création de nouvelles entités

On va commencer par le BCS designer :

On va nommer l'entité Site puis on va mettre un nouvelle identifier SiteID :

Sans oublier de mettre le bon type pour SiteID :

 

On ajoute les deux méthodes ReadList et ReadItem

Pour nous aider a designer les méthodes on utilisera le BDC Method Detail :

On va créer les paramètres pour ReadList :

Voici le contenu, on change le nom du type descriptor et la direction en Return :

Maintenant on va créer notre List Instance

Une Méthode instance permet de spécifier quand utiliser la méthode (retour de l'ensemble des entités, d'une seule entité, mise a jours d'une entité, suppression d'une entité…….)

 

On specifie le return parameter :

On va faire de même avec ReadItem :

On spécifie le return parameter :

 

Si l'on regarde dans le solution explorer on se rend compte qu'on n'a pas le site entity mais que le SiteService, on va donc créer la classe Site.

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

 

namespace BDCRiseCMS.BdcModel1

{

public class RiseSite

{

public int SiteID { get; set; }

public String SiteName { get; set; }

}

}

 

 

Maintenant qu'on l'a créé on peut terminer le schema de notre BCS, dans le BDC explorer on va changer le type des type descriptor SiteRise et SiteRiseList :

Pour SiteRiseList on coche en plus is Enumerable :

SiteID :

 

On finit l'entité SiteRise :

SiteService a été généré par le designer :

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

namespace BDCRiseCMS.BdcModel1

{

public partial class SiteService

{

public static IEnumerable<RiseSite> ReadList()

{

throw new System.NotImplementedException();

}

 

public static RiseSite ReadItem(int ID)

{

throw new System.NotImplementedException();

}

}

}

 

 

Avec le code :

 

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.Data.SqlClient;

namespace BDCRiseCMS.BdcModel1

{

public partial class SiteService

{

private static SqlConnection getSQLConnection()

{

SqlConnection _cnData;

_cnData = new SqlConnection("Data Source=srvsql; Initial Catalog=CMSRise;User ID=SA; Password=P@ssw0rd;");

_cnData.Open();

return _cnData;

}

 

public static IEnumerable<RiseSite> ReadList()

{

List<RiseSite> lstRS = new List<RiseSite>();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT c_id, c_u_Name FROM t_cms_u_Site" ;

 

SqlDataReader drData = cmdata.ExecuteReader();

while (drData.Read())

{

RiseSite rs=new RiseSite();

rs.SiteID = (int)drData.GetInt64(0);

rs.SiteName = drData.GetString(1);

lstRS.Add(rs);

}

}

}

return lstRS;

}

 

public static RiseSite ReadItem(int ID)

{

RiseSite rs = new RiseSite();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT c_id, c_u_Name FROM t_cms_u_Site " +

"where c_id=@ID";

cmdata.Parameters.AddWithValue("@ID", ID);

SqlDataReader drData = cmdata.ExecuteReader();

if (drData.Read())

{

rs.SiteID = drData.GetInt32(0);

rs.SiteName = drData.GetString(1);

}

else

{

rs.SiteID = -1;

rs.SiteName = "";

}

 

}

}

return rs;

}

}

}

 

Le résultat une fois la profile page terminé :

 

 

Mise en place de l'association

Très bien maintenant passons au plus simple, on va créer une association entre les deux entités, cette association générera une méthode dans chaque entité permettant de faire une vue Master/Details.

On ne remplit rien d'autre, seul le code sera à modifier :

Code dans SIteService

public static IEnumerable<RiseDocument> SiteToRiseDocument(int siteID)

{

List<RiseDocument> rds = new List<RiseDocument>();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT t_cms_u_Document.c_id, t_cms_u_Document.c_u_MimeType, " +

"t_cms_u_Document.c_u_Data, t_cms_u_Content.c_u_Title, t_cms_u_Content.c_u_Description, " +

"t_cms_u_Content.c_u_Language " +

"FROM t_cms_u_Content INNER JOIN " +

"t_cms_u_Document ON t_cms_u_Content.c_id = t_cms_u_Document.c_r_Content INNER JOIN " +

"t_cms_u_Site ON t_cms_u_Content.c_r_Site = t_cms_u_Site.c_id WHERE (t_cms_u_Site.c_id = @siteID) ";

cmdata.Parameters.AddWithValue("@siteID", siteID);

SqlDataReader drData = cmdata.ExecuteReader();

while (drData.Read())

{

RiseDocument rd = new RiseDocument();

if(!drData.IsDBNull(0))

rd.DocID = drData.GetInt64(0);

if (!drData.IsDBNull(1))

rd.MimeType = drData.GetString(1);

if (!drData.IsDBNull(2))

rd.Content = (byte[])drData.GetValue(2);

if (!drData.IsDBNull(3))

rd.Title = drData.GetString(3);

if (!drData.IsDBNull(4))

rd.Description = drData.GetString(4);

if (!drData.IsDBNull(5))

rd.Langue = drData.GetString(5);

rds.Add(rd);

}

 

}

}

return rds;

 

}

 

 

Code dans RiseDocumentServices :

public static IEnumerable<RiseSite> RiseDocumentToSite(long docID)

{

List<RiseSite> lstRs = new List<RiseSite>();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT t_cms_u_Site.c_id, t_cms_u_Site.c_u_Name "+

"FROM t_cms_u_Content INNER JOIN "+

"t_cms_u_Document ON t_cms_u_Content.c_id = t_cms_u_Document.c_r_Content INNER JOIN "+

"t_cms_u_Site ON t_cms_u_Content.c_r_Site = t_cms_u_Site.c_id WHERE (t_cms_u_Document.c_id = @docID) ";

cmdata.Parameters.AddWithValue("@docID", docID);

SqlDataReader drData = cmdata.ExecuteReader();

while (drData.Read())

{

RiseSite rs = new RiseSite();

rs.SiteID = (int)drData.GetInt64(0);

rs.SiteName = drData.GetString(1);

lstRs.Add(rs);

}

 

}

}

return lstRs;

}

 

 

Le résultat est le suivant :

Le master detail est bien en place. On a donc le même comportement qu'avec SharePoint Designer.

Résultat

Le résultat est proche de SharePoint designer, même si actuellement il est impossible d'indexer ce BCS. Ici on se rend compte que faire la même chose que SharePoint Designer n'est pas si simple avec Visual Studio, cependant à partir de maintenant les possibilités réélles de Visual Studio vont être utilisées.

Catégorie: SharePoint 2010
Publié: 25/01/2012 17:28
]]> Xavier VANNESTE SharePoint 2010 Wed, 25 Jan 2012 16:28:20 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=100 [SharePoint 2010] BCS Partie 1: Qu’est-ce que c’est ? http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=88 Corps:

Série D'articles:

Introduction

BCS pour Business Connectivity Services de SharePoint 2010 est le successeur des BDC pour Business Data Catalog , de SharePoint 2007.
Sour SharePoint 2010, les BCS se présentent comme un Service Application, ce qui signifie qu'il est distribuable. Les BCS permettent d'utiliser des sources de données externes, et pas seulement des Bases de Données comme beaucoup pourrait le penser, à SharePoint et de les intégrer dans SharePoint comme si le contenu faisait partie intégrante de la plateforme.
Contrairement au BDC, les BCS de SharePoint 2010 permettent de faire du CRUD (Create, Read, Update, Delete) ce qui présente un énorme avantage.
Un autre avantage des BCS est qu'il est possible de faire des références non seulement aux Bases de données mais aussi au service Web WCF et aux assemblies .Net, d'où la remarque insistant sur le fait qu'on parle de sources de données et nom de Base de données. En utilisant les assemblies .Net on peut donc considérer qu'on développe un connecteur a des sources de données externes du moment qu'elle soit interrogeable en .Net.
Ainsi il est pensable d'avoir un BCS pour interroger une base de données Oracle, MySQL, DB2, d'interroger des web services externes, sur le cloud par exemple ou alors de développer un connecteur pour un fileshare spécifique (novell par exemple qui, une fois indexé, ne remontant pas les ACL, il ne fait pas de security trimming).

Les BCS est un sujet très vaste car une fois la connexion à la source de données faite, il reste l'affichage de ces informations, en effet c'est bien beau d'avoir les données encore faut-il les afficher, leur indexation par le moteur de recherche avec le security trimming, le retour des binaires s'il y a, l'intégration avec les informations de SharePoint, et l'expérience utilisateur.

Lorsqu'on découvre les BCS on a l'impression que cela est confus et un peu complexe, le but de cet article est de délier ensemble cette complexité et de donner des pistes aux différents problèmes.

Au cours de cette série d'article nous aborderons comment faire des BCS avec SharePoint Designer, mais aussi avec Visual Studio, ainsi que les différentes possibilités qui nous sont offerte par la plateforme

L'architecture     

L'architecture des BCS est basée sur les services application de SharePoint 2010, ce qui signifie que les BCS fournissent un WCF pour y accéder depuis l'extérieur mais aussi une base de données pour stocker les informations de configurations (le template de la DB est Bdc_Service_DB_{GUID}).
Les BCS peuvent interagir directement avec SharePoint au travers des listes externes, de la recherche, des colonnes externes, des profils utilisateurs, des web parts ou des Workflow. Sur les BCS on peut développer nos propres applications et utiliser SharePoint comme Middleware pour accéder aux données, tout en s'appuyant sur l'architecture des Services Applications.
Le Secure Store permet de mettre en place la sécurité entre le monde SharePoint et le monde Externe (Single Sign On).
L'api Cliente permet de récupérer dans le BCS Client Cache les données afin de les exploiter dans les clients, cela est inclut nativement dans Office 2010 dans les applications SharePoint Workspace, Outlook, Infopath, Word et Access et à travers des Office Business Application il est aussi possible d'exploiter ces informations.

Le développement d'un BCS se base sur un XML (comme dans les BDC) de paramétrage qui renseigne les entités et les informations d'accès à l'information. Dans le fichier XML on met les différents paramètre, ainsi s'il s'agit d'un accès a une base de données on retrouvera directement les requêtes SQL. Ceux qui ont eu la chance de faire des BDC dans SharePoint 2007, se rappellent surement la joie de faire ces fichiers XML a la main.

Le BDCM

Regardons de suite un BDCM :

Source :http://msdn.microsoft.com/en-us/library/ee558376.aspx

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<Model Name="ExampleApplicationDefinition" xmlns="http://schemas.microsoft.com/windows/2007/BusinessDataCatalog">

<LobSystems>

<LobSystem Name="ExampleCRM" Type="Database">

<Properties>

<!-- This database uses % symbol for the LIKE operator. -->

<Property Name="WildcardCharacter" Type="System.String">%</Property>

</Properties>

<LobSystemInstances>

<LobSystemInstance Name="ExampleServer">

<Properties>

<Property Name="AuthenticationMode" Type="System.String">PassThrough</Property>

<!-- The database instance is named ExampleSQL and is running on the same computer as the application using this Model. -->

<Property Name="RdbConnection Data Source" Type="System.String">(local)\ExampleSQL</Property>

<!-- The database to be used is named ExampleDB. -->

<Property Name="RdbConnection Initial Catalog" Type="System.String">ExampleDB</Property>

<!-- The database instance is using integrated security. -->

<Property Name="RdbConnection Integrated Security" Type="System.String">SSPI</Property>

</Properties>

</LobSystemInstance>

</LobSystemInstances>

<Entities>

<Entity Name="Customer" Namespace="example.com" Version="1.0.0.0">

<Identifiers>

<Identifier Name="CustomerIdentifier" TypeName="System.Int32" />

</Identifiers>

<Methods>

<Method Name="GetCustomers">

<Properties>

<!-- sp_getCustomer is the name of the stored procedure that implements this method. -->

<Property Name="RdbCommandText" Type="System.String">sp_GetCustomers</Property>

<!-- Using stored procedures is a best practice when connecting to database systems. -->

<Property Name="RdbCommandType" Type="System.Data.CommandType, System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">StoredProcedure</Property>

</Properties>

<Parameters>

<!-- The parameter name @CustomerId as expected by the stored procedure. -->

<Parameter Name="@CustomerId" Direction="In">

<!-- The IdentifierName attribute is required here. -->

<TypeDescriptor Name="Id" TypeName="System.Int32" IdentifierName="CustomerIdentifier" />

</Parameter>

<Parameter Name="Customers" Direction="Return">

<!-- This SQL command returns a result set containing precisely one row, but it is still wrapped by a data reader and appears as a collection. -->

<TypeDescriptor Name="CustomerDataReader" TypeName="System.Data.SqlClient.SqlDataReader, System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" IsCollection="true">

<TypeDescriptors>

<!-- This is a data record corresponding to a single row of the result set. -->

<TypeDescriptor Name="Customer" TypeName="System.Data.IDataRecord, System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">

<TypeDescriptors>

<!-- The IdentifierName attribute is required here to associate the field with the Identifier. -->

<TypeDescriptor Name="Id" TypeName="System.Int32" IdentifierName="CustomerIdentifier" />

<TypeDescriptor Name="FirstName" TypeName="System.String" />

<TypeDescriptor Name="LastName" TypeName="System.String" />

</TypeDescriptors>

</TypeDescriptor>

</TypeDescriptors>

</TypeDescriptor>

</Parameter>

</Parameters>

<MethodInstances>

<!-- The ReturnParameterName and ReturnTypeDescriptor are pointing to the data record to be returned. The result set that is wrapping it is not important and can be ignored when processing results. -->

<MethodInstance Name="GetCustomer" Type="SpecificFinder" ReturnParameterName="Customers" ReturnTypeDescriptorPath="CustomerDataReader[0]"/>

</MethodInstances>

</Method>

</Methods>

</Entity>

</Entities>

</LobSystem>

</LobSystems>

</Model>

N'ayez pas peur, normalement vous n'aurez pas à le faire à la main si vous travaillez avec SharePoint 2010, voici la documentation du schéma complet http://msdn.microsoft.com/en-us/library/ee556387.aspx

Dans ce simple exemple on a tout d'abord :

Le Model qui permet de définir l'élément racine du XML et le nom de notre BCS.

<Model Name="ExampleApplicationDefinition" xmlns="http://schemas.microsoft.com/windows/2007/BusinessDataCatalog">

 

Ensuite nous avons les informations global a notre lobsystem et lobsysteminstance ces éléments sont un peu comme une classe application, ils définissent des éléments et des propriétés communes a l'ensemble du BCS, le lobsystem englobe la totalité du BCS et il est lui-même inclut dans le Model.

<LobSystem Name="ExampleCRM" Type="Database">

<Properties>

<!-- This database uses % symbol for the LIKE operator. -->

<Property Name="WildcardCharacter" Type="System.String">%</Property>

</Properties>

<LobSystemInstances>

<LobSystemInstance Name="ExampleServer">

<Properties>

<Property Name="AuthenticationMode" Type="System.String">PassThrough</Property>

<!-- The database instance is named ExampleSQL and is running on the same computer as the application using this Model. -->

<Property Name="RdbConnection Data Source" Type="System.String">(local)\ExampleSQL</Property>

<!-- The database to be used is named ExampleDB. -->

<Property Name="RdbConnection Initial Catalog" Type="System.String">ExampleDB</Property>

<!-- The database instance is using integrated security. -->

<Property Name="RdbConnection Integrated Security" Type="System.String">SSPI</Property>

</Properties>

</LobSystemInstance>

</LobSystemInstances>

Ensuite les entities correspondent à ceux qu'on peut appeler les External Content Type, c'est un peu comme les tables ou vues dans SQL Server.

<Entities>

<Entity Name="Customer" Namespace="example.com" Version="1.0.0.0">

<Identifiers>

<Identifier Name="CustomerIdentifier" TypeName="System.Int32" />

</Identifiers>

 

Dans nos entities on a des méthodes qui définissent un modèle de méthodes comme un select all ou un select by id ou l'appel a une procédure stockées ou une fonction .net avec des paramètres en entrée et des paramètres en sortie.

<Methods>

<Method Name="GetCustomers">

<Properties>

<!-- sp_getCustomer is the name of the stored procedure that implements this method. -->

<Property Name="RdbCommandText" Type="System.String">sp_GetCustomers</Property>

<!-- Using stored procedures is a best practice when connecting to database systems. -->

<Property Name="RdbCommandType" Type="System.Data.CommandType, System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">StoredProcedure</Property>

</Properties>

<Parameters>

<!-- The parameter name @CustomerId as expected by the stored procedure. -->

<Parameter Name="@CustomerId" Direction="In">

<!-- The IdentifierName attribute is required here. -->

<TypeDescriptor Name="Id" TypeName="System.Int32" IdentifierName="CustomerIdentifier" />

</Parameter>

 

Ces paramètres sont décrits suivant des types simples ou combiné pour créer des types complexes en retour.

<Parameter Name="Customers" Direction="Return">

<!-- This SQL command returns a result set containing precisely one row, but it is still wrapped by a data reader and appears as a collection. -->

<TypeDescriptor Name="CustomerDataReader" TypeName="System.Data.SqlClient.SqlDataReader, System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" IsCollection="true">

<TypeDescriptors>

<!-- This is a data record corresponding to a single row of the result set. -->

<TypeDescriptor Name="Customer" TypeName="System.Data.IDataRecord, System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089">

<TypeDescriptors>

<!-- The IdentifierName attribute is required here to associate the field with the Identifier. -->

<TypeDescriptor Name="Id" TypeName="System.Int32" IdentifierName="CustomerIdentifier" />

<TypeDescriptor Name="FirstName" TypeName="System.String" />

<TypeDescriptor Name="LastName" TypeName="System.String" />

</TypeDescriptors>

</TypeDescriptor>

</TypeDescriptors>

</TypeDescriptor>

</Parameter>

</Parameters>

 

Ces méthodes sont appelées dans le cadre de méthodes instance qui elles définissent s'il faut les appeler en cas de Finder ou SpecificFinder etc…

<MethodInstances>

<!-- The ReturnParameterName and ReturnTypeDescriptor are pointing to the data record to be returned. The result set that is wrapping it is not important and can be ignored when processing results. -->

<MethodInstance Name="GetCustomer" Type="SpecificFinder" ReturnParameterName="Customers" ReturnTypeDescriptorPath="CustomerDataReader[0]"/>

</MethodInstances>

 

Les Limitations

Cependant, Il est important de comprendre les limites des External list :

-Pas de versionning, ce qui est normal puisque les données sont stockées dans la base de données pas dans SharePoint, il serait donc impossible de gérer le versionning

-Pas de Information Management Policy, ce qui est aussi normal puisqu'on ne va pas pouvoir demander à stocker les informations autre part

-Pas de workflow en out of the box, mais on verra comment contourner ce problème

-Pas d'inline editing (la moi pas comprendre), en effet cela est techniquement possible

-Pas de Rating

-Impossible d'exporter en Excel ou d'ouvrir avec Visio, Access ou Project. (http://exportexternallist.codeplex.com/ export vers excel)

-Pas d'accès Rest avec ListData.svc

-Pas de flux RSS

-Pas de permission niveau item (ou pas on verra comment contourner le problème)

-Pas de lookup

-Pas d'attachements

Certaine limite sont assez normale, SharePoint gère ses enregistrements et il connait ceux qui sont supprimés, mis à jours etc… Comment peut-il avoir la même flexibilité avec des données externes comme SQL Serveur, WCF qui, par définition peuvent être mis à jours sans que SharePoint n'en soit conscient. Prenons le flux RSS, il affiche les dernières informations donc les derniers enregistrements, comment SharePoint peut savoir quelles sont les dernières lignes ajoutées dans une base de données ? On pourrait dire dans ce cas on met une colonne ou une information « dernière mise a jours » mais cela devient une contrainte sur un environnement existant sur lequel on souhaite s'intégrer.

 

Référence

 

http://msdn.microsoft.com/fr-fr/sharepoint/ff660755

http://msdn.microsoft.com/en-us/library/ee558376.aspx

http://msdn.microsoft.com/en-us/library/ee556387.aspx

http://www.sharepointanalysthq.com/2010/07/bcs-external-list-limitations/

 

Catégorie: SharePoint 2010
Publié: 16/12/2011 08:37
]]> Xavier VANNESTE SharePoint 2010 Fri, 16 Dec 2011 07:37:04 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=88 [SharePoint 2010] BCS Partie 2: SharePoint Designer http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=89 Corps:

Série D'articles:

Introduction

Comme nous avons pu le voir dans la partie 1, faire un BCS n'est pas simple. Nous aborderons ici la création d'un BCS sur une base de données, dans un premier temps sans le Secure Store puis nous utiliserons le Secure store pour faire une authentification SQL au lieu d'une authentification Windows.

Dans l'article suivant nous verrons les associations entre les entités directement dans SharePoint Designer. La base de données qui sera utilisée est la base de données AdventureWorks. Nous aborderons aussi les limitations et la création de liste externe. Nous verrons l'étendue de ce qui est fait avec SharePoint Designer et comment utiliser ce qui a été généré pour faire un déploiement sur une autre machine pour passer de Test a UAT ou de UAT a Prod par exemple.

SharePoint Designer

Commençons par regarder les deux tables que l'on va utiliser :

La table Production.Product

La table Person.Contact

Table Product

La première chose à faire est d'ouvrir le site sur lequel on veut déployer le BCS. Au niveau de SharePoint Designer il y a un paradoxe, qui, on le verra plus tard à cause d'un bug, se produit aussi avec Visual Studio, en effet on crée un BCS qui est censé être déployé de manière globale dans le BCS Service Application, et la première chose qu'on nous demande, c'est le nom d'un site.

Dans SharePoint designer on sélectionne External Content Type (Si vous en avez déjà de définit ils apparaitront à ce niveau-là).

On va en ajouter un qu'on appellera AdventureWorks. Pour cela on clique sur External Content Type en haut à droite :

On va le renommer en client sur « New External Content Type » à coté de Name et on met AdventureWorks, on fait de même pour le NameSpace :

Pour cette table on va utiliser une Generic List et autoriser la synchronisation OffLine. Ensuite on clique sur « Click Here to discover external data sources…. »

On n'a plus qu'à ajouter notre connexion :

Bien entendu les paramètres sont à mettre à jours en fonction de votre environnement.

Ensuite on sélectionne product et on clique sur Create All Operations :

Comme on peut voir on va créer un Create/Read Item/Update/Delete/Read List, on est bien dans un model CRUD.

On va aussi sélectionner que quelque colonne comme datapicker afin que les colonnes techniques (foreign key, primary key etc…) ne viennent pas polluer ce qui sera affiché à l'utilisateur:

Les colonnes choisies sont Name, ProductNumber, Color, SafetyStockLevel, ReorderPoint, StandardCost, Size, Weight, SellStartDate et SellEndDate. On verifie bien entendu que l'identifier ProductID a la propriété Map To Identifier de cochée.

On ne va pas mettre de filtre maintenant, on clique sur Finish :

A droite on peut voir l'ensemble des fonctions crées.

On retourne sur AdventureWorks :

On va cliquer sur Create List and form, si un warning demandant d'enregistrer l'external content type apparait il suffit de l'enregistrer, on ne va pas créer les formulaires infopath.

Dans SharePoint notre external list existe :

Table Contact

On va refaire la même chose avec l'autre table et le type sera Contact, on recrée un External Content type :

On va créer les opérations en lecture :

 

 

 

Dans le wizard du read item on doit mapper les propriétés de la table a des propriétés offices :

On mappe Title avec Title, FirstName avec First Name, MiddleName avec Middle Name, LastName avec Last Name, EmailAddress avec Email 1 Address, Phone avec primary Telephone Number, suffix avec suffixe. On va aussi checker la propriété Show in Picker pour les colonnes qu'on a mappées.

Pour le ReadList on crée un filtre :

Qu'on limit a 1000 car le throttle ne permet que 2000 element d'etre retourné de la DB.

On crée la liste AdventureWorksContact:

 

Et voici le résultat :

Résultat

Penchons-nous sur ce que l'on a.

On a deux connecteurs sur table de base de données. Ces connecteurs affichent les données dans SharePoint et « donne » l'impression que les données sont dans SharePoint.

Si l'on va dans le Business Connectivity Services de Sharepoint au niveau de l'administration central on retrouve nos external content type :

Même si on ne l'a pas fait avec SharePoint Designer il est possible de créer des Default Action :

Cliquer sur Configure et mettez l'url par defaut du site qui va héberger le BCS :

Cliquez sur Create/Upgrade :

 

 

La page de profil par défaut :

 

On a aussi la possibilité de les indexer et de les inclure dans le moteur de recherche de SharePoint, dans les BDC nos deux external content type sont regroupés dans l'External System adventureWorks :

On peut indexer le LOB (Line Of Business) en créant une nouvelle content source dans SharePoint (Fast ou SharePoint) :

Au niveau des clients offices:

Outlook

Un VSTO est créé et envoyé au client pour installation :

Dans Outlook voilà le résultat pour les contacts.

Conclusion

Les choses sont simples et belles MAIS dans la vie de tous les jours c'est rarement aussi simple, que se passe-t-il maintenant si en plus des produits vous voulez la catégorie des produits et pouvoir les regrouper par catégories ? ou alors vous voulez les ventes ou les types de contacts etc…. c'est ce qu'on verra dans l'article suivant avec les associations

Catégorie: SharePoint 2010
Publié: 16/12/2011 08:37
]]> Xavier VANNESTE SharePoint 2010 Fri, 16 Dec 2011 07:37:13 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=89 [SharePoint 2010] BCS Partie 4: Visual Studio 2010 http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=99 Corps:

Série D'articles:

Introduction

J'ai beaucoup utilisé les BDC dans SharePoint 2007, il est clair que l'édition de fichiers XML était loin d'être la chose que j'appréciais le plus. Lorsque j'ai abordé les BCS avec SharePoint 2010 (pendant des BDC de SharePoint 2007) j'ai été ravi de voir qu'un éditeur BCS était présent dans Visual Studio. Puis ma joie a fait place à la déception. En effet il ne faut pas vous attendre à un éditeur qui fasse tout, il est là pour vous aider mais en aucune manière il est possible d'accéder au BCS sans connaitre le schéma BDCM. Par exemple l'éditeur de Visual Studio n'offre pas d'assistant directement vers SQL Server, ou une autre base de données ou même WCF. Tout doit être fait à la main.

 

L'application

L'application est simple, votre entreprise a fait le choix d'un ECM qui s'appelle RISE (ndlr : ce CMS est disponible dans la galerie Visual Studio).

Dans ce CMS pour l'administration de votre société certains documents ont été publiés. La demande est de créer un connecteur entre ce CMS et SharePoint. Vous avez donc la responsabilité de développer le connecteur.

Il peut être relativement aisé de développer une web part vers le CMS. Mais, on le verra à travers les différents articles, le fait de le faire par un BCS offrira beaucoup d'avantage non négligeable. On abordera aussi les limites de l'éditeur.

Création du projet

Dans Visual Studio on prendra le type de projet Business Data Connectivity Model :

Une fois le projet créé l'éditeur s'ouvre sur le model BDCM.

C'est ici qu'on va travailler le plus pour la configuration, pour le code on a deux class qui sont créés, Entity1 qui représente les données renvoyées, c'est entity1 qui représente le schéma du type de contenu, l'ensemble des champs de votre external content type correspondra à l'ensemble des propriétés de votre entité qui seront mappé dans le schéma BDCM. Ensuite on a Entity1Service qui représentes le chargement des données tous simplement.

On va commencer par donner des noms plus user friendly.

On va mettre RiseDocument à la place de « Entity1 » car on va remplir les entités en partant des tables Document et Content du CMS Rise.

La classe ainsi obtenue RiseDocument contiendra une propriété par champs pertinent de la table:

Voici le schéma des deux tables :

Voici le code de la classe RiseDocument

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

 

namespace BDCRiseCMS.BdcModel1

{

/// <summary>

/// This class contains the properties for Entity1. The properties keep the data for Entity1.

/// If you want to rename the class, don't forget to rename the entity in the model xml as well.

/// </summary>

public partial class RiseDocument

{

//TODO: Implement additional properties here. The property Message is just a sample how a property could look like.

public long DocID { get; set; }

public string MimeType { get; set; }

public string Title { get; set; }

public string Description { get; set; }

public string Langue { get; set; }

public string site { get; set; }

public byte[] Content { get; set; }

}

}

 

Voici le code de la classe RiseDocumentService

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.Data.SqlClient;

using System.Data;

 

namespace BDCRiseCMS.BdcModel1

{

/// <summary>

/// All the methods for retrieving, updating and deleting data are implemented in this class file.

/// The samples below show the finder and specific finder method for Entity1.

/// </summary>

public class RiseDocumentService

{

/// <summary>

/// This is a sample specific finder method for Entity1.

/// If you want to delete or rename the method think about changing the xml in the BDC model file as well.

/// </summary>

/// <param name="id"></param>

/// <returns>Entity1</returns>

///

 

 

private static SqlConnection getSQLConnection()

{

SqlConnection _cnData;

_cnData = new SqlConnection("Data Source=srvsql; Initial Catalog=CMSRise;User ID=SA; Password=P@ssw0rd;");

_cnData.Open();

return _cnData;

}

public static RiseDocument ReadItem(long docID)

{

RiseDocument rd = new RiseDocument();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT t_cms_u_Document.c_id, t_cms_u_Document.c_u_MimeType, " +

"t_cms_u_Document.c_u_Data, t_cms_u_Content.c_u_Title, t_cms_u_Content.c_u_Description, " +

"t_cms_u_Content.c_u_Language, t_cms_u_Site.c_u_Name " +

"FROM t_cms_u_Content INNER JOIN t_cms_u_Document ON t_cms_u_Content.c_id = t_cms_u_Document.c_r_Content " +

"INNER JOIN t_cms_u_Site ON t_cms_u_Content.c_r_Site = t_cms_u_Site.c_id where t_cms_u_Document.c_id=@docID";

cmdata.Parameters.AddWithValue("@docID", docID);

SqlDataReader drData = cmdata.ExecuteReader();

if (drData.Read())

{

rd.DocID = drData.GetInt64(0);

rd.MimeType = drData.GetString(1);

rd.Content = (byte[])drData.GetValue(2);

rd.Title = drData.GetString(3);

rd.Description = drData.GetString(4);

rd.Langue = drData.GetString(5);

rd.site = drData.GetString(6);

}

else

{

rd.DocID = -1;

rd.MimeType = "";

rd.Content = null;

rd.Title = "";

rd.Description = "";

rd.Langue = "";

rd.site = "";

 

}

 

 

}

}

return rd;

}

/// <summary>

/// This is a sample finder method for Entity1.

/// If you want to delete or rename the method think about changing the xml in the BDC model file as well.

/// </summary>

/// <returns>IEnumerable of Entities</returns>

public static IEnumerable<RiseDocument> ReadList()

{

List<RiseDocument> rds = new List<RiseDocument>();

using (SqlConnection cndata = getSQLConnection())

{

using (SqlCommand cmdata = new SqlCommand())

{

cmdata.Connection = cndata;

cmdata.CommandText = "SELECT t_cms_u_Document.c_id, t_cms_u_Document.c_u_MimeType, " +

"t_cms_u_Document.c_u_Data, t_cms_u_Content.c_u_Title, t_cms_u_Content.c_u_Description, " +

"t_cms_u_Content.c_u_Language, t_cms_u_Site.c_u_Name " +

"FROM t_cms_u_Content INNER JOIN t_cms_u_Document ON t_cms_u_Content.c_id = t_cms_u_Document.c_r_Content " +

"INNER JOIN t_cms_u_Site ON t_cms_u_Content.c_r_Site = t_cms_u_Site.c_id";

SqlDataReader drData = cmdata.ExecuteReader();

while (drData.Read())

{

RiseDocument rd = new RiseDocument();

rd.DocID = drData.GetInt64(0);

rd.MimeType = drData.GetString(1);

rd.Content = (byte[])drData.GetValue(2);

rd.Title = drData.GetString(3);

rd.Description = drData.GetString(4);

rd.Langue = drData.GetString(5);

rd.site = drData.GetString(6);

rds.Add(rd);

}

 

}

}

return rds;

}

 

}

}

 

On va changer aussi le nom ET le type de l'identifier de notre entity RiseDocument :

Le BDC Explorer

Lorsque le model BCS est ouvert (et uniquement dans ce cas) une fenêtre apparait, le BDC Explorer :

Il peut être très pratique de mettre la fenêtre des propriétés en dessous du BDC Explorer, il sera ainsi plus facile de travailler avec les type descriptor, On renomme le model pour avoir des noms plus simple :

Pour cela on va utiliser la fenêtre des propriétés pour renommer les model.

Pour la methode ReadItem() :

On renomme l'identifier1 en DocID et les entités en dessous de returnparameter pour coller EXACTEMENT a ce que contient la classe RiseDocument, On ajoute des propriétés (ou type descriptor dans le cas du BDCExplorer) en faisant un clique avec le bouton droit et Add Type Descriptor :

Voici a quoi correspond notre entité :

Il faut bien paramétrer les TypeDescriptor (Nom et Type).

Une fois la partie ReadItem faites on va copier/coller l'entité DocRise en dessous de DocRiseList :

Voici le résultat final :

Quand on a terminé on lance le débuggueur, si vous avez mis des points d'arrêt dans le code ils apparaitront sur la page de profil.

Voici ce qu'on a dans la service application Business Data Service :

On retrouve RiseDocument, on va créer la page de profile en cochant la case à côté de RiseDocument et en cliquen sur Create/Upgrade :

On clique sur OK

Ensuite on va sur la page de profil en remplaçant {0} dans l'url par l'ID de la DB qu'on souhaite voir, ici 2 :

Catégorie: SharePoint 2010
Publié: 18/01/2012 17:39
]]> Xavier VANNESTE SharePoint 2010 Wed, 18 Jan 2012 16:39:57 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=99 [Fast Search for SharePoint] Récupérer les Visual Best Bet et les Best Bet avec Keyword Query et Fast Search http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=97 Corps:

Source : http://techmikael.blogspot.com/2011/12/returning-best-bets-and-visual-best.html

 

Quand vous utilisez les Best Bet ou Visual Best Bet dans le centre de rechercher SharePoint, celle-ci fonctionne parfaitement, cependant il est difficile de les faire fonctionner avec la classe de l'api KeywordQuery de SharePoint.

J'avais fait quelques recherches, après avoir été contacté par Xavier VANNESTE qui a blogué à propos de cette difficulté (http://blog.xvanneste.com/Lists/Billets/Post.aspx?ID=82 ), mais je n'avais pas été en mesure de résoudre cette issue à ce moment-là.

Etant actuellement en train d'écrire un livre sur FS4SP, j'ai dû me résoudre à trouver une solution. Le temps de sortir les outils!

Une heure plus tard après avoir utilisé le plugin Reflector pour Visual Studio a mettre des points d'arrêt dans le code des Search Service Application et j'ai compris. Et dans un sens, la solution fût évidente.

Tous les paramètres de mot clé avec FAST nécessitent un Search Setting Group et vous aurez un groupe pour chaque collection de sites dans votre batterie de serveurs SharePoint. L'ID du groupe de paramètre de recherche est le GUID de la collection de sites. Et cet ID est la solution.

 

KeywordQuery a une propriété nommée " UserContextGroupID ", et le MSDN déclare:

Obtient ou définit l'identifiant utilisé pour le groupe de mots clé correspondant au best bets et visual best bets.

En attribuant la propriété UserContextGroupID et en demandant de récupérer les SpecialTermResults cela fonctionne parfaitement.

 

Voici un petit exemple qui retourne les visual best bet attribué au terme «FAST Search for SharePoint" :

var searchProxy = (SearchServiceApplicationProxy)SearchServiceApplicationProxy.GetProxy(SPServiceContext.Current);

KeywordQuery kq = new KeywordQuery(searchProxy);

kq.QueryText = "FAST Search for SharePoint";

kq.ResultsProvider = SearchProvider.FASTSearch;

// specify best bets/visual best bets

kq.ResultTypes = ResultType.SpecialTermResults;

// specify the Search Settings Group ID

kq.UserContextGroupID = SPContext.Current.Site.ID.ToString();

ResultTableCollection resultTableCollection = kq.Execute();

ResultTable visualBestBetsTable = resultTableCollection[ResultType.VisualBestBetsResults];

foreach (DataRow row in visualBestBetsTable.Table.Rows)

{

string name = (string)row["Name"];

string uri = (string)row["Uri"];

string description = (string)row["Description"];

string keyword = (string)row["Keyword"];

string teaser = (string)row["Teaser"];

string contentType = (string)row["TeaserContentType"];

}

Article traduit avec l'accord de Mikael Svenson.

Catégorie: Fast Search for SharePoint
Publié: 19/12/2011 17:22
]]> Xavier VANNESTE Fast Search for SharePoint Mon, 19 Dec 2011 16:22:34 GMT http://blog.xvanneste.com/Lists/Billets/ViewPost.aspx?ID=97