Zusammenarbeit von Schülern, Studierenden, Lehrkräften

Bildungseinrichtungen verwenden PDF-Dokumente, um Lernmaterialien für Schüler und Studierende freizugeben. PDF bieten ein austauschbares Dokumentformat für Lehrkräfte.

Durch die Integration von Adobe PDF Services API und Adobe PDF Embed API in eine App erhalten Lehrkräfte, Schüler und Studierende eine zentrale Plattform für den Unterricht und das Lernen. Beispielsweise kann Ihre App Schülern und Studierenden ermöglichen, Fragen zu ihren Aufgaben und Berichtskarten zu stellen und an Gruppenaufgaben zusammenzuarbeiten.

Es gibt ein offizielles SDK für Node.js-Anwendungen, um auf die PDF Services API zuzugreifen. Damit kannst du Dokumente wie Microsoft Word oder Microsoft Excel in
PDF. Sie können auch komplexere Vorgänge durchführen, z. B. mehrere Berichte kombinieren, Seiten neu anordnen und PDF schützen. Weitere Informationen finden Sie in der Produktdokumentation.

Lernziel.

In diesem praktischen Tutorial lernen Sie, wie Sie eine Online-Lernplattform erstellen, mit der Lehrkräfte, Schüler und Studierende Ressourcen auf dem PDF einfach gemeinsam nutzen können. In diesem Tutorial wird ein Lernportal verwendet, das mit der JavaScript-Laufzeit Node.js (Node.js) und den PDF-Diensten erstellt wurde.

Das Lernportal verfügt über die folgenden Funktionen:

Erfahren Sie, wie Adobe Acrobat Services Ihren Schülern mit PDF ein reichhaltiges Erlebnis bietet. Acrobat Services-APIs lassen sich nahtlos in vorhandene Anwendungen integrieren, sodass Schüler und Studierende Dateien hochladen, konvertieren und anzeigen sowie Kommentare abgeben und speichern können - alles in Ihrer aktuellen Einrichtung.

Relevante APIs und Ressourcen

Hochladen von Ressourcen auf das Lernportal

Im Bereich "Lehrkräfte" des Lernportals können Lehrkräfte Dokumente wie Aufgaben und Tests hochladen. Die Dokumente können in jedem Format vorliegen, z. B. Microsoft Word, Microsoft Excel, HTML, verschiedene Bildformate usw.

Hochgeladene Dokumente werden gespeichert und den Schülern präsentiert, wenn sie ihre Webseite öffnen.

Informationen zum Hochladen der Dateien durch die Anwendung finden Sie im Projektcode.

Konvertieren von Dokumenten in PDF

Schüler können ein oder mehrere Dokumente eines beliebigen Typs in PDF, z. B. Microsoft Word, Excel und PowerPoint, sowie andere gängige Text- und Bilddateiformate konvertieren. Das Lernportal verwendet PDF Services, um Dateien in PDF zu konvertieren.

Um ein eigenes Lernportal zu erstellen, müssen Sie zunächst Ihre eigenen Anmeldeinformationen erstellen. Registrieren bei
Nutzen Sie PDF Services API sechs Monate lang kostenlos und nutzen Sie bis zu 1.000 Dokumenttransaktionen. Danach Pay-as-you-go bei nur $0,05 pro Dokumenttransaktion, während die Klasse ihre Aufgaben beschleunigt.

Wenn ein Schüler/Studierender ein Dokument im Dashboard auswählt, wird Folgendes angezeigt:

Der Schüler wählt einfach die zu konvertierenden Dokumente aus und klickt auf Bericht abrufen.

Das Lernportal konvertiert die Dokumente in PDF und zeigt eine Berichtsseite zusammen mit einer Vorschau der PDF-Datei an.

Hier ist der Beispielcode für diesen Schritt:

async function createPdf(rawFile, outputPdf) {
    try {
            // configurations
            const credentials =  adobe.Credentials
            .serviceAccountCredentialsBuilder()
            .fromFile("./src/pdftools-api-credentials.json")
            .build();

            // Capture the credential from app and show create the context
            const executionContext = adobe.ExecutionContext.create(credentials),
            operation = adobe.CreatePDF.Operation.createNew();

            // Pass the content as input (stream)
            const input = adobe.FileRef.createFromLocalFile(rawFile);
            operation.setInput(input);

            // Async create the PDF
            let result = await operation.execute(executionContext);
            await result.saveAsFile(outputPdf);
    } catch (err) {
            console.log('Exception encountered while executing operation', err);
    }
}

