Lançamento de trabalho

Ao operar um site com vários usuários, é crucial criar uma experiência que garanta uma experiência tranquila para todos.

Imagine o seguinte cenário: você tem um site que permite aos empregadores carregar publicações de trabalho. Para candidatos a emprego, é conveniente visualizar facilmente todos os documentos relacionados a uma publicação em um formato consistente. No entanto, é conveniente para os empregadores anexar informações em qualquer formato de arquivo que eles tenham. Para oferecer conveniência a ambos os tipos de usuários, você pode converter automaticamente todos os documentos carregados em PDF e incorporá-los em linha na publicação.

O que você pode aprender

Este tutorial prático percorre um exemplo de Node.js que usa o Adobe Acrobat Services e seu SDK do Node.js para adicionar esses recursos a um site de publicação de trabalhos. Isto cria um site que é mais fácil de usar e mais atraente para os empregadores e candidatos a emprego. Aqui está o 🔗código de projeto completo, caso você queira acompanhar enquanto lê.

Para iniciar, configure um aplicativo Web Node.js simples com base em Express. O Express é uma estrutura de aplicativo Web minimalista que oferece recursos como roteamento e modelagem. O código do aplicativo está disponível em GitHub. Além disso, instale o banco de dados PostgreSQL e configure-o para armazenar o PDF.

Acrobat Services APIs relevantes

Criação de credenciais de API do Adobe

Primeiro, você deve criar credenciais para a API incorporada do Adobe PDF (gratuita para uso) e a API de serviços do Adobe PDF (gratuita para seis meses e depois pagar conforme usa por apenas $0,05 por transação de documento). Ao criar credenciais para a API de Serviços do PDF, selecione a opção “Criar amostra de código personalizada”. Salve o arquivo ZIP e extraia pdftools-api-credentials.json e private.key no diretório raiz do projeto Node.js Express.

Você também precisa de uma chave de API para a API incorporada disponível gratuitamente. Em Projetos, vá para o projeto que você criou. Depois, clique em Adicionar ao Projeto e selecione API. Por fim, clique em API de PDF incorporado.

Especifique o domínio para a API de PDF incorporada. A chave de API deve ser pública (encontre-a no código executado pelo navegador). Ao especificar um domínio, você garante que outra pessoa em um domínio diferente não possa usar a chave de API.

Você não pode usar “localhost” como um domínio. Especifique um domínio, como “testing.local”, e edite o arquivo hosts no computador para redirecionar esse domínio para 127.0.0.1, que é o seu computador. Então, em vez de testar seu aplicativo em localhost:3000, você pode testá-lo em testing.local:3000. Quando terminar, encontre a chave de API para PDF Embed API na página do projeto.

Adicionando um formulário de upload e manipulador

Com um aplicativo Express e credenciais de API em funcionamento, você também precisa de um formulário que permita aos usuários fazer upload de seus documentos no site. Edite o modelo index.jade para essa finalidade.

Crie um campo de entrada para o nome da publicação de trabalho carregada e para um documento que contenha mais informações.

Dentro do bloco de conteúdo do modelo, adicione o seguinte formulário:

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

Em seguida, adicione um manipulador para a solicitação POST à ação /upload. Em seguida, adicione uma rota para /upload para o arquivo routes/index.js. Você pode criar um novo arquivo para esta rota, mas terá que atualizar o arquivo app.js para refletir o novo arquivo. Dentro deste manipulador de rotas, você pode acessar o nome fornecido e o arquivo carregado.

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

A função é assíncrona, portanto você pode usar a palavra-chave await na função, o que é conveniente ao chamar os métodos que executam chamadas de API.

Uso da API de serviços de PDF

Antes de usar a API de Serviços PDF, você deve adicionar as seguintes importações à parte superior do arquivo de rotas:

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

Logo abaixo das importações, você pode carregar credenciais de API e criar um conteúdo de execução. Como é possível reutilizar um contexto de execução para diferentes operações, faz sentido executá-lo somente uma vez.

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

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

Agora, volte para escrever código no manipulador de solicitações no comentário no bloco router.post. Comece convertendo o documento em 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!');

A maioria das operações realiza os mesmos quatro passos. Primeiro, inicialize o tipo de operação, usando o método createNew da classe apropriada. Em seguida, crie a entrada para a operação, que é FileRef. As operações subsequentes podem ignorar esta etapa porque o resultado de uma operação também é um FileRef. Para esta operação inicial, crie um FileRef dos bytes do arquivo carregado. Terceiro, você deve atribuir a entrada à operação. Finalmente, a operação é executada, com o contexto de execução como um parâmetro no método execute. Esse método retorna uma Promessa para que você possa aguardar o resultado.

