Comment rechercher avec Alfresco avec Lucene et xPath ?

1. Quelle est
cette fleur ?
Recherche Tutorial

2. Il s’agit
d’Alfresco !

3. Une solution
ECM Open Source

4. Le problème ?

5. Personnes curieuses
de connaître Alfresco...

6. Avec beaucoup de
questions… (A formuler…)

7. Une solution possible

8. Simple présentateur de
présentations sur Alfresco...

9. Avec quelques réponses…
(A vérifier)

10. Allons-y !

11. Mais avant un rappel !

12. Un principe…
Tout est nœud !
(Everything is NODE!)
Quel beau nœud
je suis!

13. Une règle…
Alfresco fournit des
services pour gérer
Des noeuds
Eh oui… Même moi
j’ai un patron…

14. Maintenant Allons-y !

15. J’ai cru comprendre qu’il existe
plusieurs langages
de recherches possibles…

16. Effectivement!
Petit tour d’horizon…

17. Lucene
XPath

18. Lucene en premier!

19. Lucene ?
• Apache Lucene is a high-
performance, full-featured text
search engine library written
entirely in Java.
• Although Lucene provides the
ability to create your own queries
through its API, it also provides a
rich query language through the
Query Parser, a lexer which
interprets a string into a Lucene
Query using JavaCC.
• Source: Lucene.org

20. Et dans Alfresco…
Comment cela fonctionne ?

21. Pour résumé…

22. 1. La collecte
Type
Aspect
Propriétés
Mot clés
ID

23. 2. La conservation
ID
As
pec
Type
t
Proprié
tés
Mot clés

24. 3. L’utilisation
tés
Proprié
Mot clés
Aspect

25. Pour aller plus loin…

26. Lors de la création d’un nœud,
il y a
• Une indexation de
l’ensemble des
propriétés de l’élément
&
• Une indexation plein
texte du contenu
associé

27. Lors de la création d’un nœud,
il y a
• Une indexation plein
texte du contenu
associé si le contenu
est au format :
– Office (Open ou Microsoft)
– XML/HTML
– PDF
– Emails
– Texte

28. Pour le vérifier…

29. Il faut consulter le modèle de
données !
Fichier : contentModel.xml

30. Mais quel est le
principe de la
« tokenisation » ?
Fichier : contentModel.xml

31. Il s’agit de découper
(ou non) un (des)
mot(s) en plusieurs
mots clés.

32. Prenons une
phrase comme
exemple
Il s’agit d’une présentation PowerPoint
sur Alfresco et la recherche.

33. Si on n’effectue pas
de segmentation
(tokenised)…
u
t en
C onIl s’agit d’une présentation PowerPoint
sur Alfresco et la recherche.

34. On effectue une copie
conforme de la
phrase dans l’index.
u
t en
C onIl s’agit d’une présentation PowerPoint
sur Alfresco et la recherche.
D EX
IN Il s’agit d’une présentation PowerPoint
sur Alfresco et la recherche.

35. Pour rechercher, il
faudra donc connaître
la phrase entière !
u
t en
C onIl s’agit d’une présentation PowerPoint
sur Alfresco et la recherche.
D EX
IN Il s’agit d’une présentation PowerPoint
sur Alfresco et la recherche.

36. Par contre si on
effectue une
segmentation…
u
t en
C onIl s’agit d’une présentation PowerPoint
sur Alfresco et la recherche.

37. On ne prend que les
mots clés de la
phrase!
u
t en
C onIl s’agit d’une présentation PowerPoint
sur Alfresco et la recherche.
D EX
IN Présentation, PowerPoint,
Alfresco, recherche

38. Donc n’oubliez pas de
vérifier le modèle de
données !

40. OK…
Démonstrations!

41. Un peu
de
théorie

42. Lucene dans Alfresco permet
de faire des requêtes sur…
• Le NodeRef (ID)
• Le Type
D’un NŒUD!
• Les Propriétés
• Les Aspects Vous travaillez pour
les services secrets ?
• Les Mot Clés
(Contenu)

43. Les
Requêt
es

44. Pour faire une requête sur
le Noderef
ID:quot; <Mon NodeRef> quot;
L’utilité de rechercher un
nœud dont on sait déjà qui
il est ?

45. Pour faire une requête sur
le Type
TYPE:quot; <TypeQName> quot;
J’espère que vous vous
rappelez du QName…
Sinon c’est par ici

46. Pour faire une requête sur
une propriété
@<QNamePropriété>:quot; Valeur quot;
Pourquoi c’est pas pareil
que les autres??
Pourquoi c’est pas en
majuscules ?

47. Pour faire une requête sur
un Aspect
ASPECT:quot; <AspectQName> quot;
AAhh! La c’est mieux!

48. Pour faire une requête sur
un mot clé du contenu d’un
noeud
TEXT:<valeur>
Bon ok… j’ai compris le
principe!
On commence à
s’ennuyer la…

49. Mise en
conditi
on

50. Voici notre
terrain

51. Mise en
Pratiqu
e