Der Beispielcode ruft die createPdf-Methode im Express-Routenhandler auf, um die PDF zu generieren.

Informationen zum Aufrufen dieser Methode finden Sie unter Projektcode.

Vorschau der Lernressourcen

Die Benutzeroberfläche verwendet die PDF Embed-API zum Rendern von PDF in einem Webbrowser. Diese API kann kostenlos verwendet werden.

Die PDF Embed-API verwendet andere Anmeldeinformationen als die PDF Services-API. Sie müssen daher Anmeldeinformationen erstellen.
bevor du es benutzen kannst. Dann können Sie PDF Embed völlig kostenlos verwenden.

Stellen Sie sicher, dass Sie die richtige Website-URL in das Token eingeben. Andernfalls können Sie die PDF möglicherweise nicht mit dem Token rendern.

Die Benutzeroberfläche verwendet die Vorlagensprache Handlebars. Die PDF wird in einem Webbrowser angezeigt.

Hier ist der Code für diesen Schritt:

<div id="adobe-dc-view" style="height: 750px; width: 700px;"></div>
<script src="https://documentcloud.adobe.com/view-sdk/main.js"></script>
<script type="text/javascript">
    document.addEventListener("adobe_dc_view_sdk.ready", function () {
        var adobeDCView = new AdobeDC.View({ clientId: "<your-credentials-here>", divId: "adobe-dc-view" });
        adobeDCView.previewFile(
            {
                content: {
                    location: { url: "<file-url>" }
                },
                    metaData: { fileName: "<file-name>" }
            },
           );
    });
</script>

<p>Material has been generated, <a href="/students/download/{{filename}}" target="_blank">click here</a> to download it.
</p>

Dieser Code zeigt die PDF-Ausgabe und den Link zum Herunterladen des PDF-Berichts an, wie in der folgenden Bildschirmaufnahme gezeigt:

Schüler sollten den Bericht herunterladen oder hier an dem Material arbeiten können.

Kommentieren von PDF-Dokumenten

Eine Lernplattform sollte grundlegende Anmerkungen, Kommentare und Diskussionen in PDF unterstützen. Die PDF Embed-API bietet all diese Funktionen. Es aktiviert die Unterstützung von Anmerkungen mithilfe von showAnnotationTools, sodass Lehrkräfte und Schüler die Dokumente kommentieren und Kommentare als Teil des PDF archivieren können.

Um Anmerkungen in PDF-Dokumenten zu aktivieren, müssen Sie nur das Argument showAnnotationTools übergeben: true an die previewFile-Methode. Dadurch wird das Anmerkungswerkzeug in der PDF-Vorschau angezeigt. Rufen Sie dieses Werkzeug über das Menü mit den drei Punkten in der oberen rechten Ecke der Vorschau auf.

In den von den Lehrkräften hochgeladenen Dokumenten können die Schüler Text hervorheben, Kommentare hinzufügen usw.

In der obigen Bildschirmaufnahme wird der Benutzer als "Gast" bezeichnet, Sie können jedoch Profile für Benutzer wie Schüler, Studierende, Lehrkräfte und Dozenten konfigurieren.

Wenn ein Schüler oder Studierender eine Anmerkung anwendet, zeigt die PDF Embed-API eine Speichern-Schaltfläche auf dem oberen Banner an. Beim Speichern werden die Anmerkungen zur Datei hinzugefügt. Klicken Sie auf Speichern, um zu sehen, wie die Datei mit der im Bericht eingebetteten Anmerkung gespeichert wird.

Die Schüler können Anmerkungen verwenden, um Fragen zu stellen oder ihre Kommentare zum Lernmaterial zu teilen.

Verfolgen der Dokumentverwendung

