Samverkan mellan studerande och lärare

Banderoll för användningsfall

Utbildningsinstitutioner använder PDF-dokument för att dela utbildningsmaterial med elever. PDF är ett utbytbart dokumentformat för lärare.

Integrera Adobe PDF Services API och Adobe PDF Embed API i en app ger lärare och elever en enda plattform att undervisa och lära sig på. Din app kan t.ex. göra det möjligt för elever att ställa frågor om sina uppgifter och rapportkort och samarbeta om grupptilldelningar.

Det finns en officiell SDK för Node.js-program för att komma åt PDF Services API. Det gör att du kan konvertera dokument som Microsoft Word och Microsoft Excel till PDF. Du kan också utföra mer avancerade åtgärder som att kombinera flera rapporter, ordna om sidor och skydda PDF. Mer information finns i produktdokumentation.

Vad du kan lära dig

I den här praktiska självstudien lär du dig att skapa en onlineutbildningsplattform som gör det möjligt för lärare och elever att enkelt dela resurser i PDF. I den här självstudiekursen används en utbildningsportal som skapats med JavaScript-körningsmiljön Node.js (Node.js) och PDF.

Utbildningsportalen har följande funktioner:

  • Gör det möjligt för lärare att överföra resurser

  • Gör det möjligt för elever att välja flera dokument som ska konverteras till PDF

  • Möjliggör konvertering av dokument till PDF

  • Tillhandahåller en PDF-förhandsgranskning för elever i en webbläsare och gör det möjligt för dem att kommentera dokumenten utan ytterligare program

  • Gör det möjligt för elever att lämna kommentarer och hämta dem till sina datorer

Lär dig hur Adobe Acrobat Services ge dina elever en rik upplevelse av PDF. Acrobat Services API:er integreras smidigt i dina befintliga program så att eleverna kan överföra, konvertera och visa filer, göra och spara kommentarer - allt i din nuvarande konfiguration.

Relevanta API:er och resurser

Överför resurser till utbildningsportalen

I lärarnas avsnitt i utbildningsportalen kan lärarna ladda upp dokument som tilldelningar och tester. Dokumenten kan ha vilket format som helst, t.ex. Microsoft Word, Microsoft Excel, HTML och olika bildformat.

Skärmbild av lärarsektionen i utbildningsportalen

Överförda dokument lagras och visas för eleverna när de öppnar sin webbsida.

Mer information om hur programmet överför filerna finns i projektkod.

Konvertera dokument till PDF

Eleverna kan konvertera enstaka eller flera dokument av olika typ till PDF, t.ex. Microsoft Word, Excel och PowerPoint, samt andra vanliga text- och bildfiltyper. Utbildningsportalen använder PDF-tjänster för att konvertera filer till PDF.

Om du vill skapa en egen utbildningsportal måste du först skapa dina egna inloggningsuppgifter. Registrera dig använda PDF Services API kostnadsfritt i sex månader och upp till 1 000 dokumenttransaktioner. Efter det, betala per användning vid endast $0,05 per dokumenttransaktion när klassen ökar sina tilldelningar.

När en elev väljer ett dokument från instrumentpanelen ser hen följande:

Skärmbild av elevavsnittet i utbildningsportalen

Eleven väljer helt enkelt dokumenten för konvertering och klickar på Hämta rapport.

Utbildningsportalen konverterar dokumenten till PDF och visar en rapportsida tillsammans med en förhandsgranskning av PDF-filen.

Här är exempelkoden för det här steget:

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);
    }
}

Exempelkoden anropar createPdf -metod i Express-flödeshanteraren för att generera PDF.

Mer information om hur den här metoden kallas finns i projektkoden.

Förhandsgranska utbildningsresurserna

Användargränssnittet använder PDF Embed API för att återge PDF i en webbläsare. Detta API är tillgängligt för användning utan kostnad.

PDF Embed API använder andra autentiseringsuppgifter än PDF Services API, så du måste skapa en autentiseringsuppgift
innan du kan använda den. Sedan kan du använda PDF Embed helt gratis.

Se till att du anger rätt webbplats-URL i token. Annars kanske du inte kan återge PDF med token.

Användargränssnittet använder Handtag språk för mallar. Då visas PDF i en webbläsare.

Här är koden för det här steget:

<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>

I koden visas utdata från PDF och länken för att hämta PDF-rapporten, som visas i skärmbilden nedan:

Skärmdump av studentens PDF-förhandsgranskning

Eleverna ska kunna ladda ner rapporten eller arbeta med materialet här.

Anteckna PDF-dokument