52. Remarque
Lucene et Alfresco!
Suivant la version que vous possédez
d’Alfresco, il se peut que les résultats
que vous obteniez soit totalement
différents des miens.
C’est aussi ça la magie de la recherche!

53. Comment faire simplement
une requête lucene
Se connecter avec le rôle
« admin » à Alfresco
Cliquer sur
Puis choisir navigateur de
noeuds

54. Comment faire simplement
une requête lucene
Choisir le store :
workspace://SpacesStore
Dans la liste déroulante,
choisir Lucene

55. Prêt ?

56. Je veux
le « Folder Test »

58. Je veux
le « Folder Test »!!!!!
@cm:name:’’Folder Test’’

59. Résultat

60. Un rappel !

61. Pour identifier et rendre unique
un nœud dans un store, on
utilise …
Un
UUID

62. La concaténation du protocole,
du nom du store et de l’UUID
d’un nœud forme
Un
NodeRef

63. Dans notre cas
NodeRef UUID

64. Je veux le
« Foder Test » mais
avec l’UUID
ID:quot;workspace://SpacesStore/
b7ecc8b1-5edb-11dd-
afdd-79a008cbb404quot;

66. Et si on veut plusieurs critères
à notre recherche ?

67. On peut rajouter des
opérateurs !

68. Les Opérateurs
+
Pour ajouter un critère validé
-
Pour ajouter un critère non validé
AND
Pour ajouter un critère
OR
Pour ajouter un choix entre critères
NOT
Pour exclure un critère

69. Je veux tous les espaces
avec le nom « space »
TYPE:quot;cm:folderquot; AND @cm:name:quot;Spacequot;
TYPE:quot;cm:folderquot; +@cm:name:quot;Spacequot;
+TYPE:quot;cm:folderquot; AND @cm:name:quot;Spacequot;

70. Résultat

71. Remarque
FOLDER ≈ ESPACE
Folder représente un type de nœud.
Space est la traduction littérale anglaise
d’un folder.
Espace est la traduction littérale du
Space anglais.

72. Ajout d’une catégorie
à un espace
Mise en
conditi
on

73. Je veux tous les folders avec le
nom « space » et qui posséde
une catégorie
TYPE:quot;cm:folderquot;
AND @cm:name:quot;Spacequot;
AND ASPECT:quot;cm:generalclassifiablequot;

74. Je veux tous les espaces avec le
nom « space » et qui
NE posséde PAS une catégorie
TYPE:quot;cm:folderquot;
AND @cm:name:quot;Spacequot;
AND NOT ASPECT:quot;cm:generalclassifiablequot;
TYPE:quot;cm:folderquot;
+@cm:name:quot;Spacequot;
-ASPECT:quot;cm:generalclassifiablequot;

75. Résultat

76. Remarque
Cette zone est
expérimentale et est très
aléatoire suivant les
expériences !

77. Il existe des opérateurs
spéciaux pour la recherche !

78. Les opérateurs spéciaux
?
Peut remplacer un caractère
*
Peut remplacer plusieurs
caractères

79. Je veux tous les espaces avec le
nom commençant par « spa »
TYPE:quot;cm:folderquot;
AND @cm:name:quot;Spa*quot;
TYPE:quot;cm:folderquot;
+@cm:name:quot;Spa*quot;

80. Je veux tous les espaces avec le
nom terminant par « ace »
TYPE:quot;cm:folderquot;
AND @cm:name:quot;*acequot;
TYPE:quot;cm:folderquot;
+@cm:name:quot;*acequot;

81. Remarque
FIN DE
ZONE EN CHANTIER!
Cette zone était
expérimentale!

82. Pour en savoir plus
Lucene WebSite
• http://lucene.apache.org/
• http://lucene.apache.org/java/docs/queryparsersyntax.html
Alfresco Wiki
• http://wiki.alfresco.com/wiki/Search#Lucene
• http://wiki.alfresco.com/wiki/Lucene
• http://wiki.alfresco.com/wiki/Lucene_Extensions_and_Issues

83. Maintenant XPath!

84. XPath ?
• XPath is a language for
addressing parts of an XML
document, designed to be
used by both XSLT and
XPointer.
• Source w3c.org

85. Mais on parle de nœuds…
Pas de xml…

86. En effet mais…

87. Un principe…
Un nœud
peut être vu comme
Un XML
J’ai une drôle de
Mirroir
tête moi…
XML

88. La preuve dans Alfresco…

89. ACP
WebApp

90. ACP
Explorateur

91. Donc avec XPath, on peut
naviguer dans les nœuds…

92. Effectivement !
Démonstrations..

93. Un peu
de
théorie

94. XPath dans Alfresco permet
de faire des requêtes sur…
• Le Type
• Les Propriétés
D’un NŒUD!
• Les Aspects
• Les associations Pourquoi toujours
moi…

95. Les
Axes

96. Vous savez jouer au
jeu des 7 familles ?
Eh bien les axes XPath
c’est pareil!

97. Dans la famille Nœud,
je voudrais moi !
self

98. Ensuite
mon Père!
parent

99. Ensuite mes
enfants!
Child

100. Ensuite mes
frères ainés
preceding-sibling

