Einrichten von Ally in Blackboard
Ally Building Block konfigurieren
Der Baustein Ally-Integration ist bereits in Ihrer Blackboard-Umgebung installiert. Wählen Sie unter Administration die Option Building Blocks und Installierte Tools, um diesen zu finden. Ein Blackboard Technical Consultant konfiguriert diesen Building Block für Sie.
Die Konfiguration des Ally Building Blocks umfasst die folgenden Schritte:
Machen Sie die Integration in den Ally-Integrationseinstellungen verfügbar.
Erstellen Sie einen Benutzer. Niemand wird als dieser Benutzer angemeldet sein. Dieser Benutzer wird für die Ausführung der REST-API-Integration erstellt und verfügt über bestimmte Berechtigungen. Häufig verwendete Benutzernamen lauten „allyuser“ oder „allyintegration“.
Wichtig
Löschen Sie den Ally-Benutzer nicht. Wenn Sie den Benutzer löschen, funktioniert die Integration nicht.
Fügen Sie Informationen zum Tool-Anbieter und benutzerdefinierte Parameter hinzu. Schlüssel, Geheim, Client-ID, URL und Benutzerdefiniertes Skript werden verwendet, damit die alternativen Formate von Ally, das Feedback von Kursleitern und Berichte in Ihrer Blackboard-Umgebung gestartet werden können.
Anmerkung
Benutzerdefinierte Skriptparameter werden hinzugefügt, damit Ally in der Original-Ansicht funktioniert.
Wichtig
Die Client-ID ist für jede Umgebung eindeutig. Sie kann nicht sowohl für Ihre Staging- als auch Ihre Produktionsumgebung verwendet werden.
Was wird mit der Building Block-Konfiguration zu der Umgebung hinzugefügt?
Nach der Konfiguration des Building Blocks sehen Sie die folgenden zusätzlichen Elemente in Ihrer Umgebung, die ein Konto, eine Rolle und Tools umfassen:
Ally-Integrationsbenutzer
Ally-Integrationssystemrolle, die dem Ally-Integrationsbenutzer zugewiesen ist
Ally-Konfiguration
Ally-Bericht
Über die Ally-Benutzer- und -Systemrolle
Nach der Konfiguration des Ally Integration Building Blocks wurde eine Ally-Integrationsbenutzer- und eine -systemrolle zu Ihrer Umgebung hinzugefügt.
Mit diesem Benutzerkonto meldet sich niemand an. Dieser Benutzer wird für die Ausführung der REST-API-Integration erstellt. Die Ally-Integrationsrolle wird nur vom Ally-Benutzer verwendet und sollte nicht einem regulären Benutzer zugewiesen werden. Es treten Fehler auf, wenn ein reguläres Benutzerkonto versucht, sich mit der Ally-Integrationssystemrolle anzumelden.
Dem Benutzer ist die Ihrer Umgebung hinzugefügte Ally-Integrationssystemrolle zugewiesen. Die Systemrolle verfügt über eine Reihe von Berechtigungen, die die Funktionsweise der Integration in der Umgebung definieren.
Wichtig
Löschen Sie die Ally-Benutzer- und -Systemrolle nicht. Wenn Sie eine dieser Rollen löschen, funktioniert die Integration nicht.
Berechtigungen der Ally-Integrationssystemrolle
Vertrauenswürdige Inhalte mit Skripten hinzufügen/bearbeiten: Ermöglicht dem Kursleiter-Feedback, dass die Inhalte so bleiben, wie sie ursprünglich von den Kursleitern erstellt wurden. Ohne diese Berechtigung könnte Ally versehentlich einen Teil des vom Kursleiter hinzugefügten Inhalts entfernen.
Kurs-/Organisationssteuerung (Tools) > Datumsverwaltung: Ermöglicht Ally den Zugriff auf das Datumsverwaltungstool in der Original-Kursansicht.
Blackboard Predict Advisor Tool: Ermöglicht Ally den Zugriff auf das Predict Advisor-Tool.
Administratorbereich (Benutzer) > Benutzer > Organisationseinschreibungen bearbeiten > anzeigen: Ermöglicht Ally, für jede Organisation die Anzahl der Teilnehmer anzugeben.
Anmerkung
Ally bezeichnet Organisationen als Kurse in den Institutions- und Kursberichten.
Administratorbereich (Benutzer) > Benutzer > Bearbeiten > Anzeigen von Kursanmeldungen: Ermöglicht Ally, für jeden Kurs die Anzahl der Teilnehmer anzugeben.
Kurs-/Organisations-Systemsteuerung (Tools) > Tests, Umfragen und Pools > Erstellen von Tests, Tests und Anzeigen von Testdesigns und -einstellungen Ermöglicht Ally das Scannen und Bewerten von angehängten Dateien oder Bildern, die in das WYSIWYG der Inhaltslinkbeschreibung von Tests und Umfragen eingebettet sind. Diese Berechtigungen sind miteinander verknüpft und müssen alle ausgewählt werden.
Steuerungsfenster für Kurs/Organisation (Tools) > Tests, Umfragen und Pools > Tests > Test erstellen
Steuerungsfenster für Kurs/Organisation (Tools) > Tests, Umfragen und Pools > Tests
Kurs-/Organisations-Systemsteuerung (Tools) > Tests, Umfragen und Pools > Tests > Anzeigen von Testdesign und -einstellungen
Kurs/Organisation (Inhaltsbereiche) > Materialien bearbeiten: Ermöglicht Ally, Bildattribute in Inhaltselementbeschreibungen zu aktualisieren.
Zugriff auf das Content System-Dateisystem "Lesen", "Schreiben", "Löschen", "Ausführen": Ermöglicht Ally, Dateien zurück in die Umgebung zu schreiben, wenn Kursleiter sie über das Kursleiter-Feedback hochladen. Mit dieser Berechtigung kann Ally auch Elemente löschen, die Krampfanfälle auslösen können, darunter auch Dateien aus Kursleiterfeedback.
Schreibgeschützter Zugriff auf das Content System-Dateisystem: Ermöglicht Ally das Lesen von Dateien für die Verarbeitung. Zum Beispiel für das Onboarding und die Kurssynchronisierung.
Die REST-API-Integration konfigurieren
Konfigurieren Sie die REST-API so, dass Ally Inhalte und Kursinformationen aus Ihrer Umgebung abrufen kann. Ein Blackboard Technical Consultant konfiguriert die REST-API-Integration für Sie.
Die Konfiguration der Ally-REST-API-Integration umfasst die folgenden Schritte:
Fügen Sie die Anwendungs-ID hinzu. Die Anwendungs-ID ist immer gleich und kann wiederverwendet werden. Anwendungs-ID:
85d3b720-1a00-45e4-a3ee-c2be80de7295Fügen Sie den Ally-Integrationsbenutzer hinzu. Häufig verwendete Benutzernamen lauten „allyuser“ oder „allyintegration“.
Gewähren Sie der REST-API den Zugriff für Endbenutzer. Wählen Sie Ja aus, damit die Ally-Integration als Benutzer fungiert, und nicht als einzelner systemweiter Benutzer.
Autorisieren Sie die REST-API als Benutzer. Wählen Sie Ja aus, damit Ally Inhalte am ursprünglichen Ort aktualisieren kann.
Kursbericht konfigurieren
Konfigurieren Sie den Kursbericht so, dass er zu Kursen in Ihrer Umgebung hinzugefügt wird. Ein Blackboard Technical Consultant konfiguriert den Kursbericht für Sie.