...
La requête possède ensuite un URI (Uniform Resource Identifier) ou route. Comme son nom l'indique, elle identifie ce qu'on veut chercher par une adresse unique (ex: recherche d'individus : https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/individu)
La requête peut aussi posséder des paramètres, qui dans le cas de la requête GET sont ajoutés à la suite de l'URI, pour préciser la requête (ex: recherche de professeurs titulaires de certaines facultés données : https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/individu?fonction=42001&faculte[0]=01&faculte[1]=28)
...
Pour obtenir la liste de principaux changements effectuées d'une version à l'autre de l'API, voir la page de recension des changements : API REST - Changements par rapport aux versions antérieures.
Service d'exposition des ressources
...
Service | Requête : URI | Requête : paramètres | Réponse : champs pour chaque élément |
---|---|---|---|
Code SAD de toutes les facultés | ressource/faculte | uniterech : identifiant de l'unité de recherche (optionnel, multiple) |
|
Code SAD de tous les départements | ressource/departement | uniterech : identifiant de l'unité de recherche (optionnel, multiple) |
|
Code SAD de toutes les unités administratives | ressource/ uniteadmin | --- |
|
Code SAD de tous les titres de fonction | ressource/fonction | --- |
|
Numéro SAD de tous les programmes | ressource/programme | --- |
|
Identifiant de tous les domaines d'études | ressource/domaineetude | --- |
|
Nom de tous les champs d'expertise de recherche | ressource/expertiserech |
|
(ci-dessous mots-clés seulement)
|
Nom des secteurs de recherche | ressource/ | --- |
|
Disciplines | ressource/discipline | --- |
|
Nom des établissements affiliés à l'UdeM | ressource/etablaffilie | --- |
|
Code et nom des langues parlées et écrites | ressource/langue | --- |
|
Code et nom des types d'unités de recherche | ressource/typeuniterech | --- |
|
...
Remarque |
---|
Règles d'affaire de l'exposition de l'expertise de rechercheIl 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é. |
Exemples de routes
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/faculte
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/faculte?uniterech=ur13711
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/faculte?uniterech[0]=ur13711&uniterech[1]=ur13581
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/departement
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/fonction
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/programme
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/domaineetude
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/expertiserech?departement=0337
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/langue
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/discipline
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/ettbaffilie
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/ressource/secteur_recherche
- https://www.recherche.umontreal.ca/vitrine/rest/public/api/1.78/umontreal/ressource/typeuniterech
Réponses
Faculté, bonne requête
...
Bloc de code | ||
---|---|---|
| ||
{"data": [ { "nom": "14e siècle", "volet": "Période chronologique", "nbIndividus": 0, "nomTraduction": [ { "codeLangue": "eng", "nom": "14th century" } ] }, ... { "nom": "Afghanistan", "volet": "Pays", "nbIndividus": 0, "nomTraduction": [ { "codeLangue": "eng", "nom": "Afghanistan" } ] }, ... { "nom": "Afrique", "nomTraduction": [ { "nom": "Africa", "codeLangue": "eng" } ], "nbIndividus": 0, "volet": "Continent" }, ... { "nom": "Afrique du Nord", "nomTraduction": [ { "nom": "North Africa", "codeLangue": "eng" } ], "nbIndividus": 0, "volet": "Sous-région" }, ... { "nom": "Architecture", "volet": "Mot-clé", "nomTraduction": [ { "codeLangue": "eng", "nom": "Architecture" } ], "departement": [ { "departementCodeSad": "0337", "departementNom": "Département d'histoire", "nbIndividus": 1 }, { "departementCodeSad": "0104", "departementNom": "École d'architecture", "nbIndividus": 16 }, { "departementCodeSad": "0108", "departementNom": "École d'urbanisme et d'architecture de paysage ", "nbIndividus": 2 } ], "faculte": [ { "faculteCodeSad": "03", "faculteNom": "Faculté des arts et des sciences", "nbIndividus": 1 }, { "faculteCodeSad": "01", "faculteNom": "Faculté de l'aménagement", "nbIndividus": 18 } ] }, ... ]} |
...
Ancre | ||||
---|---|---|---|---|
|
Service | Requête : URI | Requête : paramètres | Réponse : champs pour chaque élément |
---|---|---|---|
Identifiants pérennes de tous les individus | /id/individu |
|
|
Identifiants pérennes des unités de recherche | /id/uniterech |
|
|
Exemples de routes
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/individu
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/uniterech
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/individu?uniterech=ur13605
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/individu?faculte=23
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/individu?departement=0328
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/individu?fonction=01001
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/uniterech?faculte=23
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/uniterech?departement=0328
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/id/individu?uniterech=ur13605&fonction[0]=42001&fonction[1]=42006
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.8/umontreal/id/individu?recrutement=true
Réponses
Individu, bonne requête
...
Bloc de code | ||
---|---|---|
| ||
{ errors: "SQLSTATE[42000] [1044] Access denied for user 'usager'@'1.1.1.1/255.255.255.255' to database 'database'" } |
...
Ancre | ||||
---|---|---|---|---|
|
Service | Requête : URI | Requête : paramètres | Réponse |
---|---|---|---|
Identifiants pérennes de tous les individus | /idext/individu |
Note : Il est recommandé de spécifier au moins paramètre afin éviter d'obtenir |
(ci-dessus, premier niveau seulement; voir exemple de réponse pour détails) |
...
Exemples de routes
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/idext/individu
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/idext/individu?uniterech=ur13605
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.8/umontreal/idext/individu?faculte=23
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/idext/individu?faculte=23&recrutement=true
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/idext/individu?departement=0328
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/idext/individu?fonction=01001
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/idext/uniterech?faculte=23
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/idext/uniterech?departement=0328
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/idext/individu?uniterech=ur13605&fonction[0]=42001&fonction[1]=42006
Réponses
Individu, bonne requête
Réponse avec bonne requête (200 : OK) pour idext/individu
. Les informations sont contenus dans l'élément data.
Bloc de code | ||
---|---|---|
| ||
{ "data": [ { "idsadvr": "in12345", "prenom": "Claude", "nom": "Toupin", "affiliations": [12345 { "fonction": { "codeSad": "42001", "nom": "Professeur titulaire" }, "uniteAdministrative": { "codeSad": "N202A0", "nom": "Faculté des arts et des sciences - Département d'histoire" }, "departement": { "codeSad": "0337", "nom": "Département d'histoire" }, "faculte": { "codeSad": "03", "nom": "Faculté des arts et des sciences" }, "courrielInstitutionnel": "claude.toupin@umontreal.ca", "telephone": { "numero": "5143436111", "poste": "6543" }, "immeuble": "Pavillon Lionel-Groulx", "local": "C6534-1", "exclusion": "0", "exclusionTel": "0" } ], "etablissementsAffilies": [], "visuelOfficiel": "http://www.recherche.umontreal.ca/visuel/personne:12345.photoOfficiellePetite", "visuelOfficielGrand": "http://www.recherche.umontreal.ca/visuel/personne:12345.photoOfficielle", "courriels": [], "telephones": [ { "numero": "5143436543", "poste": null, "categorie": "Travail 1" }, { "numero": "5143431234", "poste": null, "categorie": "Télécopieur" } ], "expertise": { "secteursRecherche": [ { "uid": "10", "codeLangue": "fre", "nom": "Sciences sociales et humaines", "ordre": "1" }, { "uid": "10", "codeLangue": "eng", "nom": "Social Sciences and Humanities", "ordre": "1" } ], "disciplines": [ { "uid": "100", "codeLangue": "fre", "nom": "Archéologie", "ordre": "1" }, ... { "uid": "100", "codeLangue": "eng", "nom": "Archaeology", "ordre": "1" }, ... ], "motsCles": [ ... { "uid": "157", "nom": "Urbanisme", "ordre": "6", "codeLangue": "fre", "departement": "École d'urbanisme", "departementCodeSAD": "0107", "faculte": null, "faculteCodeSAD": null, "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "uid": "157", "nom": "City planning", "ordre": "6", "codeLangue": "eng", "departement": "École d'urbanisme", "departementCodeSAD": "0107", "faculte": null, "faculteCodeSAD": null, "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "uid": "2137", "nom": "Grèce ancienne", "ordre": "5", "codeLangue": "fre", "departement": "Département d'histoire", "departementCodeSAD": "0337", "faculte": null, "faculteCodeSAD": null, "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "uid": "2137", "nom": "Ancient Greece", "ordre": "5", "codeLangue": "eng", "departement": "Département d'histoire", "departementCodeSAD": "0337", "faculte": null, "faculteCodeSAD": null, "uniteRecherche": null, "uniteRechercheIdsadvr": null }, ... ], "pays": [], "continents": [], "periodesChronologiques": [ { "uid": "37", "ordre": "7", "codeLangue": "fre", "nom": "Antiquité" }, { "uid": "37", "ordre": "7", "codeLangue": "eng", "nom": "Antiquity" } ], "phraseCle": [ { "codeLangue": "fre", "contenu": "Archéologie et histoire grecque" } ] }, "urlVitrine": [ { "nom": "Vitrine de la recherche", "url": "http://www.recherche.umontreal.ca/la-recherche-a-ludem/la-vitrine-des-professeurs/informations/chercheur/1234/" }, { "nom": "Répertoire des experts à l’intention des médias", "url": "http://www.recherche.umontreal.ca/la-recherche-a-ludem/la-vitrine-des-professeurs/repertoire-des-experts-a-lintention-des-medias/informations/chercheur/1234/" } ], "recrutementRecherche": false }, { "idsadvr": "in14321", "prenom": "Paul", "nom": "Hurtubise", "affiliations": [ { "fonction": { "codeSad": "42001", "nom": "Professeur titulaire" }, "uniteAdministrative": { "codeSad": "N202A0", "nom": "Faculté des arts et des sciences - Département d'histoire" }, "departement": { "codeSad": "0337", "nom": "Département d'histoire" }, "faculte": { "codeSad": "03", "nom": "Faculté des arts et des sciences" }, "courrielInstitutionnel": "paul.hurtubise@umontreal.ca", "telephone": { "numero": "5143436111", "poste": "7654" }, "immeuble": "3744, rue Jean-Brillant", "local": "333-22", "exclusion": "0", "exclusionTel": "0" } ], "etablissementsAffilies": [], "visuelOfficiel": null, "courriels": [], "telephones": [], "expertise": { "secteursRecherche": [ { "uid": "10", "codeLangue": "fre", "nom": "Sciences sociales et humaines", "ordre": "0" }, { "uid": "10", "codeLangue": "eng", "nom": "Social Sciences and Humanities", "ordre": "0" } ], "disciplines": [ { "uid": "100", "codeLangue": "fre", "nom": "Histoire", "ordre": "0" }, { "uid": "100", "codeLangue": "eng", "nom": "History", "ordre": "0" } ], "motsCles": [ { "uid": "1101", "nom": "Jardins", "ordre": "3", "codeLangue": "fre", "departement": "École d'architecture de paysage", "departementCodeSAD": "0105", "faculte": null, "faculteCodeSAD": null, "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "uid": "1101", "nom": "Gardens", "ordre": "3", "codeLangue": "eng", "departement": "École d'architecture de paysage", "departementCodeSAD": "0105", "faculte": null, "faculteCodeSAD": null, "uniteRecherche": null, "uniteRechercheIdsadvr": null }, ... ], "pays": [], "continents": [], "periodesChronologiques": [], "phraseCle": [ { "codeLangue": "fre", "contenu": "Histoire de la Grèce antique" } ] }, "urlVitrine": [ { "nom": "Vitrine de la recherche", "url": "http://www.recherche.umontreal.ca/la-recherche-a-ludem/la-vitrine-des-professeurs/informations/chercheur/11111/" }, { "nom": "Répertoire des experts à l’intention des médias", "url": null } ], "recrutementRecherche": false }, |
...
Service de récupération de données par le biais d’un identifiant pérenne (idsadvr)
Service | Requête : URI | Requête : paramètres | Réponse |
---|---|---|---|
Informations sur un individu | /info/individu | idsadvr : IDSADVR (obligatoire, multiple) | (voir exemple de réponse pour détails) |
Informations sur une unité de recherche | /info/uniterech | idsadvr : IDSADVR (obligatoire, multiple ) | (voir exemple de réponse pour détails) |
Exemples de routes
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/info/individu?idsadvr=in15669
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/info/individu?idsadvr=in13593
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/info/uniterech?idsadvr[0]=ur13603&idsadvr[1]=ur13639&idsadvr[2]=ur13819&idsadvr[3]=ur13900&idsadvr[4]=ur13954
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/info/uniterech?idsadvr=ur13852
- https://www.recherche.umontreal.ca/vitrine/rest/api/1.78/umontreal/info/uniterech?idsadvr=ur13924
Réponses
Individu, bonne requête
...
Bloc de code | ||
---|---|---|
| ||
{ "data": [ { "idsadvr": "in12345", "prenom": "Claude", "nom": "Toupin", "sexe": "M", "institution": "Université de Montréal", "paysCode": "CA", "paysNom": "Canada", "consentement": { "departements": [], "facultes": [], "unitesRecherche": [], "UdeM": [ { "nom": "Vitrine de la recherche", "statutConsentement": "1" }, { "nom": "Répertoire des experts à l’intention des médias", "statutConsentement": "1" } ] }, "affichageWeb": [ { "departements": [], "facultes": [], "unitesRecherche": [], "UdeM": [ { "nom": "Vitrine de la recherche", "url": "http://www.recherche.umontreal.ca/la-recherche-a-ludem/la-vitrine-des-professeurs/informations/chercheur/12345/" }, { "nom": "Répertoire des experts à l’intention des médias", "url": "http://www.recherche.umontreal.ca/la-recherche-a-ludem/la-vitrine-des-professeurs/repertoire-des-experts-a-lintention-des-medias/informations/chercheur/12345/" } ] } ], "langues": [ { "nom": "Anglais", "medium": "Écrit" }, { "nom": "Français", "medium": "Écrit" }, { "nom": "Anglais", "medium": "Oral" }, { "nom": "Français", "medium": "Oral" }, { "nom": "Grec moderne (après 1453)", "medium": "Oral" } ], "courriels": [], "affiliations": [ { "fonction": { "codeSad": "42001", "nom": "Professeur titulaire" }, "uniteAdministrative": { "codeSad": "N202A0", "nom": "Faculté des arts et des sciences - Département d'histoire" }, "departement": { "codeSad": "0337", "nom": "Département d'histoire" }, "faculte": { "codeSad": "03", "nom": "Faculté des arts et des sciences" }, "courrielInstitutionnel": "claude.toupin@umontreal.ca", "telephone": { "numero": "5143436111", "poste": "5432" }, "immeuble": "Pavillon Lionel-Groulx", "local": "C6543-1", "exclusion": 0, "exclusionTel": 0 } ], "presenceWeb": [ { "idcategorie": "13", "categorie": "Page professionnelle (faculté,département,école)", "url": "http://histoire.umontreal.ca/repertoire-departement/toupin-claude/" }, { "idcategorie": "14", "categorie": "Site web de l’unité de recherche", "url": "http://abcd.umontreal.ca/" } ], "telephones": [ { "numero": "5143436111", "poste": "4321", "categorie": "Travail 1" }, { "numero": "5143431234", "poste": "", "categorie": "Télécopieur" } ], "etablissementsAffilies": [], "formations": [], "biographie": [ { "codeLangue": "fre", "contenu": "<p>Contenu de la biographie.</p>" } ], "recrutementRecherche": [], "activiteEnseignement": [ { "domainesEtude": [ { "id": "9", "codeLangue": "fre", "nom": "Sciences humaines" }, { "id": "9", "codeLangue": "eng", "nom": "Humanities" } ], "groupesProgramme": [ { "id": "148", "codeLangue": "fre", "nom": "Histoire" }, { "id": "57", "codeLangue": "fre", "nom": "Histoire et Études classiques" }, { "id": "148", "codeLangue": "eng", "nom": "History" }, { "id": "57", "codeLangue": "eng", "nom": "History and Classical Studies" } ], "programmes": [ { "noSad": "116510", "cycle": "1", "faculteNom": "Faculté des arts et des sciences", "faculteCodeSad": "03", "departementNom": "Département d'histoire", "departementCodeSad": "0337", "noms": [ { "codeLangue": "fre", "nom": "Baccalauréat en histoire" } ], "groupesProgramme": [ { "id": "148", "codeLangue": "eng", "nom": "History" }, { "id": "148", "codeLangue": "fre", "nom": "Histoire" } ], "domainesEtude": [ { "id": "9", "codeLangue": "eng", "nom": "Humanities" }, { "id": "9", "codeLangue": "fre", "nom": "Sciences humaines" } ] } ], "cours": [ { "noSad": "HGL1011", "trimestreCode": "H18", "annee": "18", "nom": "Initiation à l'archéologie grécoromaine", "cycle": "1", "sourceDonnees": "SAD", "faculteCodeSad": "03", "faculteNom": "Faculté des arts et des sciences", "programmes": [ { "noSad": "109510", "noms": [ { "codeLangue": "fre", "nom": "Baccalauréat en études classiques" } ] }, ... ] } ] } ] } ], "unitesRecherche": [], "projetsRecherche": [ { "categorie": "Projet de recherche au Canada", "nom": "Un projet de recherche", "dateDebut": "2015", "dateFin": "2019", "exclusion": "0", "selection": "0", "contenu": [], "pays": [], "continents": [], "periodesChronologiques": [], "financement": [ { "organisme": "CRSH/Conseil de recherches en sciences humaines du Canada", "programme": "Programme de subvention", "dateDebut": "2016-04-01", "dateFin": "2019-03-31" } ], "equipe": [ { "chercheurPrincipal": [ { "idsadvr": "in12345", "prenom": "Claude", "nom": "Toupin" } ], "coChercheur": [] } ] } ], "activitesRecherche": [ { "categorie": "Thèses et mémoires dirigés", "typeTransfert": null, "nom": "Titre d'une thèse", "dateDebut": "2016", "dateFin": "2016", "sourceFinancement": null, "exclusion": "0", "selection": "0", "sourceDonnees": "Papyrus", "contenu": [ { "codeLangue": "eng", "contenu": "<strong>Graduate :</strong> Tremblay, Sébastien<br/><strong>Cycle :</strong> Master's<br/><strong>Grade :</strong> M.A." }, { "codeLangue": "fre", "contenu": "<strong>Diplômé(e) :</strong> Tremblay, Sébastien<br/><strong>Cycle :</strong> Maîtrise <br/><strong>Diplôme obtenu :</strong> M.A." } ], "partenaires": [], "infosSupplementaires": [ { "categorie": null, "nom": "Lien vers le document dans Papyrus", "description": null, "adresse": "http://hdl.handle.net/1866/123456", "datePublication": null, "exclusion": "0", "selection": "0" } ] }, ... { "categorie": "Méthodes et formules pédagogiques", "typeTransfert": null, "nom": "Méthodes et formules pédagogiques", "dateDebut": null, "dateFin": null, "sourceFinancement": null, "exclusion": "0", "selection": "0", "sourceDonnees": null, "contenu": [ { "codeLangue": "fre", "contenu": "<p>Un exemple de contenu d'activité avec un <a href=\"http://www.umontreal.ca/" target=\"_blank\">lien</a></p>" } ], "partenaires": [], "infosSupplementaires": [] }, ... ], "publication": null, "communication": null, "expertise": [ { "secteursRecherche": [ { "uid": "10", "codeLangue": "fre", "nom": "Sciences sociales et humaines", "ordre": 1 }, { "uid": "10", "codeLangue": "eng", "nom": "Social Sciences and Humanities", "ordre": 1 }, { "uid": "18", "codeLangue": "fre", "nom": "Aménagement", "ordre": 2 }, { "uid": "18", "codeLangue": "eng", "nom": "Environmental Planning and Design", "ordre": 2 }, ... ], "disciplines": [ { "uid": "13", "codeLangue": "eng", "nom": "Classical Archaeology", "ordre": 1 }, { "uid": "13", "codeLangue": "fre", "nom": "Archéologie classique", "ordre": 1 }, ... ], "motsCles": [ { "uid": "3087", "ordre": 5, "codeLangue": "eng", "nom": "Ancient Greece", "departement": null, "departementCodeSad": null, "faculte": null, "faculteCodeSad": null, "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "uid": "3087", "ordre": 5, "codeLangue": "fre", "nom": "Grèce ancienne", "departement": null, "departementCodeSad": null, "faculte": null, "faculteCodeSad": null, "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "uid": "624", "ordre": 6, "codeLangue": "fre", "nom": "Urbanisme", "departement": null, "departementCodeSad": null, "faculte": "Faculté de l'aménagement", "faculteCodeSad": "01", "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "uid": "624", "ordre": 6, "codeLangue": "eng", "nom": "City planning", "departement": null, "departementCodeSad": null, "faculte": "Faculté de l'aménagement", "faculteCodeSad": "01", "uniteRecherche": null, "uniteRechercheIdsadvr": null }, ... ], "pays": [ { "uid": "10214", "codeLangue": "eng", "nom": "Syrian Arab Republic", "ordre": 9 }, { "uid": "10214", "codeLangue": "fre", "nom": "Syrie (République arabe syrienne)", "ordre": 9 } ], "continents": [], "periodesChronologiques": [ { "uid": "5", "codeLangue": "eng", "nom": "Antiquity", "ordre": 7 }, { "uid": "5", "codeLangue": "fre", "nom": "Antiquité", "ordre": 7 } ], "phraseCle": [ { "codeLangue": "fre", "contenu": "Archéologie et histoire grecque" } ], "contenu": [ { "codeLangue": "fre", "contenu": "<p>Description de l'expertise.</p>" } ] } ], "expertiseMedia": [ { "typesMedias": [ { "typeMedia": "Presse écrite (imprimé, numérique)" }, { "typeMedia": "Radio" }, { "typeMedia": "Télévision" } ], "langues": [ { "nom": "Anglais", "medium": "Écrit" }, { "nom": "Français", "medium": "Écrit" }, { "nom": "Anglais", "medium": "Oral" }, { "nom": "Français", "medium": "Oral" }, { "nom": "Grec moderne (après 1453)", "medium": "Oral" } ], "disciplines": [ { "codeLangue": "eng", "nom": "Archaeology", "ordre": 4 }, { "codeLangue": "fre", "nom": "Archéologie", "ordre": 4 }, ... ], "motsCles": [ { "ordre": 1, "codeLangue": "eng", "nom": "Archeological Data Analysis", "departement": null, "departementCodeSad": null, "faculte": "Faculté des arts et des sciences", "faculteCodeSad": "03", "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "ordre": 1, "codeLangue": "fre", "nom": "Analyses des données archéologiques", "departement": null, "departementCodeSad": null, "faculte": "Faculté des arts et des sciences", "faculteCodeSad": "03", "uniteRecherche": null, "uniteRechercheIdsadvr": null }, ... ], "contenu": [ { "codeLangue": "fre", "contenu": "<p>Description de l'expertise</p>" } ], "infosSupplementaires": [] } ], "prix": [ { "vitrine": [], "autre": [] } ], "infosSupplementaires": [ { "categorie": null, "nom": "Découverte d'un nouveau site archéologique", "description": "Un nouveau site archéologique mis à l'étude en Syrie.", "adresse": "http://youtube.com/1234567890asdfghjkl", "datePublication": null, "exclusion": "0", "selection": "0", "sourceDonnees": null } ], "visuels": [ { "categorie": "Photo officielle", "nom": null, "droitAuteur": null, "ordre": null, "url": "http://www.recherche.umontreal.ca/visuel/personne:12345.photoOfficielle", "legendes": [] }, { "categorie": "Portrait du chercheur", "nom": "Mission archéologique", "droitAuteur": "© Claude Toupin", "ordre": null, "url": "http://www.recherche.umontreal.ca/visuel/personne:12345.portrait.1.image", "legendes": [ { "codeLangue": "fre", "contenu": "Photo montrant le site étudié" } ] } ], "activitesPromotion": [] } ] } "activitesPromotion": [] }]} |
Ancre | ||||
---|---|---|---|---|
|
...
Paramètre | Usage | Exemples |
---|---|---|
q | Requê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
| sort= |
start / rows | Les 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. |
|
q.op | Pour 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.
...
Bloc de code |
---|
q.op=OR&q=Texte%3Aintelligence+cognition&sort=UniteAdmin_tri+asc |
...
Exemple d'une requête complète correspondant à la recherche par critère illustrée ci-dessous, si l'on voulait obtenir la deuxième page de résultats, avec 10 résultats par page.
Bloc de code |
---|
q=Faculte_fac%3A"Faculté+de+droit"+AND+Expertise_idx%3A"Droit+civil"&sort=ChercheurNP_tri+asc&start=10&rows=10 |
...
Astuce | ||
---|---|---|
| ||
|
...
Critères et tri
Professeurs
Type | Champ SOLR | Libellé / fonction |
---|---|---|
Critère, par mots | Texte | Pour la recherche simple (tous les champs) |
Critère, par expression exacte | Secteur_fac | Secteur de recherche |
Critère, par expression exacte | Discipline_fac | Discipline |
Critère, par expression exacte | ObjetsRech_fac | Expertise par mot-clé |
Critère, par expression exacte | Faculte_fac | Faculté |
Critère, par expression exacte | UniteRech_fac | Unité de recherche |
Critère, par expression exacte | ChercheurNP_fac | Nom du professeur |
Tri |
| Nom |
Tri | Expertise_tri | Expertise |
Tri | UniteAdmin_tri | Faculté d'attache |
Critère. booléen |
| Repérer les personnes qui affichent une notification de recrutement (valeur "true") |
Unités de recherche
Type | Champ SOLR | Libellé / fonction |
---|---|---|
Critère, par mots | Texte | Pour la recherche simple (tous les champs) : n'est pas utilisé actuellement |
Critère, par expression exacte | Secteur_fac | Secteur de recherche |
Critère, par expression exacte |
| Faculté |
Critère, par expression exacte |
| Établissement affilié à l'UdeM |
Critère, par mots |
| Activité de recherche |
Critère, par expression exacte |
| Responsable |
Critère, par expression exacte |
| Catégorie d'unité de recherche |
Critère, par expression exacte | UniteRech_fac | Nom de l'unité de recherche |
Tri |
| Nom |
Tri |
| Responsable |
Tri |
| Secteur de recherche |
...
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.
Bloc de code | ||
---|---|---|
| ||
{ "paginationSOLR": { "numFound": 73, "start": 10, "rows": 10 }, "data": [ ... ] } |
L'élément numFound
est le nombre total d'items trouvés. Les éléments start
et rows
retournent les valeurs de ces paramètres initialement soumis à SOLR lors de la requête. Ces informations sont nécessaires pour permettre à l'application de générer les liens permettant d'atteindre d'autres pages de résultats que celle affichée.
Repérage d'individus : professeurs et experts
...
Bloc de code |
---|
{ "paginationSOLR": { "numFound": 73, "start": 10, "rows": 10 }, "data": [ ... { "idsadvr": "in20664", "prenom": "Christine", "nom": "Gagnon", "affiliations": [ { "fonction": { "codeSad": "42032", "nom": "Professeure associée" }, "uniteAdministrative": { "codeSad": "C000A0", "nom": "Faculté de droit" }, "departement": { "codeSad": null, "nom": null }, "faculte": { "codeSad": "11", "nom": "Faculté de droit" }, "courrielInstitutionnel": "christine.gagnon.3@umontreal.ca", "telephone": { "numero": null, "poste": null }, "immeuble": null, "local": null, "exclusion": "0", "exclusionTel": "0" } ], "etablissementsAffilies": [], "visuelOfficiel": "http://www.recherche.umontreal.ca/visuel/personne:20664.photoOfficiellePetite", "visuelOfficielGrand": "http://www.recherche.umontreal.ca/visuel/personne:20664.photoOfficielle", "courriels": [], "telephones": [], "expertise": { "secteursRecherche": [ { "codeLangue": "fre", "nom": "Sciences sociales et humaines", "ordre": "1" }, { "codeLangue": "fre", "nom": "Droit", "ordre": "2" }, { "codeLangue": "eng", "nom": "Social Sciences and Humanities", "ordre": "1" }, { "codeLangue": "eng", "nom": "Law", "ordre": "2" } ], "disciplines": [ { "codeLangue": "fre", "nom": "Droit", "ordre": "1" }, { "codeLangue": "eng", "nom": "Law", "ordre": "1" } ], "motsCles": [ { "uid": "372", "nom": "Droit notarial", "ordre": "1", "codeLangue": "fre", "departement": null, "departementCodeSAD": null, "faculte": "Faculté de droit", "faculteCodeSAD": "11", "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "uid": "372", "nom": "Notarial law", "ordre": "1", "codeLangue": "eng", "departement": null, "departementCodeSAD": null, "faculte": "Faculté de droit", "faculteCodeSAD": "11", "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "uid": "1372", "nom": "Immobilier", "ordre": "2", "codeLangue": "fre", "departement": null, "departementCodeSAD": null, "faculte": "Faculté de droit", "faculteCodeSAD": "11", "uniteRecherche": null, "uniteRechercheIdsadvr": null }, { "uid": "1372", "nom": "Real estate", "ordre": "2", "codeLangue": "eng", "departement": null, "departementCodeSAD": null, "faculte": "Faculté de droit", "faculteCodeSAD": "11", "uniteRecherche": null, "uniteRechercheIdsadvr": null } ], "pays": [], "continents": [], "periodesChronologiques": [], "phraseCle": [ { "codeLangue": "eng", "contenu": "Co-ownership law" }, { "codeLangue": "fre", "contenu": "Droit de la copropriété" } ] }, "urlVitrine": [ { "nom": "Vitrine de la recherche", "url": "http://www.recherche.umontreal.ca/la-recherche-a-ludem/la-vitrine-des-professeurs/informations/chercheur/7085/" }, { "nom": "Répertoire des experts à l’intention des médias", "url": null } ], "recrutementRecherche": false }, ... ] } |
Repérage d'unités de recherche
...
Bloc de code | ||
---|---|---|
| ||
{ "paginationSOLR": { "numFound": 36, "start": 0, "rows": 20 }, "data": [ { "idsadvr": "ur13611", "nom": "Centre d'études ethniques des universités montréalaises", "acronyme": "CEETUM", "responsables": [ { "idsadvr": "in13629", "prenom": "Deirdre", "nom": "Meintel", "fonction": "Professeure titulaire", "fonctionCodeSAD": "42001", "uniteAdmin": "Faculté des arts et des sciences - Département d'anthropologie", "courriel": "deirdre.meintel@umontreal.ca" } ], "visuelOfficiel": "http://www.recherche.umontreal.ca/visuel/uniterech:13611.photoOfficiellePetite" "visuelOfficielGrand": "http://www.recherche.umontreal.ca/visuel/uniterech:13611.photoOfficielle", }, { "idsadvr": "ur13614", "nom": "Centre de recherche en droit public", "acronyme": "CRDP", "responsables": [ { "idsadvr": "in14999", "prenom": "Vincent", "nom": "Gautrais", "fonction": "Professeur titulaire", "fonctionCodeSAD": "42001", "uniteAdmin": "Faculté de droit", "courriel": "vincent.gautrais@umontreal.ca" } ], "visuelOfficiel": "http://www.recherche.umontreal.ca/visuel/uniterech:13614.photoOfficiellePetite" "visuelOfficielGrand": "http://www.recherche.umontreal.ca/visuel/uniterech:13614.photoOfficielle" }, ... ] } |
Exemples de code d'utilisation
...
laravel/framework : https://laravel-news.com (s'ajouter à la liste courriel à partir du site)
league/fractal : https://github.com/thephpleague/fractal/issues?q=is%3Aopen+is%3Aissue
...
UniteRech_fac