Outils
Navigateur de nœuds
Pour renseigner les fichiers .csv des imports (cf. partie précédente), et notamment le chemin du dossier où seront importées les données, il est possible d'utiliser le navigateur de nœuds.
Il y a deux cas de figure :
La cible est une entité (par exemple, si vous voulez importer les nutriments d'un produit), auquel cas le NodeRef nécessaire au navigateur de nœuds est visible dans la barre d'adresses.
La cible est un dossier (par exemple, pour importer des matières premières dans un dossier d'un site particulier)
Dans ce deuxième cas, l'astuce pour récupérer le NodeRef de ce dossier est de lancer la création d'un nouveau produit en son sein.
Une fois sur la page de création du produit, le NodeRef du dossier est visible dans la barre d'adresses.
Pour la suite de cette partie, nous supposerons que l'import des données se fera sur une entité existante.
Aller dans l'URL de la liste devant être complétée et copier le NodeRef.
Aller ensuite dans beCPG> Outils d'Administration> Navigateur de nœuds. Cliquer sur "fts-alfresco" et choisir "noderef". Coller le noderef obtenu dans l'URL dans l'encart blanc et appuyer sur "Rechercher". Vous aller ensuite pouvoir naviguer dans les "enfants" et trouver les termes associés à chaque liste/entité pour écrire le "PATH".
Exemple: import de la liste déroulante "Sponsors" d'un projet
1. Copier le NodeRef
Pour cela, aller dans beCPG> beCPG Administration> Listes Projet> Sponsors
2. Chercher le "PATH" dans le navigateur de nœuds
Aller en bas de la page et cliquer sur le lien "entitylist" de la rubrique "Fils". Une fois sur la nouvelle page, descendez en bas de la page et dans la rubrique "Fils" chercher "Sponsors" puis cliquer sur le lien associé.
Vous arrivez alors à cette page sur laquelle se trouve le "PATH":
- Compléter le PATH dans le fichier .CSV
Le PATH copié doit être réduit pour les imports:
- La partie "app:company_home" peut être omise
- De même, tous les "cm:" peuvent être retirés, cependant les autres préfixes comme bcpg: doivent rester.
PATH: /System/ProjectLists/bcpg:entityLists/Sponsors
Identification du nom des champs dans l'interface
Identification des noms de propriétés
Il y a plusieurs méthodes pour connaître le nom des propriétés. Deux d'entre elles sont:
- La méthode par l'édition multiple.
- La méthode par l'outil de développement du navigateur
Voyons maintenant chacune d'entre elles.
Méthode par Édition multiple
L'édition multiple permet d'avoir accès aux champs des propriétés, d'un type de produit. Pour y avoir accès :
- Placez-vous dans le dossier contenant les produits.
- Cliquez sur le bouton Edition multiple (flèche rouge).
Sur l'interface d'édition multiple, cliquer sur le bouton Type applicable aux contenus (flèche rouge).
Puis, dans la liste déroulante, sélectionnez un type de produit. Dans notre cas, Produit semi fini (encadré en vert).
Cochez ensuite les propriétés que vous voulez importer.
Puis cliquez sur le bouton afficher (flèche rouge).
- Cliquez sur Exporter pour téléchergez l'export excel des résultats (flèche verte).
- Ouvrez le fichier excel téléchargé.
Vous trouverez les noms des propriétés d'une entité au dessus des intitulés de champs (ici ligne 2).
Remarque: Les premières lignes du fichier Excel sont par défaut réduites,pensez à les ouvrir.
Utiliser l'inspecteur
La méthode par l'édition multiple est à privilégier, car plus simple. Mais il arrive parfois, suite à certaines configuration du système, que certain champs d'une entité (Produit Fini, etc) ne soient pas accessible via l'édition multiple. Il est alors possible de trouver le nom des champs interne, via l'outil de développement du navigateur.
Procédure
Prenons l'exemple du champs Commentaires placé sur le Produit Fini.
- 1. Placez vous sur la section Propriétés du Produit Fini (encadré vert) puis cliquer sur Éditer les propriétés (cf: Encadré rouge)
- 2. Une fois sur la page d'édition de propriétés, faire un clique droit sur le label Commentaires (encadré vert), puis sélectionner l'option Inspecter dans la pop-up (Encadré rouge).
- 3. L'outils de développement apparaît suite à l'étape 2. La présentation de l'outil de développement peut changer selon votre navigateur mais le principe est le même. Vous aurez en surbrillance le bloc de texte correspondant à l'élément sur lequel vous avez cliqué. (Encadré vert).
- 4. Toujours au niveau du bloc de texte en surbrillance, c'est l'attribut for qui contient le nom interne de la propriété "Commentaires", productComments (Encadré rouge).
Identification du nom des champs d'une liste
beCPG permet d'exporter en excel, directement via l'interface des listes.
Placez-vous dans la liste à exporter, par exemple, cliquez sur la liste Composition (encadré vert).
Cliquez ensuite sur le bouton Exporter (flèche rouge).
- Ouvrez le fichier Excel téléchargé.
À la ligne 2, du fichier Excel, vous avez accès aux noms des champs.
Construction de requêtes Lucène
Alfresco permet de faire des requêtes Lucène sur:
- Le NodeRef (id)
- Le Type
- Les Propriétés
- Les Aspects
- Et les mot clés
Pour faire une requête , la syntaxe est la suivante :
- sur un Type : TYPE:"TypeQName" Exemple: TYPE:\"bcpg:client\"
PS: Le back-slash sont rajoutés pour éviter les guillemets doubles, au niveau du connecteur.
- sur une Propriété :
QNamePropriété\: "Valeur" *_Exemple_*:
cm\\:name\:"sup"
PS: L'étoile veut dire , n'importe quelle chaine de caractères. Dans le cas ci-dessus, la propriété name doit-être composé du mot ''sup'.
- sur un Aspect: ASPECT:"AspectQName"\ Exemple: ASPECT:"bcpg:erpCodeAspect"
Les conditions peuvent être combinées grâce aux opérateurs lucène :
- ET: AND
- OU: OR
- NON: NOT
Exemples de requêtes
- Récupérer la liste des semi-fini ayant un nom composé avec "sauce":
*TYPE:"bcpg\\\\:semiFinishedProduct"*@cm\\\\:name:"**sauce**"
- Récupérer les derniers produits fini validés, depuis le dernier export\
*TYPE:"bcpg\\\\:finishedProduct"*`bcpg\\:productState:"Valid" AND (`cm\\\\:created:\[%s
TO MAX\] OR @cm\\\\:modified:\[%s TO MAX\])
Documentation alfresco:
http://docs.alfresco.com/5.0/concepts/rm-searchsyntax-intro.html