MACROMEDIA BREEZE 5-UTILISATION DES SERVICES WEB XML DE BREEZE Manuel utilisateur

Document
Utilisation des services Web XML de Breeze
Marques commerciales
Add Life to the Web, Afterburner, Aftershock, Andromedia, Allaire, Animation PowerPack, Aria, Attain, Authorware,
Authorware Star, Backstage, Bright Tiger, Clustercats, ColdFusion, Contribute, Design In Motion, Director, Dream Templates,
Dreamweaver, Drumbeat 2000, EDJE, EJIPT, Extreme 3D, Fireworks, Flash, Fontographer, FreeHand, Generator, HomeSite,
JFusion, JRun, Kawa, Know Your Site, Knowledge Objects, Knowledge Stream, Knowledge Track, LikeMinds, Lingo, Live
Effects, MacRecorder Logo and Design, Macromedia, Macromedia Action!, Macromedia Breeze, Macromedia Contribute,
Macromedia Flash, Macromedia M Logo and Design, Macromedia Spectra, Macromedia xRes Logo and Design, MacroModel,
Made with Macromedia, Made with Macromedia Logo and Design, MAGIC Logo and Design, Mediamaker, Movie Critic,
Open Sesame!, Roundtrip, Roundtrip HTML, Shockwave, Sitespring, SoundEdit, Titlemaker, UltraDev, Web Design 101, what
the web can be et Xtra sont des marques commerciales ou des marques d&eacute;pos&eacute;es de Macromedia, Inc. qui peuvent &ecirc;tre d&eacute;pos&eacute;es
aux Etats-Unis et/ou dans d'autres juridictions ou pays. Les autres noms de produits, logos, graphiques, mises en page, titres,
mots ou expressions mentionn&eacute;s dans cette publication peuvent &ecirc;tre des marques commerciales, des marques de service ou des
noms de marque appartenant &agrave; Macromedia, Inc. ou &agrave; d’autres entit&eacute;s et peuvent &ecirc;tre d&eacute;pos&eacute;s dans certaines juridictions ou pays.
Autres marques mentionn&eacute;es
Ce guide contient des liens vers des sites Web qui ne sont pas sous le contr&ocirc;le de Macromedia, qui n’est donc aucunement
responsable de leur contenu. L’acc&egrave;s &agrave; ces sites se fait sous votre seule responsabilit&eacute;. Macromedia ne mentionne ces liens qu'&agrave; titre
pratique et leur inclusion n'implique en aucun cas que Macromedia peut &ecirc;tre tenu pour responsable du contenu de ces sites.
Copyright &copy; 1997-2004 Macromedia, Inc. Tous droits r&eacute;serv&eacute;s. Le pr&eacute;sent manuel ne doit pas &ecirc;tre copi&eacute;, photocopi&eacute;,
reproduit, tranduit ou converti sous tout format &eacute;lectronique ou lisible par une machine, en tout ou partie, sans
l'autorisation &eacute;crite pr&eacute;alable de Macromedia, Inc.
Remerciements
Gestion du projet : Stephanie Gowin
R&eacute;daction : Jed Hartman
Responsable d'&eacute;dition : Rosana Francescato
Edition : Linda Adler, Barbara Milligan, Noreen Maher, Anne Szabla
Gestion de la production : Patrice O’Neill
Conception et production des supports : Adam Barnett, Christopher Basmajian, Aaron Begley
Premi&egrave;re &eacute;dition : mars 2004
Macromedia, Inc.
600 Townsend St.
San Francisco, CA 94103
TABLE DES MATIERES
INTRODUCTION : Avant de commencer
................................7
Utilisateurs concern&eacute;s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Guide des supports p&eacute;dagogiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Ressources suppl&eacute;mentaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Conventions typographiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CHAPITRE 1 : Vue d'ensemble de l'architecture . . . . .
. . . . . . . . . . . . . . . . . . . . . 11
Flux de donn&eacute;es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appel d'une action sur le serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A propos des param&egrave;tres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A propos des mandants, des entit&eacute;s SCO et des identifiants . . . . . . . . . . . . . . . . .
A propos de la s&eacute;curit&eacute;. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CHAPITRE 2 : T&acirc;ches courantes
7
7
8
9
12
13
13
14
15
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Sc&eacute;nario : Int&eacute;gration de Breeze &agrave; un service d’annuaire . . . . . . . . . . . . . . . . . . . . 19
Sc&eacute;nario : Int&eacute;gration de Breeze &agrave; un portail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Sc&eacute;nario : g&eacute;n&eacute;ration de rapports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
CHAPITRE 3 : Guide de r&eacute;f&eacute;rence des actions . .
. . . . . . . . . . . . . . . . . . . . . . . . . 27
accesskey-exec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
accesskey-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
action-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
common-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
group-membership-update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
permissions-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
permissions-reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
permissions-update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
principal-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
principal-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
principal-update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
principals-delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
report-active-meeting-presenters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
report-active-meetings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3
report-bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
report-course-takers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
report-disk-usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
report-meeting-attendance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
report-meeting-concurrent-users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
report-meeting-session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
report-meeting-sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
report-meeting-session-slots. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
report-meeting-summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
report-my-courses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
report-my-meetings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
report-quiz-answer-distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
report-quiz-definition-answers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
report-quiz-definition-questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
report-quiz-interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
report-quiz-question-answer-distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
report-quiz-question-distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
report-quiz-question-response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
report-quiz-question-totals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
report-quiz-summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
report-quiz-takers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
report-sco-slides. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
report-sco-views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
report-training-concurrent-users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
sco-build . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
sco-contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
sco-delete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
sco-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
sco-move . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
sco-nav . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
sco-search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
sco-shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
sco-update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
sco-upload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
user-accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
user-update-pwd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
CHAPITRE 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML .
. . . . . . . . . . . . . . . . . . . . . . . 61
A propos du code XML renvoy&eacute; . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
access-key (conteneur) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
access-key (cl&eacute;) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
access-keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
actions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
answer-text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
body . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
common . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
cookie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
4
Table des mati&egrave;res
course . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
date-begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
date-closed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
date-created . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
date-end . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
date-expired. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
date-modified . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
date-taken . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
domain-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
duration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
expired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
first-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
hit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
invalid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
last-name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
last-viewed-date. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
last-viewed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
meeting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
my-courses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
my-meetings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
participant-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
physical-path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
principal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
principal-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
principal-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
question-text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
question . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
quiz-definition-answers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
quiz-definition-questions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
report-active-meeting-presenters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
report-active-meetings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
report-bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
report-disk-usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
report-meeting-attendance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
report-meeting-concurrent-users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
report-meeting-session. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
report-meeting-sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
report-meeting-session-slots. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
report-meeting-summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
report-quiz-answer-distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
report-quiz-interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
report-quiz-question-answer-distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
report-quiz-question-distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Table des mati&egrave;res
5
report-quiz-question-response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
report-quiz-question-totals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
report-quiz-results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
report-quiz-summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
report-quiz-takers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
report-sco-slides. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
report-sco-views. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
report-training-concurrent-users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
r&eacute;sultats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
row . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
sco. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
sco-author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
sco-data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
sco-name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
sco-nav . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
sco-search-info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
scos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
source-sco . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
time-slot-begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
time-slot-end . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
url . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
url-path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
user (common-info) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
user (user-accounts) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
INDEX
6
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Table des mati&egrave;res
INTRODUCTION
Avant de commencer
Les services Web XML Macromedia Breeze permettent &agrave; un syst&egrave;me externe (tel qu'une
application Web) d'interagir avec un serveur Breeze.
Le pr&eacute;sent guide explique comment appeler des services Web XML (&laquo; actions &raquo;) sur le serveur
Breeze &agrave; partir du syst&egrave;me externe et comment interpr&eacute;ter les r&eacute;sultats XML renvoy&eacute;s par Breeze.
Il comporte &eacute;galement des sections de r&eacute;f&eacute;rence expliquant l'effet des diff&eacute;rentes actions et
indique les param&egrave;tres pouvant &ecirc;tre associ&eacute;s &agrave; ces actions.
Remarque : Pour utiliser les services Web XML de Breeze, vous devez disposer d'une cl&eacute; d'acc&egrave;s
valide. Pour plus d'informations, consultez la section A propos de la s&eacute;curit&eacute;, page 15.
Les services Web mentionn&eacute;s dans ce document sont sujets &agrave; modifications. Consultez la page de
mises &agrave; jour (http://www.macromedia.com/go/breeze_xmlapi_updates_fr) pour prendre
connaissance des derni&egrave;res mises &agrave; jour et modifications.
Utilisateurs concern&eacute;s
Le pr&eacute;sent document a &eacute;t&eacute; con&ccedil;u pour les d&eacute;veloppeurs qui souhaitent int&eacute;grer les services Web
XML de Breeze dans leurs syst&egrave;mes externes, tels que les applications Web.
Il implique des notions de base du code XML et de l'utilisation des requ&ecirc;tes HTTP permettant de
communiquer entre une application et un serveur. Vous devez &eacute;galement savoir comment &eacute;crire
du code en langage serveur, tel que le langage CFML (Macromedia ColdFusion Markup
Language).
Guide des supports p&eacute;dagogiques
Macromedia Breeze dispose de plusieurs supports qui permettent de ma&icirc;triser rapidement ce
produit. Outre le pr&eacute;sent document, les manuels &eacute;lectroniques et les syst&egrave;mes d'aide en ligne
suivants sont disponibles :
• Guide d'installation de Breeze indique comment installer les modules de Breeze. Ce guide est
•
disponible sous forme d'insert sur le DVD pour les utilisateurs professionnels, ainsi qu'au
format PDF.
Utilisation de Breeze Manager d&eacute;crit comment utiliser les composants d'administration, de
pr&eacute;sentation et de formation de Breeze Live. Vous pouvez acc&eacute;der &agrave; ce guide &agrave; partir de la page
d'accueil de Breeze Manager et du lien Aide de l'application Web Breeze Manager.
7
• Mode d’emploi de Breeze Live &agrave; l’intention des pr&eacute;sentateurs de r&eacute;unions comprend des
•
•
•
informations sur l'utilisation de l'application Web Breeze Live pour h&eacute;berger des r&eacute;unions en
temps r&eacute;el en ligne. La documentation inclut des proc&eacute;dures qui d&eacute;montrent &agrave; quel point il est
facile d'ajouter des diapositives, des fichiers Flash SWF, des images, du son et des vid&eacute;os &agrave; votre
pr&eacute;sentation. Vous pouvez acc&eacute;der &agrave; ce document &agrave; partir de la page d'accueil de l'application
Breeze Manager et du menu Aide dans une salle de r&eacute;union Breeze Live (lorsque vous entrez en
tant que pr&eacute;sentateur) en s&eacute;lectionnant R&eacute;union &gt; Aide.
Mode d’emploi de Breeze Live &agrave; l’intention des participants aux r&eacute;unions comprend les
informations qui s'appliquent aux utilisateurs participant &agrave; une r&eacute;union en temps r&eacute;el en ligne.
Breeze Live met &agrave; la disposition des participants diff&eacute;rentes options qui facilitent la
participation, ce qui inclut la possibilit&eacute; d'envoyer des messages et des questions aux
pr&eacute;sentateurs et aux autres participants, ainsi que la possibilit&eacute; de participer en direct &agrave; l'aide
des fonctions audio et vid&eacute;o. Vous pouvez acc&eacute;der &agrave; ce document &agrave; partir de la page d'accueil
de l'application Breeze Manager et du menu Aide dans une salle de r&eacute;union Breeze Live
(lorsque vous entrez en tant que participant) en s&eacute;lectionnant R&eacute;union &gt; Aide.
Utilisation du plug-in Breeze pour PowerPoint explique comment utiliser le plug-in qui permet
aux utilisateurs de cr&eacute;er des pr&eacute;sentations Breeze &agrave; partir de PowerPoint. Vous pouvez acc&eacute;der &agrave;
ce document &agrave; partir de la page d'accueil de Breeze Manager et du menu Breeze de PowerPoint
en cliquant sur Breeze &gt; Aide.
Utilisation de l'Assistant de publication de Breeze comprend les proc&eacute;dures de publication sur un
serveur Breeze des pr&eacute;sentations Breeze cr&eacute;&eacute;es dans PowerPoint. Vous pouvez acc&eacute;der &agrave; ce
document &agrave; partir de la page d'accueil de l'application Breeze Manager et du bouton Aide de
l'Assistant de publication.
Remarque : L'int&eacute;r&ecirc;t de ces guides d&eacute;pend des modules install&eacute;s sur la plate-forme de pr&eacute;sentation
Breeze, du type d'utilisateur (tel que gestionnaire du contenu de la r&eacute;union, ing&eacute;nieur informatique ou
pr&eacute;sentateur de cours) et des autorisations du compte Breeze de l'utilisateur.
Ressources suppl&eacute;mentaires
Vous trouverez ci-dessous les principales ressources disponibles sur le Web :
Remarque : Pour obtenir la liste des ressources de Breeze, consultez le manuel Guide des supports
p&eacute;dagogiques, page 7.
&agrave; xml.com (http://webservices.xml.com/pub/a/ws/2001/04/04/
webservices/) constitue un excellent point de d&eacute;part pour les services Web.
The Web Service Primer
&laquo; Working with XML and ColdFusion &raquo; dans le manuel ColdFusion Developer’s Handbook (http:/
/www.macromedia.com/devnet/mx/coldfusion/articles/cf_handbk_ch6.html) comporte des
informations suppl&eacute;mentaires sur les notions de base du code XML et la r&eacute;daction de code avec
CFML.
(http://www.macromedia.com/devnet/mx/coldfusion/
articles/cf_handbk_ch7.html) traite des services Web, de SOAP et des m&eacute;thodes d'appel des
services Web avec le langage CFML.
&laquo; Leveraging XML with ColdFusion &raquo;
(http://www.w3.org/TR/xslt) introduit le code
XSLT, que vous pouvez utiliser pour convertir les donn&eacute;es.
La sp&eacute;cification XSL Transformations (XSLT)
8
Introduction: Avant de commencer
(http://www.iso.ch/iso/en/prods-services/popstds/
datesandtime.html) fournit des informations sur le format de date et d'heure de la norme ISO
8601. De fa&ccedil;on plus sp&eacute;cifique, la note W3C relative aux dates et aux heures (http://www.w3.org/
TR/NOTE-datetime) fournit des informations sur le profil ISO 8601 retenu par Breeze.
Numeric representation of Dates and Time
Conventions typographiques
Ce manuel utilise les conventions typographiques suivantes :
• La police en italique indique une valeur qui doit &ecirc;tre remplac&eacute;e (par exemple, dans le chemin
d'un dossier).
• La police de code identifie le code. Elle met &eacute;galement en avant le nom des actions, des
param&egrave;tres, des balises et des attributs.
• La police en gras d&eacute;signe une citation ou un &eacute;l&eacute;ment de menu.
Conventions typographiques
9
10
Introduction: Avant de commencer
CHAPITRE 1
Vue d'ensemble de l'architecture
Le mod&egrave;le d'API de Macromedia Breeze convertit les interfaces en un ensemble de services Web
XML. Ces services permettent &agrave; un syst&egrave;me externe, tel qu'un portail, de communiquer avec le
serveur Breeze en utilisant le protocole HTTP ou HTTPS pour appeler des actions sur le serveur
et recevoir les r&eacute;sultats format&eacute;s en tant que code XML. Vous pouvez utiliser les services Web
pour ajouter le service de gestion de Breeze et les fonctionnalit&eacute;s de cr&eacute;ation de rapports sur votre
syst&egrave;me externe.
Remarque : Breeze ne prend pas encore en charge le protocole SOAP (Simple Object Access
Protocol).
Le pr&eacute;sent chapitre porte sur les flux de donn&eacute;es entre le serveur Breeze et les applications Web, et
indique comment d&eacute;finir les param&egrave;tres et les autorisations de s&eacute;curit&eacute;.
11
Flux de donn&eacute;es
Le diagramme suivant illustre le flux de donn&eacute;es dans une application Web qui interagit avec le
serveur Breeze :
Navigateur Web
Etape 1 : Le
navigateur Web
demande une page.
Requ&ecirc;te
R&eacute;ponse
Etape 7 : Le serveur
Web envoie la page
finale au navigateur
ayant &eacute;mis la requ&ecirc;te.
SERVEUR WEB
Etape 2 : Le serveur
Web trouve la page
et la passe au
serveur
d'applications.
Etape 3 : Le serveur
d'applications
ex&eacute;cute du code.
Etape 4 : Le serveur
d'application appelle
l'action sur le serveur
Breeze.
&lt;HTML&gt;
&lt;code&gt;
&lt;/HTML&gt;
&lt;HTML&gt;
&lt;p&gt;Hi&lt;/p&gt;
&lt;/HTML&gt;
Etape 6 : Le serveur
d'applications ins&egrave;re
des donn&eacute;es dans la
page, puis passe la
page au serveur Web.
Serveur d’application
Action
Donn&eacute;es XML
Etape 5 : Le serveur
Breeze renvoie des
donn&eacute;es XML au
serveur d'applications.
Serveur Breeze
L'exemple suivant d&eacute;crit ce qui peut de se produire lorsqu'un utilisateur se connecte au portail de
formation d'un site intranet cr&eacute;&eacute; avec Macromedia ColdFusion MX et ayant recours aux services
Web XML de Breeze :
1 Un utilisateur connect&eacute; se sert d'un navigateur Web pour demander une page qui affiche la liste
des cours auquel il est inscrit.
2 Le serveur Web trouve la page et la passe au serveur d'applications.
3 Le serveur d'applications analyse et ex&eacute;cute le code ColdFusion contenu dans la page.
4 Lors de l'ex&eacute;cution du code, le serveur d'applications appelle une action sur le serveur Breeze de
la soci&eacute;t&eacute;, afin d'obtenir la liste des cours. Cet appel d'action prend la forme d'une requ&ecirc;te POST
HTTP disposant d'informations d'identification de s&eacute;curit&eacute; incluses dans la requ&ecirc;te.
12
Chapitre 1 : Vue d'ensemble de l'architecture
5 Le serveur Breeze ex&eacute;cute l'action, en renvoyant les donn&eacute;es XML r&eacute;sultantes au serveur
d'applications.
6 Le code d'application analyse le code XML renvoy&eacute; et ins&egrave;re des donn&eacute;es dans la page Web en
fonction des besoins, puis passe la page finale au serveur Web.
7 Le serveur Web passe la page finale au navigateur, ce qui permet de l'afficher.
Appel d'une action sur le serveur
Pour appeler une action sur le serveur Breeze, passez les param&egrave;tres voulus au servlet de services
Web &agrave; l'adresse http://nom_serveur/api/xml.
Toutes les actions n&eacute;cessitent au moins deux param&egrave;tres : le param&egrave;tre action sp&eacute;cifie le nom de
l'action et le param&egrave;tre accesskey donne la cl&eacute; d'action du compte. La plupart des actions
disposent &eacute;galement d'autres param&egrave;tres. Pour plus d'informations sur les cl&eacute;s d'acc&egrave;s, consultez la
section A propos de la s&eacute;curit&eacute;, page 15. Pour plus de d&eacute;tails sur les param&egrave;tres suppl&eacute;mentaires
correspondant &agrave; une action donn&eacute;e, consultez la documentation de cette action dans le
Chapitre 3, Guide de r&eacute;f&eacute;rence des actions, page 27.
Utilisez l'une des m&eacute;thodes suivantes pour transmettre les param&egrave;tres au serveur :
• Cr&eacute;ez une cha&icirc;ne de requ&ecirc;te — une URL qui inclut les param&egrave;tres de la requ&ecirc;te — et
•
transmettez-la au serveur sous forme de requ&ecirc;te HTTP, GET ou POST, dont le contenu est d&eacute;fini
sur &quot;application/x-www-form-urlencoded&quot;. (Dans la plupart des cas, il n'est pas n&eacute;cessaire
de d&eacute;finir le type de contenu de fa&ccedil;on explicite lorsque vous appliquez cette m&eacute;thode.)
L'URL &agrave; utiliser pour la cha&icirc;ne de requ&ecirc;te prend la forme http://breeze.exemple.com/api/
xml?action=nom_action&amp;accesskey=cl&eacute;_acc&egrave;s. Les autres param&egrave;tres de l'action sont ajout&eacute;s en
tant que param&egrave;tres de requ&ecirc;te en option et s&eacute;par&eacute;s par des signes &amp;.
Cr&eacute;e un objet XML contenant les param&egrave;tres sous forme de balises param contenues dans une
balise params, puis envoie une requ&ecirc;te HTTP POST au serveur, dont le type de contenu HTTP
est d&eacute;fini sur &quot;text/xml&quot;.
Pour consulter un exemple de code indiquant comment appeler une action, reportez-vous au
Chapitre 2, T&acirc;ches courantes, page 19.
Remarque : L'exemple de code figurant dans ce document utilise l'approche avec param&egrave;tres de
requ&ecirc;te, pour plus de clart&eacute; et parce que l'utilisation du code CFML pour envoyer des objets XML
contenant des param&egrave;tres est soumise &agrave; certaines limitations. Macromedia recommande d'utiliser la
m&eacute;thode POST si possible ; en raison de la fa&ccedil;on dont le code HTTP impl&eacute;mente les m&eacute;thodes GET et
POST. POST permet de renforcer la s&eacute;curit&eacute; lorsque vous passez des param&egrave;tres dans la cha&icirc;ne de
requ&ecirc;te. Pour plus d'informations, consultez la section A propos de la s&eacute;curit&eacute;, page 15.
A propos des param&egrave;tres
La plupart des actions permettent de sp&eacute;cifier un ou plusieurs param&egrave;tres.
Vous pouvez g&eacute;n&eacute;ralement sp&eacute;cifier les param&egrave;tres sous forme de paire nom-valeur, mais le
processus exact d&eacute;pend du langage utilis&eacute; pour appeler l'action sur le serveur Breeze. Pour
consulter un exemple de code en langage CFML (ColdFusion Markup Language), consultez le
chapitre Chapitre 2, T&acirc;ches courantes, page 19.
La documentation des actions affiche les param&egrave;tres requis. Les param&egrave;tres facultatifs sont
signal&eacute;s de fa&ccedil;on explicite.
A propos des param&egrave;tres
13
Certaines actions permettent de fournir plusieurs param&egrave;tres du m&ecirc;me nom. Par exemple,
l'action principals-delete prend un param&egrave;tre appel&eacute; principal-id. Vous pouvez sp&eacute;cifier
plusieurs paires nom-valeur principal-id (portant toutes le nom principal-id) lorsque vous
appelez l'action sur le serveur Breeze. L'exemple de code CFML suivant illustre comment
supprimer deux utilisateurs sp&eacute;cifi&eacute;s &agrave; l'aide d'un appel d'action unique, en sp&eacute;cifiant deux
param&egrave;tres principal-id. (Cet exemple recourt aux variables baseurl, accesskey et
loginCookie que vous avez d&eacute;finies pendant le processus de connexion. Pour plus de d&eacute;tails,
consultez la section Sc&eacute;nario : Int&eacute;gration de Breeze &agrave; un service d’annuaire, page 19.)
&lt;cfset idOne=12345&gt;
&lt;cfset idTwo=23456&gt;
&lt;cfhttp url=&quot;#baseurl#api/xml?action=principalsdelete&amp;accesskey=#accesskey#&amp;principal-id=#idOne#&amp;principal-id=#idTwo#&quot;
method=&quot;post&quot;&gt;
&lt;cfhttpparam type=&quot;Cookie&quot; name=&quot;JSESSIONID&quot; value=&quot;#loginCookie#&quot;&gt;
&lt;/cfhttp&gt;
Certaines actions permettent de fournir des jeux de param&egrave;tres multiples. Par exemple, l'action
group-membership-update prend les param&egrave;tres group-id, principal-id, et is-member pour
proc&eacute;der &agrave; plusieurs mises &agrave; jour suite &agrave; un appel unique. Sp&eacute;cifiez chacun de ces param&egrave;tres pour
le mandant et le groupe, puis sp&eacute;cifiez-les (en conservant les m&ecirc;mes noms de param&egrave;tre) pour un
autre, etc.
A propos des mandants, des entit&eacute;s SCO et des identifiants
Breeze comporte deux types d'identit&eacute;s de base : les mandants et les SCO (Shareable Content
Objects).
Le terme mandant couvre toutes les entit&eacute;s qui disposent d'autorisations r&eacute;gissant leurs
interactions avec les entit&eacute;s SCO. Vous trouverez ci-dessous les principaux types de mandant :
Un utilisateur sp&eacute;cifique.
user
Un groupe d'utilisateurs.
group
Il existe d'autres types de mandants, appel&eacute;s &laquo; groupes primaires &raquo; : &quot;admins&quot;, &quot;authors&quot;,
et &quot;course-admins&quot;. Pour plus d'informations sur les groupes primaires,
consultez la section Utilisation de Breeze Manager.
&quot;live-admins&quot;
Vous pouvez cr&eacute;er et modifier des utilisateurs et des groupes, mais pas des groupes primaires.
Une entit&eacute; SCO est un document Breeze, tel qu'une r&eacute;union ou une pr&eacute;sentation. Les dossiers
sont &eacute;galement des SCO.
Breeze Inclut les deux types d'entit&eacute; SCO suivants :
La racine d'une hi&eacute;rarchie de dossiers. La racine d'une arborescence est trait&eacute;e en tant que
hi&eacute;rarchie ind&eacute;pendante. Vous ne pouvez pas d&eacute;terminer le dossier parent d'une arborescence &agrave;
partir de cette arborescence.
tree
folder
Un dossier sur le disque dur du serveur qui renferme le contenu Breeze.
presentation
course
meeting
flv
14
Une pr&eacute;sentation.
Un cours.
Une r&eacute;union.
Un fichier vid&eacute;o Flash.
Chapitre 1 : Vue d'ensemble de l'architecture
swf
Un fichier SWF Flash.
Un fichier d'images.
image
session Une session de r&eacute;union. Une session commence lorsqu'une personne p&eacute;n&egrave;tre dans une
salle de r&eacute;union vide et se termine lorsque la derni&egrave;re personne quitte la salle.
archive
Une r&eacute;union archiv&eacute;e.
attachment
Un fichier partag&eacute; utilisant le module de partage de fichiers au cours d'une
r&eacute;union.
pod
Un plug-in de r&eacute;union.
Une image (telle qu'un logo d'entreprise) qui peut &ecirc;tre attach&eacute;e &agrave; du contenu, tel qu'une
pr&eacute;sentation.
logos
Chaque mandant et entit&eacute; SCO dispose d'un identifiant num&eacute;rique unique. Lorsque vous
appelez une action qui utilise l'identifiant d'une entit&eacute; en tant que param&egrave;tre, le nom de
param&egrave;tre indique le type d'entit&eacute; auquel l'identifiant appartient, mais cet identifiant reste le
m&ecirc;me quel que soit le nom de param&egrave;tre. Les noms de param&egrave;tres qui s'appliquent aux
identifiants incluent acl-id, folder-id, group-id, parent-acl-id, principal-id, sco-id et
user-id.
Par exemple, pour mettre &agrave; jour un mot de passe utilisateur, appelez l'action user-update-pwd et
donnez l'identifiant de l'utilisateur en tant que param&egrave;tre user-id. Pour d&eacute;terminer un nom
d'utilisateur, appelez l'action principal-info et donnez l'identifiant de l'utilisateur en tant que
param&egrave;tre principal-id.
Vous disposez de quelques autres types d'identifiants, tels que account-id, answer-id,
permission-id et question-id. Dans la plupart des cas, un nom de param&egrave;tre qui se termine en
-id indique que la valeur de ce param&egrave;tre est un identifiant de mandant ou d'entit&eacute; SCO.
A propos de la s&eacute;curit&eacute;
Le mod&egrave;le de s&eacute;curit&eacute; de Breeze garantit que tout code appelant une action donn&eacute;e a &eacute;t&eacute; autoris&eacute;.
Pratiquement tous les appels d'action incluent deux types d'informations d'identification : une cl&eacute;
d'acc&egrave;s et un cookie qui repr&eacute;sentent un utilisateur connect&eacute; donn&eacute;.
La cl&eacute; d'acc&egrave;s ou &laquo; cl&eacute; de connexion &raquo; est un code permettant de prot&eacute;ger le serveur contre toute
utilisation non autoris&eacute;e. Toute action (ce qui inclut login) n&eacute;cessite une cl&eacute; d'acc&egrave;s, que vous
sp&eacute;cifiez en tant que param&egrave;tre appel&eacute; accesskey. Les cl&eacute;s d'acc&egrave;s tiennent compte des
majuscules et des minuscules.
Seuls les utilisateurs connect&eacute;s peuvent appeler la plupart des actions. Par cons&eacute;quent, vous devez
appeler l'action login avant toute autre action. (Les exceptions, les actions qui ne n&eacute;cessitent pas
de connexion pr&eacute;alable, sont accesskey-exec, action-list, common-info, login et useraccounts.)
Lors de la connexion, le serveur Breeze renvoie des r&eacute;sultats en code XML pour indiquer si la
connexion a r&eacute;ussi. Les en-t&ecirc;tes HTTP de ces r&eacute;sultats incluent un cookie appel&eacute; JSESSIONID.
Lorsque vous recevez les r&eacute;sultats d'un appel login, vous devez enregistrer la valeur de ce cookie
de fa&ccedil;on &agrave; pouvoir l'utiliser par la suite. Vous devez ensuite inclure la valeur de ce cookie dans
toutes les requ&ecirc;tes transmises ult&eacute;rieurement avec cet identifiant. Pour obtenir des exemples,
consultez le Chapitre 2, T&acirc;ches courantes, page 19.
A propos de la s&eacute;curit&eacute;
15
Pour appeler une action avec succ&egrave;s, par cons&eacute;quent, vous devez fournir une cl&eacute; d'acc&egrave;s et le
cookie correspondant &agrave; l'utilisateur connect&eacute; qui dispose d'autorisations pour appeler cette
action. Si vous ne fournissez pas ces deux informations d'identification (par exemple, si vous
fournissez le cookie d'un utilisateur qui ne dispose pas des bonnes autorisations), l'action &eacute;choue.
Votre application permet de connecter plusieurs utilisateurs et d'appeler des actions quel que soit
l'utilisateur. Par exemple, lorsqu'un utilisateur ordinaire ex&eacute;cute votre application, il peut &ecirc;tre
n&eacute;cessaire d'utiliser les informations d'identification de cet utilisateur tout en conservant une
connexion administrateur pour effectuer les t&acirc;ches n&eacute;cessitant ce niveau d'autorisation.
Pour plus de d&eacute;tails sur les codes d'&eacute;tat pouvant &ecirc;tre renvoy&eacute;s par le serveur, consultez la section
relative &agrave; la balise status.
Cl&eacute;s d'acc&egrave;s pour les clients dont le compte est h&eacute;berg&eacute; sur un syst&egrave;me
Macromedia Breeze (ASP)
Par d&eacute;faut, votre compte n'est pas activ&eacute; pour les services Web XML. Vous devez contacter le
service de support technique de Macromedia pour obtenir une cl&eacute; d'acc&egrave;s XML valide &agrave; utiliser
en conjonction avec les actions.
Pour contacter le centre de support technique, consultez la page de support de Breeze (http://
www.macromedia.com/support/breeze/) et demandez la g&eacute;n&eacute;ration d'une cl&eacute; d'acc&egrave;s XML pour
votre compte.
Cl&eacute;s d'acc&egrave;s pour les clients dont le compte est h&eacute;berg&eacute; sur un syst&egrave;me
Macromedia Breeze Enterprise (sous licence)
Le serveur ne dispose pas d'une cl&eacute; d'acc&egrave;s XML en standard. Vous devez ajouter cette cl&eacute; avant
d'utiliser les services Web XML.
Pour ajouter une cl&eacute; d'acc&egrave;s :
1 Recherchez le fichier custom.ini dans le sous-r&eacute;pertoire breeze du r&eacute;pertoire d'installation.
2 Ajoutez un param&egrave;tre &agrave; la fin du fichier en tapant le code suivant sur une nouvelle ligne :
XML_API_KEY=
3 Juste apr&egrave;s le signe &eacute;gal, sur la m&ecirc;me ligne, tapez une cl&eacute; d'acc&egrave;s. Cette cl&eacute; doit comporter 16
caract&egrave;res et doit comporter des chiffres et des lettres. Les cl&eacute;s d'acc&egrave;s tiennent compte des
majuscules et des minuscules.
4 Arr&ecirc;tez le serveur Breeze, puis red&eacute;marrez-le.
A propos des autorisations
Les autorisations r&eacute;gissent les interactions entre un mandant et une entit&eacute; SCO.
L'association d'autorisations &agrave; un mandant en fonction d'une entit&eacute; SCO donn&eacute;e est appel&eacute;e
ACL. Tout ACL comprend trois &eacute;l&eacute;ments d'information : l'identifiant d'un SCO (g&eacute;n&eacute;ralement
appel&eacute; identifiant d'ACL dans ce contexte), l'identifiant d'un mandant et un un mot cl&eacute; sp&eacute;cifiant
les autorisations (g&eacute;n&eacute;ralement d&eacute;sign&eacute; comme identifiant d'autorisation).
Breeze dispose de deux types d'autorisation : les autorisations associ&eacute;es &agrave; des SCO sp&eacute;cifiques et
les autorisations qui s'appliquent &agrave; l'ensemble des utilisateurs qui appartiennent &agrave; des groupes
sp&eacute;ciaux, appel&eacute;s groupes primaires. Les autorisations relatives aux groupes primaires sont
prioritaires par rapport aux autorisations d&eacute;finies sur une entit&eacute; SCO.
16
Chapitre 1 : Vue d'ensemble de l'architecture
Pour identifier les autorisations d'un utilisateur connect&eacute; sur un &eacute;l&eacute;ment donn&eacute;, appelez l'action
permissions-info. Pour modifier les autorisations d'un mandant, appelez l'action principalupdate.
Si un mandant ne dispose pas d'autorisations sp&eacute;cifiques sur une entit&eacute; SCO donn&eacute;e, les
autorisations de ce mandant sur le parent du SCO s'appliquent.
Vous pouvez sp&eacute;cifier les autorisations suivantes sur un SCO :
Le mandant peut afficher l'entit&eacute; SCO, mais ne peut pas la modifier. Dans le cadre d'un
cours, l'autorisation view permet au mandant de s'inscrire. Dans le cadre d'une r&eacute;union, view
permet au mandant de participer. Dans le cadre d'un dossier, view permet au mandant d'afficher
le contenu.
view
publish Le mandant peut publier l'entit&eacute; SCO sur le serveur et la mettre &agrave; jour. Cette
autorisation inclut l'autorisation view. Elle permet &eacute;galement au mandant d'afficher des rapports
en relation avec le SCO. Pour un dossier, publish ne permet pas au mandant de cr&eacute;er de
nouveaux dossiers dans le dossier ou de d&eacute;finir des autorisations pour ce dernier. Vous ne pouvez
pas appliquer cette autorisation &agrave; des r&eacute;unions ou des cours.
manage Le mandant peut afficher, supprimer, d&eacute;placer et modifier l'entit&eacute; SCO. Cette
autorisation permet &eacute;galement au mandant de d&eacute;finir des autorisations pour l'entit&eacute; SCO.
Lorsqu'il s'agit d'un dossier, l'autorisation manage permet au mandant d'afficher des rapports sur
les fichiers contenus dans le dossier et de cr&eacute;er de nouveaux dossiers. Vous ne pouvez pas associer
cette autorisation &agrave; des r&eacute;unions ou des cours.
Le mandant ne peut pas afficher, acc&eacute;der &agrave; ou g&eacute;rer l'entit&eacute; SCO. Vous ne pouvez pas
associer cette autorisation &agrave; des r&eacute;unions ou des cours.
denied
(R&eacute;unions uniquement) Le mandant peut cr&eacute;er ou pr&eacute;senter une r&eacute;union. Cette
autorisation permet au mandant de cr&eacute;er ou pr&eacute;senter la r&eacute;union, m&ecirc;me si le mandant ne dispose
pas d'une autorisation view pour le dossier parent de la r&eacute;union.
presenter
Dans la mesure o&ugrave; un groupe constitue un mandant, vous pouvez d&eacute;finir les autorisations cit&eacute;es
ci-dessus sur une entit&eacute; SCO pour un groupe non primaire ou un utilisateur donn&eacute;. Si un groupe
dispose d'une autorisation sp&eacute;cifique, tous les membres en h&eacute;ritent. Utilisez l'action groupmembership-update pour ajouter un membre &agrave; un groupe. Utilisez l'action permissionsupdate pour d&eacute;finir les autorisations d'un groupe en fonction d'une entit&eacute; SCO donn&eacute;e.
Le seul moyen d'obtenir certains types d'autorisation est d'appartenir &agrave; un groupe primaire,
comme indiqu&eacute; ci-dessous :
permet &agrave; ses membres de cr&eacute;er ou modifier une pr&eacute;sentation
dans tout le syst&egrave;me, quelles que soient les autorisations ACL.
Le groupe primaire des auteurs
Le groupe primaire des administrateurs
permet de g&eacute;rer des utilisateurs et des groupes.
Le groupe primaire des administrateurs de r&eacute;union permet de cr&eacute;er et de pr&eacute;senter des
r&eacute;unions dans tout le syst&egrave;me, quelles que soient les autorisations ACL.
Le groupe primaire des gestionnaires de cours permet de cr&eacute;er et de modifier des r&eacute;unions
dans tout le syst&egrave;me, quelles que soient les autorisations ACL.
Pour acc&eacute;der &agrave; l'ensemble du syst&egrave;me, vous devez &ecirc;tre membre des quatre groupes primaires.
A propos de la s&eacute;curit&eacute;
17
A propos des autorisations d'acc&egrave;s public
Il existe un identifiant sp&eacute;cial de mandant qui n'a pas de valeur num&eacute;rique : &quot;public-access&quot;.
Cet identifiant d&eacute;finit les param&egrave;tres globaux d'acc&egrave;s, en ligne ou hors connexion. Vous pouvez
attribuer les autorisations suivantes &agrave; une entit&eacute; SCO pour le mandant public-access :
denied
view
Personne ne peut afficher, acc&eacute;der &agrave; ou g&eacute;rer l'entit&eacute; SCO.
Tout le monde peut afficher l'entit&eacute; SCO, m&ecirc;me hors connexion.
(Pr&eacute;sentation uniquement) Tout le monde peut afficher la pr&eacute;sentation, m&ecirc;me hors
connexion. Cependant, les autorisations d&eacute;finies sur le dossier parent de la pr&eacute;sentation ne
s'appliquent pas &agrave; cette derni&egrave;re. Par exemple, m&ecirc;me si un utilisateur dispose d'une autorisation
manage sur le dossier parent, l'utilisateur ne peut pas supprimer les pr&eacute;sentations dont
l'autorisation est view-only. (Les autorisations normales s'appliquent toujours &agrave; la pr&eacute;sentation.
Si l'utilisateur dispose d'une autorisation manage sur la pr&eacute;sentation, il peut la supprimer.)
view-only
(R&eacute;unions uniquement) Tout le monde peut participer &agrave; la r&eacute;union, m&ecirc;me hors
connexion. Cependant, les autorisations d&eacute;finies sur le dossier parent de la r&eacute;union ne
s'appliquent pas &agrave; cette derni&egrave;re.
view-hidden
N'attribuez pas les autorisations manage, presenter ou publish au mandant public-access.
N'attribuez pas les autorisations view-only ou view-hidden &agrave; des mandants ordinaires.
A propos de la s&eacute;curit&eacute; et du lancement du contenu
Lorsque vous lancez une entit&eacute; SCO, vous devez fournir une authentification. Pour ce faire,
utilisez l'une des approches suivantes :
• Lorsque vous ouvrez l'URL du contenu, ajoutez un param&egrave;tre de requ&ecirc;te appel&eacute; session dont
la valeur doit &ecirc;tre &eacute;gale &agrave; celle du cookie de connexion, comme indiqu&eacute; dans l'exemple
suivant :
http://breeze.exemple.com/p12345678/?session=breez3238uf298
•
•
18
Cette approche risque de remettre en cause la s&eacute;curit&eacute;, dans la mesure o&ugrave; toute personne
disposant de l'URL sp&eacute;cifi&eacute;e peut se comporter en tant qu'utilisateur connect&eacute;. Par
cons&eacute;quent, utilisez le cookie d'un utilisateur ordinaire et non pas celui d'un administrateur.
En outre, si un utilisateur transmet l'URL &agrave; quelqu'un d'autre (dans un message &eacute;lectronique,
par exemple), il donne acc&egrave;s &agrave; son compte, ce qui repr&eacute;sente &eacute;galement un risque d'atteinte &agrave; la
s&eacute;curit&eacute;.
Vous pouvez d&eacute;finir un cookie JSESSIONID sur le navigateur d'un utilisateur, en appliquant
la valeur du cookie de connexion.
Cependant, cette approche ne peut fonctionner que si votre application fonctionne sur un
serveur utilisant le m&ecirc;me nom de domaine que le serveur Breeze.
En outre, si votre serveur d'applications fonctionne dans un environnement de servlet J2EE
(tel que ColdFusion ou Java), le serveur d'application doit &eacute;galement utiliser un cookie appel&eacute;
JSESSIONID, ce qui risque de provoquer un conflit entre Breeze et le serveur d'applications.
Vous pouvez vous contenter d'ouvrir l'URL et de demander &agrave; l'utilisateur de se connecter de
nouveau.
Cette approche est plus s&ucirc;re, mais moins pratique du point de vue des utilisateurs.
Chapitre 1 : Vue d'ensemble de l'architecture
CHAPITRE 2
T&acirc;ches courantes
Ce chapitre d&eacute;crit des sc&eacute;narios typiques d’int&eacute;gration de Macromedia Breeze &agrave; des applications
ou syst&egrave;mes externes. Ces sc&eacute;narios illustrent la mise en œuvre de diverses t&acirc;ches courantes. Pour
effecturer ces t&acirc;ches, l’utilisateur appelle une ou plusieurs actions sur le serveur Breeze, puis les
balises XML renvoy&eacute;es par le serveur sont analys&eacute;es. Dans certains cas, les informations renvoy&eacute;es
sont utilis&eacute;es comme param&egrave;tres pour l’action suivante.
Ce chapitre comporte des exemples de code montrant la mise en œuvre de certaines t&acirc;ches &agrave; l’aide
du langage CFML ( ColdFusion Markup Language) de Macromedia.
Remarque : Certaines descriptions ne sont pas accompagn&eacute;es d’exemples de code. La syntaxe
d’appel d’une action est similaire pour toutes les actions. Il est donc possible d’utiliser les exemples de
code fournis comme mod&egrave;les pour accomplir d’autres t&acirc;ches.
Chaque appel d’une action sur le serveur Breeze doit comporter une cl&eacute; d’acc&egrave;s et des
informations d'identification permettant de conna&icirc;tre l’auteur authentifi&eacute; de l’action. Pour plus
d’informations sur le mod&egrave;le de s&eacute;curit&eacute; de Breeze, en particulier sur les cl&eacute;s d’acc&egrave;s, consultez la
section A propos de la s&eacute;curit&eacute;, page 15.
Pour une description d&eacute;taill&eacute;e de chaque action et de chaque balise XML, voir Chapitre 3, Guide
de r&eacute;f&eacute;rence des actions, page 27 et Chapitre 4, R&eacute;f&eacute;rences pour les r&eacute;sultats XML, page 61.
Sc&eacute;nario : Int&eacute;gration de Breeze &agrave; un service d’annuaire
Supposons que votre organisation utilise un r&eacute;f&eacute;rentiel central pour toutes les informations sur les
utilisateurs, par exemple LDAP (Lightweight Directory Access Protocol). Breeze permet
d’importer ou synchroniser ces informations &agrave; partir de ce service d’annuaire.
La proc&eacute;dure ci-dessous d&eacute;crit les &eacute;tapes que doit suivre votre application pour effectuer cette
t&acirc;che. Cette proc&eacute;dure part du principe que si les informations transmises par le service
d’annuaire ne correspondent pas aux informations fournies par le serveur Breeze, ce sont celles qui
proviennent du service d’annuaire qui sont correctes et actuelles.
Pour synchroniser Breeze avec le service d’annuaire :
1 Connectez-vous en appelant l’action login sur le serveur Breeze, en indiquant l’identifiant de
connexion et le mot de passe d’un administrateur de comptes. Dans les en-t&ecirc;tes HTTP
renvoy&eacute;s, recherchez la valeur du cookie JSESSIONID. Ce param&egrave;tre est n&eacute;cessaire pour
appeler les actions suivantes.
19
Remarque : Il peut &ecirc;tre utile de cr&eacute;er un utilisateur dot&eacute; de privil&egrave;ges d’administration,
sp&eacute;cifiquement charg&eacute; des synchronisations. Dans ce cas, il est conseill&eacute; d’exclure cet utilisateur
de la liste des utilisateurs &agrave; synchroniser.
L’exemple de code suivant ouvre une session utilisateur et r&eacute;cup&egrave;re la valeur du cookie :
&lt;cfset
&lt;cfset
&lt;cfset
&lt;cfset
login=&quot;pierre@exemple.com&quot;&gt;
password=&quot;abcdefg&quot;&gt;
accesskey=&quot;0123456789101112&quot;&gt;
baseurl=&quot;http://breeze.exemple.com/&quot;&gt;
&lt;cfset params=&quot;accesskey=#accesskey#&amp;action=login&amp;login=#login#&amp;password=
#password#&quot;&gt;
&lt;cfhttp url=&quot;#baseurl#api/xml?#params#&quot; method=&quot;get&quot;&gt;
&lt;cfset loginHeaders= &quot;#cfhttp.ResponseHeader#&quot; /&gt;
&lt;cfloop collection=&quot;#loginHeaders#&quot; item=&quot;httpHeader&quot;&gt;
&lt;cfif httpHeader eq &quot;Set-Cookie&quot;&gt;
&lt;cfset value= loginHeaders[httpHeader] /&gt;
&lt;cfset cookieHeader=&quot;#value[1]#&quot; /&gt;
&lt;cfloop list=&quot;#cookieHeader#&quot; index=&quot;c&quot; delimiters=&quot;;&quot;&gt;
&lt;cfset cookieName= Left(c, Find('=', c)-1) /&gt;
&lt;cfif cookieName eq &quot;JSESSIONID&quot;&gt;
&lt;cfset fullCookie= mid(c, len(cookieName)+2,
len(c)-len(cookieName)+1) /&gt;
&lt;cfset loginCookie= Left(fullCookie, Find('.', fullCookie)-1) /&gt;
&lt;/cfif&gt;
&lt;/cfloop&gt;
&lt;/cfif&gt;
&lt;/cfloop&gt;
2 Pour v&eacute;rifier que l’action login s’est termin&eacute;e correctement, analysez le code XML renvoy&eacute; et
examinez la valeur de l’attribut code de la balise status. Si le code d’&eacute;tat n’est pas &quot;ok&quot;,
d&eacute;terminez l’origine de l’erreur et prenez les mesures appropri&eacute;es.
&lt;cfset xml= XmlParse(cfhttp.FileContent)&gt;
&lt;cfset resultsElement= XmlSearch(xml, &quot;//status[@code='ok']&quot;)&gt;
&lt;cfif ArrayLen(resultsElement) ne 1&gt;
&lt;!--- Pas de code d’&eacute;tat &quot;ok&quot;. V&eacute;rifier les autres codes d’&eacute;tat pour
traiter les erreurs. ---&gt;
&lt;/cfif&gt;
3 Appelez l’action principal-list pour demander au serveur Breeze une liste des utilisateurs
de Breeze. Le serveur renvoie la liste compl&egrave;te de tous les mandants, y compris ceux qui ne sont
pas des utilisateurs. (Pour plus d'informations sur les mandants, consultez A propos des
mandants, des entit&eacute;s SCO et des identifiants, page 14.
Le code ci-dessous appelle l’action principal-list. Notez que la valeur de cookie re&ccedil;ue &agrave;
l’&eacute;tape pr&eacute;c&eacute;dente est pass&eacute;e en param&egrave;tre HTTP.
&lt;cfhttp url=&quot;#baseurl#api/xml?action=principal-list&amp;accesskey=#accesskey#&quot;
method=&quot;post&quot;&gt;
&lt;cfhttpparam type=&quot;Cookie&quot; name=&quot;JSESSIONID&quot; value=&quot;#loginCookie#&quot;&gt;
&lt;/cfhttp&gt;
Remarque : Cette requ&ecirc;te HTTP utilise la m&eacute;thode &quot;post&quot; et non pas &quot;get&quot;, car &quot;post&quot;
repr&eacute;sente la seule m&eacute;thode permettant de sp&eacute;cifier un param&egrave;tre HTTP en CFML. Toutefois,
l’URL et les param&egrave;tres de la requ&ecirc;te restent les m&ecirc;mes que pour &quot;get&quot;.
20
Chapitre 2 : T&acirc;ches courantes
4 Pour v&eacute;rifier que l’action s’est termin&eacute;e correctement, analysez le code XML renvoy&eacute; et v&eacute;rifiez
que la valeur de l’attribut code de la balise status est &quot;ok&quot;. Il est conseill&eacute; de v&eacute;rifier la balise
status du code XML renvoy&eacute; apr&egrave;s chaque action.
5 Si le code d’&eacute;tat est &quot;ok&quot;, recherchez la liste des mandants qui a &eacute;t&eacute; renvoy&eacute;e, afin de trouver
tous les mandants dont l’attribut type est user. L’exemple de code ci-dessous place la liste de
tous les utilisateurs de Breeze dans le tableau allUsers.
&lt;cfset xmlPrincipalList= XmlParse(cfhttp.FileContent)&gt;
&lt;cfset allUsers = XmlSearch(xmlPrincipalList, &quot;//principal [@type='user']&quot;)&gt;
6 R&eacute;cup&eacute;rez la liste de tous les utilisateurs figurant dans le service d’annuaire. La proc&eacute;dure exacte
d&eacute;pend du service d’annuaire utilis&eacute;.
7 Comparez les valeurs contenues dans la balise login des utilisateurs de Breeze aux adresses email du service d’annuaire, en utilisant l’algorithme de comparaison de listes de votre choix.
D&eacute;terminez les utilisateurs qui figurent dans le service d’annuaire mais pas dans Breeze ; ces
nouveaux utilisateurs doivent &ecirc;tre ajout&eacute;s &agrave; Breeze. D&eacute;terminez ensuite les utilisateurs qui
figurent dans Breeze , mais pas dans le service d’annuaire ; ces utilisateurs doivent &ecirc;tre
supprim&eacute;s de Breeze. Enfin, d&eacute;terminez les utilisateurs qui apparaissent &agrave; la fois dans Breeze et
dans le service d’annuaire, mais sous des noms diff&eacute;rents ; les noms de ces utilisateurs doivent
&ecirc;tre chang&eacute;s dans Breeze.
8 Ajoutez dans Breeze tous les utilisateurs apparaissant dans le service d’annuaire mais pas dans
Breeze, en proc&eacute;dant comme suit :
a Extrayez du service d’annuaire le pr&eacute;nom, le nom et l’identifiant de connexion de chaque
utilisateur.
Dans Breeze, l’identifiant de connexion de l'utilisateur est g&eacute;n&eacute;ralement son adresse
&eacute;lectronique.
b Appelez l’action principal-update en d&eacute;finissant le param&egrave;tre type comme user.
Ne sp&eacute;cifiez pas de param&egrave;tre principal-id. L’absence de ce param&egrave;tre indique que vous
n’actualisez pas un utilisateur existant, mais que vous ajoutez un nouvel utilisateur.
c Dans le code XML renvoy&eacute;, v&eacute;rifiez que le code d’&eacute;tat est &quot;ok&quot;.
L’exemple de code ci-dessous montre comment ajouter un utilisateur &agrave; Breeze. Il fait appel &agrave;
des variables d&eacute;finies ant&eacute;rieurement, par exemple baseurl. Pour pr&eacute;server la simplicit&eacute; et la
clart&eacute; de cet exemple, ce code sp&eacute;cifie les informations sur l’utilisateur dans les premi&egrave;res lignes,
au lieu de les extraire d’un service d’annuaire.
&lt;cfset newlogin= &quot;jacques2@exemple.com&quot;&gt;
&lt;cfset newpass= &quot;abcdefg&quot;&gt;
&lt;cfset newfirst= &quot;Jacques&quot;&gt;
&lt;cfset newlast= &quot;Durand&quot;&gt;
&lt;cfhttp url=&quot;#baseurl#api/xml?
action=principal-update&amp;accesskey=#accesskey#&amp;first-name=#newfirst#
&amp;last-name=#newlast#&amp;has-children=0&amp;login=#newlogin#
&amp;type=user&quot; method=&quot;post&quot;&gt;
&lt;cfhttpparam type=&quot;Cookie&quot; name=&quot;JSESSIONID&quot; value=&quot;#loginCookie#&quot;&gt;
&lt;/cfhttp&gt;
&lt;!--- V&eacute;rifier que le code d’&eacute;tat est ‘ok’. ---&gt;
&lt;cfset xml= XmlParse(cfhttp.FileContent)&gt;
&lt;cfset resultsElement= XmlSearch(xml, &quot;//status[@code='ok']&quot;)&gt;
&lt;cfif ArrayLen(resultsElement) ne 1&gt;
&lt;!--- Pas de code d’&eacute;tat &quot;ok&quot;. V&eacute;rifier les autres codes d’&eacute;tat pour
traiter les erreurs. ---&gt;
&lt;/cfif&gt;
Sc&eacute;nario : Int&eacute;gration de Breeze &agrave; un service d’annuaire
21
9 Supprimez de Breeze chaque utilisateur qui appara&icirc;t dans Breeze mais pas dans le service
d’annuaire. Pour ce faire, appelez l’action principals-delete en indiquant l’ID de cet
utilisateur. Dans le code XML renvoy&eacute;, v&eacute;rifiez que le code d’&eacute;tat est &quot;ok&quot;.
L’exemple de code ci-dessous montre comment supprimer un utilisateur :.
&lt;cfset userID= &quot;503123&quot;&gt;
&lt;cfhttp url=&quot;#baseurl#api/xml?
action=principals-delete&amp;accesskey=#accesskey#
&amp;principal-id=#userID#&quot; method=&quot;post&quot;&gt;
&lt;cfhttpparam type=&quot;Cookie&quot; name=&quot;JSESSIONID&quot; value=&quot;#loginCookie#&quot;&gt;
&lt;/cfhttp&gt;
&lt;!--- V&eacute;rifier la pr&eacute;sence du code d’&eacute;tat &quot;ok&quot;. ---&gt;
&lt;cfset xml= XmlParse(cfhttp.FileContent)&gt;
&lt;cfset resultsElement= XmlSearch(xml, &quot;//status[@code='ok']&quot;)&gt;
&lt;cfif ArrayLen(resultsElement) ne 1&gt;
&lt;!--- Pas de code d’&eacute;tat &quot;ok&quot;. V&eacute;rifier les autres codes d’&eacute;tat pour
traiter les erreurs. ---&gt;
&lt;/cfif&gt;
10 Extrayez l’ID de chaque utilisateur dont les informations dans Breeze doivent &ecirc;tre actualis&eacute;es :
a Examinez les donn&eacute;es renvoy&eacute;es par l’action principal-list dans les &eacute;tapes 2 &agrave; 4, et
recherchez l’ID associ&eacute; &agrave; l'identifiant de connexion de l'utilisateur.
b Appelez l’action principal-info pour extraire les anciennes valeurs de pr&eacute;nom et de nom
de l’utilisateur.
c Modifiez ces valeurs de fa&ccedil;on appropri&eacute;e pour qu’elles soient identiques &agrave; celles contenues
dans le service d’annuaire.
d Appelez l’action principal-update.
e Dans le code XML renvoy&eacute;, v&eacute;rifiez que le code d’&eacute;tat est &quot;ok&quot;.
L’exemple de code ci-dessous ne comporte pas l’appel de principal-update ni la
v&eacute;rification du code d’&eacute;tat, puisque ces proc&eacute;dures ont &eacute;t&eacute; d&eacute;crites ci-dessus.
&lt;cfset principal= XmlSearch(xmlPrincipalList,
&quot;//principal[login='#login#']&quot;)&gt;
&lt;cfset principalId= principal[1].XmlAttributes[&quot;principal-id&quot;]&gt;
&lt;cfhttp url=&quot;#baseurl#api/xml?
action=principal-info&amp;accesskey=#accesskey#&amp;principal-id=#principalId#
&quot; method=&quot;post&quot;&gt;
&lt;cfhttpparam type=&quot;Cookie&quot; name=&quot;JSESSIONID&quot; value=&quot;#loginCookie#&quot;&gt;
&lt;/cfhttp&gt;
...
&lt;!--- Ajouter ici le code de v&eacute;rification de la pr&eacute;sence du code d’&eacute;tat
&quot;ok&quot;. ---&gt;
...
&lt;cfset xml= XmlParse(cfhttp.FileContent)&gt;
&lt;cfset firstElement= XmlSearch(xml, &quot;results/contact/first-name&quot;)&gt;
&lt;cfset firstName= firstElement[1].XmlText&gt;
&lt;cfset lastElement= XmlSearch(xml, &quot;results/contact/last-name&quot;)&gt;
&lt;cfset lastName= lastElement[1].XmlText&gt;
...
&lt;!--- Ajouter ici le code attribuant de nouvelles valeurs de pr&eacute;nom et de
nom, appeler principal-update, et v&eacute;rifier la pr&eacute;sence du code d’&eacute;tat
&quot;ok&quot;. ---&gt;
22
Chapitre 2 : T&acirc;ches courantes
Sc&eacute;nario : Int&eacute;gration de Breeze &agrave; un portail
Supposons que vous administrez une application portail, par exemple le portail de l’intranet de
votre entreprise. Vous pouvez int&eacute;grer Breeze &agrave; ce portail pour permettre aux utilisateurs de voir et
modifier les informations relatives &agrave; Breeze dans le contexte du portail. Cela permettra par
exemple aux utilisateurs de voir les prochaines r&eacute;unions Breeze et de consulter la liste des cours
auxquels ils sont inscrits.
Les proc&eacute;dures d&eacute;crites dans cette section montrent comment accomplir diverses t&acirc;ches li&eacute;es &agrave;
l’int&eacute;gration de Breeze &agrave; une application de portail.
Pour vous connecter sous une identit&eacute; sp&eacute;cifique :
1 Utilisez un formulaire Web pour extraire l’identifiant de connexion et le mot de passe de cet
utilisateur.
2 Appelez l’action login sur le serveur Breeze en utilisant l’identifiant de connexion et le mot de
passe ainsi re&ccedil;us.
3 Dans le code XML renvoy&eacute;, v&eacute;rifiez que le code d’&eacute;tat est &quot;ok&quot;.
Pour d&eacute;terminer l’ID d’un utilisateur &agrave; partir de son identifiant de connexion et son mot de
passe :
1 Connectez-vous avec son identifiant.
2 Appelez l’action common-info.
3 Dans le code XML renvoy&eacute;, recherchez la valeur de l’attribut user-id de la balise user. Cette
valeur est l’ID de cet utilisateur.
Pour v&eacute;rifier qu’un mot de passe saisi est correct :
1 Connectez-vous avec l’identifiant de cet utilisateur.
2 Si le code d’&eacute;tat renvoy&eacute; est &quot;ok&quot;, le mot de passe est correct.
Cette proc&eacute;dure est la seule m&eacute;thode permettant de v&eacute;rifier un mot de passe ; pour des raisons
de s&eacute;curit&eacute;, Breeze ne permet pas de demander au serveur le mot de passe d’un utilisateur.
Pour obtenir la liste de tous les cours auxquels l’utilisateur s’est inscrit :
1 Connectez-vous avec l’identifiant de cet utilisateur.
2 Appelez l’action report-my-courses.
3 Analysez le code XML renvoy&eacute; et affichez les r&eacute;sultats. Pour plus d'informations sur le code
XML renvoy&eacute; par le serveur, consultez la section my-courses.
Pour obtenir la liste de toutes les r&eacute;unions auxquelles l’utilisateur doit participer :
1 Connectez-vous avec l’identifiant de cet utilisateur.
2 Appelez l’action report-my-meetings.
3 Analysez le code XML renvoy&eacute; et affichez les r&eacute;sultats. Pour plus d'informations sur le code
XML renvoy&eacute; par le serveur, consultez la section my-meetings.
Pour afficher le dossier de contenu de cet utilisateur :
1 Connectez-vous avec l’identifiant de cet utilisateur.
2 Appelez l’action sco-shortcuts.
Cette action permet d’obtenir l’emplacement du dossier racine du compte actuel, ainsi que
l’emplacement des autres dossiers (r&eacute;unions auxquelles doit participer cet utilisateur, etc.)
Sc&eacute;nario : Int&eacute;gration de Breeze &agrave; un portail
23
Le code ci-dessous utilise les m&ecirc;mes variables baseurl, accesskey et loginCookie que le
code d’ouverture de session indiqu&eacute; dans la section Sc&eacute;nario : Int&eacute;gration de Breeze &agrave; un service
d’annuaire, page 19.
&lt;cfhttp url=&quot;#baseurl#api/xml?action=sco-shortcuts&amp;accesskey=#accesskey#&quot;
method=&quot;post&quot;&gt;
&lt;cfhttpparam type=&quot;Cookie&quot; name=&quot;JSESSIONID&quot; value=&quot;#loginCookie#&quot;&gt;
&lt;/cfhttp&gt;
3 Dans les balises sco renvoy&eacute;es, recherchez l’attribut type appropri&eacute; pour d&eacute;terminer l’ID du
dossier my-content.
&lt;cfset
&lt;cfset
&lt;cfset
&lt;cfset
response= cfhttp.FileContent &gt;
xml= XmlParse(response)&gt;
contentScoElement= XmlSearch(xml, &quot;//sco[@type='my-content']&quot;)&gt;
contentSco= contentScoElement[1].XmlAttributes[&quot;sco-id&quot;]&gt;
4 Si vous souhaitez fournir des liens (sous forme d’adresses URL absolues) vers les &eacute;l&eacute;ments de
contenu, d&eacute;terminez le nom du domaine du dossier.
&lt;cfset domainElement= XmlSearch(xml,
&quot;//sco[@tree-id='#myTreeId#']/domain-name&quot;)&gt;
&lt;cfset domainName= domainElement[1].XmlText&gt;
5 Appelez l’action sco-contents en lui transmettant l’ID SCO du dossier.
Cette action renvoie la liste du contenu du dossier indiqu&eacute;.
&lt;cfhttp url=&quot;#baseurl#api/xml?
action=sco-contents&amp;accesskey=#accesskey#
&amp;sco-id=#contentSco#&quot; method=&quot;post&quot;&gt;
&lt;cfhttpparam type=&quot;Cookie&quot; name=&quot;JSESSIONID&quot; value=&quot;#loginCookie#&quot;&gt;
&lt;/cfhttp&gt;
6 Analysez le code XML renvoy&eacute; et affichez les informations appropri&eacute;es.
&lt;cfset response= cfhttp.FileContent &gt;
&lt;cfset contentXml= XmlParse(response)&gt;
&lt;cfset contents= XmlSearch(contentXml, &quot;//sco&quot;)&gt;
&lt;cfset contentCount= ArrayLen(contents)&gt;
&lt;cfoutput&gt;
&lt;table&gt;
&lt;tr&gt;
&lt;th&gt;SCO ID&lt;/th&gt;
&lt;th&gt;Name&lt;/th&gt;
&lt;th&gt;Type&lt;/th&gt;
&lt;/tr&gt;
&lt;cfloop index=&quot;i&quot; from=&quot;1&quot; to=&quot;#contentCount#&quot;&gt;
&lt;cfset item=contents[#i#]&gt;
&lt;tr&gt;
&lt;td&gt;#item.XmlAttributes[&quot;sco-id&quot;]#&lt;/td&gt;
&lt;td&gt;#item.name.XmlText#&lt;/td&gt;
&lt;td&gt;#item.XmlAttributes[&quot;type&quot;]#&lt;/td&gt;
&lt;/tr&gt;
&lt;/cfloop&gt;
&lt;/table&gt;
&lt;/cfoutput&gt;
7 Pour mettre &agrave; la disposition des utilisateurs des liens pointant directement sur des &eacute;l&eacute;ments de
contenu, appelez l’action sco-info pour chaque &eacute;l&eacute;ment, et d&eacute;terminez son adresse URL
compl&egrave;te en ins&eacute;rant le contenu de la balise url-path renvoy&eacute;e apr&egrave;s le nom de domaine que
vous avez obtenu pr&eacute;c&eacute;demment. Vous obtenez ainsi une adresse URL compl&egrave;te, par exemple
http://breeze.exemple.com/p12345678/.
24
Chapitre 2 : T&acirc;ches courantes
Pour plus d'informations sur l’activation d’un lien vers du contenu, consultez A propos de la
s&eacute;curit&eacute; et du lancement du contenu, page 18.
Pour cr&eacute;er une nouvelle r&eacute;union :
1 Connectez-vous avec l’identifiant de cet utilisateur.
2 (Facultatif) Vous pouvez permettre &agrave; l’utilisateur de choisir, dans une interface Web, le dossier
dans lequel la nouvelle r&eacute;union doit &ecirc;tre cr&eacute;&eacute;e. Si vous ne sp&eacute;cifiez pas de dossier particulier, la
r&eacute;union est cr&eacute;&eacute;e dans le dossier my-meetings (Mes r&eacute;unions). Pour d&eacute;terminer l’ID de ce
dossier de r&eacute;union par d&eacute;faut, appelez l’action sco-shortcuts.
3 Appelez l’action sco-update en lui transmettant l’ID du dossier pour le param&egrave;tre folder-id.
Ne sp&eacute;cifiez pas de param&egrave;tre pour sco-id.
4 Assurez-vous du bon r&eacute;sultat de l’action en v&eacute;rifiant le contenu de la balise status renvoy&eacute;e.
Pour rechercher du contenu :
1 Utilisez un formulaire Web pour extraire la cha&icirc;ne que l’utilisateur doit rechercher.
2 Connectez-vous avec l’identifiant de cet utilisateur.
3 Appelez l’action sco-search, en lui passant la cha&icirc;ne sp&eacute;cifi&eacute;e comme valeur du param&egrave;tre
query.
4 Dans le code XML renvoy&eacute;, recherchez les informations sur le SCO qui contiennent cette
cha&icirc;ne; et affichez les informations utiles.
Sc&eacute;nario : g&eacute;n&eacute;ration de rapports
Supposons que vous souhaitez que votre application puisse pr&eacute;senter les d&eacute;tails de tous les cours
auxquels un utilisateur est inscrit, ou identifier les utilisateurs inscrits &agrave; une r&eacute;union donn&eacute;e. Les
services Web XML de Breeze comportent un grand nombre de rapports affichant des donn&eacute;es sur
l’utilisation de Breeze.
Les donn&eacute;es des rapports sont renvoy&eacute;es dans des formulaires XML. Vous pouvez utiliser
directement les r&eacute;sultats, par exemple dans le cadre d’une application Web, ou convertir les
donn&eacute;es dans d’autres formats tels que des fichiers CSV (comma-separated-values).
Pour g&eacute;n&eacute;rer le rapport de formation d’un utilisateur sous forme de fichier CSV :
1 Connectez-vous avec l’identifiant de cet utilisateur.
2 D&eacute;termine l’ID d’un cours. Dans la plupart des cas, la d&eacute;marche consiste &agrave; pr&eacute;senter une liste
de cours (obtenue en appelant l’action sco-contents, qui renvoie &eacute;galement les ID des cours)
dans l’interface de l’application, et &agrave; permettre &agrave; l’utilisateur d’en s&eacute;lectionner un.
3 Appelez l’action report-course-takers.
Cette action renvoie une s&eacute;rie de balises row dont chacune fournit des informations sur un
utilisateur inscrit au cours.
4 Convertissez les donn&eacute;es renvoy&eacute;es en XML dans un fichier texte, en utilisant des virgules
comme s&eacute;parateurs de champs, et enregistrez ce fichier en CSV. L’approche la plus courante
consiste &agrave; afficher le fichier CSV r&eacute;sultant dans le navigateur de l’utilisateur, ce qui permet &agrave;
celui-ci d’enregistrer ces donn&eacute;es sur son disque dur local.
Pour transformer le fichier en donn&eacute;es s&eacute;par&eacute;es par des virgules, vous pouvez utiliser soit un
langage interpr&eacute;t&eacute; sur le serveur comme CFML, soit un langage de conversion comme XSLT.
Pour toutes informations sur XSLT, reportez-vous &agrave; la rubrique Ressources suppl&eacute;mentaires,
page 8.
Sc&eacute;nario : g&eacute;n&eacute;ration de rapports
25
26
Chapitre 2 : T&acirc;ches courantes
CHAPITRE 3
Guide de r&eacute;f&eacute;rence des actions
Ce chapitre est le guide de r&eacute;f&eacute;rence de toutes les actions expos&eacute;es dans l’API XML de
Macromedia Breeze. Il indique les param&egrave;tres pouvant &ecirc;tre pass&eacute;s &agrave; chaque action. Dans ce
chapitre, les actions apparaissent en ordre alphab&eacute;tique.
Pour toutes informations sur les balises, donn&eacute;es et codes d’&eacute;tat XML renvoy&eacute;s par le serveur
Breeze, consultez le Chapitre 4, R&eacute;f&eacute;rences pour les r&eacute;sultats XML, page 61. Le Chapitre 2, T&acirc;ches
courantes, page 19, pr&eacute;sente des exemples de diverses t&acirc;ches courantes faisant appel &agrave; des actions.
Tout appel d’une action doit comporter des informations d'identification permettant de conna&icirc;tre
l’auteur authentifi&eacute; de l’action. Pour plus d'informations, consultez la section A propos de la
s&eacute;curit&eacute;, page 15.
Chaque action renvoie une balise results contenant une ou plusieurs autres balises, dont une
balise d’&eacute;tat (status). La section &laquo; &Eacute;l&eacute;ments renvoy&eacute;s &raquo; de la documentation de chaque action
n’indique que les autres &eacute;l&eacute;ments renvoy&eacute;s ; les &eacute;l&eacute;ments results et status sont implicitement
renvoy&eacute;s.
Pour plus d'informations sur le passage de param&egrave;tres, consultez la section A propos des param&egrave;tres,
page 13. Pour plus d'informations sur les mandants et les SCO, consultez la section A propos des
mandants, des entit&eacute;s SCO et des identifiants, page 14.
accesskey-exec
Description
Ex&eacute;cute des fonctions sp&eacute;ciales associ&eacute;es &agrave; des cl&eacute;s d’acc&egrave;s sp&eacute;cifiques.
Actuellement, la seule fonction sp&eacute;ciale prise en charge est celle qui permet aux utilisateurs de
s’auto-inscrire &agrave; des r&eacute;unions et &agrave; des cours. La documentation relative &agrave; cette action n’aborde
donc que la fonction d'auto-inscription.
Pour appeler cette action, vous devez disposer &agrave; la fois de la cl&eacute; d’acc&egrave;s normale du compte et
d’une cl&eacute; d’acc&egrave;s sp&eacute;ciale associ&eacute;e &agrave; une r&eacute;union ou &agrave; un cours. Il est possible d’indiquer la cl&eacute;
d’acc&egrave;s sp&eacute;ciale &agrave; une personne qui n’est pas utilisatrice de Breeze. Cette personne peut ensuite,
via une interface sp&eacute;cifique, s’inscrire &agrave; la r&eacute;union ou au cours, ce qui cr&eacute;e alors un nouvel
utilisateur Breeze.
Pour obtenir la cl&eacute; d’acc&egrave;s sp&eacute;ciale, appelez l’action accesskey-info.
27
La diff&eacute;rence entre accesskey-exec et principal-update pour cr&eacute;er un nouvel utilisateur
r&eacute;side dans le fait qu’il est possible d’appeler accesskey-exec sans avoir ouvert une session et
sans &ecirc;tre administrateur.
Param&egrave;tres
Cl&eacute; d’acc&egrave;s du compte.
accesskey
access-key
Cl&eacute; d’acc&egrave;s sp&eacute;ciale qui permet &agrave; l’utilisateur de s’inscrire de lui-m&ecirc;me.
first-name
Nouveau pr&eacute;nom de l’utilisateur.
Ce param&egrave;tre doit toujours &ecirc;tre mis &agrave; 0 pour l’inscription d’un nouvel
has-children
utilisateur.
Nouveau pr&eacute;nom de l’utilisateur.
first-name
login Nouvel identifiant de connexion de l'utilisateur (qui est fr&eacute;quemment l’adresse de
messagerie de cet utilisateur).
Nouveau mot de passe de l’utilisateur.
password
type
Ce param&egrave;tre doit toujours &ecirc;tre &quot;user&quot; pour l’inscription d’un nouvel utilisateur.
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
accesskey-info
Description
Permet d’obtenir une cl&eacute; d’acc&egrave;s sp&eacute;ciale, si cette cl&eacute; est associ&eacute;e au SCO sp&eacute;cifi&eacute;.
Pour plus d'informations, consultez l’action accesskey-exec.
Pour conna&icirc;tre le groupe auquel l’utilisateur sera automatiquement ajout&eacute; lorsqu’il s’inscrira &agrave;
l’aide de la cl&eacute; d’acc&egrave;s sp&eacute;ciale, appelez l’action principal-info avec la valeur renvoy&eacute;e par
accesskey-info pour parent-acl-id.
Param&egrave;tres
accesskey
acl-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’un SCO.
&Eacute;l&eacute;ments renvoy&eacute;s
access-keys
28
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;access-keys&gt;
&lt;access-key acl-id=&quot;622847&quot; action=&quot;action-self-reg-meeting&quot;
parent-acl-id=&quot;503265&quot;&gt;
&lt;access-key&gt;3hzvnifcfmphn3id&lt;/access-key&gt;
&lt;date-created&gt;2004-03-05T10:28:14.750-08:00&lt;/date-created&gt;
&lt;/access-key&gt;
&lt;/access-keys&gt;
&lt;/results&gt;
action-list
Description
Renvoie la liste de toutes les actions que vous pouvez appeler.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
actions
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;actions&gt;
&lt;action&gt;accesskey-exec&lt;/action&gt;
&lt;action&gt;accesskey-info&lt;/action&gt;
&lt;action&gt;action-list&lt;/action&gt;
...
[la liste des autres actions figure ici]
...
&lt;action&gt;user-accounts&lt;/action&gt;
&lt;action&gt;user-update-pwd&lt;/action&gt;
&lt;/actions&gt;
&lt;/results&gt;
common-info
Description
Renvoie des informations de base sur l’utilisateur actuel et le serveur.
Si vous appelez common-info sans vous &ecirc;tre identifi&eacute; au pr&eacute;alable, ces m&ecirc;mes informations sont
renvoy&eacute;es &agrave; l’exception de la balise user. De plus, la valeur de account-id peut &ecirc;tre diff&eacute;rente.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
common
common-info
29
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;common locale=&quot;en&quot;&gt;
&lt;cookie&gt;breezm5qtgnye46zpckbf.MARIANNE&lt;/cookie&gt;
&lt;date&gt;2004-02-12T15:53:19.797-07:00&lt;/date&gt;
&lt;host&gt;http://admin.breeze.exemple.com&lt;/host&gt;
&lt;url&gt;/api/xml?accesskey=yyyyyyyyyyyyyyyy&amp;action=common-info&lt;/url&gt;
&lt;version&gt;breeze_402_r116&lt;/version&gt;
&lt;account account-id=&quot;222914&quot; /&gt;
&lt;user user-id=&quot;503562&quot;&gt;
&lt;login&gt;gerweck@exemple.com&lt;/login&gt;
&lt;/user&gt;
&lt;/common&gt;
&lt;/results&gt;
group-membership-update
Description
Permet d’ajouter un ou plusieurs mandants (principals) &agrave; un groupe, ou de supprimer des
mandants d’un groupe.
Pour actualiser plusieurs mandants et groupes, transmettez autant de groupes de trois param&egrave;tres
et is-member que n&eacute;cessaire. Pour plus d'informations, reportez-vous
&agrave; la rubrique A propos des param&egrave;tres, page 13.
group-id, principal-id
Param&egrave;tres
accesskey
group-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant du groupe dont vous souhaitez actualiser l’appartenance.
principal-id
is-member
Identifiant du mandant dont vous souhaitez actualiser le statut d’appartenance.
Indique si le mandant est membre du groupe.
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
login
Description
Connecte un utilisateur (ouverture de session) avec l’identifiant de celui-ci.
Remarque : Apr&egrave;s l’ouverture de session, vous devez lire et conserver le contenu du cookie
JSESSIONID, qui figure dans les en-t&ecirc;tes HTTP du code XML r&eacute;sultant. Vous devez ensuite inclure
la valeur de ce cookie dans toutes les requ&ecirc;tes transmises ult&eacute;rieurement avec cet identifiant. Pour
plus d'informations, reportez-vous &agrave; la section A propos de la s&eacute;curit&eacute;, page 15.
30
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
account-id Identifiant du compte associ&eacute; &agrave; cet utilisateur. Ce param&egrave;tre est facultatif. Si votre
organisation ne dispose que d’un seul compte, ne sp&eacute;cifiez pas le param&egrave;tre account-id.
Identifiant de connexion de l'utilisateur (qui est fr&eacute;quemment l’adresse de messagerie de
cet utilisateur).
login
Mot de passe de l’utilisateur.
password
Remarque : Si le param&egrave;tre login ou password est absent ou incorrect, le serveur Breeze renvoie le
code d’&eacute;tat &quot;no-data&quot;.
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
logout
Description
D&eacute;connecte un utilisateur (ferme la session), en invalidant le cookie re&ccedil;u par l’application &agrave;
l’ouverture de cette session.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
permissions-info
Description
Renvoie des informations sur les mandants et les autorisations dont ils disposent pour le SCO
indiqu&eacute;.
Pour plus d'informations sur les autorisations, consultez la section A propos des autorisations,
page 16.
Param&egrave;tres
accesskey
acl-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’un SCO sp&eacute;cifique.
permissions-info
31
&Eacute;l&eacute;ments renvoy&eacute;s
permissions
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;permissions&gt;
&lt;principal principal-id=&quot;181248&quot; is-primary=&quot;false&quot; type=&quot;user&quot;
has-children=&quot;false&quot; permission-id=&quot;view&quot;&gt;
&lt;name&gt;Englesberg, Anne&lt;/name&gt;
&lt;login&gt;englesberg@exemple.com&lt;/login&gt;
&lt;/principal&gt;
&lt;principal principal-id=&quot;181249&quot; is-primary=&quot;false&quot; type=&quot;user&quot;
has-children=&quot;false&quot; permission-id=&quot;view&quot;&gt;
&lt;name&gt;Mauduit, Susanne&lt;/name&gt;
&lt;login&gt;mauduit@exemple.com&lt;/login&gt;
&lt;/principal&gt;
&lt;/permissions&gt;
&lt;/results&gt;
permissions-reset
Description
R&eacute;initialise les autorisations de tous les mandants pour le SCO indiqu&eacute;. Les autorisations sur le
parent de ce SCO s’appliquent alors &agrave; tous les mandants.
Pour plus d'informations sur les autorisations, consultez la section A propos des autorisations,
page 16.
Param&egrave;tres
accesskey
acl-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’un SCO.
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
permissions-update
Description
Actualise les autorisations d’un ou plusieurs mandants pour un ou plusieurs SCO.
Pour plus d'informations sur les mandants, consultez A propos des mandants, des entit&eacute;s SCO et des
identifiants, page 14.
Pour plus d'informations sur les autorisations, consultez la section A propos des autorisations,
page 16.
32
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
Pour actualiser les autorisations de plusieurs mandants, transmettez autant de groupes de trois
param&egrave;tres acl-id, permission-id et principal-id que n&eacute;cessaire. Pour plus d'informations,
reportez-vous &agrave; la rubrique A propos des param&egrave;tres, page 13.
Param&egrave;tres
accesskey
acl-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’un SCO.
Identifiant d’une autorisation.
permission-id
principal-id
Identifiant d’un mandant (utilisateur ou groupe).
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
principal-info
Description
Renvoie des informations sur le mandant sp&eacute;cifi&eacute; ; en particulier, fournit des information sur un
utilisateur d&eacute;fini.
Pour plus d'informations sur les mandants, consultez A propos des mandants, des entit&eacute;s SCO et des
identifiants, page 14.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
principal-id
Identifiant d’un mandant sp&eacute;cifique.
&Eacute;l&eacute;ments renvoy&eacute;s
principal
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;principal account-id=&quot;222914&quot; has-children=&quot;true&quot; is-primary=&quot;true&quot;
principal-id=&quot;222926&quot; type=&quot;course-admins&quot;&gt;
&lt;description&gt;Groupe Gestionnaires de cours&lt;/description&gt;
&lt;login&gt;Gestionnaires de cours&lt;/login&gt;
&lt;name&gt;Gestionnaires de cours&lt;/name&gt;
&lt;/principal&gt;
&lt;/results&gt;
Voir aussi
principal-list, principal-update
principal-info
33
principal-list
Description
Renvoie la liste compl&egrave;te des utilisateurs et des groupes, y compris les groupes primaires.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
principal-list
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;principal-list&gt;
&lt;principal principal-id=&quot;222917&quot; type=&quot;admins&quot; has-children=&quot;true&quot;
is-primary=&quot;true&quot; is-hidden=&quot;0&quot;&gt;
&lt;name&gt;Administrateurs des comptes&lt;/name&gt;
&lt;login&gt;Administrateurs des comptes&lt;/login&gt;
&lt;description&gt;Groupe Administrateurs des comptes&lt;/description&gt;
&lt;/principal&gt;
&lt;principal principal-id=&quot;503123&quot; type=&quot;user&quot; has-children=&quot;false&quot;
is-primary=&quot;false&quot; is-hidden=&quot;0&quot;&gt;
&lt;name&gt;Marchi, fabio&lt;/name&gt;
&lt;login&gt;marchi@exemple.com&lt;/login&gt;
&lt;email&gt;marchi@exemple.com&lt;/email&gt;
&lt;/principal&gt;
&lt;/principal-list&gt;
&lt;/results&gt;
principal-update
Description
Actualise les informations relatives &agrave; un mandant pour le compte actuel, ou cr&eacute;e un nouveau
mandant. Pour plus d'informations sur les mandants, consultez A propos des mandants, des entit&eacute;s
SCO et des identifiants, page 14.
Dans la plupart des cas, il est n&eacute;cessaire d’obtenir la version originale des informations sur le
mandant (&agrave; l’aide de l’action principal-info) avant d’appeler l’action principal-update.
Pour cr&eacute;er un nouveau mandant, appelez l’action principal-update sans sp&eacute;cifier le param&egrave;tre
Si vous cr&eacute;ez un nouveau mandant, le code XML renvoy&eacute; contient les
informations sur celui-ci, y compris son identifiant.
principal-id.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
description Description du nouveau groupe. Utilis&eacute; uniquement lors de la cr&eacute;ation d’un
nouveau groupe.
first-name Nouveau pr&eacute;nom &agrave; affecter &agrave; l’utilisateur. Utilis&eacute; uniquement lors de la cr&eacute;ation ou
de l’actualisation d’un utilisateur.
34
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
Indique si le mandant poss&egrave;de des enfants. Si le mandant est un groupe, ce
param&egrave;tre doit &ecirc;tre mis &agrave; 1. Si le mandant est un utilisateur, ce param&egrave;tre doit &ecirc;tre mis &agrave; 0.
has-children
Nouveau nom &agrave; affecter &agrave; l’utilisateur. Utilis&eacute; uniquement lors de la cr&eacute;ation ou de
l’actualisation d’un utilisateur.
last-name
login Nouvel identifiant de connexion du mandant (qui est fr&eacute;quemment l’adresse de
messagerie associ&eacute;e &agrave; ce mandant).
name
Nom du nouveau groupe. Utilis&eacute; uniquement lors de la cr&eacute;ation d’un nouveau groupe.
Nouveau mot de passe de l’utilisateur. Utilis&eacute; uniquement lors de la cr&eacute;ation d’un
nouvel utilisateur.
password
Identifiant du mandant dont vous modifiez les donn&eacute;es. Si vous ne pr&eacute;cisez pas
ce param&egrave;tre, l’action principal-update cr&eacute;e un nouveau mandant.
principal-id
Type du nouveau mandant. Utilis&eacute; uniquement lors de la cr&eacute;ation d’un nouveau
mandant. Pour plus d'informations sur les types disponibles, consultez la section A propos des
mandants, des entit&eacute;s SCO et des identifiants, page 14.
type
&Eacute;l&eacute;ments renvoy&eacute;s
En cas d’actualisation d’un mandant existant, aucun.
En cas de cr&eacute;ation d’un nouveau mandant, renvoie principal (dans le m&ecirc;me format que les
&eacute;l&eacute;ments renvoy&eacute;s pour principal-info).
Exemple de r&eacute;sultat
Exemples de r&eacute;sultats renvoy&eacute;s lors de la cr&eacute;ation d’un nouveau mandant :
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;principal type=&quot;user&quot; principal-id=&quot;2500848&quot; has-children=&quot;0&quot; accountid=&quot;181224&quot;&gt;
&lt;login&gt;jacques@exemple.com&lt;/login&gt;
&lt;name&gt;dupont, jacques&lt;/name&gt;
&lt;/principal&gt;
&lt;/results&gt;
Voir aussi
principal-info, principal-update, principals-delete
principals-delete
Description
Supprime un ou plusieurs mandants.
Pour supprimer plusieurs mandants, transmettez plusieurs param&egrave;tres principal-id. Pour plus
de d&eacute;tails, consultez la section A propos des param&egrave;tres, page 13.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
principal-id
Identifiant d’un mandant &agrave; supprimer.
principals-delete
35
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
report-active-meeting-presenters
Description
Renvoie la liste des utilisateurs qui sont actuellement pr&eacute;sentateurs de r&eacute;unions.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
sco-id Identifiant d’une r&eacute;union ; si ce param&egrave;tre est sp&eacute;cifi&eacute;, le rapport renvoie des
informations sur cette r&eacute;union uniquement. Ce param&egrave;tre est facultatif.
&Eacute;l&eacute;ments renvoy&eacute;s
report-active-meeting-presenters
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-active-meeting-presenters&gt;
&lt;sco sco-id=&quot;190298&quot;&gt;
&lt;name&gt;Jacques Moisson&lt;/name&gt;
&lt;date-created&gt;2004-02-17T17:06:23.920-08:00&lt;/date-created&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;566058&quot;&gt;
&lt;name&gt;Hans Gay&lt;/name&gt;
&lt;date-created&gt;2004-02-17T16:50:00.327-08:00&lt;/date-created&gt;
&lt;/sco&gt;
&lt;/report-active-meeting-presenters&gt;
&lt;/results&gt;
report-active-meetings
Description
Renvoie la liste des r&eacute;unions en cours.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
report-active-meetings
36
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-active-meetings&gt;
&lt;sco sco-id=&quot;196311&quot; active-participants=&quot;1&quot; length-minutes=&quot;60&quot;&gt;
&lt;name&gt;Am&eacute;lioration des processus&lt;/name&gt;
&lt;date-begin&gt;2003-09-02T14:00:58.330-07:00&lt;/date-begin&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;184847&quot; active-participants=&quot;5&quot; length-minutes=&quot;30&quot;&gt;
&lt;name&gt;Nouvelle structure&lt;/name&gt;
&lt;date-begin&gt;2003-09-02T14:45:25.273-07:00&lt;/date-begin&gt;
&lt;/sco&gt;
&lt;/report-active-meetings&gt;
&lt;/results&gt;
report-bandwidth
Description
Indique la bande passante totale utilis&eacute;e par le compte actif depuis sa cr&eacute;ation, en octets.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
report-bandwidth
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-bandwidth total=&quot;71000000&quot; /&gt;
&lt;/results&gt;
report-course-takers
Description
Renvoie la liste des utilisateurs inscrits au cours sp&eacute;cifi&eacute;.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’un cours.
&Eacute;l&eacute;ments renvoy&eacute;s
report-quiz-takers
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-quiz-takers&gt;
&lt;row transcript-id=&quot;&quot; sco-id=&quot;&quot; principal-id=&quot;506299&quot; status=&quot;&quot; score=&quot;&quot;
percentage-score=&quot;&quot; time-taken=&quot;&quot; certificate=&quot;&quot;&gt;
&lt;login&gt;benedict@exemple.com&lt;/login&gt;
&lt;principal-name&gt;Benedict, Francis&lt;/principal-name&gt;
&lt;/row&gt;
report-course-takers
37
&lt;row transcript-id=&quot;&quot; sco-id=&quot;&quot; principal-id=&quot;508197&quot; status=&quot;&quot; score=&quot;&quot;
percentage-score=&quot;&quot; time-taken=&quot;&quot; certificate=&quot;&quot;&gt;
&lt;login&gt;chiang@exemple.com&lt;/login&gt;
&lt;principal-name&gt;Chiang, Louis&lt;/principal-name&gt;
&lt;/row&gt;
&lt;row transcript-id=&quot;&quot; sco-id=&quot;&quot; principal-id=&quot;550016&quot; status=&quot;&quot; score=&quot;&quot;
percentage-score=&quot;&quot; time-taken=&quot;&quot; certificate=&quot;&quot;&gt;
&lt;login&gt;cantrell@exemple.com&lt;/login&gt;
&lt;principal-name&gt;Cantrell, Thomas&lt;/principal-name&gt;
&lt;/row&gt;
&lt;/report-quiz-takers&gt;
&lt;/results&gt;
report-disk-usage
Description
Renvoie des informations sur l’espace disque utilis&eacute; par le contenu Breeze du compte actif, en
octets. Tout le contenu et les archives sont inclus.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
report-disk-usage
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-disk-usage total=&quot;849327881&quot; /&gt;
&lt;/results&gt;
report-meeting-attendance
Description
Renvoie la liste des utilisateurs ayant assist&eacute; &agrave; la r&eacute;union sp&eacute;cifi&eacute;e. Si la r&eacute;union n’a pas encore
commenc&eacute;, le tableau des donn&eacute;es renvoy&eacute;es ne contient pas de lignes.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une r&eacute;union.
&Eacute;l&eacute;ments renvoy&eacute;s
report-meeting-attendance
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-meeting-attendance&gt;
&lt;row transcript-id=&quot;462409&quot; sco-id=&quot;505267&quot; principal-id=&quot;181255&quot;
answered-survey=&quot;0&quot;&gt;
&lt;login&gt;martin@exemple.com&lt;/login&gt;
&lt;sco-name&gt;Ma r&eacute;union&lt;/sco-name&gt;
&lt;date-created&gt;2004-01-29T00:59:15.490-08:00&lt;/date-created&gt;
38
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
&lt;date-closed&gt;2004-01-29T00:59:41.470-08:00&lt;/date-closed&gt;
&lt;participant-name&gt;Martin, Patrick&lt;/participant-name&gt;
&lt;/row&gt;
&lt;/report-meeting-attendance&gt;
&lt;/results&gt;
report-meeting-concurrent-users
Description
Indique le nombre maximal d’utilisateurs pouvant participer simultan&eacute;ment &agrave; la r&eacute;union
sp&eacute;cifi&eacute;e. Ce nombre maximal est d&eacute;termin&eacute; par la licence du compte.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une r&eacute;union.
&Eacute;l&eacute;ments renvoy&eacute;s
report-meeting-concurrent-users
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-meeting-concurrent-users max-users=&quot;426&quot;
max-participants-freq=&quot;1&quot; /&gt;
&lt;/results&gt;
report-meeting-session
Description
Renvoie des informations sur une r&eacute;union, dont le nombre de participants et les dates et heures de
d&eacute;but et de fin.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une r&eacute;union.
&Eacute;l&eacute;ments renvoy&eacute;s
report-meeting-session
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-meeting-session session-sco-id=&quot;505267&quot; sco-id=&quot;181576&quot;
num-participants=&quot;0&quot; num-guests=&quot;0&quot;&gt;
&lt;name&gt;Ma r&eacute;union&lt;/name&gt;
&lt;date-begin&gt;2004-01-29T00:30:00.000-08:00&lt;/date-begin&gt;
&lt;date-end&gt;2004-01-29T00:30:00.000-08:00&lt;/date-end&gt;
&lt;/report-meeting-session&gt;
&lt;/results&gt;
report-meeting-session
39
report-meeting-sessions
Description
Renvoie des informations sur toutes les sessions d’une r&eacute;union. Une nouvelle session d&eacute;bute
chaque fois qu’une personne entre dans une salle de r&eacute;union vide. La session se termine lorsque le
dernier participant quitte la r&eacute;union. Une nouvelle session d&eacute;bute si une personne entre &agrave;
nouveau dans la salle de r&eacute;union d&eacute;sormais vide.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une r&eacute;union.
&Eacute;l&eacute;ments renvoy&eacute;s
report-meeting-sessions
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-meeting-sessions&gt;
&lt;row sco-id=&quot;622852&quot; num-participants=&quot;1&quot; num-guests=&quot;0&quot; num-polls=&quot;0&quot;&gt;
&lt;name&gt;Ma r&eacute;union&lt;/name&gt;
&lt;date-begin&gt;2004-03-05T10:33:09.030-08:00&lt;/date-begin&gt;
&lt;date-end&gt;2004-03-05T10:54:09.030-08:00&lt;/date-end&gt;
&lt;/row&gt;
&lt;row sco-id=&quot;622852&quot; num-participants=&quot;1&quot; num-guests=&quot;0&quot; num-polls=&quot;0&quot;&gt;
&lt;name&gt;Ma r&eacute;union&lt;/name&gt;
&lt;date-begin&gt;2004-03-05T11:00:09.030-08:00&lt;/date-begin&gt;
&lt;/row&gt;
&lt;/report-meeting-sessions&gt;
&lt;/results&gt;
report-meeting-session-slots
Description
Renvoie des informations sur le nombre de participants &agrave; une r&eacute;union pour chaque p&eacute;riode de
10 minutes.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une r&eacute;union.
&Eacute;l&eacute;ments renvoy&eacute;s
report-meeting-session-slots
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-meeting-session-slots&gt;
&lt;row num-attendees=&quot;0&quot;&gt;
&lt;time-slot-begin&gt;2004-02-14T06:30:00.000-08:00&lt;/time-slot-begin&gt;
&lt;time-slot-end&gt;2004-02-14T06:40:00.000-08:00&lt;/time-slot-end&gt;
&lt;/row&gt;
40
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
&lt;row num-attendees=&quot;0&quot;&gt;
&lt;time-slot-begin&gt;2004-02-14T06:40:00.000-08:00&lt;/time-slot-begin&gt;
&lt;time-slot-end&gt;2004-02-14T06:50:00.000-08:00&lt;/time-slot-end&gt;
&lt;/row&gt;
&lt;row num-attendees=&quot;0&quot;&gt;
&lt;time-slot-begin&gt;2004-02-14T06:50:00.000-08:00&lt;/time-slot-begin&gt;
&lt;time-slot-end&gt;2004-02-14T07:00:00.000-08:00&lt;/time-slot-end&gt;
&lt;/row&gt;
&lt;/report-meeting-session-slots&gt;
&lt;/results&gt;
report-meeting-summary
Description
Indique le nombre d’utilisateurs invit&eacute;s &agrave; la r&eacute;union sp&eacute;cifi&eacute;e et le nombre d’invit&eacute;s et d’h&ocirc;tes qui
y ont r&eacute;ellement assist&eacute;.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une r&eacute;union.
&Eacute;l&eacute;ments renvoy&eacute;s
report-meeting-summary
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-meeting-summary num-invitees=&quot;10&quot; num-invitees-attended=&quot;5&quot;
num-guests-attended=&quot;1&quot; /&gt;
&lt;/results&gt;
report-my-courses
Description
Renvoie des informations sur chaque cours auquel l’utilisateur actuel est inscrit.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
my-courses
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;my-courses&gt;
&lt;course sco-id=&quot;555038&quot; status=&quot;active&quot; type=&quot;course&quot;&gt;
&lt;name&gt;Mon nom&lt;/name&gt;
&lt;url&gt;admin.breeze.exemple.com/p38547860/&lt;/url&gt;
&lt;date-created&gt;2004-02-09T14:40:38.497-08:00&lt;/date-created&gt;
&lt;date-modified&gt;2004-02-09T14:40:44.623-08:00&lt;/date-modified&gt;
&lt;date-begin&gt;2004-02-09T14:30:00.000-08:00&lt;/date-begin&gt;
&lt;date-end&gt;2004-02-09T14:30:00.000-08:00&lt;/date-end&gt;
report-my-courses
41
&lt;url-path&gt;/p38547860/&lt;/url-path&gt;
&lt;expired&gt;true&lt;/expired&gt;
&lt;/course&gt;
&lt;course sco-id=&quot;565003&quot; status=&quot;active&quot; type=&quot;course&quot;&gt;
&lt;name&gt;quiz 100&lt;/name&gt;
&lt;url&gt;admin.breeze.exemple.com/p81997938/&lt;/url&gt;
&lt;date-created&gt;2004-02-16T21:04:48.750-08:00&lt;/date-created&gt;
&lt;date-modified&gt;2004-02-16T21:33:17.560-08:00&lt;/date-modified&gt;
&lt;date-begin&gt;2004-02-16T21:00:00.000-08:00&lt;/date-begin&gt;
&lt;url-path&gt;/p81997938/&lt;/url-path&gt;
&lt;expired&gt;false&lt;/expired&gt;
&lt;/course&gt;
&lt;/my-courses&gt;
&lt;/results&gt;
report-my-meetings
Description
Renvoie des informations sur chaque r&eacute;union &agrave; laquelle l’utilisateur actuel est invit&eacute; &agrave; participer.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
my-meetings
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;my-meetings&gt;
&lt;meeting sco-id=&quot;181487&quot; type=&quot;meeting&quot; status=&quot;active&quot;
permission-id=&quot;view&quot; active-participants=&quot;0&quot;&gt;
&lt;name&gt;morris shared&lt;/name&gt;
&lt;domain-name&gt;admin.breeze.exemple.com&lt;/domain-name&gt;
&lt;url-path&gt;/r99718924/&lt;/url-path&gt;
&lt;date-begin&gt;2003-07-14T23:00:00.000-07:00&lt;/date-begin&gt;
&lt;date-end&gt;2003-07-15T09:00:00.000-07:00&lt;/date-end&gt;
&lt;expired&gt;true&lt;/expired&gt;
&lt;/meeting&gt;
&lt;meeting sco-id=&quot;505659&quot; type=&quot;meeting&quot; status=&quot;active&quot;
permission-id=&quot;presenter&quot; active-participants=&quot;0&quot;&gt;
&lt;name&gt;nouveau chef de service&lt;/name&gt;
&lt;domain-name&gt;admin.breeze.exemple.com&lt;/domain-name&gt;
&lt;url-path&gt;/p50473388/&lt;/url-path&gt;
&lt;date-begin&gt;2004-01-29T05:30:00.000-08:00&lt;/date-begin&gt;
&lt;date-end&gt;2004-01-29T05:30:00.000-08:00&lt;/date-end&gt;
&lt;expired&gt;true&lt;/expired&gt;
&lt;/meeting&gt;
&lt;/my-meetings&gt;
&lt;/results&gt;
42
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
report-quiz-answer-distribution
Description
Indique le nombre d’utilisateurs qui ont choisi une r&eacute;ponse particuli&egrave;re &agrave; une question sp&eacute;cifique
du questionnaire.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une pr&eacute;sentation contenant un questionnaire.
&Eacute;l&eacute;ments renvoy&eacute;s
report-quiz-answer-distribution
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-quiz-answer-distribution&gt;
&lt;row question-number=&quot;1&quot; question-id=&quot;257&quot;
total=&quot;8&quot;&gt;
&lt;body&gt;What is 2+2?&lt;/body&gt;
&lt;/row&gt;
&lt;row question-number=&quot;2&quot; question-id=&quot;258&quot;
total=&quot;8&quot;&gt;
&lt;body&gt;Quelle est la distance de la Terre
&lt;/row&gt;
&lt;row question-number=&quot;3&quot; question-id=&quot;259&quot;
total=&quot;8&quot;&gt;
&lt;body&gt;Quel est le standard international
&lt;/row&gt;
&lt;/report-quiz-answer-distribution&gt;
&lt;/results&gt;
a1=&quot;0&quot; a2=&quot;0&quot; a3=&quot;5&quot; a4=&quot;3&quot;
a1=&quot;8&quot; a2=&quot;0&quot; a3=&quot;0&quot; a4=&quot;0&quot;
au Soleil ?&lt;/body&gt;
a1=&quot;8&quot; a2=&quot;0&quot; a3=&quot;0&quot; a4=&quot;0&quot;
qui d&eacute;finit ECMAScript ?&lt;/body&gt;
report-quiz-definition-answers
Description
Renvoie des informations sur chacune des r&eacute;ponses autoris&eacute;es (&agrave; la fois correctes et incorrectes)
pour le questionnaire sp&eacute;cifi&eacute;.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une pr&eacute;sentation contenant un questionnaire.
&Eacute;l&eacute;ments renvoy&eacute;s
quiz-definition-answers
report-quiz-definition-answers
43
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;quiz-definition-answers&gt;
&lt;row answer-id=&quot;1&quot; question-id=&quot;257&quot; correct=&quot;0&quot;&gt;
&lt;body&gt;22&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;2&quot; question-id=&quot;257&quot; correct=&quot;0&quot;&gt;
&lt;body&gt;0&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;3&quot; question-id=&quot;257&quot; correct=&quot;1&quot;&gt;
&lt;body&gt;4&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;1&quot; question-id=&quot;258&quot; correct=&quot;1&quot;&gt;
&lt;body&gt;150 000 000 de kilom&egrave;tres&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;2&quot; question-id=&quot;258&quot; correct=&quot;0&quot;&gt;
&lt;body&gt;1 parsec&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;3&quot; question-id=&quot;258&quot; correct=&quot;0&quot;&gt;
&lt;body&gt;100 kilom&egrave;tres&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;4&quot; question-id=&quot;258&quot; correct=&quot;0&quot;&gt;
&lt;body&gt;300 000 kilom&egrave;tres&lt;/body&gt;
&lt;/row&gt;
&lt;answer-text&gt;ISO 9000&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;1&quot; question-id=&quot;259&quot; correct=&quot;1&quot;&gt;
&lt;body&gt;ECMA-262&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;2&quot; question-id=&quot;259&quot; correct=&quot;0&quot;&gt;
&lt;body&gt;RFC 821&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;3&quot; question-id=&quot;259&quot; correct=&quot;0&quot;&gt;
&lt;body&gt;ECMA-976&lt;/body&gt;
&lt;/row&gt;
&lt;/quiz-definition-answers&gt;
&lt;/results&gt;
report-quiz-definition-questions
Description
Renvoie des informations sur chaque question d’un questionnaire.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une pr&eacute;sentation contenant un questionnaire.
&Eacute;l&eacute;ments renvoy&eacute;s
quiz-definition-questions
44
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;quiz-definition-questions&gt;
&lt;row question-number=&quot;1&quot; question-id=&quot;257&quot; score=&quot;20&quot; chapter-id=&quot;1&quot;&gt;
&lt;body&gt;Combien font 2+2?&lt;/body&gt;
&lt;date-modified&gt;2004-01-13T17:09:40.230-08:00&lt;/date-modified&gt;
&lt;/row&gt;
&lt;row question-number=&quot;2&quot; question-id=&quot;258&quot; score=&quot;20&quot; chapter-id=&quot;1&quot;&gt;
&lt;body&gt;Quelle est la distance de la Terre au Soleil ?&lt;/body&gt;
&lt;date-modified&gt;2004-01-13T17:09:40.230-08:00&lt;/date-modified&gt;
&lt;/row&gt;
&lt;row question-number=&quot;3&quot; question-id=&quot;259&quot; score=&quot;20&quot; chapter-id=&quot;1&quot;&gt;
&lt;body&gt;Quel est le standard international qui d&eacute;finit ECMAScript ?&lt;/body&gt;
&lt;date-modified&gt;2004-01-13T17:09:40.240-08:00&lt;/date-modified&gt;
&lt;/row&gt;
&lt;/quiz-definition-questions&gt;
&lt;/results&gt;
report-quiz-interactions
Description
Renvoie des informations sur toutes les interactions des utilisateurs avec le questionnaire sp&eacute;cifi&eacute;.
Une interaction est le choix effectu&eacute; par un utilisateur dans le questionnaire. Ce rapport produit
donc des informations sur toutes les r&eacute;ponses que chaque utilisateur a choisi pour chaque
question du questionnaire.
Dans les r&eacute;sultats renvoy&eacute;s par cette action, l’attribut score indique la note re&ccedil;ue par le
participant &agrave; cette question.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une pr&eacute;sentation contenant un questionnaire.
&Eacute;l&eacute;ments renvoy&eacute;s
report-quiz-interactions
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-quiz-interactions&gt;
&lt;row transcript-id=&quot;459350&quot; question-id=&quot;257&quot; sco-id=&quot;217706&quot; score=&quot;20&quot;&gt;
&lt;date-created&gt;2004-01-13T02:00:46.163-08:00&lt;/date-created&gt;
&lt;question&gt;Combien font 2+2?&lt;/question&gt;
&lt;/row&gt;
&lt;row transcript-id=&quot;459350&quot; question-id=&quot;258&quot; sco-id=&quot;217706&quot; score=&quot;0&quot;&gt;
&lt;date-created&gt;2004-01-13T02:00:46.163-08:00&lt;/date-created&gt;
&lt;question&gt;Quelle est la distance de la Terre au Soleil ?&lt;/question&gt;
&lt;/row&gt;
&lt;row transcript-id=&quot;459350&quot; question-id=&quot;259&quot; sco-id=&quot;217706&quot; score=&quot;20&quot;&gt;
&lt;date-created&gt;2004-01-13T02:00:46.163-08:00&lt;/date-created&gt;
&lt;question&gt;Quel est le standard international qui d&eacute;finit ECMAScript ?&lt;/
question&gt;
&lt;/row&gt;
&lt;row transcript-id=&quot;893541&quot; question-id=&quot;259&quot; sco-id=&quot;217706&quot; score=&quot;20&quot;&gt;
report-quiz-interactions
45
&lt;date-created&gt;2004-01-13T02:00:46.163-08:00&lt;/date-created&gt;
&lt;question&gt;Quel est le standard international qui d&eacute;finit ECMAScript ?&lt;/
question&gt;
&lt;/row&gt;
&lt;/report-quiz-interactions&gt;
&lt;/results&gt;
report-quiz-question-answer-distribution
Description
Indique le nombre d’utilisateurs qui ont choisi une r&eacute;ponse particuli&egrave;re &agrave; une question sp&eacute;cifique
du questionnaire.
Utilisez les actions report-quiz-definition-answers ou report-quiz-definitionpour d&eacute;terminer l’identifiant d’une question (cet identifiant sera pass&eacute; comme
param&egrave;tre &agrave; l’action question-id).
questions
Remarque : Les identifiants des questions ne correspondent pas n&eacute;cessairement aux num&eacute;ros
affect&eacute;s aux questions dans un questionnaire.
Param&egrave;tres
accesskey
question-id
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une question sp&eacute;cifique du questionnaire.
Identifiant d’une pr&eacute;sentation contenant un questionnaire.
&Eacute;l&eacute;ments renvoy&eacute;s
report-quiz-question-answer-distribution
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-quiz-question-answer-distribution&gt;
&lt;row question-id=&quot;259&quot; answer-id=&quot;1&quot; correct=&quot;0&quot; total-responses=&quot;1&quot;
percentage-responded=&quot;10&quot;&gt;
&lt;question-text&gt;Quel est le standard international qui d&eacute;finit
ECMAScript ?&lt;/question-text&gt;
&lt;answer-text&gt;ISO-9000&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row question-id=&quot;259&quot; answer-id=&quot;2&quot; correct=&quot;0&quot; total-responses=&quot;3&quot;
percentage-responded=&quot;30&quot;&gt;
&lt;question-text&gt;Quel est le standard international qui d&eacute;finit
ECMAScript ?&lt;/question-text&gt;
&lt;answer-text&gt;RFC 821&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row question-id=&quot;259&quot; answer-id=&quot;3&quot; correct=&quot;0&quot; total-responses=&quot;2&quot;
percentage-responded=&quot;20&quot;&gt;
&lt;question-text&gt;Quel est le standard international qui d&eacute;finit
ECMAScript ?&lt;/question-text&gt;
&lt;answer-text&gt;ECMA-976&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row question-id=&quot;259&quot; answer-id=&quot;4&quot; correct=&quot;1&quot; total-responses=&quot;4&quot;
percentage-responded=&quot;40&quot;&gt;
&lt;question-text&gt;Quel est le standard international qui d&eacute;finit
ECMAScript ?&lt;/question-text&gt;
&lt;answer-text&gt;ECMA-262&lt;/answer-text&gt;
&lt;/row&gt;
46
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
&lt;/report-quiz-question-answer-distribution&gt;
&lt;/results&gt;
report-quiz-question-distribution
Description
Indique le nombre d’utilisateurs ayant r&eacute;pondu correctement &agrave; chaque question du questionnaire
sp&eacute;cifi&eacute;.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une pr&eacute;sentation contenant un questionnaire.
&Eacute;l&eacute;ments renvoy&eacute;s
report-quiz-question-distribution
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-quiz-question-distribution&gt;
&lt;row question-id=&quot;257&quot; question-number=&quot;1&quot; num-correct=&quot;8&quot;
num-incorrect=&quot;0&quot; percentage-correct=&quot;100&quot; score=&quot;20&quot;&gt;
&lt;body&gt;Combien font 2+2?&lt;/body&gt;
&lt;/row&gt;
&lt;row question-id=&quot;258&quot; question-number=&quot;2&quot; num-correct=&quot;8&quot;
num-incorrect=&quot;0&quot; percentage-correct=&quot;100&quot; score=&quot;20&quot;&gt;
&lt;body&gt;Quelle est la distance de la Terre au Soleil ?&lt;/body&gt;
&lt;/row&gt;
&lt;row question-id=&quot;259&quot; question-number=&quot;3&quot; num-correct=&quot;4&quot;
num-incorrect=&quot;6&quot; percentage-correct=&quot;40&quot; score=&quot;20&quot;&gt;
&lt;body&gt;Quel est le standard international qui d&eacute;finit ECMAScript ?&lt;/
body&gt;
&lt;/row&gt;
&lt;/report-quiz-question-distribution&gt;
&lt;/results&gt;
report-quiz-question-response
Description
Renvoie la liste de toutes les r&eacute;ponses choisies par des utilisateurs &agrave; une question particuli&egrave;re.
Utilisez les actions report-quiz-definition-answers ou report-quiz-definitionpour d&eacute;terminer l’identifiant d’une question (cet identifiant sera pass&eacute; comme
param&egrave;tre &agrave; l’action question-id).
questions
Remarque : Les identifiants des questions ne correspondent pas n&eacute;cessairement aux num&eacute;ros
affect&eacute;s aux questions dans un questionnaire.
Param&egrave;tres
accesskey
question-id
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une question sp&eacute;cifique du questionnaire.
Identifiant d’une pr&eacute;sentation contenant un questionnaire.
report-quiz-question-response
47
&Eacute;l&eacute;ments renvoy&eacute;s
report-quiz-question-response
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-quiz-question-response&gt;
&lt;row principal-id=&quot;506299&quot; question-id=&quot;257&quot; answer-id=&quot;2&quot;&gt;
&lt;body&gt;Combien font 2+2 ?&lt;/body&gt;
&lt;answer-text&gt;5&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row principal-id=&quot;557527&quot; question-id=&quot;257&quot; answer-id=&quot;2&quot;&gt;
&lt;body&gt;Combien font 2+2 ?&lt;/body&gt;
&lt;answer-text&gt;5&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row principal-id=&quot;181255&quot; question-id=&quot;257&quot; answer-id=&quot;3&quot;&gt;
&lt;body&gt;Combien font 2+2 ?&lt;/body&gt;
&lt;answer-text&gt;4&lt;/answer-text&gt;
&lt;/row&gt;
&lt;/report-quiz-question-response&gt;
&lt;/results&gt;
report-quiz-question-totals
Description
Indique le nombre total d’utilisateurs qui ont r&eacute;pondu &agrave; la question sp&eacute;cifi&eacute;e et le nombre
d’utilisateurs qui y ont r&eacute;pondu correctement.
Utilisez les actions report-quiz-definition-answers ou report-quiz-definitionpour d&eacute;terminer l’identifiant d’une question (cet identifiant sera pass&eacute; comme
param&egrave;tre &agrave; l’action question-id).
questions
Remarque : Les identifiants des questions ne correspondent pas n&eacute;cessairement aux num&eacute;ros
affect&eacute;s aux questions dans un questionnaire.
Param&egrave;tres
accesskey
question-id
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une question sp&eacute;cifique du questionnaire.
Identifiant d’une pr&eacute;sentation contenant un questionnaire.
&Eacute;l&eacute;ments renvoy&eacute;s
report-quiz-question-totals
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-quiz-question-totals question-id=&quot;260&quot; total-responses=&quot;8&quot;
num-correct-answers=&quot;5&quot; /&gt;
&lt;/results&gt;
48
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
report-quiz-summary
Description
Renvoie des informations sur les r&eacute;sultats d’un questionnaire.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une pr&eacute;sentation contenant un questionnaire.
&Eacute;l&eacute;ments renvoy&eacute;s
report-quiz-results, report-quiz-summary
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-quiz-results average-score=&quot;95&quot; low-score=&quot;90&quot; high-score=&quot;100&quot;
numtaken=&quot;8&quot; numdistincttaken=&quot;1&quot; /&gt;
&lt;report-quiz-summary sco-id=&quot;217706&quot; numquestions=&quot;5&quot; maxpossiblescore=&quot;100&quot;
passingscore=&quot;50&quot; /&gt;
&lt;/results&gt;
report-quiz-takers
Description
Renvoie des informations sur toutes les personnes ayant r&eacute;pondu &agrave; un questionnaire particulier.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une pr&eacute;sentation contenant un questionnaire.
&Eacute;l&eacute;ments renvoy&eacute;s
report-quiz-takers
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-quiz-takers&gt;
&lt;row transcript-id=&quot;586821&quot; sco-id=&quot;586760&quot; principal-id=&quot;506385&quot;
status=&quot;not-attempted&quot; score=&quot;0&quot; percentage-score=&quot;0&quot; time-taken=&quot;&quot;
certificate=&quot;&quot;&gt;
&lt;name&gt;Test de maths&lt;/name&gt;
&lt;login&gt;benedict@exemple.com&lt;/login&gt;
&lt;date-taken&gt;2004-02-27T10:53:05.013-08:00&lt;/date-taken&gt;
&lt;principal-name&gt;Benedict, Francis&lt;/principal-name&gt;
&lt;/row&gt;
&lt;row transcript-id=&quot;586837&quot; sco-id=&quot;586760&quot; principal-id=&quot;557527&quot;
status=&quot;user-failed&quot; score=&quot;10&quot; percentage-score=&quot;25&quot;
time-taken=&quot;51796&quot; certificate=&quot;&quot;&gt;
&lt;name&gt;Test de maths&lt;/name&gt;
&lt;login&gt;benedict2@exemple.com&lt;/login&gt;
&lt;date-taken&gt;2004-02-27T10:58:36.373-08:00&lt;/date-taken&gt;
&lt;principal-name&gt;Benedict, Georges&lt;/principal-name&gt;
&lt;/row&gt;
report-quiz-takers
49
&lt;row transcript-id=&quot;587485&quot; sco-id=&quot;586760&quot; principal-id=&quot;181255&quot;
status=&quot;user-passed&quot; score=&quot;30&quot; percentage-score=&quot;75&quot;
time-taken=&quot;37856&quot; certificate=&quot;587485&quot;&gt;
&lt;name&gt;Test de maths&lt;/name&gt;
&lt;login&gt;martin@exemple.com&lt;/login&gt;
&lt;date-taken&gt;2004-02-27T14:30:02.107-08:00&lt;/date-taken&gt;
&lt;principal-name&gt;Martin, Patrick&lt;/principal-name&gt;
&lt;/row&gt;
&lt;/report-quiz-takers&gt;
&lt;/results&gt;
report-sco-slides
Description
Indique le nombre de fois que chaque diapositive d’une pr&eacute;sentation a &eacute;t&eacute; visionn&eacute;e, et la date du
dernier affichage.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une pr&eacute;sentation.
&Eacute;l&eacute;ments renvoy&eacute;s
report-sco-slides
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-sco-slides&gt;
&lt;row slide=&quot;1&quot; views=&quot;5&quot;&gt;
&lt;last-viewed&gt;2004-01-13T16:35:39.517-08:00&lt;/last-viewed&gt;
&lt;/row&gt;
&lt;row slide=&quot;2&quot; views=&quot;8&quot;&gt;
&lt;last-viewed&gt;2004-01-13T16:35:42.350-08:00&lt;/last-viewed&gt;
&lt;/row&gt;
&lt;row slide=&quot;3&quot; views=&quot;7&quot;&gt;
&lt;last-viewed&gt;2004-01-13T16:35:44.933-08:00&lt;/last-viewed&gt;
&lt;/row&gt;
&lt;row slide=&quot;4&quot; views=&quot;8&quot;&gt;
&lt;last-viewed&gt;2004-01-13T16:35:47.640-08:00&lt;/last-viewed&gt;
&lt;/row&gt;
&lt;row slide=&quot;5&quot; views=&quot;8&quot;&gt;
&lt;last-viewed&gt;2004-01-13T16:35:51.723-08:00&lt;/last-viewed&gt;
&lt;/row&gt;
&lt;/report-sco-slides&gt;
&lt;/results&gt;
report-sco-views
Description
Indique le nombre de fois que la pr&eacute;sentation sp&eacute;cifi&eacute;e a &eacute;t&eacute; visionn&eacute;e, et la date du dernier
affichage.
50
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’une pr&eacute;sentation.
&Eacute;l&eacute;ments renvoy&eacute;s
report-sco-views
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-sco-views&gt;
&lt;row sco-id=&quot;217706&quot; type=&quot;presentation&quot; is-folder=&quot;0&quot; views=&quot;24&quot;&gt;
&lt;name&gt;Test 1&lt;/name&gt;
&lt;last-viewed-date&gt;2004-01-13T17:11:47.923-08:00&lt;/last-viewed-date&gt;
&lt;/row&gt;
&lt;/report-sco-views&gt;
&lt;/results&gt;
report-training-concurrent-users
Description
Indique le plus grand nombre d’utilisateurs ayant utilis&eacute; le syst&egrave;me en m&ecirc;me temps.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
report-training-concurrent-users
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;report-training-concurrent-users account-id=&quot;181224&quot; max-num-sessions=&quot;2&quot;
limit=&quot;1000000000&quot;&gt;
&lt;name&gt;Compte test professeur&lt;/name&gt;
&lt;/report-training-concurrent-users&gt;
&lt;/results&gt;
sco-build
Description
Provoque la compilation du SCO sp&eacute;cifi&eacute; par le serveur Breeze. Un SCO est invisible tant qu’il
n’a pas &eacute;t&eacute; compil&eacute;. Appelez cette action apr&egrave;s avoir transf&eacute;r&eacute; un SCO &agrave; l’aide de l’action scoupload.
Si vous transf&eacute;rez une nouvelle version d’un SCO existant, vous devez le recompiler en appelant
l’action sco-build. Tant que ce ne sera pas fait, les utilisateurs continueront &agrave; voir l’ancienne
version de ce SCO.
sco-build
51
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’un SCO &agrave; compiler.
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
Voir aussi
sco-upload
sco-contents
Description
Renvoie la liste des SCO du dossier sp&eacute;cifi&eacute;.
Dans la mesure o&ugrave; les dossiers sont eux-m&ecirc;mes des SCO, la liste renvoy&eacute;e comprend les dossiers
contenus dans le dossier sp&eacute;cifi&eacute;, mais cette liste ne comprend pas le contenu de ces sous-dossiers.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’un dossier.
&Eacute;l&eacute;ments renvoy&eacute;s
scos
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;scos&gt;
&lt;sco sco-id=&quot;505677&quot; status=&quot;no-content&quot; type=&quot;folder&quot; is-folder=&quot;1&quot;&gt;
&lt;name&gt;tests r&eacute;union PPT&lt;/name&gt;
&lt;date-modified&gt;2004-01-29T06:22:49.157-08:00&lt;/date-modified&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;193496&quot; status=&quot;active&quot; type=&quot;meeting&quot; is-folder=&quot;0&quot;&gt;
&lt;name&gt;Mon nom&lt;/name&gt;
&lt;date-begin&gt;2003-08-27T00:00:00.000-07:00&lt;/date-begin&gt;
&lt;date-end&gt;2003-08-27T01:00:00.000-07:00&lt;/date-end&gt;
&lt;date-modified&gt;2003-08-26T23:33:20.300-07:00&lt;/date-modified&gt;
&lt;duration&gt;1900-01-02T/+:00:00.000+00:00&lt;/duration&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;505323&quot; status=&quot;active&quot; type=&quot;meeting&quot; is-folder=&quot;0&quot;&gt;
&lt;name&gt;Mon nom 2&lt;/name&gt;
&lt;date-begin&gt;2004-01-29T01:30:00.000-08:00&lt;/date-begin&gt;
&lt;date-end&gt;2004-01-29T01:30:00.000-08:00&lt;/date-end&gt;
&lt;date-modified&gt;2004-01-29T01:35:26.433-08:00&lt;/date-modified&gt;
&lt;duration&gt;1900-01-02T/*:00:00.000+00:00&lt;/duration&gt;
&lt;/sco&gt;
52
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
&lt;/scos&gt;
&lt;/results&gt;
sco-delete
Description
Supprime un ou plusieurs SCO.
Pour supprimer plusieurs SCO, transmettez plusieurs param&egrave;tres sco-id. Pour plus
d'informations, consultez la section A propos des param&egrave;tres, page 13.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’un SCO.
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
sco-info
Description
Renvoie des informations sur un SCO. Pour toutes informations sur les SCO, consultez la section
A propos des mandants, des entit&eacute;s SCO et des identifiants, page 14.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’un SCO.
&Eacute;l&eacute;ments renvoy&eacute;s
Les balises renvoy&eacute;es d&eacute;pendent du type de SCO de l’&eacute;l&eacute;ment indiqu&eacute;.
Voici les principales balises susceptibles d’&ecirc;tre renvoy&eacute;es :
sco, sco-author, sco-data, source-sco
Exemple de r&eacute;sultat
Les exemples de r&eacute;sultat suivants concernent un SCO de type R&eacute;union :
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;sco author-contact-id=&quot;123200&quot; folder-id=&quot;181412&quot; host-id=&quot;&quot;
learning-time=&quot;0&quot; sco-data-id=&quot;95654&quot; sco-id=&quot;201894&quot; source-sco-id=&quot;&quot;
status=&quot;active&quot; tree-id=&quot;181227&quot; type=&quot;swf&quot;&gt;
&lt;date-created&gt;2004-01-26T20:47:05.653-07:00&lt;/date-created&gt;
&lt;date-modified&gt;2004-01-27T22:21:14.557-07:00&lt;/date-modified&gt;
&lt;name&gt;Ma r&eacute;union&lt;/name&gt;
&lt;url-path&gt;/p53917999/&lt;/url-path&gt;
sco-info
53
&lt;/sco&gt;
&lt;sco-author&gt;
&lt;email&gt;martin@exemple.com&lt;/email&gt;
&lt;first-name&gt;Paul&lt;/first-name&gt;
&lt;last-name&gt;Martin&lt;/last-name&gt;
&lt;/sco-author&gt;
&lt;sco-data byte-count=&quot;3993&quot; height=&quot;252&quot; length=&quot;-1&quot; sco-data-id=&quot;95654&quot;
slide-count=&quot;-1&quot; version=&quot;1&quot; width=&quot;380&quot;&gt;
&lt;date-created&gt;2004-01-26T20:47:05.653-07:00&lt;/date-created&gt;
&lt;date-modified&gt;2004-01-26T20:47:05.653-07:00&lt;/date-modified&gt;
&lt;physical-path&gt;222914/503227/&lt;/physical-path&gt;
&lt;/sco-data&gt;
&lt;source-sco /&gt;
&lt;/results&gt;
sco-move
Description
D&eacute;place un SCO d’un dossier &agrave; un autre.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
folder-id
Identifiant du dossier de destination.
sco-id
Identifiant du SCO &agrave; d&eacute;placer.
&Eacute;l&eacute;ments renvoy&eacute;s
status
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
sco-nav
Description
D&eacute;crit la hi&eacute;rarchie de dossiers contenant le SCO sp&eacute;cifi&eacute;.
Dans les r&eacute;sultats renvoy&eacute;s, l’attribut depth de la balise sco indique le nombre de niveaux qui
s&eacute;parent le dossier du SCO sp&eacute;cifi&eacute; dans la hi&eacute;rarchie. En d’autres termes, un attribut depth &eacute;gal
&agrave; 0 indique le SCO lui-m&ecirc;me, un attribut depth &eacute;gal &agrave; 1 indique le dossier qui contient le SCO,
etc.
Param&egrave;tres
accesskey
sco-id
Cl&eacute; d’acc&egrave;s du compte.
Identifiant d’un SCO.
&Eacute;l&eacute;ments renvoy&eacute;s
sco-nav
54
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;sco-nav&gt;
&lt;sco sco-id=&quot;181230&quot; tree-id=&quot;181230&quot; type=&quot;folder&quot; depth=&quot;2&quot;&gt;
&lt;name&gt;R&eacute;unions utilisateurs&lt;/name&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;181576&quot; tree-id=&quot;181230&quot; type=&quot;folder&quot; depth=&quot;1&quot;&gt;
&lt;name&gt;martin@exemple.com&lt;/name&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;503545&quot; tree-id=&quot;181230&quot; type=&quot;meeting&quot; depth=&quot;0&quot;&gt;
&lt;name&gt;cr&eacute;&eacute; avec 402&lt;/name&gt;
&lt;/sco&gt;
&lt;/sco-nav&gt;
&lt;/results&gt;
sco-search
Description
Renvoie la liste de tous les SCO correspondant au texte de recherche.
Le titre et le r&eacute;sum&eacute; de chaque type de SCO sont analys&eacute;s. Le contenu des pr&eacute;sentations et des
autres SCO contenant du texte est &eacute;galement analys&eacute;.
Param&egrave;tres
accesskey
query
Cl&eacute; d’acc&egrave;s du compte.
Cha&icirc;ne &agrave; rechercher.
&Eacute;l&eacute;ments renvoy&eacute;s
sco-search-info
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;sco-search-info&gt;
&lt;sco sco-id=&quot;202014&quot; folder-id=&quot;202008&quot; type=&quot;presentation&quot;
slide-count=&quot;4&quot; length=&quot;20000&quot;&gt;
&lt;name&gt;Questionnaire 1&lt;/name&gt;
&lt;url-path&gt;/p92628681/&lt;/url-path&gt;
&lt;date-created&gt;2003-11-26T22:52:28.973-08:00&lt;/date-created&gt;
&lt;date-modified&gt;2003-11-26T22:52:37.867-08:00&lt;/date-modified&gt;
&lt;first-name&gt;Michel&lt;/first-name&gt;
&lt;last-name&gt;Durand&lt;/last-name&gt;
&lt;hit&gt;1&lt;/hit&gt;
&lt;hit&gt;4&lt;/hit&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;202015&quot; folder-id=&quot;202008&quot; type=&quot;presentation&quot;
slide-count=&quot;7&quot; length=&quot;35000&quot;&gt;
&lt;name&gt;Autres questionnaires incomplets&lt;/name&gt;
&lt;url-path&gt;/p49954414/&lt;/url-path&gt;
&lt;date-created&gt;2003-11-26T23:02:52.870-08:00&lt;/date-created&gt;
&lt;date-modified&gt;2003-11-26T23:03:23.313-08:00&lt;/date-modified&gt;
&lt;first-name&gt;Michel&lt;/first-name&gt;
&lt;last-name&gt;Durand&lt;/last-name&gt;
&lt;hit&gt;1&lt;/hit&gt;
&lt;hit&gt;4&lt;/hit&gt;
sco-search
55
&lt;hit&gt;5&lt;/hit&gt;
&lt;hit&gt;7&lt;/hit&gt;
&lt;/sco&gt;
&lt;/sco-search-info&gt;
&lt;/results&gt;
sco-shortcuts
Description
Renvoie les identifiants d’un ensemble de dossiers dont le contenu concerne l’utilisateur actuel : le
dossier dans lequel sont enregistr&eacute;es les r&eacute;unions de l’utilisateur, le dossier dans lequel il place son
contenu, etc.
Pour d&eacute;terminer l’adresse URL d’un SCO, concat&eacute;nez le nom de domaine renvoy&eacute; par cette
action avec l’adresse URL renvoy&eacute;e par l’action sco-info dans la balise url-path.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
&Eacute;l&eacute;ments renvoy&eacute;s
shortcuts
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;shortcuts&gt;
&lt;sco tree-id=&quot;181230&quot; sco-id=&quot;181576&quot; type=&quot;my-meetings&quot;&gt;
&lt;domain-name&gt;http://admin.breeze.exemple.com&lt;/domain-name&gt;
&lt;/sco&gt;
&lt;sco tree-id=&quot;181227&quot; sco-id=&quot;181412&quot; type=&quot;my-content&quot;&gt;
&lt;domain-name&gt;http://admin.breeze.exemple.com&lt;/domain-name&gt;
&lt;/sco&gt;
&lt;sco tree-id=&quot;181225&quot; sco-id=&quot;181225&quot; type=&quot;content&quot;&gt;
&lt;domain-name&gt;http://admin.breeze.example.com&lt;/domain-name&gt;
&lt;/sco&gt;
&lt;sco tree-id=&quot;181226&quot; sco-id=&quot;181226&quot; type=&quot;courses&quot;&gt;
&lt;domain-name&gt;http://admin.breeze.example.com&lt;/domain-name&gt;
&lt;/sco&gt;
&lt;sco tree-id=&quot;181227&quot; sco-id=&quot;181227&quot; type=&quot;user-content&quot;&gt;
&lt;domain-name&gt;http://admin.breeze.example.com&lt;/domain-name&gt;
&lt;/sco&gt;
&lt;sco tree-id=&quot;181228&quot; sco-id=&quot;181228&quot; type=&quot;meetings&quot;&gt;
&lt;domain-name&gt;http://admin.breeze.example.com&lt;/domain-name&gt;
&lt;/sco&gt;
&lt;sco tree-id=&quot;181230&quot; sco-id=&quot;181230&quot; type=&quot;user-meetings&quot;&gt;
&lt;domain-name&gt;http://admin.breeze.example.com&lt;/domain-name&gt;
&lt;/sco&gt;
&lt;/shortcuts&gt;
&lt;/results&gt;
Voir aussi
sco-info
56
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
sco-update
Description
Si cette action est appel&eacute;e avec une valeur pour le param&egrave;tre sco-id, elle modifie le type du SCO.
Si cette action est appel&eacute;e avec une valeur pour le param&egrave;tre folder-id, elle cr&eacute;e un nouveau
SCO. Si vous cr&eacute;ez un nouveau SCO, le code XML renvoy&eacute; contient les informations sur celui-ci,
y compris son identifiant.
Un seul des deux param&egrave;tres suivants doit &ecirc;tre indiqu&eacute; : folder-id ou sco-id.
Apr&egrave;s avoir appel&eacute; cette action, vous devez aeppeler l’action permissions-update pour attribuer
les autorisations. Pour plus d'informations sur les autorisations, consultez la section A propos de la
s&eacute;curit&eacute;, page 15.
Param&egrave;tres
Cl&eacute; d’acc&egrave;s du compte.
accesskey
Date et heure de d&eacute;but pr&eacute;vues. (Utilis&eacute; uniquement pour les r&eacute;unions et les
date-begin
cours.)
date-end
Date et heure de fin pr&eacute;vues. (Utilis&eacute; uniquement pour les r&eacute;unions et les cours.)
Description du SCO, &agrave; l’intention des utilisateurs.
description
Adresse e-mail de la personne &agrave; contacter pour ce SCO. (Utilis&eacute; uniquement pour les
pr&eacute;sentations.)
email
first-name
Pr&eacute;nom de la personne &agrave; contacter pour ce SCO. (Utilis&eacute; uniquement pour les
pr&eacute;sentations.)
folder-id Identifiant du dossier dans lequel le serveur cr&eacute;era le nouveau SCO. Ce param&egrave;tre
est facultatif et ne peut pas &ecirc;tre sp&eacute;cifi&eacute; avec sco-id.
Nom de la personne &agrave; contacter pour ce SCO. (Utilis&eacute; uniquement pour les
pr&eacute;sentations.)
last-name
name
Nom du SCO.
sco-id Identifiant d’un SCO &agrave; actualiser. Ce param&egrave;tre est facultatif et ne peut pas &ecirc;tre sp&eacute;cifi&eacute;
avec folder-id.
sco-tag Libell&eacute; d’un SCO. Ce param&egrave;tre peut contenir des donn&eacute;es arbitraires. Par exemple,
pour un cours sur les notions de base de l’&eacute;conomie, vous pouvez indiquer &laquo; Notions de base &raquo;
comme valeur du param&egrave;tre sco-tag. (Utilis&eacute; uniquement pour les cours.)
source-sco-id
Identifiant du contenu du SCO. (Utilis&eacute; uniquement pour les cours.)
Type du nouveau SCO. Pour plus d'informations sur les types, consultez la section A
propos des mandants, des entit&eacute;s SCO et des identifiants, page 14.
type
&Eacute;l&eacute;ments renvoy&eacute;s
En cas d’actualisation d’un SCO existant, aucun.
En cas de cr&eacute;ation d’un SCO, sco.
sco-update
57
Exemple de r&eacute;sultat
Exemples de r&eacute;sultats renvoy&eacute;s lors de la cr&eacute;ation d’un nouveau SCO :
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;sco folder-id=&quot;181412&quot; type=&quot;folder&quot; sco-id=&quot;2501961&quot; status=&quot;active&quot;
author-contact-id=&quot;2501962&quot; tree-id=&quot;181227&quot; sco-data-id=&quot;2501963&quot;&gt;
&lt;url-path&gt;/p54135747/&lt;/url-path&gt;
&lt;name&gt;Test SCO&lt;/name&gt;
&lt;/sco&gt;
&lt;/results&gt;
sco-upload
Description
Transf&egrave;re un fichier sur le serveur Breeze.
Les param&egrave;tres de cette action doivent &ecirc;tre transmis sous la forme MIME multipartie (multipart/
form-data media type). Pour cr&eacute;er ces param&egrave;tres, le plus simple consiste &agrave; utiliser un contr&ocirc;le de
formulaire du type &quot;file&quot; dans un formulaire de page Web.
Apr&egrave;s avoir transf&eacute;r&eacute; un fichier, appelez l’action sco-build pour le compiler.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
Fichier &agrave; transf&eacute;rer. Ce param&egrave;tre doit contenir les vraies donn&eacute;es du fichier, pas
simplement son nom de fichier ou son chemin d’acc&egrave;s.
file
Identifiant du nouveau SCO. Le type de ce SCO doit avoir &eacute;t&eacute; d&eacute;fini auparavant, par
exemple &agrave; l’aide de l’action sco-update.
sco-id
summary Bref r&eacute;sum&eacute; des informations g&eacute;n&eacute;rales sur le SCO. Ce r&eacute;sum&eacute;, qui appara&icirc;t dans les
listes de contenu, est renvoy&eacute; par l’action sco-info. Ce param&egrave;tre est facultatif.
title
Titre du nouveau SCO.
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
Voir aussi
sco-build
58
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
user-accounts
Description
Renvoie la liste des comptes auxquels appartient l’utilisateur sp&eacute;cifi&eacute;.
Dans un syst&egrave;me Breeze d’entreprise (non h&eacute;berg&eacute;), il n’existe en g&eacute;n&eacute;ral qu’un seul compte ,
auquel cas il est peu probable que vous ayez besoin d’utiliser cette action.
Param&egrave;tres
accesskey
Cl&eacute; d’acc&egrave;s du compte.
Identifiant de connexion de l'utilisateur (qui est fr&eacute;quemment l’adresse de messagerie de
cet utilisateur).
login
password
Mot de passe de l’utilisateur.
&Eacute;l&eacute;ments renvoy&eacute;s
users
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;users&gt;
&lt;user user-id=&quot;211729&quot; account-id=&quot;211655&quot;&gt;
&lt;name&gt;martine@exemple.com&lt;/name&gt;
&lt;date-expired&gt;2004-01-24T00:59:59.000-07:00&lt;/date-expired&gt;
&lt;/user&gt;
&lt;user user-id=&quot;212988&quot; account-id=&quot;212928&quot;&gt;
&lt;name&gt;julien@exemple.com&lt;/name&gt;
&lt;date-expired&gt;2004-01-24T00:59:59.000-07:00&lt;/date-expired&gt;
&lt;/user&gt;
&lt;user user-id=&quot;214251&quot; account-id=&quot;214191&quot;&gt;
&lt;name&gt;fabrice@exemple.com&lt;/name&gt;
&lt;date-expired&gt;2004-01-24T00:59:59.000-07:00&lt;/date-expired&gt;
&lt;/user&gt;
&lt;/users&gt;
&lt;/results&gt;
user-update-pwd
Description
Modifie le mot de passe d’un utilisateur.
Param&egrave;tres
accesskey
password
Cl&eacute; d’acc&egrave;s du compte.
Nouveau mot de passe.
password-old
Mot de passe actuel de l’utilisateur.
password-verify
user-id
Second exemplaire du nouveau mot de passe pour v&eacute;rification.
Identifiant de l’utilisateur.
user-update-pwd
59
&Eacute;l&eacute;ments renvoy&eacute;s
Aucun.
Exemple de r&eacute;sultat
&lt;results&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
60
Chapitre 3 : Guide de r&eacute;f&eacute;rence des actions
CHAPITRE 4
R&eacute;f&eacute;rences pour les r&eacute;sultats XML
Le pr&eacute;sent chapitre d&eacute;crit les balises XML, les donn&eacute;es et les codes d'&eacute;tat renvoy&eacute;s par le serveur
Macromedia Breeze en r&eacute;ponse &agrave; une action. Pour plus de d&eacute;tails sur les actions pouvant &ecirc;tre
appel&eacute;es sur le serveur, consultez la section Chapitre 3, Guide de r&eacute;f&eacute;rence des actions, page 27.
A propos du code XML renvoy&eacute;
Lorsque vous appelez une action sur le serveur Breeze, ce dernier renvoie un bloc de code XML.
La balise parente du code XML est toujours une balise results. La balise results contient une
balise status, qui indique si l'action s'est termin&eacute;e avec succ&egrave;s. Dans la plupart des cas, si l'action
s'est termin&eacute;e avec succ&egrave;s, la balise results contient &eacute;galement d'autres balises qui regroupent les
donn&eacute;es renvoy&eacute;es par l'action.
Par exemple, une action common-info peut renvoyer les r&eacute;sultats suivants :
&lt;r&eacute;sultats&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;common locale=&quot;fr&quot;&gt;
&lt;cookie&gt;breezm5qtgnye46zpckbf.MARIANNE&lt;/cookie&gt;
&lt;date&gt;2004-02-12T15:53:19.797-07:00&lt;/date&gt;
&lt;host&gt;http://admin.breeze.exemple.com&lt;/host&gt;
&lt;url&gt;/api/xml?accesskey=yyyyyyyyyyyyyyyy&amp;action=common-info&lt;/url&gt;
&lt;version&gt;breeze_402_r116&lt;/version&gt;
&lt;account account-id=&quot;222914&quot; /&gt;
&lt;user user-id=&quot;503562&quot;&gt;
&lt;login&gt;dupont@exemple.com&lt;/login&gt;
&lt;/user&gt;
&lt;/common&gt;
&lt;/results&gt;
Le pr&eacute;sent chapitre pr&eacute;sente les balises par ordre alphab&eacute;tique ; chaque balise dispose de sa propre
section.
Pour plus de d&eacute;tails sur les valeurs possibles de la balise &laquo; status &raquo;, voir la section status.
Pour plus de d&eacute;tails sur les balises renvoy&eacute;es pour une action donn&eacute;es, consultez la documentation
correspondant &agrave; cette action dans le Chapitre 3, Guide de r&eacute;f&eacute;rence des actions, page 27.
En l'absence de donn&eacute;es pour une balise devant normalement &ecirc;tre renvoy&eacute;e en r&eacute;ponse &agrave; une
action, cette balise n'est pas renvoy&eacute;e. Dans l'exemple pr&eacute;c&eacute;dent, si l'application d'appel n'a pas
sp&eacute;cifi&eacute; d'utilisateur connect&eacute;, les r&eacute;sultats renvoy&eacute;s ne contiennent pas de balise user.
61
Lorsque votre application Web re&ccedil;oit le code XML renvoy&eacute;, elle l'analyse pour identifier les
valeurs renvoy&eacute;es. Pour consulter des exemples, reportez-vous au Chapitre 2, T&acirc;ches courantes,
page 19.
access-key (conteneur)
Il existe deux balises access-key qui sont d&eacute;crites dans des sections diff&eacute;rentes.
Description
Contient des informations sur une cl&eacute; d'acc&egrave;s sp&eacute;ciale fournie par une entit&eacute; SCO.
Attributs
acl-id
L'identifiant de l'entit&eacute; SCO associ&eacute;e &agrave; la cl&eacute; d'acc&egrave;s.
Indique le type d'auto-inscription devant &ecirc;tre appliqu&eacute; par l'utilisateur. Les valeurs
possibles sont &quot;action-self-reg-meeting&quot; et &quot;action-self-reg-course&quot;.
action
Balises contenues
access-key (cl&eacute;), date-created
Renvoy&eacute;es par
accesskey-info
Exemple
&lt;access-key acl-id=&quot;622847&quot; action=&quot;action-self-reg-meeting&quot;
parent-acl-id=&quot;503265&quot;&gt;
&lt;access-key&gt;3hzvnifcfmphn3id&lt;/access-key&gt;
&lt;date-created&gt;2004-03-05T10:28:14.750-08:00&lt;/date-created&gt;
&lt;/access-key&gt;
Voir aussi
access-key (cl&eacute;), access-keys
access-key (cl&eacute;)
Il existe deux balises access-key qui sont d&eacute;crites dans des sections diff&eacute;rentes.
Description
Contient une cl&eacute; d'acc&egrave;s sp&eacute;ciale &agrave; utiliser pour l'auto-inscription.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
accesskey-info
Exemple
&lt;access-key&gt;vb7gmg6ohtz4y7k6&lt;/access-key&gt;
62
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
Voir aussi
access-key (conteneur), access-keys
access-keys
Description
Balise conteneur ; contient une ou plusieurs cl&eacute;s d'acc&egrave;s.
Attributs
Aucun.
Balises contenues
access-key (conteneur)
Renvoy&eacute;es par
accesskey-info
Exemple
&lt;access-keys&gt;
&lt;access-key acl-id=&quot;619605&quot; action=&quot;1&quot; parent-acl-id=&quot;619605&quot;&gt;
&lt;access-key&gt;vb7gmg6ohtz4y7k6&lt;/access-key&gt;
&lt;date-created&gt;2004-03-05T00:30:38.483-08:00&lt;/date-created&gt;
&lt;/access-key&gt;
&lt;/access-keys&gt;
account
Description
Contient l'identifiant du compte.
Attributs
account-id
L'identifiant du compte.
Balises contenues
Aucune. (Balise vide.)
Renvoy&eacute;es par
common-info
Exemple
&lt;account account-id=&quot;222914&quot; /&gt;
account
63
action
Description
Contient le nom d'une action.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
action-list
Exemple
&lt;action&gt;user-accounts&lt;/action&gt;
actions
Description
Balise conteneur ; contient une liste d'actions.
Attributs
Aucun.
Balises contenues
action
Renvoy&eacute;es par
action-list
Exemple
&lt;actions&gt;
&lt;action&gt;accesskey-exec&lt;/action&gt;
&lt;action&gt;accesskey-info&lt;/action&gt;
&lt;action&gt;action-list&lt;/action&gt;
...
[la liste des autres actions figure ici]
...
&lt;action&gt;user-accounts&lt;/action&gt;
&lt;action&gt;user-update-pwd&lt;/action&gt;
&lt;/actions&gt;
64
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
answer-text
Description
Cette balise est incluse dans les r&eacute;sultats renvoy&eacute;s par une action de type report, contient le texte
d'une r&eacute;ponse &agrave; un questionnaire.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-quiz-answer-distribution, report-quiz-question-response
Exemple
&lt;answer-text&gt;ECMA-262&lt;/answer-text&gt;
body
Description
Contient le texte de l'&eacute;l&eacute;ment renvoy&eacute;, tel que le texte d'une r&eacute;ponse dans un rapport incluant un
questionnaire.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-quiz-answer-distribution, report-quiz-definition-answers,
report-quiz-definition-questions, report-quiz-question-distribution,
report-quiz-question-response
Exemple
&lt;body&gt;Combien font 2+2 ?&lt;/body&gt;
common
Description
Balise conteneur ; contient des balises qui fournissent des informations sur le serveur et
l'utilisateur connect&eacute;.
Si vous appelez common-info avant d'&eacute;talir une connexion, les m&ecirc;mes informations sont
renvoy&eacute;es, sauf pour la balise user.
common
65
Attributs
locale
Indique la zone g&eacute;ographique de l'utilisateur connect&eacute;.
Balises contenues
account, cookie, date, host, url, user (common-info), version
Renvoy&eacute;es par
common-info
Exemple
&lt;common locale=&quot;fr&quot;&gt;
&lt;cookie&gt;breezm5qtgnye46zpckbf.MARIANNE&lt;/cookie&gt;
&lt;date&gt;2004-02-12T15:53:19.797-07:00&lt;/date&gt;
&lt;host&gt;http://admin.breeze.exemple.com&lt;/host&gt;
&lt;url&gt;/api/xml?accesskey=yyyyyyyyyyyyyyyy&amp;action=common-info&lt;/url&gt;
&lt;version&gt;breeze_402_r116&lt;/version&gt;
&lt;account account-id=&quot;222914&quot; /&gt;
&lt;user user-id=&quot;503562&quot;&gt;
&lt;login&gt;dupont@exemple.com&lt;/login&gt;
&lt;/user&gt;
&lt;/common&gt;
cookie
Description
Contient la valeur du cookie de session du servlet Java, appel&eacute; JSESSIONID.
Il s'agit du cookie accompagnant tout appel d'action pour identifier l'utilisateur d'origine. Si vous
appelez common-info avant de vous connecter, le serveur renvoie un nouveau cookie.
Vous avez besoin de ce cookie lorsque, par exemple, vous cr&eacute;ez une nouvelle fen&ecirc;tre de navigateur
ou lancez un SCO. Selon l'impl&eacute;mentation du syst&egrave;me externe, il peut &ecirc;tre plus pratique
d'acqu&eacute;rir le cookie &agrave; partir du serveur &agrave; l'aide de common-info que de laisser cette couche de
code d&eacute;terminer le cookie &agrave; envoyer lors d'un appel d'action.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
common-info
Exemple
&lt;cookie&gt;breezm5qtgnye46zpckbf.MARIANNE&lt;/cookie&gt;
66
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
course
Description
Contient des informations sur un cours.
Attributs
L'identifiant du cours.
sco-id
Indique si le cours est actif. Les valeurs possibles sont &quot;no-content&quot;, qui indiquent que
le cours vient d'&ecirc;tre cr&eacute;&eacute; et ne comporte aucun contenu, et &quot;active&quot;.
status
type
Indique que cette entit&eacute; SCO est un cours. La valeur est toujours &quot;course&quot;.
Balises contenues
date-begin, date-created, date-end, date-modified, expired, name, url, url-path
Renvoy&eacute;es par
report-my-courses
Exemple
&lt;course sco-id=&quot;555038&quot; status=&quot;active&quot; type=&quot;course&quot;&gt;
&lt;name&gt;Mon nom&lt;/name&gt;
&lt;url&gt;admin.breeze.exemple.com/p38547860/&lt;/url&gt;
&lt;date-created&gt;2004-02-09T14:40:38.497-08:00&lt;/date-created&gt;
&lt;date-modified&gt;2004-02-09T14:40:44.623-08:00&lt;/date-modified&gt;
&lt;date-begin&gt;2004-02-09T14:30:00.000-08:00&lt;/date-begin&gt;
&lt;date-end&gt;2004-02-09T14:30:00.000-08:00&lt;/date-end&gt;
&lt;url-path&gt;/p38547860/&lt;/url-path&gt;
&lt;expired&gt;true&lt;/expired&gt;
&lt;/course&gt;
date
Description
Renvoie la date et l'heure du serveur au format ISO 8601.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
common-info
Exemple
&lt;date&gt;2004-02-12T15:53:19.797-07:00&lt;/date&gt;
date
67
date-begin
Description
Contient la date et l'heure pr&eacute;vues de lancement de l'entit&eacute; SCO, au format de date ISO 8601.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-active-meetings, report-meeting-session, report-meeting-sessions,
report-my-courses, report-my-meetings, sco-contents
Exemple
&lt;date-begin&gt;2003-09-02T21:41:58.330-07:00&lt;/date-begin&gt;
date-closed
Description
Indique l'heure &agrave; laquelle l'utilisateur a ferm&eacute; la fen&ecirc;tre de la r&eacute;union, ce qui confirme qu'il a
quitt&eacute; la r&eacute;union.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-meeting-attendance
Exemple
&lt;date-closed&gt;2004-01-29T00:59:41.470-08:00&lt;/date-closed&gt;
date-created
Description
Contient la date et l'heure de cr&eacute;ation d'une entit&eacute; SCO, au format de date ISO 8601.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
68
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
Renvoy&eacute;es par
accesskey-info, report-active-meeting-presenters, report-meeting-attendance,
report-my-courses, report-quiz-interactions, sco-info, sco-search
Exemple
&lt;date-created&gt;2004-02-09T14:40:38.497-08:00&lt;/date-created&gt;
date-end
Description
Contient la date et l'heure pr&eacute;vues de fin pr&eacute;vue de l'entit&eacute; SCO, au format de date ISO 8601.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-meeting-session, report-my-courses, report-my-meetings, sco-contents
Exemple
&lt;date-end&gt;2004-02-09T14:30:00.000-08:00&lt;/date-end&gt;
date-expired
Description
Contient la date d'expiration pr&eacute;vue de l'entit&eacute; SCO, au format de date ISO 8601.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
user-accounts
Exemple
&lt;date-expired&gt;2004-01-24T00:59:59.000-07:00&lt;/date-expired&gt;
date-modified
Description
Indique la derni&egrave;re date de modification de quelque chose, au format de date ISO 8601.
Attributs
Aucun.
date-modified
69
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-my-courses, report-quiz-definition-questions, sco-contents, sco-info,
sco-search
Exemple
&lt;date-modified&gt;2004-02-09T14:40:44.623-08:00&lt;/date-modified&gt;
date-taken
Description
Indique la date &agrave; laquelle un utilisateur a r&eacute;pondu &agrave; un questionnaire.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-quiz-takers
Exemple
&lt;date-taken&gt;2004-01-13T01:33:49.460-08:00&lt;/date-taken&gt;
description
Description
Contient la description d'une entit&eacute; principale.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
principal-info, principal-list
Exemple
&lt;description&gt;Groupe d'administrateurs de compte&lt;/description&gt;
70
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
domain-name
Description
Contient le nom de domaine de l'emplacement de l'entit&eacute; SCO avec tous ses qualificatifs.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-my-meetings, sco-shortcuts
Exemple
&lt;domain-name&gt;admin.breeze.exemple.com&lt;/domain-name&gt;
duration
Description
La dur&eacute;e d'une entit&eacute; SCO.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
sco-contents
Exemple
&lt;duration&gt;1900-01-02T/+:00:00.000+00:00&lt;/duration&gt;
email
Description
Contient l'adresse e-mail d'un utilisateur.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
principal-list, sco-info
email
71
Exemple
&lt;email&gt;durand@exemple.com&lt;/email&gt;
expired
Description
Indique si une entit&eacute; SCO a expir&eacute;.
Une entit&eacute; SCO expire lorsque sa date de fin est atteinte et que cette entit&eacute; n'est plus disponible.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-my-courses, report-my-meetings
Exemple
&lt;expired&gt;true&lt;/expired&gt;
first-name
Description
Contient le pr&eacute;nom d'un utilisateur.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
sco-info, sco-search
Exemple
&lt;first-name&gt;Paul&lt;/first-name&gt;
72
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
hit
Description
Indique qu'une diapositive donn&eacute;e contient les termes recherch&eacute;s.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
sco-search
Exemple
&lt;hit&gt;5&lt;/hit&gt;
host
Description
Contient l'URL de l'h&ocirc;te du serveur Breeze.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
common-info
Exemple
&lt;host&gt;http://admin.breeze.exemple.com&lt;/host&gt;
invalid
Description
Explique pourquoi l'appel &agrave; une action n'est pas valide.
Cet &eacute;l&eacute;ment s'affiche uniquement dans une balise status et uniquement lorsque l'attribut code
de cette balise est d&eacute;fini sur &quot;invalid&quot;.
Le serveur renvoie uniquement une balise invalid pour une requ&ecirc;te donn&eacute;e, m&ecirc;me s'il manque
plusieurs param&egrave;tres. Pour r&eacute;soudre les erreurs li&eacute;es aux param&egrave;tres manquants, ajoutez les
param&egrave;tres requis &agrave; l'action. Pour d&eacute;terminer les param&egrave;tres requis, consultez le document de
r&eacute;f&eacute;rence de l'action concern&eacute;e dans le Chapitre 3, Guide de r&eacute;f&eacute;rence des actions, page 27.
invalid
73
Attributs
field
Le nom du param&egrave;tre non valide.
subcode La raison pour laquelle le param&egrave;tre n'&eacute;tait pas valide. Vous trouverez ci-dessous les
valeurs possibles de cet attribut :
L'appel a tent&eacute; d'ajouter un &eacute;l&eacute;ment dupliqu&eacute; dans un contexte imposant des
&eacute;l&eacute;ments uniques.
format Le format de l'un des param&egrave;tres pass&eacute;s n'est pas correct.
illegal-operation L'op&eacute;ration requise ne respecte pas les r&egrave;gles d'int&eacute;grit&eacute; (par
exemple, le d&eacute;placement d'un dossier sur lui-m&ecirc;me est une op&eacute;ration non valide).
missing Un param&egrave;tre requis est manquant.
no-such-item Les informations requises n'existent pas.
range La valeur est en dehors de la plage authoris&eacute;e.
duplicate
type
Le type de param&egrave;tre, tel que &quot;id&quot;, &quot;long&quot; ou &quot;string&quot;.
Balises contenues
Aucune. (Balise vide.)
Renvoy&eacute;es par
Toute action non valide.
Exemple
&lt;invalid field=&quot;sco-id&quot; type=&quot;id&quot; subcode=&quot;missing&quot; /&gt;
last-name
Description
Contient le nom d'un utilisateur.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
sco-info, sco-search
Exemple
&lt;last-name&gt;Martin&lt;/last-name&gt;
74
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
last-viewed-date
Description
Indique la date et l'heure du dernier affichage de l'identit&eacute; SCO.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-sco-views
Exemple
&lt;last-viewed-date&gt;2004-01-13T17:11:47.923-08:00&lt;/last-viewed-date&gt;
last-viewed
Description
Indique la date et l'heure du dernier affichage de l'entit&eacute; SCO.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-sco-slides
Exemple
&lt;last-viewed&gt;2004-01-13T16:35:39.517-08:00&lt;/last-viewed&gt;
login
Description
Indique le nom de connexion de l'utilisateur, qui correspond g&eacute;n&eacute;ralement &agrave; son adresse
&eacute;lectronique.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
login
75
Renvoy&eacute;es par
common-info, permissions-info, principal-info, principal-list,
report-course-takers, report-meeting-attendance, report-quiz-takers
Exemple
&lt;login&gt;durand@exemple.com&lt;/login&gt;
meeting
Description
Contient des informations sur une r&eacute;union.
Attributs
active-participants
Le nombre actuel de participants.
Les autorisations de l'utilisateur dans le cadre de la r&eacute;union. Pour plus
d'informations, consultez la section A propos de la s&eacute;curit&eacute;, page 15.
permission-id
L'identifiant de la r&eacute;union.
sco-id
Indique l'&eacute;tat de la r&eacute;union. Les valeurs possibles sont &quot;no-content&quot;, qui indique que
la r&eacute;union vient d'&ecirc;tre cr&eacute;&eacute;e, mais n'a pas encore re&ccedil;u de contenu ou &quot;in-progress&quot;, qui d&eacute;signe
une r&eacute;union en cours et &quot;active&quot;.
status
type
Indique que cette entit&eacute; SCO est une r&eacute;union. La valeur est toujours &quot;meeting&quot;.
Balises contenues
date-begin, date-end, domain-name, expired, name, url-path
Renvoy&eacute;es par
report-my-meetings
Exemple
&lt;meeting sco-id=&quot;181487&quot; type=&quot;meeting&quot; status=&quot;active&quot; permission-id=&quot;view&quot;
length=&quot;36000000&quot; active-participants=&quot;0&quot;&gt;
&lt;name&gt;morris shared&lt;/name&gt;
&lt;domain-name&gt;admin.breeze.exemple.com&lt;/domain-name&gt;
&lt;url-path&gt;/r99718924/&lt;/url-path&gt;
&lt;date-begin&gt;2003-07-14T23:00:00.000-07:00&lt;/date-begin&gt;
&lt;date-end&gt;2003-07-15T09:00:00.000-07:00&lt;/date-end&gt;
&lt;expired&gt;true&lt;/expired&gt;
&lt;/meeting&gt;
my-courses
Description
Balise conteneur ; contient des informations sur un ou plusieurs cours.
Attributs
Aucun.
76
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
Balises contenues
course
Renvoy&eacute;es par
report-my-courses
Exemple
&lt;my-courses&gt;
&lt;course sco-id=&quot;555038&quot; status=&quot;active&quot; type=&quot;course&quot;&gt;
&lt;name&gt;Mon nom&lt;/name&gt;
&lt;url&gt;admin.breeze.exemple.com/p38547860/&lt;/url&gt;
&lt;date-created&gt;2004-02-09T14:40:38.497-08:00&lt;/date-created&gt;
&lt;date-modified&gt;2004-02-09T14:40:44.623-08:00&lt;/date-modified&gt;
&lt;date-begin&gt;2004-02-09T14:30:00.000-08:00&lt;/date-begin&gt;
&lt;date-end&gt;2004-02-09T14:30:00.000-08:00&lt;/date-end&gt;
&lt;url-path&gt;/p38547860/&lt;/url-path&gt;
&lt;expired&gt;true&lt;/expired&gt;
&lt;/course&gt;
&lt;/my-courses&gt;
my-meetings
Description
Balise conteneur ; contient des informations sur une ou plusieurs r&eacute;unions.
Attributs
Aucun.
Balises contenues
meeting
Renvoy&eacute;es par
report-my-meetings
Exemple
&lt;my-meetings&gt;
&lt;meeting sco-id=&quot;181487&quot; type=&quot;meeting&quot; status=&quot;active&quot; permission-id=&quot;view&quot;
length=&quot;36000000&quot; active-participants=&quot;0&quot;&gt;
&lt;name&gt;morris shared&lt;/name&gt;
&lt;domain-name&gt;admin.breeze.exemple.com&lt;/domain-name&gt;
&lt;url-path&gt;/r99718924/&lt;/url-path&gt;
&lt;date-begin&gt;2003-07-14T23:00:00.000-07:00&lt;/date-begin&gt;
&lt;date-end&gt;2003-07-15T09:00:00.000-07:00&lt;/date-end&gt;
&lt;expired&gt;true&lt;/expired&gt;
&lt;/meeting&gt;
&lt;/my-meetings&gt;
my-meetings
77
name
Description
Contient un nom. Par exemple, selon le contexte, la balise peut contenir le nom d'une personne,
le nom d'un groupe, le nom d'une entit&eacute; SCO, une adresse &eacute;lectronique ou tout autre sorte de
nom.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
permissions-info, principal-info, principal-list,
report-active-meeting-presenters, report-active-meetings,
report-meeting-session, report-meeting-sessions, report-my-courses,
report-my-meetings, report-quiz-takers, report-sco-views,
report-training-concurrent-users, sco-contents, sco-info, sco-nav, sco-search,
user-accounts
Exemple
&lt;name&gt;Contr&ocirc;le de math&eacute;matiques&lt;/name&gt;
participant-name
Description
Contient le nom d'un participant &agrave; une r&eacute;union.
Le nom est pr&eacute;sent&eacute; sous la forme correspondant aux param&egrave;tres r&eacute;gionaux.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-meeting-attendance
Exemple
&lt;participant-name&gt;Durand, Pat&lt;/participant-name&gt;
78
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
permissions
Description
Balise conteneur ; contient des informations sur une ou plusieurs entit&eacute;s principales et les
autorisations correspondantes.
(Pour plus d'informations sur les entit&eacute;s principales, consultez la section A propos des mandants,
des entit&eacute;s SCO et des identifiants, page 14. Pour plus d'informations sur les autorisations,
consultez la section A propos de la s&eacute;curit&eacute;, page 15.
Attributs
Aucun.
Balises contenues
principal
Renvoy&eacute;es par
permissions-info
Exemple
&lt;autorisations&gt;
&lt;principal principal-id=&quot;181248&quot; is-primary=&quot;false&quot; type=&quot;user&quot;
has-children=&quot;false&quot; permission-id=&quot;view&quot;&gt;
&lt;name&gt;Englesberg, Ari&lt;/name&gt;
&lt;login&gt;englesberg@exemple.com&lt;/login&gt;
&lt;/principal&gt;
&lt;/permissions&gt;
physical-path
Description
Contient le chemin de l'entit&eacute; SCO sur le serveur.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
sco-info
Exemple
&lt;physical-path&gt;222914/503227/&lt;/physical-path&gt;
physical-path
79
principal
Description
Contient des informations sur une entit&eacute; principale.
(Pour plus d'informations sur les entit&eacute;s principales, consultez la section A propos des mandants,
des entit&eacute;s SCO et des identifiants, page 14.
Attributs
account-id L'identifiant du compte dont le mandant est membre. Cet attribut est renvoy&eacute;
uniquement par l'action principal-info.
Indique si le mandant poss&egrave;de des enfants. Les groupes peuvent avoir des
enfants, mais pas les utilisateurs. Par cons&eacute;quent, cet attribut indique si le mandant est un groupe.
has-children
is-primary
type.
Indique si le mandant est un groupe primaire. Pour plus de d&eacute;tails, voir l'attribut
Les autorisations du mandant dans le cadre de l'entit&eacute; SCO sp&eacute;cifi&eacute;e. Cet
attribut est renvoy&eacute; uniquement par l'action permissions-info.
permission-id
principal-id
L'identifiant du mandant.
type Le type du mandant. Les valeurs possibles incluent &quot;user&quot;, &quot;group&quot; et diff&eacute;rents types de
groupes primaires : &quot;admins&quot;, &quot;authors&quot;, &quot;live-admins&quot; et &quot;course-admins&quot;. Vous pouvez
cr&eacute;er et modifier des utilisateurs et des groupes, mais pas des groupes primaires.
Balises contenues
description, email, login, name
Remarque : Les balises contenues ne sont renvoy&eacute;es que sous certaines conditions.
Renvoy&eacute;es par
permissions-info, principal-info, principal-list
Exemple
&lt;principal principal-id=&quot;222917&quot; type=&quot;admins&quot; has-children=&quot;true&quot;
is-primary=&quot;true&quot; is-hidden=&quot;0&quot;&gt;
&lt;name&gt;Administrateurs de compte&lt;/name&gt;
&lt;login&gt;Administrateurs de compte&lt;/login&gt;
&lt;description&gt;Groupe d'administrateurs de compte&lt;/description&gt;
&lt;/principal&gt;
principal-list
Description
Balise conteneur ; contient un ou plusieurs mandants.
Attributs
Aucun.
Balises contenues
principal
80
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
Renvoy&eacute;es par
principal-list
Exemple
&lt;principal-list&gt;
&lt;principal principal-id=&quot;222917&quot; type=&quot;admins&quot; has-children=&quot;true&quot;
is-primary=&quot;true&quot; is-hidden=&quot;0&quot;&gt;
&lt;name&gt;Administrateurs de compte&lt;/name&gt;
&lt;login&gt;Administrateurs de compte&lt;/login&gt;
&lt;description&gt;Groupe d'administrateurs de compte&lt;/description&gt;
&lt;/principal&gt;
&lt;/principal-list&gt;
principal-name
Description
Contient le nom d'un mandant.
Le nom est pr&eacute;sent&eacute; sous la forme correspondant aux param&egrave;tres r&eacute;gionaux.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-course-takers, report-quiz-takers
Exemple
&lt;principal-name&gt;Chiang, Ed&lt;/principal-name&gt;
question-text
Description
Contient l'une des questions d'un questionnaire.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-quiz-question-answer-distribution
Exemple
&lt;question-text&gt;Combien font 2+2 ?&lt;/question-text&gt;
question-text
81
question
Description
Contient l'une des questions d'un questionnaire.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-quiz-interactions
Exemple
&lt;question&gt;Combien font 2+2 ?&lt;/question&gt;
quiz-definition-answers
Description
Balise conteneur ; contient une ou plusieurs balises row, chacune de ces balises comporte la
r&eacute;ponse &agrave; une question.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-quiz-definition-answers
Exemple
&lt;quiz-definition-answers&gt;
&lt;row answer-id=&quot;1&quot; question-id=&quot;257&quot;
&lt;body&gt;1&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;2&quot; question-id=&quot;257&quot;
&lt;body&gt;2&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;1&quot; question-id=&quot;258&quot;
&lt;body&gt;1&lt;/body&gt;
&lt;/row&gt;
&lt;row answer-id=&quot;2&quot; question-id=&quot;258&quot;
&lt;body&gt;2&lt;/body&gt;
&lt;/row&gt;
&lt;/quiz-definition-answers&gt;
82
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
correct=&quot;0&quot;&gt;
correct=&quot;1&quot;&gt;
correct=&quot;1&quot;&gt;
correct=&quot;0&quot;&gt;
quiz-definition-questions
Description
Balise conteneur ; contient une ou plusieurs balises row, chacune de ces balises comporte la
r&eacute;ponse &agrave; une question.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-quiz-definition-questions
Exemple
&lt;quiz-definition-questions&gt;
&lt;row question-number=&quot;1&quot; question-id=&quot;257&quot; score=&quot;20&quot; chapter-id=&quot;1&quot;&gt;
&lt;body&gt;Combien font 2+2 ?&lt;/body&gt;
&lt;date-modified&gt;2004-01-13T17:09:40.230-08:00&lt;/date-modified&gt;
&lt;/row&gt;
&lt;row question-number=&quot;2&quot; question-id=&quot;258&quot; score=&quot;20&quot; chapter-id=&quot;1&quot;&gt;
&lt;body&gt;Quelle est la distance de la terre au soleil ?&lt;/body&gt;
&lt;date-modified&gt;2004-01-13T17:09:40.230-08:00&lt;/date-modified&gt;
&lt;/row&gt;
&lt;/quiz-definition-questions&gt;
report-active-meeting-presenters
Description
Balise conteneur ; contient la liste des utilisateurs qui sont en train de pr&eacute;senter des r&eacute;unions.
Attributs
Aucun.
Balises contenues
sco
Renvoy&eacute;es par
report-active-meeting-presenters
Exemple
&lt;report-active-meeting-presenters&gt;
&lt;sco sco-id=&quot;190298&quot;&gt;
&lt;name&gt;Jaques Lemouet&lt;/name&gt;
&lt;date-created&gt;2004-02-17T17:06:23.920-08:00&lt;/date-created&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;566058&quot;&gt;
&lt;name&gt;Jean Galin&lt;/name&gt;
&lt;date-created&gt;2004-02-17T16:50:00.327-08:00&lt;/date-created&gt;
&lt;/sco&gt;
&lt;/report-active-meeting-presenters&gt;
report-active-meeting-presenters
83
report-active-meetings
Description
Balise conteneur ; contient la liste des r&eacute;unions en cours.
Attributs
Aucun.
Balises contenues
sco
Renvoy&eacute;es par
report-active-meetings
Exemple
&lt;report-active-meetings&gt;
&lt;sco sco-id=&quot;196311&quot; active-participants=&quot;1&quot; length-minutes=&quot;241656&quot;&gt;
&lt;name&gt;QT load&lt;/name&gt;
&lt;date-begin&gt;2003-09-02T21:41:58.330-07:00&lt;/date-begin&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;184847&quot; active-participants=&quot;5&quot; length-minutes=&quot;292290&quot;&gt;
&lt;name&gt;Prise 2&lt;/name&gt;
&lt;date-begin&gt;2003-07-29T17:48:25.273-07:00&lt;/date-begin&gt;
&lt;/sco&gt;
&lt;/report-active-meetings&gt;
report-bandwidth
Description
Indique la bande passante totale utilis&eacute;e par le compte actif depuis sa cr&eacute;ation, en octets.
Attributs
total
Le montant total de la bande passante, en octets.
Balises contenues
Aucune. (Balise vide.)
Renvoy&eacute;es par
report-bandwidth
Exemple
&lt;report-bandwidth total=&quot;71000000&quot; /&gt;
84
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
report-disk-usage
Description
Indique l'espace disque occup&eacute; par le contenu Breeze, en octets. Tout le contenu et les archives
sont inclus.
Attributs
total
La quantit&eacute; totale d'espace disque utilis&eacute;, en octets.
Balises contenues
Aucun. (Balise vide.)
Renvoy&eacute;es par
report-disk-usage
Exemple
&lt;report-disk-usage total=&quot;849327881&quot; /&gt;
report-meeting-attendance
Description
Balise conteneur ; contient une ou plusieurs balises row, chacune de ces balises comporte des
informations sur l'un des utilisateurs qui a particip&eacute; &agrave; une r&eacute;union.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-meeting-attendance
Exemple
&lt;report-meeting-attendance&gt;
&lt;row transcript-id=&quot;462409&quot; sco-id=&quot;505267&quot; principal-id=&quot;181255&quot;
answered-survey=&quot;0&quot;&gt;
&lt;login&gt;durand@exemple.com&lt;/login&gt;
&lt;sco-name&gt;Ma r&eacute;union&lt;/sco-name&gt;
&lt;date-created&gt;2004-01-29T00:59:15.490-08:00&lt;/date-created&gt;
&lt;date-closed&gt;2004-01-29T00:59:41.470-08:00&lt;/date-closed&gt;
&lt;participant-name&gt;Durand, Pat&lt;/participant-name&gt;
&lt;/row&gt;
&lt;/report-meeting-attendance&gt;
report-meeting-attendance
85
report-meeting-concurrent-users
Description
Indique le nombre maximum d'utilisateurs qui peuvent participer simultan&eacute;ment &agrave; la r&eacute;union
sp&eacute;cifi&eacute;e.
Attributs
max-participants-freq
Le nombre de fois o&ugrave; le nombre maximum d'utilisateurs a &eacute;t&eacute; atteint
au cours du mois.
max-users
Le nombre maximum d'utilisateurs.
Balises contenues
Aucune. (Balise vide.)
Renvoy&eacute;es par
report-meeting-concurrent-users
Exemple
&lt;report-meeting-concurrent-users max-users=&quot;426&quot; max-participants-freq=&quot;1&quot; /&gt;
report-meeting-session
Description
Contient des informations sur une r&eacute;union.
Attributs
Le nombre de participants qui se sont connect&eacute;s en tant qu'observateurs et non pas
en tant que participants inscrits.
num-guests
num-participants
sco-id
Le nombre total de participants &agrave; la r&eacute;union.
L'identifiant de la r&eacute;union.
session-sco-id
Un identifiant unique de session.
Balises contenues
date-begin, date-end, name
Renvoy&eacute;es par
report-meeting-session
Exemple
&lt;report-meeting-session session-sco-id=&quot;505267&quot; sco-id=&quot;181576&quot;
num-participants=&quot;0&quot; num-guests=&quot;0&quot;&gt;
&lt;name&gt;MaR&eacute;union&lt;/name&gt;
&lt;date-begin&gt;2004-01-29T00:30:00.000-08:00&lt;/date-begin&gt;
&lt;date-end&gt;2004-01-29T00:30:00.000-08:00&lt;/date-end&gt;
&lt;/report-meeting-session&gt;
86
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
report-meeting-sessions
Description
Balise conteneur ; contient des informations sur l'ensemble des &laquo; sessions &raquo; d'une r&eacute;union. Pour
plus d’informations, consultez l'action report-meeting-sessions.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-meeting-sessions
Exemple
&lt;report-meeting-sessions&gt;
&lt;row sco-id=&quot;622852&quot; num-participants=&quot;1&quot; num-guests=&quot;0&quot; num-polls=&quot;0&quot;&gt;
&lt;name&gt;Ma r&eacute;union&lt;/name&gt;
&lt;date-begin&gt;2004-03-05T10:33:09.030-08:00&lt;/date-begin&gt;
&lt;/row&gt;
&lt;/report-meeting-sessions&gt;
report-meeting-session-slots
Description
Balise conteneur ; contient une ou plusieurs balises row, chacune de ces balises comporte des
informations sur une session donn&eacute;e. Pour plus d’informations, consultez l'action reportmeeting-session-slots.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-meeting-session-slots
Exemple
&lt;report-meeting-session-slots&gt;
&lt;row num-attendees=&quot;0&quot;&gt;
&lt;time-slot-begin&gt;2004-02-14T06:30:00.000-08:00&lt;/time-slot-begin&gt;
&lt;time-slot-end&gt;2004-02-14T06:40:00.000-08:00&lt;/time-slot-end&gt;
&lt;/row&gt;
&lt;row num-attendees=&quot;0&quot;&gt;
&lt;time-slot-begin&gt;2004-02-14T06:40:00.000-08:00&lt;/time-slot-begin&gt;
&lt;time-slot-end&gt;2004-02-14T06:50:00.000-08:00&lt;/time-slot-end&gt;
&lt;/row&gt;
&lt;/report-meeting-session-slots&gt;
report-meeting-session-slots
87
report-meeting-summary
Description
Indique le nombre d’utilisateurs invit&eacute;s &agrave; la r&eacute;union sp&eacute;cifi&eacute;e et le nombre d’invit&eacute;s et d’h&ocirc;tes qui
y ont r&eacute;ellement assist&eacute;.
Attributs
num-guests-attended Le nombre de participants qui se sont connect&eacute;s en tant
qu'observateurs et non pas en tant que participants inscrits.
num-invitees
Le nombre d'utilisateurs qui ont &eacute;t&eacute; invit&eacute;s.
num-invitees-attended
Le nombre d'utilisateurs invit&eacute;s qui ont particip&eacute;.
Balises contenues
Aucun. (Balise vide.)
Renvoy&eacute;es par
report-meeting-summary
Exemple
&lt;report-meeting-summary num-invitees=&quot;10&quot; num-invitees-attended=&quot;5&quot;
num-guests-attended=&quot;1&quot; /&gt;
report-quiz-answer-distribution
Description
Balise conteneur ; contient une ou plusieurs balises row qui indiquent le nombre d'utilisateurs
ayant choisi de r&eacute;pondre &agrave; la question sp&eacute;cifi&eacute;e.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-quiz-answer-distribution
Exemple
&lt;report-quiz-answer-distribution&gt;
&lt;row question-number=&quot;1&quot; question-id=&quot;257&quot;
total=&quot;8&quot;&gt;
&lt;body&gt;Combien font 2+2 ?&lt;/body&gt;
&lt;/row&gt;
&lt;row question-number=&quot;2&quot; question-id=&quot;258&quot;
total=&quot;8&quot;&gt;
&lt;body&gt;Quelle est la distance de la terre
&lt;/row&gt;
&lt;row question-number=&quot;3&quot; question-id=&quot;259&quot;
total=&quot;8&quot;&gt;
88
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
a1=&quot;0&quot; a2=&quot;0&quot; a3=&quot;5&quot; a4=&quot;3&quot;
a1=&quot;8&quot; a2=&quot;0&quot; a3=&quot;0&quot; a4=&quot;0&quot;
au soleil ?&lt;/body&gt;
a1=&quot;8&quot; a2=&quot;0&quot; a3=&quot;0&quot; a4=&quot;0&quot;
&lt;body&gt;Quelle norme internationale d&eacute;finit le langage ECMAScript ?&lt;/
body&gt;
&lt;/row&gt;
&lt;/report-quiz-answer-distribution&gt;
report-quiz-interactions
Description
Balise conteneur ; contient une ou plusieurs balises row, chacune de ces balises comporte des
informations sur l'interaction entre un utilisateur et le questionnaire sp&eacute;cifi&eacute;. Pour plus
d’informations sur les interactions, voir l'action report-quiz-interactions.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-quiz-interactions
Exemple
&lt;report-quiz-interactions&gt;
&lt;row transcript-id=&quot;459350&quot; question-id=&quot;257&quot; sco-id=&quot;217706&quot; score=&quot;20&quot;&gt;
&lt;date-created&gt;2004-01-13T02:00:46.163-08:00&lt;/date-created&gt;
&lt;question&gt;Combien font 2+2 ?&lt;/question&gt;
&lt;/row&gt;
&lt;row transcript-id=&quot;459350&quot; question-id=&quot;258&quot; sco-id=&quot;217706&quot; score=&quot;0&quot;&gt;
&lt;date-created&gt;2004-01-13T02:00:46.163-08:00&lt;/date-created&gt;
&lt;question&gt;Quelle est la distance de la terre au soleil ?&lt;/question&gt;
&lt;/row&gt;
&lt;row transcript-id=&quot;459350&quot; question-id=&quot;259&quot; sco-id=&quot;217706&quot; score=&quot;20&quot;&gt;
&lt;date-created&gt;2004-01-13T02:00:46.163-08:00&lt;/date-created&gt;
&lt;question&gt;Quelle norme internationale d&eacute;finit le langage ECMAScript ?&lt;/
question&gt;
&lt;/row&gt;
&lt;/report-quiz-interactions&gt;
report-quiz-question-answer-distribution
Description
Balise conteneur ; contient une ou plusieurs balises row qui indiquent le nombre d'utilisateurs
ayant choisi telle r&eacute;ponse &agrave; la question sp&eacute;cifi&eacute;e.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-quiz-question-answer-distribution
report-quiz-question-answer-distribution
89
Exemple
&lt;report-quiz-question-answer-distribution&gt;
&lt;row question-id=&quot;259&quot; answer-id=&quot;1&quot; correct=&quot;0&quot; total-responses=&quot;1&quot;
percentage-responded=&quot;10&quot;&gt;
&lt;question-text&gt;Quelle norme internationale d&eacute;finit le langage
ECMAScript ?&lt;/question-text&gt;
&lt;answer-text&gt;ISO-9000&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row question-id=&quot;259&quot; answer-id=&quot;2&quot; correct=&quot;0&quot; total-responses=&quot;3&quot;
percentage-responded=&quot;30&quot;&gt;
&lt;question-text&gt;Quelle norme internationale d&eacute;finit le langage
ECMAScript ?&lt;/question-text&gt;
&lt;answer-text&gt;RFC 821&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row question-id=&quot;259&quot; answer-id=&quot;3&quot; correct=&quot;0&quot; total-responses=&quot;2&quot;
percentage-responded=&quot;20&quot;&gt;
&lt;question-text&gt;Quelle norme internationale d&eacute;finit le langage
ECMAScript ?&lt;/question-text&gt;
&lt;answer-text&gt;ECMA-976&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row question-id=&quot;259&quot; answer-id=&quot;4&quot; correct=&quot;1&quot; total-responses=&quot;4&quot;
percentage-responded=&quot;40&quot;&gt;
&lt;question-text&gt;Quelle norme internationale d&eacute;finit le langage
ECMAScript ?&lt;/question-text&gt;
&lt;answer-text&gt;ECMA-262&lt;/answer-text&gt;
&lt;/row&gt;
&lt;/report-quiz-question-answer-distribution&gt;
report-quiz-question-distribution
Description
Balise conteneur ; contient une ou plusieurs balises row qui indiquent le nombre d'utilisateurs
ayant r&eacute;pondu correctement &agrave; la question sp&eacute;cifi&eacute;e.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-quiz-question-distribution
Exemple
&lt;report-quiz-question-distribution&gt;
&lt;row question-id=&quot;257&quot; question-number=&quot;1&quot;
percentage-correct=&quot;100&quot; score=&quot;20&quot;&gt;
&lt;body&gt;Combien font 2+2 ?&lt;/body&gt;
&lt;/row&gt;
&lt;row question-id=&quot;258&quot; question-number=&quot;2&quot;
percentage-correct=&quot;100&quot; score=&quot;20&quot;&gt;
&lt;body&gt;Quelle est la distance de la terre
&lt;/row&gt;
&lt;row question-id=&quot;259&quot; question-number=&quot;3&quot;
percentage-correct=&quot;40&quot; score=&quot;20&quot;&gt;
90
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
num-correct=&quot;8&quot; num-incorrect=&quot;0&quot;
num-correct=&quot;8&quot; num-incorrect=&quot;0&quot;
au soleil ?&lt;/body&gt;
num-correct=&quot;4&quot; num-incorrect=&quot;6&quot;
&lt;body&gt;Quelle norme internationale d&eacute;finit le langage ECMAScript ?&lt;/
body&gt;
&lt;/row&gt;
&lt;/report-quiz-question-distribution&gt;
report-quiz-question-response
Description
Balise conteneur ; contient une ou plusieurs balises row qui d&eacute;crivent la r&eacute;ponse apport&eacute;e &agrave; la
question sp&eacute;cifi&eacute;e.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-quiz-question-response
Exemple
&lt;report-quiz-question-response&gt;
&lt;row principal-id=&quot;506299&quot; question-id=&quot;257&quot; answer-id=&quot;2&quot;&gt;
&lt;body&gt;Combien font 2+2 ?&lt;/body&gt;
&lt;answer-text&gt;5&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row principal-id=&quot;557527&quot; question-id=&quot;257&quot; answer-id=&quot;2&quot;&gt;
&lt;body&gt;Combien font 2+2 ?&lt;/body&gt;
&lt;answer-text&gt;5&lt;/answer-text&gt;
&lt;/row&gt;
&lt;row principal-id=&quot;181255&quot; question-id=&quot;257&quot; answer-id=&quot;3&quot;&gt;
&lt;body&gt;Combien font 2+2 ?&lt;/body&gt;
&lt;answer-text&gt;4&lt;/answer-text&gt;
&lt;/row&gt;
&lt;/report-quiz-question-response&gt;
report-quiz-question-totals
Description
Indique le nombre total d’utilisateurs qui ont r&eacute;pondu &agrave; la question sp&eacute;cifi&eacute;e et le nombre
d’utilisateurs qui y ont r&eacute;pondu correctement.
Attributs
num-correct-answers
question-id
Le nombre d'utilisateurs qui ont r&eacute;pondu correctement &agrave; la question.
L'identifiant de la question.
total-responses
Le nombre total d'utilisateurs qui ont r&eacute;pondu &agrave; la question.
Balises contenues
Aucune. (Balise vide.)
report-quiz-question-totals
91
Renvoy&eacute;es par
report-quiz-question-totals
Exemple
&lt;report-quiz-question-totals question-id=&quot;260&quot; total-responses=&quot;8&quot;
num-correct-answers=&quot;5&quot; /&gt;
report-quiz-results
Description
Contient des informations sur le nombre d'utilisateurs qui ont particip&eacute; au questionnaire et la
plage de r&eacute;sultats correspondante.
Attributs
average-score
La moyenne des r&eacute;sultats des utilisateurs qui ont r&eacute;pondu au questionnaire.
Le r&eacute;sultat le plus &eacute;lev&eacute;.
high-score
Le r&eacute;sultat le plus faible.
low-score
numdistincttaken
numtaken
Le nombre d'individus qui ont r&eacute;pondu au questionnaire.
Le nombre d'utilisations du questionnaire.
Balises contenues
Aucun. (Balise vide.)
Renvoy&eacute;es par
report-quiz-summary
Exemple
&lt;report-quiz-results average-score=&quot;95&quot; low-score=&quot;90&quot; high-score=&quot;100&quot;
numtaken=&quot;8&quot; numdistincttaken=&quot;1&quot; /&gt;
report-quiz-summary
Description
Contient des informations sur un questionnaire.
Attributs
maxpossiblescore
Le meilleur r&eacute;sultat possible.
numquestions
Le nombre de questions du questionnaire.
passingscore
R&eacute;sultat minimum consid&eacute;r&eacute; comme acceptable. D&eacute;fini par le cr&eacute;ateur du
questionnaire.
sco-id
L'identifiant du questionnaire.
Balises contenues
Aucun. (Balise vide.)
92
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
Renvoy&eacute;es par
report-quiz-summary
Exemple
&lt;report-quiz-summary sco-id=&quot;217706&quot; numquestions=&quot;5&quot; maxpossiblescore=&quot;100&quot;
passingscore=&quot;0&quot; /&gt;
report-quiz-takers
Description
Balise conteneur ; contient une ou plusieurs balises row, chacune de ces balises comporte des
informations sur l'un des utilisateurs qui a particip&eacute; au cours ou &agrave; la r&eacute;union sp&eacute;cifi&eacute;e.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-course-takers, report-quiz-takers
Exemple
&lt;report-quiz-takers&gt;
&lt;row transcript-id=&quot;586821&quot; sco-id=&quot;586760&quot; principal-id=&quot;506385&quot;
status=&quot;not-attempted&quot; score=&quot;0&quot; percentage-score=&quot;0&quot; time-taken=&quot;&quot;
certificate=&quot;&quot;&gt;
&lt;name&gt;Contr&ocirc;le de math&eacute;matiques&lt;/name&gt;
&lt;login&gt;benedicte@exemple.com&lt;/login&gt;
&lt;date-taken&gt;2004-02-27T10:53:05.013-08:00&lt;/date-taken&gt;
&lt;principal-name&gt;Benedicte, Fred&lt;/principal-name&gt;
&lt;/row&gt;
&lt;row transcript-id=&quot;586837&quot; sco-id=&quot;586760&quot; principal-id=&quot;557527&quot;
status=&quot;user-failed&quot; score=&quot;10&quot; percentage-score=&quot;25&quot;
time-taken=&quot;51796&quot; certificate=&quot;&quot;&gt;
&lt;name&gt;Contr&ocirc;le de math&eacute;matiques&lt;/name&gt;
&lt;login&gt;benedicte2@exemple.com&lt;/login&gt;
&lt;date-taken&gt;2004-02-27T10:58:36.373-08:00&lt;/date-taken&gt;
&lt;principal-name&gt;Benedicte, Georges&lt;/principal-name&gt;
&lt;/row&gt;
&lt;/report-quiz-takers&gt;
report-quiz-takers
93
report-sco-slides
Description
Balise conteneur ; contient une ou plusieurs balises row qui indiquent la fr&eacute;quence d'affichage de
l'une des diapositives de la pr&eacute;sentation, ainsi que la date et l'heure de la derni&egrave;re consultation.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-sco-slides
Exemple
&lt;report-sco-slides&gt;
&lt;row slide=&quot;1&quot; views=&quot;5&quot;&gt;
&lt;last-viewed&gt;2004-01-13T16:35:39.517-08:00&lt;/last-viewed&gt;
&lt;/row&gt;
&lt;row slide=&quot;2&quot; views=&quot;8&quot;&gt;
&lt;last-viewed&gt;2004-01-13T16:35:42.350-08:00&lt;/last-viewed&gt;
&lt;/row&gt;
&lt;row slide=&quot;3&quot; views=&quot;7&quot;&gt;
&lt;last-viewed&gt;2004-01-13T16:35:44.933-08:00&lt;/last-viewed&gt;
&lt;/row&gt;
&lt;/report-sco-slides&gt;
report-sco-views
Description
Balise conteneur ; contient une ou plusieurs balises row qui indiquent la fr&eacute;quence d'affichage de
la pr&eacute;sentation sp&eacute;cifi&eacute;e, ainsi que la date et l'heure de la derni&egrave;re consultation.
Attributs
Aucun.
Balises contenues
row
Renvoy&eacute;es par
report-sco-views
Exemple
&lt;report-sco-views&gt;
&lt;row sco-id=&quot;217706&quot; type=&quot;presentation&quot; is-folder=&quot;0&quot; views=&quot;24&quot;&gt;
&lt;name&gt;Test 1&lt;/name&gt;
&lt;last-viewed-date&gt;2004-01-13T17:11:47.923-08:00&lt;/last-viewed-date&gt;
&lt;/row&gt;
&lt;/report-sco-views&gt;
94
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
report-training-concurrent-users
Description
Indique le plus grand nombre d’utilisateurs ayant utilis&eacute; le syst&egrave;me en m&ecirc;me temps.
Attributs
account-id
L'identifiant du compte courant.
Le nombre maximum d'utilisateurs pouvant acc&eacute;der au syst&egrave;me en m&ecirc;me temps,
conform&eacute;ment aux sp&eacute;cifications de la licence de votre compte.
limit
max-num-sessions
Le plus grand nombre de sessions ayant &eacute;t&eacute; ouvertes simultan&eacute;ment.
Balises contenues
name
Renvoy&eacute;es par
report-training-concurrent-users
Exemple
&lt;report-training-concurrent-users account-id=&quot;181224&quot; max-num-sessions=&quot;2&quot;
limit=&quot;1000000000&quot;&gt;
&lt;name&gt;Compte de test du professeur&lt;/name&gt;
&lt;/report-training-concurrent-users&gt;
r&eacute;sultats
Description
Balise conteneur ; tous les r&eacute;sultats renvoy&eacute;s par une action sont contenus dans une balise
results.
Attributs
Aucun.
Balises contenues
Tout type.
Renvoy&eacute;es par
Toutes les actions.
Exemple
&lt;r&eacute;sultats&gt;
&lt;status code=&quot;ok&quot; /&gt;
&lt;/results&gt;
r&eacute;sultats
95
row
Description
Contient un enregistrement unique d'informations dans un rapport.
Pour obtenir des exemples d'attributs acceptables et de balises contenues, consultez les exemples
de r&eacute;sultats fournis dans la documentation pour l'action que vous appelez.
Attributs
Les attributs de la balise row varient consid&eacute;rablement en fonction de l'action repr&eacute;sent&eacute;e par
cette balise.
Balises contenues
Les balises contenues dans la balise row varient consid&eacute;rablement en fonction de l'action
repr&eacute;sent&eacute;e par cette balise.
Renvoy&eacute;es par
report-course-takers, report-meeting-attendance, report-meeting-sessions,
report-meeting-session-slots, report-quiz-answer-distribution,
report-quiz-definition-answers, report-quiz-definition-questions,
report-quiz-interactions, report-quiz-question-answer-distribution,
report-quiz-question-distribution, report-quiz-question-response,
report-quiz-takers, report-sco-slides, report-sco-views
Exemple
&lt;row sco-id=&quot;622852&quot; num-participants=&quot;1&quot; num-guests=&quot;0&quot; num-polls=&quot;0&quot;&gt;
&lt;name&gt;Ma r&eacute;union&lt;/name&gt;
&lt;date-begin&gt;2004-03-05T10:33:09.030-08:00&lt;/date-begin&gt;
&lt;/row&gt;
sco
Description
Contient des informations sur une entit&eacute; SCO, ce qui correspond &agrave; un document Breeze unique.
Pour obtenir des exemples d'attributs acceptables et de balises contenues, consultez les exemples
de r&eacute;sultats fournis dans la documentation.
Attributs
Les attributs de la balise sco varient consid&eacute;rablement en fonction de l'action repr&eacute;sent&eacute;e par
cette balise.
Balises contenues
Les balises contenues dans la balise sco varient consid&eacute;rablement en fonction de l'action
repr&eacute;sent&eacute;e par cette balise.
Renvoy&eacute;es par
report-active-meeting-presenters, report-active-meetings, sco-contents, sco-info,
sco-nav, sco-search, sco-shortcuts
96
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
Exemple
&lt;sco author-contact-id=&quot;185&quot; folder-id=&quot;71&quot; host-id=&quot;&quot; learning-time=&quot;-1&quot;
sco-data-id=&quot;173&quot; sco-id=&quot;235&quot; source-sco-id=&quot;&quot; status=&quot;active&quot;
tree-id=&quot;25&quot; type=&quot;session&quot;&gt;
&lt;date-begin&gt;2003-06-30T19:33:38.317+00:00&lt;/date-begin&gt;
&lt;date-created&gt;2003-06-30T19:33:38.317+00:00&lt;/date-created&gt;
&lt;date-end&gt;2003-07-10T13:05:42.180+00:00&lt;/date-end&gt;
&lt;date-modified&gt;2003-06-30T19:33:38.317+00:00&lt;/date-modified&gt;
&lt;name&gt;another - 06/30/2003 12:33 PM&lt;/name&gt;
&lt;url-path&gt;/p62559548/&lt;/url-path&gt;
&lt;/sco&gt;
sco-author
Description
Fournit des informations sur l'auteur d'une entit&eacute; SCO.
Attributs
Aucun.
Balises contenues
email, first-name, last-name
Renvoy&eacute;es par
sco-info
Exemple
&lt;sco-author&gt;
&lt;email&gt;durand@exemple.com&lt;/email&gt;
&lt;first-name&gt;Paul&lt;/first-name&gt;
&lt;last-name&gt;Martin&lt;/last-name&gt;
&lt;/sco-author&gt;
sco-data
Description
Contient des informations sur le fichier de donn&eacute;es sous-jacent (tel que le fichier contenant une
pr&eacute;sentation) utilis&eacute; dans une entit&eacute; SCO.
Attributs
byte-count
La taille du fichier de l'entit&eacute; SCO, en octets.
height
La hauteur de l'entit&eacute; SCO, en pixels.
length
La dur&eacute;e d'une pr&eacute;sentation, en millisecondes.
sco-data-id
L'identifiant du fichier de donn&eacute;es de l'entit&eacute; SCO.
slide-count Le nombre de diapositives dans l'entit&eacute; SCO. Une valeur de -1 indique que le
d&eacute;compte de diapositives ne s'applique pas ; par exemple, si l'entit&eacute; SCO est une r&eacute;union et non
pas une pr&eacute;sentation, le nombre de diapositives s'affiche sous la forme -1.
version
width
Le num&eacute;ro de version de l'entit&eacute; SCO.
La largeur de l'entit&eacute; SCO, en pixels.
sco-data
97
Balises contenues
date-created, date-modified, physical-path
Renvoy&eacute;es par
sco-info
Exemple
&lt;sco-data byte-count=&quot;3993&quot; height=&quot;252&quot; length=&quot;-1&quot; sco-data-id=&quot;95654&quot;
slide-count=&quot;-1&quot; version=&quot;1&quot; width=&quot;380&quot;&gt;
&lt;date-created&gt;2004-01-26T20:47:05.653-07:00&lt;/date-created&gt;
&lt;date-modified&gt;2004-01-26T20:47:05.653-07:00&lt;/date-modified&gt;
&lt;physical-path&gt;222914/503227/&lt;/physical-path&gt;
&lt;/sco-data&gt;
sco-name
Description
Le nom d'une entit&eacute; SCO donn&eacute;e, sous une forme compr&eacute;hensible par l'utilisateur, tel que le
nom d'une r&eacute;union.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-meeting-attendance
Exemple
&lt;sco-name&gt;Ma r&eacute;union&lt;/sco-name&gt;
sco-nav
Description
Contient des informations sur la hi&eacute;rarchie de dossiers renfermant l'entit&eacute; SCO sp&eacute;cifi&eacute;e.
Attributs
Aucun.
Balises contenues
sco
Renvoy&eacute;es par
sco-nav
98
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
Exemple
&lt;sco-nav&gt;
&lt;sco sco-id=&quot;181230&quot; tree-id=&quot;181230&quot; type=&quot;folder&quot; depth=&quot;2&quot;&gt;
&lt;name&gt;Ma r&eacute;union&lt;/name&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;181576&quot; tree-id=&quot;181230&quot; type=&quot;folder&quot; depth=&quot;1&quot;&gt;
&lt;name&gt;durand@exemple.com&lt;/name&gt;
&lt;/sco&gt;
&lt;/sco-nav&gt;
sco-search-info
Description
Balise conteneur ; contient une ou plusieurs balises sco, chacune de ces balises comporte des
informations sur une entit&eacute; SCO correspondant au texte de recherche sp&eacute;cifi&eacute;.
Attributs
Aucun.
Balises contenues
sco
Renvoy&eacute;es par
sco-search
Exemple
&lt;sco-search-info&gt;
&lt;sco sco-id=&quot;202014&quot; folder-id=&quot;202008&quot; type=&quot;presentation&quot; slide-count=&quot;4&quot;
length=&quot;20000&quot;&gt;
&lt;name&gt;Questionnaire 1&lt;/name&gt;
&lt;url-path&gt;/p92628681/&lt;/url-path&gt;
&lt;date-created&gt;2003-11-26T22:52:28.973-08:00&lt;/date-created&gt;
&lt;date-modified&gt;2003-11-26T22:52:37.867-08:00&lt;/date-modified&gt;
&lt;first-name&gt;Paul&lt;/first-name&gt;
&lt;last-name&gt;Martin&lt;/last-name&gt;
&lt;hit&gt;1&lt;/hit&gt;
&lt;hit&gt;4&lt;/hit&gt;
&lt;/sco&gt;
&lt;/sco-search-info&gt;
scos
Description
Balise conteneur ; contient une ou plusieurs balises sco, chacune de ces balises comporte des
informations sur une entit&eacute; SCO &agrave; l'int&eacute;rieur du dossier sp&eacute;cifi&eacute;.
Attributs
Aucun.
Balises contenues
sco
scos
99
Renvoy&eacute;es par
sco-contents
Exemple
&lt;scos&gt;
&lt;sco sco-id=&quot;505677&quot; status=&quot;no-content&quot; type=&quot;folder&quot; is-folder=&quot;1&quot;&gt;
&lt;name&gt;Mes tests de r&eacute;union PPT&lt;/name&gt;
&lt;date-modified&gt;2004-01-29T06:22:49.157-08:00&lt;/date-modified&gt;
&lt;/sco&gt;
&lt;sco sco-id=&quot;193496&quot; status=&quot;active&quot; type=&quot;meeting&quot; is-folder=&quot;0&quot;&gt;
&lt;name&gt;Mon nom&lt;/name&gt;
&lt;date-begin&gt;2003-08-27T00:00:00.000-07:00&lt;/date-begin&gt;
&lt;date-end&gt;2003-08-27T01:00:00.000-07:00&lt;/date-end&gt;
&lt;date-modified&gt;2003-08-26T23:33:20.300-07:00&lt;/date-modified&gt;
&lt;duration&gt;1900-01-02T/+:00:00.000+00:00&lt;/duration&gt;
&lt;/sco&gt;
&lt;/scos&gt;
shortcuts
Description
Balise conteneur ; contient une ou plusieurs balises sco, chacune de ces balises contient des
informations sur un dossier dont le contenu se rapporte &agrave; l'utilisateur connect&eacute;. Pour plus
d’informations, consultez l'action sco-shortcuts.
Attributs
Aucun.
Balises contenues
sco
Renvoy&eacute;es par
sco-shortcuts
Exemple
&lt;raccourcis&gt;
&lt;sco tree-id=&quot;181230&quot; sco-id=&quot;181576&quot; type=&quot;my-meetings&quot;&gt;
&lt;domain-name&gt;http://admin.breeze.exemple.com&lt;/domain-name&gt;
&lt;/sco&gt;
&lt;sco tree-id=&quot;181227&quot; sco-id=&quot;181412&quot; type=&quot;my-content&quot;&gt;
&lt;domain-name&gt;http://admin.breeze.exemple.com&lt;/domain-name&gt;
&lt;/sco&gt;
...
[Autres balises sco ici.]
...
&lt;sco tree-id=&quot;181230&quot; sco-id=&quot;181230&quot; type=&quot;user-meetings&quot;&gt;
&lt;domain-name&gt;http://admin.breeze.exemple.com&lt;/domain-name&gt;
&lt;/sco&gt;
&lt;/shortcuts&gt;
100
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
source-sco
Description
Balise conteneur ; contient des informations sur le SCO qui se rapportent au contenu d'un cours.
Attributs
Aucun.
Balises contenues
source-sco
Renvoy&eacute;es par
sco-info
Exemple
&lt;source-sco&gt;
&lt;source-sco author-contact-id=&quot;586761&quot; folder-id=&quot;506334&quot; host-id=&quot;&quot;
learning-time=&quot;&quot; sco-data-id=&quot;586762&quot; sco-id=&quot;586760&quot; source-sco-id=&quot;&quot;
status=&quot;active&quot; tree-id=&quot;181225&quot; type=&quot;presentation&quot;&gt;
&lt;date-created&gt;2004-02-27T10:31:06.717-08:00&lt;/date-created&gt;
&lt;date-modified&gt;2004-02-27T10:52:58.217-08:00&lt;/date-modified&gt;
&lt;description&gt;Pr&eacute;sentation de test simple&lt;/description&gt;
&lt;name&gt;Contr&ocirc;le de math&eacute;matiques&lt;/name&gt;
&lt;url-path&gt;/p60802018/&lt;/url-path&gt;
&lt;/source-sco&gt;
&lt;/source-sco&gt;
status
Description
Lorsque Breeze renvoie des donn&eacute;es XML, il inclut une balise status. Cette section regroupe des
informations sur tous les codes et les sous-codes d'&eacute;tat que Breeze peut renvoyer.
Attributs
code
L'&eacute;tat de l'action. Vous trouverez ci-dessous les valeurs possibles de cet attribut :
Indique qu'un appel n'est pas valide, sans plus de pr&eacute;cisions. Si l'attribut code
est d&eacute;fini sur &quot;invalid&quot;, la balise status contient une balise invalid qui comporte plus
de d&eacute;tails sur l'origine du probl&egrave;me.
no-access Indique que vous ne disposez pas des autorisations n&eacute;cessaires pour ex&eacute;cuter
l'action. Ce probl&egrave;me peut survenir sous diff&eacute;rentes situations ; la valeur de l'attribut
subcode fournit plus de d&eacute;tails. Pour plus de d&eacute;tails sur les valeurs possibles de l'attribut
subcode, consultez la section suivante. Si vous fournissez une cl&eacute; d'acc&egrave;s non valide, aucune
valeur n'est renvoy&eacute;e par subcode.
no-data Indique qu'aucune donn&eacute;e n'est disponible (en r&eacute;ponse &agrave; une action devant
normalement renvoyer des donn&eacute;es). Indique g&eacute;n&eacute;ralement qu'aucun &eacute;l&eacute;ment ne dispose de
l'identifiant sp&eacute;cifi&eacute;. Pour r&eacute;soudre cette erreur, modifiez l'identifiant sp&eacute;cifi&eacute; de fa&ccedil;on &agrave; ce
qu'il corresponde &agrave; un &eacute;l&eacute;ment existant.
ok Indique que l'action s'est termin&eacute;e avec succ&egrave;s.
invalid
status
101
Indique que l'action aurait d&ucirc; renvoyer un r&eacute;sultat unique, mais a
renvoy&eacute; des r&eacute;sultats multiples. Par exemple, si plusieurs utilisateurs portent le m&ecirc;me nom et
utilisent le m&ecirc;me mot de passe, et si vous appelez l'action login qui utilise ce nom et ce mot
de passe en tant que param&egrave;tres, le syst&egrave;me ne peut pas d&eacute;terminer votre identit&eacute; lors de la
connexion et renvoie l'erreur &quot;too-much-data&quot;.
too-much-data
Parfois utilis&eacute; pour donner plus de d&eacute;tails sur l'&eacute;tat de l'action. Par exemple, les valeurs
permettent de d&eacute;tecter les situations o&ugrave; code est d&eacute;fini sur no-access. Vous trouverez
ci-dessous les valeurs possibles de cet attribut :
subcode
subcode
Le compte du client a expir&eacute;.
Vos informations de s&eacute;curit&eacute; ne permettent pas d'ex&eacute;cuter l'action.
no-login Vous ne vous &ecirc;tes pas connect&eacute;. Pour r&eacute;soudre cette erreur, connectez-vous
(avec l'action login) avant d'appeler l'action. Pour plus d'informations, consultez l’action
login.
no-quota Les limites du compte ont &eacute;t&eacute; atteintes ou d&eacute;pass&eacute;es.
not-available La ressource sp&eacute;cifi&eacute;e n'est pas disponible.
not-secure Vous devez utiliser SSL pour appeler cette action.
pending-activation Le compte n'a pas encore &eacute;t&eacute; activ&eacute;.
pending-license Le contrat de licence du compte n'a pas encore &eacute;t&eacute; accept&eacute;.
sco-expired Le cours ou le contenu de suivi a expir&eacute;.
sco-not-started La r&eacute;union ou le cours n'a pas encore commenc&eacute;.
account-expired
denied
Balises contenues
invalid
Renvoy&eacute;es par
Toutes les actions.
Exemple
&lt;status code=&quot;ok&quot; /&gt;
time-slot-begin
Description
Contient la date et l'heure de d&eacute;but d'une r&eacute;union.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-meeting-session-slots
Exemple
&lt;time-slot-begin&gt;2004-02-14T06:50:00.000-08:00&lt;/time-slot-begin&gt;
102
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
time-slot-end
Description
Contient la date et l'heure de fin d'une r&eacute;union.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-meeting-session-slots
Exemple
&lt;time-slot-end&gt;2004-02-14T07:00:00.000-08:00&lt;/time-slot-end&gt;
url
Description
Contient une URL.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
common-info, report-my-courses
Exemple
&lt;url&gt;/api/xml?accesskey=yyyyyyyyyyyyyyyy&amp;action=common-info&lt;/url&gt;
url-path
Description
Contient le chemin de l'entit&eacute; SCO sp&eacute;cifi&eacute;e sur le serveur Breeze.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
report-my-courses, report-my-meetings, sco-info, sco-search
url-path
103
Exemple
&lt;url-path&gt;/r99718924/&lt;url-path&gt;
user (common-info)
Description
Contient des informations sur un utilisateur.
Attributs
user-id
Identifiant de l’utilisateur.
Balises contenues
login
Renvoy&eacute;es par
common-info
Exemple
&lt;user user-id=&quot;503562&quot;&gt;
&lt;login&gt;dupont@exemple.com&lt;/login&gt;
&lt;/user&gt;
user (user-accounts)
Description
Contient des informations sur un utilisateur.
Attributs
user-id
Identifiant de l’utilisateur.
account-id
L'identifiant d'un compte.
Balises contenues
date-expired, name
Renvoy&eacute;es par
user-accounts
Exemple
&lt;user user-id=&quot;211729&quot; account-id=&quot;211655&quot;&gt;
&lt;name&gt;jacques@exemple.com&lt;/name&gt;
&lt;date-expired&gt;2004-01-24T00:59:59.000-07:00&lt;/date-expired&gt;
&lt;/user&gt;
104
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
users
Description
Balise conteneur ; contient une ou plusieurs balises user, chacune de ces balises comporte des
informations sur un utilisateur et un compte.
Attributs
Aucun.
Balises contenues
user (user-accounts)
Renvoy&eacute;es par
user-accounts
Exemple
&lt;users&gt;
&lt;user user-id=&quot;211729&quot; account-id=&quot;211655&quot;&gt;
&lt;name&gt;jacques@exemple.com&lt;/name&gt;
&lt;date-expired&gt;2004-01-24T00:59:59.000-07:00&lt;/date-expired&gt;
&lt;/user&gt;
&lt;user user-id=&quot;212988&quot; account-id=&quot;212928&quot;&gt;
&lt;name&gt;lapierre@exemple.com&lt;/name&gt;
&lt;date-expired&gt;2004-01-24T00:59:59.000-07:00&lt;/date-expired&gt;
&lt;/user&gt;
&lt;/users&gt;
version
Description
Contient le num&eacute;ro de version de Breeze.
Attributs
Aucun.
Balises contenues
Aucune. (Contenu uniquement.)
Renvoy&eacute;es par
common-info
Exemple
&lt;version&gt;breeze_402_r116&lt;/version&gt;
version
105
106
Chapitre 4 : R&eacute;f&eacute;rences pour les r&eacute;sultats XML
INDEX
A
acc&egrave;s public, autorisations 18
acc&egrave;s, cl&eacute;s 15
acc&egrave;s, cl&eacute;s sp&eacute;ciales 27, 28
access-key, balise 62
access-keys, balise 63
account, balise 63
ACL 16
acl-id, param&egrave;tres 15
action accesskey-exec 27
action accesskey-info 28
action action-list 29
action common-info 23, 29
action group-membership-update 30
action login 30
action logout 31
action permissions-info 31
action permissions-reset 32
action permissions-update 32
action principal-info 22, 33
action principal-list 20, 34
action principal-update 21, 34
action principals-delete 22, 35
action report-active-meeting-presenters 36
action report-active-meetings 36
action report-bandwidth 37
action report-course-takers 25, 37
action report-disk-usage 38
action report-meeting-attendance 38
action report-meeting-concurrent-users 39
action report-meeting-session 39
action report-meeting-session-slots 40
action report-meeting-sessions 40
action report-meeting-summary 41
action report-my-courses 23, 41
action report-my-meetings 23, 42
action report-quiz-answer-distribution 43
action report-quiz-definition-answers 43
action report-quiz-definition-questions 44
action report-quiz-interactions 45
action report-quiz-question-answer-distribution 46
action report-quiz-question-distribution 47
action report-quiz-question-response 47
action report-quiz-question-totals 48
action report-quiz-summary 49
action report-sco-slides 50
action report-sco-views 50
action report-training-concurrent-users 51
action sco-build 51
action sco-contents 24, 52
action sco-delete 53
action sco-info 24, 53
action sco-move 54
action sco-nav 54
action sco-search 55
action sco-shortcuts 23, 56
action sco-update 57
action sco-upload 58
action user-accounts 59
action user-update-pwd 59
action, balise 64
actions
accesskey-exec 27
accesskey-info 28
action-list 29
appel 13
common-info 23, 29
connexion 19
d&eacute;finition 7
group-membership-update 30
liste 29
login 30
logout 31
mises &agrave; jour des informations 7
107
noms 64
permissions-info 31
permissions-reset 32
permissions-update 32
principal-info 22, 33
principal-list 20, 34
principal-update 21, 34
principals-delete 22, 35
report-active-meeting-presenters 36
report-active-meetings 36
report-bandwidth 37
report-course-takers 25, 37
report-disk-usage 38
report-meeting-attendance 38
report-meeting-concurrent-users 39
report-meeting-session 39
report-meeting-session-slots 40
report-meeting-sessions 40
report-meeting-summary 41
report-my-courses 23, 41
report-my-meetings 23, 42
report-quiz-answer-distribution 43
report-quiz-definition-answers 43
report-quiz-definition-questions 44
report-quiz-interactions 45
report-quiz-question-answer-distribution 46
report-quiz-question-distribution 47
report-quiz-question-response 47
report-quiz-question-totals 48
report-quiz-summary 49
report-quiz-takers 49
report-sco-slides 50
report-sco-views 50
report-training-concurrent-users 51
sco-build 51
sco-contents 24, 52
sco-delete 53
sco-info 24, 53
sco-move 54
sco-nav 54
sco-search 55
sco-shortcuts 23, 56
sco-update 57
sco-upload 58
termin&eacute;es avec succ&egrave;s 20
user-accounts 59
user-update-pwd 59
Voir aussi services Web
actions, balise 64
108
Index
actualisation
appartenance au groupe 30
autorisations 32
informations utilisateur 22
mandants 34
mots de passe 59
SCO 57
admins, groupe primaire 14
adresses &eacute;lectroniques comme nom de connexion 75
affichage
diapositives 50
pr&eacute;sentations 50
affichage en tableau des informations renvoy&eacute;es 24
ajout d’utilisateurs &agrave; Breeze 21
ajout de mandants &agrave; un groupe 30
analyse du code XML renvoy&eacute; 20
answer-text, balise 65
appel d’actions 12, 13, 19
arborescences 14
archiver, r&eacute;union 15
attributs, recherche 21
authors, groupe primaire 14
auto-inscription 27, 28, 62, 63
autorisations
acc&egrave;s public 18
affectation 57
vue d'ensemble 16
permissions
Voir aussi SCO
autorisations, configuration 32
B
balise cfhttp (en CFML) 20
balise d’&eacute;tat 20, 61, 101
balises
access-key 62
access-keys 63
account 63
action 64
actions 64
answer-text 65
autorisations 79
body 65
common 65
cookie 66
course 67
date 67
date-begin 68
date-closed 68
date-created 68
date-end 69
date-expired 69
date-modified 69
date-taken 70
description 70
domain-name 71
duration 71
email 71
expired 72
first-name 72
hit 73
host 73
invalid 73
last-name 74
last-viewed 75
last-viewed-date 75
ligne 25, 96
login 75
meeting 76
my-courses 76
my-meetings 77
name 78
participant-name 78
physical-path 79
principal 80
principal-list 80
principal-name 81
question 82
question-text 81
quiz-definition-answers 82
quiz-definition-questions 83
raccourcis 100
report-active-meeting-presenters 83
report-active-meetings 84
report-bandwidth 84
report-disk-usage 85
report-meeting-attendance 85
report-meeting-concurrent-users 86
report-meeting-session 86
report-meeting-session-slots 87
report-meeting-sessions 87
report-meeting-summary 88
report-quiz-answer-distribution 88
report-quiz-interactions 89
report-quiz-question-answer-distribution 89
report-quiz-question-distribution 90
report-quiz-question-response 91
report-quiz-question-totals 91
report-quiz-results 92
report-quiz-summary 92
report-quiz-takers 93
report-sco-slides 94
report-sco-views 94
report-training-concurrent-users 95
r&eacute;sultats 61, 95
sco 96
sco-author 97
sco-data 97
sco-name 98
sco-nav 98
sco-search-info 99
scos 99
source-sco 101
status 61, 101
time-slot-begin 102
time-slot-end 103
url 103
url-path 103
users 105
utilisateur 104
version 105
vue d'ensemble 61
bande passante, rapport 37
body, balise 65
Breeze
affichage de contenu sp&eacute;cifique 23
documentation 7
int&eacute;gration &agrave; un portail 23
interaction avec le serveur 12
liste de toutes les actions 29
num&eacute;ro de version 105
utilisateurs, actualisation 22
utilisateurs, ajout 21, 27
utilisateurs, suppression 22
C
cas courants d’utilisation 19
CFML
exemples de code 13
utilisation du code XML 8
cha&icirc;nes de requ&ecirc;te, cr&eacute;ation 13
chemin d’acc&egrave;s &agrave; du contenu 24
cl&eacute;s d’acc&egrave;s
Breeze Enterprise 16
clients h&eacute;berg&eacute;s 16
obtention 28
sp&eacute;ciales 27, 28, 62, 63
vue d'ensemble 15
code, exemples 19
code, police 9
Index
109
codes d'&eacute;tat
invalid 73
vue d'ensemble 101
ColdFusion Markup Language. Voir CFML
common, balise 65
compilation de SCO 51, 58
comptes
limites 39
liste 59
comptes h&eacute;berg&eacute;s, cl&eacute;s d'acc&egrave;s pour 16
configuration des cl&eacute;s d'acc&egrave;s 16
connexion 15, 19, 23, 30
contenu
dossier 52
extraction de l’URL 24
lancement 18
recherche 25
sp&eacute;cifique, affichage 23
conventions typographiques 9
cookie, balise 66
cookies Voir JSESSIONID, cookies
cours
lancement 18
liste 23, 25, 41
participants inscrits 37
vue d'ensemble 14
Voir aussi SCO
course, balise 67
course-admins, groupe primaire 14
cr&eacute;ation
cha&icirc;nes de requ&ecirc;te 13
mandants 34
r&eacute;unions 25
SCO 57
utilisateurs 21
utilisateurs administratifs 20
CSV (donn&eacute;es s&eacute;par&eacute;es par des virgules) 25
D
date, balise 67
date-begin, balise 68
date-closed, balise 68
date-created, balise 68
date-end, balise 69
date-expired, balise 69
date-modified, balise 69
date-taken, balise 70
dates et heures 9
d&eacute;connexion 31
110
Index
demande de la liste des utilisateurs de Breeze 20
denied, autorisation 17
d&eacute;pannage 101
d&eacute;placement de SCO 54
description des mandants 33
description, balise 70
diapositives
nombre de diapositives 97
nombre de visionnages 50
documentation et mises &agrave; jour 7
domain-name, balise 71
dossiers
autorisations 17
communs 56
contenu 52
hi&eacute;rarchies 54
liste des contenus 24
my-content (Mon contenu) 24
relatifs &agrave; l’utilisateur actuel 56
vue d'ensemble 14
Voir aussi SCO
dossiers parents 54
duration, balise 71
E
&eacute;l&eacute;ments XML renvoy&eacute;s 27, 61
email, balise 71
erreur, recherche d’ 20
espace disque utilis&eacute; 38
exemples de code
analyse du code XML renvoy&eacute; 20
pr&eacute;sentation 19
utilisation de CFML 13
exemples de t&acirc;ches courantes 19
expired, balise 72
extraction de l’URL 56
F
first-name, balise 72
Flash, fichiers 14
flux de donn&eacute;es 12
flux de travail 12
folder-id, param&egrave;tres 15
format CSV 25
G
g&eacute;n&eacute;ration de rapports 25
gras, convention 9
group-id, param&egrave;tres 15
groupes
autorisations 17
membres, actualisation 30
primaires 14
rejoints lors de l’auto-inscription 28
vue d'ensemble 14
Voir aussi mandants, utilisateurs
groupes primaires
autorisations 16
d&eacute;finition 14
H
heures et dates 9
hi&eacute;rarchies de dossiers 54
hit, balise 73
host, balise 73
HTTP
param&egrave;tres 20
requ&ecirc;tes GET et POST 13
I
ID
utilisateurs, extraction 23
identifiant
account 63
autorisations 16
questions 46, 47, 48
vue d'ensemble 14
identifiants de connexion, obtention 33
identit&eacute;, v&eacute;rification 30
images, fichier 15
informations
affichage 24
sur les mandants 33
sur les SCO 53
sur les serveurs, obtenir 29
informations d'identification, s&eacute;curit&eacute; 15, 30
informations de derni&egrave;re minute 7
inscription d’un utilisateur 27
insertion d’un nouvel utilisateur Breeze 21
int&eacute;gration de Breeze &agrave; un portail 23
interaction avec le serveur Breeze 12
interactions avec les questionnaires 45
interfaces, conversion 11
invalid, balise 73
invit&eacute;s, nombre 41
ISO 8601, format de date 9
italiques, convention 9
J
JSESSIONID, cookies
action login 30
conflits des noms de cookie 18
cookie, balise 66
exemple de code 19
invalidation 31
s&eacute;curit&eacute; 15
vue d'ensemble 15
L
lancement du contenu 18
last-name, balise 74
last-vewed, balise 75
last-viewed-date, balise 75
LDAP 19
licence, cl&eacute;s d'acc&egrave;s 16
liens hypertexte, cr&eacute;ation 24
Lightweight Directory Access Protocol (LDAP) 19
limites des comptes 39
liste
actions 29
comptes 59
contenu des dossiers 24, 52
cours 23, 41
mandants 34
pr&eacute;sentateurs 36
questions 44
r&eacute;unions 23, 36
stagiaires 37
live-admins, groupe primaire 14
login, action 15
login, balise 75
logos 15
M
manage, autorisation 17
mandants
ajout &agrave; un groupe 30
autorisations 16, 31, 32
cr&eacute;ation 34
informations, obtenir 33
liste 34
public-access 18
vue d'ensemble 14
Voir aussi utilisateurs, groupes
manuels 7
meeting, balise 76
mises &agrave; jour de la documentation 7
Index
111
mises &agrave; jour r&eacute;centes de la documentation 7
modification
appartenance au groupe 30
autorisations 32
mandants 34
modules 15
mots de passe
modification 59
v&eacute;rification 23
my-content (Mon contenu), dossier 24
my-courses, balise 76
my-meetings, balise 77
N
name, balise 78
noms d'actions 64
noms de domaine, extraction 24
notes des questionnaires 45
notions de base des services Web 8
nouveaut&eacute;s 7
P
param&egrave;tres
en option 13
ID 15
multiples, sp&eacute;cification 13, 30, 33, 35, 53
session 18
sp&eacute;cification 13
vue d'ensemble 13
param&egrave;tres en option 13
param&egrave;tres requis 13
parent-acl-id, param&egrave;tres 15
participant-name, balise 78
participants &agrave; un cours 37
participation
aux r&eacute;unions 38
maximum 39
participation maximale &agrave; une r&eacute;union 39
p&eacute;riodes de session de r&eacute;union 40
permissions, balise 79
physical-path, balise 79
planning de r&eacute;unions 39, 42
portails, int&eacute;gration de Breeze 23
POST, requ&ecirc;tes (HTTP) 13, 20
pr&eacute;requis 7
pr&eacute;sentateurs
de r&eacute;unions 36
pr&eacute;sentation des services Web 8
112
Index
pr&eacute;sentations
nombre de diapositives 97
nombre de visionnages 50
recherche 25
vue d'ensemble 14
Voir aussi SCO
presenter
autorisations 17
principal, balise 80
principal-id, param&egrave;tres 15
principal-list, balise 80
principal-name, balise 81
publish, autorisation 17
Q
question, balise 82
question-text, balise 81
questionnaires
dates taken 70
interactions 45
liste des r&eacute;ponses 47
nombre d’utilisateurs ayant r&eacute;pondu 48
note, d&eacute;finition 45
questions 44
r&eacute;ponses correctes aux questions 47
r&eacute;ponses correctes et incorrectes 43
r&eacute;ponses, distribution 43, 46
r&eacute;ponses, texte 65
r&eacute;sum&eacute; des r&eacute;sultats 49
utilisateurs ayant r&eacute;pondu 49
Voir aussi SCO
questions
identifiant, extraction 46, 47, 48
liste 44
quiz-definition-answers, balise 82
quiz-definition-questions, balise 83
R
raccourcis 23, 56
rapports
format CSV 25
g&eacute;n&eacute;ration 25
recherche
cours 23
de contenu 25
r&eacute;unions 23
SCO 55
text dans des SCO 55
recherche d’erreurs 20
recompilation de SCO 51
r&eacute;initialisation des autorisations 32
r&eacute;ponses au questionnaire
correctes et incorrectes 43
distribution 43, 46
interactions 45
liste 47
r&eacute;ponses correctes 47
texte 65
report-active-meeting-presenters, balise 83
report-active-meetings, balise 84
report-bandwidth, balise 84
report-disk-usage, balise 85
report-meeting-attendance, balise 85
report-meeting-concurrent-users, balise 86
report-meeting-session, balise 86
report-meeting-session-slots, balise 87
report-meeting-sessions, balise 87
report-meeting-summary, balise 88
report-quiz-answer-distribution, balise 88
report-quiz-interactions, balise 89
report-quiz-question-answer-distribution, balise 89
report-quiz-question-distribution, balise 90
report-quiz-question-response, balise 91
report-quiz-question-totals, balise 91
report-quiz-results, balise 92
report-quiz-summary, balise 92
report-quiz-takers action 49
report-quiz-takers, balise 93
report-sco-slides, balise 94
report-sco-views, balise 94
report-training-concurrent-users, balise 95
requ&ecirc;tes GET et POST (HTTP) 13, 20
ressources
bande passante, rapport 37
rapport sur l’espace disque utilis&eacute; 38
ressources (documentation), suppl&eacute;mentaires 8
ressources en ligne 8
r&eacute;sultats
actions 61
des questionnaires 49
results, balise 61, 95
r&eacute;sum&eacute; des r&eacute;sultats d’un questionnaire 49
retrait
mandants d'un groupe 30
utilisateurs 22
r&eacute;unions
actives 36
archiv&eacute;e 15
autorisations 17
cr&eacute;ation 25
invit&eacute;s, nombre 41
lancement 18
liste 23, 36
planifi&eacute;es 39, 42
pr&eacute;sentateurs 36
sessions 40
vides 40
vue d'ensemble 14
Voir aussi SCO
r&eacute;unions actives
liste 36
pr&eacute;sentateurs 36
r&eacute;unions, participation
liste des utilisateurs 38
maximum 39
nombre de participants 39
participants par p&eacute;riode de 10 minutes 40
r&eacute;sum&eacute; 41
row, balise 25, 96
S
sc&eacute;narios courants 19
SCO
actualisation 57
autorisations du parent 17
autorisations, actualisation 32
autorisations, affichage des informations 31
autorisations, vue d'ensemble 16
compilation 51, 58
couramment utilis&eacute;s 56
cr&eacute;ation 57
d&eacute;placement 54
dossiers parents 54
expiration, d&eacute;finition 72
extraction de l’URL 56
hi&eacute;rarchies de dossiers 54
liste des SCO d’un dossier 52
obtention d’informations 53
recherche 25, 55
r&eacute;initialisation des autorisations 32
suppression 53
transfert 58
vue d'ensemble 14
Voir aussi cours, dossiers, r&eacute;unions, pr&eacute;sentations,
questionnnaires
sco, balise 96
sco-author, balise 97
sco-data, balise 97
sco-id, param&egrave;tres 15
Index
113
sco-name, balise 98
sco-nav, balise 98
sco-search-info, balise 99
scos, balise 99
s&eacute;curit&eacute;, vue d'ensemble 15
serveurs, informations 29
services d’annuaire, synchronisation 19
services Web
mises &agrave; jour 7
primer 8
vue d'ensemble de l'architecture 11
Voir aussi actions
services Web XML Voir actions, services Web
session, param&egrave;tre de requ&ecirc;te 18
sessions de r&eacute;unions 39, 40
shortcuts, balise 100
SOAP (Simple Object Access Protocol) 11
source-sco, balise 101
sous-dossiers, liste 52
sp&eacute;cification de param&egrave;tres multiples
actualisation de l’appartenance &agrave; un groupe 30
actualisation des autorisations 33
mandants, suppression 35
SCO, suppression 53
vue d'ensemble 13
stagaires, liste 37
supports p&eacute;dagogiques 7
suppression
mandants 35
mandants de Breeze 35
SCO 53
utilisateurs 22
synchronisation avec des services d’annuaire 19
syst&egrave;mes d'aide 7
T
tableaux, affichage 24
t&acirc;ches courantes 19
texte, recherche dans des SCO 55
time-slot-begin, balise 102
time-slot-end, balise 103
transfert de SCO 51, 58
typographie, conventions 9
U
url, balise 103
URL, extraction 24
url-path, balise 103
user, balise 104
114
Index
user-id, param&egrave;tres 15
users
vue d'ensemble 14
Voir aussi mandants, groupes
users, balise 105
utilisateur administratif 20
utilisateurs
actualisation des informations 22
administratifs 20
ajout 21
autorisations 31
ayant r&eacute;pondu &agrave; un questionnaire 49
connexion 23, 30
d&eacute;connexion 31
dossiers 56
groupes, changement d’appartenance 30
ID, extraction 23
informations, obtenir 29, 33
inscription &agrave; des cours 23, 41
inscription dans Breeze 27
inscrits &agrave; des cours 37
liste 20
liste des comptes 59
mots de passe, modification 59
participation &agrave; une r&eacute;union, nombre maximal 39
r&eacute;unions planifi&eacute;es 23, 42
r&eacute;unions, participation 38
simultan&eacute;s maximum 51
suppression 22
V
v&eacute;rification de l’identit&eacute; 30
version, balise 105
view, autorisation 17
view-hidden, autorisation 18
view-only, autorisation 18
vue d'ensemble de l'architecture 11
X
XML, r&eacute;sultats
analyse 20
vue d'ensemble 61
XML, utilisation avec CFML 8
XML_API_KEY, configuration 16
XSLT (XSL Transformations) 8, 25
">
Bonjour ! Je suis un chatbot IA spécialement formé pour vous aider avec le MACROMEDIA BREEZE 5-UTILISATION DES SERVICES WEB XML DE BREEZE Manuel utilisateur. J'ai soigneusement étudié le document et je peux vous aider à trouver les informations dont vous avez besoin ou expliquer le contenu en termes clairs et simples. Que vous recherchiez des conseils sur des fonctionnalités spécifiques, des étapes de dépannage ou une utilisation générale, n'hésitez pas à poser vos questions. Plus vous fournissez de détails sur vos préoccupations ou besoins, plus je pourrai vous aider avec précision et efficacité.