Home

Using Connect Enterprise Web Services

1.
2. 292 Anhang A Ein Anwendungsbeispiel Der zweite Konstruktor bernimmt den Anmeldenamen und das Kennwort des betreffenden Benutzers sowie den Wert des BREEZESESSION Cookies public XMLApiAdapter String baseUrl String login String password String breezesession throws XMLApiException this baseUrl breezesession this setLogin login this setPassword password Sie erhalten den Wert des BREEZESESSION Cookies vor der Anmeldung eines Benutzers durch einen Aufruf von common info Eine Instanz des Adapters erstellen Mit dem folgenden aus der Datei mymeetings jsp entnommenen Code wird eine Instanz der Klasse XMLApiAdapter erstellt mit der ein an Connect Enterprise angemeldeter Benutzer abgebildet werden kann Der aktuelle Wert von breezesession in dem der Wert des BREEZESESSION Cookies gespeichert ist wird dann auf das JSP Attribut session bertragen und so anderen Dateien zug nglich gemacht lt XMLApiAdapter breeze null gt lt breeze new XMLApiAdapter breezeBase login password breezesession breeze getBreezesession session setAttribute breezesession breeze 2 Benutzer anmelden Die entsprechenden Beispieldateien sind XMLApiAdapter java und login jsp SI3SMNIH Ihre Anwendung braucht eine Methode mit der die Benutzer an Connect Enterprise angemeldet werden Eine Anmeldemethode muss eine Verbindung zum Server ffnen die login Aktion starten und dann die XML Ant
3. Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen 214 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung code report quotas quota acl id quota id used limit soft limit date begin date end Zul ssiger Wert Container Container Ganzzahl Zul ssiger Wert Ganzzahl Ganzzahl Ganzzahl Datetime Datum Uhrzeit Datetime Datum Uhrzeit Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Informationen zu s mtlichen Kontingenten des aktuellen Kontos Informationen zu einem Kontingent Die Kennung des Kontos f r welches das Kontingent gilt Der Name des auf dem Server definierten Kontingents mit der Endung quota Die Anzahl der Nutzungen die auf dieses Kontingent angerechnet werden Das Limit bei dem der Server eine Aktion verhindert Dieser Wert ist mit dem von soft 1imit entweder identisch oder er liegt geringf gig dar ber Er ist entweder ganzzahlig oder lautet unlimited Das durch die Serverlizenz bestimmte Limit Das Datum und die Uhrzeit der Aktivierung des Kontingents auf dem Server Das Datum des Ablaufs des Kontingents Beispielanforderung https example com api xml action report quotas Beispielantwort lt xml version 1 0 encoding utf 8 gt lt result
4. Rufen Sie group membership update mit is member true auf um den Benutzer der Gruppe hinzuzuf gen https example com api xml action group membership update amp group id 4930296 amp principal id 2006258745 amp is member true Rufen Sie permissions update auf um den Benutzer in einem Studienplan einzuschreiben https example com api xml action permissions update amp acl id 2006745669 amp principal id 2007124930 amp permission id view Geben Sie als permission id den Wert view ein Rufen Sie report my training auf um s mtliche Kurse und Studienpl ne aufzulisten in denen der Benutzer eingeschrieben ist https example com api xml action report my training 78 Kapitel 5 Schulungen 6 Durchsuchen Sie die row Elemente der Antwort nach den Werten die Sie anzeigen m chten lt row sco id 2006745669 type curriculum icon curriculum permission id view gt lt name gt A Day in the Life lt name gt lt url gt example com day lt url gt lt date created gt 2006 06 12114 47 59 903 07 00 lt date created gt lt date modified gt 2006 06 12T14 47 59 903 07 00 lt date modified gt lt date begin gt 2006 06 12T14 45 00 000 07 00 lt date begin gt lt url path gt day lt url path gt lt expired gt false lt expired gt lt completed gt false lt completed gt lt row gt Eine gro e Zahl von Benutzern einschreiben Wenn Sie eine gro e Zahl von Benutzern in einem Kurs oder Studienplan einschr
5. 0 0 cee ee ene ene eee 55 Meetingraum URLs erstellen 0 00 cece cece eens 56 Meetings erstellen 2 0 0c eee eee een eee 57 Benutzerdefinierte Meetings erstellen 000 cee eee 60 Benutzer zu Meetings einladen 0 c ccc eee eee 61 Benutzer aus Meetings entfernen 00 2 c eee ee eee 63 Die Meetingnutzung berechnen 00 c eee eee eee 64 Meetingarchive abrufen 0 00 0 c ccc ence eee eee 66 Abstimmungsergebnisse abrufen 0 000 e eee ee eee eee 67 Meetings mit externer Authentisierung starten 68 Kapitel 5 Schulungen 000 0c eee eee eee eee 71 Berechtigungen der Schulungsbibliothek 72 Kurse und Studienpl ne suchen 0 00 cece eee eee eee 73 Schulung eines Benutzers anzeigen 0 cee eee 76 Einen Benutzer einschreiben 0 00 cece cece eens 77 Eine gro e Zahl von Benutzern einschreiben 79 Studienplaninformationen anzeigen 0 cee eee 82 Punktzahlen angeben 0c c cece ence eee een eee 84 Kapitel 6 AktionsreferenzZ 000 00s 87 Neue und entferne AKtionen 0 ccc cece ene enn ees 87 aclfield iNO une ors ite asad ae an eine Aah Lee aia 89 ACIMHISIGKSt sacs ete su a Hae nab Savas stead Sir hihi 91 acl field update 0 nec ence eens 93 acl preference Update asr aeri cece nen eee 95 COMMONTIAIO Acie ss ahead
6. Die Berechtigung die fur den Zugriff auf ein benutzerdefiniertes Feld erforderlich ist Zul ssige Werte finden Sie im Abschnitt permission id Die Definition eines zul ssigen Objekts auf dem Server zul ssige Werte finden Sie im Abschnitt type Text mit dem das benutzerdefinierte Feld identifiziert wird field id wird in Enterprise Manager nicht angezeigt der Wert kann allerdings mithilfe unterschiedlicher Aktionen abgerufen werden Eine Kennung des aktuell angemeldeten Benutzers Wird durch den Server zugewiesen Die Position auf der das benutzerdefinierte Feld auf der Benutzeroberfl che angezeigt oder von der Aktion zur ckgegeben wird Der Datentyp den das Feld annimmt Zul ssige Werte sind text textarea und password Gibt an ob das benutzerdefinierte Feld gel scht werden kann Bei true kann das Feld nicht gel scht werden bei false schon Gibt an ob das benutzerdefinierte Feld eine Eingabe erfordert Bei true muss f r jeden Principal oder jedes SCO das dieses Feld verwendet ein Wert eingegeben werden false gibt an dass eine Eingabe nicht erforderlich ist Die Kennung des benutzerdefinierten Felds in einer Access Control List ACL Die Folgenummer des benutzerdefinierten Felds auf der Benutzeroberfl che 276 Kapitel8 Allgemeine Referenz Attribut Typ Beschreibung type principal id Zeichenfolge Der Typ des benutzerdefinierten Felds zul ssige Werte finden Sie im Abschni
7. Element Attribut Typ Beschreibung num failed Ganzzahl num enrollees Ganzzahl date last taken Datetime Datum Uhrzeit Bei einem Kurs die Angabe wie h ufig der angegebene Kurs von einem beliebigen Benutzer nicht bestanden wurde Bei einer Kurs Benutzer Kombination die Angabe wie h ufig dieser Benutzer an diesem Kurs teilgenommen und wie h ufig er ihn nicht bestanden hat Die Anzahl der Benutzer die bisher insgesamt in diesem Kurs eingeschrieben waren Wird nur f r Kurse zur ckgegeben nicht dagegen f r Kurs Benutzer Kombinationen Die letzte Teilnahme eines beliebigen Benutzers am Kurs oder die letzte Teilnahme des angegebenen Benutzers am Kurs Beispielanforderung https example com api xml action report course status amp sco id 123456 amp principal id 278935 Beispielantwort lt results gt lt status code ok gt lt report course status total course completions 4 total unique course completions 4 num passed 3 num failed 1 gt lt date last taken gt 2004 07 27712 53 42 297 07 00 lt date last taken gt lt report course status gt lt results gt report course status 165 report curriculum taker Verf gbarkeit Connect Enterprise Web Services 6 Beschreibung Gibt Informationen zum Fortschritt eines Benutzers in einem Studienplan zur ck Die Antwort enth lt f r jeden Kurs im Studienplan ein row Element mit Informationen wie dem Zugriff auf den Kurs
8. InhaltsverzeichnisS Kapitel 7 Filter und Sortierreferenz 000005 269 filter definition a re nahen 269 SOrt definiti n 2 arts en ee ee a tee 271 Kapitel 8 Allgemeine Referenz 200000ceeeee 275 ACCESS en un ee a ee ie Aa 275 TSI Ay nr ae Mes hae tele mit Anes SR u E 276 ICON ar a ee wo Da aa audits ew A hae bY 277 lang iann ern eu ee ee 278 OBject type u rennen else 279 path ty Pei yes om een nat 279 permissionsid sucht anna rd ae cr ken 280 Status een en era rear Bars 281 Status AttribUt p ees 4 ats ehe sb 284 time zone ideena sraa RR an 285 typene ae See cae au a IEE EEE S e EN ER 288 Anhang A Ein Anwendungsbeispiel 22222000 291 Aufbau einer Adapter Klasse 22222e2neneenenne 292 Benutzer anmelden 2 2222 ccc cece nennen n eee ne eens 293 XML Anforderungen senden 0 ccc cece eee eee eens 295 XML Antworten analysieren 0 0 eee eee eee 296 Benutzerdaten anzeigen 6 een eens 298 Meetings eines Benutzers auflisten 222222222 300 Meetings erstellen und aktualisieren 22222222 301 Einzelinformationen zu Meetings anzeigen 304 Index oean an en 307 6 Inhaltsverzeichnis Vorbereitungsmafbnahmen Adobe Connect Enterprise Web Services erm glicht Ihnen die Integration Ihrer Anwendungen in Adobe Connect Enterprise Server 6 oder in Adobe Connect Enterprise Hosted 6
9. Mit Cookie Management anmelden 1 Rufen Sie die Aktion login auf und bergeben Sie ihr den Anmeldenamen und das Kennwort allerdings ohne den Parameter session http example com api xml action login amp login bobs acme com amp password football 24 Kapitel 2 Anmeldung und Anforderungen 2 Analysieren Sie die Antwort und suchen Sie den Statuscode ok Falls die Anmeldung erfolgreich verlaufen ist gibt der Server das Cookie BREEZESESSION im Header der Antwort zur ck Set Cookie BREEZESESSION breezbryf9ur23mbokzs8 domain macromedia com path berlassen Sie die Verwaltung des Cookie Werts von BREEZESESSION der Bibliothek F r die Dauer dieser Benutzersitzung gibt die clientseitige Bibliothek im Anforderungs Header nachfolgender Aufrufe das Cookie an den Server zur ck Sie brauchen das Cookie im Anforderungs Header nicht explizit anzugeben Mit der Beendigung der Benutzersitzung verliert das Cookie seine G ltigkeit Mit dem Sitzungsparameter anmelden 1 Rufen Sie vor der Anmeldung des Benutzers common info auf um den Wert des Cookies BREEZESESSION abzufragen http example com api xml action common info Extrahieren Sie den Cookie Wert aus der Antwort lt cookie gt breezxg66rt43poai3if8 lt cookie gt Melden Sie den Benutzer an Geben Sie dabei den extrahierten Cookie Wert an http example com api xml action login amp login bobs acme com amp password football amp session breezxq66rt43poai3if8 Analysiere
10. lt url path gt f1234567890 lt url path gt lt sco gt Optional Wenn Sie den Dom nennamen von Enterprise Server bzw Ihres Enterprise Hosted Kontos kennen k nnen Sie die URL mit http bzw https dem Wert von domain name und schlie lich dem Wert von ur path zusammenf gen Sollten Sie den Dom nennamen nicht kennen rufen Sie zun chst common info auf https example com api xml action common info Durchsuchen Sie die Antwort nach dem Wert des host Elements Meetings erstellen Ein Benutzer muss Administrator sein um ein Acrobat Connect Meeting erstellen zu k nnen Das bedeutet dass der Benutzer ein Mitglied der integrierten Gruppe admins sein muss In der Antwort von principal list wird diese Gruppe durch type 1ive admins gekennzeichnet Meetings erstellen 57 Meetings k nnen entweder ffentlich oder privat sein und Sie m ssen zu ihrer Erstellung eine bestimmte Kombination von principal id und permission id Werten einstellen m ffentlich bedeutet hierbei dass alle Personen die die URL f r das Meeting haben den Raum betreten k nnen principal id public access amp permission id view hidden m Privat hei t dass nur registrierte Benutzer und genehmigte G ste den Raum betreten k nnen principal id public access amp permission id denied Bei einem privaten Meeting k nnen die als Teilnehmer registrierten Benutzer durch Klicken auf die Meetingraum URL und Anmelden den Raum betreten wahrend
11. ple co e gt ple co e gt e gt disabled has children false primary false principal id 2006282569 lt ext login gt jazzdoe example com lt ext login gt lt login gt lt email gt lt first name gt Jazz lt first name gt lt last name gt Doe lt last name gt Francisco lt x 2007017651 gt lt x 2007017651 gt San lt manager gt lt preferences acl id 2006258745 lang en time zone id 4 gt lt principal account id 624520 disabled has children false is hidden false is primary false principal id 2006258745 type user gt lt ext login gt joy acme com lt ext login gt lt login gt joy acme com lt login gt lt name gt Joy Smith lt name gt principal info 131 lt email gt joy acme com lt email gt lt first name gt Joy lt first name gt lt last name gt Smith lt last name gt lt x 2007017651 gt San Francisco lt x 2007017651 gt lt principal gt lt results gt Siehe auch principal list principal list by field principal update principal list Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt eine vollst ndige Liste der Benutzer und Gruppen bereit einschlie lich prim rer Gruppen Dieser Aufruf ist hilfreich wenn Sie eine Ihnen unbekannte principal id ben tigen Sie sollten dabei aber ber cksichtigen dass mit diesem Aufruf eine Liste aller Principals in Enterprise Server und Enterprise Hosted zur ckgeg
12. sco move 242 sco nav 243 sco search 246 sco shortcuts 46 250 297 sco update 53 253 302 sco upload 258 user accounts 261 user transcript update 264 user update pwd 266 aktualisieren Benutzer 41 aktueller Benutzer principal id 38 Anforderungen in einem XML Dokument 32 Anforderungs URLs Java Beispiel 294 anmelden und Benutzer aktualisieren 41 mit einem Anmeldenamen 26 aus einer Anwendung heraus 23 293 Aufbau einer Anforderungs URL 294 Cookie Management 23 24 mit einem Dom nennamen 27 an Enterprise Hosted 26 an Enterprise Server 24 grundlegendes Verfahren 24 mit Sitzungsparametern 25 Anmeldename 26 Antworten analysieren 296 mit XPath analysieren 33 nach Fehlermeldungen durchsuchen 34 Statuscode 34 Statuscode extrahieren 297 Werte extrahieren 297 Antworten analysieren Fehlermeldungen 34 Java Beispiel 296 mit XPath 33 Anwendungen Beispiel 9 291 benutzerdefiniert 8 16 Connect Enterprise 17 Meetings empfohlene Aufrufe 53 Schulung empfohlene Aufrufe 71 Anwendungsbeispiel 9 291 Anwendungsserver Web 17 anzeigen Benutzerdaten 298 Meetings 55 Status von Kursen oder Studienpl nen 76 Studienplaninformationen 82 API Aufrufe Ausf hrung der ersten Aufrufe 18 Reihenfolge 291 Archive Meetings 66 Attribute access 275 icon 277 lang 278 object type 279 permission id 56 73 280 status 284 time zone id 285 type 288 auflisten alle Kurse oder Studienplane 75 G ste 39 Kurse eines Studienplans 83 Meetingarchive 6
13. Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report quiz question distribution gt lt row display seq integer interaction id integer num correct integer num incorrect integer total responses integer percentage correct integer score integer gt lt name gt string lt name gt 202 Kapitel 6 Aktionsreferenz lt description gt string lt description gt lt row gt lt report quiz question distribution gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status report quiz question Container Informationen zu s mtlichen distribution Fragen in einem Quiz row Container Informationen zu einer Frage in einem Quiz display seq Ganzzahl Die laufende Nummer im Quiz unter die diese Frage fallt interaction id Ganzzahl Die Kennung der Frage im Quiz num correct Ganzzahl Die Anzahl der richtigen Antworten auf diese Frage num incorrect Ganzzahl Die Anzahl der falschen Antworten auf diese Frage total responses G
14. Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report user trainings taken gt lt row transcript id integer max retries integer sco id integer type allowedValue icon allowedValue status allowedValue certificate integer score integer permission id allowedValue attempts allowedValue gt lt name gt string lt name gt lt description gt string lt description gt lt url path gt string lt url path gt lt date taken gt datetime lt date taken gt lt from curriculum gt boolean lt from curriculum gt lt row gt lt report user trainings taken gt lt results gt report user trainings taken 221 Antwortwerte Element Attribut Typ Beschreibung results status code type report user trainings taken row transcript id max retries sco id type icon Container Leer mit Attributen Zul ssiger Wert Zul ssiger Wert Container Container Ganzzahl Ganzzahl Ganzzahl Zul ssiger Wert Zul ssiger Wert Alle Ergebnisse die von der Aktion zuruckgegeben werden Der Status der Antwort Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Der Typ des SCOs Zul ssige Werte sind user content content und my content Eine Liste s mtlicher Schulungen an denen der
15. lt shortcuts gt lt results gt Siehe auch sco info sco expanded contents sco update Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Erstellt Metadaten f r ein SCO bzw aktualisiert bestehende Metadaten mit denen ein SCO beschrieben wird Rufen Sie sco update auf um Metadaten f r die SCOs zu erstellen die Materialien oder Meetings darstellen Sie m ssen dar ber hinaus die Materialdateien mithilfe von sco upload oder mit Connect Enterprise Manager hochladen Dabei m ssen Sie entweder eine folder id oder eine sco id angeben allerdings nicht beide Wenn Sie eine folder id angeben erstellt sco update ein neues SCO und gibt eine sco id zur ck Wenn das SCO bereits vorhanden ist und Sie eine sco id bergeben aktualisiert sco update die Metadaten die das SCO beschreiben Rufen Sie nach der Erstellung eines neuen SCOs mit sco update die Aktion permissions update auf um festzulegen welche Benutzer und Gruppen Zugriff erhalten sollen sco update 253 Anforderungs URL http server_name api xml action sco update amp author info 1 string amp author info 2 string amp author info 3 string amp date begin datetime amp date end datetime amp description string amp email string amp first name string amp folder id integer amp lang allowedValue amp last name string amp name string amp sco id integer amp sco tag string amp source sco id integer amp type allowedValu
16. 2006258745 gt lt results gt Falls ein Principal keine ausdriickliche Berechtigung fiir ein SCO hat wenn also der Wert von permission id leer ist dann gelten die Berechtigungen des Principals f r das dem SCO bergeordnete Objekt Die Berechtigungen aller Principals f r ein SCO berpr fen 1 Rufen Sie permissions info mit einer acl id aber ohne principal id auf https example com api xml action permissions info amp acl id 2006293572 Durchsuchen Sie nacheinander alle principal Elements nach ihren Werten f r permission id lt principal principal id 2596608 is primary false type user has children false permission id view gt lt name gt Jay Arnold lt name gt lt login gt jay example com lt login gt lt principal gt Die zul ssigen Berechtigungen sind im Abschnitt permission id zusammengefasst Berechtigungen berpr fen 51 52 Kapitel 3 Grundlagen KAPITEL 4 Meetings In benutzerdefinierten Webanwendungen Portalen oder anderen Umgebungen k nnen Sie Adobe Acrobat Connect Professional Meetings anzeigen erstellen und l schen sowie ihre Daten in Berichten auswerten Wenn Sie gerade Ihre ersten Meetinganwendungen erstellen k nnen Sie sich am Anwendungsbeispiel auf der Produkt CD orientieren weitere Hinweise finden Sie auch im Anhang A Ein Anwendungsbeispiel Sobald die Benutzer auf eine Meetingraum URL klicken gelangen sie in die Umgebung von Acrobat Con
17. 3 Melden Sie sich zun chst nicht an L schen Sie den Teil der URL hinter dem Dom nennamen und f gen Sie einen Aufruf von common info hinzu https example com api xml action common info Die Antwort von common info enth lt Informationen zu Ihrer Sitzung auf dem Server vor allem aber das Cookie mit dem Ihre Sitzung identifiziert wird lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt common locale en time zone id 85 gt 18 Kapitel 1 Architektur lt cookie gt breezbryf9ur23mbokzs8 lt cookie gt lt date gt 2006 08 29T19 02 45 843 00 00 lt date gt lt host gt https example com lt host gt lt local host gt abcl23def789 lt local host gt lt url gt api xml action common info lt ur1 gt lt version gt breeze_530_r212 lt version gt lt user agent gt Mozilla 4 0 compatible MSIE 6 0 Windows NT 5 1 SV1 NET CLR 1 1 4322 lt user agent gt lt common gt lt results gt Bei der Anmeldung eines Benutzers aus einer Anwendung miissen Sie den Cookie Wert zum Server zuriicksenden um die Sitzung des Benutzers zu identifizieren weitere Informationen hierzu finden Sie im Abschnitt Aus einer Anwendung heraus anmelden principal list in einem Browser aufrufen Sobald der Wert des BREEZESESSION Cookies von common info vorliegt wird es im Browser bei der n chsten Anforderung hinzugef gt 1 Melden Sie sich in einem Webbrowser an Connect Enterprise
18. Das bedeutet dass name etwas anderes ist als Name und sco id nicht mit sco ID bereinstimmt Sie m ssen also alle Namen und Werte genau so eingeben wie sie hier in dieser Referenz angegeben sind access Beschreibung Ein Attribut das den Zugriff beschreibt den ein Benutzer auf einen Kurs oder einen Studienplan hat Werte Wert Beschreibung access blocked Der Kurs oder Studienplan ist eingeschr nkt und der Benutzer kann nicht darauf zugreifen access hidden Der Kurs oder Studienplan ist eingeschr nkt und der Benutzer kann nicht darauf zugreifen Au erdem wird er in Adobe Connect Enterprise Manager bzw auf der Benutzeroberfl che Ihrer Anwendung sofern Sie diesen Wert verwenden nicht angezeigt access open Der Kurs oder Studienplan steht zur Verf gung und der Benutzer kann darauf zugreifen access optional Der Kurs oder Studienplan ist optional access pass Der Benutzer hat an dem Kurs oder Studienplan bereits teilgenommen und ihn bestanden 275 field Beschreibung Ein Element mit Informationen zu einem benutzerdefinierten Feld eines Objekts oder Principals Attribute Attribut Typ Beschreibung permission id object type field id account id display seq field type is primary is required acl id custom seq Zul ssiger Wert Zul ssiger Wert Zeichenfolge Ganzzahl Ganzzahl Zeichenfolge Boolescher Wert Boolescher Wert Ganzzahl Ganzzahl
19. Der Wert muss dabei ein Datum im Format ISO 8601 sein filter ismember value Gibt alle Principals zur ck die Mitglied der in einem separaten Parameter angegebenen Gruppe sind bernimmt die Booleschen Werte true oder false Dabei wird bei value nicht zwischen Gro und Kleinschreibung unterschieden So ergibt jeder dieser Filter die R ckgabe eines Meetings mit dem Namen August All Hands Meeting amp filter name August All Hands Meeting amp filter name august all hands meeting Bei einigen Modifikatoren ist die Angabe eines Feldnamens erforderlich auf das der Filter angewendet werden soll z B name Andere Filter bernehmen keinen Feldnamen Bei Filtern die Feldnamen bernehmen h ngt die Auswahl der zul ssigen Felder von den Aktionen ab Sehen Sie bei der gew nschten Aktion in Kapitel 6 Aktionsreferenz nach um n here Informationen ber die Feldnamen zu erhalten die Sie in Filtern verwenden k nnen Filter f r genaue bereinstimmung filter name Goals Review Gibt die Objekte zur ck in deren Namen genau der Begriff Goals Review bzw eine beliebige Variante mit unterschiedlicher Gro Kleinschreibung gefunden wird Filter f r ungef hre bereinstimmung filter like name Goals 270 Kapitel 7 Filter und Sortierreferenz Gibt die Objekte zur ck in deren Namen der Begriff Goals bzw eine beliebige Variante mit unterschiedlicher Gro Kleinschreibung gefunden wird Zu den Ergebnissen z hlen auch
20. Materialtypen wie FLV SWF und PDF Dateien werden dagegen nicht durchsucht Bei der Suche wird nicht zwischen Gro und Kleinschreibung unterschieden Au erdem k nnen Jokerzeichen verwendet werden Zul ssige Jokerzeichen sind m Das Sternchen zur Suche nach einem oder mehreren beliebigen Zeichen m Das Fragezeichen zur Suche nach einem Zeichen Au erdem k nnen die Operatoren and und or zur Konstruktion mehrstufiger Abfragen verwendet werden Die Operatoren und die Suchbegriffe m ssen durch Leerzeichen getrennt werden https example com api xml action sco search query quiz or test Falls Sie also beispielsweise nach quizortest suchen interpretiert der Server dies als ganzen Suchbegriff und gibt nur entsprechende Ubereinstimmungen zur ck Anforderungs URL http server_name api xml action sco search amp query querystring amp filter definition value amp session BreezeSessionCookieValue 246 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung query Suchbegriff J Eine Zeichenfolge nach der gesucht werden soll Sonderzeichen im Suchbegriff m ssen mit einem vorangestellten umgekehrten Schr gstrich gekennzeichnet werden Fl ECHT Rt ae Bei dem Suchbegriff wird nicht zwischen Gro und Kleinschreibung unterschieden Jokerzeichen k nnen nicht verwendet werden session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebun
21. Zul ssiger Die Berechtigung die ein Benutzer f r Wert das Meeting hat zul ssige Werte finden Sie im Abschnitt permission id active Ganzzahl Die Anzahl der Benutzer die an participants name domain name url path date begin date end expired duration Zeichenfolge Zeichenfolge Zeichenfolge Datetime Datum Uhrzeit Datetime Datum Uhrzeit Boolescher Wert Uhrzeit diesem Meeting derzeit teilnehmen einschlie lich Veranstaltern und Moderatoren Der Name des Meetings Der Teil der URL zum Meetingraum der den Dom nennamen enth lt Der Teil der Meetingraum URL der das Meeting eindeutig identifiziert und auf den Dom nennamen folgt Das Datum und die Uhrzeit des Meetingbeginns Das Datum und die Uhrzeit des Meetingendes Gibt an ob das Meeting bereits beendet ist true wenn ja false wenn nicht Die tats chliche Dauer des Meetings Dieser Wert ist unter Umst nden k rzer oder l nger als die geplante Dauer Beispielanforderung https example com api xml action report my meetings report my meetings 189 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt my meetings gt lt meeting sco id 2006334033 type meeting icon meeting permission id host active participants 0 gt lt name gt How to Write a Novel lt name gt lt domain name gt example com lt domain name gt lt url path g
22. berpr fen 2 Schreiben Sie einen Code mit dem eine HTTP POST Anforderung an Connect Enterprise gesendet und die XML Antwort empfangen wird Die genaue Syntax Ihres Codes h ngt von der Programmiersprache und der Entwicklungsumgebung ab 3 Senden Sie das XML Dokument im Hauptteil der HTTP POST Anforderung an Connect Enterprise m F gen Sie das XML Dokument in die Anforderung ein a Stellen Sie dabei sicher dass ein content type Header mit dem Wert text xm1 oder application xml angegeben wird 32 Kapitel 2 Anmeldung und Anforderungen Eine Antwort mit XPath analysieren Wenn Sie von Connect Enterprise eine XML Antwort erhalten m ssen Sie diese analysieren um die ben tigten XML Elemente extrahieren zu k nnen Falls Sie dabei mit einer Sprache wie Java arbeiten die bereits einen XML Parser z B Xerces oder JDOM enth lt k nnen Sie die XML Antwort analysieren und die Werte extrahieren und verwenden Eine Antwort mit XPath analysieren 1 Schreiben Sie eine Methode die mindestens eine Aktion aufruft Erstellen Sie eine Instanz der XPath Klasse damit Sie die XPath Ausdr cke verwenden k nnen Rufen Sie die Aktionen auf lesen Sie die XML Antworten und w hlen Sie mithilfe der XPath Syntax die ben tigten Werte aus public String scoUrl String scold throws XMLApiException try Element e request sco info sco id scold if codePath valueOf e equalsIgnoreCase ok return XPath xpath XPath newInst
23. date created gt lt date end gt datetime lt date end gt lt date modified gt datetime lt date modified gt lt description gt string lt description gt lt name gt string lt name gt lt url path gt string lt url path gt lt passing score gt integer lt passing score gt lt duration gt datetime lt duration gt lt section count gt integer lt section count gt lt sco gt lt source Ssco gt lt source sco account id integer display seq integer folder id integer icon allowedValue lang allowedValue max retries integer sco id integer source sco id integer type allowedValue version integer gt lt date created gt datetime lt date created gt lt date modified gt datetime lt date modified gt lt name gt string lt name gt lt url path gt string lt url path gt 238 Kapitel 6 Aktionsreferenz lt source sco gt lt source sco gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results status code Sco account id disabled display seq folder id icon lang Container Leer mit Attributen Zul ssiger Wert Container Ganzzahl Datetime Datum Uhrzeit Ganzzahl Ganzzahl Zul ssiger Wert Zul ssiger Wert Alle Ergebnisse die von der Aktion zur ckgegeben werden Der Status der Antwort Ein Code zur Angabe des Antwortstatus zulassige Werte finden Sie im Abschnitt status Informationen zum SCO Die Kennung des Kontos zu dem das
24. lt results gt Siehe auch report bulk objects report bulk questions report bulk slide views report bulk users 150 Kapitel 6 Aktionsreferenz report bulk objects Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Gibt Informationen zu allen Objekten SCOs auf einem lizenzierten Enterprise Server bzw in einem Enterprise Hosted Konto zur ck Zu den zur ckgegebenen Objekttypen geh ren archive attachment authorware captivate course curriculum external event flv image meeting presentation und swf Da die Antwort wahrscheinlich sehr umfangreich ist sollten Sie sie mithilfe von Filtern einschr nken Wenn Sie also beispielsweise eine Liste aller Meetings abrufen m chten k nnen Sie einen Filter f r das Feld type verwenden http example com api xml action report bulk objects amp filter type meeting Anforderungs URL http server_name api xml action report bulk objects amp filter definition value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt repo
25. lt report c lt sco tra rriculum taker gt nscript id 2006905613 path type prereq none asset id 2006334911 sco id 2006334909 depth 0 fo Sta d lang en max retries t er id 2006258747 type content icon producer source sco id source sco type s user failed score 0 certificate max score 0 attempts 5 gt lt access gt access open lt access gt lt credi t granted gt false lt credit granted gt lt name gt Test Quiz lt name gt lt url path gt quiz lt url path gt lt date created gt 2006 06 30T15 24 34 897 07 00 lt date created gt lt date modi fied gt 2006 05 16T15 22 25 703 07 00 lt date modified gt 170 Kapitel 6 Aktionsreferenz lt date taken gt 2006 06 30115 24 34 897 07 00 lt date taken gt lt override gt false lt override gt lt sco gt lt report curriculum taker gt lt results gt report meeting attendance Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt eine Liste der Benutzer zur ck die an einem Acrobat Connect Meeting teilgenommen haben Die Antwort enth lt f r jede Person die teilgenommen hat ein row Element Wenn das Meeting noch nicht gestartet wurde oder keine Teilnehmer anwesend waren enth lt die Antwort keine Zeilen In der Antwort sind au erdem keine Veranstalter oder solche Benutzer enthalten die zwar eingeladen waren aber nicht teilgenommen haben F r den Aufruf von
26. lt report course status total course completions integer total unique course completions integer num passed integer num failed integer num enrollees integer gt lt date last taken gt datetime lt date last taken gt lt report course status gt lt results gt report course status 163 Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status report course status Container Informationen zu einem Kurs oder total course Ganzzahl completions total unique Ganzzahl course completions num passed Ganzzahl zum Fortschritt eines Principals in einem Kurs Bei einem Kurs die Angabe von wie vielen Benutzern der Kurs insgesamt abgeschlossen wurde Bei einem Benutzer die Angabe wie h ufig der angegebene Kurs abgeschlossen wurde Bei einem Kurs die Angabe von wie vielen einzelnen Benutzern der Kurs abgeschlossen wurde Bei einem Benutzer die Angabe wie h ufig der angegebene Kurs von einzelnen Benutzern abgeschlossen wurde Bei einem Kurs die Angabe wie h ufig der angegebene Kurs von einem beliebigen Benutzer bestanden wurde Bei einem Benutzer die Angabe wie h ufig er an dem angegebenen Kurs teilgenommen und ihn bestanden hat 164 Kapitel 6 Aktionsreferenz
27. lt results gt lt status code allowedValue gt lt report user training transcripts gt lt row transcript id integer sco id integer principal id integer status allowedValue score integer max score integer certificate integer type allowedValue icon allowedValue gt lt name gt string lt name gt lt url path gt string lt url path gt lt login gt string lt login gt lt date taken gt datetime lt date taken gt lt principal name gt string lt principal name gt lt sco tag gt string lt sco tag gt lt row gt lt report user training transcripts gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zulassiger Wert Ein Code zur Angabe des Antwortstatus zulassige Werte finden Sie im Abschnitt status report user training transcripts 225 Element Attribut Typ Beschreibung report user training Container Informationen zu allen transcripts Lernzielkopien des angegebenen Benutzers row Container Informationen zu einem Versuch des Benutzers an einer Schulung teilzunehmen transcript id Ganzzahl Die Kennung der Kopie auf der die Punktzahl des Benutzers gespeichert ist F r jeden Versuch eines Benutzers an einem SCO teilzunehmen wird eine Kopie angelegt sco id Ganzzahl Die Kennung des SCOs Hierbei kann essich um ein Meeting einen Kurs oder Studienplan eine Veran
28. lt status code allowedValue gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status Beispielanforderung https example com api xml action user update pwd Auser id 2006258745 amp password old hello amp password newone amp password verify newone Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt user update pwd 267 268 Kapitel 6 Aktionsreferenz KAPITEL 7 Filter und Sortierreferenz Dieses Kapitel enth lt eine Referenz f r Filter und Sortierwerte mit denen Sie den Umfang von Antworten aus XML Aktionen in Adobe Connect Enterprise Web Services einschr nken k nnen filter definition Beschreibung Ein Filter ist ein bestimmter Parametertyp mit dem der Umfang einer Antwort eingeschrankt werden kann Wenn Sie in der Syntax einer Anforderungs URL den Begriff filter definition sehen k nnen Sie an der Stelle eine Filterdefinition eingeben Bei der Erstellung einer Filterdefinition geben Sie zun chst das Schl sselwort filter an f gen ggf einen Modifikator hinzu und danach einen Filternamen sofern zul ssig und einen Wert Verwenden Sie dabei die folgende Syntax f
29. sentation Beantwortung eines Quiz etc Der Name des Benutzers der mit dem SCO interagiert Eine Bezeichnung f r das SCO als Zusatz zum Namen z B ein Kurzname f r einen Kurs Beispielanforderung https example com api xml action report user training transcripts amp principal id 2006258745 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report user training transcripts gt lt row transcript id 2006905612 sco id 2006298431 principal id 2006258745 status review score 0 max score certificate type content icon course gt lt name gt Test Course lt name gt lt url path gt test lt url path gt lt login gt joy acme com lt login gt lt date taken gt 2006 06 30T15 23 55 070 07 00 lt date taken gt lt principal name gt Joy Smith lt principal name gt lt row gt report user training transcripts 227 lt row transcript id 2007016805 sco id 2006298431 principal id 2006258745 status review score 0 max score certificate type content icon course gt lt name gt Test Course lt name gt lt url path gt test lt url path gt lt login gt joy acme com lt login gt lt date taken gt 2006 07 14716 55 28 440 07 00 lt date taken gt lt principal name gt Joy Smith lt principal name gt lt row gt lt report user training transcripts gt lt results gt sco contents Verf gbarkeit Breeze
30. zugreifen darf m Einige SCOs verf gen ber Beschreibungsfelder das sind Textzeichenfolgen mit Informationen zu diesem SCO H ufig m ssen Sie die Kennung oder weitere Daten eines SCOs finden SCOs sind in bestimmten Ordnerhierarchien gespeichert Deren Ordnernamen zeigen an ob sie auf der obersten Ebene liegen und ob freigegebene oder benutzerdefinierte Materialien oder Vorlagen enthalten sind Beim Aufruf von sco shortcuts wird eine Liste der Ordner zur ckgegeben Beachten Sie dabei dass einige Ordner unterschiedlichen Typs sind lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt shortcuts gt lt sco tree id 624530 sco id 2006258751 type my meeting templates gt lt domain name gt http example com lt domain name gt lt sco gt lt sco tree id 624530 sco id 2006258750 type my meetings gt lt domain name gt http example com lt domain name gt lt sco gt lt sco tree id 624529 sco id 624529 type meetings gt lt domain name gt http example com lt domain name gt lt sco gt 46 Kapitel 3 Grundlagen lt sco tree id 624530 sco id 624530 type user meetings gt lt domain name gt http example com lt domain name gt lt sco gt lt shortcuts gt lt results gt Die Ordner in diesem Beispiel sind Meetingordner und die Ordner fiir andere SCO Typen haben hnliche Typenmuster In jedem Ordner wird ein bestimmter Objekttyp gespeiche
31. 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt files gt lt file gt lt path gt string lt path gt lt file gt lt files gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Antwortstatus Wert zul ssige Werte finden Sie im Abschnitt status files Container Informationen zu s mtlichen hochgeladenen Dateien Dieses Element ist veraltet und steht in zuk nftigen Versionen ggf nicht mehr zur Verf gung 260 Kapitel6 Aktionsreferenz Element Attribut Typ Beschreibung file Container Informationen zu einer Datei Dieses Element ist veraltet und steht in zuk nftigen Versionen ggf nicht mehr zur Verf gung path Zeichenfolge Der Pfad zur neu hochgeladenen Datei Nur zum internen Gebrauch durch Adobe Dieses Element ist veraltet und steht in zuk nftigen Versionen ggf nicht mehr zur Verf gung Beispielanforderung Diese Anforderung wird durch das Hochladen einer Datei mithilfe eines HTML Formulars erstellt http example com api xml action sco upload amp sco id 2006768386 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt files gt lt file gt lt path gt 624520 2006768386 10 input WhatMakesAGreatFilm ppt lt path gt lt
32. 00 lt date expired gt lt user gt lt users gt lt results gt user accounts 263 user transcript update Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Setzt die Punktzahl eines Objekts in einem Studienplan au er Kraft So k nnen Sie beispielsweise mithilfe von user transcript update einem Benutzer eine bestimmte Punktzahl f r eine externe Schulung zuweisen Diese Aktion funktioniert allerdings nur bei den Objekten eines Studienplans Au erdem ben tigen Sie manage Berechtigung f r diesen Studienplan Anforderungs URL http server_name api xml action user transcript update amp curriculum id integer amp sco id integer amp status allowedValue amp score integer amp principal id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung curriculum id Ganzzahl N Die Kennung des Studienplans sco id Ganzzahl J Die eindeutige Kennung des SCOs dessen Punktzahl Sie au er Kraft setzen m chten status Zul ssiger J Ein Wert mit dem Status des Versuchs Wert des Benutzers dieses SCO zu verwenden Zul ssige Werte sind completed incomplete user passed user failed oder not attempted score Ganzzahl J Eine Ganzzahl die die Punktzahl repr sentiert die der Benutzer f r dieses SCO erzielt hat 264 Kapitel 6 Aktionsreferenz Name Typ Erforderlich Beschreibung principal id Ganzzahl J Die Kennung des Benutzers dessen Lern
33. 2006745673 source sco type 0 status user passed score 0 certificate max score 0 attempts 0 gt lt access gt access open lt access gt lt credit granted gt true lt credit granted gt lt name gt Al1 About Web Communities lt name gt lt url path gt 180422078 lt url path gt lt description gt test lt description gt lt date created gt 2006 06 12T15 06 02 947 07 00 lt date created gt lt date modified gt 2006 06 12T14 48 25 980 07 00 lt date modified gt lt date taken gt 2006 06 12T15 06 02 947 07 00 lt date taken gt lt override gt false lt override gt lt sco gt Die Statuswerte user passed bzw completed zeigen an dass ein Modul vom Benutzer abgeschlossen wurde Der Status not attempted oder incomplete weist auf nicht abgeschlossene Module hin Der Studienplan selbst kann nur die Statuswerte completed oder incomplete annehmen Punktzahlen angeben Bei vielen Kursen erhalten die Teilnehmer mehrere Gelegenheiten zur Teilnahme Wenn Sie eine serverseitige berpr fung nutzen kann der Schulungsverwalter die maximale Anzahl der Versuche eingeben die ein Teilnehmer erh lt um den Kurs erfolgreich abzuschlie en weitere Hinweise zu diesem Thema sowie zur serverseitigen und zur clientseitigen berpr fung finden Sie im Connect Enterprise Benutzerhandbuch Das bedeutet dass ein Lernender mehrfach an einem Kurs teilnehmen und mehrere Punktzahlen erreichen kann Aber ggf m chten Sie in Ihrer
34. 2007064258 filter permission id view filter type group Eine gro e Zahl von Benutzern einschreiben 81 2 Werten Sie die Antwort nach der principal id der Gruppe aus lt principal principal id 2006258745 is primary false type group has children true permission id view gt lt name gt developers lt name gt lt login gt developers acme com lt login gt lt principal gt 3 Rufen Sie permissions update mit der permission id denied auf um die Gruppe aus dem Kurs zu entfernen https example com api xml action permissions update amp acl id 2007064258 amp principal id 2007105030 amp permission id denied Studienplaninformationen anzeigen Sobald Ihre Schulungsverwalter damit beginnen ihre Studienpl ne zu erstellen und die Benutzer an den Kursen teilnehmen m ssen Sie diese Daten abrufen und in Ihrer Anwendung darstellen k nnen H ufig erhalten Sie die gew nschten Daten mit nur einem Aufruf z B dann wenn Sie die sco id des Studienplans oder Kurses und die principal id des Benutzers kennen Oder Sie m chten unter Umst nden alle in einem Studienplan eingeschriebenen Benutzer bzw die enthaltenen Kurse wissen Eine weitere h ufige Anforderung besteht darin die Kurse eines Studienplans anzuzeigen die ein Benutzer bisher abgeschlossen hat und danach seine verbleibenden Kurse aufzuf hren Alle Benutzer eines Kurses oder Studienplans anzeigen 1 Rufen Sie permissions info auf und filtern Sie das Ergebnis an
35. 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt eine Liste von SCOs innerhalb eines anderen SCOs bereit Das bergeordnete SCO kann ein Ordner ein Meeting oder ein Studienplan sein Die untergeordneten SCOs k nnen normalerweise jeden Typ haben also Meetings Kurse Studienpl ne Materialobjekte Veranstaltungen Ordner Dateistrukturen oder Links sein siehe die Liste im Abschnitt type Allerdings muss der untergeordnete SCO einen f r den bergeordneten SCO g ltigen Typ haben So sind Kurse beispielsweise in Studienpl nen enthalten und Meetingmaterialien in Meetings Da auch Ordner SCOs sind gibt die Liste nur die SCOs und Unterordner der n chsten hierarchischen Ebene zur ck nicht aber deren Inhalte Zum Abfragen der Inhalte von Unterordnern m ssen Sie sco expanded contents aufrufen Anforderungs URL http server_name api xml action sco contents amp sco id integer amp filter definition value amp sort definition value amp session value 228 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J session Zeichenfolge N Die eindeutige Kennung des Ordners dessen Inhalt Sie anzeigen m chten Sie erhalten die entsprechenden sco id Werte durch einen Aufruf von sco shortcuts Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem en
36. 81 integriert 38 Liste aller Gruppen eines Benutzers 45 Mitgliedschaft von Benutzern berpr fen 43 44 suchen principal id 38 H HeaderAuthenticationFilter 28 herunterladen Adobe Ressourcen 8 Dateien 49 icon Attribut 277 integrierte Gruppen 38 Interaktionen 195 invalid Statuscode 34 J JavaScript Meetingraum URL ffnen 69 K Komponenten 17 Flash Media Server 17 SQL Server Datenbank 18 Webanwendungsserver 17 Konventionen typografisch 11 Kurse alle Benutzer anzeigen 82 alle verf gbaren auflisten 75 Benutzer entfernen 80 Definition 71 einen Benutzer einschreiben 77 eines Benutzers anzeigen 76 Gruppen einschreiben 81 Gruppen entfernen 81 Kurse von Studienpl nen auflisten 83 mehrere Benutzer einschreiben 79 Punktzahlen angeben 84 sco id finden 74 Kursordner 47 72 L lang Attribut 278 learning path info 111 learning path update 114 Links zu Connect Enterprise Ressourcen 9 login Aktion 116 Java Beispiel 294 logout Aktion 118 Java Beispiel 35 M manage Berechtigung 73 Materialordner 47 Meetinganwendungen empfohlene Aufrufe 53 Meetingarchive 66 Meetingnutzung berechnen 64 Meetingordner 47 Meetingraum URL 56 305 Meetings Abstimmungsergebnisse abrufen 67 aktualisieren 301 als Teilnehmer starten 68 anzeigen 304 Archive auflisten 66 Benutzer einladen 61 Benutzer hinzuf gen 55 benutzerdefiniert 60 Berechtigungen festlegen 303 Doppelte Anmeldung verhindern 69 Einladungen senden 61
37. A und endet mit Z Numerische Listen beginnen mit der niedrigsten Nummer bzw mit dem fr hesten Datum desc Absteigende Reihenfolge Bei alphabetischen Listen beginnt die Sortierung mit Z und endet mit A Numerische Listen beginnen mit der h chsten Nummer bzw mit dem j ngsten Datum 272 Kapitel 7 Filter und Sortierreferenz Die Ergebnisse werden unter Umst nden mithilfe von sort1 und sort2 einer prim ren und einer sekund ren Sortierung unterzogen Wenn Sie beispielweise durch einen Aufruf von principal list die Liste aller Principals anzeigen m chten k nnen Sie eine prim re Sortierung auf type und danach eine sekund re Sortierung auf das Feld name durchf hren Auf diese Weise werden alle Principals typenweise gruppiert und dann in ihrer Gruppe jeweils nach dem Namen sortiert Eine doppelte Sortierung kann ggf folgenderma en angegeben werden sortl type asc amp sort2 name desc Siehe auch filter definition sort definition 273 274 Kapitel 7 Filter und Sortierreferenz KAPITEL 8 Allgemeine Referenz Diese Abschnitt der Referenz beschreibt die XML Elemente und Attribute die von mehreren Aktionen der Adobe Connect Enterprise Web Services verwendet werden In den Tabellen der Aktionsanforderungen und antworten der Web Services XML API wird auf die hier beschriebenen Elemente verwiesen Bei allen Namen von Parametern Elementen und Attributen wird zwischen Gro und Kleinschreibung unterschieden
38. Anwendung ja nur die h chste Punktzahl des Teilnehmers anzeigen Die h chste Punktzahl eines Benutzers f r einen Kurs oder ein Quiz anzeigen 1 Rufen Sie die principal id des betreffenden Benutzers ab entsprechende Hinweise finden Sie im Abschnitt Die principal id des aktuellen Benutzers erhalten Rufen Sie die sco id des betreffenden Kurses oder Quizzes ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Kurses oder Studienplans suchen 84 Kapitel 5 Schulungen 3 Rufen Sie report user training transcripts auf filtern Sie die sco id und sortieren Sie die Antwort nach den Punktzahlen https example com api xml action report user training transcripts amp principal id 2006258745 amp filter sco id 20063349098sort score desc 4 Werten Sie die Antwort nach der h chsten Punktzahl aus also dem ersten row Element in der Liste lt row transcript id 2006335954 sco id 2006334909 principal id 2006258745 status user passed score 20 max score 20 certificate 2006335954 type content icon producer gt lt name gt Java Data Type Quiz lt name gt lt url path gt quiz lt url path gt lt login gt bob acme com lt login gt lt date taken gt 2006 05 12T11 55 24 940 07 00 lt date taken gt lt principal name gt Bob Smith lt principal name gt lt row gt Punktzahlen angeben 85 86 Kapitel 5 Schulungen KAPITEL 6 Aktionsreferenz Dieser Abschnitt enth l
39. Bei einem Studienplan immer 0 Bei einem Kurs eine Ebene unter dem Studienplan also 1 Die Kennung des Ordners der den Kurs oder Studienplan enth lt Bei Kursen die Kennung eines Studienplans bei Studienpl nen die Kennung eines Benutzers Der Typ des Kurses oder Studienplans zul ssige Werte finden Sie im Abschnitt type Der Typ des Symbols mit dem der Kurs oder Studienplan in Enterprise Manager identifiziert wird zul ssige Werte finden Sie im Abschnitt icon Die mit dem Kurs oder Studienplan verbundene Sprache zul ssige Werte finden Sie im Abschnitt 1ang 168 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung max retries source sco id source sco type status score certificate max score attempts Ganzzahl Ganzzahl Ganzzahl Zul ssiger Wert Ganzzahl Ganzzahl Ganzzahl Ganzzahl Die maximale Anzahl der Versuche die ein Benutzer erh lt um einen Kurs oder Studienplan erneut zu beginnen Wenn ein Benutzer an einem Kurs 3 mal teilnehmen kann lautet der Wert von max retries 2 Die eindeutige Kennung des SCOs das als Vorlage f r diesen Kurs oder Studienplan dient Der Typ des SCOs das als Vorlage f r diesen Kurs oder Studienplan dient zul ssige Werte finden Sie im Abschnitt type Der Status des Versuchs eines Benutzers diesen Kurs oder Studienplan zu verwenden Bei Kursen lauten die zul ssigen Werte completed incomplete u
40. Benutzer teilgenommen hat Informationen zu einem Kurs oder Studienplan an dem der Benutzer teilgenommen hat unabh ngig davon ob er diesen bestanden hat oder nicht Die Kennung des Datensatzes mit der aktuellen Punktzahl f r diese Schulung Die maximale Anzahl der m glichen Schulungswiederholungen f r diesen Benutzer Die Kennung des Schulungs SCOs Der Typ des Schulungs SCOs zul ssige Werte finden Sie im Abschnitt type Der Typ des Symbols mit dem der Kurs oder Studienplan in Connect Enterprise Manager identifiziert wird Enth lt neben type noch weitere Informationen zum Kurs oder Studienplan zul ssige Werte finden Sie im Abschnitt icon 222 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung name description url path date taken from curriculum status certificate score permission id attempts Zul ssiger Wert Ganzzahl Ganzzahl Zul ssiger Wert Ganzzahl Zeichenfolge Zeichenfolge Zeichenfolge Datetime Datum Uhrzeit Boolescher Wert Der Status des Versuchs eines Benutzers mit diesem SCO zu arbeiten Zul ssige Werte f r Kurse oder Pr sentationen sind user passed user failed completed incomplete not attempted und review Studienpl ne und Ordner k nnen nur completed oder incomplete sein Die Kennung des Datensatzes der anzeigt ob der Benutzer die Schulung bestanden oder nicht bestanden hat Die Punktz
41. Dagegen sollten Sie sco search lieber nicht verwenden da dabei nur bestimmte SCO Typen zur ckgegeben werden Ein SCO suchen dessen sco id Sie nicht kennen 1 Rufen Sie sco shortcuts auf um eine Liste der Stammordner von Connect Enterprise zu erhalten https example com api xml action sco shortcuts 2 Durchsuchen Sie die Antwort nach dem Wert von type des Stammordners der das SCO logisch enthalten sollte z B my courses bei einem Kurs den der Benutzer erstellt hat SCOs suchen 47 3 Durchsuchen Sie das zur ckgegebene sco Element nach einer sco id 5 lt sco tree id 4930295 sco id 2006258748 type my courses gt lt domain name gt http example com lt domain name gt lt sco gt Erstellen Sie einen sco expanded contents Aufruf um den Inhalt des Ordners anzuzeigen F gen Sie dabei nach M glichkeit einen Filter f r eine genaue bereinstimmung hinzu https example com api xml action sco expanded contents amp sco id 2006258748 filter name All About Web Communities Bei den Filtern stehen Ihnen mehrere M glichkeiten zur Verfiigung a Ein Filter f r genaue Ubereinstimmungen bei name oder url path z B filter name oder fil ter url path wenn Sie den Namen oder die URL des SCOs kennen a Ein Datumsfilter mit der Suchoption vorher oder nachher filter gt Datum oder filter 1t Datum auf die Felder date begin date created oder date modified falls Ihnen diese Daten bekannt sind m Ein
42. Erstellung der Transaktion date closed Datetime Das Datum und die Uhrzeit der Datum Uhrzeit Freigabe des SCOs durch den Principal sowie des Abschlusses der Transaktion Beispielanforderung https example com api xml action report bulk consolidated transactions amp filter type meeting Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report bulk consolidated transactions gt lt row transaction id 2006905086 sco id 2006905049 type meeting principal id 2006258745 score 0 gt lt name gt Celebrate End of June Meeting lt name gt lt url gt endjune lt url gt lt login gt joy acme com lt login gt lt user name gt Joy Smith lt user name gt lt status gt completed lt status gt lt date created gt 2006 06 30T11 10 37 003 07 00 lt date created gt lt date closed gt 2006 06 30T11 45 21 397 07 00 lt date closed gt lt row gt lt row transaction id 2006905795 sco id 2006905049 type meeting principal id 2006258745 score 0 gt lt name gt Celebrate End of June Meeting lt name gt lt url gt endjune lt url gt lt login gt joy acme com lt login gt lt user name gt Joy Smith lt user name gt lt status gt completed lt status gt lt date created gt 2006 06 30T17 58 29 060 07 00 lt date created gt lt date closed gt 2006 06 30T17 59 09 970 07 00 lt date closed gt lt row gt lt report bulk consolidated transactions gt
43. In diesem Handbuch wird erkl rt wie Sie aus einer Anwendung heraus XML API Aufrufe an Connect Enterprise senden und die XML Antworten auswerten k nnen Das Handbuch richtet sich an Entwickler die benutzerdefinierte Anwendungen f r Connect Enterprise erstellen oder das Produkt in andere Systeme integrieren m chten wie beispielsweise Learning Management Systeme oder den LDAP Verzeichnisdienst Bevor Sie dieses Handbuch lesen sollten Sie die Grundlagen von XML und die Verwendung von HTTP zur Kommunikation zwischen Client Anwendungen und Servern verstehen Dieses Handbuch enth lt einige Java Codebeispiele Es wird aber nicht davon ausgegangen dass Sie eine bestimmte Entwicklungssprache oder umgebung verwenden Tipps und Schulung Adobe bietet zahlreiche Ressourcen die das Erlernen und den Umgang mit Adobe Produkten erleichtern m Adobe Developer Center Tutorials Referenzmaterial Scripting Anleitungen und andere detaillierte Informationen m Weitere Ressourcen Schulungen B cher Benutzerforen Produktzertifizierungen und anderes m Extras und Downloads Materialien und Software zum Herunterladen Adobe Developer Center Dieser community basierte Bereich von Adobe com bietet Informationen f r erfahrene Benutzer einschlie lich Software und Plug In Entwickler Dort finden Sie Tutorials SDKs Scripting Anleitungen und Code Beispiele sowie Foren RSS Feeds Online Seminare und andere technische Ressourcen Weitere Ress
44. Meetings zu einem bestimmten Zeitpunkt in einem gegebenen Zeitraum max participants Ganzzahl Die Angabe wie h ufig dieser freq maximale Wert im angegebenen Zeitraum erreicht wurde Beispielanforderung https example com api xml action report meeting concurrent users Beispielantwort lt results gt lt status code ok gt lt report meeting concurrent users max users 400 max participants freq 1 gt lt results gt report meeting concurrent users 175 report Meeting sessions Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt Informationen ber alle Sitzungen eines Acrobat Connect Meetings bereit Eine Sitzung wird erstellt sobald ein Teilnehmer ein leeres Meeting betritt Alle weiteren Teilnehmer die das Meeting betreten nehmen an dieser Sitzung teil Die Sitzung endet wenn der letzte Teilnehmer das Meeting verl sst Wenn zu einem sp teren Zeitpunkt wieder ein Teilnehmer auf das leere Meeting zugreift wird eine neue Sitzung gestartet So gibt es f r ein w chentlich stattfindendes Meeting immer dann eine neue Sitzung wenn das Meeting tats chlich durchgef hrt wird Sie k nnen report meeting sessions f r vergangene aktuelle oder zuk nftige Meetings aufrufen allerdings wird es f r zuk nftige Meetings wohl kaum Sitzungen geben Anforderungs URL http server_name api xml action report meeting sessions amp sco id integer amp filter definiti
45. Sie diesen Benutzer mithilfe externer Authentisierungsdaten bei Enterprise Server oder bei Enterprise Hosted authentisieren werden Sie diesem Benutzer unter Umst nden erlauben ein Meeting als Teilnehmer oder als Gast zu betreten ohne dass er sich ein weiteres Mal bei Acrobat Connect Professional anmelden muss Ein Meeting starten und den Benutzer als Teilnehmer eintreten lassen 1 Sobald der Benutzer in Ihrem Netzwerk authentisiert ist k nnen Sie ihn an Connect Enterprise anmelden Hinweise hierzu finden Sie im Abschnitt Mit einer HTTP Header Authentisierung anmelden 2 Lesen Sie den Wert des Cookies BREEZESESSION f r diese Benutzersitzung aus Sie haben hierf r zwei M glichkeiten m Rufen Sie common info auf und lesen Sie aus der Antwort den Wert von cookie aus lt cookie gt breezma6zor9rdfps8h6a lt cookie gt m Extrahieren Sie den Wert des Cookies BREEZESESSION aus dem Antwort Header Set Cookie BREEZESESSION breezqw4vtfarqxvf9pk2 domain macromedia com path 3 Erstellen Sie eine Meetingraum URL Hinweise hierzu finden Sie im Abschnitt Meetingraum URLs erstellen 4 F gen Sie die Werte des session Parameters und des BREEZESESSION Cookies an die Meetingraum URL an http example com employeeMeeting session breezbityp829r9ozv5rd 68 Kapitel 4 Meetings ffnen Sie die Meetingraum URL an die session angeh ngt wurde Eine M glichkeit hierzu ist der JavaScript Befehl onC1 ick lt a href http
46. Standardkonventionen f r die Darstellung von Code verwendet Allerdings ist die API Referenz eine formale Beschreibung der API Vereinbarung zwischen der aufrufenden Anwendung und dem Server Daher sollten die Syntaxdefinitionen der Anforderungs URLs beschrieben werden Wir verwenden mehrere Zeilen um die einzelnen Bereiche einer Anforderungs URL deutlich lesbar darzustellen und zwar so http server_name api xml action custom fields amp filter definition value amp session BreezeSessionCookieValue Bei der Eingabe einer Anforderungs URL in die Adresszeile eines Browsers oder der Erstellung durch eine Anwendung darf nur eine Zeile verwendet werden https example com api xml action custom fields amp filter name location Syntax Elemente in blauer Codeschriftart bezeichnen Definitionen die Sie erstellen m ssen Ein Link verweist auf die Syntax der Definition Konventionen 11 12 Vorbereitungsma nahmen KAPITEL 1 Architektur Willkommen bei Adobe Connect Enterprise Web Services der Webservice Ebene ber Adobe Connect Enterprise Server 6 Adobe Connect Enterprise Hosted 6 sowie der Connect Enterprise Produktreihe f r Anwendungen Die Webservices erm glichen Ihnen das Erstellen von Portalen oder Webanwendungen die Connect Enterprise Funktionen und Berichtsdaten aus den Systemen anderer Anbieter integrieren wie Portale sowie CRM und ERP Systeme Mithilfe der XML API erm glicht Connect Enterprise Web S
47. Symbol mit dem das SCO auf Wert der Benutzeroberfl che visuell identifiziert wird byte count Ganzzahl Die Gr e des SCOs in Byte name Zeichenfolge Der Dateiname des SCOs url path Zeichenfolge Die eindeutige Kennung die in der date created date modified hi Datetime Datum Uhrzeit Datetime Datum Uhrzeit Ganzzahl URL des SCOs auf den Dom nennamen folgt Das Datum der Erstellung des SCOs Das Datum der nderung des SCOs Die Folgenummer dieser Instanz des Suchbegriffs im SCO 248 Kapitel 6 Aktionsreferenz Beschreibung Element Attribut Typ hit type Zul ssiger Wert hit url Zeichenfolge thumbnail path Zeichenfolge Der Materialtyp in dem der Suchbegriff gefunden wurde Zul ssige Werte sind metadata und slide Eine relative URL zu der Position an der der Suchbegriff im Material gefunden wurde beispielsweise eine bestimmte Folie Muss an den ur path angeh ngt werden Eine relative URL zu einem Bild des SCOs das den Suchbegriff enth lt Beispielanforderung https example com api xml action sco search query quiz Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt sco search info gt lt sco sco id 5677964 folder id 2562850 type content icon producer byte count 5985 gt lt name gt Final Quiz lt name gt lt url path gt p46125962 lt url path gt lt date created gt 2005 05 09
48. Umgebung und Serverkonfiguration nutzen Sie unter Umst nden mehrere dieser Optionen gleichezeitig Cookie Management Bei der Anmeldung eines Benutzers gibt Connect Enterprise ein Cookie zur ck mit dem die Sitzung dieses Benutzers identifiziert wird Im Verlauf dieser Benutzersitzung m ssen Sie dem Server den Cookie Wert mit jedem Aufruf zur ckgeben Wenn sich der Benutzer sp ter abmeldet setzt der Server das Cookie zur ck Sie sollten diesen Cookie Wert daraufhin nicht mehr verwenden In Ihrer Entwicklungsumgebung k nnen Sie eine Codebibliothek nutzen die die Cookies f r Sie verwaltet Ob Sie eine Cookie Managementbibiothek verwenden oder die Benutzersitzungen selbst verwalten hat Auswirkungen auf das verwendete Anmeldeverfahren und die Verwaltung der Benutzersitzung 23 Lizenzierter Server oder Hosted Konto In Ihrem Unternehmen gibt es innerhalb der Firewall unter Umst nden einen lizenzierten Enterprise Server Die andere M glichkeit besteht darin dass Sie ber ein Enterprise Hosted Konto bei Adobe verf gen In beiden F llen senden Sie XML Anforderungen ber HTTP oder HTTPS aber die Sicherheitsanforderungen und das Anmeldeverfahren unterscheiden sich Falls Sie ein Hosted Kunde sind k nnen Sie die Aktion login mit verschiedenen Parametern verwenden um zu verhindern dass Anmeldenamen und Kennw rter ber das Internet gesendet werden Direkte oder externe Authentisierung Unabh ngig davon ob Sie ein Hosted Kunde sind
49. Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status expanded scos Container Die Liste aller SCOs die im Ordner enthalten sind sco Container Informationen zu einem SCO im Ordner Dieses SCO kann ein Ordner oder ein beliebiges anderes Objekt sein depth Ganzzahl Die Hierarchietiefe in der Verzeichnisstruktur in der das Objekt gespeichert ist Objekte auf der obersten Ebene geben eine 1 zur ck sco expanded contents 235 Element Attribut Typ Beschreibung sco id Ganzzahl folder id Ganzzahl type Zul ssiger Wert icon Zul ssiger Wert lang Zul ssiger Wert source sco id Ganzzahl display seq Ganzzahl source sco type Ganzzahl Die eindeutige Kennung des SCOs Falls das SCO ein Ordner ist der gleiche Wert wie folder id Die Kennung des Ordners zu dem das SCO geh rt Der Typ des Materialobjekts siehe type Der Name des Symbols mit dem das Objekt visuell identifiziert wird Die Sprache in der die Daten zum SCO angezeigt werden zul ssige Werte finden Sie im Abschnitt 1 ang Die Kennung eines SCOs das als Vorlage f r dieses SCO diente wie z B eine Meetingvorlage oder bestimmtes Kursmaterial Die Reihenfolge in der Enterprise Manager bzw Ihre Anwendung sofern Sie diesen Wert verwenden die Liste der SCOs anzeigt Die Werte brauchen dabei nicht eindeutig zu sein es k nnen also auch mehrere SCOs den gleichen display seq Wert erhalten In diesem Fall muss die
50. Wert wie quiz zip und nicht quiz zip erhalten Berechtigungen berpr fen Berechtigungen definieren in welcher Form ein Principal mit einem SCO arbeiten kann Eine Berechtigungszuordnung die die Berechtigungen eines Principals f r ein bestimmtes SCO enth lt wird auch als Access Control List Zugriffskontrollliste bezeichnet Eine ACL enth lt drei Arten von Informationen m Die Kennung des Principals d h die principal id m Die Kennung des SCOs Kontos oder Principals auf das bzw den zugegriffen werden soll Bei Berechtigungsaufrufen wird diese Kennung als ac id bezeichnet In anderen F llen handelt es sich um eine sco id eine account id oder eine principal id m Ein Schl sselwort das die Berechtigungsebene des Principals angibt also einer der Werte von permission id 50 Kapitel 3 Grundlagen Die Berechtigung eines Principals f r ein SCO berpr fen 1 Rufen Sie permissions info mit einer acl id und einer principal id auf https example com api xml action permissions info amp acl id 2006334909 amp principal id 2006258745 Bei der berpr fung der Berechtigungen f r ein SCO ist die acl id eine sco id Bei der acl id kann es sich auch um eine principal id oder eine account id handeln Werten Sie die Antwort nach permission id aus lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt permission acl id 2007035246 permission id view principal id
51. auswirken kann m Sie k nnen die sco id Ihres speziellen Schulungsordners aber auch aus der URL in Enterprise Manager entnehmen und dann an sco contents bergeben 4 Werten Sie die Antwort nach der sco id des gew nschten Schulungsordners aus lt sco sco id 2007122244 source sco id folder id 624528 type folder icon folder display seq 0 is folder 1 gt 5 Rufen Sie sco contents auf bergeben Sie die sco id des betreffenden Schulungsordners und f gen Sie einen Filter hinzu mit dem Sie den Kurs oder Studienplan bestimmen https example com api xml action sco contents amp sco id 2007122244 amp filter name Java 201 m An Stelle von sco expanded contents k nnen Sie auch sco contents verwenden sofern alle Kurse und Studienpl ne auf der obersten Ebene Ihres Schulungsordners gespeichert sind Die Systemleistung wird dadurch erh ht 74 Kapitel 5 Schulungen m Durch das Anlegen benutzerdefinierter Felder f r Ihre SCOs schaffen Sie eine weitere M glichkeit nach diesen Objekten zu suchen Weitere Hinweise hierzu finden Sie im Abschnitt Benutzerdefinierte Felder erstellen 6 Durchsuchen Sie die sco Elemente der Antwort nach der sco id des gew nschten Kurses oder Studienplans lt sco depth 2 sco id 2006745673 folder id 2006745671 type content icon course lang en source sco id 2006744233 display seq 1 source sco type 0 gt lt name gt All About Web Communities lt name gt lt url path gt
52. ckgeben sollen tats chlich aber mehrere Ergebnisse zur ckgibt Wenn ein Aufruf den Status invalid zur ckgibt enth lt die Antwort ebenfalls ein invalid Element das anzeigt welcher Anforderungsparameter fehlt oder ung ltig ist lt xml version 1 0 encoding utf 8 gt lt results gt lt status code invalid gt lt invalid field has children type long subcode missing gt lt status gt lt results gt Beim Statuscode no access wird im Attribut subcode erkl rt warum dieser Fehler aufgetreten ist lt xml version 1 0 encoding utf 8 gt lt results gt lt status code no access subcode denied gt lt results gt Alle g ltigen Werte von code subcode und invalid werden in der API Referenz im Abschnitt status beschrieben Ihre Anwendung muss also die Statuscodes und Untercodes verarbeiten k nnen Statuscodes verarbeiten 1 Schreiben Sie eine Methode die die XML API Antwort nach den Statuswerten von code und subcode analysiert Ein Java Beispiel k nnte so aussehen private String getStatus Element el throws JDOMException String code codePath valueOf el String subcode subcodePath valueOf el StringBuffer status new StringBuffer 34 Kapitel 2 Anmeldung und Anforderungen if null code amp amp code length gt 0 status append code if null subcode amp amp subcode length gt 0 status append subcode return status toString 2 Durchsuchen Sie
53. date created gt 2006 05 11T12 02 01 470 07 00 lt date created gt lt row gt lt row transaction id 2006334916 principal id 123456 gt lt page gt 0 lt page gt lt date created gt 2006 05 11112 02 01 487 07 00 lt date created gt lt row gt lt report bulk slide views gt lt results gt Siehe auch report bulk objects report bulk questions report bulk consolidated transactions report bulk users 158 Kapitel 6 Aktionsreferenz report bulk users Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Gibt Informationen ber alle Benutzer in einem Konto zur ck Der Unterschied zwischen diesem Aufruf und principal 1ist besteht darin dass principal 1ist sowohl Benutzer als auch Gruppen zur ckgibt w hrend report bulk users nur die Benutzer anzeigt Da die Antwort von report bulk users besonders bei Verwendung benutzerdefinierter Felder sehr umfangreich werden kann sollten Sie sie ggf filtern und sortieren So gibt der folgende Aufruf beispielsweise alle Benutzer mit den Buchstaben Jo im Namen in alphabetischer Reihenfolge zur ck http myserver com api xml action report bulk users amp sort name asc amp filter like name Jo Wenn custom fields true bergeben wird gibt der Aufruf von report bulk users unter Umst nden bis zu acht benutzerdefinierte Felder zur ck die f r Benutzer angelegt wurden Sollten Sie f r Ihre Benutzer mehr als acht eigene Felder definiert haben werden beim Aufru
54. den ref count des SCOs berpr fen Dabei handelt es sich um die Anzahl anderer SCOs die dieses SCO referenzieren Falls das SCO keine Referenz hat k nnen Sie es v llig problemlos entfernen Der Server belegt den Speicherplatz neu Gibt es dagegen Referenzen f r das SCO kann es sein dass nach dem L schen die Referenz auf die SCOs nicht mehr funktioniert der Server den Speicherplatz nicht mehr belegen kann oder beides Wenn beispielsweise ein Kurs eine Quizpr sentation referenziert und diese Pr sentation gel scht wird kann auch der Kurs nicht mehr gestartet werden Bei einem anderen Beispiel k nnte ein Meeting ein Material SCO verwendet haben beispielsweise eine Pr sentation oder ein Video Hier gibt es eine Referenz vom Meeting zum SCO Durch das L schen des Material SCOs wird kein Speicherplatz freigegeben weil das Meeting noch immer darauf verweist Um ein SCO l schen zu k nnen ben tigen Sie zumindest manage Berechtigung weitere Hinweise finden Sie im Abschnitt permission id Benutzer die der integrierten Gruppe authors zugewiesen sind haben manage Berechtigung f r ihre eigenen Materialordner Damit k nnen Sie auch die enthaltenen Materialien l schen 232 Kapitel 6 Aktionsreferenz Anforderungs URL http server_name api xml action sco delete amp sco id integer amp session value Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung des SCOs session Zeic
55. der Teilnehmer und Moderatoren k nnen Sie allen Beteiligten nun die entsprechenden Einladungen per E Mail zusenden Zum Senden der Meetingeinladungen ben tigen Sie zun chst die Meetingdaten also den Namen des Meetings und des Veranstalters sowie dessen E Mail Adresse Au erdem die URL des Meetingraums Datum und Uhrzeit des Beginns und schlie lich den Namen und die E Mail Adresse des Moderators Bei der Erstellung der E Mail Nachricht k nnen Sie jedes beliebige Verfahren anwenden das Ihre Benutzeroberfl che zul sst Mithilfe der folgenden Schritte k nnen Sie die ben tigten Informationen zum Meeting erhalten Eine E Mail an die Teilnehmer senden 1 Rufen Sie sco info mit der sco id des Meetings auf https example com api xml action sco info amp sco id 2006334033 2 Werten Sie die Antwort nach dem Meetingnamen den Daten oder nach anderen Werten aus lt sco account id 624520 disabled display seq 0 folder id 2006258750 icon meeting lang en max retries sco id 2007063163 source sco id 1625529 type meeting version 0 gt lt date begin gt 2006 08 15T09 00 00 000 07 00 lt date begin gt lt date created gt 2006 07 277T15 30 43 220 07 00 lt date created gt lt date end gt 2006 08 15T18 00 00 000 07 00 lt date end gt lt date modified gt 2006 07 271T15 30 43 220 07 00 lt date modified gt lt name gt August All Hands Meeting lt name gt lt url path gt august lt url path gt lt sco gt 3 Erste
56. die Ebene eines SCOs in der Ordnerhierarchie relativ zum abgefragten SCO an 0 f r das abgefragte SCO selbst 1 f r die dar ber liegende Ebene etc Die Werte werden gr er je weiter oben in der Hierarchie das aktuelle SCO gespeichert ist Zeichenfolge Der Name des SCOs Beispielanforderung https example com api xml action sco nav amp sco id 2006334909 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt sco nav gt lt sco sco id 624522 type folder icon folder depth 2 gt lt name gt User Content lt name gt lt sco gt lt Sco lt n lt sc lt Sco lt lt sc lt sco sco id 2006258747 type folder icon folder depth 1 gt ame gt joy acme com lt name gt o gt sco id 2006334909 type content icon producer depth 0 gt ame gt Test Quiz lt name gt o gt av gt lt results gt sco nav 245 Siehe auch sco move sco search Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt eine Liste aller SCOs bereit die den Suchtext enthalten Mit der Aktion sco search werden der Titel und die Zusammenfassung der SCOs nach der Suchzeichenfolge durchsucht Falls es sich bei dem SCO um eine Pr sentation handelt oder das SCO Text enth lt wird mit sco search auch der Inhalt durchsucht Diese Aktion durchsucht nur bestimmte Materialtypen wie Pr sentationen und Meetingarchive Andere
57. example com employeeMeeting onClick javascript window open http example com employeeMeeting session breezbityp829r9ozv5rd Breeze toolbar no menubar no width 800 height 600 resizable yes return false gt http example com employeeMeeting lt a gt Ein Meeting starten und den Benutzer als Gast eintreten lassen 1 Sobald der Benutzer in Ihrem Netzwerk authentisiert ist k nnen Sie ihn an Connect Enterprise anmelden Hinweise hierzu finden Sie im Abschnitt Mit einer HTTP Header Authentisierung anmelden Lesen Sie den Wert des Cookies BREEZESESSION f r diese Benutzersitzung aus Sie haben hierf r zwei M glichkeiten Rufen Sie common info auf und lesen Sie aus der Antwort den Wert von cookie aus lt cookie gt breezma6zor9rdfps8h6a lt cookie gt a Rufen Sie login auf und extrahieren Sie den Wert des Cookies BREEZESESSION aus dem Antwort Header Set Cookie BREEZESESSION breezqw4vtfarqxvf9pk2 domain macromedia com path Erstellen Sie in der Anwendung eine Meetingraum URL Hinweise hierzu finden Sie im Abschnitt Meetingraum URL s erstellen F gen Sie den Parameter guestname und den Anzeigenamen des Benutzers als Gast an die Meetingraum URL an http example com employeeMeeting guestName joy ffnen Sie die Meetingraum URL mit dem guestname Parameter Eine M glichkeit hierzu ist der JavaScript Befehl onClick lt a href http example com employeeMeeting onClick java
58. gt lt row gt Principals oder G ste auflisten 39 Benutzer erstellen Sie ben tigen Administratorrechte um neue Benutzer erstellen zu k nnen Adobe empfiehlt dass Sie einen Benutzer erstellen und ihn der admins Gruppe Ihrer Anwendung zuweisen Mit diesem Benutzer k nnen Sie dann die API Aufrufe ausf hren f r die Administratorberechtigungen erforderlich sind Neue Benutzer erstellen und Willkommens E Mails senden 1 Melden Sie sich an Ihre Anwendung mit Administratorrechten an Informationen zu unterschiedlichen Anmeldeverfahren finden Sie im Abschnitt Aus einer Anwendung heraus anmelden Rufen Sie principal update auf Verwenden Sie dabei mindestens die folgenden Parameter https example com api xml action principal update Afirst name jazz amp last name doedlogin jazz99 doe com amp password hello amp type user send email true amp has children 0 amp email jazz99 doe com type muss dabei user sein has children den Wert 0 oder false haben send email auf true eingestellt sein und email eine g ltige E Mail Adresse enthalten Der Server sendet eine Willkommens E Mail mit den angegebenen Anmeldedaten an die E Mail Adresse des Benutzers Durchsuchen Sie die principal Elemente der Antwort nach der principal iddes Benutzers lt principal type user principal id 2007184341 has children 0 account id 624520 gt lt login gt jammdoe example com lt login gt lt ext login gt jammdoe example c
59. gt 2006 08 031T12 34 04 093 07 00 lt date closed gt lt row gt Berechnen Sie in Ihrer Anwendung die Zeitdifferenz zwischen diesen beiden Werten In Java k nnen Sie beispielsweise eine Utility Methode schreiben mit der Sie die ISO 8601 Datums und Uhrzeitwerte der Antwort in ein Gregori anCal endar Objekt umwandeln Sie k nnen dann jedes GregorianCalendar Datum in Millisekunden umwandeln die Differenz zwischen Erstellung und Abschluss berechnen und diesen Wert dann wieder in Minuten ausdr cken Wiederholen Sie dieses Verfahren f r alle Meetingtransaktionen die den Kriterien entsprechen und addieren Sie die Nutzungszeiten Informationen zu den gleichzeitigen Meetingteilnehmern abrufen 1 Rufen Sie report quotas auf um Ihre Kontingente f r gleichzeitige Meetingteilnehmer zu berpr fen https example com api xml action report quotas Analysieren Sie die Antwort des quota Elements Werten Sie das Feld quota id nach dem Attribut concurrent user per meeting quota aus und erfassen Sie den Wert von soft limit lt quota acl id 624529 quota id concurrent user per meeting quota used 0 limit 2500 soft limit 2500 gt lt date begin gt 2004 03 09T09 45 02 297 08 00 lt date begin gt lt date end gt 2999 12 31T16 00 00 000 08 00 lt date end gt lt quota gt Dabei ist soft 1imit die von Ihrer Connect Enterprise Lizenz festgelegte Obergrenze Bei limit handelt es sich um den Wert bei dem Connect Enterprise keine
60. in einen anderen Ordner Um ein SCO in einen anderen Ordner zu verschieben muss der aktuelle Benutzer die Berechtigung zum Erstellen von Materialien im Zielordner haben Im Allgemeinen haben die Benutzer in der Standardkonfiguration nur die Berechtigung f r ihre eigenen Ordner also beispielsweise f r my meetings my courses my events my content und my meeting templates Um ein SCO in einen der gemeinsamen Ordner zu verschieben wie content courses oder meetings muss der Benutzer ber Verwaltungsberechtigung verf gen oder ein Administrator sein Anforderungs URL http server_name api xml action sco move amp folder id integer amp sco id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung folder id Ganzzahl J Die Kennung des Zielordners sco id Ganzzahl J Die eindeutige Kennung des SCOs das verschoben werden soll session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt results gt 242 Kapitel 6 Aktionsreferenz Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attr
61. lt report bulk slide views gt lt row transaction id integer principal id integer gt lt page gt integer lt page gt lt date created gt datetime lt date created gt lt row gt lt report bulk slide views gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status report bulk slide Container Die vollst ndige Liste aller views Folienanzeigen die den Bedingungen der Anforderung entsprechen report bulk slide views 157 Element Attribut Typ Beschreibung row Container Informationen zur Anzeige einer Folie transaction id Ganzzahl Die Kennung der Interaktion zwischen dem Benutzer und der Folie principal id Ganzzahl Die Kennung des Benutzers der die Folie angezeigt hat page Ganzzahl Die Nummer der Folie in der Pr sentation date created Datetime Das Datum und die Uhrzeit der Datum Uhrzeit Anzeige Beispielanforderung https example com api xml action report bulk slide views amp filter principal id 123456 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report bulk slide views gt lt row transaction id 2006334916 principal id 123456 gt lt page gt 0 lt page gt lt
62. nach dem die Ergebnisse sortiert werden sollen Die Felder die Sie verwenden k nnen sind aktionsbezogen berpr fen Sie die API Referenz und sichen Sie nach dem gew nschten Aufruf sort definition 271 value ist entweder asc f r eine aufsteigende oder desc f r eine absteigende Sortierung Auf diese Weise k nnen Sie die Reihenfolge der Ergebnisse festlegen Die folgende Tabelle enth lt eine bersicht ber die Bestandteile eines Sortfilters Sortiertyp Feld Wert Beschreibung sort Je nach Aufruf asc oder desc Sortiert die Ergebnisse nach dem unterschiedlich angegebenen Feld entweder in aufsteigender oder in absteigender Reihenfolge sortl Je nach Aufruf asc oder desc Sortiert die Ergebnisse nach dem unterschiedlich angegebenen Feld entweder in aufsteigender oder in absteigender Reihenfolge und bergibt die Ergebnisse an die n chste Sortierung sort2 Je nach Aufruf asc oder desc Sortiert gleiche Ergebnisse aus einer unterschiedlich ersten Sortierung wie z B ein Name oder eine Gruppe erneut nach dem angegebenen Feld entweder in aufsteigender oder in absteigender Reihenfolge Einfache Beispiele mit sort field value und nur einer Sortierung sind beispielsweise die folgenden sort name asc sort date desc Die folgende Tabelle enth lt Informationen zur Sortierung anhand der Werte asc und desc Wert Beschreibung asc Aufsteigende Reihenfolge Bei alphabetischen Listen beginnt die Sortierung mit
63. name Zeichenfolge Lernziele eines Studienplans Die numerische Kennung des Studienplans Das Lernobjekt dessen Lernziel Sie anzeigen m chten Die Kennung des Lernobjekts das den Zugang zum aktuellen Lernobjekt verwehrt beispielsweise ein Lernobjekt das als Voraussetzung f r ein anderes Lernobjekt definiert wurde Der Typ des Lernziels zwischen dem Ziel und dem aktuellen Lernobjekt z B ob der Abschluss des Ziellernobjekts eine Voraussetzung f r das aktuelle Lernobjekt darstellt Zul ssige Werte finden Sie im Abschnitt path type Der Name des Ziellernobjekts Beispielanforderung https example com api xml action learning path info amp sco id 2006334909 amp curriculum id 2006298444 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt learning paths gt lt learning path curriculum id 2006298444 current sco id 2006298444 target sco id 2006298445 path type completion required gt lt name gt Security at AcmeCo lt name gt learning path info 113 lt learning path gt lt learning paths gt lt results gt Siehe auch learning path update learning path update Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Aktualisiert das Lernziel f r ein einzelnes Lernobjekt in einem Studienplan Ein Lernobjekt ist ein beliebiges SCO das einem Studienplan hinzugef gt wurde Anforderungs URL h
64. principal gt Alle Gruppenmitgliedschaften eines Benutzers berpr fen 1 Rufen Sie principal 1ist mit der principal id des Benutzers und filter is member true auf https example com api xml action principal list amp principal id 2006258745 filter is member true Werten Sie die Antwort nach den principal Elementen aus lt principal principal id 5698354 account id 624520 type group has children true is primary false is hidden false gt lt name gt Bob Jones lt name gt lt login gt bobjones acme com lt login gt lt is member gt true lt is member gt lt principal gt SCOs suchen Samtliche auf Connect Enterprise gespeicherten Objekte sind Sharable Content Objects SCOs Dabei stammt das Wort Shareable von Learning Management Systemen bei denen die Materialien in Kursen oder Studienpl nen kombiniert und gemeinsam genutzt werden k nnen Auf dem Server kann ein SCO ein beliebiges Materialobjekt sein das mit anderen Materialobjekten zu einem Kurs oder Studienplan zusammengefasst wurde SCOs k nnen also Kurse Studienpl ne Pr sentationen und andere Materialtypen sein Aber auch Meetings Veranstaltungen Ordner und Ordnerstrukturen Links Grafikdateien und andere Objekte k nnen SCOs sein Jedes SCO hat eine eindeutige Kennung die als sco id bezeichnet wird Diese sco id ist auf dem ganzen Server eindeutig Bei Hosted Konten ist eine sco id konten bergreifend eindeutig Jed
65. r SCOs keine objektorientierte Struktur und ein SCO Typ ist keine Unterklasse eines anderen Typs Dies sollten Sie bei der Entwicklung Ihrer Anwendung ber cksichtigen Aufbau einer Adapter Klasse Die entsprechenden Beispieldateien sind XMLApiAdapter java login jsp und mymeetings jsp SISMNIH Bei der Entwicklung einer benutzerdefinierten Anwendung mit der Connect Enterprise aufgerufen werden kann ist es sinnvoll eine Adapter Klasse anzulegen Damit k nnen Sie f r jede Anmeldesitzung eines Benutzers eine Instanzklasse erstellen Der Adapter verwaltet die Verbindung zum Server meldet den Benutzer an ruft die Anforderungen an die XML API auf und wertet die XML Antworten aus Konstrukturen f r die Adapter Klasse schreiben Der folgende Konstruktor aus der Datei des Anwendungsbeispiels XMLApiAdapter java erstellt eine Instanz der Adapter Klasse mit der ein auf Connect Enterprise zugreifender Benutzer dargestellt wird Es handelt sich dabei um den Konstruktor den Sie verwenden k nnen wenn Sie bereits ber einen Cookie Wert von BREEZESESSION verf gen siehe Aus einer Anwendung heraus anmelden Dieser Konstruktor ruft au erdem die Methode createXPaths auf mit der g ltige XPath Instanzen erstellt und in anderen Methoden verwendet werden k nnen public XMLApiAdapter String baseUrl String breezesession throws XMLApiException this setBaseUrl baseur this breezesession breezesession createXPaths
66. report meeting attendance ben tigen Sie publish mini host oder host Berechtigung f r das Meeting weitere Einzelheiten finden Sie im Abschnitt permission id Anforderungs URL http server_name api xml action report meeting attendance amp sco id integer amp filter definition value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung des Meetings session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren report meeting attendance 171 Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report meeting attendance gt lt row transcript id integer sco id integer principal id integer answered survey boolean gt lt login gt string lt login gt lt session name gt string lt session name gt lt sco name gt string lt sco name gt lt date created gt datetime lt date created gt lt date end gt datetime lt date end gt lt participant name gt string lt participant name gt lt row gt lt report meeting attendance gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Ak
67. results gt principals delete 139 Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Attributen Der Status der Antwort code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Beispielanforderung https example com api xml action principals delete amp principal id 2006339311 amp principal id 2006339323 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Siehe auch principal info principal list principal list by field principal update principal update Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Erstellt bzw aktualisiert einen Benutzer oder eine Gruppe Der Benutzer bzw die Gruppe also der Principal wird in dem Konto erstellt bzw aktualisiert mit dem die Aktion aufgerufen wurde Um einen neuen Principal zu erstellen rufen Sie die principal update ohne den Parameter principal id auf F r eine Aktualisierung m ssen Sie auch die principal id angeben Bevor Sie aber die Metadaten zu einem Principal aktualisieren k nnen m ssen Sie dessen aktuellen Informationen mithilfe von principal info abrufen Wenn die Informationen eines Principals auch aus benutzerdefinierten Feldern bestehen m ssen Sie anstelle von principal update die Aktion ac fiel
68. ssen Sie eine Download URL der ZIP Datei erstellen Diese sieht etwa so aus http server domain url path output url path zip download zip Wahrscheinlich kennen Sie bereits den Dom nennamen Ihres Servers wie example com Sollte dies nicht der Fall sein k nnen Sie ihn mithilfe eines Aufrufs von sco shortcuts ermitteln Dateien herunterladen 49 Eine ZIP Datei von einem Server herunterladen 1 Rufen Sie sco shortcuts auf https example com api xml action sco shortcuts 2 Extrahieren Sie s mtliche domain name Werte aus der Antwort http example com 3 Rufen Sie sco info mit der sco id der ZIP Datei auf https example com api xml action sco info amp sco id 2006258747 Dieses SCO ist die gesamte ZIP Datei 4 Werten Sie die Antwort nach dem ur path Element aus lt sco account id 624520 disabled display seq 0 folder id 624522 icon folder lang en max retries sco id 2006258747 source sco id type folder version 1 gt lt date created gt 2006 04 18T10 21 47 020 07 00 lt date created gt lt date modified gt 2006 04 18T10 21 47 020 07 00 lt date modified gt lt name gt joy acme com lt name gt lt url path gt f124567890 lt url path gt lt sco gt 5 Erstellen Sie die Download URL zum Beispiel https example com quiz output quiz zip download zip L schen Sie auf jeden Fall beim Wert von ur path den nachfolgenden Schr gstrich bevor Sie die Dateiendung zip anh ngen damit Sie einen
69. ssige Werte finden Sie im Abschnitt permission id acl id Ganzzahl Die Kennung des SCOs f r das die Berechtigung definiert wird name Zeichenfolge Der Name des Principals der die Berechtigung zum Zugriff auf das SCO hat login Zeichenfolge Der Anmeldename des Principals der die Berechtigung zum Zugriff auf das SCO hat Beispielanforderung https example com api xml action permissions info amp acl id 2006334033 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt permissions gt lt principal principal id 2006258745 is primary false type user has children false permission id host gt lt name gt Joy Smith lt name gt lt login gt joy acme com lt login gt lt principal gt lt permissions gt lt results gt Siehe auch permissions reset permissions update permissions info 123 permissions reset Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Setzt alle Berechtigungen s mtlicher Principals f r ein SCO auf die Berechtigungen des bergeordneten SCOs zur ck Wenn f r das bergeordnete Objekt keine Berechtigungen festgelegt wurden gibt es f r das untergeordnete SCO auch keine Berechtigungen Anforderungs URL http server_name api xml action permissions reset amp acl id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung acl id Gan
70. teilweiser Namensfilter z B fil ter 1ike name wenn Sie den genauen Namen des SCOs nicht kennen Allerdings kann die Verwendung dieses Filters die Systemleistung negativ beeinflussen Werten Sie die Antwort nach sco id aus lt sco depth 1 sco id 2006745671 folder id 2006258748 type folder icon folder lang en source sco id 2006745669 display seq 0 source sco type 14 gt lt name gt A Day in the Life Resources lt name gt lt url path gt f28435879 lt url path gt lt date created gt 2006 06 127T14 47 59 903 07 00 lt date created gt lt date modified gt 2006 06 12T14 47 59 903 07 00 lt date modified gt lt sco gt Informationen ber ein SCO abrufen 1 Rufen Sie sco info mit der sco id auf https example com api xml action sco info amp sco id 2006745669 2 Werten Sie die Antwort nach name url path oder einem anderen Wert aus lt sco account id 624520 disabled display seq 0 folder id 2006258748 icon curriculum lang en max retries sco id 2006745669 source sco id type curriculum version 0 gt lt date begin gt 2006 06 12T14 45 00 000 07 00 lt date begin gt lt date created gt 2006 06 12T14 47 59 903 07 00 lt date created gt lt date modified gt 2006 06 12T14 47 59 903 07 00 lt date modified gt lt name gt A Day in the Life lt name gt lt url path gt day lt url path gt lt sco gt 48 Kapitel 3 Grundlagen Die URL eines SCOs erstellen 1 Rufen Sie sco shortc
71. value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung value Zeichenfolge J Der Wert nach dem alle Felder durchsucht werden sollen Ein Feldname braucht dabei nicht eingegeben zu werden session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt principal list gt lt principal account id integer principal id integer type allowedValue has children boolean is primary boolean is hidden boolean gt lt name gt string lt name gt lt login gt string lt login gt lt principal gt lt principal list gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden 136 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung status code principal list principal principal id account id type has children is primary is hidden name login Leer mit Attributen Zul ssiger Wert Container Container Ganzzahl Ganzzahl Zul ssiger Wert Boolescher Wert Boolescher Wert Boolescher Wert Zeichenfolge Zeichenfolge Der Status der
72. 07018414 Sie brauchen aber eigentlich die genaue Berechtigung des Principals zur Teilnahme am Meeting erst dann zu wissen wenn Sie diese Berechtigung entfernen m chten 2 Rufen Sie die sco id des betreffenden Meetings ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Meetings suchen Benutzer aus Meetings entfernen 63 3 Rufen Sie die principal id des betreffenden Benutzers ab entsprechende Hinweise finden Sie im Abschnitt Die principal id suchen 4 Rufen Sie permissions update mit der sco id des Meetings als acl id und permission id remove auf https example com api xml action permissions update amp acl id 2007018414 amp principal id 2006258745 amp permission id remove Die Meetingnutzung berechnen Wenn Sie Benutzer und Acrobat Connect Professional Meetings erstellen m ssen Sie ggf auch die Meetingnutzung kennen Diese Meetingnutzung wird h ufig auf eine der folgenden Weisen errechnet m Die Zeit die ein Benutzer in einem bestimmten Meeting verbringt in Minuten pro Benutzer m Die Anzahl der gleichzeitigen Meetingteilnehmer Die Zeit die ein Benutzer in einem Meeting verbringt wird mithilfe einer Transaktion gemessen das hei t anhand der Interaktion zwischen Principal und SCO also in diesem Fall zwischen Benutzer und Meeting Das Datum und die Uhrzeit des Beginns und des Endes einer Transaktion werden von report bulk consolidated transactions zur ckgegeben Die Anzahl der maxi
73. 1T17 32 53 970 07 00 lt date created gt lt description gt report quiz interactions 197 The governor of California is a former actor lt description gt lt response gt false lt response gt lt row gt lt row display seq 2 transcript id 2006335954 interaction id 2006334914 sco id 2006334909 score 10 gt lt name gt Joy Smith lt name gt lt sco name gt California Quiz sco name gt lt date created gt 2006 05 12T11 55 24 940 07 00 lt date created gt lt description gt The governor of California is a former actor lt description gt lt response gt true lt response gt lt row gt lt report quiz interactions gt lt results gt report quiz question answer distribution Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt Informationen zu der Anzahl der Benutzer zur ck die auf eine Quizfrage eine bestimmte Antwort gegeben haben Die Kombination von einer Quizfrage und s mtlichen Antworten eines Benutzers wird als Interaktion bezeichnet Wenn der Benutzer eine bestimmte Frage mehrmals beantwortet werden alle Antworten ein und derselben Interaktion zugewiesen und erhalten damit auch die gleiche interaction id Mithilfe von report quiz interactions k nnen Sie eine interaction id feststellen die Sie dann in der Anforderung angeben k nnen Die interaction id entspricht dabei aber nicht der Nummer der Quizfrage also Frage 1 Frage 2 etc Anforderungs URL http s
74. 3 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt my courses gt lt course sco id 2006298431 type content icon course permission id view gt lt name gt Test Course lt name gt lt url gt example com test lt url gt lt date created gt 2006 05 03T10 21 46 810 07 00 lt date created gt lt date modified gt 2006 05 03T10 22 30 803 07 00 lt date modified gt lt date begin gt 2006 05 03T10 15 00 000 07 00 lt date begin gt lt url path gt test lt url path gt lt expired gt false lt expired gt lt completed gt false lt completed gt lt course gt lt my courses gt lt results gt report my events Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Stellt Informationen zu jeder Veranstaltung bereit an der der aktuelle Benutzer teilgenommen hat oder f r eine Teilnahme vorgesehen ist Bei dem Benutzer kann es sich entweder um einen Veranstalter oder einen Teilnehmer handeln Die zur ckgegebenen Veranstaltungen sind die Veranstaltungen die im Ordner my events Meine Veranstaltungen des Benutzers gespeichert sind Wenn Sie Informationen zu allen Veranstaltungen ben tigen die auf Ihrem Enterprise Server oder in Ihrem Enterprise Hosted Konto gespeichert sind rufen Sie sco shortcuts auf um die sco id des Ordners events abzurufen Rufen Sie danach sco contents mit der sco id auf um alle Veranstaltungen auf
75. 6 Meetings Java Beispiel 300 Principals 39 Authentisierung extern 28 68 B Benutzer aktualisieren 41 alle Gruppen auflisten 45 aus Kursen und Studienplanen entfernen 80 aus Meetings entfernen 63 einem Meeting hinzuf gen 55 einer Gruppe zuweisen 43 eingeschriebene Benutzer anzeigen 82 einschreiben 77 erstellen 40 erstellen ohne Angabe der E Mail Adresse 40 Fortschritt im Studienplan anzeigen 83 Gruppenmitgliedschaft berpr fen 43 44 h chste Punktzahl angeben 84 Meetingeinladungen senden 61 Meetings anzeigen 55 Schulung anzeigen 76 suchen principal id 38 zu Meetings einladen 61 Benutzer aus Kursen und Studienpl nen entfernen 80 Benutzerdaten abrufen 299 anzeigen 298 benutzerdefinierte Anwendungen 16 Datenfluss 16 Sprachen 8 308 Index benutzerdefinierte Felder f r Benutzer 42 erstellen Feldelement 276 Typen 290 berechnen Meetingnutzung 64 Berechtigungen 50 Definition 280 Einstellungen f r Meetings 303 f r Principals berpr fen 51 f r SCOs berpr fen 51 Kursteilnehmer 72 Schulungsbibliothek 72 Berechtigungen der Schulungsbibliothek 72 Berechtigungen f r Kursteilnehmer 72 BREEZESESSION in einer Adapter Klasse 293 from common info 68 von common info 25 mit Cookie Management 24 im JSP Attribut session speichern 293 at logout 35 in response header 25 68 von common info 69 zur cksetzen 35 C common info 97 Browsertests 18 example 38 Java Beispiel 299 vor der Anmeld
76. 7 Tipps und Schulung a 44 322544 tenia e RT 7 Entwicklungsumgebung 0 2 e eee e eens 8 Neu in diesem Handbuch ccc cece cece eet nenne nen 9 Weitere Ressourcen 2 1 cece eet eee e nnn nee ennes 9 KOAVENTIONEN 055 44 sone ek ade ee obs Bete enabled n Kapitel 1 Architektur 0 000 000 cece es 13 Datentluss ren ae A E Fea EE 14 Ihre ersten API Aufrufe 00 cece cee cece t ene 18 Kapitel 2 Anmeldung und Anforderungen 23 Aus einer Anwendung heraus anmelden 2222222 23 Eine Anforderung in einem XML Dokument senden 32 Eine Antwort mit XPath analysieren 00 0000 cee eens 33 Antworten nach Fehlermeldungen durchsuchen 34 Einen Benutzer abmelden 000 cee cee cent nennen 35 Kapitel 3 Grundlagen 000 cece es 37 Die principal id SUCHEN 0 eee eens 38 Principals oder G ste auflisten nann annann annann nananana 39 Benutzer erstellen 2 0 0 0 0 ccc cece ne eee teen een nennen 40 Benutzer aktualisieren 0 0 ccc eee teen eens 41 Benutzerdefinierte Felder erstellen 0000 c cece een eeee 42 Gr ppen erstellen a BER 43 SCOS S chen aus ee Reden 45 Dateien herunterladen 0 0 ccc cent eee teen ene 49 Berechtigungen Uberpriifen 2 0 0 ccc cee eee eee 50 Kapitel 4 Meetings 000 cece ee 53 Meetings SUCHEN wu 2 an et ates bin base a es 53 Meetings anzeigen
77. 745 interaction id 2006334913 gt lt user name gt Joy Smith lt user name gt lt response gt Sacramento lt response gt lt date created gt 2006 05 11T15 50 23 643 07 00 lt date created gt lt row gt lt row principal id 2006258745 interaction id 2006334913 gt lt user name gt Joy Smith lt user name gt lt response gt san francisco lt response gt lt date created gt 2006 05 11T17 32 53 970 07 00 lt date created gt lt row gt lt row principal id 2006258745 interaction id 2006334913 gt lt response gt Sacramento lt response gt lt date created gt 2006 05 12T11 55 24 940 07 00 lt date created gt lt row gt 206 Kapitel 6 Aktionsreferenz lt report quiz question response gt lt results gt report quiz summary Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt eine Zusammenfassung der Daten zu einem Quiz bereit Zu den Informationen geh ren die Anzahl der Versuche das Quiz zu beantworten die mittleren h chsten und niedrigsten Punktzahlen sowie andere Informationen Anforderungs URL http server_name api xml action report quiz summary amp sco id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung einer Pr sentation die ein Quiz enth lt session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung k
78. 78 lt url path gt lt description gt test lt description gt lt date created gt 2006 06 12T14 48 25 980 07 00 lt date created gt lt date modified gt 2006 06 12T14 48 25 980 07 00 lt date modified gt lt sco gt Die Antwort listet die oberste Ebene der sco Elemente auf Sie k nnen aber mit diesen drei Werten auch die ganze Hierarchie der Objekte anzeigen Das SCO mit type curriculum ist der bergeordnete Studienplan der die Kurse enth lt In diesem Fall dient der Studienplan als Ordner Abgeschlossene und verbleibende Kurse eines Benutzers in einem Studienplan anzeigen 1 Rufen Sie die sco id des betreffenden Studienplans ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Kurses oder Studienplans suchen Rufen Sie die principal id des betreffenden Benutzers ab entsprechende Hinweise finden Sie im Abschnitt Die principal id suchen Rufen Sie report curriculum taker auf und bergeben Sie die principal idals user id https example com api xml action report curriculum taker amp user id 2006258745 amp sco id 2006745669 Studienplaninformationen anzeigen 83 4 Werten Sie die Antwort des Attributs status jedes sco Elements aus sowie alle anderen Werte die Sie in Ihrer Anwendung anzeigen m chten lt sco transcript id 2006745722 path type prereq none asset id sco id 2006745674 depth 1 folder id 2006745669 type 15 icon course lang en max retries source sco id
79. 8 gt lt results gt lt status code ok gt lt my events gt lt event sco id 2006334107 type event icon event permission id host gt lt name gt Meet the Famous Author lt name gt lt domain name gt example com lt domain name gt lt url path gt author lt url path gt lt date begin gt 2006 05 12T18 00 00 000 07 00 lt date begin gt lt date end gt 2006 05 12T20 00 00 000 07 00 lt date end gt lt expired gt true lt expired gt lt duration gt 02 00 00 000 lt duration gt lt event gt lt my events gt lt results gt report my meetings Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt Informationen zu allen Acrobat Connect Meetings bereit bei denen der Benutzer ein Veranstalter ein eingeladener Teilnehmer oder ein registrierter Gast ist Das Meeting kann f r die Vergangenheit die Gegenwart oder die Zukunft geplant sein Anforderungs URL http server_name api xml action report my meetings amp filter definition value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt report my meetings 187 Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt x
80. 9 amp object type object type principal Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Siehe auch custom field update custom field update Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Erstellt ein neues benutzerdefiniertes Feld oder aktualisiert den Wert eines vorhandenen Felds Sie k nnen bis zu acht Felder f r einen Principal oder ein SCO definieren Rufen Sie custom field update mit wenigstens den folgenden Feldern auf um ein benutzerdefiniertes Feld zu erstellen object type permission id name field type is required und is primary Wenn custom field update erfolgreich aufgerufen werden kann wird die field id zur ckgegeben Wenn Sie ein benutzerdefiniertes Feld aktualisieren m chten m ssen Sie die field id einen Wert f r object type und einen f r name der Felder angeben deren Werte Sie ndern m chten custom field update 105 Gehen Sie beim Anlegen benutzerdefinierter Felder umsichtig vor da die Abfrage solcher Felder in einem Bericht z B durch einen Aufruf von report bulk users unter Umst nden die Leistung des Servers und der Datenbank beeintr chtigen kann Anforderungs URL http server_name api xml action custom field update amp account id integer amp object type object type allowedValue amp permission id allowedValue amp name string amp comments string amp field type
81. ADOBE CONNECT ENTERPRISE ADOBE CONNECT ENTERPRISE WEB SERVICES AI Adobe 2006 Adobe Systems Incorporated Alle Rechte vorbehalten Adobe Connect Enterprise Web Services Falls dieses Handbuch im Lieferumfang einer Software enthalten ist die im Rahmen einer Endbenutzerlizenzvereinbarung bereitgestellt wird so wird dieses Handbuch ebenso wie die hierin beschriebene Software im Rahmen der Lizenz bereitgestellt und darf nur gem den Bestimmungen dieser Lizenz verwendet oder kopiert werden ber die Bestimmungen dieser Lizenz hinaus darf kein Teil dieses Handbuchs ohne vorherige schriftliche Genehmigung durch Adobe Systems Incorporated vervielf ltigt in Retrieval Systemen gespeichert oder in irgendeiner Form bzw auf irgendeine Weise sei es elektronisch mechanisch durch Aufzeichnung oder auf andere Weise bermittelt werden Beachten Sie hierbei dass der Inhalt dieses Handbuchs auch ohne eine Software mit Endbenutzerlizenzvereinbarung urheberrechtlich gesch tzt ist Der Inhalt dieses Handbuchs wird ausschlie lich zu informativen Zwecken zur Verf gung gestellt kann ohne Vorank ndigung ge ndert werden und stellt kein Zugest ndnis von Adobe Systems Incorporated dar Adobe Systems Incorporated bernimmt keinerlei Verantwortung oder Verpflichtung f r Fehler oder Ungenauigkeiten die unter Umst nden in diesen rein informativen Inhalten dieses Handbuchs auftreten Bedenken Sie dar ber hinaus dass bereits vorhandene k ns
82. Absender der E Mail Nachrichten fest also den Meeting Veranstalter Benutzer aus Meetings entfernen Manchmal werden Benutzer zu einem Acrobat Connect Professional Meeting eingeladen m ssen aber sp ter wieder aus der Liste der eingeladenen Personen gestrichen werden Das Entfernen von Benutzern hat mehrere Auswirkungen Dies h ngt davon ab ob das Meeting ffentlich oder privat ist m Bei ffentlichen Meetings Die Berechtigung des Benutzers Teilnehmers Moderators oder Veranstalters zur Teilnahme am Meeting wird gel scht aber der Benutzer kann das Meeting noch immer als Gast betreten m Bei privaten Meetings Die Berechtigung des Benutzers zur Teilnahme am Meeting wird gel scht aber der Benutzer kann das Meeting mit Zustimmung des Veranstalters noch immer als Gast betreten Wenn Sie die Berechtigung eines Benutzers zur Teilnahme an einem Meeting entfernen m chten rufen Sie permissions update mit einem besonderen Berechtigungswert auf n mlich permission id remove Wenn ein Meeting begonnen hat und sich der Benutzer bereits im Raum befindet wird er nicht aus dem Raum entfernt Sobald aber die Sitzung des Benutzers abl uft kann er den Raum nicht wieder betreten Die Berechtigung eines Benutzers zur Teilnahme an einem Meeting entfernen 1 Optional Rufen Sie permissions info auf um die Berechtigung des Principals zur Teilnahme am Meeting zu berpr fen https example com api xml action permissions info amp acl id 20
83. Angaben zur Anrechnung des Kurses der Punktzahl dem eindeutigen url path des Kurses etc Anforderungs URL http server_name api xml action report curriculum taker amp user id integer amp sco id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung user id Ganzzahl J Die Kennung des Benutzers dessen Punktzahl Sie berpr fen m chten sco id Ganzzahl J Die eindeutige Kennung des Studienplans dessen Zusammenfassung Sie anzeigen m chten session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden 166 Kapitel 6 Aktionsreferenz Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report curriculum taker gt lt sco transcript id integer path type allowedValue asset id integer sco id integer depth integer folder id integer type integer icon allowedValue lang allowedValue max retries integer source sco id integer source sco type allowedValue status allowedValue score integer certificate integer max score integer attempts integer gt lt access gt allowedValue lt access gt lt credit granted gt boolean lt credit granted gt lt name gt string lt name gt lt url path gt string lt url path gt lt date modified gt datetime lt date modified gt lt ove
84. Antwort Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Die vollst ndige Liste der Principals deren Werte in mindestens einem Feld dem Suchbegriff entsprechen Ein Principal dessen Feldwert dem Suchbegriff entspricht Die Kennung des Principals Die Kennung des Kontos zu dem der Principal geh rt Der Typ des Principals zul ssige Werte finden Sie im Abschnitt type Gibt an ob der Principal untergeordnete Objekte hat Im Gegensatz zu Benutzern k nnen Gruppen untergeordnete Objekte haben Dieser Wert gibt also an ob es sich bei dem Principal um eine Gruppe handelt Gibt an ob der Principal eine integrierte Gruppe ist true oder nicht false Gibt an ob der Principal auf der Benutzeroberfl che ausgeblendet wird true oder nicht false Der vollst ndige Name des Principals bestehend aus den Werten der Felder first name und last name Der Anmeldename des Principals h ufig eine E Mail Adresse principal list by field 137 Beispielanforderung https example com api xml action principal list by field amp value bob Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt principal list gt lt principal account id 624520 principal id 2616099 type user has children false is primary false is hidden false gt lt name gt Bob Jones lt name gt lt login gt bjones acme com lt log
85. Anwendung die Anzeigereihenfolge festlegen Der Standardwert lautet 0 Eine Ganzzahl die den Typ des SCOs angibt das als Vorlage f r dieses SCO diente Beispielanforderung https example com api xml action sco expanded contents amp sco id 624529 236 Kapitel 6 Aktionsreferenz Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt expanded scos gt lt sco depth 0 sco id 624529 folder id 624520 type folder icon folder lang en source sco id display seq 0 source sco type gt lt name gt Shared Meetings lt name gt lt url path gt f624529 lt url path gt lt date created gt 2004 03 09109 45 41 060 08 00 lt date created gt lt date modified gt 2005 03 18T10 19 38 950 08 00 lt date modified gt lt sco gt lt sco depth 1 sco id 2598379 folder id 624529 type meeting icon meeting lang en source sco id 8888 display seq 0 source sco type 3 gt lt name gt Monday Night Football lt name gt lt url path gt r68075204 lt url path gt lt description gt Monday Night Football lt description gt lt date begin gt 2004 05 177T15 30 00 000 07 00 lt date begin gt lt date end gt 2004 05 18T00 15 00 000 07 00 lt date end gt lt date created gt 2004 05 17115 50 39 733 07 00 lt date created gt lt date modified gt 2006 08 16100 34 52 930 07 00 lt date modified gt lt sco gt lt expanded scos gt lt results gt sco i
86. Datum und Uhrzeit Datum Uhrzeit Format auf der W3C Website w3 org enth lt die offizielle Definition des Datum und Uhrzeitformats ISO 8601 Weitere Ressourcen Flash Player Developer Center und Flash Media Server Developer Center stehen ber die Seite Adobe Developer Center zur Verf gung und bieten Artikel Beispiele und Erkl rungen zur Entwicklung von Anwendungen die Adobe Flash Player oder Adobe Flash Media Server verwenden SCORM Concepts auf der Eduworks Corporation Website eduworks com ist ein Tutorial ber das Shareable Content Object Reference Modell und beschreibt SCOs Shareable Content Objects und Learning Management Systeme LMS 10 Vorbereitungsma nahmen Die LDAP Roadmap auf der Website von Kings Mountain Systems www kingsmountain com bietet einen hilfreichen berblick ber das Lightweight Directory Access Protokoll LDAP Diese Seite bietet Entwicklern die ein LDAP Verzeichnis in Connect Enterprise integrieren m chten unter Umst nden n tzliches Hintergrundmaterial oder weiterf hrende Links Microsoft SQL Server Connect Enterprise verwendet eine Microsoft SQL Server Datenbank aus der Ihre benutzerdefinierte Anwendung die Daten abruft oder speichert Weitere hilfreiche Ressourcen finden Sie im Microsoft SQL Server Developer Center msdn microsoft com Referenzen Communities Support und andere Informationen Konventionen In diesem Handbuch werden die hinl nglich bekannten und branchen blichen
87. Elemente mithilfe von XPath Weitere Informationen hierzu finden Sie im XPath Tutorial unter w3schools com Die folgende Antwort von sco shortcuts ist ein Beispiel lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt shortcuts gt lt sco tree id 4930295 sco id 2006258748 type my courses gt lt domain name gt http example com lt domain name gt lt sco gt 296 Anhang A Ein Anwendungsbeispiel lt sco tree id 4930293 sco id 2006258749 type my events gt lt domain name gt http example com lt domain name gt lt sco gt lt shortcuts gt lt results gt Werte extrahieren Die Methode getShortcuts ruft sco shortcuts auf und analysiert die Antwort mithilfe von XPath Der folgende Code ist ein Beispiel fiir die Extraktion einer Liste von sco Elementen und ihrer sco ids public List getShortcuts throws XMLApiException try Element e request sco shortcuts null List scosXml XPath selectNodes e sco List scos new ArrayList XPath id XPath newInstance sco id for Iterator i scosXml iterator i hasNext Element s Element i next SCO sco getSco id valueOf s if null sco scos add sco return scos catch JDOMException jde throw new XMLApiException PARSE_ERROR jde Statuscodes extrahieren Thre Anmeldung muss dariiber hinaus auch die Statuscodes erfolgreicher und nicht erfolgreicher Aktionen aus
88. Ganzzahl Eine bei 1 beginnende Folgenummer f r die Sitzung num participants Ganzzahl Die Anzahl der Teilnehmer im Meeting Der Veranstalter wird nicht mitgez hlt report meeting sessions 177 Element Attribut Typ Beschreibung date created Datetime Das Datum und die Uhrzeit der Datum Sitzungserstellung also der Uhrzeit Zeitpunkt an dem der erste Teilnehmer den leeren Meetingraum betrat date end Datetime Das Datum und die Uhrzeit des Datum Sitzungsendes also der Zeitpunkt Uhrzeit an dem der letzte Teilnehmer den Meetingraum verlie Beispielanforderung https example com api xml action report meeting sessions amp sco id 2006811328 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report meeting sessions gt lt row sco id 2006811328 asset id 2006811333 version 1 num participants 1 gt lt date created gt 2006 06 29T11 46 52 210 07 00 lt date created gt lt date end gt 2006 06 29T13 34 43 410 07 00 lt date end gt lt row gt lt report meeting sessions gt lt results gt report meeting summary Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt die Zusammenfassung f r ein angegebenes Acrobat Connect Meeting zur ck Die Antwort gibt an wie viele Benutzer eingeladen wurden und wie viele eingeladene Benutzer und G ste anwesend waren Au erdem werden weitere Daten zum Meeting ang
89. Goals Review und Quarterly Goals Filter f r den Ausschluss von Objekten filter out name Status Schlie t die Objekte aus in deren Namen der Begriff Status bzw eine beliebige Variante mit unterschiedlicher Gro Kleinschreibung gefunden wird Filter f r bereinstimmung und Ausschluss filter like name Goals amp filter out status active Gibt die Objekte zur ck in deren Namen der Begriff Goals bzw eine beliebige Variante mit unterschiedlicher Gro Kleinschreibung gefunden wird und die nicht mehr aktiv sind bereinstimmung mit einem Startdatum filter gt date begin 2005 05 01 amp sort name asc Gibt die Objekte zur ck die am 1 Mai 2005 begonnen haben Die Objekte werden in der Ergebnisliste nach dem Namen aufsteigend sortiert bereinstimmung mit einem Datumsbereich filter gt date begin 2005 05 01 amp filter 1t date begin 2005 05 31 Gibt die Objekte zuriick die zwischen dem 1 und dem 31 Mai 2005 begonnen haben Siehe auch sort definition sort definition Wo immer Sie in dieser Referenz in einer Anforderungs URL den Begriff sort definition sehen k nnen Sie einen Sortierfilter auf einen Feldnamen und einen Wert definieren anhand dessen Sie die Ergebnisse sortieren m chten Die Syntax lautet sort field value Ersetzen Sie sort mit einem dieser Werte sort einfache Sortierung sort1 bergeordnete Sortierung oder sort2 in sortl untergeordnete Sortierung Mit der Variablen field definieren Sie das Feld
90. Gruppen k nnen untergeordnete Objekte haben Wenn der Wert von has children also true lautet handelt es sich bei dem Principal um eine Gruppe Gibt an ob der Principal eine integrierte Gruppe ist true oder nicht false Gibt an ob Enterprise Manager bzw Ihre Anwendung den Principal anzeigt true wenn er nicht angezeigt wird und false wenn er angezeigt wird Der vollst ndige Name des Principals Der Anmeldename des Principals h ufig eine E Mail Adresse Die E Mail Adresse des Principals Die vollst ndige Liste der Werte benutzerdefinierter Felder des Principals Informationen zu einem benutzerdefinierten Feld des Principals zul ssige Werte finden Sie im Abschnitt field Beispielanforderung https example com api xml action principal list 134 Kapitel 6 Aktionsreferenz Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt principal list gt lt principal principal id 624526 account id 624520 type user has children false is primary false is hidden false gt lt name gt ned mack lt name gt lt login gt nmack acme com lt login gt lt email gt nmack acme com lt emai1 gt lt principal gt lt principal principal id 624550 account id 624520 type user has children false is primary false is hidden false gt lt name gt amelie jones lt name gt lt login gt amelie example com lt login gt lt email gt amelie ex
91. ION aus dem Antwort Header Speichern Sie diesen Wert und geben Sie ihn mit dem Parameter session bei allen nachfolgenden Aktionen dieses Benutzers an den Server zur ck solange die betreffende Benutzersitzung g ltig ist https example com api xml action principal list amp session breezs zuepmy9wh2tseu Stellen Sie sicher dass Sie den Cookie Wert nach Beendigung der Benutzersitzung nicht mehr verwenden Aus einer Anwendung heraus anmelden 31 Eine Anforderung in einem XML Dokument senden Unter Umst nden m chten Sie lieber eine HTTP P0ST Anforderung an den Server senden um sicherzustellen dass die Daten w hrend der bermittlung auch wirklich sicher sind und nicht ausgesp ht werden k nnen In diesem Fall geben Sie den Aktionsnamen und dessen Parameter in einem XML Dokument an Eine Anforderung als XML Dokument erstellen 1 Erstellen Sie ein XML Dokument mit dem Stammelement params und untergeordneten param Elementen f r den Aktionsnamen und jeden Parameter lt params gt lt param name action gt login lt param gt lt param name login gt jon doe com lt param gt lt param name password gt foobar lt param gt lt params gt m Sie k nnen im Stammelement params immer nur eine Aktion senden Die Ausf hrung mehrerer Aktionen hintereinander ist hier nicht m glich a Das XML Dokument muss g ltig und ordnungsgem formatiert sein Es wird empfohlen dass Sie das Dokument vor dem Senden in einem XML Editor
92. SCO geh rt Ein leerer Wert wenn das SCO nicht deaktiviert wurde Wenn doch das Datum und die Uhrzeit seiner Deaktivierung Die Reihenfolge in der Enterprise Manager bzw Ihre Anwendung sofern Sie diesen Wert verwenden die Liste der SCOs anzeigt Die Werte brauchen dabei nicht eindeutig zu sein es k nnen also auch mehrere SCOs den gleichen display seq Wert erhalten In diesem Fall muss die Anwendung die Anzeigereihenfolge festlegen Der Standardwert lautet 0 Die Kennung des Ordners zu dem das SCO geh rt Der Typ des Symbols mit dem das SCO visuell identifiziert wird siehe icon Die Abk rzung der neuen Sprache zul ssige Werte finden Sie im Abschnitt type sco info 239 Element Attribut Typ Beschreibung max retries Ganzzahl Die maximale Anzahl der Versuche die einem Benutzer zur Bearbeitung des SCOs gestattet werden sco id Ganzzahl Die eindeutige Kennung des SCOs source sco id Ganzzahl Die eindeutige Kennung der Vorlage mit der das SCO erstellt worden ist type Zul ssiger Wert Der Materialtyp des SCOs zul ssige Werte finden Sie unter type type ist dabei eine Oberkategorie in icon erhalten Sie weitere Informationen zum Typ des Materials version Ganzzahl Die Versionsnummer des SCOs Der Wert wird erh ht sobald das Objekt ge ndert oder auf den Server hochgeladen wird date begin Datetime Falls das SCO ein Meeting ist das Datum Uhrzeit Datum und die Uhrzeit des Meetingbeginns da
93. Sarai aie REN 97 c stom telds resistance ds 101 custom fields delete 0 ccc ccc cect e eens 104 custom field update 0 0 ccc cece ene a nee 105 group membership update 0 0 c ccc eee eee eee 110 learning Bath info 4 0 sur ded cede aaa sted ae daran 111 learning path update 0 cc eee eens 114 logii SE beads ced NDR we sind Bait la aes freed Se ae ON ee SP Ae eden 116 lOGOUt satis wes ia coke ae ae RR eee 118 permissions info ne rasiert gba dran 120 Dermissionssresef a u 2 aan 124 permissions pd te 2 2 2 2 bp Bee Aves a ae ee 125 principal info 0 0 ee tee eee n ene eae 127 principal list oo woe cng og bee deegu Ag ade ota oases 132 principal list by field 2 0 0 0 ccc eens 135 principalS delete 3 2 0 4 eased Essen aa 139 principal update 0 0 eee e eens 140 4 Inhaltsverzeichnis report active MeetingS 0 ee eee eens 144 report bulk consolidated transactions 222222 147 report bulk objeets ran Fire era 151 report bulk questions 0 0 0 cece eee eens 154 report bulk slide VieWS 0 0 cece ene eens 156 report bUulKzUsSers r 020 8 ars een ae abort es Eaa andl 159 report course status eoi e eects 162 report curriculum taker 2 0 0 eee e eee 166 report meeting attendance 0 eee eens 171 report meeting concurrent USerS 0 0 eee eee ee 174 report meeting sessions 0 cece eee eee 176 report m
94. September All Hands Meeting lt name gt lt domain name gt example com lt domain name gt lt url path gt septl5 lt url path gt lt date begin gt 2006 09 15T09 00 00 000 07 00 lt date begin gt lt date end gt 2006 09 15T18 00 00 000 07 00 lt date end gt lt expired gt false lt expired gt lt duration gt 09 00 00 000 lt duration gt lt meeting gt 56 Kapitel 4 Meetings Verbinden Sie diese beiden Werte und stellen Sie http oder https voran https example com online Wenn Sie HTTPS verwenden aber nicht explizit https voranstellen beginnt die URL in der Standardeinstellung mit http Das bedeutet dass der Benutzer unter Umst nden keinen Zugang zum Meetingraum erh lt Die URL eines Meetingsraums erstellen in dem der Benutzer nicht der Veranstalter ist 1 Rufen Sie die sco id des betreffenden Meetings ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Meetings suchen Rufen Sie sco info mit der sco id auf https example com api xml action sco info amp sco id 2006258750 Werten Sie die Antwort nach url path aus lt sco account id 624520 disabled display seq 0 folder id 624530 icon folder lang en max retries sco id 2006258750 source sco id type folder version 1 gt lt date created gt 2006 04 18T10 21 47 020 07 00 lt date created gt lt date modified gt 2006 04 18T10 21 47 020 07 00 lt date modified gt lt name gt joy acme com lt name gt
95. SessionCookieValue report bulk consolidated transactions 147 Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortst ruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report bulk consolidated transactions gt lt row transaction id integer sco id integer type allowedValue principal id integer score integer gt lt name gt string lt name gt lt url relativelrI lt url gt lt login gt string lt login gt lt user name gt string lt user name gt lt status gt allowedValue lt status gt lt da lt da te created gt datetime lt date created gt te closed gt datetime lt date closed gt lt row gt lt report bulk consolidated transactions gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status report bulk Container Die vollst ndige Liste aller consolidated transacti ons Transaktionen die den Bedingungen der Anforderun
96. Sie folgende Punkte zur Adobe Connect Enterprise Web Services XML API beachten Reihenfolge der API Aufrufe Die Aufrufe an die XML API m ssen h ufig in einer bestimmten Reihenfolge ausgef hrt werden So m ssen Sie beispielsweise zuerst die principal id eines Benutzers und die sco id eines Meetings abrufen bevor Sie den Benutzer mithilfe von permissions update zu einem Moderator des Meetings machen k nnen Die Reihenfolge der Aufrufe bei bestimmten Aufgaben ist in den ersten Kapiteln dieses Handbuchs beschrieben Unterschiedliche Parameternamen f r ein und denselben Wert Ein Wert kann in einem Aufruf einen bestimmten Parameternamen haben in einem anderen Aufruf aber ganz anders bezeichnet werden So lautet die eindeutige Kennung eines SCOs unter Umst nden sco id wenn sie mit sco info verwendet wird und acl id im Zusammenhang mit permissions update Es handelt sich in beiden Aufrufen und den gleichen Wert Die einfachste M glichkeit dies zu verstehen besteht darin die API Referenz dieses Handbuchs zu Rate zu ziehen 291 SCOs sind nicht objektorientiert Bei einem SCO handelt es sich um ein so genanntes Sharable Content Objekt auf dem Server Eine vollst ndige Definition finden Sie im Abschnitt SCOs suchen Ein SCO kann ein Meeting eine Pr sentation ein Kurs ein Bild ein Ordner oder ein anderes beliebiges Objekt auf dem Server sein SCOs sind in Ordnern in einer Navigationshierarchie gespeichert Allerdings gibt es f
97. T14 24 36 390 07 00 lt date created gt lt date modi fied gt 2005 05 09T14 24 36 390 07 00 lt date modified gt lt hit gt 0 lt hit gt lt hit type gt metadata lt hit type gt lt sco gt lt sco sco id 5677964 folder id 2562850 type content icon producer byte count 5985 gt lt name gt Final Quiz lt name gt lt url path gt p46125962 lt url path gt lt date created gt 2005 05 09T14 24 36 390 07 00 lt date created gt lt date modi fied gt 2005 05 09T14 24 36 390 07 00 lt date modified gt lt hit gt 7 lt hit gt lt hit type gt slide lt hit type gt lt hit url gt slide 7 lt hit url gt lt sco gt lt sco search info gt lt results gt sco search 249 sco shortcuts Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt Informationen zu den Ordnern bereit die f r den aktuellen Benutzer von Belang sind Dazu z hlt ein Ordner mit den aktuellen Meetings des Benutzers ein Ordner mit dessen Materialien sowie die in der Navigationshierarchie dar ber liegenden Ordner Um die URL eines SCOs festzulegen k nnen Sie den von sco info sco contents oder sco expanded contents zur ckgegebenen url path mit dem von sco shortcuts bereitgestellten domain name kombinieren So k nnen Sie zum Beispiel die beiden folgenden Zeichenfolgen zusammenf gen m http test server com von sco shortcuts zur ckgegebener domain name m f2006123456 von sco info sco con
98. Uhrzeit Formate 10 Microsoft SQL Server 10 11 online 9 SCORM 10 Webdienste 10 XML 10 XPath 10 XSLT 10 S Schulung alle Kurse oder Studienpl ne auflisten 75 Berechtigungen 72 Berechtigungen f r Kursteilnehmer 72 eines Benutzers anzeigen 76 Interaktionen 195 Kurse 71 Kurse suchen 73 Studienpl ne 71 Studienpl ne suchen 73 Schulungsanwendungen empfohlene Aufrufe 71 sco contents 228 sco delete 232 sco expanded contents 234 sco id Definition 45 eines Kurses oder Studienplans suchen 74 von Meetings suchen 53 sco info Definition 237 Java Beispiel 304 sco move 242 sco nav 243 sco search 246 sco shortcuts 250 Beispiel 46 Java Beispiel 297 sco update Definition 253 Java Beispiel 302 in Meetinganwendungen 53 sco upload 258 SCORM 10 SCOs Berechtigungen berpr fen 51 Charakteristiken 46 Definition 37 Informationen abrufen 48 304 nicht objektorientiert 292 ohne Angabe der sco id suchen 47 suchen Typen 45 288 URLs erstellen 49 Seminarordner 47 Server Flash Media 17 Set Cookie after login 25 68 after logout 35 shareable content objects Siehe SCOs shared meeting templates Ordner 47 Sitzung Definition 176 Sitzungsparameter 25 sortieren Aufrufbeispiel 20 Definition 20 Syntax 271 Sprachen und benutzerdefinierte Anwendungen 8 SQL Server 11 18 status Attribut 76 284 status Element 281 Statuscode Java Beispiel 34 297 312 Index Studienpl ne abgeschlossene Kurse anzeigen 83 a
99. Uhrzeit der Datum letzten Kurs bzw Uhrzeit Studienplan nderung date begin Datetime Das Datum und die Uhrzeit des Datum Kurs bzw Studienplanstarts Uhrzeit entweder in der Vergangenheit oder in der Zukunft date end Datetime Das Datum und die Uhrzeit des Datum Kurs bzw Studienplanendes Uhrzeit entweder in der Vergangenheit oder in der Zukunft sco tag Zeichenfolge Ein nicht eindeutige Kennung des Kurses oder Studienplans so wie sie auf der Benutzeroberfl che angezeigt werden soll z B ECON101 url path Zeichenfolge Der eindeutige Name des Kurses oder Studienplans in der URL expired Boolescher Gibt an ob das Ende des Kurses Wert oder Studienplans bereits zur ckliegt true wenn ja false wenn nicht completed Boolescher Gibt an ob der Benutzer oder die Wert Gruppe den Kurs abgeschlossen hat Beispielanforderung https example com api xml action report my training amp principal id 2006258745 report my training 193 Beispielantwort lt xml vers lt results gt lt status lt report ion 1 0 encoding utf 8 gt code ok gt my training gt lt row sco id 2006298431 type content icon course permission id view gt lt name gt Intro to Psychology lt name gt lt url gt example com psychology lt url gt lt date created gt 2006 05 03T10 21 46 810 07 00 lt date created gt lt date modified gt 2006 05 03T10 22 30 803 07 00 lt date modified gt lt dat
100. Value acl field info 89 Parameter Name Typ Erforderlich Beschreibung acl id Ganzzahl J Die Kennung des SCOs Kontos oder Principals f r das bzw den Sie bestimmte Feldinformationen erhalten m chten Kann eine zul ssige sco id account id oder principal id sein session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt acl fields gt lt field acl id integer field id string gt lt value gt string lt value gt lt field gt lt acl fields gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status acl fields Container Informationen zu allen Feldern die den Principal das Konto oder das Objekt beschreiben field Container Ein Feld das den Principal das Konto oder das Objekt beschreibt 90 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung acl id Ganzzahl Die in der Anforderung angegebene acl id Entweder eine sco id eine principal id oder eine accou
101. Verf gung preass none Das aktuelle SCO enth lt keinen Einstufungstest preass hidden Das aktuelle SCO enth lt einen Einstufungstest Wenn der Teilnehmer den Test besteht kann das aktuelle SCO f r den Benutzer ausgeblendet werden Andernfalls ist das aktuelle SCO sichtbar so dass sich der Benutzer einschreiben kann preass optional Das aktuelle SCO enth lt einen Einstufungstest Wenn der Teilnehmer den Test besteht ist das aktuelle SCO nicht mehr erforderlich um den Studienplan abzuschlie en permission id Beschreibung Mit dem Parameter oder dem Attribut permission id werden Berechtigungen definiert Je nach Aktion oder Antwort handelt es sich um eine Berechtigung die ein Principal f r ein bestimmtes SCO hat oder es ist eine Berechtigung die zur Ausf hrung einer Aktion erforderlich ist Werte Berechtigung Beschreibung admin view Der Principal hat den vollen Zugriff auf ein Konto und kann Benutzer erstellen jeden Ordner anzeigen und jedes SCO starten Dagegen kann der Principal kein Material ver ffentlichen oder Veranstalter eines Acrobat Connect Professional Meetings sein Der Principal kann das SCO anzeigen aber nicht ver ndern Der Principal kann an einem Kurs oder als Teilnehmer an einem Meeting teilnehmen oder den Inhalt eines Ordners anzeigen 280 Kapitel8 Allgemeine Referenz Berechtigung Beschreibung host mini host remove publish manage denied Nur bei Me
102. Werte von type sind in der folgenden Tabelle enthalten Wert Beschreibung admins Die integrierte Gruppe der Administratoren f r Serveradministratoren authors Die integrierte Gruppe der Autoren f r Autoren course admins event admins event group everyone Die integrierte Gruppe der Schulungsverwalter f r Schulungsverwalter Die integrierte Gruppe der Veranstaltungsverwalter f r alle Principals die ein Acrobat Connect Professional Meeting erstellen k nnen Die Gruppe der Benutzer die zu einer Veranstaltung eingeladen ist Alle Connect Enterprise Benutzer type 289 Wert Beschreibung external group external user group guest learners live admins seminar admins user Eine Gruppe die ber ein externes Netzwerk authentisiert wurde Ein Benutzer der Uber ein externes Netzwerk authentisiert wurde Eine Gruppe die von einem Benutzer oder Administrator erstellt wird Ein nicht registrierter Benutzer der einen Acrobat Connect Professional Meetingraum betritt Die integrierte Gruppe der Kursteilnehmer f r Principals die an einem Kurs teilnehmen Die integrierte Gruppe der Meetingveranstalter fur die Veranstalter von Acrobat Connect Professional Meetings Die integrierte Gruppe der Seminarveranstalter fur Seminarveranstalter Ein registrierter Benutzer auf dem Server Typen von benutzerdefinierten Feldern Bei benutzerdefinierten Feldern kann type einen der folg
103. Zu diesen Metadaten geh ren der Name sowie die Daten und Zeiten der Meetings oder Kurse die Meetingraum URL die Material URL und die Berichtsdaten Der Datenfluss mit dem die benutzerdefinierte Anwendung die erforderlichen Metadaten aus der Datenbank abruft l uft vom Clientbrowser ber den Webanwendungsserver des Clients die XML API und weiter zum Webanwendungsserver von Connect Enterprise zur SQL Datenbank und wieder zur ck Der Datenfluss zwischen einer benutzerdefinierten Anwendung und Connect Enterprise l uft wie folgt 1 Ein Benutzer greift ber einen Webbrowser auf die benutzerdefinierte Anwendung zu 2 Die Anwendung ruft dabei die XML API ber HTTP 80 oder HTTPS 443 auf 3 Der Webanwendungsserver von Connect Enterprise autorisiert die Anwendung und ihre Benutzer ruft die Metadaten aus der SQL Datenbank ab und gibt sie zur ck 4 Aufder Clientseite wird die Antwort vom Web oder Anwendungsserver dem XML Parser und den Softwarebibliotheken verarbeitet und an die Anwendung weitergeleitet 5 Der Benutzer setzt seine Arbeit mit der benutzerdefinierten Anwendung fort und klickt auf ein Meeting oder eine Material URL In diesem Moment greift der Benutzer beispielsweise um den Meetingraum zu betreten auf eine Connect Enterprise Anwendung wie Acrobat Connect Professional zu und der Server l dt die erforderlichen Daten 16 Kapitel 1 Architektur Connect Enterprise Anwendungen Die Connect Enterprise Anwendungen rufen d
104. ad Pressburg Budapest Ljubljana Prag 95 GMT 01 00 Sarajevo Skopje Warschau Zagreb 00 GMT 01 00 Brussel Kopenhagen Madrid Paris 05 GMT 01 00 Amsterdam Berlin Bern Rom Stockholm Wien 10 GMT 01 00 West Zentralafrika 13 GMT 02 00 Bukarest 15 GMT 02 00 Kairo 20 GMT 02 00 Helsinki Kiew Riga Sofia Tallinn Wilna 25 GMT 02 00 Athen Istanbul Minsk 30 GMT 02 00 Jerusalem 35 GMT 02 00 Harare Pretoria 40 GMT 03 00 Moskau St Petersburg Wolgograd 45 GMT 03 00 Kuwait Riad 50 GMT 03 00 Nairobi 55 GMT 03 00 Bagdad 58 GMT 03 30 Teheran 60 GMT 04 00 Abu Dhabi Muskat 65 GMT 04 00 Baku Tiflis Eriwan 70 GMT 04 30 Kabul 75 GMT 05 00 Ekaterinburg 80 GMT 05 00 Islamabad Karatschi Taschkent 85 286 Kapitel 8 Allgemeine Referenz Zeitzoneneinstellung Wert GMT 05 30 Chennai Kolkata Mumbai Neu Delhi 190 GMT 05 45 Katmandu 193 GMT 06 00 Astana Dakka 195 GMT 06 00 Sri Jayawardenepura 200 GMT 06 00 Almaty Nowosibirsk 201 GMT 06 30 Rangun 203 GMT 07 00 Bangkok Hanoi Jakarta 205 GMT 07 00 Krasnojarsk 207 GMT 08 00 Peking Chongqing Hongkong Urumgi 210 GMT 08 00 Kuala Lumpur Singapur 215 GMT 08 00 Taipei 220 GMT 08 00 Perth 225 GMT 08 00 Irkutsk Ulan Bator 227 GMT 09 00 Seoul 230 GMT 09 00 Osaka Sapporo Tokio 235 GMT 09 00 Jakutsk 240 GMT 09 30 Darwin 245 GMT 09 30 Adelaide 250 GMT 10 00 Canberra Melbourne Sydney 255 GMT 10 00 Bri
105. ahl Die Anzahl der Benutzer die an participants einem aktuellen Meeting teilnehmen einschlie lich Veranstaltern und Moderatoren length minutes Ganzzahl Die Zeit die seit Beginn des Meetings vergangen ist name Zeichenfolge Der Name des Meetings zum Zeitpunkt der Erstellung url path Zeichenfolge Der Teil der Meeting URL die auf den Dom nennamen folgt und das Meeting eindeutig kennzeichnet date begin Datetime Das Datum und die Uhrzeit des Datum Uhrzeit Meetingbeginns Beispielanforderung https example com api xml action report active meetings Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report active meetings gt lt sco sco id 2006778715 active participants length minutes 1 gt lt name gt Designing Online Courses lt name gt lt url path gt online lt url path gt lt date begin gt 2006 06 287T14 35 21 307 07 00 lt date begin gt lt sco gt lt report active meetings gt lt results gt 146 Kapitel 6 Aktionsreferenz report bulk consolidated transactions Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Gibt Informationen zu den Principal SCO Transaktionen in Adobe Connect Enterprise Server bzw in Ihrem Enterprise Hosted Konto zur ck Bei einer Transaktion handelt es sich um die Instanz eines Zugriffs auf ein Objekt SCO durch einen Principal Das SCO kann dabei ein Acrobat Connect Profession
106. ahl des Benutzers bei seinem letzten Versuch zum Abschluss der Schulung Die Zugriffsrechte die der Benutzer f r den Zugriff auf den Kurs oder Studienplan hat zul ssige Werte finden Sie im Abschnitt permission id Die Anzahl der Versuche des Benutzers diese Schulung abzuschlie en Der Name des Schulungs SCOs Die Beschreibung des Schulungs SCOs Die eindeutige Kennung des SCOs aus der URL unmittelbar hinter dem Dom nennamen Das Datum der Interaktion eines Benutzers mit dem Schulungs SCO Anzeige einer Pr sentation Beantwortung eines Quiz etc Gibt an ob dieser Kurs im Rahmen eines Studienplans besucht wurde report user trainings taken 223 Beispielanforderung https example com api xml action report user trainings taken amp principal id 2006258745 amp principal id 4797406 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report user trainings taken gt lt row transcript id 2006745722 max retries sco id 2006745673 type content icon course status user passed certificate 2006745722 score 0 permission id attempts 1 gt lt name gt All About Web Communities lt name gt lt description gt test lt description gt lt url path gt p33096345 lt url path gt lt date taken gt 2006 06 12T15 06 02 947 07 00 lt date taken gt lt from curriculum gt false lt from curriculum gt lt row gt lt report user trai
107. al Meeting ein Kurs ein Dokument oder beliebiges Material auf dem Server sein Dies sind drei Beispiele f r Transaktionen m Wenn ein Principal ein Meeting zweimal besucht gibt es zwei Transaktionen Und zwar eine f r jeden Besuch des Principals bei dem Meeting m Falls f nf Benutzer an einem Meeting teilnehmen gibt es f nf Transaktionen Eine f r jeden Benutzer der am Meeting teilnimmt m Sollte ein Principal je dreimal auf zwei Kurse zugreifen und jeden Kurs erst beim dritten Versuch absolvieren gibt es insgesamt sechs Transaktionen Eine f r jede Teilnahme an einem der beiden Kurse Da mit diesem Aufruf alle Transaktionen zur ckgegeben werden sollten Sie unter Umst nden einen Filter einsetzen um den Umfang der Antwort einzuschr nken Mit dem Filter filter type meeting k nnen Sie beispielsweise nur die Transaktionen anzeigen die sich auf Meetings beziehen https example com api xml action report bulk consolidated transactions amp filter type meeting Anhand der Informationen zu den Meetingtransaktionen in der Antwort siehe Beispielantwort k nnen Sie durch einen Vergleich der date created und date closed Angaben die Nutzung der Connect Enterprise Meetings berechnen Weiterf hrende Hinweise finden Sie im Abschnitt Die Meetingnutzung berechnen Anforderungs URL http server_name api xml action report bulk consolidated transactions amp filter definition value amp sort definition value amp session Breeze
108. allowedValue amp is required boolean amp is primary boolean amp display seq integer amp field id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung account id Ganzzahl N Die Kennung des Kontos in dem das Feld erstellt wurde object type Zeichenfolge J Der Typ des SCOs zu dem das Feld gehort Dieser Wert ist erforderlich um Felder zu erstellen und zu aktualisieren Zul ssige Werte e object type principal object type meeting object type sco object type event object type read only Beispiel object type object type principal Der Wert object type read only zeigt an dass Enterprise Manager den Wert zwar anzeigt der Benutzer diesen aber in Enterprise Manager nicht ndern kann Sie k nnen diesen Wert auch in benutzerdefinierten Anwendungen einsetzen 106 Kapitel 6 Aktionsreferenz Name Typ Erforderlich Beschreibung permission id name comments field type is required is primary display seq field id session Zeichenfolge Zeichenfolge Zeichenfolge Zeichenfolge Boolescher Wert Boolescher Wert Ganzzahl Ganzzahl Zeichenfolge J Die Berechtigung die ein Principal fur das Objekt ben tigt um dessen Feldwert einzustellen oder anzuzeigen Der einzige zul ssige Wert lautet manage Erforderlich um ein Feld zu erstellen Die Bezeichnung des Felds auf der Benutzeroberfl che Erforderlich um ein Feld zu e
109. alten die Sie entfernen m chten https example com api xml action principal list amp filter type user amp filter account id 624520 m Lesen Sie die gew nschten Werte aus einer Datei ein Schreiben Sie eine Methode die permissions update aufruft und f r jeden gefundenen Eintrag acl id principal id und permission id zur ckgibt https example com api xml action permissions update amp acl id 2007064258 amp principal id 2007105030 amp permission id denied amp acl id 2007064258 amp principal id 2006258745 amp permission id denied Dabei muss permission id mit dem Wert denied verwendet werden 80 Kapitel 5 Schulungen 4 Rufen Sie permissions info auf um zu berpr fen ob alle gew nschten Benutzer entfernt wurden https example com api xml action permissions info amp acl id 20070642588 filter permission id denied Eine gro e Zahl von Benutzern ab 1 000 ber eine Gruppe in einen Kurs einschreiben 1 Erstellen Sie eine Gruppe Mit der XML API Rufen Sie principal update auf und werten Sie die Antwort nach principal id aus https example com api xml action principal update amp type group amp has children l amp name developersc5 Mit Enterprise Manager Frstellen Sie die Gruppe unter Verwaltung gt Benutzer und Gruppen gt Neue Gruppe bernehmen Sie die principal id der neuen Gruppe von der Browser URL 2 F gen Sie die Benutzer hinzu die Sie mithilfe der Gruppe einschreiben m chten Sie k nnen h
110. ammengefasst Sofern sie durch andere Aufrufe ersetzt wurden sind diese angegeben Aktion Entfernt in Ersetzt durch accesskey exec accesskey info action list report account meeting attendance report active meeting presenters report bandwidth report bulk content quiz report bulk content quiz results report bulk content slide views report bulk course quiz report bulk course results report bulk meeting report bulk meeting attendance report course takers report disk usage report meeting session report meeting session slots report principal list report quiz answer distribution Breeze 5 Breeze 5 Web Services 6 Breeze 5 Web Services 6 Breeze 5 Breeze 5 Breeze 5 Breeze 5 Breeze 5 Breeze 5 Breeze 5 Breeze 5 Breeze 5 Breeze 5 Breeze 5 Breeze 5 Breeze 5 Breeze 5 report meeting attendance report bulk consolidated transactions report quiz interactions report quiz question distribution report quiz question response report quiz takers report quiz summary report bulk slide views report quiz interactions report bulk objects mit filter type meeting report quiz takers report meeting sessions Filterung von asset id acl field 11st acl field update report quiz question answer distribution 88 Kapitel 6 Aktionsreferenz Aktion Entfernt in Ersetzt durch report quiz definition answers Breeze 5 report quiz interactions report
111. ample com lt emai gt lt principal gt lt principal list gt lt results gt Siehe auch principal info principal update principal list by field principal list by field Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Listet die Principals auf die in einem beliebigen Feld den angegebenen Wert haben Geben Sie mit dem Parameter value den Wert an den Sie suchen Dabei sollte dieser Wert der Name eines Datenbankfelds sein Das Element name beispielsweise enth lt den vollst ndigen Namen der aus first name bob und last name jones zusammengesetzt wird Wenn Sie also nach name bob jones suchen gibt principal list by field keinen Wert zur ck es sei denn der vollst ndige Name wurde als Datenbankfeld definiert ist also ein benutzerdefiniertes Feld Bei der Suche wird nicht zwischen Gro und Kleinschreibung unterschieden und der Suchbegriff kann Leerzeichen enthalten Jokerzeichen sind in der Abfragezeichenfolge dagegen nicht zugelassen Wenn Sie also t als Suchbegriff eingeben sucht principal list by field nach der exakten Zeichenfolge t principal list by field 135 Die Aktion principal list by field durchsucht alle Felder die f r den Principal definiert wurden einschlie lich der benutzerdefinierten Felder Anforderungs URL http server_name api xml action principal list by field amp value string amp filter definition value amp sort definition
112. an ndern Sie die Browser URL und rufen Sie principal list auf https example com api xml action principal list berpr fen Sie den Header der Anforderung Bei dieser Anforderung wird der Wert des BREEZESESSION Cookies an den Server zuriickgesendet GET api xml action principal list HTTP 1 1 Accept Accept Language en us Accept Encoding gzip deflate User Agent Mozilla 4 0 compatible MSIE 6 0 Windows NT 5 1 SV1 NET CLR 1 1 4322 Host example com Connection Keep Alive Cookie BREEZESESSION breezbryf9ur23mbokzs8 Sehen Sie sich die Antwort an Sie sollte s mtliche auf dem Server gespeicherten Principals in je einem principal Element enthalten lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt principal list gt lt principal principal id 624526 account id 624520 type user has children false is primary false is hidden false gt lt name gt joe harrison lt name gt lt login gt jharrison example com lt login gt lt email gt jharrison example com lt emai1 gt Ihre ersten API Aufrufe 19 lt principal gt lt principal principal id 624550 account id 624520 type user has children false is primary false is hidden false gt lt name gt bob jones lt name gt lt login gt bjones example com lt login gt lt email gt bjones example com lt emai gt lt principal gt lt principal list gt lt results gt Filter und Sortie
113. anager also die Anwendung mit der Sie die Materialien und Benutzer Ihres Unternehmens anzeigen und verwalten sofern Sie diese Arbeiten nicht mit einer benutzerdefinierten Anwendung oder einem integrierten System eines anderen Anbieters ausf hren Die Metadaten der Materialien und Benutzer werden entweder in einer einzelnen Datenbank oder in mehreren replizierten SQL Datenbanken gespeichert Der Webanwendungsserver hat keinen Status das bedeutet dass die Skalierung nahezu linear verl uft Flash Media Server Flash Media Server stellt die Muskeln von Connect Enterprise dar Diese Software streamt die Audio Video und Rich Media Daten mithilfe von RTMP Die Aufzeichnung und Wiedergabe eines Meetings die Synchronisierung von Audio und Videodaten oder die Konvertierung und Komprimierung des Materials zur Bildschirmfreigabe in Echtzeit sind Aufgaben die Flash Media Server bernimmt Aber diese Software spielt auch eine wichtige Rolle bei der Reduzierung der Serverbelastung denn sie speichert h ufig besuchte Webseiten Streams und freigegebene Daten zwischen Datenfluss 17 Die SQL Datenbank Connect Enterprise nutzt eine Microsoft SQL Server Datenbank zur Speicherung h ufig genutzter Transaktions und Anwendungsmetadaten einschlie lich aller Benutzer Gruppen Material und Berichtsdaten Uber die XML API werden die in der Datenbank gespeicherten Metadaten abgerufen Die Datenbank kann entweder mit der Microsoft SQL Server Desktop Engin
114. ance url path text String path Text xpath selectSingleNode e getText e request sco shortcuts null xpath XPath newInstance domain name text String url Text xpath selectSingleNode e getText return url path substring 1 session breezesession catch JDOMException jde throw new XMLApiException PARSE_ERROR jde Sie k nnen den Statuscode ok auch mit einem Zeichenmustervergleich abfragen Eine erfolgreiche Aktion gibt immer diese Antwort zur ck lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Sie brauchen also die Antwort nur nach ok oder nach code 0k zu durchsuchen Eine Antwort mit XPath analysieren 33 Antworten nach Fehlermeldungen durchsuchen Wenn eine API Aktion erfolgreich ausgef hrt wird gibt sie den Statuscode ok zur ck Schl gt der Aufruf dagegen fehl wird unter Umst nden einer der folgenden Statuscodes zur ckgegeben invalid Gibt an dass ein Aufruf in irgendeiner Hinsicht ung ltig ist normalerweise wegen eines Syntaxfehlers no access Gibt an dass der aktuelle Benutzer keine Berechtigung hat die Aktion aufzurufen Die Antwort enth lt ein subcode Attribut mit weiteren Informationen no data Gibt an dass die Aktion zwar eigentlich Daten zur ckgeben soll aber derzeit keine Daten zur Verf gung stehen too much data Gibt an dass die Aktion ein einzelnes Ergebnis h tte zur
115. anzzahl Die Anzahl der Antworten auf diese Frage insgesamt percentage correct Ganzzahl Der Prozentsatz der richtigen Antworten insgesamt score Ganzzahl Die Punktzahl die der Frage zugeordnet wurde report quiz question distribution 203 Element Attribut Typ Beschreibung name Zeichenfolge Der Name der Frage gem den Angaben bei ihrer Erstellung im Quizmanager description Zeichenfolge Die Definition der Frage gem den Angaben bei ihrer Erstellung im Quizmanager Beispielanforderung https example com api xml action report quiz question distribution amp sco id 2006334909 amp filter like description The capital of California Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report quiz question distribution gt lt row display seq 1 interaction id 2006334913 num correct 2 num incorrect 1 total responses 3 percentage correct 66 score 10 gt lt name gt The capital of California is lt 1 gt lt name gt lt description gt The capital of California is lt 1 gt lt description gt lt row gt lt report quiz question distribution gt lt results gt report quiz question response Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt eine Liste der Antworten bereit die Benutzer auf die Fragen in einem Quiz gegeben haben Ohne Filterung gibt diese Aktion alle Antworten aller Benutzer zu jed
116. as init param Element mit einem param value von api glas lt init param gt lt param name gt ignore pattern 0 lt param name gt lt param value gt api lt param value gt lt init param gt p Ihre Anwendung nutzt nur die XML API ndern Sie das Element filter mapping Ihres Filtertyps so dass an Stelle von das URL Muster api verwendet wird lt filter mapping gt lt filter name gt HeaderAuthenticationFilter lt filter name gt lt url pattern gt api lt url pattern gt lt filter mapping gt F gen Sie dann im Element filter Ihres Filtertyps Kommentartags um alle init param Elemente die einen param name mit dem Wert ignore pattern x haben lt filter gt lt filter name gt HeaderAuthenticationFilter lt filter name gt lt filter class gt com macromedia airspeed servlet filter HeaderAuthenticationFilter lt filter class gt ire lt init param gt lt param name gt ignore pattern 0 lt param name gt lt param value gt api lt param value gt lt init param gt lt init param gt lt param name gt ignore pattern 4 lt param name gt lt param value gt servlet testbuilder lt param value gt lt init param gt lt filter gt Konfigurieren Sie Enterprise Server so dass bei der Erstellung der Benutzer das Feld ext login mit der von Ihnen bergebenen externen Benutzer ID ausgef llt wird weitere Hinweise hierzu finden Sie im Connect Enterprise Installations und Konfigu
117. berlassen Weitere Informationen finden Sie in den Abschnitten Mit Cookie Management anmelden bzw Mit dem Sitzungsparameter anmelden Aus einer Anwendung heraus anmelden 27 Mit einer HTTP Header Authentisierung anmelden Die Anweisungen dieses Abschnitts gelten ausschlie lich f r Enterprise Server SISMNIH Thre Anwendung kann die Authentisierung der Benutzer durch SSO auch mithilfe eines vertrauenswiirdigen zentralen Servers durchf hren und die hier so genannten externen Authentisierungsdaten an Enterprise Server bergeben Benutzer ID und Kennwort werden dabei ausdr cklich nicht bermittelt Detaillierte Anweisungen zum Einrichten und Konfigurieren der HTTP Header Authentisierung finden Sie im Adobe Connect Enterprise Installations und Konfigurationshandbuch Mithilfe der HTTP Header Authentisierung kann sich ein Benutzer an Ihrem Authentisierungsserver anmelden Sobald der Benutzer authentisiert ist k nnen Sie einen HTTP Anforderungs Header hinzuf gen mit dem der Benutzer identifiziert wird Oder Sie konfigurieren einen Proxy Server der den Header automatisch hinzuf gt Der Authentisierungsfilter von Connect Enterprise mit der Bezeichnung HeaderAuthenticationFilter konvertiert die Benutzer ID in einen Connect Enterprise Anmeldenamen und authentisiert den Benutzer Authentisierungs Server 7 Proxy Server v Connect Enterprise Server Authentisierungsfilter 7 er dar ae u ese P
118. bung Ein Attribut das den Fortschritt eines Benutzers bei der Bearbeitung eines Kurs oder Studienplan SCOs beschreibt Es wird von Aktionen zuriickgegeben die Schulungsberichte bereitstellen Studienpl ne und Ordner k nnen nur einen status Wert von completed oder incomplete haben Die folgende Tabelle enth lt die zul ssigen Werte f r status wenn diese in einem row Element als Beschreibung eines Kurses zuriickgegeben werden Wert Beschreibung user passed Das SCO enth lt bewertete Interaktionen die der Benutzer bestanden hat user failed Das SCO enth lt bewertet Interaktionen Der Benutzer hat zwar die Fragen beantwortet aber das SCO nicht bestanden completed Der Benutzer hat alle Materialien des SCOs angezeigt aber es waren keine bewerteten Interaktionen enthalten incomplete Der Benutzer hat nicht alle Materialien des SCOs angezeigt not attempted Der Benutzer hat noch keine Materialien des SCOs angezeigt review Der Benutzer hat den Kurs abgeschlossen oder bestanden bzw alle zulassigen Wiederholungsversuche durchlaufen Beispiel lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report user training transcripts gt lt row transcript id 2006905612 sco id 2006298431 principal id 2006258745 status review score 0 max score certificate type content icon course gt 284 Kapitel 8 Allgemeine Referenz lt name gt Test Course lt name gt
119. bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt principal list gt lt principal principal id integer account id integer type allowedValue has children boolean is primary boolean is hidden boolean gt lt name gt string lt name gt lt login gt string lt login gt lt email gt string lt email gt lt principal gt lt principal list gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status principal list Container Die gesamte Liste der Principals principal Container Informationen zu einem Principal principal id Ganzzahl Die Kennung des Principals principal list 133 Element Attribut Typ Beschreibung account id type has children is primary is hidden name login email principal custom field values field Ganzzahl Zul ssiger Wert Boolescher Wert Boolescher Wert Boolescher Wert Zeichenfolge Zeichenfolge Zeichenfolge Container Container Die Kennung des Kontos zu dem der Principal geh rt Der Typ des Principals zul ssige Werte finden Sie im Abschnitt type Gibt an ob der Principal untergeordnete Objekte hat
120. c id eingeben die der Kennung des SCOs des Principals oder des Kontos entspricht auf den oder das zugegriffen werden soll ACL steht hierbei f r Access Control List und stellt eine Liste der Einheiten dar die eine Zugriffsberechtigung erhalten haben Sie k nnen auch eine principal id angeben um die Berechtigungen einer bestimmten Person oder Gruppe f r das Objekt abzufragen Rufen Sie zur Bestimmung der principal id die Aktion principal 1ist auf Sie k nnen die zur ckgegebenen Daten dabei mit einem Filter einschr nken Auf dem Server werden zwei besondere Principals definiert public access und logged in access Dabei k nnen public access und die Werte von permission id zu speziellen Zugangsberechtigungen f r Meetings zusammengesetzt werden zum Beispiel m principal id public access und permission id view hidden geben an dass das Acrobat Connect Meeting ffentlich ist und jeder Benutzer der die URL dieses Meetings erh lt den Meetingraum betreten kann m principal id public access und permission id denied bezeichnen private Meetings in denen nur registrierte Benutzer und genehmigte G ste zugelassen sind Die principal id von logged in access gibt an dass nur die Principals an einem Meeting teilnehmen k nnen die am Server angemeldet sind Anforderungs URL http server_name api xml action permissions info amp acl id integer amp principal id integer amp filter definition value amp sort definition value amp sessi
121. con meeting sco id 2007184134 version 0 gt lt date begin gt 2006 10 01T09 00 lt date begin gt lt date end gt 2006 10 01T17 00 lt date end gt lt url path gt october lt url path gt lt name gt October All Hands Meeting lt name gt lt sco gt 58 Kapitel 4 Meetings Unter Umst nden m chten Sie den url path des Meetings speichern falls Sie sp ter eine URL f r diesen Meetingraum erstellen m chten 6 Rufen Sie permissions update auf um das Meeting als ffentliches Meeting zu definieren Verwenden Sie dabei die sco id des Meetings als acl id https example com api xml action permissions update amp ac id 2007018414 amp principal id public access amp permission id view hidden 7 Rufen Sie permissions update auf um einen Veranstalter einen Moderator und die Teilnehmer hinzuzuf gen https example com api xml action permissions update amp principal id 2006258745 amp ac1 id 2007018414 amp permission id host m Legen Sie dabei f r den Meetingveranstalter eine permission id mit dem Wert host fest Verwenden Sie mini host f r den Moderator und view fiir die Teilnehmer m Sie k nnen in einem Aufruf von permissions update mehrere Datens tze mit principal id acl id und permission id angeben 8 Erstellen Sie die URL zum Meetingraum Hinweise hierzu finden Sie im Abschnitt Meetingraum URLs erstellen Ein privates Meeting erstellen und einen Veranstalter einen Moderator und meh
122. d update verwenden Au erdem ben tigen Sie Administratorberechtigungen um einen Principal zu erstellen oder zu aktualisieren 140 Kapitel 6 Aktionsreferenz Anforderungs URL http server_name api xml action principal update amp description string amp email string amp first name string amp has children boolean amp last name string amp login string amp name string amp password string amp principal id integer amp send email boolean amp type allowedValue amp session BreezeSessionCookieValue Parameter Name Typ Erforderlic h Beschreibung description email first name has children last name Zeichenfolge N Zeichenfolge N Zeichenfolge J N Boolescher J Wert Zeichenfolge J N Die Beschreibung der neuen Gruppe Wird nur beim Erstellen einer neuen Gruppe verwendet Die E Mail Adresse des Benutzers Dieser Wert ist unter Umstanden ein anderer als der von login Sie sollten hier aber auf jeden Fall einen Wert eingeben wenn Sie send email true verwenden Der Vorname des Benutzers Dieses Feld sollten Sie nur bei Benutzern verwenden nicht bei Gruppen Erforderlich um einen Benutzer zu erstellen Gibt an ob der Principal untergeordnete Objekte hat Falls der Principal eine Gruppe ist geben Sie hier eine 1 oder true an Bei einem Benutzer geben Sie hier eine 0 oder false an Der neue Nachname der dem Benutzer zugewiesen werden soll Erforderlich um einen Benu
123. debeispiel wird der Cookie Wert beispielsweise in der Variablen breezesession gespeichert und nun auf null gesetzt public void logout throws XMLApiException request logout null this breezesession null Einen Benutzer abmelden 35 36 Kapitel 2 Anmeldung und Anforderungen KAPITEL 3 Grundlagen Sie haben jetzt einen Einblick in die Architektur von Adobe Connect Enterprise Server und Adobe Connect Enterprise Hosted erhalten und wissen wie Sie API Aufrufe im Browser testen k nnen Damit sind Sie nunmehr in der Lage XML API Anweisungen zu senden und die Antworten auszuwerten F r die ersten Schritte mit Adobe Connect Enterprise Web Services m ssen Sie sich mit drei wesentlichen Konzepten auseinandersetzen m Principals also Benutzer und Gruppen m SCOs also Sharable Content Objects gemeinsam nutzbare Materialobjekte wie z B Meetings Kurse und sonstige Materialien die in Connect Enterprise erstellt werden k nnen Diese SCOs Aussprache von SCO als Akronym skou sind kompatibel zur Industriestandardspezifikation der Sharable Content Objekt Reference Modelle SCORM und k nnen auch in Learning Management Systemen LMS verwendet werden m Berechtigungen also Definitionen in welcher Weise Principals mit Objekten umgehen k nnen In diesem Abschnitt werden die grundlegenden Aufgaben beschrieben die unabh ngig von den lizenzierten Connect Enterprise Anwendungen mit Web Services ausgef hrt we
124. deinstellung entweder in Connect Enterprise Manager festlegen oder durch einen Aufruf von custom field update Wenn Sie angeben m chten dass das Feld nur mithilfe der API ge ndert werden kann rufen Sie custom field update mit dem Parameter object type object type read on1y auf Eigene Felder definieren und einem Benutzer zuweisen 1 Erstellen Sie zun chst mit custom field update ein Feld https example com api xml action custom field update amp object type object type principal amp permission id manage amp account id 624520 amp name Location amp comments adobe 20location amp field type text amp is required true amp is primary false amp display seq 9 Mit dem Feld name wird der Feldname festgelegt so wie er in Ihrer Anwendung angezeigt werden soll Beachten Sie also hier die Regeln der Rechtschreibung Das benutzerdefinierte Feld dieses Beispiels wird fiir alle Connect Enterprise Principals definiert 2 Durchsuchen Sie die fie d Elemente der Antwort nach der field id lt field field id 2007184366 object type object type principal display seq 9 account id 624520 is primary false permission id manage is required true field type text gt lt comments gt test lt comments gt lt name gt Country lt name gt lt field gt 3 Rufen Sie die principal id des betreffenden Benutzers ab entsprechende Hinweise finden Sie im Abschnitt Die principal id suchen 4 Rufen Sie ac field update auf um den Feldwert f
125. der Benutzer registriert ist oder war report my events 185 Element Attribut Typ Beschreibung event Container Die Informationen zu einer Veranstaltung sco id Ganzzahl Die eindeutige Kennung der Veranstaltung type Zul ssiger Wert Der Typ des Objekts Bei Veranstaltungen immer event icon Zul ssiger Wert Ein Symbol das das Objekt identifiziert Bei Veranstaltungen immer event permission id Zul ssiger Wert Die Berechtigung des Benutzers f r die Veranstaltung zul ssige Werte finden Sie im Abschnitt permission id name Zeichenfolge Der Name der Veranstaltung domain name url path date begin date end expired duration Zeichenfolge Zeichenfolge Datum Datum Boolescher Wert Uhrzeit Der Dom nenname der Veranstaltungs URL der direkt auf http bzw https folgt und dem eindeutigen Veranstaltungsnamen vorangestellt wird Der Teil der Veranstaltungs URL unmittelbar im Anschluss an den Dom nennamen Das Datum des Veranstaltungsbeginns im Format ISO 8601 Das Datum des Veranstaltungsendes im Format ISO 8601 Ein Wert der angibt ob die Veranstaltung beendet worden ist Der Wert lautet false falls die Veranstaltung noch l uft Die geplante Dauer der Veranstaltung Geben Sie die Zeit nach ISO 8601 an Beispielanforderung https example com api xml action report my events 186 Kapitel 6 Aktionsreferenz Beispielantwort lt xml version 1 0 encoding utf
126. der Verwaltungsberechtigung Ordner Meine Schulung In der Standardkonfiguration hat der betreffende Benutzer Verwaltungsberechtigung Ordner Meine Materialien In der Standardkonfiguration hat der betreffende Benutzer Verwaltungsberechtigung Ordner Meine Veranstaltungen In der Standardkonfiguration hat der betreffende Benutzer Verwaltungsberechtigung Ordner Meine Meetings In der Standardkonfiguration hat der betreffende Benutzer Verwaltungsberechtigung Ordner Meine Vorlagen In der Standardkonfiguration hat der betreffende Benutzer Verwaltungsberechtigung Ordner Gemeinsame Seminare Erfordert Administratorrechte oder Verwaltungsberechtigung Ordner Gemeinsame Vorlagen Ubernimmt die Berechtigungen von Gemeinsame Meetings Enthalt die Ordner Benutzermaterialien Enthalt die Ordner mit den Kursen der Benutzer Enthalt die Ordner mit den Veranstaltungen der Benutzer Enthalt die Ordner mit den Meetings der Benutzer 252 Kapitel 6 Aktionsreferenz Beispielanforderung http example com api xml action sco shortcuts Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt shortcuts gt lt sco tree id 4930295 sco id 2006258748 type my courses gt lt domain name gt http example com lt domain name gt lt sco gt lt sco tree id 4930293 sco id 2006258749 type my events gt lt domain name gt http example com lt domain name gt lt sco gt
127. die Objekte der Schulungsbibliothek zul ssig sind Berechtigungen der Schulungsbibliothek Der Ordner Gemeinsame Schulung in Adobe Connect Enterprise Manager wird auch als Schulungsbibliothek bezeichnet In den Antworten von sco shortcuts hei t dieser Ordner courses lt sco tree id 123456 sco id 123456 type courses gt lt domain name gt example com lt domain name gt lt sco gt Bei jedem Ordner Kurs und Studienplan der Bibliothek handelt es sich um ein SCO Wenn Sie die Schulungsbibliothek durchsuchen wird f r jedes Objekt in der Browser URL die sco id angezeigt Sie erhalten diesen Wert auch durch einen Aufruf von sco contents oder sco expanded contents f r einen Ordner der Schulungsbibliothek F r jeden Kurs und Studienplan sowie f r jedes Materialobjekt der Schulungsbibliothek gelten bestimmte Berechtigungen mit denen definiert wird welcher Benutzer darauf Zugriff erh lt Bei der Entwicklung Ihrer Anwendung sollten Sie die folgenden Berechtigungsebenen ber cksichtigen Berechtigungen f r Kursteilnehmer F r Kurse und Studienpl ne gelten bestimmte Berechtigungen mit denen definiert wird welcher Benutzer eingeschrieben ist und eine Zugangsberechtigung hat Die beiden hier zul ssigen Berechtigungen lauten Eingeschrieben und Verweigert Berechtigungen f r die Schulungsbibliothek F r Kurse Studienpl ne und Ordner der Schulungsbibliothek gelten die Berechtigungen Verweigert oder Verwalte
128. dl string lt x customfieldl gt lt x customfield2 gt string lt x customfield2 gt lt manager gt lt preferences acl id integer lang allowedValue time zone id allowedValue gt lt principal account id integer disabled boolean has children boolean is hidden boolean is primary boolean principal id integer type allowedValue gt lt description gt string lt description gt lt ext login gt string lt ext login gt lt login gt string lt login gt lt name gt string lt name gt 128 Kapitel 6 Aktionsreferenz lt email gt string lt email gt lt first name gt string lt first name gt lt last name gt string lt last name gt lt x customfieldI string lt x customfieldl gt lt x customfield2 gt string lt x customfield2 gt lt principal gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Antwortelement auf der obersten Ebene status Leer mit Attributen Der Status der Antwort code Zulassiger Wert Ein Code zur Angabe des Antwortstatus zulassige Werte finden Sie im Abschnitt status contact Container Informationen zur Kontaktperson eines Principals Wenn der Principal ein Benutzer ist normalerweise die gleiche Information wie in principal email Zeichenfolge Die E Mail Adresse der Kontaktperson first name Zeichenfolge Der Vorname der Kontaktperson last name Zeichenfolge Der Nachname der Kontaktperson manager Container Informationen zum Vorgesetzten eines Benutzers d
129. dung mit dem Server her liest das BREEZESESSION Cookie aus dem Antwort Header und berpr ft dann den Statuscode ok in der Antwort protected void login throws XMLApiException try if breezesession null logout URL loginUrl breezeUrl login login amp password getPassword getLogin URLConnection conn loginUrl openConnection conn connect 294 Anhang A Ein Anwendungsbeispiel InputStream resultStream conn getInputStream Document doc new SAXBuilder false build resultStream String breezesessionString String conn getHeaderField Set Cookie StringTokenizer st new StringTokenizer breezesessionString String sessionName null if st countTokens gt 1 sessionName st nextToken if sessionName null amp amp sessionName equals BREEZESESSION String breezesessionNext st nextToken int semilndex breezesessionNext index0f breezesession breezesessionNext substring 0 semilndex Element root doc getRootElement String status getStatus root if breezesession null I ok equalsIgnoreCase status throw new XMLApiException Could not log into Connect Enterprise catch IOException ioe throw new XMLApiException IO_ERROR ioe catch JDOMException jde throw new XMLApiException PARSE_ERROR jde XML Anforderungen senden Die entsprechenden Beispieldateien sind XMLApiAdapter java und createm
130. e amp url path string amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung author info 1 Zeichenfolge N Informationen zum Autor Wird nur bei Pr sentationen verwendet Enth lt den Namen des Autors oder eine beliebige andere Information author info 2 Zeichenfolge N Weitere Informationen zum Autor Wird nur bei Pr sentationen verwendet Enth lt den Titel des Autors oder eine beliebige andere Information author info 3 Zeichenfolge N Weitere Informationen zum Autor Wird nur bei Pr sentationen verwendet Enth lt den Namen des Unternehmens bei dem der Autors besch ftigt ist oder eine beliebige andere Information date begin Datetime N Das Datum und die Uhrzeit des Datum geplanten Beginns im Format ISO Uhrzeit 8601 Wird nur bei Meetings und Kursen verwendet 254 Kapitel 6 Aktionsreferenz Name Typ Erforderlich Beschreibung date end Datetime N Das Datum und die Uhrzeit des Datum geplanten Endes im Format ISO 8601 Uhrzeit Wird nur bei Meetings und Kursen description email first name folder id lang last name name sco id sco tag Zeichenfolge Zeichenfolge Zeichenfolge Ganzzahl Zul ssiger Wert Zeichenfolge Zeichenfolge Ganzzahl Zeichenfolge J N J N J N verwendet Eine Beschreibung des SCOs die auf der Benutzeroberfl che angezeigt wird Die E Mail Adresse der Kontaktperson f r die Pr sentation wird nu
131. e MSDE oder mit einer Vollversion von Microsoft SQL Server 2000 implementiert werden Ihre ersten API Aufrufe Connect Enterprise Web Services verwaltet die XML API Anforderungen mithilfe eines Servlets Im Datenflussdiagramm wird der Servletbereich durch die API Komponente dargestellt Das API Servlet erh lt die XML Anforderungen von den Clients und gibt die XML Antworten des Webanwendungsservers und der Datenbank zur ck Eine an die XML API gerichtete Anforderung wird als HT TP Anforderungs URL formuliert und vom API Servlet verarbeitet Die Anforderungs URL besteht aus einem Aktionsnamen und ggf einem oder mehreren Parametern in Name Wert Paaren Zum Beispiel https example com api xml action sco info amp sco id 2006334909 Falls Sie Zugang zu einer Enterprise Server oder Enterprise Hosted Umgebung haben in der Sie Ihre API Aufrufe testen k nnen haben Sie die M glichkeit unterschiedliche XML API Aufrufe auszuprobieren Und Adobe empfiehlt auch beim Kennenlernen der API und beim Schreiben von Anwendungen die API Aufrufe in einem Browser zu testen Zun chst sollten Sie aber ein Tool installieren mit dem Sie die HTTP Anforderungen und deren Antwort Header in einem Browser anzeigen k nnen common info in einem Browser aufrufen 1 Optional Installieren Sie ein Tool mit dem Sie die HTTP Header in einem Browser anzeigen k nnen 2 ffnen Sie einen Webbrowser und navigieren Sie zur Anmeldeseite von Connect Enterprise
132. e Zul ssiger Der Datentyp den das Feld annimmt Wert Zul ssige Werte sind text textarea und password comments Zeichenfolge Der Kommentar der in der Anforderung in comments eingegeben wird name Zeichenfolge Der Name des Felds der in der Anforderung in name eingegeben wird Beispielanforderung https example com api xml action custom field update amp object type object type principal amp permission id manage amp account id 624520 amp name jobtitle amp comments test amp field type text amp is required true amp is primary false amp display seq l Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt field field id 2006472106 object type object type principal display seq 1 account id 624520 is primary false permission id manage is required true field type text gt lt comments gt test lt comments gt lt name gt jobtitle lt name gt lt field gt lt results gt Siehe auch report bulk users custom field update 109 group membership update Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung F gt Principals einer Gruppe hinzu oder entfernt Principals aus einer Gruppe Um mehrere Principals und Gruppen zu aktualisieren geben Sie mehrere Datens tze der Parameter group id principal id und is member an Sie erhalten die group id durch den Aufruf von principal 1ist und k nnen die Antwort mit filter t
133. e auch ae l Tield list acl preference update Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Aktualisiert ein Benutzerprofil mit neuen Sprach und Zeitzoneneinstellungen Anforderungs URL http server_name api xml action acl preference update amp acl id integer amp lang allowedValue acl preference update 95 amp time zone id allowedValue amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung acl id Ganzzahl lang Zul ssiger Wert time zone id Zul ssiger Wert session Zeichenfolge J N N Die Kennung des Benutzers dessen Einstellungen aktualisiert werden Kann eine zul ssige principal id sein Die Abk rzung der neuen Sprache zul ssige Werte finden Sie im Abschnitt 1ang Eine ganzzahlige Einstellung f r die neue Zeitzone zul ssige Werte finden Sie im Abschnitt time zone id Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul s
134. e begin gt 2006 05 03T10 15 00 000 07 00 lt date begin gt lt url path gt psychology lt url path gt lt expired gt false lt expired gt lt completed gt true lt completed gt lt row gt lt row sco id 2006745669 type curriculum icon curriculum permission id view gt lt na lt ur lt da lt da lt da lt ur lt ex lt co e gt A Day in the Life lt name gt gt example com day lt url gt te created gt 2006 06 12T14 47 59 903 07 00 lt date created gt te modified gt 2006 06 12T14 47 59 903 07 00 lt date modified gt te begin gt 2006 06 12T14 45 00 000 07 00 lt date begin gt path gt day lt url path gt pired gt false lt expired gt pleted gt false lt completed gt lt row gt lt report my training gt lt results gt report quiz interactions Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt Informationen ber alle Interaktionen bereit die Benutzer mit einem bestimmten Quiz hatten Eine Interaktion kennzeichnet s mtliche Antworten die ein Benutzer auf eine Quizfrage gibt Wenn der Benutzer eine bestimmte Frage mehrmals beantwortet werden s mtliche Antworten ein und derselben Interaktion zugewiesen und erhalten damit auch die gleiche interaction id 194 Kapitel 6 Aktionsreferenz Dieser Bericht stellt die Informationen zu jeder Antwort bereit die ein beliebiger Benutzer jemals auf eine bestimmte Quizfrage gegeben hat Sie
135. e finden Sie im Abschnitt status Beispielanforderung https example com api xml action learning path update amp curriculum id 2006298444 amp current sco id 2007064258 amp target sco id 2007035246 amp path type completion required Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Siehe auch learning path info learning path update 115 login Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Meldet einen Benutzer an Connect Enterprise Server oder an einem Connect Enterprise Hosted Konto an Nach der Anmeldung eines Benutzers m ssen Sie in einer Clientanwendung ein Cookie mit der Bezeichnung BREEZESESSION lesen und speichern das dem HTTP Header der Antwort von login entnommen werden kann Sie m ssen den Wert des Cookies in jede nachfolgende Anforderung aufnehmen die Sie als dieser Benutzer t tigen Wenn es Ihnen nicht m glich ist das Cookie aus dem HTTP Header der Antwort auszulesen k nnen Sie common info aufrufen um den Cookie Wert abzurufen bevor der Benutzer angemeldet wird Danach bergeben Sie den Wert mithilfe des Anforderungsparameters session an login https example com api xml action login amp login oginId amp password password amp session value Sie k nnen den session Parameter auch f r jeden anderen API Aufruf nach login verwenden Wenn Sie nach der Anmeldung z B principa
136. e im Abschnitt status Beispielanforderung https example com api xml action group membership update group id 632398 amp principal id 2006258745 amp is member true Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt learning path info Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Gibt eine Liste der Lernziele f r ein Lernobjekt zur ck das zu einem Studienplan geh rt Ein Lernobjekt ist ein beliebiges SCO das einem Studienplan hinzugef gt wurde Ein Lernziel ergibt sich aus den Regeln die definieren wann ein Lernender mit dem n chsten Lernobjekt fortfahren kann Sie k nnen ein Lernziel erstellen indem Sie Voraussetzung f r Teilnahme Abschluss und Qualifikation definieren So k nnen Sie beispielsweise als Lernziel festlegen dass die Teilnehmer zuerst Willkommen bei ABC GmbH abschlie en m ssen bevor Sie mit Projektverwaltung bei ABC GmbH beginnen k nnen learning path info 111 Durch einen Aufruf von learning path info werden die Module eines Studienplans und ihre einzelnen Lernziele aufgelistet Wenn Sie den vollst ndigen Inhalt eines Studienplans einschlie lich aller Materialien Meetings und anderer Objekte anzeigen m chten m ssen Sie sco expanded contents aufrufen Anforderungs URL http server_name api xml action learning path info amp curriculum id integer amp sco id integer am
137. e wie das sco Element Beispielanforderung https example com api xml action sco info amp sco id 2006320683 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt sco account id 624520 disabled display seq 0 folder id 2006258750 icon meeting lang en max retries sco id 2006320683 source sco id 1625529 type meeting version 0 gt lt date begin gt 2006 05 04T11 15 00 000 07 00 lt date begin gt lt date created gt 2006 05 04T11 27 47 087 07 00 lt date created gt lt date end gt 2006 05 04T12 15 00 000 07 00 lt date end gt lt date modified gt 2006 05 04T11 27 47 087 07 00 lt date modified gt lt name gt Technology and Law Review Meeting lt name gt lt url path gt tlawreview lt url path gt lt sco gt lt source Sco gt lt source sco account id 624520 display seq 0 folder id 625529 icon meeting lang en max retries sco id 1625529 source sco id 8888 type meeting version 0 gt lt date created gt 2004 10 05T00 49 30 217 07 00 lt date created gt lt date modified gt 2005 01 04T15 03 25 937 08 00 lt date modified gt lt name gt Default Meeting Template lt name gt lt url path gt defaultMeetingTemplate lt url path gt lt source sco gt lt source sco gt lt results gt sco info 241 SCO MOVE Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Verschiebt ein SCO aus einem
138. eben wird sofern Sie die Antwort nicht mit einem Filter einschr nken Eine Liste der Gruppen in Ihrem Konto erhalten Sie dagegen mit principal list und einem Filter auf die Felder type und is member https example com api xml action principal list amp filter type group amp filter is member true Allerdings gibt filter type group nur die von Ihnen erstellten Gruppen und nicht die integrierten Gruppen auf dem Server zur ck Diese integrierten Gruppen haben einen anderen type Wert als group zum Beispiel admins und authors eine Liste der zul ssigen Werte finden Sie im Abschnitt type Sie k nnen die Antwort mit filter type filtern und so die gew nschte Gruppe festlegen und dann nach principal id auswerten Danach bergeben Sie in einer weiteren Anforderung die principal id als group id an einen principal 1ist Aufruf Anforderungs URL http server_name api xml action principal list amp group id integer amp filter definition value amp sort definition value amp session BreezeSessionCookieValue 132 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung group id Ganzzahl N Die Kennung einer Gruppe Entspricht der principal id eines Principals mit dem type Wert group session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern
139. ect Enterprise Support Center Wenn Sie technischen Support brauchen finden Sie im Support Center aktuelle Informationen wie technische Hinweise Connect Enterprise Pr sentationen und Einzelheiten zum Support Programm Und in den Foren k nnen Sie sich mit an Diskussionen mit Gleichgesinnten ber technische Probleme beteiligen Connect Enterprise Licensed Support Center Das Licensed Support Center enth lt Dokumentationen und andere Ressourcen f r Kunden von Adobe Connect Enterprise Server 6 XML und Webservices Ressourcen Web Services Primer auf xml com ist eine gute Einf hrung in das Thema Webservices Das XML Tutorial auf der Website von W3Schools w3schools com bietet Hinweise zu den ersten Schritten mit XML Das XPath Tutorial ebenso auf der W3Schools Website w3schools com zu finden beschreibt XPath und dessen Funktionen zum Parsen von XML Dokumenten die damit in einer Anwendung ausgewertet werden k nnen Das XSLT Tutorial das dritte Tutorial auf dieser Website w3schools com erkl rt XSL Transformations mit dem Sie XML Daten in andere Formate konvertieren k nnen Die XSL Transformations XSLT Spezifikation auf der W3C Website w3 org ist die offizielle XSLT Definition vom Standardkommittee das diesen Standard entwickelt hat Numerische Darstellung des Datums und der Uhrzeit auf der Website der International Organization for Standardization iso org enth lt Informationen zur Verwendung des Standardformats ISO 8601 f r
140. eeting version 1 gt Zwischen dem Erstellen und dem Aktualisieren eines Meetings mit sco update gibt es folgende Unterschiede m Zur Erstellung eines Meetings wird eine folder id bergeben m w hrend f r die Aktualisierung eines vorhandenen Meetings eine sco id verwendet wird Nur bereits vorhandene Meetings weisen eine sco id auf Ein Meeting erstellen In einer Anwendung m ssen Sie zun chst die Informationen zusammentragen die Sie zum Erstellen oder Aktualisieren eines Meetings ben tigen wie den Meetingnamen das Datum die Uhrzeit etc Sobald Sie ber diese Daten verf gen k nnen Sie mit einer Methode wie updateSco die Aktion sco update aufrufen Bei sco update sollten Sie sicherstellen dass Sie den Wert von type auf meeting setzen Optional k nnen Sie zudem einen Sprachcode f r den Meetingraum festlegen zum Beispiel mit lang en https example com api xml action sco update amp folder id 2006258750 amp description nov amp aname Nov 20A11 20Hands 20Meeting amp type meeting amp lang en amp date begin 2006 11 11T09 00 amp date end 2006 11 11T17 00 Die Methode updateSCO verdeutlicht wie sco update in Java aufgerufen werden kann wenn Sie ber die ben tigten Informationen zum Meeting verf gen public String updateSCO String action SCO sco throws XMLApiException try StringBuffer sb new StringBuffer Map data sco getUpdateFields mis f CREATE equals action sb append folder id sco getF
141. eeting SUMMAary 0 0 eee eee eens 178 r poOrt my COUrseS 252 095 2ER 181 report my eVents a casa ara ecke ne er sia ue We alge asl Sane Wel 184 report my MeetingS 0 cence eens 187 report my training 0 cence eens 190 report quiz interactions 00 cece eee eens 194 report quiz question answer distribution 198 report quiz question distribution uaaa aaea cc eee eee 202 report quiz question reSpONSe 2 ee eee 204 report quiz SUMMALY 2 ee ee ene eens 207 report quiz takers oaren a Ema aE cece eens 209 rEpOrt AUGtas n ran ee A ein Mica dienes eat 213 report s slides m nna 2a he a ee a AAS 216 rept SCO VIEWS nein el ee i data 218 report user trainings taken 22 2222 cece eee eens 220 report user training transcripts 0 0 ccc cee eee 224 SEO CONtents Hr es Mads See ai er hs Sena 228 sco delete unsern En ei ee ie 232 sco expanded contents 00 ccc cece eee eens 234 SCO INIO tdi dhl ode eee ead ie hae bee ad 237 SCO MOVE en nen lees Seth hate Bue door boats es 242 SCOSNAV waa west cee hee Bde ek ed lacy oe Be pee ee Ree aa 243 SCO SEAlch ad ekg okie dud Ran decd ah 246 sco shortcuts na ara 250 SCOsUPCate is ott ate en ra ee Be 253 SCO lt UPIOAG as een serie 258 USEFFACCOUNTSH nn a ede asad insted O aE ENEE nie have ay E A EEE 261 user transcript update 2 0 0 0 eee eens 264 user update pwd wa sii ce 2 Nenn kein eher 266
142. eeting jsp SISMNIH Sobald der Benutzer angemeldet ist sollten Sie mithilfe einer allgemeinen Anforderungsmethode eine Anforderung an den Server senden in der Sie einen Aktionsnamen und eine Anforderungszeichenfolge angeben XML Anforderungen senden 295 Die Methode request des Beispiels bernimmt eine Aktion und eine Zeichenfolge und sendet das BREEZESESSION Cookie im Anforderungs Header zur ck an den Server protected Element request String action String queryString throws XMLApiException try if breezesession null login URL url breezeUrl action queryString URLConnection conn url openConnection conn setRequestProperty Cookie BREEZESESSION breezesession conn connect InputStream resultStream conn getInputStream Document doc new SAXBuilder false build resultStream return doc getRootElement catch IOException ioe throw new XMLApiException A communication error occurred ioe catch JDOMException jde throw new XMLApiException A parsing error occurred jde XML Antworten analysieren Die entsprechenden Beispieldatei ist XMLApiAdapter java SI3MNIH Wenn Sie eine XML Anforderung an Connect Enterprise senden gibt der Server eine XML Antwort zur ck Sie m ssen diese Antwort ihre Werte und Statuscodes analysieren und auswerten Eine M glichkeit zur Analyse einer solchen Antwort besteht in der Abfrage der XML
143. eiben m chten m ssen Sie zuerst entscheiden ob Sie die Benutzer direkt einschreiben oder zuerst eine Gruppe erstellen und dann die Gruppe einschreiben Adobe empfiehlt f r das Einschreiben von Benutzern in Kursen die folgenden bew hrten Verfahren m Schreiben Sie die Benutzer mithilfe von permissions update in den Kurs ein Auf diese Weise k nnen Sie 1 000 10 000 oder noch mehr Benutzer mit einem einzigen API Aufruf einschreiben m Weisen Sie die Benutzer einer Gruppe zu und schreiben Sie die Gruppe ein Dies ist aber nur dann sinnvoll wenn Sie diese Gruppe erneut verwenden m chten beispielsweise um die betreffenden Benutzer auch in anderen Kursen einzuschreiben Hierbei k nnen Sie aber nur 200 Benutzer auf einmal hinzuf gen Eine gro e Zahl von Benutzern ab 1 000 direkt in einem Kurs einschreiben 1 Rufen Sie die sco id des betreffenden Kurses ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Kurses oder Studienplans suchen 2 Rufen Sie die principal id jedes Benutzers ab den Sie einschreiben m chten Dabei haben Sie folgende M glichkeiten m Rufen Sie principal list mit Filtern auf um genau die Benutzer zu erhalten die Sie einschreiben m chten https example com api xml action principal list amp filter type user amp filter type sales m Lesen Sie die gew nschten Werte aus einer Datei ein Eine gro e Zahl von Benutzern einschreiben 79 3 Schreiben Sie eine Methode die permissi
144. eibung type Zul ssiger Wert Der Typ des Principals der die Sitzung gestartet hat normalerweise user zul ssige Werte f r Principaltypen finden Sie im Abschnitt type name Zeichenfolge Der vollst ndige Name des Benutzers der die Sitzung am Server gestartet hat login Zeichenfolge Der Anmeldename des Benutzers der am Server angemeldet ist H ufig die E Mail Adresse dieses Benutzers user agent Zeichenfolge Die Kennung des Webbrowsers oder Clients mit dem die Sitzung auf dem Server gestartet wurde Beispielanforderung https example com api xml action common info Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt common locale en time zone id 4 gt lt cookie gt breezsi4dundhdsrw2fq6 lt cookie gt lt date gt 2006 09 08T11 17 04 470 07 00 lt date gt lt host gt https example com lt host gt lt local host gt localserverl7 lt local host gt lt url gt api xml action common info lt url gt lt version gt connect_6000 lt version gt lt account account id 624520 gt lt user user id 2006258745 type user gt lt name gt Joy Smith lt name gt lt login gt joy acme com lt login gt lt user gt lt user agent gt Mozilla 4 0 compatible MSIE 6 0 Windows NT 5 1 SV1 NET CLR 1 1 4322 lt user agent gt lt common gt lt results gt 100 Kapitel 6 Aktionsreferenz custom fields Verf gbarkeit Breeze 4 und 5 Con
145. eine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report quiz summary gt lt row num questions integer average score integer low score integer high score integer numtaken integer numdistincttaken integer maxpossiblescore integer asset id integer gt lt report quiz summary gt lt results gt report quiz summary 207 Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status report quiz summary Container Enth lt Informationen zum Quiz row Leer mit Eine Zusammenfassung des Attributen Quiz Gibt unter Umst nden mehr als ein row Element zur ck wenn maxpossiblescore bei anderen Kopien unterschiedlich ist num questions Ganzzahl Die Anzahl der Fragen im Quiz average score Ganzzahl Die durchschnittliche Punktzahl aller Benutzer die das Quiz beantwortet haben low score Ganzzahl Die niedrigste Punktzahl die ein Benutzer bei dem Quiz erhalten hat high score Ganzzahl Die h chste Punktzahl die ein Benutzer bei dem Quiz erhalten hat numtaken Ganzzahl Die Angabe wie oft das Quiz bisher beantwortet wurde numdistincttaken Gan
146. eise k nnen Sie sicherstellen dass die Teilnehmer ihre Lernziele auch erreichen Kurse und Materialien k nnen Module eines Studienplans sein und Materialobjekte k nnen in mehreren Kursen und Studienpl nen verwendet werden Alle in Connect Training gespeicherten Materialobjekte Kurse und Studienpl ne sind SCOs und haben eine eigene eindeutige sco id Dabei k nnen Materialobjekte und Kurse nach dem SCORM Standard kombiniert und wiederverwendet werden F r die Entwicklung von Schulungsanwendungen empfiehlt Adobe die folgenden XML API Aktionen permissions update Einschreiben von Benutzern in Kursen und berpr fen der entsprechenden Berechtigungen zum Starten und Abschlie en der Kurse group membership update Hinzuf gen von Benutzern zu Gruppen wenn ganze Gruppen eingeschrieben werden sollen report my training Auflisten s mtlicher Kurse und Studienpl ne des aktuellen Benutzers einschlie lich der URLs mit denen auf die Kurse und Studienpl ne zugegriffen werden kann 71 report curriculum taker Abfragen von Detailinformationen zum Fortschritt eines Benutzers innerhalb eines Studienplans report user trainings taken Anzeigen des aktuellen Status der Kurse und Studienpl ne eines Benutzers report user training transcripts Auflisten aller Lernzielkopien und Punktzahlen eines Benutzers Diese Aktionen k nnen bei Kursen Studienpl nen und Schulungsordnern angewendet werden Dabei gelten die Berechtigungen die f r
147. eldename des Benutzers date created Datetime Datum Uhrzeit auf dem Server Das Datum und die Uhrzeit des letzten Versuchs des Benutzers das Quiz zu beantworten 212 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung principal name Zeichenfolge Der vollst ndige Name des Benutzers der das Quiz beantwortet hat override Boolescher Eine Einstellung mit der angegeben Wert wird ob ein Schulungsmanager die Punktzahl eines Benutzers aus dem Quiz ndern kann Beispielanforderung https example com api xml action report quiz takers amp sco id 2006334909 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report quiz takers gt lt row transcript id 2006337854 sco id 2006334909 principal id 2006258745 status incomplete score 0 max score 20 asset id 2006334911 permission id attempts 4 time taken 12593 certificate answered survey 1 version 1 gt lt name gt California State Quiz lt name gt lt login gt joy acme com lt login gt lt date created gt 2006 05 16T11 14 47 000 07 00 lt date created gt lt principal name gt Joy Smith lt principal name gt lt override gt false lt override gt lt row gt lt report quiz takers gt lt results gt report quotas Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt Informationen zu den Kontingenten zur ck die f r Ihre C
148. ement mit weiteren Informationen zum Statuscode invalid Element Attribut Typ Beschreibung invalid Leer mit Informationen dar ber warum der Attributen Aufruf ung ltig war field Zeichenfolge Der Name des Anforderungsparameters der ung ltig war oder fehlte type Zul ssiger Wert Der Typ des ung ltigen oder fehlenden Felds subcode Zul ssiger Wert Ein Code als Erkl rung warum die Anforderung ung ltig war zul ssige Werte finden Sie in der folgenden Tabelle Die folgende Tabelle enth lt die zul ssigen Werte von subcode wenn code als invalid erkannt wird Wert Beschreibung duplicate Der Aufruf versuchte ein doppeltes Element in einem Kontext einzuf gen in dem einmalige Elemente erforderlich sind format Ein bergebener Parameter lag im falschen Format vor illegal operation Der angeforderte Vorgang verst t gegen Integrit tsregeln z B das Verschieben eines Ordners in sich selbst missing Ein erforderlicher Parameter fehlt no such item Die ausgew hlte Ressource ist nicht vorhanden range Der Wert liegt au erhalb des zul ssigen Wertebereichs Zur ckgegeben von allen Aktionen der Connect Enterprise Web Services XML API status 283 Beispiele Dies ist eine g ltige Antwort lt status code ok gt Diese Antwort ist ungiiltig lt status code invalid gt lt invalid field principal id type id subcode missing gt lt status gt status Attribut Beschrei
149. en vorbereiten Er ffnen r 4 4 xs Ergebnisse einer Abstimmung abrufen 1 Stellen Sie sicher dass der Veranstalter des Meetings die Abstimmung geschlossen hat Die Abstimmungsergebnisse werden bis zum Schlie en der Abstimmung im Meeting zwischengespeichert 2 Rufen Sie die sco id des betreffenden Meetings ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Meetings suchen 3 Rufen Sie report quiz interactions mit der sco id des Meetings auf https example com api xml action report quiz interactions amp sco id 2007071193 Sie k nnen die Antwort auch mithilfe von Filtern einschr nken zum Beispiel filter response berpr fung s mtlicher Benutzer auf eine bestimmte Antwort filter interaction id berpr fung s mtlicher Antworten einer Umfrage in einem Meeting kann es mehrere Umfragen geben Abstimmungsergebnisse abrufen 67 4 Werten Sie die Antwort nach response name oder einem anderen Wert aus lt row display seq 1 transcript id 2007071200 interaction id 2007027923 sco id 2007071193 score 0 gt lt name gt jazz doe lt name gt lt sco name gt Thursday Meeting lt sco name gt lt date created gt 2006 08 03T12 29 09 687 07 00 lt date created gt lt description gt What is your favorite color lt description gt lt response gt 4 lt response gt lt row gt Meetings mit externer Authentisierung starten Sobald sich ein Benutzer an Ihrem Netzwerk anmeldet und
150. en Server mit den gleichen Web Services XML APIs auf die auch Sie aus der benutzerdefinierten Anwendung heraus verwenden Das Material wird im Allgemeinen ber den HTTP Port 80 oder den HTTPS Port 443 bertragen Bei dem Material kann es sich um Folien HT TP Seiten und Adobe Macromedia Flash Dateien oder auch um Dateien handeln die ber den Dateifreigabe Pod bertragen werden Die genannten Port Nummern sind die Standard Ports aber Sie k nnen diese auch ndern Informationen hierzu finden Sie im Connect Enterprise Installations und Konfigurationshandbuch Gestreamte Kommunikation in Echtzeit wird von Flash Media Server ber RTMP 1935 bertragen Gestreamte Kommunikation enth lt beispielsweise Audio und Videodaten Webcam und FLV freigegebene Dateien und Chat Auch der Meetingstatus wird ber den RTMP Port 1935 verwaltet Komponenten von Connect Enterprise Sowohl Enterprise Server als auch Enterprise Hosted bestehen aus zwei Serverkomponenten die jeweils eine SQL Datenbank nutzen Der Webanwendungsserver Der Webanwendungsserver ist das Gehirn von Connect Enterprise Er enth lt die gesamte Unternehmenslogik die f r den Transfer des Materials zu den Benutzern erforderlich ist und f hrt diese aus Au erdem verwaltet er die Zugangssteuerung die Sicherheit die Kontingente die Lizenzen und die Verwaltungsfunktionen wie Clustering Ausfallsicherung und Replikation Der Webanwendungsserver verwaltet zudem Connect Enterprise M
151. en kann Lautet dieser Wert dagegen true k nnen Sie ihn mithilfe von custom field update ndern Anforderungs URL http server_name api xml action custom fields delete amp field id string amp object type allowedValue amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung field id Zeichenfolge J Die Kennung des Felds das gel scht object type Zeichenfolge J werden soll Rufen Sie custom fields delete auf um die Kennung zu erhalten Sie wird im Attribut field id des Elements field zur ckgegeben Der Typ des SCOs f r welches das Feld definiert wurde zul ssige Werte finden Sie im Abschnitt type session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 lt results gt lt status code allowedValue gt lt results gt encoding utf 8 gt 104 Kapitel 6 Aktionsreferenz Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zulassiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Beispielanforderung https example com api xml action custom fields delete amp field id 200633871
152. enden Werte annehmen Wert Beschreibung required optional optional no self reg Ein fur das Benutzerkonto erforderliches benutzerdefiniertes Feld Ein optionales Feld das wahrend der Sofortregistrierung angezeigt wird Ein optionales Feld das wahrend der Sofortregistrierung ausgeblendet wird 290 Kapitel 8 Allgemeine Referenz ANHANG A Ein Anwendungsbeispiel Dieses Handbuch enth lt ein mit firstapp bezeichnetes Anwendungsbeispiel das auf der Produkt CD im Ordner der Dokumentationen und Beispiele zur Verf gung steht Dieses Anwendungsbeispiel wurde in Java und JSP in einer Model View Controller Architektur geschrieben und kann auf jedem beliebigen Anwendungsserver mit einem J2EE Servlet Container ausgef hrt werden Das Beispiel veranschaulicht die Implementierung von Connect Enterprise Meeting Funktionen in einer benutzerdefinierten Java Anwendung oder in einem Portal Es verdeutlicht die Anmeldung eines Benutzers die Auflistung der Meetings dieses Benutzers sowie die Erstellung nderung und L schung von Meetings Sie k nnen den Code des Anwendungsbeispiels nach Ihren Vorstellungen einsetzen ndern oder erweitern S mtliche Beispieldateien auf die in diesem Anhang verwiesen wird sind in der Beispieldatei firstapp zip enthalten Anweisungen f r die Installation und die Ausf hrung dieser Anwendung finden Sie in der ReadMe Datei Bei der Erstellung und Entwicklung Ihrer Anwendung sollten
153. ens tze angeben Sie k nnen mit einem Aufruf von permissions update ber 200 Berechtigungen auf einmal ndern Rufen Sie permissions update auf um einem Benutzer die Zugriffsberechtigung f r ein Acrobat Connect Meeting einen Kurs einen Studienplan oder ein anderes SCO zu erteilen So k nnen Sie durch den Aufruf von permissions update beispielsweise folgende Aufgaben ausf hren m Einladung eines Benutzers zu einem Meeting als Teilnehmer Moderator oder Veranstalter mit einer permission id mit dem Wert view mini host oder host m Entfernung des Zugriffs eines Benutzers als Teilnehmer Moderator oder Veranstalters auf ein Meeting mit einer permission id mit dem Wert remove m Einschreibung von Benutzern in Kursen mit einer permission id mit dem Wert view permissions update Falls Sie mehrere Datens tze mit drei Feldern verwenden und es darunter irgendwelche fehlerhaften Datens tze gibt zum Beispiel mit einer falschen ac id oder principal id gibt permissions update den Status ok zur ck Die korrekten Datens tze werden ausgef hrt die fehlerhaften dagegen nicht Anforderungs URL http server_name api xml action permissions update amp acl id integer amp principal id integer amp permission id allowedValue amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung acl id Ganzzahl J Die Kennung des SCOs eine sco id dessen Berechtigungen Sie aktualisie
154. enutzer eingeschrieben ist https example com api xml action report my training Einen Benutzer einschreiben 77 5 Durchsuchen Sie die row Elemente der Antwort nach den Werten die Sie anzeigen m chten lt row sco id 2007035246 type content icon course permission id view gt lt name gt Java 101 lt name gt lt url gt example com javal01 lt url gt lt date created gt 2006 07 20T17 21 11 940 07 00 lt date created gt lt date modified gt 2006 07 20T17 21 38 860 07 00 lt date modified gt lt date begin gt 2006 07 20T17 15 00 000 07 00 lt date begin gt lt url path gt javal01 lt url path gt lt expired gt false lt expired gt lt completed gt false lt completed gt lt row gt Neue Benutzer mithilfe von Ablaufen einschreiben 1 Rufen Sie principal update auf um einen neuen Benutzer zu erstellen und ihm eine Willkommens E Mail zu senden https example com api xml action principal update first name jazz amp last name doe amp login jazz doe com amp password hel lo amp type user amp send email true amp has children 0 amp emai l jazz doe com Denken Sie daran das Senden der E Mail durch send email true zu gew hrleisten Melden Sie den Benutzer am Server an https example com api xml action login amp login jazz doe com amp password hel lo amp session breezma6zor9rdfps8h6a Weitere Hinweise zum Aufrufen der Aktion login finden Sie im Abschnitt Aus einer Anwendung heraus anmelden
155. eption jde throw new XMLApiException PARSE_ERROR jde Benutzerdaten anzeigen 299 Meetings eines Benutzers auflisten Die entsprechenden Beispieldateien sind XMLApiAdapter java und SCO java SISMNIH Gegebenenfalls besteht in Ihrer Anwendung die Notwendigkeit alle Meetings eines Benutzers aufzulisten In diesem Fall k nnen Sie in ihrem Anwendungsdesign unter Umst nden M glichkeiten definieren die gew nschten Meetings auszuw hlen und die erforderlichen Informationen anzuzeigen Die folgende Abbildung zeigt ein Beispiel einer Meetingliste Geplante Meetings il October Company Meeting Enter 10 01 2006 Host 9 00 AM Abgelaufene Meetings g EN Monday Night Football Enter 05 17 2004 Participant 3 30 PM il seminar invitee Enter 02 13 2005 Host 12 00 AM How to write a Novel Enter 09 06 2006 Presenter 10 00 PM Gil September All Hands Meetin Enter 09 15 2006 Host 9 00 AM ii Platinum Support Team Meetin Enter 08 02 2006 Participant 11 45 AM Um die Meetings eines Benutzers mithilfe der XML API aufzulisten rufen Sie report my meetings mit oder ohne Filter auf Ohne Filter gibt report my meetings s mtliche Meetings eines Benutzers zur ck https example com api xml action report my meetings Wenn Sie den Filter filter expired false hinzuf gen erhalten Sie nur die Meetings die gerade laufen und f r die Zukunft geplant sind https example com api xml action repo
156. er Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status report my training Container Die vollst ndige Liste mit den Kursen und Studienpl nen in die der Benutzer eingeschrieben ist row Container Informationen zu einem Kurs in den der Benutzer eingeschrieben ist sco id Ganzzahl Die eindeutige Kennung des Kurses oder Studienplans type Zul ssiger Der Typ des Objekts zul ssige Wert Werte finden Sie im Abschnitt type icon Zul ssiger Das Symbol mit dem das Objekt Wert in Connect Enterprise Manager identifiziert wird zul ssige Werte finden Sie im Abschnitt icon Wenn type den Wert content hat wird mit icon das Material beschrieben permission id Zulassiger Die Berechtigung des Principals Wert f r das Objekt zul ssige Werte finden Sie im Abschnitt permission id name Zeichenfolge Der Name des Kurses oder description Zeichenfolge Studienplans Die Beschreibung des Kurses oder Studienplans 192 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung ur Zeichenfolge Der Teil der URL des Kurses oder Studienplans der den Dom nennamen und den eindeutigen Namen umfasst aber ohne http oder https date created Datetime Das Datum und die Uhrzeit der Datum Kurs bzw Studienplanerstellung Uhrzeit date modified Datetime Das Datum und die
157. er Frage im Quiz zur ck Sie k nnen die Antwort allerdings nach einem bestimmten Benutzer einer bestimmten Interaktion oder einer bestimmten Antwort filtern Weitere Hinweise finden Sie bei der Beschreibung der Filter im Abschnitt filter definition Eine Interaktion ist eine Kombination aus einem Benutzer und einer Frage Wenn der Benutzer eine bestimmte Frage mehrmals beantwortet werden alle Antworten ein und derselben Interaktion zugewiesen und erhalten damit auch die gleiche interaction id 204 Kapitel 6 Aktionsreferenz Anforderungs URL http server_name api xml action report quiz question response amp sco id integer amp filter definition value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung einer Pr sentation die ein Quiz enth lt session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report quiz question response gt lt row principal id integer interaction id string gt lt user name gt string lt user name gt lt response gt string lt response gt lt date created gt datetime lt date created g
158. er ebenfalls ein Principal ist principal Container Informationen zum Principal account id Ganzzahl Die Kennung des Kontos zu dem der Principal geh rt disabled Datetime Datum Wenn das Konto des Principals Uhrzeit g ltig ist wird ein Nullwert in der Form zur ckgegeben Wurde das Konto deaktiviert wird das Datum der Deaktivierung angezeigt principal nfo 129 Element Attribut Typ Beschreibung description ext login login name email first name has children is hidden is primary principal id type Boolescher Wert Boolescher Wert Boolescher Wert Ganzzahl Zul ssiger Wert Zeichenfolge Zeichenfolge Zeichenfolge Zeichenfolge Zeichenfolge Zeichenfolge Gibt an ob der Principal untergeordnete Objekte hat Im Gegensatz zu Benutzern k nnen Gruppen untergeordnete Objekte haben Dieser Wert gibt also an ob es sich bei dem Principal um eine Gruppe handelt Gibt an ob der Principal in Enterprise Manager oder in Ihrer Anwendung ausgeblendet wird true oder nicht false Gibt an ob der Principal eine integrierte Gruppe ist t rue oder nicht false Die Kennung des Principals Der Typ des Principals zulassige Werte finden Sie im Abschnitt type Bei einer Gruppe der Gruppenname Bei einem Benutzer der Anmeldename der aus einem externen Netzwerk stammt In der Standardkonfiguration der gleiche Wert wie login daher muss dieser Wert be
159. er eines Kurses zur ck Bei einem Principal gibt die Antwort ggf auch die Anzahl der Kurse an die eine Person abgeschlossen bestanden oder nicht bestanden hat Bei Kursen wird die Anzahl der Benutzer zur ckgegeben die diesen Kurs abgeschlossen bestanden oder nicht bestanden haben Die sco id eines Kurses muss angegeben werden Wenn sowohl eine principal idalsauch eine sco id angegeben werden so gibt der Aufruf die Daten eines bestimmten Principals zur ck der am angegebenen Kurs teilnimmt oder teilgenommen hat 162 Kapitel 6 Aktionsreferenz Anforderungs URL http server_name api xml action report course status amp sco id integer amp principal id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung principal id Ganzzahl N Die Kennung des Principals dessen Kursstatus Sie wissen m chten sco id Ganzzahl J Die eindeutige Kennung des Kurses dessen Status Sie wissen m chten Wenn Sie keine principal idangeben bezieht sich die Antwort auf den Kurs Bei Angabe einer principal idgilt die Antwort f r den angegebenen Principal in diesem Kurs session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt
160. eraus anmelden m In Kapitel 3 Grundlagen um die drei der API zu Grunde liegenden Konzepte zu verstehen m In Kapitel 4 Meetings wenn Sie aus einer Anwendung heraus Meetings erstellen und verwalten m chten m In Kapitel 5 Schulungen wenn Sie eine Schulungsanwendung erstellen m chten Ihre ersten API Aufrufe 21 22 Kapitel 1 Architektur KAPITEL 2 Anmeldung und Anforderungen In diesem Kapitel wird erkl rt wie sich ein Benutzer aus Ihrer Anwendung heraus anmelden Anforderungen formulieren die Antworten auswerten und sich wieder abmelden kann Es gibt mehrere M glichkeiten diese Aufgaben auszuf hren Diese h ngen von Ihrer Entwicklungsumgebung der Serverkonfiguration und dem Anwendungsentwurf ab Aus einer Anwendung heraus anmelden Bei jeder Anwendung die Sie selbst schreiben und die die Adobe Connect Enterprise Web Services Funktionen verwendet oder das System eines Drittanbieters integriert muss zun chst eine Anmeldung an Adobe Connect Enterprise Server 6 oder an ein Adobe Connect Enterprise Hosted 6 Konto erfolgen Die einfachste M glichkeit hierzu besteht in einem Aufruf der Aktion login Aber es k nnen auch andere Anmeldeverfahren eingesetzt werden und zwar je nachdem ob Sie Cookie Management verwenden ber einen lizenzierten Server oder ein gehostetes Konto verf gen und die Authentisierung direkt ber Connect Enterprise oder ber eine externe Stelle vornehmen Je nach
161. erstellen 57 301 f r einen Gast starten 69 gleichzeitige Teilnehmer 65 in Java auflisten 300 in Java erstellen 302 Liste f r Benutzer 301 Meetingraum URLs erstellen 56 305 mit externer Authentisierung starten 68 mit Vorlage erstellen 60 Moderatoren hinzuf gen 58 Nutzung berechnen 64 Nutzung pro Benutzer 64 ffentlich 58 privat 58 sco id suchen 53 Sitzungen 176 310 Index Teilnehmer entfernen 63 Teilnehmer hinzuf gen 58 Veranstalter hinzuf gen 58 von Benutzern anzeigen 55 Mehrere Benutzer einschreiben 79 Microsoft SQL Server 11 18 Moderatoren hinzuf gen 58 my content Ordner 47 my courses Ordner 47 my events Ordner 47 my meeting templates Ordner 47 my meetings Ordner 47 N Neue Aktionen 87 no access Statuscode 34 no data Statuscode 34 Nutzung Meetings 64 O object type Attribut 279 ffentliche Meetings Benutzer entfernen 63 erstellen 58 P Parameter mit unterschiedlichen Namen 50 291 permission id 280 denied 73 manage 73 Meetings 56 view 73 permissions info 120 permissions reset 124 permissions update 125 in Meetinganwendungen 53 in Schulungsanwendungen 71 principal id des aktuellen Benutzers 38 suchen 38 principal info 127 principal list Browsertests 19 Definition 132 principal list by field 135 principal update Beispiel 40 Definition 140 example 40 41 Principals alle auflisten 39 Berechtigungen berpr fen 51 Definition 37 l schen 139 suchen princi
162. ert name Zeichenfolge ur Zeichenfolge date created Datetime date modified Datetime date begin Datetime date end Datetime url path Zeichenfolge expired Boolescher Wert completed Boolescher Wert Datum Uhrzeit Datum Uhrzeit Datum Uhrzeit Datum Uhrzeit Informationen zu einem Kurs in dem der Benutzer eingeschrieben ist Die eindeutige Kennung des Kurses Der Typ des Kurses zul ssige Werte finden Sie im Abschnitt type Der Typ des Symbols mit dem der Kurs auf der Benutzeroberflache identifiziert wird Bei Kursen immer course Die Berechtigung die ein Benutzer fur den Kurs hat zulassige Werte finden Sie im Abschnitt permission id Der Name des Kurses Die URL unter der ein Benutzer auf den Kurs zugreifen kann Dieser Wert schlie t den Dom nennamen und die Kennung des Kurses ein Das Datum und die Uhrzeit der Kurserstellung Das Datum und die Uhrzeit der letzten nderung des Kurses Das Datum und die Uhrzeit der ersten Verf gbarkeit des Kurses f r Benutzer Das Datum und die Uhrzeit des Kursendes Der Teil der Kurs URL unmittelbar im Anschluss an den Dom nennamen der den Kurs eindeutig identifiziert Gibt an ob der Kurs bereits abgelaufen ist true wenn ja false wenn nicht Gibt an ob der Benutzer den Kurs abgeschlossen hat true wenn ja false wenn nicht Beispielanforderung https example com api xml action report my courses report my courses 18
163. ertificate Authority amp RTMPS 443 gt D Flash Player Flash Media Server 3 RTMP 1935 gt RTMPT 830 De SQL Datenbank Datenfluss zwischen Connect Enterprise und Clientanwendungen Die Daten k nnen dabei mit SSL verschl sselt oder unverschl sselt gesendet werden 14 Kapitel 1 Architektur Unverschl sselt Wenn die Daten unverschl sselt bertragen werden laufen die Verbindungen ber HTTP und das Adobe Real Time Messaging Protokoll RTMP Dabei gelten die entsprechenden Pfade der folgenden Tabelle 1 3a alternativ 4a alternativ Der Webbrowser des Clients fragt Uber den HTTP Port 80 ein Acrobat Connect Professional Meeting oder eine Material URL ab die Verbindungen k nnen auch etwas anders laufen Der Webserver reagiert mit der bertragung des Materials oder liefert dem Clientbrowser die Daten mit denen dieser auf Acrobat Connect Professional zugreifen kann Adobe Flash Player fordert die Verbindung mit Adobe Macromedia Flash Media Server ber RTMP 1935 und HTTP 80 an Flash Media Server reagiert Eine dauerhafte Verbindung wird ge ffnet ber welche die Meetingdaten zum Browser gestreamt werden Flash Player fordert eine Verbindung mit Flash Media Server an erh lt aber unter Umst nden nur eine getunnelte Verbindung ber RTMPT 80 Flash Media Server reagiert Eine getunnelte Verbindung wird ge ffnet ber welche die Meetingdaten zu
164. erver_name api xml action report quiz question answer distribution amp interaction id integer amp sco id integer amp filter definition va lue amp sort definition value amp session BreezeSessionCookieValue 198 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung interaction id Ganzzahl N Die Kennung mit der s mtliche Antworten eines Benutzers auf eine Quizfrage gekennzeichnet werden sco id Ganzzahl J Die eindeutige Kennung einer Pr sentation oder eines Kurses die bzw der ein Quiz enth lt session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report quiz question answer distribution gt lt row display seq integer interaction id integer score integer asset id integer num selected integer gt lt response gt string lt response gt lt row gt lt report quiz question answer distribution gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie i
165. ervices Ihnen die Integration von Meeting Schulungs und Veranstaltungsfunktionen in Ihre Anwendungen Unter Umst nden nutzen Sie ein zentrales Benutzermanagementsystem wie ein LDAP Verzeichnis Microsoft Active Directory oder ein System eines anderen Anbieters als festen Bestandteil Ihrer Gesch ftsvorg nge Mithilfe der Webservices k nnen Sie Anwendungen schreiben die Ihre Benutzer zwischen diesem System und Connect Enterprise synchronisieren Dabei kann die Anwendung die Liste der Benutzer mithilfe der J2EE Plattform oder eines anderen Verfahrens aus dem Verzeichnis auslesen diese mit der Liste der Connect Enterprise Benutzer vergleichen und dann die erforderlichen Updates im Benutzer Repository von Connect Enterprise durchf hren wie das Hinzuf gen oder L schen von Benutzern oder Gruppen Aber dies ist nur ein Beispiel f r eine benutzerdefinierte Anwendung Im Connect Enterprise Developer Center finden Sie weitere Beispiele Datenfluss Die Datenfl sse zwischen Clientanwendungen und Connect Enterprise werden im folgenden Diagramm abgebildet Die von Ihnen erstellten Anwendungen verwenden die Pfade 1 und 2 sowie A und B Die Connect Enterprise Anwendungen also Adobe Acrobat Connect Professional Connect Training oder Connect Events k nnen einen beliebigen Pfad nutzen amp Zertifizierungsstelle Or En wn R HTTPS 443 Q Services Anwendungs ap weneung server C
166. es SCO hat dar ber hinaus einen Typ wie beispielsweise content course meeting etc Sie k nnen die Werte von sco id und type der Antwort von sco info oder auch von anderen Aktionen entnehmen lt sco account id 624520 disabled display seq 0 folder id 2006258747 icon producer lang en max retries sco id 2006334909 source sco id type content version 1 gt SCOs suchen 45 Charakteristiken von SCOs Wenn Sie sich die XML Antworten mehrerer Aufrufe ansehen werden Sie weitere Charakteristiken von SCOs feststellen m In einigen Aktionen wird die Kennung eines SCOs mit sco id bezeichnet aber in anderen Aktionen sind auch Namen wie folder id acl id und andere m glich Es handelt sich aber immer um die gleiche eindeutige Kennung m Der Zugriff auf die SCOs kann durch unterschiedliche Principals erfolgen seien es Benutzer oder Gruppen Die Principals die einen Zugriff auf ein SCO erhalten sind in der ACL der Access Control List aufgef hrt m Jedes SCO hat eine eigene URL die aus zwei Teilen besteht Einem Dom nennamen wie http example com und einem URL Pfad wie f2006123456 Sie k nnen diese Informationen verbinden und eine vollst ndige URL erstellen mit der auf das SCO zugegriffen werden kann m Jedes SCO verf gt ber einen Navigationspfad der beschreibt wo in der Ordnerhierarchie das SCO gespeichert wird m F r jedes SCO wird mithilfe von Berechtigungen definiert welcher Principal darauf
167. estzulegen bergeben Sie hierzu die field id die principal id des Benutzers als acl id und den gew nschten Wert https example com api xml action acl field update amp acl id 2006258745 amp field id 2007017474 amp value San 20Francisco 5 Analysieren Sie die Antwort und suchen Sie den Statuscode ok 42 Kapitel 3 Grundlagen Gruppen erstellen Wenn Sie Ihre Benutzer bestimmten Gruppen zuweisen m chten m ssen Sie principal update als Benutzer mit Administratorrechten f r Ihre Anwendung aufrufen Benutzer einer Gruppe zuweisen 1 Melden Sie sich als Benutzer mit Administratorrechten f r Ihre Anwendung an 2 Optioinal Wenn der Benutzer noch nicht vorhanden ist erstellen Sie ihn durch einen Aufruf von principal update https example com api xml action principal update amp first name jazzwayjazz amp last name doe amp login jazz doe com amp password nothing amp type user amp has children 0 3 Optional Werten Sie die Antwort nach der principal id des Benutzers aus 4 Falls es den Benutzer bereits gibt k nnen Sie seine principal id mit einem Aufruf von principal list erhalten https example com api xml action principal list amp filter type user 5 Werten Sie die Antwort nach principal id aus lt principal principal id 5611980 account id 624520 type user has children false is primary false is hidden false gt lt name gt Joy Black lt name gt lt login gt joy acme com lt login gt lt email
168. eting attendance gt lt row transcript id 2006778723 sco id 2006778715 principal id 2006258745 answered survey 0 gt lt login gt joy acme com lt login gt lt session name gt Joy Smith lt session name gt lt sco name gt Designing Online Courses lt sco name gt lt date created gt 2006 06 28T14 35 21 307 07 00 lt date created gt lt date end gt 2006 06 28T15 09 05 447 07 00 lt date end gt lt participant name gt Joy Smith lt participant name gt lt row gt lt report meeting attendance gt lt results gt report meeting attendance 173 report meeting concurrent users Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt die maximale Anzahl der gleichzeitigen Benutzer in einem Acrobat Connect Meeting in den letzten 30 Tagen zur ck sowie die Angabe wie h ufig diese Anzahl erreicht wurde Diese Anzahl ist die h chste Anzahl von Benutzern in einem Meeting zu einem bestimmten Zeitpunkt Dabei ist es unerheblich ob es sich um ein Meeting mehrere gleichzeitige Meetings oder eine Anzahl sich berschneidender Meetings handelt Sie k nnen den Zeitraum ber die 30 Tage hinaus erh hen indem Sie den Parameter length hinzuf gen also beispielsweise mit length 120 Die maximale Anzahl der Benutzer max users wird durch die Kontolizenz festgelegt und gilt f r den Server als Ganzes nicht nur f r ein bestimmtes Meeting Diese Aktion erteilt auch Auskunft dar ber wie h ufig d
169. etings Der Principal ist Veranstalter des Meetings und kann das Meeting erstellen oder als Moderator auftreten auch wenn er keine view Berechtigung f r den bergeordneten Ordner des Meetings hat Nur bei Meetings Der Principal ist Moderator eines Meetings und kann Materialien pr sentieren seinen Bildschirm freigeben Textnachrichten senden Fragen berwachen Texthinweise erstellen Audio und Videodaten bertragen und Materialien mithilfe von Weblinks vorgeben Nur bei Meetings Der Principal hat keine Berechtigung als Teilnehmer Moderator oder Veranstalter und kann nicht am Meeting teilnehmen Wenn der Benutzer bereits an einem Meeting teilnimmt wird er erst dann aus dem Meeting entfernt wenn seine Sitzung abl uft Bei SCOs au er Meetings Der Principal kann das SCO ver ffentlichen oder aktualisieren Die Berechtigung publish schlie t view ein und erm glicht dem Principal die SCO bezogenen Berichte anzuzeigen Bei Ordnern hei t publish dass der Principal keine Unterordner erstellen oder Berechtigungen festlegen darf Bei SCOs au er Meetings und Kursen Der Principal kann das SCO anzeigen l schen verschieben bearbeiten und dessen Berechtigungen einstellen Bei Ordnern kann der Principal Unterordner erstellen und Berichte zu Ordnerinhalten anzeigen Bei SCOs au er Meetings Der Principal kann das SCO nicht anzeigen oder verwalten und nicht darauf zugreifen status Beschreibung Ein Statuscode der von Connec
170. ezeigt F r den Aufruf von report meeting summany ben tigen Sie publish mini host oder host Berechtigung f r das Meeting Sofern Sie ber eine dieser Berechtigungen verf gen k nnen Sie report meeting summary f r ein aktuelles ein abgeschlossenes oder ein zuk nftiges Meeting aufrufen Den meisten Sinn ergeben die Daten f r ein abgeschlossenes Meeting 178 Kapitel 6 Aktionsreferenz Ein Meeting wird unter Umst nden in regelm igen Abst nden wiederholt zum Beispiel eine w chentliche Mitarbeiterbesprechung dann wird jedes Mal eine eigene Sitzung erstellt Bei regelm igen Meetings werden die von report meeting summary zur ckgegebenen Daten aus allen Sitzungen des Meetings zusammengefasst Sie beziehen sich also nicht nur auf die letzte Sitzung Anforderungs URL http server_name api xml action report meeting summary amp sco id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Dei eindeutige Kennung eines Meetings f r das Sie publish bzw host Berechtigung haben session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report meeting summary num unique meetings in
171. f von report bulk users nur die ersten acht Felder aus der Feldliste des Bildschirms Benutzerprofil anpassen von Connect Enterprise Manager Administration gt Benutzer und Gruppen gt Benutzerprofil anpassen zur ckgegeben Bei der Verwendung von Enterprise Server k nnen Sie in der Datei custom ini einen Wert f r REPORT_MAX_CUSTOM_FIELDS einstellen so dass mehr als acht benutzerdefinierte Felder zur ckgegeben werden weitere Informationen hierzu finden Sie im Adobe Connect Enterprise Installations und Konfigurationshandbuch Sie k nnen hier zwar jeden beliebigen Wert angeben aber h here Werte verringern unter Umst nden die Datenbankleistung Als Enterprise Hosted Kunde k nnen Sie diesen Wert nicht ndern Anforderungs URL http server_name api xml action report bulk users amp custom fields boolean amp filter definition value amp sort definition value amp session BreezeSessionCookieValue report bulk users 159 Parameter Name Typ Erforderlich Beschreibung custom fields Boolescher N Wert Gibt an ob benutzerdefinierte Felder in der Antwort zur ckgegeben werden Gibt bis zu acht benutzerdefinierte Felder zur ck Bei true wird das Feld manager in der Antwort nicht angezeigt session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribu
172. f 8 gt lt results gt lt status code allowedValue gt lt users gt lt user user id integer account id integer gt lt name gt string lt name gt lt date expired gt datetime lt date expired gt lt user gt lt users gt lt results gt 262 Kapitel 6 Aktionsreferenz Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Antwortstatus Wert zul ssige Werte finden Sie im Abschnitt status users Container Informationen zu den Konten zu denen der Benutzer geh rt user Container Informationen zu einem Benutzer und zu einem Benutzerkonto user id Ganzzahl Die Kennung des Benutzers auf dem Server account id Ganzzahl Die Kennung des Kontos zu dem der Benutzer geh rt name Zeichenfolge Der Name des Kontos zu dem der Benutzer geh rt date expired Datetime Das Datum und die Uhrzeit des Ablaufs Datum der G ltigkeitsdauer einer Uhrzeit Benutzeranmeldung Beispielanforderung https sample com api xml action user accounts amp login joy acme com amp password bigdog Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt users gt lt user user id 2006258745 account id 624520 gt lt name gt Test Account lt name gt lt date expired gt 2999 12 311T16 00 00 000 08
173. file gt lt files gt lt results gt Siehe auch sco update user accounts Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt eine Liste der Konten bereit zu denen ein Benutzer geh rt user accounts 261 Die Aktion user accounts wird nur dann verwendet wenn ein Benutzer bei mehr als einem Konto auf dem Server registriert ist und f r alle Konten den gleichen Anmeldenamen und das gleiche Kennwort nutzt In einem solchen Fall kann die Anmeldung des Benutzers unter Umst nden mit der Fehlermeldung too much data fehlschlagen Diese Aktion ist sinnvoll wenn Sie eine Liste der Konten eines Benutzers abrufen und dem Benutzer die M glichkeit geben m chten eines dieser Konten f r die Anmeldung auszuw hlen Anforderungs URL http server_name api xml action user accounts amp login string amp password string amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung login Zeichenfolge J Der Anmeldename eines Benutzers bei dem es sich unter Umst nden um seine E Mail Adresse handelt password Zeichenfolge J Das Kennwort des Benutzers session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Die Standardsortierung erfolgt nach account name Antwortstruktur lt xml version 1 0 encoding ut
174. fs Vp amp amp gt Extern Extern mit Header Enterprise Server SQL Datenbank Authentisierungsfilter konvertieren die externen Authentisierungsdaten in Enterprise Server Anmeldedaten Die externe Authentisierung wird zus tzlich zur Standardauthentisierung von Connect Enterprise verwendet Jeder Benutzer der auf Enterprise Server zugreifen m chte ben tigt einen g ltigen Anmeldenamen und ein Kennwort f r Enterprise Server 28 Kapitel 2 Anmeldung und Anforderungen Wenn Sie Enterprise Server eine Anmeldeanforderung mit externen Authentisierungsdaten senden wird folgender Vorgang ausgel st m Der Authentisierungsfilter f ngt die Anforderung ab und berpr ft das Feld ext login der Enterprise Server Benutzer auf eine bereinstimmung mit den externen Anmeldedaten m Falls es eine bereinstimmung gibt bergibt der Filter die externe Authentisierung an Enterprise Server und der Server meldet den Benutzer an m Gibt es keine bereinstimmung wird die Anmeldeanforderung an den Server bergeben der eine Anmeldeseite anzeigt Der Benutzer muss sich dann an Enterprise Server anmelden m Wenn diese Anmeldung erfolgreich verl uft aktualisiert Enterprise Server das Feld ext login im Benutzerprofil mit den externen Daten aus der Anforderung Bei der n chsten Anmeldung mit diesen externen Anmeldedaten findet Enterprise Server die bereinstimmung in ext 1ogin so dass sich der Benutzer nicht mehr an Connect Enterpri
175. g entsprechen 148 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung row name ur login user name status transaction id sco id type principal id score Container Ganzzahl Ganzzahl Zul ssiger Wert Ganzzahl Ganzzahl Zeichenfolge Zeichenfolge Zeichenfolge Zeichenfolge Zul ssiger Wert Informationen einer Transaktion die den Bedingungen der Anforderung entspricht Die Kennung der Transaktion Die eindeutige Kennung des Objekts SCOs auf das der Benutzer zugegriffen hat Der Typ des SCOs zul ssige Werte finden Sie im Abschnitt type Die Kennung des an der Transaktion beteiligten Principals Falls bei der Transaktion z B einem Quiz eine Punktzahl zugewiesen wurde die tats chliche Punktzahl Ansonsten 0 Der Name der dem an der Transaktion beteiligten SCO zugewiesen wurde Der Dateiname in der URL des an der Transaktion beteiligten SCOs Der Anmeldename des Principals Der vollst ndige Name des an der Transaktion beteiligten Benutzers aus den Feldern first name und last name zusammengesetzt Der Status der Transaktion Zul ssige Werte sind completed in progress user passed und user failed report bulk consolidated transactions 149 Element Attribut Typ date created Beschreibung Datetime Das Datum und die Uhrzeit des Datum Uhrzeit Zugriffs auf das SCO durch den Principal sowie der
176. g keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt sco search info gt lt sco sco id integer folder id integer type allowedValue icon allowedValue byte count integer gt lt name gt string lt name gt lt url path gt string lt url path gt lt date created gt datetime lt date created gt lt date modified gt datetime lt date modified gt lt hit gt integer lt hit gt lt hit type gt allowedValue lt hit type gt lt thumbnail path gt string lt thumbnail path gt lt sco gt lt sco search info gt lt results gt sco search 247 Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status sco search info Container Die Liste der Objekte SCOs die mit der Suchabfrage bereinstimmen sco Container Informationen zu einem Objekt das mit der Suchabfrage bereinstimmt sco id Ganzzahl Die eindeutige Kennung des SCOs folder id Ganzzahl Die Kennung des Ordners in dem das SCO gespeichert ist type Zul ssiger Der Materialtyp des SCOs zul ssige Wert Werte finden Sie im Abschnitt type icon Zul ssiger Das
177. g keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut sortieren 216 Kapitel 6 Aktionsreferenz Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report sco slides gt lt row slide integer name integer asset id integer views integer gt lt date created gt datetime lt date created gt lt row gt lt report sco slides gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status report sco slides Container Informationen zu s mtlichen Folien einer Pr sentation einschlie lich der Angabe wie oft eine Pr sentationsfolie und wann sie zuletzt angezeigt wurde row Container Informationen zu einer Folie der Pr sentation slide Ganzzahl Die Nummer der Folie in der Pr sentation name Ganzzahl Der Titel der Folie in der Pr sentation asset id Ganzzahl Die Versionsnummer der Pr sentation Bei jeder Ver ffentlichung einer Pr sentation erh lt sie eine neue asset id views Ganzzahl Die Angabe wie oft die Folie bisher angezeigt wurde date created Datetime Das Datum und die Uhrzeit der letzten Datum Anzeige der Folie Uhrzeit report sco slide
178. gen das Datum des Endes 152 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung date modified Datetime Datum Das Datum der letzten Uhrzeit Aktualisierung des SCOs description Zeichenfolge Die Beschreibung des SCOs Beispielanforderung http example com api xml action report bulk objects amp filter type meeting amp filter gt date created 2006 06 01 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report bulk objects gt lt row sco id 2006778715 type meeting gt lt url gt online lt url gt lt name gt Designing Online Courses lt name gt lt date created gt 2006 06 28T14 15 00 000 07 00 lt date created gt lt date end gt 2006 06 28T14 30 00 000 07 00 lt date end gt lt date modified gt 2006 07 13T14 57 54 150 07 00 lt date modified gt lt row gt lt report bulk objects gt lt results gt Siehe auch report bulk consolidated transactions report bulk questions report bulk slide views report bulk users report bulk objects 153 report bulk questions Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Gibt Informationen zu jeder Quizfrage in dem Konto zur ck an dem Sie angemeldet sind Die Antwort enth lt die Quizfrage die Antwort die Kennung des Benutzers der geantwortet hat sowie die Kennung der Transaktion Diese Aktion gibt s mtliche im Konto gespeicherten Frage Antwort Kombi
179. glich ist is required Boolescher Gibt an ob das benutzerdefinierte Wert Feld erforderlich ist true wenn f r jedes Objekt das dieses Feld benutzt in diesem Feld ein Wert eingegeben werden muss Ansonsten false name Zeichenfolge Der Name des benutzerdefinierten Felds so wie er von Enterprise Manager oder Ihrer Anwendung angezeigt wird Beispielanforderung https example com api xml action custom fields amp filter ike name name Beispielant wort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt custom fields gt lt field fi fi lt na lt fiel lt field fi fi lt na lt fiel anage object type object type principal e account id 624520 display seq 1 is primary true is required true gt e gt anage object type object type principal e account id 624520 display seq 2 is primary true is required true gt permission id eld id first na eld type text e gt First Name lt na d gt permission id eld id last nam eld type text e gt Last Name lt name gt d gt lt custom fields gt lt results gt Siehe auch custom field update custom fields 103 custom fields delete Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung L scht ein benutzerdefiniertes Feld Der Wert von is primary eines benutzerdefinierten Felds muss false sein damit das Feld gel scht werd
180. gt joy acme com lt email gt lt principal gt 6 Rufen Sie principal list erneut auf um die principal id der gew nschten Gruppe zu erhalten https example com api xml action principal list amp filter type group 7 Rufen Sie group membership update mit is member true auf um den Benutzer der Gruppe hinzuzuf gen https example com api xml action group membership update amp group id 4930296 amp principal id 2006258745 amp is member true Dieprincipal id ist die principal id des Benutzers m Die group id ist die principal id der Gruppe a Der Parameter is member muss true wahr sein Eine Gruppe auf bestimmte Benutzer berpr fen 1 Rufen Sie principal list mit einer group id dem Filter filter is member sowie einem weiteren Filter zur Identifizierung des Principals auf https example com api xml action principal list amp group id 624523 amp filter is member true amp filter 1ike name bob Gruppen erstellen 43 2 Suchen Sie in der Antwort nach einem principal Element Eine erfolgreiche Antwort sieht beispielsweise so aus lt principal list gt lt principal principal id 624660 account id 624520 type user has children false is primary false is hidden false gt lt name gt Bill Jones lt name gt lt login gt bjones acme com lt login gt lt email gt bjones acme com lt emai 1 gt lt is member gt true lt is member gt lt principal gt lt principal list gt Falls der Benutzer kein Grup
181. hand der permission id mit dem Wert view https example com api xml action permissions info amp acl id 2006298444 amp filter permission id view m Die acl id ist hierbei die sco id des Kurses oder Studienplans m Dabei steht die permission id mit dem Wert view f r einen eingeschriebenen Benutzer 2 Werten Sie das Ergebnis nach principal id name oder einem anderen ben tigten Wert aus lt principal principal id 2006258745 is primary false type user has children false permission id view gt lt name gt Joy Smith lt name gt lt login gt joy acme com lt login gt lt principal gt 82 Kapitel 5 Schulungen Eine Liste aller Kurse eines Studienplans anzeigen Ein Studienplan ist ein Ordnertyp dessen Inhalt Sie mithilfe von sco contents oder sco expanded contents darstellen k nnen 1 Rufen Sie die sco id des betreffenden Studienplans ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Kurses oder Studienplans suchen Rufen Sie sco expanded contents auf und bergeben Sie die sco id https example com api xml action sco expanded contents amp sco id 2006745669 Werten Sie die Antwort nach der sco id der folder id und dem Wert von depth aus lt sco depth 1 sco id 2006745674 folder id 2006745669 type link icon course lang en source sco id 2006745673 display seq 0 source sco type 0 gt lt name gt All About Web Communities lt name gt lt url path gt 1804220
182. henfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Beispielanforderung https example com api xml action sco delete amp sco id 2007171127 sco delete 233 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Siehe auch sco info sco move sco nav sco expanded contents sco expanded contents Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Listet s mtliche SCOs eines Ordners auf einschlie lich der Inhalte von Unterordnern Studienpl nen und allen Typen einschlie ender SCOs Falls Sie keinen Filter verwenden wird die Liste der SCOs in der gleichen Reihenfolge angezeigt wie in Connect Enterprise Manager Wenn Sie die Antwort dagegen filtern oder sortieren wird die Liste entsprechend dieser Einstellungen zur ckgegeben Anforderungs URL http se
183. i einer externen Authentisierung ge ndert werden Der Anmeldename des Principals auf Connect Enterprise Stimmt unter Umst nden mit der E Mail Adresse berein Bei einem Benutzer der vollst ndige Name der aus first name und last name zusammengesetzt wird Bei einem Benutzer die E Mail Adresse Bei einem Benutzer der Vorname 130 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung last name Zeichenfolge Bei einem Benutzer der Nachname x customfield Zeichenfolge Ein benutzerdefiniertes Feld fur den Benutzer oder die Gruppe preferences Leer mit Attributen Informationen zu den Voreinstellungen des Principals acl id Ganzzahl Die Kennung des Principals lang Zul ssiger Wert Die Spracheinstellung die der time zone id Zu Principal fur Connect Enterprise Anwendungen festgelegt hat lassiger Wert Die Zeitzone die der Principal fur Connect Enterprise Anwendungen festgelegt hat Beispielanforderung https example com api xml action principal info amp principal id 2006258745 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt contact gt lt email gt bob acme com lt emai gt lt first name gt Bob lt first na lt last name gt Jones lt last na lt contact gt lt manager account id 624520 is hidden fa type user gt lt login gt jazzdoe exa lt name gt jazz doe lt na lt email gt jazzdoe exa se is
184. ibuten code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Beispielanforderung https example com api xml action sco move amp sco id 2006744233 amp folder id 2006258748 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Siehe auch Sco nav SCO NAaV Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Beschreibt die Ordnerhierarchie die ein SCO enth lt Der Aufruf von sco nav ist bei der Erstellung von Navigationsstrukturen Listen von Navigationslinks oder anderen Hierarchieanzeigen der Benutzeroberfl che hilfreich Die Antwort enth lt eine Liste der sco Elemente Eines f r das SCO nach dem Sie suchen und je ein weiteres f r alle bergeordneten Ordner bis hin zur obersten Hierarchieebene Der oberste Ordner ist in der Liste der von sco shortcuts zur ckgegebenen Ordner enthalten In jedem sco Element zeigt das Attribut depth an wie viele Ebenen zwischen dem aktuellen SCO und dem SCO liegen das Sie abgefragt haben Ein depth Wert von 0 zeigt an dass es sich um das gesuchte SCO handelt Der Wert 1 weist auf den Ordner hin in dem das SCO enthalten ist usw sco nav 243 Anforderungs URL http server_name api xml action sco nav amp sco id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibu
185. identifiziert wird Die andere M glichkeit besteht darin Informationen ber einen bestimmten Principal zu erhalten der das Quiz beantwortet hat In diesem Fall geben Sie eine sco id und eine principal idan Sie k nnen mithilfe von report quiz takers aber auch Informationen zu allen SCOs abrufen die ein Principal angezeigt hat Hierzu geben Sie nur eine principal id ohne eine sco idan report quiz takers 209 Um den Umfang der Antwort einzuschr nken k nnen Sie jeden zul ssigen Filter verwenden oder einen type Parameter angeben um Nutzungsdaten zu einem SCO Typ zu erhalten Kurse Materialien oder Meetings siehe folgende Tabelle Typ Beschreibung type course Listet alle Kurse auf an denen der Benutzer teilgenommen hat type presentation Listet alle Materialien auf die ein Benutzer angezeigt hat type meeting Listet alle Meetings auf an denen der Benutzer teilgenommen hat Anforderungs URL http server_name api xml action report quiz takers amp sco id integer amp principal id integer amp type allowedValue amp filter definition value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung einer Pr sentation oder eines Kurses die bzw der ein Quiz enth lt principal id Ganzzahl N Die Kennung des Principals dessen Quizergebnisse Sie wissen m chten type Zul ssiger N Der Materia
186. ie Datei ggf auf Wenn Sie eine neue Datei hinzuf gen rufen Sie zuerst sco update auf und bergeben Sie die zur ckgegebene sco id an sco upload Bei einer Aktualisierung einer bereits auf dem Server gespeicherten Datei k nnen Sie sco upload sofort aufrufen Sie m ssen dabei aber sco upload innerhalb eines form Elements von HTML aufrufen Das form Element muss hierzu dem Zertifikatstyp multipart form data entsprechen Au erdem muss das HTML Formular ber ein input Element mit dem Zusatz name file verf gen Siehe folgendes Beispiel lt FORM action http domain name api xml action sco upload amp sco id xx amp summary xxx amp title xxx enctype multipart form data method post gt lt P gt What files are you sending lt INPUT type file name file gt lt BR gt lt INPUT type submit value Send gt lt INPUT type reset gt lt FORM gt 258 Kapitel 6 Aktionsreferenz Dieses Formular l dt eine einzelne Datei hoch Um mehrere Dateien hochzuladen beispielsweise eine PPT und eine PPC Datei m ssen Sie mehrere input Elemente mit name file angeben Zum Beispiel lt FORM action http domain name api xml action sco upload amp sco id xxx amp summary xxx amp title xxxx enctype multipart form data method post gt lt P gt PPT files you are sending lt INPUT type file name file gt lt BR gt PPC files you are sending lt INPUT type file name file gt lt BR gt lt INPUT type submit val
187. ierzu einen API Aufruf oder Enterprise Manager verwenden aber Sie k nnen immer nur 200 Benutzer auf einmal hinzuf gen Mit der XML API Rufen Sie group membership update jeweils mit group id principal id und is member true auf https example com api xml action group membership update amp group id 4930296 amp principal id 2006258745 amp is member true amp group id 4930296 amp principal id 2007343711 amp is member true Bei Datens tzen mit ung ltigen Daten gibt group membership update den Status ok zur ck aber der betreffende Benutzer wird der Gruppe nicht hinzugef gt Mit Enterprise Manager Navigieren Sie zu Verwaltung gt Benutzer und Gruppen gt Importieren Sie k nnen die Benutzer von einer CSV Datei Datei mit kommagetrennten Werten importieren die f r jeden Benutzer zumindest den Anmeldenamen enth lt 3 Rufen Sie die sco id des Kurses ab siehe Die sco id eines Kurses oder Studienplans suchen Geben Sie die sco id des Schulungsordners an der den Kurs enth lt 4 Rufen Sie permissions update auf um die Gruppe in den Kurs einzuschreiben https example com api xml action permissions update amp acl id 2007064258 amp principal id 2007105030 amp permission id view Eine gro e Gruppe ab 1 000 Benutzer aus einem Kurs entfernen 1 Rufen Sie f r den Kurs permissions info auf und filtern Sie das Ergebnis anhand der permission id mit dem Wert view https example com api xml action permissions info amp acl id
188. ieses Maximum im aktuellen Monat erreicht wurde max participants freg Anforderungs URL http server_name api xml action report meeting concurrent users amp length integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung length Ganzzahl N Der Zeitraum in Tagen Uber den die gleichzeitige Nutzung von Meetings berpr ft werden soll Der Standardwert lautet 30 Sie k nnen auch Werte ber 30 angeben session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden 174 Kapitel 6 Aktionsreferenz Antwortstruktur lt results gt lt status code allowedValue gt lt report meeting concurrent users max users integer max participants freq integer gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status report meeting Leer mit Informationen zur maximalen GONCUrRenE users Attributen Teilnehmerzahl in allen Meetings zu einem bestimmten Zeitpunkt max users Ganzzahl Die maximale Teilnehmerzahl in allen Meetings entweder ein einzelnes Meeting oder mehrere gleichzeitige
189. ilter modifier field value Die Modifikatoren die Sie hinzuf gen k nnen sind in der folgenden Tabelle enthalten Filter Beschreibung filter field value Gibt alle Objekte zur ck deren Daten in field exakt mit value bereinstimmen filter like field value Gibt alle Objekte mit der Zeichenfolge value im Feld field zur ck Bei field muss es sich nicht um eine genaue bereinstimmung handeln filter out field value Filtert bzw unterdr ckt alle Objekte mit der Zeichenfolge value im Feld field filter rows value Beschr nkt die Antwort auf die in value angegebene Anzahl von Zeilen filter start value Gibt die Antwort ab der in value angegebenen Indexnummer zur ck 269 Filter Beschreibung filter gt datefield value Gibt alle Objekte zur ck deren Datumswert gr er als value ist Funktioniert nur bei Datumsfeldern Der Wert muss dabei ein Datum im Format ISO 8601 sein filter 1t datefield value Gibt alle Objekte zur ck deren Datumswert kleiner als value ist Funktioniert nur bei Datumsfeldern Der Wert muss dabei ein Datum im Format ISO 8601 sein filter gte datefield value Gibt alle Objekte zur ck deren Wert im Feld field gr er oder gleich value ist Funktioniert nur bei Datumsfeldern Der Wert muss dabei ein date Wert im Format ISO 8601 sein filter Ite datefield value Gibt alle Objekte zur ck deren Wert im Feld field kleiner oder gleich value ist Funktioniert nur mit Datumswerten
190. im Browser testen oder weitere Informationen im Abschnitt sort definition nachschlagen Aufrufe mit Filtern und Sortierungen 1 Rufen Sie principal list erneut auf aber dieses Mal nur f r die Benutzergruppen und in alphabetischer Reihenfolge nach dem Namen https example com api xml action principal list amp filter type group amp sort name asc 20 Kapitel 1 Architektur 2 Um die Antwort einzugrenzen w hlen Sie aus der Liste eine Gruppe aus und filtern Sie die R ckgabe nach ihrem Namen https example com api xml action principal list amp filter name developers Nun sollte nur eine Gruppe angezeigt werden lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt principal list gt lt principal principal id 2007105030 account id 624520 type group has children true is primary false is hidden false gt lt name gt developers lt name gt lt login gt developers lt login gt lt principal gt lt principal list gt lt results gt Weitere Schritte Sie k nnen nun weitere Aufrufe im Browser testen und feststellen wie sie funktionieren Das ist die beste und einfachste M glichkeit die XML API zu erlernen Sollten Sie weitere Informationen ben tigen schlagen Sie in folgenden Abschnitten nach m Inder API Referenz in Kapitel 6 Aktionsreferenz m In Kapitel 2 Anmeldung und Anforderungen wenn Sie wissen m chten wie Sie Benutzer aus einer Anwendung h
191. in gt lt principal gt lt principal list gt lt results gt Siehe auch principal info principal list principal update 138 Kapitel 6 Aktionsreferenz principals delete Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Entfernt einen bzw mehrere Principals entweder Benutzer oder Gruppen Zum Entfernen von Principals m ssen Sie ber Administratorrechte verf gen Um mehrere Principals zu l schen geben Sie mehrere principal id Parameter an Alle von Ihnen angegebenen Principals werden gel scht Mit der principal id werden Benutzer oder Gruppen identifiziert Wenn Sie einen Benutzer angeben wird dieser Benutzer aus allen Gruppen gel scht Bei einer Gruppe wird die Gruppe gel scht die in der Gruppe zusammengefassten Benutzer bleiben dagegen erhalten Anforderungs URL http server_name api xml action principals delete amp principal id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderli Beschreibung ch principal id Ganzzahl J Die Kennung des Benutzers oder der Gruppe den bzw die Sie entfernen m chten session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt
192. integer amp field id string amp value string amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung acl id Ganzzahl J Die Kennung des Objekts Principals oder Kontos Kann eine zul ssige sco id account id oder principal id sein field id Zeichenfolge J Der Name des Felds dessen Wert Sie aktualisieren m chten Bei dem Feld kann es sich um serverseitiges oder um ein benutzerdefiniertes Feld handeln value Zeichenfolge J Der neue Wert der eingestellt werden soll session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden 94 Kapitel 6 Aktionsreferenz Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Antwortstatus Wert zul ssige Werte finden Sie im Abschnitt status Beispielanforderung https example com api xml action acl field updatedacl id 2006404141 amp field id first name amp value jazz Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Sieh
193. inzuf gen l schen und ndern sowie deren Berechtigungen festlegen Dar ber hinaus kann der Benutzer mithilfe von sco contents oder sco expanded contents den Inhalt des Ordners anzeigen denied Der Benutzer kann in dem Ordner keine Objekte hinzuf gen l schen oder ndern bzw die Berechtigungen der Objekte einstellen Er kann allerdings den Inhalt des Ordners anzeigen Kurse und Studienpl ne suchen F r die meisten im Zusammenhang mit Kursen und Studienpl nen verwendeten XML API Aktionen wird die sco id des betreffenden Kurses oder Studienplans ben tigt H ufig m ssen Sie diese sco id zuerst suchen bevor Sie eine andere Aktion aufrufen k nnen Dies ist immer dann der Fall wenn Sie den genauen Namen des SCOs nicht kennen Folgende Vorgehensweisen werden f r eine effiziente Suche nach Schulungs SCOs empfohlen m Erstellen Sie im Ordner Gemeinsame Schulung jeweils eigene Unterordner zum Speichern der einzelnen Kurse und Studienpl ne Sie k nnen diese Aufgabe sowohl in Connect Enterprise Manager als auch mithilfe der XML API durchf hren dort wird der Ordner Gemeinsame Schulung mit courses bezeichnet m In diesen Ordnern speichern Sie die unterschiedlichen Kurs und Studienplankategorien z B Marketingschulung oder Vertriebsschulung m Speichern Sie die Kurse und Studienpl ne in diesen Ordnern in einer flachen Struktur also nur auf einer Hierarchieebene Kurse und Studienpl ne suchen 73 Eine solche Verzeichnisstr
194. k nnen die Antwort mithilfe eines beliebigen zul ssigen Filters sinnvoll einschr nken So k nnen Sie beispielsweise alle Antworten eines bestimmten Benutzers abfragen https example com api xml action report quiz interactions amp sco id 2006334909 amp filter like name Joy 20Smith Oder Sie k nnen die Antworten eines bestimmten Benutzers auf eine bestimmte Frage abfragen https example com api xml action report quiz interactions amp sco id 2006334909 amp filter name Joy 20Smith amp filter like description What 20is 20the 20capital 200f 20California Anforderungs URL http server_name api xml action report quiz interactions amp sco id integer amp filter definition value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung einer Pr sentation oder eines Kurses die bzw der ein Quiz enth lt session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt results gt lt status code allowedValue gt lt report quiz interactions gt lt row display seq integer transcript id integer interaction id integer sco id integer score integer gt lt name gt string lt name gt lt sco name gt string lt sco name gt
195. konfiguration der gleiche Wert wie der Anmeldename es sei denn Sie haben diesen Wert ausdr cklich auf eine Authentisierungskennung Ihres Netzwerks eingestellt name Zeichenfolge Der vollst ndige Name des Principals Falls der Principal ein Benutzer ist wird dieser Wert aus den Feldern first name und last name zusammengesetzt Beispielanforderung https example com api xml action principal updatedfirst name jake amp last name doe amp has children 0 amp login jakedoe example com amp type user Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt principal principal id 2006403978 account id 624520 type user has children 0 gt lt login gt jakedoe example com lt login gt lt ext login gt jakedoe example com lt ext login gt lt name gt jake doe lt name gt lt principal gt lt results gt Siehe auch principal info principals delete principal list principal list by field report active meetings Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt eine Liste der Adobe Acrobat Connect Professional Meetings zur ck die derzeit stattfinden Zu den Informationen geh rt auch die Zeitdauer seit Beginn des Meetings 144 Kapitel 6 Aktionsreferenz Damit report active meetings Ergebnisse zur ckgeben kann muss mindestens ein Benutzer in mindestens einem Meetingraum anwensend sein Falls f r den aktuellen Zeitpu
196. ktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt principal principal id integer account id integer has children integer type integer gt lt login gt string lt login gt lt ext login gt string lt ext login gt lt name gt string lt name gt lt principal gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Antwortstatus Wert zul ssige Werte finden Sie im Abschnitt status principal Container Informationen zum neu erstellten Principal principal id Ganzzahl Die Kennung des neu erstellten Benutzers account id Ganzzahl Die Kennung des Kontos zu dem der neue Benutzer geh rt Entspricht dem Konto des aktuellen Benutzers has children Boolescher Gibt an ob der Principal untergeordnete Wert Elemente hat Dies weist darauf hin ob es sich bei dem Principal um einen Benutzer oder um eine Gruppe handelt 1 f r eine Gruppe 0 f r einen Benutzer type Zul ssiger Der Typ des Principals zul ssige Werte Wert finden Sie im Abschnitt type login Zeichenfolge Der Anmeldename des Principals h ufig eine E Mail Adresse principal update 143 Element Attribut Typ Beschreibung ext login Zeichenfolge Die Kennung des Principals aus der externen Authentisierung In der Standard
197. l ssige Werte Wert finden Sie im Abschnitt type sco id Zul ssiger Die eindeutige Kennung des neuen SCOs Wert version Ganzzahl Die Versionsnummer des neuen SCOs Bei der Erstellung des SCOs hat version den Wert 0 account id Ganzzahl Die Kennung des Kontos in dem das neue SCO erstellt wurde icon Ganzzahl Der Typ des Symbols mit dem das SCO in Connect Enterprise Manager identifiziert wird zulassige Werte finden Sie im Abschnitt icon url path Zeichenfolge Der Teil der SCO URL die auf den description name Zeichenfolge Zeichenfolge Dom nennamen folgt und das SCO eindeutig kennzeichnet Die Kurzbeschreibung des SCOs Der Name des SCOs sco update 257 Beispielanforderung https example com api xml action sco update amp folder id 2006258747 amp description test amp name More About Web Communities amp type content amp lang en Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt sco folder id 2006258747 account id 624520 type content lang en icon content sco id 2006752036 version 0 gt lt url path gt p53884157 lt url path gt lt description gt test lt description gt lt name gt More About Web Communities lt name gt lt sco gt lt results gt Siehe auch sco upload sco upload Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung L dt eine Datei auf den Server hoch und baut danach d
198. l list aufrufen m chten geben Sie folgendes ein https example com api xml action principal list session value Der Wert von BREEZESESSION gilt dabei immer nur f r eine Anmeldesitzung Das hei t Ihre Anwendung muss f r jede Anmeldung eines Benutzers einen neuen Cookie Wert speichern Beim Aufruf einer 1ogin Aktion senden Sie einen Anmeldenamen und ein Kennwort ber das Netzwerk es sei denn Sie verwenden eine externe Authentisierung Daher sollten Sie die bertragung von Kennw rtern immer mithilfe von SSL oder anderen Sicherheitsverfahren sch tzen Anforderungs URL http server_name api xml action login amp login string amp password string amp account id integer amp external auth use amp domain string 116 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung account id external auth login password domain session Ganzzahl Zul ssiger Wert Zeichenfolge Zeichenfolge Zeichenfolge Zeichenfolge N J N J N Die Kennung Ihres Kontos bei Enterprise Hosted Wenn Ihr Unternehmen Enterprise Server nutzt sollten Sie account id nicht verwenden Ein Wert der angibt ob Sie eine externe Netzwerkanmeldekennung senden um den Benutzer bei Connect Enterprise zu identifizieren Verwenden Sie in diesem Fall external auth use Der Anmeldename des Benutzers Nicht bei externer oder HTTP Header Authentisierung verwenden Das Kennwort des Be
199. licherweise auch die Anzahl und Art der Zeichen die in einem Kennwort enthalten sein m ssen Wenn ein Benutzer ein neues Kennwort eingibt das diesen Richtlinien nicht entspricht erh lt die Anwendung einen Fehler mit dem Hinweis dass der Wert des Parameters password also das neue Kennwort nicht zul ssig ist Beim Aufruf von user update pwd senden Sie ein Kennwort ber HTTP bzw vorzugsweise ber HTTPS Sie sollten die bertragung von Kennw rtern immer mithilfe von HTTPS oder anderen Sicherheitsverfahren sch tzen Anforderungs URL http server_name api xml action user update pwd amp user id integer amp password old string amp password string amp password verify string amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung user id Ganzzahl J Die Kennung des Benutzers password old Zeichenfolge J N password Zeichenfolge J password verify Zeichenfolge J session Zeichenfolge N Das aktuelle Kennwort des Benutzers Erforderlich f r normale Benutzer nicht dagegen f r Administratoren Das neue Kennwort Eine zweite Angabe des neuen Kennworts zu Pr fzwecken Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt 266 Kapitel 6 Aktionsreferenz Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt
200. lle Benutzer anzeigen 82 alle Kurse auflisten 83 alle verf gbaren auflisten 75 Benutzer entfernen 80 Definition 71 einen Benutzer einschreiben 77 eines Benutzers anzeigen 76 Gruppen einschreiben 81 Gruppen entfernen 81 Informationen anzeigen 82 mehrere Benutzer einschreiben 79 Punktzahlen angeben 84 sco id finden 74 Status anzeigen 76 verbleibende Kurse anzeigen 83 suchen principal id 38 sco id von Meetings 53 SCOs ohne Angabe der sco id 47 T technischer Support 10 Teilnehmer gleichzeitige 65 hinzuf gen 58 time zone id Attribut 285 too much data Statuscode 34 Transaktionen 64 Typ benutzerdefinierte Felder 290 Principals 289 SCOs 288 type Attribut 288 Element 288 SCOs 45 typografische Konventionen 11 U unverschl sselter Datenfluss 14 URLs Anforderung 294 f r ein SCO erstellen 49 Meetingraum 56 305 request 18 user accounts 261 user content Ordner 47 user courses Ordner 47 user events Ordner 47 user meetings Ordner 47 user transcript update 264 user update pwd 266 V Veranstalter hinzuf gen 58 Veranstaltungsordner 47 view Berechtigung 73 W Web Services 13 web xml Datei Aktivierung des Authentisierungsfilters 29 Webanwendungsserver 17 X XML Anforderungen Java Beispiel 295 XML Dokument Anforderung 32 XML Ressourcen 10 XPath Antworten analysieren 33 Java Beispiel 33 Ressourcen 10 XSLT 10 Z ZIP Dateien herunterladen 49 Index 313 314 Index
201. llen Sie die URL zum Meetingraum Hinweise hierzu finden Sie im Abschnitt Meetingraum URLs erstellen 4 Rufen Sie permissions info auf um die Werte von principal id f r den die Moderator en und Teilnehmer zu erhalten und filtern Sie die Ergebnisse nach der permission id https example com api xml action permissions info amp acl id 2007018414 amp filter permission id mini host Um eine Liste der Moderatoren zu erhalten rufen Sie permission id mit dem Wert mini host auf m F r die Teilnehmer k nnen Sie permission id view verwenden Benutzer zu Meetings einladen 61 5 Werten Sie die Antwort nach den gew nschten principal id Werten aus lt principal principal id 2006282569 is primary false type user has children false permission id view gt lt name gt jazz doe lt name gt lt login gt jazzdoe example com lt login gt lt principal gt 6 Rufen Sie principal info mit der principal id auf https example com api xml action principal info amp principal id 2006282569 7 Extrahieren Sie die Werte name und email aus der Antwort lt principal account id 624520 disabled has children false is hidden false is primary false principal id 2006282569 type user gt lt ext login gt jazzdoe example com lt ext login gt lt login gt jazzdoe example com lt login gt lt name gt jazz doe lt name gt lt email gt jazzdoe newcompany com lt email gt lt first name gt jazz lt first name gt
202. lt date created gt datetime lt date created gt lt description gt string lt description gt report quiz interactions 195 lt response gt integer lt response gt lt row gt lt report quiz interactions gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results status code report quiz interactions row display seq transcript id interaction id Container Leer mit Attributen Zul ssiger Wert Container Container Ganzzahl Ganzzahl Ganzzahl Alle Ergebnisse die von der Aktion zur ckgegeben werden Der Status der Antwort Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Informationen zu allen Interaktionen die s mtliche Benutzer mit diesem Quiz verbinden Informationen zu einem Benutzer einer Quizfrage und einer Antwort Die Antwort zu einer Interaktion kann aus mehreren row Elementen bestehen Die laufende Nummer der Frage im Quiz Die Kennung des Versuchs eines Benutzers ein Quiz zu beantworten Die Anforderung bezieht sich dabei auf einen Benutzer einen Versuch und ggf mehrere Fragen und Antworten Mit jedem Versuch eines Benutzers das Quiz zu beantworten wird die transcript id ge ndert Die Kennung s mtlicher Antworten die ein Benutzer auf eine Quizfrage gibt 196 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung sco id Ganzzahl Die eindeutige Kenn
203. lt last name gt doe lt last name gt lt x 2006293620 gt E3612 lt x 2006293620 gt lt x 2007017651 gt San Francisco lt x 2007017651 gt lt principal gt 8 Rufen Sie permissions info erneut auf und filtern Sie nach der permission id mit dem Wert host https example com api xml action permissions info amp acl id 2007018414 amp filter permission id host 9 Werten Sie die Antwort nach principal id aus lt principal principal id 2006282569 is primary false type user has children false permission id host gt lt name gt jazz doe lt name gt lt login gt jazzdoe example com lt login gt lt principal gt 10 Rufen Sie principal info mit der principal id auf https example com api xml action principal info amp principal id 2006258745 11 Durchsuchen Sie das principal Element der Antwort nach den Werten von name und login oder name und email lt principal account id 624520 disabled has children false is hidden false is primary false principal id 2006282569 type user gt lt ext login gt jazzdoe example com lt ext login gt 62 Kapitel 4 Meetings lt login gt jazzdoe example com lt login gt lt name gt jazz doe lt name gt lt email gt jazzdoe newcompany com lt email gt lt first name gt jazz lt first name gt lt last name gt doe lt last name gt lt x 2006293620 gt E3612 lt x 2006293620 gt lt x 2007017651 gt San Francisco lt x 2007017651 gt lt principal gt Mit diesen Werten legen Sie den
204. lt url path gt test lt url path gt lt login gt joy acme com lt login gt lt date taken gt 2006 06 30115 23 55 070 07 00 lt date taken gt lt principal name gt Joy Smith lt principal name gt lt row gt lt report user training transcripts gt lt results time zone id Beschreibung Einstellungen mit denen die Zeitzonen beschrieben werden die mithilfe von time zone id verwendet werden k nnen Werte Zeitzoneneinstellung Wert GMT 12 00 Internationale Datumsgrenze Westen 0 GMT 11 00 Midway Inseln Samoa 1 GMT 10 00 Hawaii 2 GMT O9 00 Alaska 3 GMT 08 00 Pacific USA und Kanada Tijuana 4 GMT 07 00 Mountain USA Kanada 10 GMT 07 00 Chihuahua La Paz Mazatlan 13 GMT 07 00 Arizona 15 GMT 06 00 Central USA Kanada 20 GMT 06 00 Saskatchewan 25 GMT 06 00 Guadalajara Mexiko Stadt Monterrey 30 GMT 06 00 Zentralamerika 33 GMT 05 00 Eastern USA Kanada 35 GMT 05 00 Indiana Ost 40 GMT 05 00 Bogota Lima Quito 45 GMT 04 00 Atlantic Kanada 50 GMT O4 00 Caracas La Paz 55 GMT 04 00 Santiago 56 time zone id 285 Zeitzoneneinstellung Wert GMT 03 30 Neufundland 60 GMT 03 00 Brasilien 65 GMT 03 00 Buenos Aires Georgetown 70 GMT 03 00 Gr nland 73 GMT 02 00 Mittelatlantik 75 GMT 01 00 Azoren 80 GMT 01 00 Kapverdische Inseln 83 GMT Greenwich Mean Time Dublin Edinburgh Lissabon London 85 GMT Casablanca Monrovia 90 GMT 01 00 Belgr
205. ltyp ber den Sie Wert Informationen erhalten m chten Zul ssige Werte sind course presentation oder meeting session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren 210 Kapitel 6 Aktionsreferenz Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report quiz takers gt lt row transcript id integer sco id integer principal id integer status allowedValue score integer asset id integer permission id allowedValue attempts integer time taken integer certificate integer answered survey integer version integer gt lt name gt string lt name gt lt login gt string lt login gt lt date created gt datetime lt date created gt lt principal name gt string lt principal name gt lt override gt boolean lt override gt lt row gt lt report quiz takers gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status report quiz takers Container Informationen zu allen Benutzern die das Quiz beantwortet haben row Container Informa
206. m chten session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report sco views sco id integer type allowedValue is folder boolean views integer gt lt name gt string lt name gt lt last viewed date gt string lt last viewed date gt lt report sco views gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status report sco views Container Gibt an wie oft und wann zuletzt die Pr sentation angezeigt wurde sco id Ganzzahl Die eindeutige Kennung der Pr sentation type Zul ssiger Wert Der Typ des Materialobjekts SCOs Zul ssige Werte sind content curriculum event folder link meeting und tree report sco views 219 Element Attribut Typ Beschreibung is folder Boolescher Wert Gibt an ob das SCO ein Ordner bei 1 oder ein anderer Objekttyp ist bei 0 views Ganzzahl Die Angabe wie h ufig die Benutzer das SCO angezeigt haben name Zeichenfolge Der Name des SCOs last viewed da
207. m der auf den Dom nennamen folgt Der url path muss im Ordner eindeutig sein Ohne Angabe wird der Wert durch den Server zugewiesen Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 lt results gt encoding utf 8 gt lt status code allowedValue gt lt sco folder id integer lang allowedValue type allowedValue sco id integer version integer account id integer icon integer gt lt url path gt string lt url path gt lt description gt string lt description gt lt name gt string lt name gt lt sco gt lt results gt 256 Kapitel 6 Aktionsreferenz Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Antwortstatus Wert zul ssige Werte finden Sie im Abschnitt status sco Container Informationen zu einem gerade neu erstellten SCO einschlie lich der sco id Wird nur bei der Erstellung eines SCOs zur ckgegeben folder id Ganzzahl Die Kennung des Ordners in dem das neue SCO gespeichert ist lang Zul ssiger Eine Abk rzung f r die mit dem SCO Wert verbundene Sprache zul ssige Werte finden Sie im Abschnitt 1ang type Zul ssiger Der Typ des neuen SCOs zu
208. m Abschnitt status report quiz question Container Die Liste der Fragen und ASNT Antworten distribution report quiz question answer distribution 199 Element Attribut Typ Beschreibung row Container Informationen zu einem Benutzer einer Quizfrage und einer Antwort display seq Ganzzahl Die laufende Nummer der Frage im Quiz interaction id Ganzzahl Die Kennung mit der s mtliche Antworten eines Benutzers auf eine Quizfrage gekennzeichnet werden Wenn der Benutzer eine bestimmte Frage mehrmals beantwortet erhalten s mtliche Antworten die gleiche interaction id score Ganzzahl Die Punktzahl die der Benutzer f r die Beantwortung der Frage erhalten hat asset id Ganzzahl Die Kennung der Quizversion aus welcher der Benutzer eine Frage versucht hat zu beantworten Die asset id wird bei jedem Hochladen neuen Materials ge ndert num selected Ganzzahl Bei Multiple Choice oder Wahr Falsch Fragen die Folgenummer der ausgew hlten Antwort response Zeichenfolge Die Antwort die der Benutzer auf die Frage gegeben hat Beispielanforderung https example com api xml action report quiz question answer distribution amp sco id 2006334909 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report quiz question answer distribution gt lt row display seq 1 interaction id 2006334913 score 0 asset id 2006334911 num selected 1 gt lt respon
209. m Browser gestreamt werden Verschl sselt Bei verschl sselten Datenfl ssen werden sichere Verbindungen ber HTTPS und RTMPS Real Time Messaging Protocol ber SSL hergestellt A Der Webbrowser des Clients fordert eine sichere Meeting oder Material URL ber eine verschl sselte Verbindung auf HTTPS 443 an die Verbindungen k nnen auch etwas anders laufen Der Webserver reagiert mit einer verschl sselten bertragung des Materials oder liefert dem Clientbrowser die Daten mit denen dieser ebenfalls verschl sselt auf Acrobat Connect Professional zugreifen kann Flash Player fordert eine verschl sselte Verbindung mit Flash Media Server ber RTMPS 443 an Flash Media Server reagiert Eine dauerhafte Verbindung wird ge ffnet ber welche die Meetingdaten zum Browser gestreamt werden Datenfluss 15 Benutzerdefinierte Anwendungen Connect Enterprise Web Services bietet eine XML API Das bedeutet dass Ihre Anwendung mit XML ber HTTP oder mit XML ber HTTPS mit Enterprise Server bzw Enterprise Hosted kommunizieren k nnen muss Ihre Anwendung ruft die API mithilfe einer Anforderungs URL auf und bergibt ggf einen oder mehrere Parameter und zwar entweder als Name Wert Paar e oder in Form eines XML Dokuments Web Services gibt eine XML Antwort zur ck aus der Sie die gew nschten Werte extrahieren k nnen Benutzerdefinierte Anwendungen erhalten die ben tigten Metadaten aus der Connect Enterprise Datenbank
210. m Meeting verkn pften Archive aufzulisten https example com api xml action sco contents amp sco id 2007018414 amp filter icon archive Analysieren Sie die Antwort und suchen Sie nach dem sco Element Extrahieren Sie die y gew nschten Informationen wie name date created oder url path lt sco sco id 2598402 source sco id folder id 2598379 type content icon archive display seq 0 is folder 0 gt lt name gt EN Monday Night Footbal1l_0 lt name gt lt url path gt p71144063 lt url path gt lt date begin gt 2004 05 17T15 51 54 670 07 00 lt date begin gt lt date end gt 2004 05 17T15 54 52 920 07 00 lt date end gt lt date modified gt 2004 05 17T15 55 00 733 07 00 lt date modified gt lt duration gt 00 02 58 250 lt duration gt lt sco gt 66 Kapitel 4 Meetings Abstimmungsergebnisse abrufen Wenn Sie auf die Ergebnisse einer w hrend eines Meetings durchgef hrten Abstimmung zugreifen m chten k nnen Sie report quiz interactions verwenden Diese Aktion gibt alle Ergebnisse zur ck aber Sie k nnen die Antwort mithilfe eines Filters einschr nken Jede Multiple Choice Antwort der Abstimmung wird durch eine ganzzahlige Kennung identifiziert Dabei erh lt die erste Antwort in der angezeigten Liste die Ziffer 0 die zweite die Ziffer 1 usw What is your favourite color Antwort O r Blue 2 Antwort Red 3 white o Gold 1 D Pink 1 D Violet o E Ergebnisse ver ffentlich
211. mal zul ssigen gleichzeitigen Meetingteilnehmer wird durch Ihre Connect Enterprise Lizenz bestimmt Sie k nnen sowohl diesen Wert berpr fen als auch die maximale Anzahl der gleichzeitigen Meetingteilnehmer in einem bestimmten Zeitraum Die Meetingnutzung pro Benutzer berechnen 1 Rufen Sie report bulk consolidated transactions auf und filtern Sie ggf nach den gew nschten Meetings bzw optional nach anderen Werten https example com api xml action report bulk consolidated transactions amp filter type meeting amp filter gt date created 2006 07 01 m Der zweite Filter kann sich auf den Beginn oder das Ende der Transaktion beziehen sowie auf die principal id des Benutzers auf die sco id eines bestimmten Meetings oder je nach Anforderung auch auf andere zul ssige Filter m Dieser Aufruf gibt s mtliche Transaktionen zur ck die den Filterkriterien entsprechen Allerdings ist die Antwort unter Umst nden sehr umfangreich 64 Kapitel 4 Meetings 2 Durchsuchen Sie die row Elemente der Antwort nach date created und date closed lt row transaction id 2007071217 sco id 2007071193 type meeting principal id 2007003123 score 0 gt lt name gt Thursday Meeting lt name gt lt url thursday lt url gt lt login gt jazz doe com lt login gt lt user name gt jazzwayjazz doe lt user name gt lt status gt completed lt status gt lt date created gt 2006 08 03T12 33 48 547 07 00 lt date created gt lt date closed
212. ments gt string lt comments gt lt name gt string lt name gt lt field gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Antwortstatus Wert zul ssige Werte finden Sie im Abschnitt status field Leer mit Informationen zum benutzerdefinierten Attributen Feld field id Ganzzahl Eine numerische Kennung des Felds display seq Ganzzahl Die Position auf der das Feld in Enterprise Manager bzw in Ihrer Anwendung angezeigt wird object type Zul ssiger Der Typ des Objekts das mit dem Feld Wert beschrieben wird zul ssige Werte finden Sie im Abschnitt type account id Ganzzahl Bei Enterprise Hosted Kunden die Kennung des Kontos in dem das Feld definiert wurde is primary Boolescher Gibt an ob das benutzerdefinierte Feld Wert gel scht werden kann true wenn es nicht gel scht werden kann und false wenn dies m glich ist 108 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung permission id Zul ssiger Die Berechtigung die erforderlich ist Wert um auf das benutzerdefinierte Feld zuzugreifen zul ssige Werte finden Sie im Abschnitt permission id is required Boolescher Gibt an ob in dieses Feld ein Wert Wert eingegeben werden muss true wenn der Wert erforderlich ist und false wenn er optional ist field typ
213. missions update aufrufen um den Meetingzugang festzulegen public void setPermissions String aclId String principalld String permissionld throws XMLApiException request permissions update acl id aclId amp principal id principalld amp permission id permissionld Meetings erstellen und aktualisieren 303 Einzelinformationen zu Meetings anzeigen Die entsprechenden Beispieldateien sind XMLApiAdapter java SCO java mymeetings jsp und showmeeting jsp SISMNIH Die meisten Meetingdaten die Sie anzeigen k nnen werden mit sco info abgerufen https example com api xml action sco info amp sco id 2006334909 Die Antwort enth lt mehrere anzeigbare Werte zum Beispiel lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt sco account id 624520 disabled display seq 0 folder id 2006258747 icon producer lang en max retries sco id 2006334909 source sco id type content version 1 gt lt date created gt 2006 05 11T12 00 02 000 07 00 lt date created gt lt date modified gt 2006 05 16115 22 25 703 07 00 lt date modified gt lt name gt Test Quiz lt name gt lt url path gt quiz lt url path gt lt passing score gt 1l0 lt passing score gt lt duration gt 15100 0 lt duration gt lt section count gt 6 lt section count gt lt sco gt lt results gt Informationen Uber ein SCO abrufen Die Java Methode getSco f h
214. ml action report my meetings Sie k nnen die Antwort mithilfe von Filtern einschr nken So k nnen Sie beispielsweise die Meetings ausschlie en die bereits durchgef hrt wurden https example com api xml action report my meetings amp filter expired false Werten Sie die Antwort nach den meet ing Elementen aus lt meeting sco id 2007063179 type meeting icon meeting permission id host active participants 0 gt lt name gt September All Hands Meeting lt name gt lt domain name gt example com lt domain name gt lt url path gt septl5 lt url path gt lt date begin gt 2006 09 15T09 00 00 000 07 00 lt date begin gt lt date end gt 2006 09 15T18 00 00 000 07 00 lt date end gt lt expired gt false lt expired gt lt duration gt 09 00 00 000 lt duration gt lt meeting gt Erstellen Sie die URL zum Meetingraum indem Sie http bzw https url path und domain name miteinander verbinden Einem Meeting einen Benutzer hinzuf gen und die Meetings anzeigen 1 2 Melden Sie sich als Benutzer mit Administratorrechten fiir Ihre Anwendung an Rufen Sie die principal id des betreffenden Benutzers ab entsprechende Hinweise finden Sie im Abschnitt Die principal id suchen Rufen Sie die sco id des betreffenden Meetings ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Meetings suchen Meetings anzeigen 55 4 Rufen Sie permissions update auf um den Benutzer dem Meeting hin
215. ml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt my meetings gt lt lt meeting sco id integer type meeting icon meeting permission id allowedValue active participants integer gt ame gt string lt name gt lt description gt string lt description gt lt domain name gt domain lt domain name gt lt url path gt uri lt url path gt lt date begin gt date lt date begin gt lt date end gt date lt date end gt lt expired gt boolean lt expired gt lt duration gt time lt duration gt lt meeting gt lt my meetings gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status my meetings Container Informationen zu allen Meetings zu denen der Benutzer eingeladen ist oder war meeting Container Informationen zu einem Meeting des Benutzers sco id Ganzzahl Die eindeutige Kennung des Meetings type Zul ssiger Der Typ des zur ckgegebenen Wert Objekts bei diesem Aufruf immer meeting 188 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung icon Zul ssiger Das Symbol mit dem das Meeting in Wert Enterprise Manager sichtbar gekennzeichnet wird bei diesem Aufruf immer meeting permission id
216. n Die Berechtigung Verwalten erm glicht hier die Erstellung L schung und Bearbeitung von Objekten bzw die Zuweisung von Berechtigungen In der Standardkonfiguration erhalten die Benutzer nur die Verwaltungsberechtigung f r ihre eigenen Schulungsordner Dagegen haben die Administratoren Verwaltungsberechtigung f r s mtliche Ordner der Schulungsbibliothek 72 Kapitel 5 Schulungen Durch den Aufruf von permissions update kann ein Administrator einem Benutzer die Verwaltungsberechtigung f r einen bestimmten Kurs Studienplan oder Ordner erteilen Mit permissions info kann er die Berechtigungen des Benutzers berpr fen Bei Ihrer Arbeit mit der Schulungsbibliothek nutzen Sie die XML API Aufrufe um die Werte von permission id zu lesen zu nutzen oder einzustellen F r Kurse und Studienpl ne gelten die folgenden permission id Werte view Der Benutzer erh lt Zugang zum Kurs oder Studienplan seine Berechtigung lautet Eingeschrieben denied Der Benutzer erh lt keinen Zugang seine Berechtigung lautet Verweigert Vor dem Aufruf einer API Aktion sollten Sie sich auch ber die Berechtigung eines Benutzers f r einen bestimmten Ordner im Klaren sein Melden Sie sich daher als Benutzer mit den entsprechenden Berechtigungen an oder ggf als Administrator Ihrer Anwendung F r die Schulungsordner gelten die folgenden permission id Werte manage Der Benutzer kann in diesem Ordner Kurse Studienpl ne und Materialien h
217. n Sie die Antwort und suchen Sie den Statuscode ok Verwenden Sie bei nachfolgenden Aufrufen dieses Benutzers den Parameter session immer mit dem gleichen Cookie Wert bis die Sitzung abl uft Zum Beispiel https example com api xml action principal list Asession breezxq66rt43poai3if8 Wenn sich der Benutzer abmeldet oder die Benutzersitzung beendet wird d rfen Sie diesen Cookie Wert nicht mehr verwenden Aus einer Anwendung heraus anmelden 25 An Enterprise Hosted anmelden Wenn Sie sich direkt an ein gehostetes Konto bzw mehrere gehostete Konten anmelden m chten k nnen Sie die Aktion login ebenfalls verwenden m ssen aber dabei das gew nschte Konto oder den Dom nennamen sowie den Anmeldenamen des Benutzers und dessen Kennwort angeben Sie k nnen einen Dom nennamen angeben wenn Sie die Kontenkennung nicht ber das Internet senden m chten Bei einem gehosteten Konto k nnen Sie aber kein SSO Single Sign On oder eine externe Authentisierung verwenden Statt der Anmeldedaten des externen Netzwerks m ssen Sie also die Authentisierungsdaten des Benutzers an Enterprise Hosted bergeben Aus diesem Grund ist es von entscheidender Bedeutung dass f r Ihr Konto SSL aktiviert wurde da Sie die Anmeldenamen Kennw rter und Kontoinformationen f r Enterprise Hosted ber das Internet zu dem bei Adobe gehosteten Konto senden SISMNIH Mit einem Anmeldenamen an Enterprise Hosted anmelden 1 Bevor Sie den Ben
218. n dem das gew nschte Meeting gespeichert ist 4 Werten Sie die Antwort nach der sco id des Meetings aus lt sco sco id 2006743452 source sco id 1625529 folder id 2006258750 type meeting icon meeting display seq 0 is folder 0 gt lt name gt Intro to Film lt name gt lt url path gt film lt url path gt lt date begin gt 2006 06 09T14 00 00 000 07 00 lt date begin gt lt date end gt 2006 06 09T20 00 00 000 07 00 lt date end gt lt date modified gt 2006 06 09T14 07 13 767 07 00 lt date modified gt lt duration gt 06 00 00 000 lt duration gt lt sco gt 54 Kapitel 4 Meetings Meetings anzeigen In Ihrer Anwendung m chten Sie unter Umst nden eine Liste der Acrobat Connect Professional Meetings anzeigen wie z B die aktuell oder zuk nftig geplanten Meetings eines Benutzers Bei einem solchen Anwendungsablauf wird m glicherweise ein Benutzer angemeldet und dann eine Liste der Meetings dieses Benutzers angezeigt oder die Anwendung f gt diesen Benutzer einem Meeting hinzu und zeigt dann die Meetings an Die Anzeige der Meetings eines Benutzers entspricht der Auflistung des Inhalts seines my meet ings Ordners Die Meetings eines Benutzers anzeigen 1 3 4 Melden Sie den betreffenden Benutzer an siehe hierzu Abschnitt Aus einer Anwendung heraus anmelden Rufen Sie report my meetings auf um die Meetings des betreffenden Benutzers anzuzeigen https example com api x
219. n von neu erstellten Benutzern sp ter ndern Dabei k nnen Sie die f r Benutzer definierten Standardfelder durch einen Aufruf von principal update mit der principal id des Benutzers durchf hren Zu diesen Standardfelder geh ren email login first name und last name Wenn Sie f r einen Principal benutzerdefinierte Felder eingerichtet haben k nnen Sie diese mit ac field update aktualisieren Zur Aktualisierung der Benutzerdaten ben tigen Sie Administratorrechte daher muss die Anwendung Sie zun chst als Mitglied der Gruppe admins anmelden Es ist nicht m glich einen Benutzer anzumelden und dann dessen Profil selbst zu ndern Anmelden und einen Benutzer aktualisieren 1 Melden Sie sich als Administrator an 2 Rufen Sie principal 1ist mit einem Filter auf um die principal id des Benutzers zu erhalten siehe Abschnitt Die principal id suchen 3 Rufen Sie principal update auf um den Benutzer zu aktualisieren https example com api xml action principal update amp principal id 2006282569 amp email jazzdoe newcompany com 4 Analysieren Sie die Antwort und suchen Sie den Statuscode ok Benutzer aktualisieren 41 Benutzerdefinierte Felder erstellen Benutzerdefinierte Felder sind Felder die Sie selbst einrichten Mithilfe von custom field update k nnen Sie bis zu acht Felder f r einen Principal oder ein SCO definieren Wenn Sie das benutzerdefinierte Feld erstellt haben k nnen Sie dessen Wert in der Standar
220. nach dem Aufruf einer Aktion die Antwort nach dem Status 3 Falls der Status nicht ok lautet geben Sie den Wert nu11 zur ck zeigen Sie den Fehlerstatuscode fiir ein Debugging an oder geben Sie eine Anwendungsausnahme aus Welche Aktion Sie ausf hren m ssen h ngt davon ab welchen Aufruf Sie gerade ausf hren und wie der Entwurf Ihrer Anwendung aussieht Einen Benutzer abmelden Wenn sich ein Benutzer abmeldet wird die aktuelle Benutzersitzung beendet und das Cookie BREEZESESSION von Connect Enterprise zur ckgesetzt Hierzu wird dessen Wert auf null gesetzt und ein Ablaufdatum in der Vergangenheit abgespeichert Wenn beispielsweise am 29 August 2006 logout aufgerufen wurde wird im Antwort Header folgende Set Cookie Methode angezeigt Mit ihr wird ein leerer Cookie Wert festgelegt und das Ablaufdatum um ein Jahr zur ckgesetzt Set Cookie BREEZESESSION domain macromedia com expires Mon 29 Aug 2005 22 26 15 GMT path Falls Sie das Cookie BREEZESESSION selbst verwalten m ssen Sie seinen Wert l schen damit es nach der Abmeldung des Benutzers nicht erneut verwendet werden kann Einen Benutzer abmelden und das Sitzungs Cookie zur cksetzen 1 Rufen Sie logout auf um den Benutzer abzumelden https example com api xml action logout 2 Suchen Sie nach dem Statuscode ok um sicherzustellen dass die Abmeldung erfolgreich war 3 Setzen Sie den Cookie Wert auf nul oder auf andere Weise zur ck Im folgenden Java Co
221. nationen zur ck es sei denn Sie verwenden einen Filter um die Antwort einzuschr nken Anforderungs URL http server_name api xml action report bulk questions amp filter definition value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report bulk questions gt lt row transaction id integer score integer principal id integer gt lt question gt string lt question gt lt response gt string lt response gt lt date created gt datetime lt date created gt lt row gt lt report bulk questions gt lt results gt 154 Kapitel 6 Aktionsreferenz Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status report bulk questions Container Die vollst ndige Liste der Frage Antwort Kombinationen die den Bedingungen der Anforderung entsprechen row Co
222. nect Enterprise Web Services 6 Beschreibung Listet alle benutzerdefinierten Felder auf die f r ein Konto angelegt wurden und gibt Informationen zu den Feldern zur ck Benutzerdefinierte Felder enthalten Informationen zu Objekten SCOs oder Principals die in der Standardinstallation von Adobe Connect Enterprise Manager nicht festgelegt wurden Mit custom field update k nnen Sie benutzerdefinierte Felder erstellen oder ihre Werte ndern Anforderungs URL http server_name api xml action custom fields amp filter definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt custom fields gt lt field permission id allowedValue object type allowedValue field id string account id integer display seq integer field type allowedValue is primary boolean is required boolean gt lt name gt string lt name gt lt field gt lt custom fields gt lt results gt custom fields 101 Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden statu
223. nect Professional die Software in der der Meetingraum gehostet wird Adobe Connect Enterprise Server bzw Adobe Connect Enterprise Hosted streamen daraufhin die Audio Video und Rich Media Daten der Materialien zu den Benutzern die im Meetingraum versammelt sind Adobe empfiehlt die folgenden Aktionen f r Meetinganwendungen report my meetings Anzeigen der Meetings eines Benutzers sco update Erstellen eines Meetingraums bzw Aktualisieren seiner Daten permissions update Hinzuf gen von Veranstaltern Moderatoren und Teilnehmern report bulk consolidated transactions Berechnen der Nutzung von Meetings insbesondere der Zeit die jeder Benutzer im Meeting verbracht hat report quiz interactions Ermitteln der Ergebnisse einer Meetingumfrage F r den Aufruf einiger meetingbezogener Aktionen sind Administratorrechte erforderlich Hinweise hierzu finden Sie in den individuellen Anleitungen Damit Sie in Ihrer Anwendung solche Aufrufe durchf hren k nnen wird empfohlen einen Connect Enterprise Benutzer zu erstellen der Mitglied der Gruppe admins ist Meetings suchen H ufig m ssen Sie zun chst die sco id eines Meetings suchen damit Sie Benutzer einladen Berichtsdaten abrufen oder die Daten in anderer Weise ndern k nnen 53 Zu diesem Zweck sollten Sie die Struktur der Ordner kennen in denen die Meetings gespeichert werden k nnen In der Standardkonfiguration werden Meetings im Ordner Meine Meetings des betreffenden Veran
224. nen Namen Durch einen Aufruf von common info k nnen Sie nach der Anmeldung des Benutzers bestimmte grundlegende Daten zu seiner Person abrufen https example com api xml action common info In der Antwort gibt es dabei ein user Element mit Informationen die Sie anzeigen oder in Variablen ablegen und sp ter wiederverwenden k nnen lt user user id 2006258745 type user gt lt name gt Joy Smith lt name gt lt login gt joy acme com lt login gt lt user gt Wenn Sie common info aufrufen bevor der Benutzer angemeldet wurde so enth lt die Antwort kein user Element 298 Anhang A Ein Anwendungsbeispiel Informationen ber einen Benutzer abrufen In diesem Beispiel ruft die Methode getUser Info die Aktion common info auf und durchsucht die Antwort nach den Werten von name login und user id Die Methode speichert daraufhin diese Benutzerdaten in einer Instanz der UserInfo Klasse einer Bean Standardklasse mit getter und setter Methoden public UserInfo getUserInfo String login String password throws XMLApiException try Element e request common info login password XPath name XPath newInstance user name XPath log XPath newInstance user login XPath id XPath newInstance user user id login amp password UserInfo user new UserInfo user setLogin log valueOf e user setName name valueOf e user setUserlId id valueOf e return user catch JDOMExc
225. nes Material SCOs das in einem Kurs oder Studienplan verwendet worden ist Die Kennung eines Ordners die als sco idin der Anforderung bergeben wird Der Typ des Objekts zul ssige Werte finden Sie im Abschnitt type SCOs die Materialien sind haben den Typ content andere SCOs dagegen einen genauer definierten Typ wie presentation Der Name des Symbols mit dem das Objekt identifiziert wird Stellt weitere Informationen zu dem mit type bezeichneten Objekttyp bereit Die Position auf der das Objekt in Enterprise Manager bzw in Ihrer Anwendung angezeigt wird Gibt an ob das Objekt ein Ordner bei 1 oder ein anderer Objekttyp ist bei 0 230 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung byte count Ganzzahl Die Gr e des Inhalts Bei Ordnern betr gt dieser Wert 0 ref count Ganzzahl Die Anzahl der SCOs die dieses SCO referenzieren name Zeichenfolge Der Name des Objekts auf dem Server url path Zeichenfolge Die eindeutige Kennung in der URL description date modified date begin date end domain name duration sco tag Zeichenfolge Datetime Datum Uhrzeit Datetime Datum Uhrzeit Datetime Datum Uhrzeit Zeichenfolge Datetime Datum Uhrzeit Zeichenfolge des SCOs hinter dem Dom nennamen Die Beschreibung des Objekts Das Datum der letzten nderung des Objekts Das Beginndatum eines Kurses oder Meetings wird nur bei Kursen und Meeting
226. nfo Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt Informationen zu einem SCO in Connect Enterprise bereit Das Objekt kann einen beliebigen SCO Typ haben Eine Liste der zul ssigen SCO Typen finden Sie im Abschnitt type Die Antwort beinhaltet auch das Konto zu dem das SCO geh rt sowie die Daten der Erstellung und der letzten Aktualisierung den Eigent mer die URL die zum Objekt f hrt und andere Informationen Bei einigen SCO Typen gibt die Antwort auch Informationen zur Vorlage zur ck mit der dieses SCO erstellt wurde sco info 237 Anforderungs URL http server_name api xml action sco info amp sco id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung des SCOs auf dem Server session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt sco account id integer disabled datetime display seq integer folder id integer icon allowedValue lang allowedValue max retries integer sco id integer source sco id integer type allowedValue version integer gt lt date begin gt datetime lt date begin gt lt date created gt datetime lt
227. ng sco id Ganzzahl J Die eindeutige Kennung eines SCOs dessen Ordnerhierarchie Sie bis zur obersten Ebene anzeigen m chten session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt sco nav gt lt sco sco id integer type allowedValue icon allowedValue depth integer gt lt name gt string lt name gt lt sco gt lt sco nav gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zulassiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status 244 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung sco nav Sco name Container Die gesamte Navigationsstruktur vom obersten Ordner bis zum gew nschten SCO Container Informationen zu einem SCO in der Hierarchie sco id Ganzzahl Die eindeutige Kennung des SCOs type Zul ssiger Wert Der Typ des SCOs zul ssige Werte finden Sie im Abschnitt type icon Zul ssiger Wert Das Symbol das das SCO visuell identifiziert zul ssige Werte finden Sie im Abschnitt icon depth Ganzzahl Gibt
228. nings taken gt lt results gt report user training transcripts Verf gbarkeit Connect Enterprise Web Services 6 Beschreibung Gibt eine Liste mit allen Lernzielkopien von Schulungen zur ck an denen ein Benutzer teilgenommen hat Eine Lernzielkopie ist dabei eine Aufzeichnung der Punktzahlen die ein Benutzer f r die Bearbeitung eines Schulungs SCOs erhalten hat Zu diesen Schulungs SCOs z hlen Kurse Studienpl ne Meetings und Veranstaltungen Die Antwort kann mehrere Lernzielkopien f r ein SCO enthalten wenn der Benutzer an einer Schulung mehrmals teilgenommen hat Auch wenn ein Benutzer bei einer Schulung im ersten Anlauf durchf llt kann er mit dem zweiten Versuch immer noch bestehen F r jeden Versuch gibt es eine Lernzielkopie und beide Kopien werden im Bericht aufgef hrt Anforderungs URL http server_name api xml action report user training transcripts amp principal id integer amp session BreezeSessionCookieValue 224 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung principal id Ganzzahl J Die Kennung des Benutzers dessen Lernzielkopie n Sie abfragen m chten session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt
229. nkt zwar Meetings geplant aber keine Benutzer anwesend sind gibt report active meetings eine leere Antwort zur ck Anforderungs URL http server_name api xml action report active meetings amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt results gt lt status code allowedValue gt lt report active meetings gt lt sco sco id integer active participants integer length minutes integer gt lt name gt string lt name gt lt url path gt string lt url path gt lt date begi gt datetime lt date begin gt lt sco gt lt report active meetings gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status report active meetings 145 Element Attribut Typ Beschreibung report active Container Die Liste aller Meetings die meetings derzeit stattfinden sco Container Informationen zu einem aktuellen Meeting sco id Ganzzahl Die eindeutige Kennung eines aktuellen Meetings active Ganzz
230. nt id field id Zeichenfolge Der Name des Felds value Zeichenfolge Der Wert des Felds Beispielanforderung https example com api xml action acl field info amp acl id 2006258745 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt acl fields gt lt field acl id 2006258745 field id email gt lt value gt joy acme com lt value gt lt field gt lt field acl id 2006258745 field id first name gt lt value gt Joy lt value gt lt field gt lt field acl id 2006258745 field id last name gt lt value gt Smith lt value gt lt field gt lt acl fields gt lt results gt Siehe auch acl field list acl field update acl field list Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Gibt eine Liste mit Werten f r alle Instanzen eines Feldnamens in Enterprise Server oder in Ihrem Enterprise Hosted Konto zur ck Um z B die Vornamen aller Benutzer des Kontos aufzulisten rufen Sie acl field list mit field id first name auf Sie k nnen acl field info zuerst aufrufen um eine Liste mit allen Feldnamen zu erhalten acl field list 91 Anforderungs URL http server_name api xml action acl field list amp field id string amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung field id Zeichenfolge J Der Name eines Felds in der Access Control List ACL dessen Werte
231. ntainer Informationen zu einer Frage transaction id Ganzzahl score Ganzzahl principal id Ganzzahl question Zeichenfolge response Zeichenfolge date created Datetime Datum Uhrzeit Antwort Kombination Die Kennung der Interaktion zwischen einem Benutzer und einem Quiz Die Punktzahl die der Frage zugeordnet wurde Die Kennung des Benutzers der die Frage angezeigt oder beantwortet hat Der Text der Frage der ggf auch als Aussage formuliert werden kann Die Antwort die der Benutzer ausgew hlt oder eingegeben hat Das Datum und die Uhrzeit der Beantwortung der Frage Beispielanforderung https example com api xml action report bulk questions report bulk questions 155 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report bulk questions gt lt row transaction id 2006335803 score 10 principal id 2006258745 gt lt question gt The capital of California is lt 1l gt lt question gt lt response gt Sacramento lt response gt lt date created gt 2006 05 11115 50 23 643 07 00 lt date created gt lt row gt lt row transaction id 2006335827 score 0 principal id 2006258745 gt lt question gt The capital of California is lt 1 gt lt question gt lt response gt san francisco lt response gt lt date created gt 2006 05 11117 32 53 970 07 00 lt date created gt lt row gt lt report bulk questions gt lt results g
232. nter erstellt wurde Ein Seminar das mit Adobe Acrobat Connect Professional Seminars erstellt wurde Eine Instanz eines regelm ig stattfindenden Acrobat Connect Professional Meetings Eine Adobe Macromedia Flash Datei lang Beschreibung Eine aus zwei oder drei Buchstaben bestehende Abk rzung f r eine Sprache gem den Spezifikationen von ISO 639 ISO 639 1 beschreibt die aus zwei Buchstaben ISO 639 2 die aus drei Buchstaben bestehenden Abk rzungen Dieser Sprachcode wirkt sich auf die Anzeige der Connect Enterprise Anwendung aus beispielsweise auf Meetingr ume oder die Anzeige von Enterprise Manager Werte 2 Buchstaben 3 Buchstaben Sprache en eng Englisch fr fre Franz sisch die Abk rzung fra ist nicht zul ssig de ger Deutsch die Abk rzung deu ist nicht zul ssig Ja jpn Japanisch ko kor Koreanisch 278 Kapitel 8 Allgemeine Referenz object type Beschreibung Ein Attribut das den Typ eines Connect Enterprise Objekts beschreibt Werte Wert Beschreibung object type account Ein Konto ber das Principals und SCOs verwaltet werden object type action Eine Aktion der XML API von Web Services object type event Eine Acrobat Connect Professional Veranstaltung object type hidden Ein SCO das in Enterprise Manager bzw in Ihrer Anwendung sofern Sie diesen Wert verwenden nicht angezeigt wird object type meeting Ein Acrobat Connect Professional Meeting
233. ntos auf Hierzu k nnen Sie entweder die Anforderungs URL oder den Parameter domain verwenden http acme adobe com api xml action common info http adobe com api xml action common info amp domain acme adobe com Werten Sie die Antwort nach den Werten der Felder cookie und host aus lt cookie gt breezxq66rt43poai3i f8 lt cookie gt lt host gt https acme adobe com lt host gt Extrahieren Sie den Domanennamen aus dem Wert von host acme adobe com Speichern Sie in der Anwendung den Anmeldenamen und das Kennwort des Benutzers zwischen Stellen Sie dabei sicher dass der Anmeldename des Benutzers der Anmeldename fiir Enterprise Hosted und nicht fiir das externe Netzwerk ist Rufen Sie die Aktion login auf und geben Sie die Daten des Benutzers sowie die Parameter domain und session an https example com api xml action login amp login joe amp password smith99 amp domain acme adobe com amp session breezxq66rt43poai3if8 Der Wert von domain entspricht eigentlich dem von account id aber auf diese Weise k nnen Sie vermeiden eine Kontenkennung ber das Internet zu senden besonders dann wenn Sie eine nicht verschl sselte Verbindung verwenden Analysieren Sie die Antwort und suchen Sie den Statuscode ok Optional Wenn Sie m gen k nnen Sie login auch vor common info aufrufen den Cookie Wert aus der Antwort extrahieren und den Wert dann entweder selbst verwalten oder dies einer Cookie Managementbibliothek
234. nutzers Nicht bei externer oder HTTP Header Authentisierung verwenden Der Dom nenname Ihres Kontos bei Enterprise Hosted Wenn Ihr Unternehmen Enterprise Server nutzt sollten Sie domain nicht verwenden Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt results gt login 117 Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Attributen Der Status der Antwort code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Beispielanforderung http example com api xml action login amp login joy acme com amp password happy amp session breeztg8mz53r93vebwur Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Siehe auch logout logout Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Beendet die Anmeldesitzung eines Benutzers und macht den mit der Benutzersitzung verkn pften Cookie Wert ung ltig Nach dem Aufruf von logout wird der Wert des BREEZESESSION Cookies auf null gesetzt Wenn der Benut
235. object type principal Ein Benutzer bzw eine Gruppe object type readonly Eine Einstellung die angibt dass Enterprise Manager zwar bestimmte Daten anzeigt diese aber in Enterprise Manager von den Benutzern nicht ge ndert werden k nnen object type sco Ein SCO Diese Objekte stellen Meetings Kurse Studienpl ne Materialobjekte Ordner oder beliebige andere Objekte auf dem Server dar path type Beschreibung Das Attribut path type beschreibt den Typ des Lernpfads zwischen zwei Objekten in einem Studienplan zum Beispiel ob ein Objekt abgeschlossen werden muss damit das zweite begonnen werden kann Werte Wert Beschreibung completion none Es ist f r den Abschluss des Studienplans nicht erforderlich das aktuelle SCO abzuschlie en completion required Das aktuelle SCO muss abgeschlossen werden prereq none Fur das aktuelle Lernobjekt gibt es keine Vorbedingungen path type 279 Wert Beschreibung prereq required Fur das aktuelle Lernobjekt gibt es eine Vorbedingung die erfullt sein muss prereq hidden Das Ziellernobjekt ist eine erforderliche Vorbedingung Das aktuelle Lernobjekt wird erst angezeigt wenn das Ziellernobjekt abgeschlossen ist prereq suggested Das aktuelle SCO ist eine empfohlene Vorbedingung es ist allerdings nicht erforderlich preass blocked Das aktuelle SCO enth lt einen Einstufungstest Wenn der Teilnehmer den Test besteht ist das Objekt gesperrt Andernfalls steht das Objekt zur
236. oder einen eigenen Server lizenziert haben Ihre Anwendung wird sich entweder unmittelbar bei Connect Enterprise authentisieren oder Sie authentisieren die Benutzer in Ihrem Netzwerk selbst definieren eine Kennung mithilfe einer HT TP Anforderung und senden diese an Connect Enterprise Der Anmeldevorgang unterscheidet sich in Abh ngigkeit vom Authentisierungsverfahren An Enterprise Server anmelden Das Standardverfahren f r die Anmeldung eines Benutzers an Enterprise Server verwendet die Aktion login mit der der Anmeldename und das Kennwort des Benutzers bergeben werden Dieses Verfahren funktioniert sowohl bei den GET als auch bei den POST Anforderungen von HTTP Allerdings m ssen Sie dabei das Cookie BREEZESESSION verwalten k nnen das der Server f r jede Benutzersitzung zur ckgibt Falls Sie eine clientseitige Cookie Managementbibliothek verwenden ist es viel einfacher wenn Sie ihr das Cookie Management berlassen und nicht die Cookies selbst verwalten m ssen Ohne eine solche Bibliothek sollten Sie login lieber mit dem Parameter session aufrufen da dieses Verfahren viel einfacher und zuverl ssiger ist als das Einstellen eines HTTP Headers F r das Senden der Benutzerkennworter an Enterprise Server wird au erdem die Nutzung von SSL empfohlen so dass die Kennw rter w hrend der bertragung verschl sselt sind Dies gilt auch f r lizenzierte Enterprise Server innerhalb Ihrer eigenen Firewall SI3SMNIH
237. odified gt lt sco gt Kurse und Studienplane suchen 75 Schulung eines Benutzers anzeigen Wenn ein Benutzer angemeldet ist k nnen Sie mithilfe von report my courses alle Kurse auflisten zu denen dieser Benutzer angemeldet ist Mit report my training fragen Sie alle Kurse und Studienpl ne des Benutzers ab Mit diesem Aufruf zeigen Sie nur die Kurse bzw die Kurse und Studienpl ne an f r die der Benutzer eingeschrieben ist nicht alle verf gbaren Kurse Kurse und Studienpl ne eines Benutzers anzeigen 1 Melden Sie den betreffenden Benutzer an siehe hierzu Abschnitt Aus einer Anwendung heraus anmelden Rufen Sie report my training auf um s mtliche Kurse und Studienpl ne aufzulisten in denen ein Benutzer eingeschrieben ist https example com api xml action report my training Werten Sie die Antwort nach name ur oder einem anderen Wert aus den Sie anzeigen m chten lt row sco id 2007035246 type content icon course permission id view gt lt name gt Java 101 lt name gt lt url gt example com javal01 lt url gt lt date created gt 2006 07 20T17 21 11 940 07 00 lt date created gt lt date modified gt 2006 07 20T17 21 38 860 07 00 lt date modified gt lt date begin gt 2006 07 20T17 15 00 000 07 00 lt date begin gt lt url path gt javal01 lt url path gt lt expired gt false lt expired gt lt completed gt false lt completed gt lt row gt Status aller Ku
238. oftware kommerzieller Computersoftware und Commercial Computer Software Documentation Dokumentation kommerzieller Computersoftware im Sinn von 48 C ER 12 212 bzw 48 C ER 227 7202 Entsprechend der Bestimmungen unter 48 C ER 12 212 bzw 48 C ER 227 7202 1 bis 227 7202 4 werden diese kommerzielle Computersoftware und ihre Dokumentation unter folgenden Bedingungen an Endbenutzer in Beh rden der US Regierung lizenziert a es handelt sich nur um Wirtschaftsg ter und b die Lizenz beinhaltet nur die Rechte die auch allen anderen Endbenutzern gem der hier beschriebenen allgemeinen Bedingungen gew hrt werden Unver ffentlichte Rechte vorbehalten gem den in den USA geltenden Urheberrechten Adobe Systems Incorporated 345 Park Avenue San Jose California 95110 2704 USA Im Hinblick auf Endbenutzer in Beh rden der US Regierung erkl rt Adobe die Einhaltung aller ggf anwendbaren Gleichstellungsgesetze sowie der Executive Order 11246 einschlie lich ihrer nderungen des Abschnitts 402 des Vietnam Era Veterans Readjustment Assistance Act von 1974 38 USC 4212 des Abschnitts 503 des Rehabilitation Act von 1973 einschlie lich seiner nderungen und den Bestimmungen in 41 CFR Teile 601 bis 6060 60250 und 60741 Die Minderheitsf rderungsklausel und die entsprechenden Bestimmungen soweit der vorstehende Satz diese betrifft gelten per Referenz Inhaltsverzeichnis Vorbereitungsma nahmen nass nnennnnen nun nun nenn
239. olderld else sb append sco id sco getId Iterator iter data keySet iterator while iter hasNext String key String iter next if key indexOf sco id 1 continue if key indexOf folder id 1 302 Anhang A Ein Anwendungsbeispiel continue String value String data get key sb append amp key value if null data get type throw new XMLApiException SCO type not defined Element e request sco update sb toString XPath scold XPath newInstance results sco sco id if scold valueOf e null return null else return scold valueOf e catch JDOMException jde throw new XMLApiException PARSE_ERROR jde catch ParseException pe throw new XMLApiException PARSE_ERROR pe Meetingzugang festlegen Sobald Sie eine sco id haben muss der Zugang definiert werden Der das Meeting erstellende Benutzer ist normalerweise auch der Veranstalter und kann entscheiden ob das Meeting ffentlich oder privat ist Hierzu legt er mit permissions update bestimmte Werte f r permission id und principal id fest Mit dem folgenden Aufruf wird beispielsweise festgelegt dass es sich um ein ffentliches Meeting handeln soll https example com api xml action permissions update amp ac id 2006334033 amp principal id public access amp permission id view hidden Wenn ein Benutzer diese Werte definiert kann er mit setPermissions die Aktion per
240. om lt ext login gt lt name gt jamm doe lt name gt lt principal gt Einen Benutzer erstellen ohne eine E Mail Adresse als Anmelde ID anzugeben 1 Wechseln Sie in Enterprise Manager zu Administration gt Benutzer und Gruppen gt Anmelde und Kennwortrichtlinien bearbeiten Stellen Sie sicher dass die Option E Mail Adresse f r Anmeldung verwenden auf Nein eingestellt ist Melden Sie sich an Ihre Anwendung mit Administratorrechten an Rufen Sie principal update auf um den neuen Benutzer zu erstellen und bergeben Sie dabei die Parameter login und email https example com api xml action principal update first name jazz amp last name doe amp login jazz amp emai l jazzdoe company com amp password nothing amp type user amp has children 0 40 Kapitel 3 Grundlagen 4 Werten Sie die Antwort nach der principal id des neuen Benutzers aus lt principal type user principal id 2007184341 has children 0 account id 624520 gt lt login gt jazzdoe example com lt login gt lt ext login gt jazzdoe example com lt ext login gt lt name gt jazz doe lt name gt lt principal gt In der Antwort hat ext 1ogin in der Standardeinstellung den gleichen Wert wie login bis sich der Benutzer einmal erfolgreich mit der externen Authentisierung angemeldet hat Weitere Informationen hierzu finden Sie im Abschnitt Mit einer HTTP Header Authentisierung anmelden Benutzer aktualisieren H ufig m ssen Sie die Date
241. on BreezeSessionCookieValue 120 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung acl id principal id session Ganzzahl Ganzzahl Zeichenfolge J N N Die Kennung des SCOs Kontos oder Principals auf den oder das ein Principal zugreifen kann Die ac id ist in anderen Aufrufen eine sco id principal id oder account id Die Kennung eines Benutzers oder einer Gruppe mit bestimmten Berechtigungen auch im Fall von denied oder einer fehlenden Einstellung zum Zugriff auf ein SCO ein Konto oder einen anderen Principal Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt permissions gt lt principal principal id integer is primary boolean type allowedValue has children boolean permission id integer gt lt name gt string lt name gt lt login gt string lt login gt lt principal gt lt permission acl id integer permission id allowedValue principal id integer gt lt permissions gt lt results gt permissions info 121 Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden s
242. on value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die Kennung des Meetings ber das Sie Sitzungsinformationen abfragen m chten session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren 176 Kapitel 6 Aktionsreferenz Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report meeting sessions gt lt row sco id integer asset id integer version integer num participants integer gt lt date created gt datetime lt date created gt lt date end gt datetime lt date end gt lt row gt lt report meeting sessions gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status report meeting Container Die vollst ndige Liste mit den ser21018 Sitzungen des Meetings row Container Informationen zu einer Sitzung sco id Ganzzahl Die eindeutige Kennung des Meetings asset id Ganzzahl Die eindeutige Kennung der Sitzung version
243. onnect Enterprise Lizenz oder Ihr gehostetes Konto gelten In Connect Enterprise werden bestimmte Kontingente berpr ft wie z B die Anzahl der gleichzeitigen Benutzer in Schulungen die Anzahl der Downloads oder der Autoren etc report quotas 213 Dabei gibt die Serverlizenz zwar bestimmte Kontingente vor aber Sie k nnen Ihre Lizenz auch dar ber hinaus erweitern Bei den Antworten die Sie durch den Aufruf von report quotas erhalten stehen soft 1imit f r die durch Ihre Lizenz festgelegte Anzahl und limit f r die tats chliche Anzahl bei der einem Benutzer die Aktion auf dem Server verweigert wird Der Wert von limit ist identisch mit dem von soft 1imit oder er liegt etwas dar ber Anforderungs URL http server_name api xml action report quotas amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report quotas gt lt quota acl id integer quota id string used integer limit allowedValue soft limit integer gt lt date begin gt datetime lt date begin gt lt date end gt datetime lt date end gt lt quota gt lt report quotas gt lt results gt
244. ons update aufruft und f r jeden gefundenen Eintrag ac id principal id und permission id zur ckgibt https example com api xml action permissions update amp acl id 2007064258 amp principal id 2007105030 amp permission id view amp acl id 2007064258 amp principal id 2006258745 amp permission id view a Die acl id ist hierbei die sco id des Kurses m Dabei muss permission id mit dem Wert view verwendet werden m Die principal id ist f r jeden Datensatz mit den drei genannten Feldern eine eindeutige Kennung Wenn es bei den Datens tzen an irgend einer Stelle ung ltige Daten gibt liefert permissions update den Status ok zur ck f hrt die korrekten Datens tze aus und ignoriert die ung ltigen Rufen Sie permissions info auf um zu berpr fen ob alle Benutzer eingeschrieben wurden https example com api xml action permissions info amp acl id 2007064258 filter permission id view Ohne Angabe einer principal id gibt dieser Aufruf eine Liste der Principals zur ck die im Kurs eingeschrieben sind Eine gro e Zahl von Benutzern ab 1 000 aus einem Kurs entfernen 1 Rufen Sie die sco id des betreffenden Kurses ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Kurses oder Studienplans suchen Rufen Sie die principal id jedes Benutzers ab den Sie entfernen m chten Dabei haben Sie folgende M glichkeiten m Rufen Sie principal 1ist mit Filtern auf um genau die Benutzer zu erh
245. ourcen Zu den Adobe Produkten sind weiterhin die folgenden Informationsquellen und Hilfen erh ltlich m Besuchen Sie die Support Homepage der Adobe Website um weitere Informationen zu kostenlosen und kostenpflichtigen Supportleistungen zu erhalten Auf der US und der japanischen Website stehen produktbezogene Topthemen zur Verf gung Uber den Link Schulung gelangen Sie zu angebotenen Adobe Press B chern Online und Videoschulungen sowie Schulungen mit Kursleiter Adobe Zertifizierungsprogramme und vielen weiteren Ressourcen m Im Bereich Community der Adobe Website finden Sie Foren Blogs und andere M glichkeiten zum Austausch von Tools und Informationen mit anderen Benutzern sowie f r Fragen und Informationen zur optimalen Nutzung der Software Auf der Support Homepage der lokalen Adobe Website stehen Anwenderforen in Englisch Franz sisch Spanisch Deutsch und Japanisch zur Verf gung Auch die Blogs werden in mehreren Sprachen gepostet Extras und Downloads Kostenlose Materialien und Add Ons finden Sie bei Adobe Studio Exchange einer Online Community in der die Anwender Tausende kostenloser Aktionen Plug Ins und andere Materialien herunterladen und weitergeben k nnen Den Link zu Adobe Studio Exchange finden Sie im Adobe Design Center auf der Homepage der Adobe Website Die Downloads auf der Adobe Website umfassen kostenlose Updates Beispiele und andere hilfreiche Software Daneben bietet der Plug Ins Bereich de
246. p filter definition value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung curriculum id Ganzzahl J Die Kennung des Studienplans zu dem das Objekt geh rt sco id Ganzzahl J Die Kennung des Studienplanmoduls Kurs Pr sentation oder hnliches Objekt dessen Lernziel Sie anzeigen m chten session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt learning paths gt lt learning path curriculum id integer current sco id integer target sco id integer path type allowedValue gt lt name gt string lt name gt lt learning path gt lt learning paths gt lt results gt 112 Kapitel 6 Aktionsreferenz Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Antwortstatus Wert zul ssige Werte finden Sie im Abschnitt status learning paths Container Enth lt Informationen ber die curriculum id Ganzzahl current sco id Ganzzahl target sco id Ganzzahl path type Zul ssiger Wert
247. p33096345 lt url path gt lt description gt Web 2 0 course lt description gt lt date created gt 2006 06 12T14 48 25 870 07 00 lt date created gt lt date modified gt 2006 06 12T14 48 25 870 07 00 lt date modified gt lt sco gt Alle verf gbaren Kurse oder Studienpl ne auflisten 1 Rufen Sie die sco id des betreffenden Schulungsordners ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Kurses oder Studienplans suchen Sie erhalten die sco id auch indem Sie in Enterprise Manager zu dem gew nschten Ordner wechseln auf dessen URL klicken und die sco id der Browser URL entnehmen Rufen Sie sco contents mit der sco id des gew nschten Ordners auf https example com api xml action sco contents amp sco id 2006258748 Es wird empfohlen die Ordnerstruktur mit den eigenen Schulungen nur eine Ebene tief anzulegen Auf diese Weise k nnen Sie sco contents verwenden und m ssen nicht auf sco expanded contents zur ckgreifen Die Systemleistung wird dadurch erh ht Werten Sie die Antwort nach name ur path oder einem anderen Wert aus den Sie anzeigen m chten lt sco sco id 2007035246 source sco id 2006334909 folder id 2006258748 type content icon course display seq 0 is folder 0 gt lt name gt Java 101 lt name gt lt url path gt javal01 lt url path gt lt date begin gt 2006 07 20T17 15 00 000 07 00 lt date begin gt lt date modified gt 2006 07 20T17 21 38 860 07 00 lt date m
248. pal id 38 Typen 289 Principals l schen 139 principals delete 139 private Meetings Benutzer entfernen 63 erstellen 58 Punktzahlen angeben 84 Punktzahlen f r Quize angeben 84 Punktzahlen f r Quize Berichte 84 R report active meetings 144 report bulk consolidated transactions Definition 147 in Meetinganwendungen 53 report bulk objects 151 report bulk questions 154 report bulk slide views 156 report bulk users 159 report course status 162 report curriculum taker Definition 166 in Schulungsanwendungen 72 report meeting attendance 171 report meeting concurrent users 174 report meeting sessions 176 report meeting summary 178 report my courses 181 report my events 184 report my meetings Definition 187 Java Beispiel 301 in Meetinganwendungen 53 report my training Definition 190 in Schulungsanwendungen 71 Index 311 report quiz interactions Definition 194 in Meetinganwendungen 53 report quiz question answer distribution 198 report quiz question distribution 202 report quiz question response 204 report quiz summary 207 report quiz takers 209 report quotas Definition 213 Meetingteilnehmer berpr fen 65 report sco slides 216 report sco views 218 report user training transcripts Definition 224 in Schulungsanwendungen 72 report user trainings taken Definition 220 in Schulungsanwendungen 72 request URLs example 18 responses Set Cookie 25 35 68 Ressourcen Adobe 7 Connect Enterprise 9 Datum
249. penmitglied ist wird ein leeres principal 1ist Element zur ckgegeben lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt principal list gt lt results gt Die Benutzer einer Gruppe berpr fen 1 2 Rufen Sie principal list mit einem Filter auf um die principal id der Gruppen zu erhalten https example com api xml action principal list amp filter type group amp filter name developers Bei filter type und filter name sollte principal list genau eine Ubereinstimmung zuriickgeben Werten Sie die Antwort nach principal id aus lt principal principal id 2007105030 account id 624520 type group has children true is primary false is hidden false gt lt name gt developers lt name gt lt login gt developers lt login gt lt is member gt false lt is member gt lt principal gt Rufen Sie principal list erneut auf aber geben Sie diesmal die principal id als eine group id sowie den Zusatz filter is member true an https example com api xml action principal list amp group id 2007105030 amp filter is member true 44 Kapitel 3 Grundlagen Werten Sie die Antwort nach den principal Elementen aus lt principal principal id 5698354 account id 624520 type group has children true is primary false is hidden false gt lt name gt Bob Jones lt name gt lt login gt bobjones acme com lt login gt lt is member gt true lt is member gt lt
250. ps user ist ein registrierter Connect Enterprise Benutzer Dagegen weist der Typ guest auf einen Benutzer hin der einen Meetingraum als Gast betreten hat Der Server ruft die Daten dieses Gastes ab und weist ihm eine principal id zu Alle auf dem Server gespeicherten Principals auflisten 1 Rufen Sie principal list ohne Parameter auf https example com api xml action principal list Dieser Aufruf gibt s mtliche Connect Enterprise Benutzer zur ck die Antwort ist also unter Umst nden sehr umfangreich 2 Durchsuchen Sie die principal Elemente der Antwort nach dem gew nschten Wert lt principal has ch principal id 2006282569 account id 624520 type user ildren false is primary false is hidden false gt lt name gt jazz doe lt name gt lt login gt jazzdoe example com lt login gt lt email gt jazzdoe newcompany com lt email gt lt principa gt Alle auf dem Server gespeicherten G ste auflisten 1 Rufen Sie re dem Wert gu port bulk users auf und filtern Sie die Antwort nach dem Feld type mit est https example com api xml action report bulk users amp filter Verwenden S ike type guest ie dabei filter like type guest anstatt filter type guest 2 Analysieren Sie die row Elemente in der Antwort lt row principal id 51157227 gt lt login gt joy acme com lt login gt lt name gt joy acme com lt name gt lt email gt joy acme com lt emai1 gt lt type gt guest lt type
251. quiz question answer distribution report quiz question distribution report quiz question response report quiz definition questions Breeze 5 report quiz interactions report quiz question answer distribution report quiz question distribution report quiz question response report quiz question totals Breeze 5 report quiz question distribution report survey question response Breeze 5 sco build Web Services 6 im Rahmen von sco upload acl field info Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Gibt Informationen zu einem Principal Konto oder SCO zur ck Diese Informationen werden in einer ACL Access Control List definiert Zu den zur ckgegebenen Informationen geh ren auch Felder und ihre Werte Jedes Feld verf gt dabei ber eine Kennung d h einen Namen der das Feld beschreibt F r einen Aufruf von acl field info ben tigen Sie Anzeigeberechtigungen f r den Principal bzw das Konto oder das Objekt Au erdem m ssen Sie f r ac id einen Wert angeben Dieser Wert definiert das Objekt auf das der Principal zugreifen kann Die acl id kann eine sco id eine account id oder eine principal id sein Mit einem Aufruf von principal list k nnen Sie eine account id oder eine principal id festlegen mit sco shortcuts oder sco contents dagegen eine sco id Anforderungs URL http server_name api xml action acl field info amp acl id integer amp session BreezeSessionCookie
252. r Adobe Store Homepage Tausende von Plug Ins anderer Anbieter die Ihnen unter anderem helfen Ihre Aufgaben zu automatisieren die Arbeitsabl ufe anzupassen und besondere professionelle Effekte zu erstellen Entwicklungsumgebung F r Connect Enterprise Web Services k nnen Sie jede Sprache oder Plattform verwenden die das Senden und Empfangen von XML ber HTTP zur Entwicklung benutzerdefinierter Anwendungen unterst tzt So k nnen Sie beispielsweise Java und die J2EE Plattform C NET PHB einen Portalserver oder jede beliebige andere Entwicklungsplattform verwenden Die h ufigsten Anwendungen sind Webanwendungen und Portale Die folgenden Tools sind im Allgemeinen sehr hilfreich m Eine XML Parser Codebibliothek sofern die von Ihnen verwendete Programmiersprache XML Parsing unterst tzt 8 Vorbereitungsma nahmen m Eine Cookie Managementbibliothek die Sie bei der Verwaltung der von Connect Enterprise zur ckgegebenen Sitzungs Cookies unterst tzt m Ein Tool zum Anzeigen von HTTP Anforderungs und Antwort Headern in einem Browser Viele solcher Tools stehen im Internet als Downloads zur Verf gung Neu in diesem Handbuch Im Entwicklerhandbuch finden Sie jetzt schrittweise Beschreibungen und Anleitungen f r bestimmte Aufgaben die Sie mit der XML API durchf hren k nnen Sie k nnen diese Codeabschnitte in Ihre Anwendung bernehmen Die API Referenz enth lt neue Abschnitte mit Anforderungs URLs und deren Parametern Antwo
253. r bei Pr sentations SCOs verwendet Der Vorname der Kontaktperson f r die Pr sentation wird nur bei Pr sentations SCOs verwendet Die Kennung des Ordners in dem das neue SCO gespeichert wird Erforderlich f r ein neues SCO Darf bei vorhandenen SCOs nicht verwendet werden Eine Abk rzung f r die mit dem SCO verbundene Sprache zul ssige Werte finden Sie im Abschnitt 1ang Ohne Angabe wird der Standardwert des Ordners verwendet in dem das SCO erstellt und verwendet wurde Der Nachname der Kontaktperson f r die Pr sentation wird nur bei Pr sentations SCOs verwendet Der Name des SCOs mit oder ohne Leerzeichen Erforderlich zum Erstellen eines SCOs Die eindeutige Kennung des SCOs das aktualisiert werden soll Verwenden Sie entweder sco id oder folder id aber nicht beide Erforderlich zum Aktualisieren eines vorhandenen SCOs Eine Kennzeichnung f r beliebige Informationen die Sie zum Kurs speichern m chten Wird nur bei Kursen verwendet sco update 255 Name Typ Erforderlich Beschreibung source sco id type url path session Ganzzahl Zul ssiger Wert Zeichenfolge Zeichenfolge N N Die eindeutige Kennung einer Vorlage mit der ein Meeting oder eine Materialdatei f r Kurse erstellt werden kann Der Typ des neuen SCOs zul ssige Werte finden Sie im Abschnitt type Der Standardwert lautet content Der benutzerdefinierte Teil der URL zum Meetingrau
254. rationshandbuch In der Standardkonfiguration hat ext 1ogin den gleichen Wert wie login der Anmeldename f r Enterprise Server 30 Kapitel 2 Anmeldung und Anforderungen 5 Sobald Ihr System einen Benutzer authentisiert hat k nnen Sie die Anforderung login erstellen Verwenden Sie dabei an Stelle von login oder password den Parameter external auth use https example com api xml action login amp external auth use 6 F gen Sie dem HTTP Anforderungs Header den authentisierten Anmeldenamen hinzu In der Standardkonfiguration k nnen Sie den Header Namen x user id verwenden x user id joesmith Sie k nnen auch einen anderen Header Namen angeben indem Sie in der Datei custom ini einen Wert f r HTTP_AUTH_HEADER eingeben Sie k nnen den Proxy Server so konfigurieren dass der Wert des HT TP Headers automatisch hinzugef gt wird Weitere Hinweise zu diesen Verfahren finden Sie im Connect Enterprise Installations und Konfigurationshandbuch 7 Analysieren Sie die Antwort und suchen Sie den Statuscode ok 8 Extrahieren Sie den Wert des Cookies BREEZESESSION der im Header der Antwort zur ckgegeben wird Hierzu gibt es zwei M glichkeiten Sie nutzen eine Clientbibliothek die Cookies verwaltet Lassen Sie die Bibliothek den Cookie Wert extrahieren speichern und bei nachfolgenden Anforderungen des betreffenden Benutzers an den Server zur ckgeben Sie verwalten die Cookies selbst Extrahieren Sie den Wert des Cookies BREEZESESS
255. rcen 9 Adobe Developer Center 7 Adobe Ressourcen Downloads 8 Aktionen acl field info 89 acl field list 91 acl field update 93 acl preference update 95 common info 18 97 298 299 custom field update 105 custom fields 101 custom fields delete 104 group membership update 71 110 learning path info 111 learning path update 114 login 116 294 logout 35 118 neue bzw entfernte 87 permissions info 120 permissions reset 124 permissions update 125 principal info 127 principal list 132 principal list by field 135 principal update 40 140 principals delete 139 report active meetings 144 report bulk consolidated transactions 53 147 report bulk objects 151 report bulk questions 154 report bulk slide views 156 report bulk users 159 report course status 162 report curriculum taker 72 166 report meeting attendance 171 report meeting concurrent users 174 report meeting sessions 176 report meeting summary 178 report my courses 181 report my events 184 report my meetings 53 187 301 report my training 71 190 report quiz interactions 53 194 report quiz question answer distribution 198 report quiz question distribution 202 report quiz question response 204 report quiz summary 207 report quiz takers 209 report quotas 65 213 report sco slides 216 report sco views 218 report user training transcripts 72 224 report user trainings taken 72 220 sco contents 228 sco delete 232 sco expanded contents 234 sco info 237 304 307
256. rden k nnen Bei der Beschreibung vieler Aufgaben wird davon ausgegangen dass sie in einem Browser ausgef hrt werden Falls Sie einen Aufruf aus einer Anwendung heraus ausf hren m chten m ssen Sie die XML Anforderung in die Sprache bersetzen mit der Sie arbeiten Ein Beispiel f r diese Aufgabe in Java finden Sie im Abschnitt XML Anforderungen senden 37 Die principal id suchen Principals sind Benutzer oder Gruppen die ber bestimmte Berechtigungen f r die auf dem Server gespeicherten SCOs verf gen Sie k nnen diese Benutzer und Gruppen entsprechend der Anforderungen in Ihrem Unternehmen erstellen und deren Berechtigungen bearbeiten Connect Enterprise enth lt mehrere integrierte Gruppen Administratoren Autoren Schulungsverwalter Veranstaltungsverwalter Meetingveranstalter und Seminarveranstalter Sie k nnen die Benutzer und Gruppen den integrierten Gruppen zuweisen aber Sie k nnen die Berechtigungen einer integrierten Gruppen nicht ndern Jeder Benutzer und jede Gruppe in Connect Enterprise hat eine eigene principal id Bei einigen API Aufrufen wird die principal idals group id oder als user id angegeben um sie von anderen Werten zu unterscheiden Der Wert der ID mit der ein Benutzer bzw eine Gruppe identifiziert wird ist unabh ngig von ihrem Namen immer gleich Die Syntax einer Aktion k nnen Sie in Kapitel 6 Aktionsreferenz berpr fen Die principal id eines Benutzers oder einer Gruppe erhal
257. ren m chten principal id Ganzzahl J Die Kennung eines Principals also eines Benutzers oder einer Gruppe permission id Zeichenfolge J Die Berechtigung die Sie zuweisen m chten zul ssige Werte finden Sie im Abschnitt permission id session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code code gt lt results gt 126 Kapitel 6 Aktionsreferenz Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Attributen Der Status der Antwort code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Beispielanforderung https example com api xml action permissions update amp ac id 2006334033 amp principal id 2006258745 amp permission id host Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Siehe auch permissions info permissions reset principal info Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Liefert Informationen zu einem Principal also entweder zu einem Benutzer oder zu einer Gruppe Sie m
258. report my training amp principal id integer amp filter definition value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung principal id Ganzzahl N session Zeichenfolge N Die eindeutige Kennung eines Benutzers oder einer Gruppe dessen bzw deren Kurse und Studienpl ne Sie auflisten m chten Wenn Sie keinen bestimmten Wert angeben gilt die Antwort f r den aktuellen Benutzer Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report my training gt lt row sco id integer type allowedValue icon allowedValue permission id allowedValue gt lt name gt string lt name gt lt url string lt url gt lt date created gt datetime lt date created gt lt date modified gt datetime lt date modified gt lt date begin gt datetime lt date begin gt lt url path gt string lt url path gt lt expired gt boolean lt expired gt lt completed gt boolean lt comp leted gt lt row gt lt report my training gt lt results gt report my training 191 Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von d
259. rere Teilnehmer hinzuf gen 1 Melden Sie sich als Benutzer mit Administratorrechten f r Ihre Anwendung an 2 F hren Sie die Schritte aus mit denen Sie ein ffentliches Meeting erstellt haben aber stellen Sie nun die Berechtigungen auf private ein https example com api xml action permissions update amp acl id 2007018414 amp principal id public access amp permission id denied 3 Rufen Sie permissions update erneut auf um einen Veranstalter einen Moderator und die Teilnehmer hinzuzufiigen 4 Erstellen Sie die URL zum Meetingraum Hinweise hierzu finden Sie im Abschnitt Meetingraum URLs erstellen Meetings erstellen 59 Benutzerdefinierte Meetings erstellen Bei der Erstellung eines Acrobat Connect Professional Meetings k nnen Sie dem Meeting eine Raumvorlage zuweisen mit der ein bestimmtes Layout des Meetingraums definiert wird Wenn Sie keine Vorlage zuweisen wird der Meetingraum mit der Standardvorlage erstellt Zur Bearbeitung einer Meetingraumvorlage starten Sie Adobe Enterprise Manager und klicken Sie auf die URL der Vorlage Sofern Sie ber Bearbeitungsrechte f r den Ordner mit den Meetingvorlagen verf gen entweder Meine Vorlagen oder Gemeinsame Vorlagen k nnen Sie die Vorlage auch dort ndern Einen Meetingraum mit einer Vorlage erstellen 1 Melden Sie sich als Benutzer mit Administratorrechten f r Ihre Anwendung an 2 Rufen Sie sco shortcuts auf https example com api xml action sco
260. rofessional Meeting session Eine Instanz eines regelm ig stattfindenden Acrobat Connect Professional Meetings tree Der Ausgangspunkt einer Ordnerhierarchie Der Ausgangspunkt einer Ordnerhierarchie wird als unabh ngige Hierarchie verstanden Sie k nnen den bergeordneten Ordner einer Hierarchie aus der Hierarchie selbst heraus nicht bestimmen 288 Kapitel 8 Allgemeine Referenz Die von einigen Aktionen wie report bulk objects zur ckgegebenen Materialobjekte k nnen die type Werte annehmen die in der folgenden Tabelle dargestellt sind Wert Beschreibung archive Eine archivierte Kopie eines live durchgef hrten Acrobat Connect Professional Meetings bzw einer Pr sentation attachment Ein Materialobjekt das als Anlage hochgeladen wurde authorware Ein Multimedia Materialobjekt das mit Macromedia Authorware von Adobe erstellt wurde captivate Eine Demo oder ein Film die bzw der mit Adobe Captivate erstellt wurde course Ein Kurs curriculum external event flv image meeting presentation swf Ein Studienplan einschlie lich seiner Kurse Pr sentationen und anderer Materialien Eine externe Schulung die einem Studienplan hinzugef gt werden kann Eine Adobe Macromedia Flash Videodatei Ein Bild beispielsweise im GIF oder JPEG Format Ein Acrobat Connect Professional Meeting Eine Pr sentation Eine Adobe Macromedia Flash Datei Principaltypen Die f r Principals zul ssigen
261. rride gt boolean lt override gt lt sco gt lt report curriculum taker gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status report curriculum Container Informationen zur Leistung des taker Benutzers im gesamten Studienplan sco Container Informationen zur Leistung des Benutzers in einem Kurs oder Studienplan transcript id Ganzzahl Die Kennung der Lernzielkopie eines Benutzers f r den Kurs oder Studienplan report curriculum taker 167 Element Attribut Typ Beschreibung path type asset id sco id depth folder id type icon lang Zul ssiger Wert Ganzzahl Ganzzahl Ganzzahl Ganzzahl Ganzzahl Zul ssiger Wert Zul ssiger Wert Der Lernpfad dem ein Benutzer folgen muss bevor er an diesem Kurs oder Studienplan teilnehmen kann zul ssige Werte finden Sie im Abschnitt path type Die Version des Kurses oder Studienplans die ein Benutzer abzuschlie en versuchte Die asset id wird dabei jedes Mal erh ht wenn neue Materialien f r den Kurs oder Studienplan hochgeladen werden Die eindeutige Kennung des Kurses oder Studienplans Die Ebene des Kurses in der Navigationshierarchie unterhalb des Studienplans
262. rse und Studienplane eines Benutzers anzeigen 1 Rufen Sie die principal id des betreffenden Benutzers ab entsprechende Hinweise finden Sie im Abschnitt Die principal id suchen Rufen Sie report user trainings taken auf https example com api xml action report user trainings taken amp principal id 2006258745 Durchsuchen Sie die Antwort nach den status Werten lt row transcript id 2006293632 max retries sco id 2564016 type content icon course status completed certificate 2006293632 score 0 permission id attempts 1 gt lt name gt Programming in Perl lt name gt lt description gt Info about Perl lt description gt lt url path gt p57283193 lt url path gt lt date taken gt 2006 05 01T17 10 56 400 07 00 lt date taken gt lt from curriculum gt false lt from curriculum gt lt row gt 76 Kapitel 5 Schulungen Bei Kursen gibt es mehrere zul ssige Werte f r status f r Studienpl ne gelten dagegen nur die Statuswerte completed abgeschlossen oder incomplete nicht abgeschlossen Die zul ssigen Statuswerte sind in der Referenz im Abschnitt status Attribut beschrieben Einen Benutzer einschreiben Um Ihren Benutzern den Zugang zu einer Schulung zu erm glichen wird empfohlen diese Benutzer in Kursen einzuschreiben Auf diese Weise erhalten die Benutzer die ausreichenden Berechtigungen um einen Kurs zu starten und abzuschlie en Au erdem k nnen Sie so ihre Statistiken nachvoll
263. rstellen Beliebige Kommentare zu dem benutzerdefinierten Feld Wird als Hinweistext auf der Benutzeroberfl che angezeigt Es k nnen bis zu 60 Zeichen eingegeben werden Der Typ des Felds Zul ssige Werte sind text textarea und password Erforderlich um ein Feld zu erstellen Gibt an ob das Feld erforderlich ist Geben Sie true ein wenn f r jedes Objekt das dieses Feld benutzt ein Wert in dieses Feld eingegeben werden muss Verwenden Sie ansonsten false Erforderlich um ein Feld zu erstellen Gibt an ob das Feld ber die Benutzeroberfl che gel scht werden kann true wenn es nicht gel scht werden kann und false wenn dies m glich ist Die Position auf der das benutzerdefinierte Feld in Enterprise Manager bzw in Ihrer Anwendung unter den anderen benutzerdefinierten Feldern angezeigt wird Der Name des Felds dessen Wert Sie aktualisieren m chten Erforderlich um ein Feld zu aktualisieren Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt custom field update 107 Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt field field id integer display seq integer object type allowedValue account id integer is primary boolean permission id allowedValue is required boolean field type string gt lt com
264. rt der auch bestimmte Zugriffsrechte erfordert content courses meetings events seminars Hierbei handelt es sich um freigegebene Ordner wie Gemeinsame Meetings Gemeinsame Schulung etc Der Connect Enterprise Administrator hat Zugang zu diesen Ordnern Der Administrator kann jedem beliebigen Benutzer eine Verwaltungsberechtigung erteilen aber nur die Mitglieder der mit diesem Ordner verkn pften integrierten Gruppe k nnen neue Materialien oder Meetings darin erstellen user content user meetings user courses user events Diese Ordner enthalten Unterordner f r alle Benutzer die Materialien erstellen k nnen z B Ordner f r alle Meetingveranstalter oder f r die Schulungsentwickler my courses my events my meetings my meeting templates my content Auch die Benutzer k nnen Materialien in eigenen Ordnern anlegen F r diese Ordner erhalten sie Verwaltungsberechtigung So k nnen Meetingveranstalter in ihren my meetings Ordnern Meetings erstellen und f r diese Meetings Verwaltungsberechtigung erhalten shared meeting templates Dieser Ordner befindet sich im Ordner Gemeinsame Meetings und enth lt Meetingvorlagen Er hat die gleichen Zugriffsberechtigungen wie der bergeordnete Ordner Sie k nnen den Inhalt jedes Ordners auflisten und die Daten zu jedem einzelnen SCO abrufen Wenn Sie nach einem SCO suchen aber die sco id nicht kennen k nnen Sie mithilfe von sco shortcuts und sco expanded contents durch die Ordner navigieren
265. rt bulk objects gt lt row sco id integer type allowedValue gt lt url string lt url gt lt name gt string lt name gt lt date created gt datetime lt date created gt lt date end gt datetime lt date end gt report bulk objects 151 lt date modified gt datetime lt date modified gt lt description gt datetime lt description gt lt row gt lt report bulk objects gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status report bulk objects Container Eine vollst ndige Liste der SCOs auf dem Server Bei Verwendung eines Filters die vollst ndige Liste der SCOs die den Filterkriterien entsprechen row Container Informationen zu einem SCO sco id Ganzzahl Die eindeutige Kennung des SCOs type Zul ssiger Wert Der Typ des SCOs zul ssige Werte finden Sie im Abschnitt type ur Zeichenfolge Die eindeutige Kennung des Schulungs SCOs aus der URL unmittelbar hinter dem Dom nennamen name Zeichenfolge Der Name der dem SCO date created date end Datetime Datum Uhrzeit Datetime Datum Uhrzeit zugeordnet wurde Das Datum der Erstellung des SCOs Bei Meetings das Datum und die Uhrzeit des Meetingbeginns Bei Meetings oder Veranstaltun
266. rt einen Aufruf von sco info aus analysiert die Ergebnisse und speichert die Werte in Variablen damit diese auf der Benutzeroberfl che angezeigt werden k nnen public SCO getSco String scold throws XMLApiException try Element e scolnfo scold if ok equalsIgnoreCase codePath valueOf e return null Element sco Element XPath selectSingleNode e sco 304 Anhang A Ein Anwendungsbeispiel Die URL zum Meetingraum erstellen Sie m ssen aber auch die URL zum Meetingraum erstellen Dies k nnen Sie mithilfe von sco info und sco shortcuts tun https example com api xml action sco info amp sco id 2006258750 https example com api xml action sco shortcuts Extrahieren Sie ur path aus der Antwort von sco info Extrahieren Sie danach den Wert von domain name aus der sco shortcuts R ckgabe und verbinden Sie beide Werte lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt shortcuts gt lt sco tree id 4930295 sco id 2006258748 type my courses gt lt domain name gt http example com lt domain name gt lt sco gt Wenn sich ein Meeting im Ordner my meetings eines Benutzers befindet und der betreffende Benutzer angemeldet ist k nnen Sie diese Aufgabe auch mit einem Aufruf von report my meetings ausf hren https example com api xml action report my meetings In diesem Fall k nnen Sie sowohl domain name als auch ur path unmittelbar aus der Antwort von repor
267. rt my meetings amp filter expired false Aber auch mit der Verwendung von Filtern enth lt die Antwort mit hoher Wahrscheinlichkeit mehrere meeting Elemente die Sie durchsuchen und deren Datenanzeige Sie einschr nken m chten Ein solches meet ing Element sieht beispielsweise so aus lt meeting sco id 2007063179 type meeting icon meeting permission id host active participants 0 gt lt name gt September All Hands Meeting lt name gt lt description gt For all company employees lt description gt lt domain name gt example com lt domain name gt lt url path gt sept15 lt url path gt lt date begin gt 2006 09 15T09 00 00 000 07 00 lt date begin gt lt date end gt 2006 09 15T18 00 00 000 07 00 lt date end gt lt expired gt false lt expired gt 300 Anhang A Ein Anwendungsbeispiel lt duration gt 09 00 00 000 lt duration gt lt meeting gt Meetingliste abrufen Um die Meetingliste in Java abzurufen k nnen Sie eine Methode schreiben wie getMyMeetings mit der die Meetings eines Benutzers aufgelistet und gefiltert werden Falls Sie keinen Filter verwenden m chten k nnen Sie als Filterargument den Wert null bergeben Bei einem Meeting handelt es sich um ein SCO Daher ruft getMyMeetings die Methode getSco auf um die Werte aus der Antwort zu extrahieren und in einer Instanz von SCO java zu speichern public List getMyMeetings String filter throws XMLApiException try Element meetingDoc request repor
268. rtelemente und attribute sowie Antwortbeispiele Eine Beispielanwendung wurde in dieser Version ebenfalls hinzugef gt Bei diesem Beispiel handelt es sich um eine auf allen J2EE kompatiblen Web oder Anwendungsservern lauff hige Java und JSP Anwendung zur Demonstration der Erstellung Anzeige und Aktualisierung von Adobe Acrobat Connect Professional Meetings Dieses mit firstapp bezeichnete Anwendungsbeispiel steht auf der Produkt CD im Ordner mit der Dokumentation und den Beispielen in der Datei firstapp zip zur Verf gung Anweisungen f r die Installation und die Ausf hrung dieser Anwendung finden Sie in der ReadMe Datei Weitere Ressourcen Dar ber hinaus gibt es im Internet etliche hilfreiche Quellen mit Informationen zu Connect Enterprise sowie zu den Webservices und zu XML Connect Enterprise Ressourcen Connect Enterprise Resource Center Das Resource Center auf der Adobe Website wird regelm ig mit neuen Tutorials Simulationen Informationen zum optimalen Vorgehen und Links zu ausgew hlten Verfahren aktualisiert Connect Enterprise Developer Center Eine sinnvolle Ressource f r Entwickler ist das Developer Center Zu den Aktualisierungen geh ren hier Tutorials und Artikel zur Erstellung von Anwendungen f r Connect Enterprise Connect Enterprise Documentation Center Das Documentation Center stellt die gesamte Connect Enterprise Produktdokumentation als Download oder zur Anzeige bereit Weitere Ressourcen 9 Conn
269. rungen hinzuf gen Viele der API Aktionen erm glichen den Einsatz eines Filters um nur bestimmte Antwortelemente zur ckzuerhalten oder die Sortierung der Antwortelemente in einer bestimmten Reihenfolge Ein Filter ist dabei ein spezieller Parameter der mit dem Schl sselwort filter beginnt Dahinter folgt ein optionaler Modifizierer dann ein Feldname und ein Wert Dies sind drei Beispiele m filter name jazz doe zeigt nur die Ergebnisse mit dem Namen jazz doe an m filter like name jazz zeigt alle Ergebnisse an bei denen jazz im Namen vorkommt m filter out type user zeigt alle Ergebnisse an die nicht vom Typ user sind Dies sind nur wenige Filtertypen Im Abschnitt filter definition finden Sie hierzu weitere Informationen Sehen Sie in der Referenz in Kapitel 6 Aktionsreferenz nach ob die R ckgabe einer Aktion gefiltert werden kann Wenn eine Aktion die Nutzung von Filtern zul sst k nnen Sie die Filter im Allgemeinen auf jedes Element oder Attribut anwenden Ein weiterer besonderer Parameter ist die Sortierung Sie wird durch das Schl sselwort sort bzw sort1 oder sort2 eingeleitet darauf folgt ein Feldname und dann eines der Schl sselw rter asc oder desc Zum Beispiel m sort name asc sortiert nach dem Feld name in aufsteigender Reihenfolge m sort group id desc sortiert nach dem Feld group id in absteigender Reihenfolge Das sind nur ein paar Beispiele f r eine Sortierung Sie k nnen die Sortierung selbst
270. rver_name api xml action sco expanded contents amp sco id integer amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung eines Ordners session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt 234 Kapitel 6 Aktionsreferenz Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Ungenaue Filter mit filter like wie beispielsweise filter 1ike name werden f r sco expanded contents nicht empfohlen da sie unter Umst nden die Serverleistung beeintr chtigen Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt expanded scos gt lt sco depth integer sco id integer folder id integer type allowedValue icon allowedValue lang allowedValue source sco id integer display seq integer source sco type integer gt lt name gt string lt name gt lt url path gt string lt url path gt lt date created gt datetime lt date created gt lt date modified gt datetime lt date modified gt lt sco gt lt expanded scos gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des
271. s 217 Beispielanforderung https example com api xml action report sco slides amp sco id 2006334909 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report sco slides gt lt row slide 1 name 1 views 4 gt lt date created gt 2006 05 167T11 14 54 453 07 00 lt date created gt lt row gt lt row slide 2 name 2 views 4 gt lt date created gt 2006 05 167T11 14 59 593 07 00 lt date created gt lt row gt lt row slide 3 name 3 views 3 gt lt date created gt 2006 05 12T11 55 52 330 07 00 lt date created gt lt row gt lt row slide 4 name 4 views 3 gt lt date created gt 2006 05 12T11 55 55 487 07 00 lt date created gt lt row gt lt row slide 5 name 5 views 3 gt lt date created gt 2006 05 12T11 56 00 233 07 00 lt date created gt lt row gt lt report sco slides gt lt results gt Siehe auch report sco views report sco views Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt an wie oft und wann zuletzt ein SCO angezeigt wurde Anforderungs URL http server_name api xml action report sco views amp sco id integer amp session BreezeSessionCookieValue 218 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung des SCOs das Sie berpr fen
272. s BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt my courses gt lt course sco id integer type content icon course permission id allowedValue gt lt name gt string lt name gt lt description gt string lt description gt lt url string lt url gt lt date created gt datetime lt date created gt lt date modified gt datetime lt date modified gt lt date begin gt datetime lt date begin gt lt url path gt string lt url path gt lt expired gt boolean lt expired gt lt completed gt boolean lt comp leted gt lt course gt lt my courses gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status my courses Container Informationen zu allen Kursen in denen der Benutzer eingeschrieben ist 182 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung course Container sco id Ganzzahl type Zul ssiger Wert icon Zul ssiger Wert permission id Zul ssiger W
273. s Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des custom fields field permission id object type field id account id display seq field type Container Container Zul ssiger Wert Zul ssiger Wert Zeichenfolge Ganzzahl Ganzzahl Zul ssiger Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status Die Liste der benutzerdefinierten Felder die mit der Abfrage bereinstimmen Informationen zu einem benutzerdefinierten Feld Die Berechtigung des aktuellen Benutzers f r den Zugriff auf das benutzerdefinierte Feld zul ssige Werte finden Sie im Abschnitt permission id Der Typ des Objekts das mit dem benutzerdefinierten Feld beschrieben wird zul ssige Werte finden Sie im Abschnitt permission id Der Name des Felds gem seiner Definition auf dem Server Die Kennung des Kontos in dem das benutzerdefinierte Feld angelegt wurde Die Position auf der das benutzerdefinierte Feld in Enterprise Manager bzw in Ihrer Anwendung unter den anderen benutzerdefinierten Feldern angezeigt wird Der Datentyp den das benutzerdefinierte Feld annimmt Zul ssige Werte sind text textarea und password 102 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung is primary Boolescher Gibt an ob das benutzerdefinierte Wert Feld gel scht werden kann true wenn es nicht gel scht werden kann und false wenn dies m
274. s Parameter aufrufen kann das System nicht entscheiden f r welchen Benutzer die Anmeldung erfolgen soll und gibt daher den Fehler too much data zur ck subcode Stellt unter Umst nden weitere Informationen zum Status der Antwort bereit So kann beispielsweise mithilfe der Werte von subcode zwischen mehreren M glichkeiten unterschieden werden falls code auf no access gesetzt ist Wert Beschreibung account expired denied no login no quota not available not secure Die G ltigkeitsdauer des Benutzerkontos des Kunden ist abgelaufen Nach den Anmeldeinformationen fehlen Ihnen die erforderlichen Berechtigungen zum Aufruf der Aktion Der Benutzer ist nicht angemeldet Um den Fehler zu beheben melden Sie sich mithilfe der Aktion login an und rufen Sie die Aktion erneut auf Weitere Informationen finden Sie im Abschnitt login Die Obergrenzen f r das Benutzerkonto wurden erreicht oder berschritten Die erforderliche Ressource ist nicht verf gbar Sie m ssen SSL verwenden um diese Aktion aufzurufen 282 Kapitel 8 Allgemeine Referenz Wert Beschreibung pending activation Das Benutzerkonto wurde noch nicht aktiviert pending license Die Lizenzvereinbarung des Benutzerkontos wurde noch nicht aktiviert sco expired Die Gultigkeitsdauer des Kurs oder Protokollmaterials ist abgelaufen sco not started Das Meeting oder der Kurs hat noch nicht begonnen Das Element invalid Ein El
275. s gt lt status code ok gt lt report quotas gt lt quota acl id 624520 quota id download quota used 1 limit unlimited soft 1imit 1000000000 gt lt date begin gt 2004 03 09T09 45 41 047 08 00 lt date begin gt lt date end gt 3000 01 01T00 00 00 000 08 00 lt date end gt report quotas 215 lt quota gt lt quota acl id 624520 quota id bandwidth quota used 12802 limit unlimited soft limit 1000000000 gt lt date begin gt 2006 05 31T17 00 00 943 07 00 lt date begin gt lt date end gt 2006 06 30T17 00 00 943 07 00 lt date end gt lt quota gt lt report quotas gt lt results gt report sco slides Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt Informationen zu den Folien einer Pr sentation zur ck Diese Informationen umfassen Angaben wie oft eine Pr sentationsfolie und wann sie zuletzt angezeigt wurde Anforderungs URL http server_name api xml action report sco slides amp sco id integer amp asset id integer amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung der Pr sentation asset id Ganzzahl N Die Versionsnummer der Pr sentation Dieser Wert wird jedes Mal erh ht wenn die Pr sentation hochgeladen wird session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebun
276. s zur ckgegeben Das Endedatum eines Kurses oder Meetings wird nur bei Kursen und Meetings zur ckgegeben Der Dom nenname unter dem Sie auf ein Meeting oder eine Veranstaltung zugreifen k nnen wird nur bei Kursen und Meetings zur ckgegeben Die Dauer eines Kurses oder Meetings wird nur bei Kursen und Meetings zur ckgegeben Die Kurzbeschreibung des SCOs Beispielanforderung https example com api xml action sco contents amp sco id 2006258748 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt SCOS gt lt sco sco id 2007035246 lt name gt Java 101 lt name gt source sco id 2006334909 folder id 2006258748 type content icon course display seq 0 is folder 0 gt sco contents 231 lt url path gt javal01 lt url path gt lt date begin gt 2006 07 20T17 15 00 000 07 00 lt date begin gt lt date modified gt 2006 07 20T17 21 38 860 07 00 lt date modified gt lt sco gt lt scos gt lt results gt Siehe auch sco expanded contents sco shortcuts sco delete Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung L scht mindestens ein Objekt SCO Wenn die von Ihnen angegebene sco id einen Ordner bezeichnet werden alle Materialien in diesem Ordner gel scht Um mehrere SCOs zu l schen geben Sie mehrere sco i d Parameter an Mithilfe eines Aufrufs wie sco contents k nnen Sie
277. sbane 260 GMT 10 00 Hobart 265 GMT 10 00 Wladiwostok 270 GMT 10 00 Guam Port Moresby 275 GMT 11 00 Magadan Salomonen Neukaledonien 280 GMT 12 00 Fidschi Kamtschatka Marshall Inseln 285 GMT 12 00 Auckland Wellington 290 GMT 13 00 Nuku alofa 300 time zone id 287 type Beschreibung Ein R ckgabeelement oder attribut zur Definition eines SCOs bzw Principals auf dem Server Die zul ssigen Werte von type sind f r SCOs und Principals unterschiedlich SCO Typen Ein SCO kann ein Material ein Adobe Acrobat Connect Professional Meeting eine Veranstaltung ein Kurs ein Studienplan ein Ordner bzw eine Ordnerstruktur oder ein anderes Objekt in Connect Enterprise sein Alle Connect Enterprise Objekte sind SCOs Im Allgemeinen kann ein SCO einen der folgenden Werte von type annehmen Wert Beschreibung content Eine anzeigbare Datei die auf den Server hochgeladen wurde beispielsweise eine FLV oder HTML Datei ein Bild ein Pod etc course Ein Kurs als Bestandteil eines Studienplans curriculum Ein Studienplan event Eine Veranstaltung folder Ein Ordner auf der Festplatte des Servers in dem Materialien gespeichert sind link Ein Verweis auf ein anderes SCO Diese Links werden in Studienpl nen verwendet um auf andere SCOs zu verweisen Wenn einem Studienplan Inhalte hinzugef gt werden wird ein Link erstellt der aus dem Studienplan auf den Inhalt verweist meeting Ein Acrobat Connect P
278. script window open http example com employeeMeeting guestName joy Breeze toolbar no menubar no width 800 height 600 resizable yes return false gt http example com employeeMeeting lt a gt Meetings mit externer Authentisierung starten 69 70 Kapitel 4 Meetings KAPITEL 5 Schulungen Eine benutzerdefinierte Schulungsanwendung oder ein entsprechendes Portal kann auf Adobe Connect Training zugreifen und ggf die verf gbaren Schulungskurse anzeigen den Benutzern die Einschreibung erm glichen s mtliche Kurse und Studienpl ne auflisten in denen der Benutzer eingeschrieben ist und unterschiedliche Berichte bereitstellen Bei Connect Training gibt es zwei Schulungstypen n mlich Kurse und Studienpl ne Ein Kurs besteht aus Materialien z B einer Pr sentation f r eine bestimmte Gruppe von eingeschriebenen Kursteilnehmern F r jeden Kursteilnehmer werden dabei individuelle Statistiken erstellt Der Kurs kann eigenst ndig oder als Teil eines Studienplans verteilt und verwaltet werden Ein Studienplan setzt sich aus Kursen und anderen Materialien zusammen und leitet die Teilnehmer auf einem Lernpfad zu bestimmten Lernzielen Studienpl ne bestehen haupts chlich aus Connect Training Kursen k nnen aber auch andere Elemente wie z B Materialien und Meetings enthalten Genau wie bei Kursen k nnen Sie auch f r Studienpl ne Berichte erstellen um den Lernfortschritt der Teilnehmer zu verfolgen Auf diese W
279. se anmelden muss m Andernfalls erh lt der Benutzer keinen Zugang zu den Enterprise Server Anwendungen bzw zu den Materialien oder Meetings In den folgenden Schritten wird beschrieben wie Sie login aufrufen k nnen wenn Sie die HTTP Header Authentisierung verwenden Mit einer HTTP Header Authentisierung an Enterprise Server anmelden 1 Konfigurieren Sie Ihre Netzwerkserver und Enterprise Server anhand der Anweisungen im Connect Enterprise Installations und Konfigurationshandbuch f r die HTTP Header Authentisierung 2 L schen Sie in der Datei Ihr Serververzeichnis lappserv conf WEB INF web xml die Kommentarzeichen um das Element filter mapping von HeaderAuthenticationFilter und kommentieren Sie alle anderen filter mapping Elemente aus lt filter mapping gt filter name gt HeaderAuthenticationFilter lt filter name gt rl pattern gt lt url pattern gt lt filter mapping gt Mas lt filter mapping gt lt filter name gt NtlmAuthenticationFilter lt filter name gt lt url pattern gt lt url pattern gt lt filter mapping gt SN AN Aus einer Anwendung heraus anmelden 29 3 Aktivieren Sie im filter Element von HeaderAuthenticationFilter das URL Muster api f r die Anforderungs URLs Hierzu gibt es zwei M glichkeiten Ihre Anwendung nutzt die XML API sowie beliebige Connect Enterprise Anwendungen Deaktivieren Sie im filter Element von HeaderAuthenticationFilter mithilfe von Kommentar Tags d
280. se gt san francisco lt response gt lt row gt 200 Kapitel 6 Aktionsreferenz lt row display seq 1 interaction id 2006334913 score 10 asset id 2006334911 num selected 2 gt lt response gt Sacramento lt response gt lt row gt lt row display seq 2 interaction id 2006334914 score 0 asset id 2006334911 num selected 1 gt lt response gt false lt response gt lt row gt lt report quiz question answer distribution gt lt results gt report quiz question answer distribution 201 report quiz question distribution Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt Informationen zur Anzahl der richtigen und falschen Antworten auf eine Quizfrage zur ck Auf diese Weise k nnen Sie feststellen wie eine Gruppe allgemein auf eine bestimmte Quizfrage geantwortet hat Da dieser Aufruf Informationen zu allen Fragen in einem Quiz zur ckgibt wird empfohlen dass Sie die Antwort ggf mit einem Filter auf eine bestimmte Frage oder eine bestimmte Fragengruppe einschr nken Anforderungs URL http server_name api xml action report quiz question distribution amp sco id integer amp filter definition value amp sort definition value amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung sco id Ganzzahl J Die eindeutige Kennung einer Pr sentation die ein Quiz enth lt session Zeichenfolge N Der Wert des BREEZESESSION
281. ser passed user failed oder not attempted F r Studienpl ne und Ordner gelten die Werte completed und incomplete Die Punktzahl die der Benutzer f r die Beantwortung des Kurses oder Studienplans erhalten hat Die Kennung des Zertifikats des Benutzers Die maximale Punktzahl die im Kurs oder Studienplan erreicht werden kann Die Anzahl der Versuche des Benutzers am Kurs oder Studienplan teilzunehmen report curriculum taker 169 Element Attribut Typ Beschreibung access credit granted name url path date modified override Zul ssiger Wert Die Zugriffsrechte die der Benutzer f r den Kurs oder Studienplan hat zul ssige Werte finden Sie im Abschnitt access Boolescher Ein Wert der angibt ob der Wert Kurs oder Studienplan angerechnet wurde Zeichenfolge Der Name des Lernobjekts oder Studienplans Zeichenfolge Der Teil der URL der unmittelbar auf den Dom nennamen folgt und das Objekt auf dem Server eindeutig identifiziert Datetime Das Datum und die Uhrzeit der Datum Uhrzeit letzten nderung dieses SCOs im Format ISO 8601 Boolescher Ein Wert der Angibt ob die Wert Lernzielkopie f r dieses SCO angepasst wurde Beispielanforderung https example com api xml action report curriculum taker amp user id Beispielantw 2006258748 amp sco id 2006298444 ort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt
282. shortcuts 3 Analysieren Sie die Antwort und suchen Sie nach dem Feld sco id des Ordners der die Meetingvorlagen enth lt lt sco tree id 624529 sco id 625529 type shared meeting templates gt lt domain name gt http example com lt domain name gt lt sco gt lt sco tree id 624530 sco id 2006258751 type my meeting templates gt lt domain name gt http example com lt domain name gt lt sco gt 4 Rufen Sie sco contents auf und bergeben Sie dabei die sco id des Vorlagenordners https example com api xml action sco contents amp sco id 2006258751 5 Werten Sie die Antwort nach der sco id der gew nschten Meetingvorlage aus 6 Erstellen Sie das Meeting durch den Aufruf von sco update bergeben Sie die sco id der Meetingvorlage als source sco id https example com api xml action sco updatedtype meeting amp name August 20A11 20Hands 20Meeting amp folder id 2006258750 amp date begin 2006 08 01T09 00 amp date end 2006 08 01T17 00 amp url path august amp source sco id 2006349744 7 Legen Sie danach die Berechtigungen f r das Meeting fest und f gen Sie die Teilnehmer den Veranstalter und den Moderator hinzu weitere Hinweise finden Sie im Abschnitt Meetings erstellen 8 Erstellen Sie die URL zum Meetingraum Hinweise hierzu finden Sie im Abschnitt Meetingraum URLs erstellen 60 Kapitel 4 Meetings Benutzer zu Meetings einladen Nach der Erstellung des Acrobat Connect Meetings und dem Hinzuf gen
283. sich nicht registrierte Benutzer nur als G ste anmelden k nnen Der Veranstalter des Meetings erh lt darauf vom Gast eine Zutrittsanfrage auch als Anklopfen bezeichnet die er genehmigen oder ablehnen kann Ein ffentliches Meeting erstellen und einen Veranstalter einen Moderator und mehrere Teilnehmer hinzuf gen 1 Rufen Sie principal list auf um zu berpr fen ob der Benutzer der das Acrobat Connect Meeting erstellt ein Mitglied der Gruppe 1ive admins ist https example com api xml action principal list amp group id 624523 amp filter is member true amp filter like name bob 2 Rufen Sie sco shortcuts auf um die sco id des Ordners my meetings des Benutzers zu erhalten https example com api xml action sco shortcuts 3 Durchsuchen Sie die Antwort nach dem sco Element mit dem Wert type my meetings lt sco tree id 624530 sco id 2006258750 type my meetings gt lt domain name gt http example com lt domain name gt lt sco gt 4 Call sco update auf um den Meetingraum zu erstellen https example com api xml action sco update amp type meeting amp name October All Hands Meeting amp folder id 2006258750 amp date begin 2006 10 01T09 00 amp date end 2006 10 01T17 00 amp ur path october Hierbei entspricht folder id der sco id des Ordners my meetings des Benutzers 5 Werten Sie die Antwort nach der sco id des neuen Meetings aus lt sco folder id 2006258750 lang en account id 624520 type meeting i
284. siger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status 96 Kapitel 6 Aktionsreferenz Beispielanforderung https server com api xml action acl preference update amp acl id 12345 amp lang fr amp time zone id 0 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt common info Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt die grundlegenden Informationen zum aktuellen Benutzer und zum Server bzw zum Hosted Konto zur ck einschlie lich des Werts des BREEZESESSION Cookies Wenn Sie common info aufrufen ohne sich angemeldet zu haben enth lt die Antwort keine user und account Elemente da der Server den Benutzer nicht erkennen kann Allerdings gibt common info auch ohne Anmeldung immer das BREEZESESS10N Cookie zur ck Anforderungs URL http server_name api xml action common info amp domain string amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung domain Zeichenfolge N Ein Domanenname zur Identifizierung eines Hosted Kontos Enth lt Informationen zu Ihrem Hosted Konto session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden common info 97 Antworts
285. ssen hierzu eine principal id angeben Rufen Sie principal list auf um die principal id zu suchen Verwenden Sie dabei ggf einen Filter um die Antwort einzuschr nken Anforderungs URL http server_name api xml action principal info amp principal id integer amp session BreezeSessionCookieValue principal info 127 Parameter Name Typ Erforderlich Beschreibung principal id Ganzzahl J Die Kennung des Benutzers oder der Gruppe ber den oder die Sie Informationen erhalten m chten Sie erhalten die Kennung durch den Aufruf von principal list session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt contact gt lt email gt string lt email gt lt first name gt string lt first name gt lt last name gt string lt last name gt lt contact gt lt manager account id integer disabled boolean has children boolean is hidden boolean is primary boolean principal id integer type allowedValue gt lt ext login gt string lt ext login gt lt login gt string lt login gt lt name gt string lt name gt lt email gt string lt email gt lt first name gt string lt first name gt lt last name gt string lt last name gt lt x customfiel
286. st local host ur version account account id user user id Zeichenfolge Datetime Datum Uhrzeit Zeichenfolge Zeichenfolge Zeichenfolge Zeichenfolge Leer mit Attribut Ganzzahl Container Ganzzahl Der Wert des Cookies BREEZESESSION eine Zeichenfolge die der Server zur ckgibt und den Benutzer und seine Anmeldesitzung identifiziert Das Tagesdatum und die Uhrzeit des Aufrufs von common info im Format ISO 8601 Die URL des vollst ndig qualifizierten Hostnamens des Servers Bei einem Cluster der Name des Clusters Der Name des Computers auf dem die Aktion ausgef hrt wurde bei einem einzelnen Server der gleiche Computername wie host bei einem Cluster der Name des Servers auf dem die Aktion ausgef hrt wurde Der Teil der diesen Aufruf ausf hrenden URL mit der der Aktionsname gekennzeichnet wird Der Versionsname und die Versionsnummer des Servers Informationen zum Konto zu dem der Benutzer geh rt Wird zur ckgegeben wenn Sie an Connect Enterprise angemeldet sind oder auf einem gehosteten Konto einen Aufruf ausf hren Die Kennung des Kontos zu dem der Benutzer geh rt Informationen zum Benutzer der die Sitzung am Server gestartet hat Wird nur dann zur ckgegeben wenn der Benutzer der den Aufruf ausgef hrt hat angemeldet ist Die Kennung des Benutzers der die Sitzung am Server gestartet hat common info 99 Element Attribut Typ Beschr
287. stalters gespeichert in der API hei en diese Ordner my meetings Weitere Hinweise zur Ordnerstruktur finden Sie im Abschnitt Charakteristiken von SCOs Die sco id eines Meetings suchen 1 Rufen Sie sco shortcuts auf https example com api xml action sco shortcuts 2 Analysieren Sie die Antwort und suchen Sie nach dem Feld sco id des Meetingordners der wahrscheinlich das Meeting enth lt lt sco tree id 624530 sco id 624530 type user meetings gt lt domain name gt http example com lt domain name gt lt sco gt Der Ordnername sollte meetings user meetings oder my meetings lauten Suchen Sie einen Ordner der in der Ordnerstruktur m glichst weit unten steht 3 Rufen Sie f r diesen Ordner sco contents aufund f gen Sie einen oder zwei Filter hinzu um das Ergebnis einzuschr nken https example com api xml action sco contents amp sco id 2006258750 amp filter type meeting amp filter name Intro to Film m Je genauer Sie die Filter einstellen k nnen desto besser Sinnvolle Filter sind beispielsweise filter name filter url path oder ein Datumsfilter Setzen Sie dabei allerdings fil ter 1ike name mit Vorsicht ein da sich ein solcher Aufruf negativ auf die Serverleistung auswirken kann a Sie k nnen auch sco expanded contents aufrufen wenn Sie die Unterordner und deren Inhalte anzeigen m chten Allerdings wirkt sich sco contents g nstiger auf die Serverleistung aus sofern Sie die sco id des Ordners kennen i
288. staltung ein Seminar oder ein Materialobjekt handeln principal id Ganzzahl Die Kennung des Benutzers status Zul ssiger Wert Der Status des Versuchs eines Benutzers mit diesem SCO zu arbeiten zul ssige Werte finden Sie im Abschnitt status Attribut score Ganzzahl Die Punktzahl die der Benutzer f r die Bearbeitung des SCOs erhalten hat Falls es f r das SCO keine Punktzahl gibt wie z B bei einem Meeting hat score den Wert 0 max score Ganzzahl Die maximale Punktzahl die im Kurs oder Studienplan erreicht werden kann certificate Ganzzahl Die Kennung des Datensatzes der anzeigt ob der Benutzer den Kurs oder Studienplan bestanden oder nicht bestanden hat type Zul ssiger Wert Der Typ des SCOs Zul ssige Werte sind user content content und my content 226 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung icon Zul ssiger Wert Der Name des Symbols mit dem der Kurs oder Studienplan in Connect Enterprise Manager bezeichnet wird name Zeichenfolge Der Name des Kurses oder Studienplans url path Zeichenfolge Die eindeutige Kennung des Kurses oder Studienplans aus der URL unmittelbar hinter dem Dom nennamen login Zeichenfolge Der Anmeldename des Benutzers in Enterprise Server oder Enterprise Hosted date taken Datetime Das Datum der Interaktion eines Datum Benutzers mit dem Kurs oder Uhrzeit Studienplan Anzeige einer principal name sco tag Zeichenfolge Zeichenfolge Pr
289. t Siehe auch report bulk objects report bulk consolidated transactions report bulk slide views report bulk users report bulk slide views Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Gibt die Informationen zu jedem Mal zur ck bei dem ein Principal eine Folie angezeigt hat Die Folie kann in einer beliebigen Pr sentation im Konto des aktuellen Benutzers enthalten sein Jede Anzeige einer Folie ist eine Transaktion Bei einer Transaktion handelt es sich um eine Interaktion zwischen einem Benutzer und einem beliebigen SCO auf Connect Enterprise In diesem Fall l uft die Transaktion zwischen einem Benutzer und einer Folie ab Diese Aktion gibt s mtliche Freignisse an bei denen Principals beliebige Folien im Konto angezeigt haben es sei denn Sie filtern die Antwort Anforderungs URL http server_name api xml action report bulk slide views amp filter definition value amp sort definition value amp session BreezeSessionCookieValue 156 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt
290. t lt row gt lt report quiz question response gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status report quiz question response 205 Element Attribut Typ Beschreibung report quiz question Container Informationen zu s mtlichen Vesponse Antworten auf alle Fragen in einem Quiz row Container Informationen zu einer Antwort principal id Ganzzahl Die Kennung des Benutzers der die Quizfrage beantwortet hat interaction id Ganzzahl Die Kennung einer Antwort auf eine Frage user name Zeichenfolge Der Name des Benutzers gem seiner Registrierung auf dem Server response Zeichenfolge Die Antwort des Benutzers auf die Frage einschlie lich eines Begriffs oder Ausdrucks true false oder eines Buchstabens f r die Auswahl einer Antwort date created Datetime Das Datum und die Uhrzeit der Datum Antwort durch den Benutzer Uhrzeit Beispielanforderung https example com api xml action report quiz question response amp sco id 2006334909 amp filter interaction id 2006334913 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report quiz question response gt lt row principal id 2006258
291. t novel lt url path gt lt date begin gt 2006 05 11T11 30 00 000 07 00 lt date begin gt lt date end gt 2006 05 11T12 30 00 000 07 00 lt date end gt lt expired gt true lt expired gt lt duration gt 01 00 00 000 lt duration gt lt meeting gt lt meeting sco id 2006743452 type meeting icon meeting permission id host active participants 0 gt lt name gt Intro to Film lt name gt lt domain name gt example com lt domain name gt lt url path gt film lt url path gt lt date begin gt 2006 06 09T14 00 00 000 07 00 lt date begin gt lt date end gt 2006 06 09T20 00 00 000 07 00 lt date end gt lt expired gt true lt expired gt lt duration gt 06 00 00 000 lt duration gt lt meeting gt lt my meetings gt lt results gt report my training Verf gbarkeit Connect Enterprise Web Services 6 Beschreibung Gibt eine Liste s mtlicher Kurse und Studienpl ne zur ck in die ein Benutzer oder eine Gruppe eingeschrieben ist Wenn Sie keine principal id angeben bezieht sich die Liste auf den aktuellen Benutzer Mithilfe einer principal id k nnen Sie die Listen eines bestimmten Principals abrufen Die Antwort enth lt eine Liste von row Elementen In der Liste haben die Kurse die Attribute type content und icon course w hrend die Studienpl ne mit type curriculum und icon curriculum gekennzeichnet werden 190 Kapitel 6 Aktionsreferenz Anforderungs URL http server_name api xml action
292. t Enterprise in der Antwort auf alle Aktionen der Web Services XML API zur ckgegeben wird Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt results gt oder lt xml version 1 0 encoding utf 8 gt lt results gt lt status code al owedValue gt lt invalid field string type allowedValue subcode allowedValue gt status 281 lt status gt lt results gt Attribute code Der Status der Antwort Wert Beschreibung invalid Gibt an dass ein Aufruf in irgendeiner Hinsicht ung ltig ist Das Element invalid gibt Aufschluss ber weitere Einzelheiten no access Gibt an dass Sie zum Aufruf der Aktion nicht berechtigt sind Das Attribut subcode gibt Aufschluss ber weitere Einzelheiten no data Gibt an dass keine Daten verf gbar sind nach dem Aufruf einer Aktion die normalerweise Daten zur ckgibt Bedeutet in der Regel dass es kein Element mit der von Ihnen angegebenen Kennung gibt Um den Fehler zu beheben ersetzen Sie die angegebene Kennung durch die Kennung eines vorhandenen Elements ok Gibt an dass die Aktion erfolgreich abgeschlossen wurde too much data Gibt an dass die Aktion nur ein Ergebnis h tte zur ckgeben sollen tats chlich aber mehrere Ergebnisse zur ckgibt Wenn es z B mehrere Benutzer mit demselben Benutzernamen und Kennwort gibt und Sie die Aktion login mit diesem Benutzernamen und Kennwort al
293. t acl acl id 381223 gt lt value gt John lt value gt lt acl gt lt acl acl id 381302 gt lt value gt Daryl lt value gt lt acl gt lt acl acl id 381405 gt lt value gt Mary lt value gt lt acl gt lt acl field list gt lt results gt Siehe auch acl field info acl field update acl field update Verf gbarkeit Breeze 5 Connect Enterprise Web Services 6 Beschreibung Aktualisiert den Wert eines Felds das einem Principal einem SCO oder einem Konto zugeordnet ist acl field update 93 Der Principal das SCO oder das Konto geh ren zu mindestens einer Access Control List ACL in der die Elemente aufgef hrt sind die eine Berechtigung zum Zugriff auf den Principal das SCO oder das Konto haben Rufen Sie ac field info auf um das Feld zu bestimmen das dem Principal dem SCO oder dem Konto geh rt In der Antwort erhalten Sie die field id mit der Sie die Anforderung von ac field update ausf hren k nnen lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt acl fields gt lt field acl id 2006258745 field id email gt lt value gt joy acme com lt value gt lt field gt lt acl fields gt lt results gt Wenn Sie acl field update aufrufen m chten ben tigen Sie die Berechtigung modi fy f r den betreffenden Principal das SCO oder das Konto Anforderungs URL http server_name api xml action acl field update amp acl id
294. t eine Referenz f r die Aktionen die in der Adobe Connect Enterprise Web Services XML API zur Verf gung stehen Sie k nnen diese Aktionen entweder auf einem Adobe Connect Enterprise Server 6 oder auf einem Adobe Connect Enterprise Hosted 6 Konto aufrufen Bei allen Namen von Aktionen Parametern Elementen und Attributen wird zwischen Gro und Kleinschreibung unterschieden Das bedeutet dass name etwas anderes ist als Name und sco id nicht mit sco ID bereinstimmt Sie m ssen sie also genau so eingeben wie sie in dieser Referenz angegeben sind Bei einigen Aktionen weist allerdings ein besonderer Eintrag darauf hin dass bei diesen nicht zwischen Gro und Kleinschreibung unterschieden wird Neue und entferne Aktionen In dieser Version wurden einige neue Aktionen hinzugef gt einige andere entfernt und eine in einer fr heren Version entfernte Aktion wieder eingef gt Neue Berichtsaktionen erm glichen Ihnen die Erstellung von Berichten auf dem Server report curriculum taker report my training report user trainings taken report user training transcripts Eine Aktion f r benutzerdefinierte Felder die in Adobe Breeze 5 entfernt worden war wurde nun in Web Services 6 wieder eingef hrt custom fields 87 Einige API Aufrufe die in vorangegangenen Versionen Connect Enterprise 4 oder Connect Enterprise 5 noch zur Verf gung standen sind nun nicht mehr enthalten Diese Aufrufe sind in der folgenden Tabelle zus
295. t filtern bzw sortieren Sie sollten filter type nicht zusammen mit report bulk users verwenden Statt dessen k nnen Sie filter like type nutzen Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt report bulk users gt lt row principal id integer gt lt login gt string lt login gt lt name gt string lt name gt lt email gt string lt email gt lt manager gt string lt manager gt lt type gt allowedValue lt type gt any custom fields lt row gt lt report bulk users gt lt results gt 160 Kapitel 6 Aktionsreferenz Antwortwerte Element Attribut Typ Beschreibung results status code report bulk users row principal id login name emai manager type Container Leer mit Attributen Zul ssiger Wert Container Container Ganzzahl Zeichenfolge Zeichenfolge Zeichenfolge Zeichenfolge Zul ssiger Wert Antwortelement auf der obersten Ebene Der Status der Antwort Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Die vollst ndige Liste aller Benutzer im Konto Informationen zu einem Benutzer im Konto Die Kennung des Benutzers Der Anmeldename des Benutzers h ufig eine E Mail Adresse Der vollst ndige Name des Benutzers zusammengesetzt aus dessen Vornamen und dem Nachnamen Die E Mail Adresse des Benu
296. t my meetings filter List list XPath selectNodes meetingDoc meeting Iterator meetings list iterator List result new ArrayList while meetings hasNext Element m Element meetings next SCO meeting getSco m result add meeting return result catch JDOMException jde throw new XMLApiException PARSE_ERROR jde Das SC0 Objekt beinhaltet dabei die Daten zum SCO so dass Sie dieses v llig problemlos von einer Webseite also beispielsweise einer HTML oder einer JSP Seite in Ihre Anwendung bernehmen k nnen Meetings erstellen und aktualisieren Die entsprechenden Beispieldateien sind XMLApiAdapter java und SCO java SISMNIH Unter Umst nden m ssen Ihre Benutzer mit der Anwendung aber auch Meetings erstellen k nnen Rufen Sie hierzu sco update mit der folder id des Meetingordners und dem Zusatz type meeting auf https example com api xml action sco update amp folder id 2006258750 amp description For all company employees Meetings erstellen und aktualisieren 301 amp name Company All Hands Meeting amp type meeting amp lang en amp date begin 2006 06 161T23 00 amp date end 2006 06 16T23 30 Die Antwort gibt die sco id des Meetings zur ck Diese k nnen Sie extrahieren und speichern lt sco account id 624520 disabled display seq 0 folder id 2006258750 icon meeting lang en max retries sco id 2006743452 source sco id 1625529 type m
297. t my meetings entnehmen Die Java Methode scoUr1 setzt die URL durch einen Aufruf von sco info f r den Wert von url path und sco shortcuts f r domain name zusammen In diesem Fall werden zwei Aufrufe verwendet da nicht unbedingt davon ausgegangen werden kann dass sich das gew nschte Meeting im Ordner my meetings des angemeldeten Benutzers befindet public String scoUrl String scold throws XMLApiException try Element e request sco info sco id scold fC codePath valueOf e equalsIgnoreCase ok return XPath xpath XPath newInstance url path text String path Text xpath selectSingleNode e getText e request sco shortcuts null xpath XPath newInstance domain name text String url Text xpath selectSingleNode e getText return url path substring 1 session breezesession catch JDOMException jde throw new XMLApiException PARSE_ERROR jde Einzelinformationen zu Meetings anzeigen 305 306 Anhang A Ein Anwendungsbeispiel Index A Abstimmungsergebnisse 67 Abstimmungsergebnisse aus Meetings 67 access Attribut 275 Access Control List ACL 50 acl field info 89 acl field list 91 acl field update 93 acl preference update 95 actions common info 38 principal update 40 41 Adapter Klasse erstellen 292 Instanz erstellen 293 Konstruktoren 292 Adobe Connect Enterprise Web Services 13 Adobe Connect Enterprise Ressou
298. tatus Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status permissions Container Eine Liste der Principals mit ihren Berechtigungen f r den Zugriff auf das SCO das Konto oder den Principal permission Leer mit Informationen zur Berechtigung die Attributen ein Principal f r ein SCO ein Konto oder einen anderen Principal hat Falls der Wert leer ist wurde keine Berechtigung eingestellt principal Container Informationen zum Principal mit dessen Berechtigungsebene f r ein SCO ein Konto oder einen anderen Principal principal id Ganzzahl Die Kennung des Principals der Berechtigungen f r ein SCO ein Konto oder einen anderen Principal hat is primary Boolescher Ein Wert der angibt ob der Principal Wert eine primare Gruppe ist gleichbedeutend mit einer integrierten Gruppe type Zul ssiger Wert Der Typ des Principals zul ssige has children Boolescher Wert Werte finden Sie im Abschnitt type Ein Wert der angibt ob der Principal untergeordnete Objekte hat Im Gegensatz zu Benutzern k nnen Gruppen untergeordnete Objekte haben Lautet dieser Wert also true so handelt es sich bei dem Principal um eine Gruppe 122 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung permission id Zul ssiger Wert Die Berechtigung die ein Principal f r ein SCO ein Konto oder einen anderen Principal hat zul
299. te Datetime Das Datum und die Uhrzeit der Datum Uhrzeit letzten Anzeige des SCOs Beispielanforderung https server com api xml action report sco views amp sco id 2006334909 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report sco views sco id 2006334909 type content is folder 0 views 3 gt lt name gt Quiz on California lt name gt lt last viewed date gt 2006 05 12T11 55 24 940 07 00 lt last viewed date gt lt report sco views gt lt results gt report user trainings taken Verf gbarkeit Connect Enterprise Web Services 6 Beschreibung Gibt eine Liste s mtlicher Kurse und Studienpl ne zur ck an denen ein Benutzer teilgenommen hat und zwar unabh ngig davon ob er diese abgeschlossen hat oder nicht Dabei wird jeder Kurs oder Studienplan in einem eigenen row Element zur ckgegeben und enth lt die aktuelle Lernzielkopie mit den Punktzahlen des Benutzers Anforderungs URL http server_name api xml action report user trainings taken amp principal id integer amp session BreezeSessionCookieValue 220 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung principal id Ganzzahl J Die Kennung des Benutzers dessen Schulungsliste Sie abrufen m chten session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter
300. te created Datetime Das Datum und die Uhrzeit der Datum Uhrzeit Erstellung des SCOs bei Materialien des Hochladens date end Datetime Falls das SCO ein Meeting ist das Datum Uhrzeit Datum und die Uhrzeit des Meetingendes date modified Datetime Das Datum und die Uhrzeit der letzten Datum Uhrzeit nderung des SCOs description name url path passing score duration Zeichenfolge Zeichenfolge Zeichenfolge Ganzzahl Ganzzahl Die Beschreibung des SCOs zum Zeitpunkt seiner Erstellung Der Name des SCOs Der Pfad zum angegebenen SCO auf dem Server Die Mindestpunktezahl die ein Benutzer erreichen muss um einen Schulungskurs zu bestehen Die Zeit in Millisekunden die bendtigt wird um das SCO anzuzeigen bzw abzuspielen 240 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung section count Ganzzahl Die Anzahl der Abschnitte im Kursmaterial einschlie lich der Anzahl der Folien Seiten Kapitel Interaktionen und anderer Unterteilungen des Materials source sco Container Informationen zu allen SCOs die f r das abgefragte SCO als Vorlage dienen oder f r dieses Material bereitstellen Zu den SCOs die eine Materialquelle haben k nnen geh ren Meetings Kurse und Veranstaltungen source sco Container Einzelheiten zudem SCO das f r das abgefragte SCO als Vorlage dient oder f r dieses Material bereitstellt Enth lt die gleichen zus tzlichen Elemente und Attribut
301. teger peak users integer num invitees integer num invitees attended integer ispublic boolean num guests attended integer gt lt results gt Zur ckgegebene XML Elemente Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen report meeting summary 179 Element Attribut Typ Beschreibung code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status report meeting summary Leer mit Informationen zum Meeting Attributen bzw zur Meetingserie num unique meetings Ganzzahl Die Anzahl der Sitzungen eines regelm ig stattfindenden Meetings peak users Ganzzahl Die h chste Anzahl von Teilnehmern im Meetingraum zu einem bestimmten Zeitpunkt und w hrend einer beliebigen Meetingsitzung num invitees Ganzzahl Die Anzahl der eingeladenen Benutzer num invitees Ganzzahl Die Anzahl der eingeladenen attended Benutzer die teilgenommen haben ispublic Boolescher Gibt an ob das Meeting Wert ffentlich ist und G ste ohne Weiteres eintreten k nnen bei 1 oder true oder ob es sich um ein privates Meeting handelt und G ste auf eine Genehmigung warten m ssen bei 0 oder false num guests attended Ganzzahl Die Anzahl der Teilnehmer die den Meetingraum als G ste und nicht als registrierte Teilnehmer betreten haben Beispielanforderung https e
302. ten 1 Rufen Sie principal list mit einem Filter auf https example com api xml action principal list amp filter name jazz doe Genaue bereinstimmungen erreichen Sie am besten mit filter name filter login oder filter email Setzen Sie fi ter 1ike name mit Vorsicht ein da sich ein solcher Aufruf negativ auf die Serverleistung auswirken kann 2 Durchsuchen Sie die principal Elemente der Antwort nach der principal id lt principal principal id 2006282569 account id 624520 type user has children false is primary false is hidden false gt lt name gt jazz doe lt name gt lt login gt jazzdoe example com lt login gt lt email gt jazzdoe newcompany com lt email gt lt principal gt Die principal id des aktuellen Benutzers erhalten 1 Melden Sie einen Benutzer an und rufen Sie dann common info auf https example com api xml action common info 2 Werten Sie die Benutzerelemente der Antwort nach user id aus lt user user id 2007124930 type user gt lt name gt jazz doe lt name gt lt login gt jazz doe com lt login gt lt user gt 38 Kapitel 3 Grundlagen In diesem Beispiel wird die principal idals user id bezeichnet da sie immer einen Benutzer bezeichnet der in Connect Enterprise authentisiert ist Eine Gruppe kann sich nicht am Server anmelden In anderen Aktionen k nnen Sie den Wert von user idals principal i d bergeben Principals oder G ste auflisten Ein Principal des Ty
303. tents oder sco expanded contents zur ckgegebener url path Das Ergebnis ist diese URL http test server com f2006123456 Dar ber hinaus k nnen sie auch sco contents mit der sco id eines Ordners aufrufen die von sco shortcuts zur ckgegeben wurde um den Inhalt des Ordners anzuzeigen Anforderungs URL http server_name api xml action sco shortcuts amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden 250 Kapitel 6 Aktionsreferenz Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code code gt lt shortcuts gt lt sco tree id integer sco id integer type allowedValue gt lt domain name gt string lt domain name gt lt sco gt lt shortcuts gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status shortcuts Container Informationen zu s mtlichen Ordnern die f r den aktuellen Benutzer von Belang sind sco Container Informationen zu einem Ordner des aktuellen Ben
304. thaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt SCOS gt lt sco sco id integer source sco id integer folder id integer type allowedValue icon allowedValue display seq integer is folder boolean byte count integer ref count integer gt lt name gt string lt name gt lt url path gt string lt url path gt lt description gt string lt description gt lt date begin gt string lt date begin gt lt date modified gt datetime lt date modified gt lt date end gt string lt date end gt lt sco tag gt string lt sco tag gt lt sco gt lt scos gt lt results gt sco contents 229 Antwortwerte Element Attribut Typ Beschreibung results status code SCOS Sco sco id source sco id folder id type icon display seq is folder Container Leer mit Attributen Zul ssiger Wert Container Container Ganzzahl Ganzzahl Ganzzahl Zul ssiger Wert Zul ssiger Wert Ganzzahl Boolescher Wert Alle Ergebnisse die von der Aktion zur ckgegeben werden Der Status der Antwort Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Die Liste der Objekte die im Ordner gespeichert sind Ein Objekt das im Ordner gespeichert ist Die eindeutige Kennung eines Objekts im Ordner Die eindeutige Kennung ei
305. tion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Wert Antwortstatus zul ssige Werte finden Sie im Abschnitt status report meeting Container Die vollst ndige Liste mit den attendance Teilnehmern des Meetings row Container Informationen zu einem Meetingteilnehmer transcript id Ganzzahl Die Kennung der Meetingkopie sco id Ganzzahl Die eindeutige Kennung des Meetings principal id Ganzzahl Die Kennung des Principals der am Meeting teilgenommen hat 172 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung answered survey Boolescher Gibt an ob der Wert Meetingteilnehmer eine Umfrage zum Meeting beantwortet hat login Zeichenfolge Der Anmeldename des session name sco name date created date end participant name Zeichenfolge Zeichenfolge Datetime Datum Uhrzeit Datetime Datum Uhrzeit Zeichenfolge Meetingteilnehmers Der Name des Benutzers der den Meetingraum betreten und eine Sitzung erstellt hat Der Name des Meetings Das Erstellungsdatum des Meetings Das Datum des Meetingendes Der Name des Meetingteilnehmers laut der Registrierung auf dem Server Beispielanforderung https example com api xml action report meeting attendance amp sco id 2006778715 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report me
306. tionen zu einem Benutzer der das Quiz beantwortet hat transcript id Ganzzahl Die Kennung der Kopie auf der die Punktzahl des Benutzers aus dem Quiz gespeichert ist sco id Ganzzahl Die eindeutige Kennung der Pr sentation des Meetings oder des Kurses in der bzw dem das Quiz enthalten ist principal id Ganzzahl Die Kennung des Benutzers der das Quiz beantwortet hat report quiz takers 211 Element Attribut Typ Beschreibung status Zul ssiger Wert Gibt an ob der Benutzer den letzten Versuch zur Beantwortung des Quiz bestanden hat oder nicht Zul ssige Werte sind hier user passed und user failed score Ganzzahl Die Punktzahl des Benutzers bei seinem letzten Versuch zur Beantwortung des Quiz asset id Ganzzahl Die Kennung der Quizversion die der Benutzer versucht hat zu beantworten permission id Zul ssiger Wert Die Berechtigung die der Benutzer f r das Quiz hat zul ssige Werte finden Sie im Abschnitt permission id attempts Ganzzahl Die Angabe wie oft der Benutzer das Quiz bisher beantwortet hat time taken Ganzzahl Die Angabe wie lange der Benutzer f r die Beantwortung des Quiz gebraucht hat in Millisekunden certificate Ganzzahl Die eindeutige Kennung der Lernzielkopie des Benutzers answered Boolescher Die Angabe ob der Benutzer eine Survey Wert Meetingumfrage oder ein Quiz beantwortet hat version Ganzzahl Die Revisionsnummer des Quiz name Zeichenfolge Der Name des Quiz login Zeichenfolge Der Anm
307. tlerische Arbeiten oder Bilder die Sie in Ihren Projekten verwenden m chten unter Umst nden ebenfalls urheberrechtlich gesch tzt sind Die nicht genehmigte Verwendung solchen Materials in Ihren Arbeiten stellt m glicherweise eine Verletzung der Urheberrechte der betreffenden Rechtsinhaber dar Sie sollten daher sicherstellen dass Sie im Vorfeld zu solchen Arbeiten s mtliche erforderlichen Rechte von den betreffenden Rechtsinhabern anfordern S mtliche Hinweise auf Firmennamen in den Beispielen und Vorlagen dienen ausschlie lich darstellenden Zwecken und beziehen sich nicht notwendigerweise auf tats chlich existierende Unternehmen Adobe das Adobe Logo Acrobat Adobe Captivate Adobe Connect Adobe Press Breeze Flash Flash Player PDF und Shockwave sind eingetragene Marken oder Marken von Adobe Systems Incorporated in den USA und oder in anderen L ndern Java ist eine Marke oder eingetragene Marke von Sun Microsystems Inc in den USA und in anderen L ndern Alle andere Marken sind Eigentum ihrer jeweiligen Rechtsinhaber RealDuplex Acoustic Echo Cancellation tr gt das Copyright 1995 2004 SPIRIT Adobe Systems Incorporated 345 Park Avenue San Jose California 95110 USA Hinweis f r Endbenutzer in Beh rden der US Regierung Bei dieser Software und der Dokumentation handelt es sich um als Commercial Items bezeichnete Wirtschaftsg ter im Sinn von 48 C ER 2 101 Diese bestehen aus so genannter Commercial Computer S
308. truktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt common locale allowedValue time zone id integer gt lt cookie gt string lt cookie gt lt date gt datetime lt date gt lt host gt url lt host gt lt local host gt hostname lt local host gt lt url gt api xml action common info lt ur1 gt lt version gt string lt version gt lt account account id integer gt lt user user id integer type user gt lt name gt string lt name gt lt login gt string lt login gt lt user gt lt user agent gt string lt user agent gt lt common gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status common Container Allgemeine Informationen zu Ihrer Serververbindung locale Zul ssiger Wert Eine Einstellung mit der definiert wird wie Adobe Connect Enterprise Manager bzw Ihre Anwendung einem Benutzer Informationen anzeigt zul ssige Werte finden Sie im Abschnitt lang time zone id Zul ssiger Wert Ein Code zur Definition der Zeitzone des Benutzers zul ssige Werte finden Sie im Abschnitt time zone id 98 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung cookie date ho
309. tt type Ganzzahl Die Kennung des Principals f r den das benutzerdefinierte Feld angelegt wurde icon Beschreibung Das Symbol mit dem ein SCO in Enterprise Manager identifiziert wird Werte Wert Beschreibung archive Ein Archiv eines Adobe Acrobat Connect Professional Meetings attachment Ein Materialobjekt das als Anlage hochgeladen wurde authorware Ein Multimedia Materialobjekt das mit Macromedia Authorware von Adobe erstellt wurde captivate Eine Demo oder ein Film die bzw der mit Adobe Captivate erstellt wurde course Ein Schulungskurs curriculum external event flv htm image Ims plugin logos meeting template mp3 pdf Ein Studienplan Eine externe Schulung die einem Studienplan hinzugef gt werden kann Eine Adobe Macromedia Flash Videodatei Eine HTML Datei Ein Bild Ein Materialobjekt aus einem externen LMS Learning Management System Ein benutzerdefiniertes Logo das in einem Meetingraum bzw in Enterprise Manager verwendet wird Ein benutzerdefiniertes Layout eines Meetings Eine MP3 Datei Eine Datei im Adobe Portable Document Format icon 277 Wert Beschreibung pod presentation producer seminar session swf Ein sichtbares Feld mit bestimmten Funktionen in einem Meetingraumlayout Eine Pr sentation die mit einer fr heren Version von Adobe Breeze erstellt wurde Eine Pr sentation die mit Adobe Prese
310. ttp server_name api xml action learning path update amp curriculum id integer amp current sco id integer amp target sco id integer amp path type allowedValue amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung curriculum id Ganzzahl J Die Kennung des Studienplans zu dem das Lernobjekt geh rt current sco id Ganzzahl N Die Kennung des Lernobjekts dessen Zugang Sie aktualisieren m chten target sco id Ganzzahl N Die Kennung des Lernobjekts das den Zugang zum aktuellen Lernobjekt verwehrt beispielsweise ein Kurs das als Voraussetzung f r ein anderes Lernobjekt definiert wurde 114 Kapitel 6 Aktionsreferenz Name Typ Erforderlich Beschreibung path type Zul ssiger J Der Typ des Lernziels zwischen dem Wert Ziel und dem aktuellen Lernobjekt zul ssige Werte finden Sie im Abschnitt path type session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Antwortelement auf der obersten Ebene status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Antwortstatus Wert zul ssige Wert
311. tzer zu erstellen Dieses Feld sollten Sie nicht bei Gruppen verwenden principal update 141 Name Typ Erforderlic Beschreibung h login Zeichenfolge J N Der neue Anmeldename normalerweise die E Mail Adresse des Principals Muss auf dem Server eindeutig sein Erforderlich um einen Benutzer zu erstellen oder zu aktualisieren Dieses Feld sollten Sie nicht bei Gruppen verwenden name Zeichenfolge J N Der Name der neuen Gruppe Wird nur beim Erstellen einer neuen Gruppe verwendet Erforderlich um die Gruppe zu erstellen password Zeichenfolge N Das Kennwort des neuen Benutzers Wird nur beim Erstellen eines neuen Benutzers verwendet principal id Zeichenfolge J N Die Kennung des Principals dessen Informationen Sie aktualisieren m chten Wird zum Aktualisieren eines Benutzers oder einer Gruppe verwendet nicht aber beim Erstellen eines Principals send email Boolescher N Eine Kennzeichnung mit der angezeigt Wert wird ob der Server dem Principal eine E Mail mit dessen Konto und Anmeldedaten senden soll type Zeichenfolge J N Der Typ des Principals Wird nur beim Erstellen eines neuen Principals verwendet zul ssige Werte finden Sie im Abschnitt type session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden 142 Kapitel 6 Aktionsreferenz Antwortstru
312. tzers Der Vorgesetzte des Benutzers ebenfalls ein registrierter Benutzer Wird nur dann zur ckgegeben wenn f r den Benutzer ein Vorgesetzter Manager definiert wurde Wenn in der Anforderung custom fields auf true gesetzt wurde wird der Vorgesetzte nicht angezeigt Der Typ des Benutzers entweder user oder guest Beispielanforderung https example com api xml action report bulk users amp filter like name john report bulk users 161 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report bulk users gt lt row principal id 5417288 gt lt login gt john example com lt login gt lt name gt John Owens lt name gt lt emai l gt john example com lt email gt lt type gt guest lt type gt lt row gt lt row principal id 5417255 gt lt login gt jsmith example com lt login gt lt name gt John Smith lt name gt lt email gt jsmith example com lt email gt lt type gt guest lt type gt lt row gt lt report bulk users gt lt results gt Siehe auch report bulk objects report bulk questions report bulk slide views report bulk consolidated transactions report course status Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt entsprechend der angegebenen Parameter den Kursstatus f r einen Principal oder einen Kurs zur ck Dieser Aufruf gibt die Daten aus Sicht einer Person od
313. ue Send gt lt INPUT type reset gt lt FORM gt Rufen Sie nach dem Hochladen sco info auf um den Status des SCOs zu erhalten Der SCO Status lautet anfangs in progress das Material wird also erstellt Wenn dieser Status zu active wechselt ist die Erstellung des Materials abgeschlossen und die Benutzer erhalten Zugriff auf das Material Anforderungs URL http server_name api xml action sco upload amp file formElementName amp sco id integer amp summary string amp title string amp session BreezeSessionCookieValue Beschreibung Parameter Name Typ Erforderlich file Name des J Formular elements sco id Ganzzahl J summary Zeichenfolge N Die hochzuladende Datei die in einem HTML Formular ber ein input Element mit dem Zusatz name file gesendet wird Das HTML Formular muss hierzu dem Zertifikatstyp multipart form data entsprechen Dies wird im form Element festgelegt Die von sco update zur ckgegebene Kennung des SCOs das hochgeladen werden soll Eine Kurzbeschreibung des SCOs die in Enterprise Manager oder Ihrer Anwendung angezeigt wird sco upload 259 Name Typ Erforderlich Beschreibung title Zeichenfolge N Der Titel des SCOs session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1
314. uktur wird auch dann empfohlen wenn Sie eine Liste aller Kurse und Studienpl ne bzw alle Objekte eines Themenbereichs anzeigen und den Benutzern die M glichkeit einr umen m chten sich selbst einzuschreiben Wenn Sie in Enterprise Manager arbeiten erhalten Sie die sco id eines Kurses oder Studienplans wenn Sie zu dem betreffenden Objekt wechseln auf dessen URL klicken und dann den Wert von sco id der Browser URL entnehmen Mithilfe der XML API k nnen Sie die sco id aber auch in einer Anwendung ermitteln Die sco id eines Kurses oder Studienplans suchen 1 Rufen Sie sco shortcuts auf https example com api xml action sco shortcuts 2 Werten Sie die Antwort nach der sco id des courses Ordners aus lt sco tree id 624528 sco id 624528 type courses gt lt domain name gt http example com lt domain name gt lt sco gt Bei sco shortcuts k nnen Sie keine Filter verwenden aber vielmehr die Ergebnisliste von sco id auf type courses einschr nken 3 Rufen Sie sco contents auf und bergeben Sie die sco id von courses Filtern Sie die Ergebnisse nach Ihren Schulungsordnern https example com api xml action sco contents amp sco id 624528 amp filter name Sales Training m Sie k nnen hierzu filter name filter url path einen anderen Filter f r genaue bereinstimmungen oder einen Datumsfilter verwenden Setzen Sie dabei allerdings filter like name mit Vorsicht ein da sich ein solcher Aufruf negativ auf die Serverleistung
315. und Kennungen Sie wissen m chten Es kann immer nur ein Feldname angegeben werden session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt acl field list gt lt acl acl id integer gt lt value gt string lt value gt lt acl gt lt acl field list gt lt results Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status 92 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung acl field list Container Informationen zu allen Werten des angegebenen Felds im gesamten Konto acl Container Informationen zu einem Wert des angegebenen Felds acl id Ganzzahl Die Kennung des Principals SCOs oder Kontos zu dem das Feld geh rt value Zeichenfolge Der Wert des Felds Beispielanforderung https example com api xml action acl field list amp field id first name Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt acl field list gt l
316. ung 116 Connect Enterprise Web Services 13 Connect Enterprise Ressourcen 9 Cookie Management 23 24 custom field update 105 custom fields 101 custom fields delete 104 D Dateien herunterladen 49 hochladen 258 Dateien hochladen 258 Datenfluss benutzerdefinierte Anwendungen 16 Connect Enterprise Anwendungen 17 Diagramm 14 verschl sselt oder unverschl sselt 14 Datum Uhrzeit Formate 10 denied Berechtigung 73 E E Mail an neue Benutzer senden 40 Einen Benutzer einschreiben 77 Einladungen 61 Entwicklungsressourcen 7 Entwicklungsumgebung 8 erstellen Benutzer 40 benutzerdefinierte Felder benutzerdefinierte Meetings 60 Gruppen 43 Meetingraum URL 56 Meetings 57 neue Benutzer 40 neue Benutzer ohne Angabe der E Mail Adresse 40 ffentliche Meetings 58 private Meetings 59 externe Authentisierung Authentisierungsfilter 28 Meetings starten 68 F Fehlermeldungen analysieren 34 297 Feldelement 276 Felder benutzerdefiniert Siehe benutzerdefinierte Felder Filter Aufrufbeispiel 20 Authentisierung 28 Beispiele 20 Definition 20 Syntax 269 firstapp Beispiel 9 291 Flash Media Server 17 G G ste auflisten 39 gemeinsame Ordner 47 Gemeinsame Schulung Ordner 72 gleichzeitige Meetingteilnehmer 65 group membership update Definition 110 in Schulungsanwendungen 71 Index 309 Gruppen aus Kursen und Studienpl nen entfernen 81 Benutzer hinzuf gen 43 erstellen 43 in Kurse oder Studienpl ne einschreiben
317. ung der Pr sentation oder des Kurses die bzw der das Quiz enth lt score Ganzzahl Die Punktzahl des Benutzers f r diese Frage name Zeichenfolge Der Name des Benutzers sco name Ganzzahl Der Name der Pr sentation oder des Kurses die bzw der das Quiz enth lt date created Datetime Das Datum der Pr sentations Datum oder Kurserstellung Uhrzeit description Zeichenfolge Die Quizfrage die der Benutzer beantwortet hat response Zeichenfolge Die Antwort die der Benutzer gegeben hat Beispielanforderung https example com api xml action report quiz interactions amp sco id 2006334909 amp filter name Joy Smith amp filter like description governor Beispielanforderung lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report quiz interactions gt lt row display seq 2 transcript id 2006335803 interaction id 2006334914 sco id 2006334909 score 10 gt lt name gt Joy Smith lt name gt lt sco name gt California Quiz lt sco name gt lt date created gt 2006 05 11T15 50 23 643 07 00 lt date created gt lt description gt The governor of California is a former actor lt description gt lt response gt true lt response gt lt row gt lt row display seq 2 transcript id 2006335827 interaction id 2006334914 sco id 2006334909 score 0 gt lt name gt Joy Smith lt name gt lt sco name gt California Quiz lt sco name gt lt date created gt 2006 05 1
318. uts auf https example com api xml action sco shortcuts 2 Durchsuchen Sie die Antwort nach dem domain name Wert jedes sco Elements lt sco tree id 624530 sco id 2006258750 type my meetings gt lt domain name gt http example com lt domain name gt lt sco gt 3 Rufen Sie sco info mit der sco id auf https example com api xml action sco info amp sco id 2006334909 4 Werten Sie die Antwort nach url path aus lt sco account id 624520 disabled display seq 0 folder id 2006258747 icon producer lang en max retries sco id 2006334909 source sco id type content version 1 gt lt date created gt 2006 05 11T12 00 02 000 07 00 lt date created gt lt date modified gt 2006 05 16115 22 25 703 07 00 lt date modified gt lt name gt Test Quiz lt name gt lt url path gt quiz lt url path gt lt passing score gt l0 lt passing score gt lt duration gt 15100 0 lt duration gt lt section count gt 6 lt section count gt lt sco gt Der Wert von url path ist in Schr gstriche eingeschlossen Sie k nnen url path von report my meetings report my training oder jedem anderen Aufruf erhalten der diese Information zuriickgibt 5 Setzen Sie url path und domain name zusammen http example com f2006258748 Dateien herunterladen Sie k nnen ZIP Dateien von Connect Enterprise auf den Computer eines Benutzers herunterladen Auch eine ZIP Datei ist ein SCO Wenn Sie sie herunterladen m chten m
319. utzer anmelden rufen Sie common info mit dem Dom nennamen des gehosteten Kontos auf Hierzu k nnen Sie entweder die Anforderungs URL oder den Parameter domain verwenden http acme adobe com api xml action common info http adobe com api xml action common info amp domain acme adobe com 2 Werten Sie die Antwort nach den Werten der Felder cookie und account id aus lt cookie gt Sbreezzd2dfr2ua5gscogv lt cookie gt lt account account id 295153 gt 3 Speichern Sie den Anmeldenamen und das Kennwort des Benutzers in Ihrer Anwendung zwischen 4 Rufen Sie die Aktion login auf und geben Sie die Daten des Benutzers sowie die Parameter account id und session an https example com api xml action 1ogin amp login joy acme com amp password happy amp account id 295153 amp session Sbreezzd2dfr2ua5gscogv 5 Analysieren Sie die Antwort und suchen Sie den Statuscode ok 6 Optional Wenn Sie m gen k nnen Sie login auch vor common info aufrufen den Cookie Wert aus der Antwort extrahieren und den Wert dann entweder selbst verwalten oder dies einer Cookie Managementbibliothek berlassen Weitere Informationen finden Sie in den Abschnitten Mit Cookie Management anmelden bzw Mit dem Sitzungsparameter anmelden 26 Kapitel 2 Anmeldung und Anforderungen Mit einem Dom nennamen an Enterprise Hosted anmelden 1 Bevor Sie den Benutzer anmelden rufen Sie common info mit dem Dom nennamen des gehosteten Ko
320. utzers tree id Ganzzahl Die Kennung der Navigationsstruktur die den Ordner enth lt Unter Umst nden weisen mehrere Ordner die gleiche tree id auf sco id Ganzzahl Die eindeutige Kennung des Ordners type Zul ssiger Wert Der Typ des Ordners Zul ssige Werte k nnen der folgenden Tabelle entnommen werden domain name Zeichenfolge Der Dom nenname des Ordners sco shortcuts 251 Die Werte die im Attribut type des Elements sco zur ckgegeben werden k nnen nur bei diesem Aufruf also sco shortcuts kennzeichnen Connect Enterprise Ordner Jeder Ordnertyp wird einem Ordner in Adobe Connect Enterprise Manager zugeordnet und erfordert bestimmte Zugriffsberechtigungen Diese k nnen der folgenden Tabelle entnommen werden Wert des Typs Beschreibung account custom content courses events meetings my courses my content my events my meetings my meeting templates seminars shared meeting templates user content user courses user events user meetings Benutzerdefiniertes Material eines Kontos wie eine eigene Anmeldeseite oder eigene Banner etc Ordner Gemeinsame Materialien Erfordert Administratorrechte oder Verwaltungsberechtigung Ordner Gemeinsame Schulung Erfordert Administratorrechte oder Verwaltungsberechtigung Ordner Gemeinsame Veranstaltungen Erfordert Administratorrechte oder Verwaltungsberechtigung Ordner Gemeinsame Meetings Erfordert Administratorrechte o
321. weiteren Benutzer f r die Meetings zul sst Normalerweise ist dieser Wert identisch mit soft limit Rufen Sie report meeting concurrent users auf um die maximale Anzahl der gleichzeitigen Meetingteilnehmer auf Ihrem Server oder in Ihrem Hosted Konto zu berpr fen https example com api xml action report meeting concurrent users Die Meetingnutzung berechnen 65 4 Werten Sie die Antwort nach dem report meeting concurrent users Element aus Analysieren Sie den Wert des Attributs max users und vergleichen Sie ihn mit dem Wert von soft limit lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report meeting concurrent users max users 18 max participants freq 3 gt lt results gt Meetingarchive abrufen F r ein Acrobat Connect Professional Meeting k nnen ein oder mehrere Archive angelegt werden Wenn ein Meeting beispielsweise w chentlich stattfindet gibt es f r jede Sitzung ein Archiv Ein Meetingarchiv wird mithilfe von type content und icon archive identifiziert Der Wert von icon stellt dabei eine Unterkategorie von type dar und identifiziert den Typ des Materials Archive eines Meetingraums auflisten 1 Rufen Sie die sco id des betreffenden Meetings ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Meetings suchen Rufen Sie sco expanded contents mit dieser sco id und dem Zusatz filter icon archive auf um alle mit de
322. werten k nnen Wenn ein Benutzer also beispielsweise eine Aktion aufruft f r die er keine ausreichende Berechtigung hat so enth lt die Antwort ein status Element mit code und subcode Attributen lt xml version 1 0 encoding utf 8 gt lt results gt lt status code no access subcode denied gt lt results gt Die folgenden Zeilen der Methode createXPaths analysieren die Werte von code und subcode codePath XPath newInstance status code subcodePath XPath newInstance status subcode XML Antworten analysieren 297 In diesem Beispiel wird createXPaths aufgerufen um eine Instanz von XMLApiAdapter zu erstellen Die Methode getStatus gibt dann mithilfe von codePath und subcodePath die durch einen Bindestrich getrennten Werte von code und subcode zur ck private String getStatus Element el throws JDOMException String code codePath valueOf el String subcode subcodePath valueOf el StringBuffer status new StringBuffer if null code amp amp code length gt 0 status append code if null subcode amp amp subcode length gt 0 status append subcode return status toString Benutzerdaten anzeigen Die entsprechenden Beispieldateien sind XMLApiAdapter java Userlnfo java und header jsp SISMNIH In Ihrer Benutzeroberfl che m chten Sie w hrend einer Anmeldesitzung eines Benutzers ggf dessen Daten anzeigen also beispielsweise sei
323. wort entgegenehmen Au erdem muss die Methode den Wert des BREEZESESSION Cookies aus dem Antwort Header auslesen und diesen Wert speichern Benutzer anmelden 293 Die einfachste Form der 1ogin Aktion ist folgende https example com api xml action login amp login joy example com amp password jazz Unter Umst nden m ssen Sie der 1ogin Aktion die Parameter session account id oder domain hinzuf gen detaillierte Hinweise zum Aufrufen von login finden Sie im Abschnitt Aus einer Anwendung heraus anmelden Bei einer erfolgreichen Anmeldung wird die folgende Antwort zusammen mit dem Statuscode ok zur ckgegeben lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Aufbau der grundlegenden Anforderungs URL Die Anmeldemethode sollte zun chst die grundlegende Anforderungs URL erstellen die an den Server gesendet wird Im Beispiel erzeugt die Methode breezeUr1 eine URL wie diese http example com api xml action Dar ber hinaus f gt die Methode einen Aktionsnamen und eine Abfragezeichenfolge hinzu die ihr bergeben wird Die ganze Methode sieht so aus protected URL breezeUrl String action String queryString throws MalformedURLException return new URL getBaseUrl api xml action action queryString null amp queryString Die Anmeldedaten des Benutzers senden Die Methode login ruft die Aktion login auf stellt eine Verbin
324. xample com api xml action report meeting summary amp sco id 2006334033 180 Kapitel 6 Aktionsreferenz Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report meeting summary num unique meetings 1 peak users 1 num invitees 1 num invitees attended 1 ispublic 1 num guests attended 0 gt lt most recent session gt 2006 06 28T15 11 15 133 07 00 lt most recent session gt lt report meeting summary gt lt results gt report my courses Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt Informationen zu jedem Kurs bereit in dem der aktuelle Benutzer eingeschrieben ist oder war Die zur ckgegebenen Daten umfassen alle zuk nftigen vergangenen und aktuellen Kurse in denen der Benutzer eingeschrieben ist oder war Da die Liste dieser Kurse unter Umst nden sehr lang ist wird empfohlen die Antwort mit einem Filter einzuschr nken F r jeden Kurs gibt es eine permission id mit der die Zugriffsberechtigung angezeigt wird die der Benutzer f r diesen Kurs hat Bei dieser Berechtigung kann es sich um view publish oder manage handeln Anforderungs URL http server_name api xml action report my courses amp filter definition value amp sort definition value amp session BreezeSessionCookieValue report my courses 181 Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert de
325. ype group oder einem anderen Filterwert filtern wie filter type admins Die integrierten Gruppen haben von group verschiedene Typen zul ssige Werte finden Sie im Abschnitt type Anforderungs URL http server_name api xml action group membership update amp group id integer amp principal id integer amp is member boolean amp session BreezeSessionCookieValue Parameter Name Typ Erforderlich Beschreibung group id Ganzzahl J Die Kennung der Gruppe in der Sie neue Mitglieder hinzuf gen oder vorhandene Mitglieder ndern m chten principal id Ganzzahl J Die Kennung des Principals dessen Mitgliedschaft Sie aktualisieren m chten Wird von principal info zur ckgegeben is member Boolescher J Gibt an ob der Principal der Gruppe Wert hinzugef gt true oder aus ihr entfernt werden soll false session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden 110 Kapitel 6 Aktionsreferenz Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Antwortelement auf der obersten Ebene status Leer mit Der Status der Antwort Attributen code Zulassiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Si
326. zer abgemeldet ist darf dieser Cookie Wert nicht mehr verwendet werden Anforderungs URL http server_name api xml action logout amp session BreezeSessionCookieValue 118 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zuruckgegeben werden status Leer mit Attributen Der Status der Antwort code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Beispielanforderung http example com api xml action logout Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Siehe auch login logout 119 permissions info Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Gibt die Liste der Principals Benutzer und Gruppen zur ck die die Berechtigung haben Aktionen auf ein SCO einen Principal oder ein Konto auszuf hren F r den Aufruf von permissions info m ssen Sie eine a
327. ziehen und verschiedene Reportaktionen aufrufen Kurse unterscheiden sich von Materialien Kurse k nnen unterbrochen und erneut aufgenommen werden und erm glichen eine serverseitige berpr fung weitere Informationen hierzu finden Sie im Adobe Connect Enterprise Benutzerhandbuch Ihr Anwendung erm glicht den Benutzern unter Umst nden das selbstst ndige Einschreiben in Kursen Hierzu ist der Aufruf von permissions update erforderlich mit dieser Aktion kann immer genau ein Benutzer eingeschrieben werden Sie k nnen ggf einen Ablauf bzw eine Abfolge von Aufrufen schreiben mit denen neue Benutzer erstellt und in einem Kurs eingeschrieben werden k nnen Einen Benutzer in einem Kurs oder Studienplan einschreiben 1 Rufen Sie die sco id des betreffenden Kurses ab entsprechende Hinweise finden Sie im Abschnitt Die sco id eines Kurses oder Studienplans suchen 2 Rufen Sie die principal id des betreffenden Benutzers ab entsprechende Hinweise finden Sie im Abschnitt Die principal id des aktuellen Benutzers erhalten 3 Rufen Sie permissions update auf um den Benutzer im betreffenden Kurs einzuschreiben Setzen Sie die sco id als acl id ein und verwenden Sie die permission id mit dem Wert view https example com api xml action permissions update amp acl id 2007035246 amp principal id 2006258745 amp permission id view 4 Rufen Sie report my training auf um s mtliche Kurse und Studienpl ne aufzulisten in denen ein B
328. zielkopie berschrieben werden soll session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Ein Code zur Angabe des Antwortstatus Wert zul ssige Werte finden Sie im Abschnitt status Beispielanforderung https example com api xml action user transcript update amp curriculum id 2006298444 amp sco id 2006298445 amp status user passed amp principal id 2006258745 amp score 100 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Siehe auch learning path info learning path update user transcript update 265 user update pwd Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung ndert das Kennwort eines Benutzers Dabei muss einmal das aktuelle Kennwort und zweimal das neue Kennwort angegeben werden Ein Administrator kann die Richtlinien f r zul ssige Kennw rter auf dem Server festlegen Zu diesen Richtlinien geh rt m g
329. zulisten Anforderungs URL http server_name api xml action report my events amp filter definition value amp sort definition value amp session BreezeSessionCookieValue 184 Kapitel 6 Aktionsreferenz Parameter Name Typ Erforderlich Beschreibung session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Sie k nnen die Antwort nach jedem enthaltenen Element oder Attribut filtern bzw sortieren Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code allowedValue gt lt my events gt lt event sco id integer type event icon event permission id allowedValue gt lt name gt string lt name gt lt domain name gt string lt domain name gt lt url path gt string lt url path gt lt date begin gt datetime lt date begin gt lt date end gt datetime lt date end gt lt expired gt boolean lt expired gt lt duration gt datetime duration gt lt event gt lt my events gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden status Leer mit Der Status der Antwort Attributen code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status my events Container Die vollst ndige Liste der Veranstaltungen f r die
330. zuzuf gen https example com api xml action permissions update amp acl id 2006258765 amp principal id 2006258745 amp permission id view W hlen Sie hierbei f r den Teilnehmer eine permission id mit dem Wert view f r einen Moderator mit dem Wert mini host und f r einen Veranstalter mit dem Wert host 5 Melden Sie sich als Administrator ab und danach als der Benutzer an den Sie gerade dem Meeting zugewiesen haben 6 Zeigen Sie die aktuellen Meetings des Benutzers an https example com api xml action report my meetings amp filter expired false Meetingraum URLs erstellen F r das Zusammensetzen der URL eines Meetingraums gibt es mehrere M glichkeiten Welche Aktion Sie optimalerweise aufrufen h ngt davon ab wie Ihre Anwendung angemeldet ist und an welcher Stelle im Ablauf der Anwendung Sie sich gerade befinden In der Standardeinstellung wird der Meetingraum im Ordner my meetings des Veranstalters erstellt Die URL eines Meetingsraums erstellen in dem der Benutzer der Veranstalter ist 1 Falls Sie als Benutzer angemeldet sind werden Sie wahrscheinlich eine Meetingraum URL im Ordner my meetings erstellen Rufen Sie hierzu report my meetings auf https example com api xml action report my meetings 2 Analysieren Sie die Antwort und extrahieren Sie die Werte von domain name und ur path lt meeting sco id 2007063179 type meeting icon meeting permission id host active participants 0 gt lt name gt
331. zzahl Die Angabe wie oft das Quiz bisher von unterschiedlichen Principals beantwortet wurde Wenn ein Principal das Quiz mehrmals beantwortet hat wird nur ein Mal gez hlt maxpossiblescore Ganzzahl Die maximale Punktzahl die bei dem Quiz erreicht werden kann asset id Ganzzahl Die Kennung der letzten Version des SCOs das auf den Server hochgeladen wurde 208 Kapitel 6 Aktionsreferenz Beispielanforderung https server com api xml action report quiz summary amp sco id 2006123456 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt report quiz summary gt lt row num questions 2 average score 0 low score 0 high score 0 umtaken 1 numdistincttaken 1 maxpossiblescore 0 asset id 2006334911 gt lt row num questions 2 average score 13 low score 0 high score 20 umtaken 3 numdistincttaken 3 maxpossiblescore 20 asset id 2006334911 gt lt report quiz summary gt lt results gt report quiz takers Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Stellt Informationen zu den Benutzern bereit die das Quiz beantwortet haben oder zu den Objekten SCOs die ein Principal verwendet hat Mit dieser Aktion k nnen Sie zwei unterschiedliche Dinge abfragen Wenn Sie Informationen zu allen Benutzern erhalten m chten die das Quiz beantwortet haben geben Sie eine sco id an mit der das Quiz
332. zzahl J Die Kennung des SCOs dessen Berechtigungen Sie zur cksetzen m chten session Zeichenfolge N Der Wert des BREEZESESSION Cookies Verwenden Sie diesen Parameter wenn Ihre Umgebung keine Cookies unterst tzt Filter Die Ergebnisse k nnen weder gefiltert noch sortiert werden Antwortstruktur lt xml version 1 0 encoding utf 8 gt lt results gt lt status code code gt lt results gt Antwortwerte Element Attribut Typ Beschreibung results Container Alle Ergebnisse die von der Aktion zur ckgegeben werden 124 Kapitel 6 Aktionsreferenz Element Attribut Typ Beschreibung status Leer mit Attributen Der Status der Antwort code Zul ssiger Wert Ein Code zur Angabe des Antwortstatus zul ssige Werte finden Sie im Abschnitt status Beispielanforderung https example com api xml action permissions reset amp ac id 2006334033 Beispielantwort lt xml version 1 0 encoding utf 8 gt lt results gt lt status code ok gt lt results gt Siehe auch permissions info permissions update permissions update Verf gbarkeit Breeze 4 und 5 Connect Enterprise Web Services 6 Beschreibung Aktualisiert die Berechtigungen die ein Principal f r den Zugriff auf ein SCO hat Die Definition erfolgt mithilfe der Felder principal id acl id und permission id Wenn Sie die Berechtigungen mehrerer Principals oder Objekte aktualisieren m chten k nnen Sie mehrere Dat

Using Connect Enterprise Web Services

Contents

Download Pdf Manuals

Related Search

Related Contents