Comparaison des versions

Ancienne version 2

changes.mady.by.user Luc Grondin

Sauvegardée le

comparé à

Nouvelle version 3

changes.mady.by.user Luc Grondin

Sauvegardée le

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

...

Le Service des ressources permet d’exposer l’ensemble des valeurs possibles pour 6 des 7 paramètres proposés par le Service de recherche d’identifiant pérenne.

ServiceRequête : URIRequête : paramètres

Réponse : champs pour chaque élément

Code SAD de toutes les facultésressource/faculte

uniterech : identifiant de l'unité de recherche (optionnel, multiple)

codeSad, nom
Code SAD de tous les départementsressource/departementuniterech : identifiant de l'unité de recherche (optionnel, multiple)codeSad, nom
Code SAD de tous les titres de fonctionressource/fonction---codeSad, nomM, nomF
Numéro SAD de tous les programmesressource/programme---noSad, nom
Identifiant de tous les domaines d'étudesressource/domaineetude---id, nom
Nom de tous les champs d'expertise de rechercheressource/expertiserech

departement : code SAD de département (optionnel, multiple)

faculte : code SAD de faculté (optionnel, simple)

(avertissement) au moins l'un de ces deux paramètres est requis.

fonction : code SAD de fonction (optionnel, multiple)

  • nom
  • volet
  • nomTraduction
    • codeLangue
    • nom
  • nbIndividus (sauf mots-clés)

(ci-dessous mots-clés seulement)

  • departement
    • departementCodeSad
    • departementNom
    • nbIndividus
  • faculte
    • faculteCodeSad
    • faculteNom
    • nbIndividus


Code et nom des langues parlées et écritesressource/langue---
  • id
  • code
  • oral (true|false)
  • ecrit (true|false)
  • noms
    • codeLangue
    • nom
Disciplinesressource/discipline---
Nom des établissements affiliés à l'UdeMressource/
ettbaffilie
etablaffilie---
Nom des secteurs de rechercheressource/
secteur_recherche
secteurrech---


Remarque

Règles d'affaire de l'exposition de l'expertise de recherche

Il n'est pas possible d'obtenir l'exposition globale de l'expertise, pour toutes les facultés et tous les départements confondus. Il faut préciser une (et une seule) faculté ou un ou des départements. On peut préciser une faculté ET un département, mais le département doit faire partie de la faculté indiquée. Dans ce cas, le fait d'inclure la faculté est inutile car le service retourne alors les mots-clés associés au département (et non tous les mots-clés utilisés par l'ensemble des départements de la faculté). Le service permet l'exposition de l'expertise conjointe de plusieurs départements. Toutefois, ceux-ci doivent tous faire partie de la même faculté.

...

Ancre
idunite
idunite
Service de recherche d’identifiant(s) pérenne(s) (idsadvr)

ServiceRequête : URIRequête : paramètres

Réponse : champs pour chaque élément

Identifiants pérennes de tous les individus/id/individu

uniterech : IDSADVR de unité de recherche (optionnel, multiple)

faculte : code SAD de faculté (optionnel, multiple)

departement : code SAD de département (optionnel, multiple)

fonction : code SAD de fonction (optionnel, multiple)

programme : code SAD de programme (optionnel, multiple)

domaineEtude : ID du domaine d'étude (optionnel, multiple)

expertiseRech : nom de l'expertise de recherche (optionnel, multiple)

  • idsadvr
  • prenom
  • nom
  • titreFonction
  • uniteAdmin
  • courriel
  • etablissementsAffilies
  • visuelOfficiel


Identifiants pérennes des unités de recherche/id/uniterech

faculte : code SAD de faculté (optionnel, multiple)

departement : code SAD de département (optionnel, multiple)

  • idsavr
  • nom
  • acronyme
  • responsable
    • id
    • nom
    • prenom
    • courriel
    • fonction
    • fonctionCodeSAD
    • uniteAdmin
    • fonctionResp
  • visuelOfficiel

  • unitesRattachement

    • departements
    • facultes
  • expertise
    • secteursRecherche
    • disciplines
    • motsCles
    • pays
    • continents
    • periodesChronologiques

Exemples de routes

...

Ancre
idext
idext
Service de recherche d’identifiants pérennes étendu pour les individus

ServiceRequête : URIRequête : paramètres

Réponse

Identifiants pérennes de tous les individus/idext/individu

uniterech : IDSADVR de unité de recherche (optionnel, multiple)

faculte : code SAD de faculté (optionnel, multiple)

departement : code SAD de département (optionnel, multiple)

fonction : code SAD de fonction (optionnel, multiple)

programme : code SAD de programme (optionnel, multiple)

domaineEtude : ID du domaine d'étude (optionnel, multiple)

expertiseRech : nom de l'expertise de recherche (optionnel, multiple)

  • idsadvr
  • prenom
  • nom
  • affiliations
  • courriels
  • téléphones
  • etablissementsAffilies
  • visuelOfficiel
  • expertise
  • urlVitrine
  • recrutementRecherche

(ci-dessus, premier niveau seulement; voir exemple de réponse pour détails)

 

Exemples de routes

...

Service de récupération de données par le biais d’un identifiant pérenne (idsadvr) 

ServiceRequête : URIRequête : paramètres

Réponse

