Jobbbokföring

När du driver en webbplats med flera användare är det viktigt att utforma en upplevelse som säkerställer en smidig upplevelse för alla.

Tänk dig följande scenario: du har en webbplats där arbetsgivare kan överföra jobbannonser. För arbetssökande är det bekvämt att enkelt visa alla dokument som rör ett inlägg i ett konsekvent format. Det är dock bekvämt för arbetsgivare att bifoga information i vilket filformat de än råkar ha. Du kan underlätta för båda användartyperna genom att automatiskt konvertera alla uppladdade dokument till PDF och bädda in dem online i inlägget.

Vad du kan lära dig

Den här praktiska självstudiekursen går igenom ett Node.js-exempel som använder Adobe Acrobat Services och dess Node.js SDK för att lägga till de här funktionerna på en webbplats för jobbpublicering. Detta skapar en webbplats som är lättare att använda och mer attraktiv för både arbetsgivare och arbetssökande. Här är den fullständiga projektkoden, om du vill följa med medan du läser.

Konfigurera ett enkelt Express-baserat Node.js-webbprogram för att starta. Express är ett minimalistiskt ramverk för webbprogram med funktioner som routning och mallar. Koden för programmet finns på GitHub. Installera också PostgreSQL-databasen och konfigurera den för att lagra PDF.

Relevanta Acrobat Services API:er

Skapa API-inloggningsuppgifter för Adobe

Först måste du skapa autentiseringsuppgifter för Adobe PDF Embed API (kostnadsfritt att använda) och Adobe PDF Services API (kostnadsfritt i sex månader och sedan betala per användning för bara $0,05 per dokumenttransaktion). När du skapar autentiseringsuppgifter för PDF Services API väljer du alternativet "Skapa personligt kodexempel". Spara ZIP-filen och extrahera pdftools-api-credentials.json och private.key i rotkatalogen i Node.js Express-projektet.

Du behöver också en API-nyckel för det kostnadsfria Embed API:et. Gå till projektet du skapade från Projekt. Klicka sedan på Lägg till i projekt och välj API. Klicka till sist på PDF Embed API.

Ange domänen för PDF Embed API. API-nyckeln måste vara offentlig (den finns i koden som körs av webbläsaren). Genom att ange en domän ser du till att någon annan i en annan domän inte kan använda API-nyckeln.

Du kan inte använda "localhost" som domän. Ange en domän, till exempel "testing.local", och redigera värdfilen på datorn för att omdirigera domänen till 127.0.0.1, som är din dator. I stället för att testa programmet på localhost:3000 kan du sedan testa det på testing.local:3000. Leta reda på API-nyckeln för PDF Embed API på projektsidan när det är klart.

Lägga till ett överföringsformulär och en hanterare

Med ett fungerande Express-program och API-inloggningsuppgifter behöver du också ett formulär som gör att användarna kan överföra sina dokument till webbplatsen. Redigera index.jade-mallen för detta ändamål.

Skapa ett inmatningsfält för namnet på den överförda jobbpubliceringen och för ett dokument som innehåller mer information.

Lägg till följande formulär i mallens innehållsblock:

extends layout

block content
  h1= title

  form(action="/upload", enctype="multipart/form-data", method="POST")
    label Job posting name: 
    input(type="text", name="name", required="required")
    br
    br
    label Describing document: 
    input(type="file", name="attachment", required="required")
    br
    br
    input(type="submit", value="Submit job posting")

Lägg sedan till en hanterare för POSTENS begäran till åtgärden /upload. Lägg sedan till en väg för /upload i filen routes/index.js. Du kan skapa en ny fil för den här vägen, men du måste uppdatera filen app.js så att den speglar den nya filen. I den här flödeshanteraren kan du komma åt det angivna namnet och den överförda filen.

router.post('/upload', async function (req, res, next) {
    const name = req.body.name;
    const fileContents = req.files.attachment.data;

    // code to work with the uploaded document
  });

Funktionen är asynkron så att du kan använda nyckelordet await i funktionen, vilket är praktiskt när du anropar metoderna som utför API-anrop.

Använda PDF Services API

Innan du använder PDF Services API måste du lägga till följande importer överst i filen med flöden:

const PDFToolsSdk = require('@adobe/documentservices-pdftools-node-sdk');
  const { Readable } = require('stream');