En utbildningsplattform bör ha stöd för grundläggande anteckningar, kommentarer och diskussioner i PDF. PDF Embed API har alla dessa funktioner. Det aktiverar anteckningsstöd med showAnnotationTools, så att lärare och elever kan kommentera dokumenten och arkivera kommentarer som en del av PDF.

Om du vill aktivera anteckningar i PDF-dokument behöver du bara skicka argumentet showAnnotationTools : true to the previewFile metod. Då visas anteckningsverktyget i förhandsvisningen i PDF. Det här verktyget kommer du åt från menyn med tre punkter i förhandsvisningens övre högra hörn.

Skärmbild av kommentarverktyg i PDF

I de dokument som lärarna har överfört kan eleverna markera text, lägga till kommentarer och så vidare.

Skärmbild av hur man lägger till kommentarer i PDF

I skärmbilden ovan är användaren märkt Gäst, men du kan konfigurera profiler för användare som elever och lärare.

När en elev använder en kommentar visas ett PDF Embed API-meddelande i Spara knapp längs den övre banderollen. När du sparar läggs anteckningar till i filen. Prova att klicka Spara om du vill se hur filen sparas med anteckningen inbäddad i rapporten.

Elever kan använda anteckningar för att ställa frågor eller dela med sig av sina kommentarer om utbildningsmaterialet.

Spåra dokumentanvändning

Det är viktigt för lärare och skolor att se hur eleverna använder onlineplattformar. Det hjälper lärare att hjälpa sina elever med resurser som hjälper dem att utföra sina uppgifter bättre. PDF Embed API kan integreras med analysfunktioner som du kan använda för att mäta alla händelser som äger rum, till exempel när användare öppnar, läser och stänger dokument. Med PDF Services API kan lärarna även inaktivera utskrift, hämtning och filändringar för att bibehålla den akademiska integriteten.

Om du har en Adobe Analytics licens kan du använda dess färdig integrering. Annars kan du använda återanrop för att integrera PDF-tjänsterna med andra analysleverantörer, till exempel Google.

Om du vill aktivera mätning av dokumenthändelser kopplar du händelsehanterarna med registerCallback metod med Adobe DC View-instans. Du kan visa grundläggande måttangivelser i konsolen, t.ex. om du öppnar ett dokument eller läser en sida. Du kan också spara mätvärdena i en logg eller publicera dem i andra analysarkiv.

Här är exempelkoden för att bifoga händelsehanterare:

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

Lärare kan se hur många elever som har sett uppgiften, hur många som har gått igenom alla sidor i anteckningarna och andra värdefulla detaljer.

Här är en skärmdump av webbläsarkonsolen:

Skärmbild av webbläsarkonsolen

Den här skärmbilden visar att eleven öppnade uppdragsfilen och läste den första sidan. Eleven bläddrade antingen inte vidare till ytterligare sidor eller så hade dokumentet bara en sida och laddade sedan ned filen. Du kan samla in dessa mätvärden för att utföra analyser och studera elevernas beteende.

Dessutom Adobe Analytics är integrerat med PDF Embed API, så om du har ett abonnemang på Adobe Analytics kan du publicera mätvärdena i abonnemanget. Om du vill publicera mätvärdena i Adobe Analytics behöver du bara skicka ditt svit-ID till PDF Embed API-konstruktorn. (Observera att du måste använda dina inloggningsuppgifter för PDF Embed API, inte dina API-inloggningsuppgifter för PDF Services).

Här är exempelkod som visar hur du skickar svit-ID till PDF Embed API-konstruktorn:

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

Nästa steg

I den här praktiska självstudiekursen har vi granskat hur du använder PDF Services API och PDF Embed API för att skapa en utbildningsportal, vilket underlättar effektiv samarbete mellan elever och lärare. Med hjälp av den här portalen kan lärare ladda upp utbildningsmaterial i valfritt format och konvertera det till PDF med hjälp av PDF Services API. Eleverna kan sedan förhandsgranska dessa PDF med hjälp av PDF Embed API.

Nu när du vet hur du lägger till anteckningar i PDF, arkiverar anteckningarna och spårar användningen av PDF-rapporter kan du börja implementera dessa i dina egna projekt.

Du kan använda Adobe Acrobat Services API:er för att skapa användarvänliga, interaktiva PDF-upplevelser på din webbplats. Använd Adobe PDF Services API kostnadsfritt i sex månader och sedan bara betala per användning (via AWS eller ett direktavtal) för endast $0,05 per dokumenttransaktion. Använd Adobe PDF Embed gratis utan tidsbegränsning. Skapa ett kostnadsfritt konto för att kom igång idag.

recommendation-more-help
61c3404d-2baf-407c-beb9-87b95f86ccab