Informations sur un individu/info/individuidsadvr : IDSADVR (obligatoire, multiple)(voir exemple de réponse pour détails)
Informations sur une unité de recherche/info/uniterechidsadvr : IDSADVR (obligatoire, multiple )(voir exemple de réponse pour détails)

Exemples de routes

...

Présentement, le contenu de trois "vitrines" est repérable via l'API. Il s'agit de la "Vitrine des professeurs", la "Vitrine des unités de recherche" et le "Répertoire des experts à l'intention des médias". Plus tard s'ajouteront la "Vitrine des bâtisseurs" et celle des prix. Chaque vitrine fait l'objet d'une route propre en ce qui concerne le service de repérage.

ServiceRoute
Recherche dans la Vitrine des professeurs/recherche/professeur/select
Recherche dans la Vitrine des unités de recherche/recherche/uniterech/select
Recherche dans le Répertoire des experts à l'intention des médias/recherche/expertmedia/select

Syntaxe de requête de recherche SOLR

Dans le cadre du repérage dans la Vitrine-Recherche via l'API, une requête SOLR comporte habituellement 5 paramètres.

ParamètreUsageExemples
qRequête textuelle comme telle. Ce paramètre est obligatoire et permet de spécifier les termes et champs de recherche. Le nom d'un champ est suivi du caractère ":". On utilise les guillemets ASCII pour délimiter une experssion exacte. Les espaces sont remplacés par des "+".q=ID:* (repérer tous les objets)
q=Texte:Intelligence+artificielle+AND+Faculte_fac:"Faculté+de+droit"
sort +asc/+desc

Préciser le tri des résultats. Par défaut, le tri s'effectue selon la pertinence telle qu'évaluée par SOLR. On utilise ce paramètre pour choisir un champ de tri particulier. On précise la direction du tri avec asc ou desc.

(avertissement) Ce paramètre n'est présentement pas fonctionnel du côté de l'API : le tri effectué par SOLR est perdu lors du formatage des résultats du côté de l'API.

sort=ChercheurNP_tri+asc (trier par nom de professeur, de A à Z)
start / rowsLes résultats de SOLR sont paginés. Le paramètre start désigne la position du pointeur au début de la page. Quant à rows, il indique le nombre de résultats par page.

start=0&rows=10 (les 10 premiers résultats)
start=10&rows=10 (les 10 résultats de la deuxième page)
start=20&rows=10 (les 10 résultats de la troisième page)

q.opPour préciser l'opérateur booléen s'appliquant entre les mots spécifiés dans la requête q. En l'absence de ce paramètret, c'est le ET (AND) qui s'applique.q.op=AND&q=Texte:intelligence+artificielle (on cherche "intelligence" ET "artificielle")
q.op=OR&q=Texte:intelligence+cognition (on cherche "intelligence" OU "cognition")

 

Exemple d'une requête complète correspondant à la recherche simple dans l'interface de la Vitrine-Recherche illustrée ci-dessous.

...

Critères et tri

Professeurs

TypeChamp SOLRLibellé / fonction
Critère, par motsTextePour la recherche simple (tous les champs)
Critère, par expression exacteSecteur_facSecteur de recherche
Critère, par expression exacteDiscipline_facDiscipline
Critère, par expression exacteObjetsRech_facExpertise par mot-clé
Critère, par expression exacteFaculte_facFaculté
Critère, par expression exacteUniteRech_facUnité de recherche
Critère, par expression exacteChercheurNP_facNom du professeur
Tri

ChercheurNP_tri

Nom
TriExpertise_triExpertise
TriUniteAdmin_triFaculté d'attache

Unités de recherche

TypeChamp SOLRLibellé / fonction
Critère, par motsTextePour la recherche simple (tous les champs) : n'est pas utilisé actuellement
Critère, par expression exacteSecteur_facSecteur de recherche
Critère, par expression exacte
UniteAdmin_fac
Faculté
Critère, par expression exacte
EtablAffil_fac
Établissement affilié à l'UdeM
Critère, par mots
ActiviteRech_idx
Activité de recherche
Critère, par expression exacte
ChercheurNP_fac
Responsable
Critère, par expression exacte
TypeUniteRech_fac
Catégorie d'unité de recherche
Critère, par expression exacteUniteRech_facNom de l'unité de recherche
Tri
UniteRech_tri
Nom
Tri
ChercheurNP_tri
Responsable
Tri
Secteur_tri
Secteur de recherche

Experts

TypeChamp SOLRLibellé / fonction
Critère, par motsTextePour la recherche simple et option "tous les champs" de la recherche par critère
Critère, par expression exacteDiscipline_facDiscipline
Critère, par expression exacteObjetsRech_facExpertise par mot-clé
Critère, par expression exacteLangueEcrite_facLangue (oral)
Critère, par expression exacteLangueParlee_facLangue (écrite)
Critère, par expression exacte
Media_fac
Média privilégié
Critère, par expression exacteChercheurNP_facNom de l'expert
Tri

ChercheurNP_tri

Nom
TriExpertise_triExpertise
TriUniteAdmin_triFaculté d'attache

Réponse

La réponse retournée par l'API REST du SADVR contient deux blocs. Le premier contient les informations relatifs à la pagination des résultats (paginationSOLR) et le second (data) contient la liste des résultats.

...