Under importen kan du läsa in API-uppgifter och skapa ett körningsinnehåll. Eftersom du kan återanvända en körningskontext för olika åtgärder är det praktiskt att bara göra det en gång.

  const credentials = PDFToolsSdk.Credentials
  .serviceAccountCredentialsBuilder()
  .fromFile("pdftools-api-credentials.json")
  .build();

  const executionContext = PDFToolsSdk.ExecutionContext.create(credentials);

Gå nu tillbaka till att skriva kod i begärandehanteraren vid kommentaren i blocket router.post. Börja med att konvertera dokumentet till PDF.

  const createPdfOperation = PDFToolsSdk.CreatePDF.Operation.createNew();

  const input = PDFToolsSdk.FileRef.createFromStream(Readable.from(fileContents),
  req.files.attachment.mimetype);

  createPdfOperation.setInput(input);

  let result = await createPdfOperation.execute(executionContext);

  result.saveAsFile('output-pdf' + new Date().getTime() + '.pdf');
  return res.send('success!');

De flesta operationer utförs i samma fyra steg. Initiera först åtgärdstypen med metoden createNew för lämplig klass. Skapa sedan indata för åtgärden, som är FileRef. Efterföljande åtgärder kan hoppa över detta steg eftersom resultatet av en åtgärd också är en FileRef. För den här inledande åtgärden skapar du en FileRef från byten i den överförda filen. För det tredje måste du tilldela indata till åtgärden. Slutligen körs åtgärden med körningskontexten som en parameter i körningsmetoden. Den här metoden returnerar ett löfte så att du kan vänta på resultatet.

Den returnerade PDF sparas i en fil och ett enkelt bekräftelsemeddelande skickas till webbläsaren. Delen "Datum" i filnamnet garanterar ett unikt filnamn. SaveAsFile returnerar ett fel om målfilen finns.

Konvertera bilder till text och komprimera PDF

Använd sedan optisk teckenläsning (OCR) för att konvertera bilder till text och komprimera resultatet. Du gör detta med OCR- och CompressPDF-åtgärderna som liknar åtgärden Skapa PDF. Lägg till följande i flödesfilen i router.post:

  const name = req.body.name;
  const fileContents = req.files.attachment.data;

  const createPdfOperation = PDFToolsSdk.CreatePDF.Operation.createNew();
  const input = PDFToolsSdk.FileRef.createFromStream(Readable.from(fileContents),
  req.files.attachment.mimetype);
  createPdfOperation.setInput(input);

  let result = await createPdfOperation.execute(executionContext);

  const ocrOperation = PDFToolsSdk.OCR.Operation.createNew();
  ocrOperation.setInput(result);
  result = await ocrOperation.execute(executionContext);

  const compressPdfOperation = PDFToolsSdk.CompressPDF.Operation.createNew();
  compressPdfOperation.setInput(result);
  result = await compressPdfOperation.execute(executionContext);

  result.saveAsFile('output-pdf' + new Date().getTime() + '.pdf');
  return res.send('success!');

Det är bara nödvändigt att göra denna åtgärd en gång eftersom resultatet är en FileRef, som koden kan skicka till setInput.

Det finns ett bättre alternativ än att spara filen på en hårddisk och returnera ett överförenklat HTTP-svar. Istället kan du lagra PDF i en databas och visa en webbsida som bäddar in PDF med Adobe kostnadsfria PDF Embed API. På så sätt är arbetsgivarens arbetsförmedling synlig på webbplatsen för arbetssökande att hitta och visa, komplett med företagslogotyper och andra designelement.

Lagra PDF i en databas

Lagra PDF i en PostgreSQL-databas. Hämta node-postgres-paketet för att ansluta till Postgres i Node.js. Installera streams-buffers-paketet eftersom du någon gång måste lagra PDF-innehållet i en buffert och FileRef fungerar bara med streams. Så använd paketet stream-buffers för att skriva innehållet till en buffert.

npm install pg stream-buffers

Skapa nu en databastabell för jobbannonser. Den behöver en kolumn för en unik identifierare, en kolumn för ett namn och en kolumn för den kopplade PDF. Du kan skapa en databastabell från kommandoradsgränssnittet i Postgres (CLI):

CREATE TABLE job_postings (id TEXT PRIMARY KEY, name TEXT NOT NULL, attachment
BYTEA NOT NULL);

Gå tillbaka till Node.js-filerna. Lägg till några importer överst i filen:

  const { Client } = require('pg');
  const streamBuffers = require('stream-buffers');