101. Ensuite mes
soeurs cadettes
following-sibling

102. Maintenant, allons plus
loin dans ma famille!

103. Je veux connaître toute
ma descendance !
descendant

104. Je veux connaître tous
mes ancêtres
ancestor

105. Je veux tous les
nœuds plus âgés
preceding

106. Je veux tous les
nœuds plus jeunes
following

107. Hein… Elle est belle
ma famille?

108. Malheureusement, toute
la famille n’est pas
visible avec Alfresco…
following following-sibling
preceding-sibling preceding

109. Les
Requêt
es

110. Pour faire une requête sur
un axe
Axe::*
En gros, Je veux tous les
nœuds de cet axe!

111. Pour faire une requête sur
une propriété
Axe::*[@<QName>:’<Valeur>’]
Ca me rappelle un peu
Lucene…

112. Pour faire une requête sur
un aspect
Axe::*[hasAspect(’<QNameAspect>’)]
L’aspect ne fait pas le
nœud… Drôle non ?

113. Pour faire une requête sur
un type
Axe::*[subtypeOf(’<QNameType>’)]
Attention ! Il s’agit du type
et des types fils!!!

114. Pour faire une requête sur
l’ensemble des propriétés
et du contenu…
Axe::*[contains(’<Valeur>’)]
Utile, n’est il pas ?

115. Mise en
conditi
on

116. Voici notre
terrain

117. Mise en
Pratiqu
e

118. Comment faire simplement
une requête lucene
Se connecter avec le rôle
« admin » à Alfresco
Cliquer sur
Puis choisir navigateur de
noeuds

119. Comment faire simplement
une requête lucene
Choisir le store :
workspace://SpacesStore
Dans la liste déroulante,
choisir selectNodes

120. Pourquoi est ce que l’on ne
prend pas XPath ??

121. C’est la même chose!
Sauf que …

122. XPath :
Absolue par
rapport à la
SelectNodes : racine du store
Relatif au nœud
en cours

123. Or nous on veut se placer
dans un folder spécifique!

124. Prêt ?

125. Je veux
le nœud en cours
self::*

126. Résultat

127. Je veux
les fils du nœud en cours
descendant::*

128. Je veux
le père du nœud en cours
parent::*

129. Je veux
le fils qui posséde une description
« Space 1.1 Description »
descendant::*[@cm:description
='Space 1.1 Description']

130. A noter que les opérateurs sont
aussi disponibles en XPath…

131. Je veux
le fils qui possède une description « Space 1.1
Description » et qui soit de type folder
descendant::*[@cm:description
='Space 1.1 Description' and
subtypeOf('cm:folder')]

132. Je veux
le fils qui possède l’aspect lié aux catégories et
qui soit de type folder
descendant::*[hasAspect('cm:genera
lclassifiable') and
subtypeOf('cm:folder')]

133. Pour en savoir plus
• Wikipedia [FR]
• W3Schools[ENG]
• Spécifications W3C : Xpath 1.0[ENG]
• Spécifications W3C : XPath 2.0[ENG]
• Developpez.com (A voir!)

134. J’ai maintenant plein de nœuds!
Mais Où est Charlie...
Enfin… le bon nœud ?

135. Si vous cherchez un nœud,
utilisez les services…

136. En premier, pensez
Alfreso Service Registry !

137. Et faites appel à …
AttributeService
MultilangualContentService AuditService
ScriptService
ActionService
AuthorityService AuthenticationService SearchService
RuleService
NodeService TemplateService
AVMService
CopyService
LockService CategoryService
CheckOutCheckInService
FileFolderService
ContentService
MimeTypeService
EditionService
DictionnaryService
WorkflowService ImporterService
ExporterService
VersionService TransactionService

138. Et faites appel à …
AttributeService
MultilangualContentService AuditService
ScriptService
ActionService
AuthorityService AuthenticationService SearchService
RuleService
NodeService TemplateService
AVMService
CopyService
LockService CategoryService
CheckOutCheckInService
FileFolderService
ContentService
MimeTypeService
EditionService
DictionnaryService
WorkflowService ImporterService
ExporterService
VersionService TransactionService

139. Ou encore…
AttributeService
MultilangualContentService AuditService
ScriptService
ActionService
AuthorityService AuthenticationService SearchService
RuleService
NodeService TemplateService
AVMService
CopyService
LockService CategoryService
CheckOutCheckInService
FileFolderService
ContentService
MimeTypeService
EditionService
DictionnaryService
WorkflowService ImporterService
ExporterService
VersionService TransactionService

141. Voilà!
C’est fini pour aujourd’hui!

142. Maintenant à vous de
chercher… Ou rechercher!

143. Des questions ???

144. Pour une prochaine fois…

145. Dans les prochains
épisodes…

146. Et si je veux partager mes
nœuds ?

147. Il faudra utiliser les
protocoles…

148. Pour découvrir…

149. Pour aller de
l’avant…

150. Et pour atteindre
ces objectifs…

151. Choisissez l’ECM
Open Source

152. Alfresco en
quelques points…
Par JM.PASCAL
www.opensourceecm.fr
&
www.open-source-ecm.com