O código salva o PDF retornado em um arquivo e envia uma resposta simples de “sucesso” ao navegador. A parte “Data” do nome de arquivo garante um nome de arquivo exclusivo. O saveAsFile retorna um erro se o arquivo de destino existir.

Conversão de imagens em texto e compactação do PDF

Agora, use o reconhecimento óptico de caracteres (OCR) para converter imagens em texto e compactar o resultado. Para fazer isso, use as operações de OCR e Compactar PDF semelhantes à operação Criar PDF. Adicione o seguinte ao arquivo de rotas, em 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!');

Só é necessário fazer essa operação uma vez porque o resultado é um FileRef, que o código pode passar para setInput.

Há uma alternativa melhor do que salvar o arquivo em um disco rígido e retornar uma resposta HTTP supersimplificada. Em vez disso, armazene o PDF em um banco de dados e exiba uma página da Web que incorpora o PDF usando a API de incorporação de PDF livre de Adobe. Dessa forma, a publicação ou folheto de trabalho do empregador fica visível no site para que os candidatos a emprego encontrem e visualizem, com logotipos da empresa e outros elementos de design.

Armazenando o PDF em um banco de dados

Armazene os PDF em um banco de dados PostgreSQL. Obtenha o pacote node-postgres para conectar-se ao Postgres no Node.js. Instale o pacote stream-buffers porque, em algum momento, você deve armazenar o conteúdo do PDF em um buffer, e FileRef funciona apenas com fluxos. Assim, use o pacote stream-buffers para gravar o conteúdo em um buffer.

npm install pg stream-buffers

Agora, crie uma tabela de banco de dados para publicações de trabalhos. É necessária uma coluna para um identificador exclusivo, uma coluna para um nome e uma coluna para o PDF anexado. Você pode criar uma tabela de banco de dados a partir da interface de linha de comando (CLI) do Postgres:

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

Volte para os arquivos Node.js. Adicione algumas importações na parte superior do arquivo:

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

Para armazenar o PDF na tabela de banco de dados, modifique a função de upload. Substitua as duas últimas linhas (saveAsFile e send) por este trecho de código:

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

Para gravar o conteúdo, crie um WritableStreamBuffer. Com o evento finish, é hora de executar a consulta SQL. O pacote node-postgres converte automaticamente o parâmetro Buffer para o formato BYTEA. A consulta redireciona o usuário para /job/{id}, um ponto de extremidade criado posteriormente.

Para a API incorporada de PDF, você também precisa de um ponto de extremidade que retorne apenas o conteúdo do PDF:

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

Incorporando o PDF

Agora, crie o ponto de extremidade /job/{id}, que renderiza um modelo contendo o nome da publicação de trabalho solicitada e um PDF incorporado.

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

No diretório views/, crie um arquivo job.jade com este conteúdo:

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

O primeiro script é o SDK Adobe View, que facilita a incorporação do PDF. O segundo script é um enlace único em linha que define o valor de window.embedUrl para o URL do PDF fornecido pelo manipulador de rota Express. Crie o terceiro script da seguinte maneira:

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

Agora, você pode testar todo o processo de upload de um documento, sendo redirecionado para a página /job/id e visualizando o PDF incorporado. Seus usuários seguem as mesmas etapas para adicionar uma publicação de trabalho ou outro documento ao seu site.

Para ver uma incorporação em linha em ação, confira esta demonstração ao vivo.

Próximas etapas

Este tutorial prático abordou como usar o Node.js com Acrobat Services para converter uma publicação de trabalho carregada em vários formatos em um PDF. O PDF resultante foi então incorporado em uma página da Web. Agora você pode adicionar a mesma função ao seu site, facilitando o upload de descrições de cargos, folhetos e muito mais para os candidatos a emprego encontrarem. Esses recursos ajudam todos a obter as informações necessárias para encontrar o emprego dos seus sonhos.

O Acrobat Services ajuda a adicionar funções importantes de manuseio de documentos ao seu site ou aplicativo. Se quiser aprofundar-se no que essas APIs podem fazer, consulte a seguinte documentação do quickstart:

Para começar a adicionar recursos amigáveis de manuseio de documentos ao seu site, inscreva-se para o teste grátis. A API incorporada do Adobe PDF é sempre gratuita e a API de serviços do Adobe PDF é gratuita por seis meses; basta 0,05 por transação de documento para que você possa pagar conforme crescer na sua empresa.