Om du vill lagra PDF i databastabellen ändrar du överföringsfunktionen. Ersätt de två sista raderna (saveAsFile och send) med följande kodfragment:

  const pgClient = new Client();
  pgClient.connect();

  const id = Math.random().toString(36).substr(2, 6); // not securely random at all,
  but serves the purpose for this demo

  const writableStream = new streamBuffers.WritableStreamBuffer();
  writableStream.on("finish", async () => {
    await pgClient.query("INSERT INTO job_postings VALUES ($1, $2, $3)", [
      id,
      name,
      writableStream.getContents()
    ]);
    res.redirect(`/job/${id}`);
  })
  result.writeToStream(writableStream);

Skapa en WritableStreamBuffer för att skriva innehållet. Med avslutningshändelsen är det dags att köra SQL-frågan. Paketet node-postgres konverterar automatiskt Buffer-parametern till BYTEA-formatet. Frågan omdirigerar användaren till /job/{id}, en slutpunkt som skapades senare.

För PDF Embed API behöver du också en slutpunkt som returnerar bara PDF-innehållet:

  router.get('/pdf/:id', async function (req, res, next) {
    const id = req.params.id;

    const pgClient = new Client();
    pgClient.connect();

  const pgResult = await pgClient.query("SELECT attachment FROM job_postings WHERE id
  = $1", [id]);
  const buffer = pgResult.rows[0].attachment;
  res.type('pdf');
    return res.send(buffer);
  });

Bädda in PDF

Skapa nu slutpunkten /job/{id}, som återger en mall som innehåller namnet på den begärda jobbpubliceringen och en inbäddad PDF.

router.get('/job/:id', async function(req, res, next) {
    const id = req.params.id;

    const pgClient = new Client();
    pgClient.connect();

    const pgResult = await pgClient.query("SELECT name FROM job_postings WHERE id =
  $1", [id]);
    const name = pgResult.rows[0].name;

    res.render('job', { pdf_url: `/pdf/${id}`, name });
  });

Skapa en job.jade-fil med följande innehåll i vyer/katalog:

  extends layout

  block content
    h1= name
    div(id='adobe-dc-view')
    script(src='https://documentcloud.adobe.com/view-sdk/main.js')
    script.
      window.embedUrl = "!{pdf_url}";
    script(src='/javascripts/embed-pdf.js')

Det första skriptet är Adobe View SDK, vilket gör det enkelt att bädda in PDF. Det andra skriptet är en infogad one-liner som ställer in värdet på window.embedUrl till URL:en för PDF som tillhandahålls av Express-routningshanteraren. Skapa det tredje skriptet själv så här:

  document.addEventListener("adobe_dc_view_sdk.ready", function () {
    var adobeDCView = new AdobeDC.View({ clientId: "YOUR API KEY HERE", divId:
   "adobe-dc-view" });
    adobeDCView.previewFile({
      content: { location: { url: '//' + window.location.host + window.embedUrl }
         },
      metaData: { fileName: "Job posting" }
    });
  });

Nu kan du testa hela processen med att överföra ett dokument, omdirigeras till sidan /job/id och visa den inbäddade PDF. Användarna går igenom samma steg för att lägga till jobbannonser eller andra dokument på webbplatsen.

Se denna live-demo om du vill se hur en inbäddning fungerar.

Nästa steg

I den här praktiska självstudiekursen går vi igenom hur du använder Node.js med Acrobat Services för att konvertera en uppladdad jobbannons i olika format till en PDF. PDF som blev resultatet bäddades sedan in i en webbsida. Nu kan du lägga till samma funktion på din webbplats, vilket gör det lättare för arbetsgivare att ladda upp arbetsbeskrivningar, broschyrer och annat för arbetssökande att hitta. Dessa funktioner hjälper alla att få den information som behövs för att hitta ett drömjobb.

Acrobat Services hjälper dig att lägga till viktiga funktioner för dokumenthantering på din webbplats eller i din app. Om du vill lära dig mer om vad dessa API:er kan göra kan du läsa följande snabbstartsdokumentation:

Om du vill börja lägga till användarvänliga funktioner för dokumenthantering på din webbplats registrerar du dig för en kostnadsfri provperiod. Adobe PDF Embed API är alltid kostnadsfritt att använda och Adobe PDF Services API är kostnadsfritt i sex månader. Sedan är det bara $0,05 per dokumenttransaktion så att du kan betala allteftersom verksamheten växer.