Unterstützende Systeme
Microsoft Teams
In Avendoo® ist es möglich, MS Teams als virtuellen Standort zu erstellen. Folgende Einstellungen müssen Sie dafür im Azure und in Avendoo® vornehmen:
- Azure: Technischer Account
Sie benötigen einen Account für die Organisation der Teams-Einladungen. Der Zugriff erfolgt mit den Applikationsberechtigungen. Sie benötigen keine Zugangsdaten für den Account.
Der technische User benötigt ein Postfach (Kalender) und darf nicht auf einem lokalen Server liegen. - Azure: Enterprise Application
Sie müssen im Azure eine neue Costum Application registrieren und der vorher erstellte Benutzer muss auf diese Application berechtigt sein. - Azure: App Registrations
Manifest:
Ändern Sie den Wert “allowPublicClient” auf “true”. Optional können Sie Herunterladen wählen, um das Manifest lokal zu bearbeiten, und dann Hochladen verwenden, um es wieder auf Ihre Anwendung anzuwenden.
API Permissions:
Sie müssen folgendes Recht vergeben:- Microsoft Graph calenders.ReadWrite
Erteilen Sie die Administratoreinwilligung für diese Berechtigung.
- Microsoft Graph calenders.ReadWrite
- Avendoo®: MS Teams als virtueller Standort
Sofern eine Veranstaltung über MS Teams gehalten wird, kann der Autor im Veranstaltungs-Assistenten über Virtueller Standort MS Teams auswählen. Der Zugangslink zur Besprechung erscheint für den Benutzer am Veranstaltungstermin.
Dafür muss der Autor MS Teams als virtuellen Standort erstellen.
Unter Ressourcen → Standorte → Neuer Standort → Virtueller Standort öffnet sich der Standort-Assistent. Hier legen Sie MS Teams als virtuellen Standort an. Wichtig ist, dass Sie als Virtual Classroom Typ Microsoft Teams auswählen. Weitere Konfigurationen für den MS Teams Standort (z.B. Sichtbarkeit des Zugangslinks, Kalender, Zeitzone etc.) können Sie hier vornehmen. Weitere Informationen finden Sie im Standort-Assistent. - Abschließend werden in Avendoo® im Standort-Assistent unter Parameter → Virtual Classroom Einstellungen die spezifischen Einstellungen aus den vorherigen Schritten für die Virtual Classroom Anbindung (siehe Screenshot) wie folgt hinterlegt:
- tenantId ist gepflegt (= ID vom Microsoft Account; diese können Sie auf der Übersichtsseite von Azure Active Directory im UUID (=Universally Unique Identifier)-Format sehen)
- clientId ist gepflegt (= Application ID von Avendoo® innerhalb der AzureAD-Umgebung; diese können Sie im Azure Active Directory unter Unternehmensanwendungen >> App-Registrierungen sehen)
- Nutzen Sie das von Microsoft empfohlene Client-Secret-Authentifizierungsverfahren, indem Sie die userId des Teamsbenutzers und den Wert für clientSecret hinzufügen. Die Authentifizierung über den Nutzernamen und das Passwort wird nicht von Microsoft empfohlen und steht daher nicht mehr zur Verfügung.
Bei Fragen steht Ihnen unser Support-Team zur Verfügung.
GoToWebinar
Um einen Virtuellen Standort mit GoToWebinar-Anbindung zu nutzen, befolgen Sie folgende Schritte:
OAuth-Client konfigurieren
- https://developer.goto.com/ , dort mit Logindaten für GoToWebinar anmelden.
- Dort oben “OAuth-Clients” anklicken, dann “Client erstellen” wählen.
- Bei “Client-Name” den Namen des Avendoo-Systems (Lernwelt, KundennameAvendoo…) angeben.
- Eine “Beschreibung” optional angeben (z. B. OAuth Client für VC-Standort in Avendoo LMS)
- Bei “Weiterleitungs-URIs” einfach die Starseite des Avendoo Systems angeben. Diese Merken für die spätere URL-Code Abfrage.
- ACHTUNG: Bei einer Auto-Weiterleitung für SSO entsprechend “/l/logoutReg” oder “/l/index” mit angeben.
- Unter “Bereich” bei “GoToMeeting, GoToWebinar oder GoToTraining” die Checkbox setzen.
- Die “Client-ID” (Beispiel: fb6ea2f5-37e4-9999-abd9-bbf2e819e600) und das “Client-Geheimnis” (Beispiel: oWvp0sghVBFGeS0f20we8OWt) kopieren. Das Client-Geheimnis kann nur einmal angezeigt werden. Sie müssen es speichern.
Authentifizierungs-Code und Refresh-Token
- URL für Code-Anfrage bauen durch Einsetzen der OAuth-Client-ID und der Weiterleitungs-URI in folgenden Link: https://api.getgo.com/oauth/v2/authorize?client_id={client_id}&response_type=code&redirect_uri={Weiterleitungs-URL aus dem OAuthClient}
- Diese URL in den Browser kopieren und aufrufen. Dann auf “Zulassen” klicken bzw. wieder mit dem GoToWebinar Account authentifizieren.
- Nachdem laden/re-direct der Seite, oben alles aus der Adresszeile des Browsers in einen Texteditor (nicht Word) kopieren. Die Zeichenkette nach “code=” wird später benötigt.
Beispiel (gekürzt): …code=eyJraWQiOiJvYXV0a….-MKSZTrJozmYoE1mPsQ
mit cygwin oder Postmann folgenden “POST” Aufruf durchführen:
Bei Postman:
Typ: POST
URL/Endpunkt: https://api.getgo.com/oauth/v2/token
Authorisation: BasicAuth mit der OAuth-Client-ID als “Username” und dem OAuth-Client-Secret als Passwort.
Headers:
Accept application/json
Content-Type application/x-www-form-urlencoded
Body: x-www-form-urlencoded
KEY: redirect_uri
Value: {Weiterleitungs-URL aus dem OAuthClient}&grant_type=authorization_code&code=(authentifzierungs-CodeAusDem Ergebnis von Code-Anfrage mit https://api.getgo.com/oauth/v2/authorize?client_id=}
Bei cygwin:
- Zuerst auf https://www.base64encode.org/ gehen. Dort die OAuth-Client-ID gefolgt von einem Doppelpunkt und dem OAuth-Client-Secret eingeben (client-id:clientSecret) und weiter unten auf “Encode” klicken.
Beispiel: fb6ea2f5-37e4-9999-abd9-bbf2e819e600:oWvp0sghVBFGeS0f20we8OWt
- Das Ergebnis (mit meist zwei Gleichheitszeichen am Ende) in einen Texteditor (nicht Word) kopieren.
Beispiel: ZmI2ZWEyZjUtMzdlNC05OTk5LWFiZDktYmJmMmU4MTllNjAwOm9XdnAwc2doVkJGR2VTMGYyMHdlOE9XdCA=
curl -X POST https://api.getgo.com/oauth/v2/token \
H “Authorization: Basic YTIwfAKeNGYtODY4YS00MzM5LTkzNGYtNGRhMmQ3ODhkMGFhOjNuYU8xMElBMmFnY3ZHKzlJOVRHRVE9PQ==” \
H “Accept:application/json” \
H “Content-Type: application/x-www-form-urlencoded” \
d “redirect_uri=https://example.com&grant_type=authorization_code&code=iS0vynEEvRFA9i6kZ8gvNDnnOGE…”
ACHTUNG: Am Ende des code in “-d “redirect_uri..” steht ein Anführungszeichen (“)!
- Den POST-Aufruf absenden. Die Antwort enthält einen “refresh_toke” und einen “organizer_key”. Diese beiden Angaben werde dann für die Konfiguration in Avendoo genutzt.
Beispiel:
{“access_token”:”eyJraWQiOiJvYXV0aHYyLmxtaS5jb20uMDIxOSIsImFsZyI6IlJTNTEyIn0.eyJzYyI…kBsT19H2CpNOr4uuITu-tEb4rTfvx53nEsOVtrl3t0BAUaPLH3C7HC5TUxrr1nMvUHvnEf6W_dbTic_Ac6D_XXYsmosCPEGiw”
,”token_type”:”Bearer”,
“refresh_token”:”eyJraWQiOiJvYXV0aHYyLmxtaS5jb20uMDIxOSIsImFsZyI6IlJTNTEyIn…KOLrYtvrHNs-MTO9xQ_Lor1Ls0bSLFgoaqGuojODK1dYrSDBzuhBfHy0t3WMYQ”
,”expires_in”:3600,”account_key”:”4980789151390994437″,”email”:seminare@Musterfirma.biz,”firstName”:”Musterfirma”,”lastName”:”Seminare”,
“organizer_key”:”526690667472934″,”version”:”3″,”account_type”:””}
Avendoo Virtuellen Standort erstellen
- In Avendoo einen neuen Standort erstellen. Im Standort-Assistenten “Virtueller Standort” wählen.
- Unten im Tab “Stammdaten” im Abschnitt “Virtual Classroom Typ” die Option “GoToWebinar” wählen.
- Im Tab “Parameter” bei “Virtual Classroom Einstellungen” folgendes einfügen:
clientId=017e6790-…78d2a9211683
clientSecret=**********
organizerId=526690667472934
refreshToken=eyJraWQiOiJvYXV0aHYyLmxtaS5jb20uMDIxOSIsImFsZyI6IlJTNTEyIn…KOLrYtvrHNs-MTO9xQ_Lor1Ls0bSLFgoaqGuojODK1dYrSDBzuhBfHy0t3WMYQ
Die Werte für clientId und clientSecret stammen aus der OAuth Konfiguration.
Die Werte für organizerId und der refreshToken aus dem POST Call (per cygwin oder Postman).
Im Tab “Parameter” bei “Zeitpunkt Raumerstellung” 2440 Minuten eintragen. Dann wird der Raum/Session 2 Tage vorher in GoToWebniar angelegt.
- “Join-Link Vorab-Sichtbarkeit” einstellen, auf 30-60 Minuten. Diese gibt an, ab wann der Teilnehmer den Link zum GoToMeeting auf dem Lernplatz bzw. in der Termin-Detailansicht sehen kann.
- “Join-Link Sichtbarkeit” einstellen auf 30-60 Minuten”
- Standort speichern.
- WICHTIG: Wenn mehrere GoToWebinar Termine parallel (=zeitlich überschneidend) erzeugt werden sollen, sind entsprechen mehrere Virtuelle Standorte anzulegen.
Testen
- Veranstaltung und Veranstaltungstermin mit “Virtuellem Standort GoToWebinar” anlegen. Termin maximal soweit in der Zukunft, wie der Wert bei “Join-Link Vorab-Sichtbarkeit” eingestellt wurde.
- Kurs und Kursfreigabe dazu erstellen.
- Test-Teilnehmer (mit dem man sich selbst einloggen kann) an den Termin anmelden.
- URL des Avendoo Systems nach https://avendooURL.de/share/ ersetzten mit “/tutor/TutorController?action=runTestMethod&testMethod=newVcInstantRun” zu https://avendooURL.de/tutor/TutorController?action=runTestMethod&testMethod=newVcInstantRun und aufrufen. Das sorgt für eine sofortige Übermittlung zum testen.
- Unter https://dashboard.gotowebinar.com/ mit den Zugangsdaten für GoToWebinar anmelden.
- Der VC-Termin der Veranstaltung sollte auf dem Dahboard in GoToWebniar zu sehen sein.
- In Avendoo mit dem angemeldeten Testeilnehmer einloggen und auf dem Lernplatz auf den Termin klicken.
- In der Termin-Detail-Ansicht sollt der “JOIN-Link” für den Übergang zu GoToWebinar vorhanden sein.
YuLinc
Die folgenden Einstellungen entsprechen den angezeigten Virtual Classroom Einstellungen auf dem Reiter Parameter im Standort-Assistenten des Virtuellen Standortes.
Um einen Virtuellen Standort mit YuLinc-Anbindung zu nutzen, müssen zuerst folgende Voraussetzungen hinsichtlich YuLinc gewährleistet sein:
- manager_username (= Nutzername des Managers im YuLinc-System) ist gepflegt
- manager_password (=Passwort des Managers im YuLinc-System) ist gepflegt
- session_success_percentage (=Zeit in Prozent, die ein Nutzer an einer Session in YuLinc teilgenommen haben muss, um zu bestehen) ist gepflegt
Bei Fragen steht Ihnen unser Support-Team zur Verfügung.
Weitere Schnittstellen zu VC Tools
Weiterhin können Sie folgende Schnittstellen zu VC Tools nutzen:
- Vitero
- WebEx
- YuLinc
Weitere Informationen zu Vitero und WebEx finden Sie hier.
Stammdaten
Titel und Sprache
Geben Sie einen Titel ein und wählen Sie die Sprache für den neuen virtuellen Standort.
Externe Referenz und Externer Referenztyp
Die Externe Referenz dient dazu eine Beziehung (Referenz) mit einem anderen externen System herzustellen. Dies können Sie für manuelle Verknüpfungen und auch bei der Verwendung von Schnittstellen (REST-API) nutzen.
Die Externe Referenz stellt dabei einen Referenz-Wert wie ID, Laufnummer oder Name dar und der Externe Referenztyp beschreibt, was es für eine Referenz ist oder wie der Referenz-Wert zu verstehen ist. Das ist besonders wichtig, wenn es verschiedene Quellen oder Arten von Referenztypen gibt, da diese eventuell gleiche Referenzwerte verwenden.
Beispiele:
•Referenztyp SAP-Kundennummer mit der Externen Referenz 100234
•Referenztyp SAP-User-ID mit der Externen Referenz 000004
Virtual Classroom Typ
Wählen Sie die Virtual-Classrooms-Anbindung aus.
Zur Zeit können Sie folgende Virtual Classroom Typen auswählen:
- Microsoft Teams
- GoToWebinar
- Linkeingabe und
Beispiel für Linkeingabe: Sie hinterlegen eine Teams Event URL im Eingabefeld Link im Veranstaltungstermin-Assistenten nach Hinzufügen des Virtuellen Standortes (Menü Virtuellen Raum hinzufügen) , damit Teilnehmer über einen Link teilnehmen können. - YuLinc.
Parameter
Aktiver Standort
Setzen Sie das Häkchen, wenn es sich bei dem Standort um einen aktiven Standort handelt, er also aktiv verwendet werden kann und nicht durch z.B. Renovierungsmaßnahmen oder Ähnliches nicht nutzbar ist.
Virtual Classroom Einstellungen
Um die Felder Virtual Classroom Einstellungen, Zeitpunkt Raumerstellung und Join-Link Sichtbarket sehen und bearbeiten zu können, hat der Autor das Häkchen für das Zugriffsrecht VC-Einstellung am Standort sehen und bearbeiten gesetzt.
In diesem Feld werden Ihnen die spezifischen Einstellungen für die VC-Anbindung angezeigt (siehe “Unterstützende Systeme”) . Diese sind abhängig vom jeweiligen VC-Typ (z.B. Microsoft Teams).
Zeitpunkt Raumerstellung
Legen Sie fest, um wie viel Minuten vor der eigentlichen Nutzung der Raum im externen System erstellt werden soll. Maximal können Sie 2 Tage, d.h. 2880 Minuten eingeben. Das heißt diese angegebene Zeit vorher (Vorlaufphase) können die Teilnehmer den Raum betreten.
Join-Link Vorab-Sichtbarkeit
Um die Join-Link Vorab-Sichtbarkeit zu aktivieren, setzen Sie das Häkchen Aktivieren.
Legen Sie dann fest, um wie viel Minuten vor der eigentlichen Nutzung der Raum im externen System erstellt werden soll, z.B. 5 Minuten heißt, die Benutzer können dem Raum bei einer Veranstaltung von 15 bis 16 Uhr bereits um 14.55 Uhr beitreten.
Join-Link Sichtbarkeit
Um die Join-Link Sichtbarkeit zu aktivieren, setzen Sie das Häkchen Aktivieren.
Legen Sie dann fest, wie viele Minuten lang ein Join-Link für die Benutzer in dem Veranstaltungsbereich sichtbar ist, z.B. 15 Minuten bei einer Veranstaltung von 15 bis 16 Uhr heißt, dass die Benutzer nur bis 15.15 Uhr dem Raum beitreten können. Wenn Sie eine Join-Link Vorab-Sichtbarkeit z.B. auf 5 Minuten eingestellt haben, zählt die Sichtbarkeit ab 14.55 Uhr und die Benutzer können nur bis 15.10 Uhr dem Raum beitreten.
Wenn es keine spezielle Sichtbarkeitsdauer gibt, wird die Nutzung des Standortes am Termin als Sichtbarkeit genutzt, z.B.: 15 bis 16 Uhr.
Interne und externe Anmerkung
Geben Sie eine interne und/oder externe Anmerkung für den virtuellen Standort ein.
Alternative Beschreibung (ohne HTML)
Geben Sie eine alternative Beschreibung (ohne HTML) für den virtuellen Standort ein.
Kalender
Kalender zuordnen
Ordnen Sie jedem Standort einen oder mehrere Kalender (beispielsweise ein Kalender für nationale und ein weiterer für regionale Feiertage) hinzu, indem Sie auf den Button “Hinzufügen” klicken und den entsprechenden Kalender auswählen. Den zugeordneten Kalender können Sie gegebenenfalls wieder entfernen.
Kalendertage hinzufügen
Falls die Nutzung des Standorts über die Tage der zugeordneten Kalender hinaus geblockt werden soll (z.B. bei Renovierungsarbeiten), können Sie weitere einzelne Tage hinzufügen. Diese werden keinem Kalender, sondern lediglich dem Standort zugeordnet. Geben Sie dazu in den Feldern “Bezeichnung”, “Startzeit” und “Endzeit” die entsprechenden Daten ein und klicken dann auf den Button “Hinzufügen”.
Zeitzone
Zeitzonenverschiebung
Geben Sie die Zeitzonenverschiebung an, in der sich der Standort befindet. UTC = Coordinated Universal Time
Zeitzone
Geben Sie die Zeitzone an, in der sich der Standort befindet. Gewisse Zeitzonen vefügen über eine unterschiedliche Sommer-/Winterzeit. Falls Sie die Zeitzone ändern, wird die Zeitzone eines Termins, die diesen Standort verwendet, nicht angepasst.
Sie können die Zeitzonenverschiebung auch auswählen, indem Sie auf den entsprechenden Bereich auf der Karte klicken.
Sie können die Größe der Karte durch den Plus- und Minusknopf (
und 
) verändern.
Beschreibung
Bearbeiten Sie die Beschreibung des Standortes über den Editor folgendermaßen:
- Wählen Sie ein Responsive Layout über den Button Responsive-Layouts.
- Wählen Sie nach Bedarf die Buttons Textbereich, Raumliste, Adresse oder/und Bildergalerie.
Hinweis: Die älteren Beschreibungen sind immer noch vorhanden. Sie können über diesen Editor bearbeitet werden.
Mit Hilfe dieses Buttons fügen Sie einen Textbereich via Drag and Drop ein. Zum Bearbeiten des Textbereiches klicken Sie in die Box und der Editor öffnet sich.
Mit Hilfe des Buttons Raumliste fügen Sie den Platzhalter für die Raumliste via Drag and Drop ein. Über die Vorschau des Standortes können Sie sehen, welche Raumliste eingefügt wurde.
Mit Hilfe des Buttons Adresse fügen Sie den Platzhalter für die Adresse via Drag and Drop ein. Über die Vorschau des Standortes können Sie sehen, welche Adresse eingefügt wurde.
Mit Hilfe des Buttons Bildergalerie fügen Sie den Platzhalter für die Bildergalerie via Drag and Drop ein. Über die Vorschau des Standortes können Sie sehen, welche Bildergalerie eingefügt wurde.
Mit Hilfe des Buttons Responsive Layouts können Sie responsive Layouts erstellen.
Mit Hilfe des Buttons Seite zurücksetzen können Sie konfigurierte Seiten zurücksetzen.
Mit Hilfe des Buttons CSS/JS können Sie hinsichtlich JavaScript oder/und CSS konfigurieren.
Medien
Laden Sie Medien hoch, die den Standort näher beschreiben oder ihn grafisch darstellen, um den Lernenden eine Vorschau zu geben. Haben Sie mehrere Bilder hochgeladen, so wird als Standard-Vorschaubild das Bild gewählt, welches in der Darstellung an erster Position steht und welches farblich umrandet ist.
Tasks
Um einen Task zuzuordnen, legen Sie zuerst auf dem Reiter Parameter den Standorttyp fest und wählen dann auf diesem Reiter den Button Taskvorlage hinzufügen.
Um eine neue Taskvorlage zu erstellen, klicken Sie zuerst auf den Button Taskvorlage hinzufügen und dann auf den Button Neue Taskvorlage.
Taskvorlagen am Veranstaltungsort
Taskvorlagen
Sie wählen zuerst eine Taskvorlage aus.
Sie können den Auslöser (Terminaktivierung, Geänderte Essenswünsche, Geänderte Übernachtungen, Ersatzteilnehmer, Anmeldungen, Abmeldungen, Nachrücken von Warteliste, Zu wenig Teilnehmer, Zu viele Teilnehmer, Termininitiierung oder Terminplanung) auswählen. Sie können durch Setzen eines Häkchens festlegen, ob der Auslöser sofort aktiv ist oder wie viele Stunden und Tage vor oder nach Terminbeginn, Anmeldeschluss oder Abmeldeschluss.
Wenn Sie den Auslöser Terminaktivierung, Termininitiierung oder Terminplanung gewählt haben, können Sie nicht Auslöser aktiv ab festlegen, da diese Auslöser immer ab sofort aktiv sind. Mit Hilfe der Auslöser Termininitiierung und Terminplanung kann der Koordinator Tasks erstellen und bearbeiten, die vor der Terminaktivierung sind.
Beim Auslöser Terminaktivierung wird der Task erstellt, sobald der Terminsstatus von In Planung auf Initiiert oder Aktiv wechselt.
Beim Auslöser Termininitiierung wird der Task erstellt, sobald der Terminstatus von In Planung auf Initiiert wechselt.
Beim Auslöser Terminplanung wird der Task sofort erstellt, sobald der Autor den Veranstaltungstermin speichert und der Terminstatus In Planung hat.
Wer erhält den Task?
Legen Sie die zuständige Person für den Task fest, indem Sie den entsprechenden Radio-Button anklicken:
- Koordinator des Veranstaltungstermins
- Besitzer der Veranstaltung
- Auswahl eines Autors
Klicken Sie hierzu auf den Button Auswählen, wählen aus der Liste den entsprechenden Autoren aus und bestätigen Ihre Auswahl mit dem Button “Auswählen”.
Fälligkeit
Legen Sie die Fälligkeit des Tasks in folgendem Format fest:
- Stunden
- Tage
Zusätzlich wählen Sie, ob die Fälligkeit des Tasks
- vor Terminbeginn, Anmeldeschluss oder Abmeldeschluss oder
- nach Terminbeginn, Anmeldeschluss oder Abmeldeschluss
sein soll.
Über den Button Löschen können Sie die Taskzuordnung wieder entfernen.
