Box.net APIv1 Migration

Aus MoodleDocs
Wechseln zu:Navigation, Suche


Box.net API v2

Die Box.net API v1, die Moodle zur Kommunikation mit dem Box Repository und dem Box.net Portfolio verwendet hat, ist zum 14. Dezember 2013 ausgelaufen. Sie wurde ersetzt durch die Box.net API v2. Daraus ergeben sich drei wichtige Konsequenzen:

  1. Die Moodle-Site muss HTTPS verwenden, um auf Box.net zuzugreifen.
  2. Das Box.net Repository und das Box.net Portfolio müssen mit einer Client ID und einem Secret konfiguriert werden.
  3. Nutzer/innen des Box Repository können keine Shortcuts / Aliase zu Dateien mehr erstellen, die in Box.net gespeichert sind. Bestehende Shortcuts / Aliase müssen mit Hilfe des Box.net-alias-to-copy-conversion Tools in Dateikopien umgewandelt werden.

Box.net Client ID und Secret erwerben

  • Gehen Sie auf die Seite https://app.box.com/ und melden Sie sich an oder registrieren Sie sich neu.
  • Gehen Sie auf die Seite https://app.box.com/developers/services und klicken Sie auf den Link Create new application.
  • Geben Sie der Applikation einen Namen und klciken Sie auf den Button Content API.
  • Wenn die Applikation angelegt ist, klicken Sie auf den Button Edit this application.
  • Scrollen Sie nach unten auf der Seite in den Abschnitt OAuth2 parameters und notieren Sie sich die Client ID und das Secret. Diese Daten verwenden Sie, um das Box.ner Repository bzw. Box.net Portfolio in Moodle zu konfigurieren, siehe folgende Abschnitte.

Box.net Repository Einstellungen

  • Beschaffen Sie sich eine Client ID und ein Secret von Box.net.
  • Gehen Sie auf die Seite Einstellungen > Website-Administration > Plugins > Repositories > Übersicht.
  • Re-Aktivieren Sie das Box.net Repository und wählen Sie die Option Aktiviert und sichtbar.
  • Tragen Sie die Client ID und das Secret ein.
  • Klicken Sie auf den Button Speichern.

Box.net Portfolio Einstellungen

  • Beschaffen Sie sich eine Client ID und ein Secret von Box.net. Dieser Schritt ist nicht nötig, wenn Sie diese Daten bereits für das Box.net Repository erworben haben.
  • Gehen Sie auf die Seite Einstellungen > Website-Administration > Plugins > Portfolios > Portfolios verwalten.
  • Re-Aktivieren Sie das Box.net Portfolio und wählen Sie die Option Verfügbarund sichtbar.
  • Tragen Sie die Client ID und das Secret ein.
  • Klicken Sie auf den Button Speichern.

Das Box.net-alias-to-copy-conversion Tool

Achtung: Die Moodle-Administration muss das Box.net-alias-to-copy-conversion Tool vor dem 14. Dezember 2013 laufen lassen, um Datenverluste zu vermeiden! Es wird empfohlen, das Tool unmittelbar nach der Aktualisierung von Moodle laufen zu lassen:

  • Gehen Sie dazu auf die Seite Einstellungen > Website-Administration > Plugins > Repositories > Übersicht und klicken Sie auf den Link Einstellungen beim Box Repository.
  • Klicken Sie auf den entsprechenden Link, um das Tool laufen zu lassen.

Alternative: Sie können auch von Kommandozeile das Skript /moodle/repository/boxnet/cli/migrationv1.php laufen lassen.

Beachten Sie, dass die Konvertierung einige Stunden dauern kann, je nachdem wie viele Aliase es gibt und wie groß die entsprechenden Dateien sind.