Für Lehrkräfte und Schulen ist es wichtig zu sehen, wie Schüler Online-Plattformen nutzen. Dies hilft Lehrkräften, ihre Schüler und Studierenden mit Ressourcen zu unterstützen, die ihnen helfen, ihre Aufgaben besser zu erfüllen. Die PDF Embed-API ist mit Analysen integriert, mit denen Sie alle stattfindenden Ereignisse messen können, z. B. das Öffnen, Lesen und Schließen von Dokumenten. Mit der PDF Services API können Lehrkräfte auch das Drucken, Herunterladen und Ändern von Dateien deaktivieren, um die akademische Integrität zu wahren.

Wenn Sie über eine Adobe Analytics-Lizenz verfügen, können Sie die vorkonfigurierte Integration verwenden. Verwenden Sie andernfalls Rückrufe, um Ihre PDF Services mit anderen Analyseanbietern wie Google zu integrieren.

Um die Messung von Dokumentereignissen zu aktivieren, hängen Sie die Ereignishandler mithilfe der registerCallback-Methode mit der Adobe DC View-Instanz an. Sie können grundlegende Kennzahlen wie das Öffnen eines Dokuments oder das Lesen einer Seite auf der Konsole anzeigen. Sie können die Metriken auch in einem Protokoll speichern oder in anderen Analyse-Stores veröffentlichen.

Hier ist der Beispielcode zum Anhängen der Ereignishandler:

adobeDCView.registerCallback(
    AdobeDC.View.Enum.CallbackType.EVENT_LISTENER,
    function(event) {
           console.log(event);
    },
    {
           enablePDFAnalytics: true
    }
);

Lehrer können sehen, wie viele Schüler den Auftrag gesehen haben, wie viele die Seiten ihrer Notizen durchlaufen haben und andere wertvolle Details sehen.

Hier ist eine Bildschirmaufnahme der Webbrowser-Konsole:

Diese Bildschirmaufnahme zeigt, dass der Schüler die Aufgabendatei geöffnet hat, er die erste Seite gelesen hat - er hat entweder nicht zu weiteren Seiten gescrollt oder das Dokument hatte nur eine Seite - dann hat er die Datei heruntergeladen. Ihr könnt diese Kennzahlen erfassen, um Analysen durchzuführen und das Verhalten eurer Schüler zu untersuchen.

Außerdem ist Adobe Analytics mit der PDF Embed-API integriert. Wenn Sie also über ein Abonnement für die Adobe Analytics-Suite verfügen, können Sie Ihre Kennzahlen in Ihrem Abonnement veröffentlichen. Um die Metriken in Adobe Analytics zu veröffentlichen, müssen Sie lediglich Ihre Suite-ID an den PDF Embed-API-Konstruktor übergeben. (Beachten Sie, dass Sie Ihre PDF Embed-API-Anmeldedaten verwenden müssen, nicht Ihre PDF Services API-Anmeldedaten).

Hier ist ein Beispielcode, der zeigt, wie die Suite ID an den PDF Embed-API-Konstruktor übergeben wird:

var adobeDCView = new AdobeDC.View({
    clientId: "<your-adobe-dc-credential>",
    divId: "<#element>"
    reportSuiteId: <your-id-here>,
});

Nächste Schritte

In diesem praktischen Tutorial wurde die Verwendung der PDF Services API und der PDF Embed API zum Erstellen eines Lernportals untersucht, das eine effektive Zusammenarbeit zwischen Schülern und Lehrkräften ermöglicht. Mit diesem Portal können Lehrkräfte Lernmaterial in jedem Format hochladen und es mithilfe der PDF Services API in PDF konvertieren. Die Schüler/Studierenden können diese PDF dann mithilfe der PDF Embed-API in der Vorschau anzeigen.

Nachdem Sie nun wissen, wie Sie PDF-Berichte kommentieren, die Anmerkungen archivieren und die Verwendung von PDF-Berichten verfolgen, können Sie mit der Implementierung dieser Lösungen in Ihren eigenen Projekten beginnen.

Sie können Adobe Acrobat Services-APIs verwenden, um benutzerfreundliche, interaktive PDF-Erlebnisse auf Ihrer Website zu erstellen. Nutzen Sie die Adobe PDF Services API sechs Monate lang kostenlos, danach nur Pay-as-you-go (über AWS oder einen Direktvertrag) für nur $0,05 pro Dokumenttransaktion. Nutze Adobe PDF Embed kostenlos und unbegrenzt. Erstellen Sie noch heute ein kostenloses Konto für Erste Schritte.