채용 공고
여러 사용자가 함께 웹 사이트를 운영하는 경우 모든 사용자에게 원활한 경험을 제공하는 경험을 디자인하는 것이 중요합니다.
다음 시나리오를 상상해 보십시오. 고용주가 채용 공고를 업로드할 수 있는 웹 사이트가 있습니다. 구직자는 게시물과 관련된 모든 문서를 일관된 형식으로 쉽게 볼 수 있어 편리하다. 그러나 고용주들은 어떤 파일 형식으로든 정보를 첨부하는 것이 편리하다. 두 유형의 사용자 모두에게 편의를 제공하기 위해 업로드된 모든 문서를 자동으로 PDF으로 변환하고 게시물에 인라인 임베드할 수 있습니다.
학습 내용
이 실습형 튜토리얼에서는 Adobe Acrobat Services 및 해당 Node.js SDK를 사용하여 이러한 기능을 채용 공고 사이트에 추가하는 Node.js 예제를 살펴봅니다. 이를 통해 보다 쉽게 사용할 수 있고 고용주와 구직자 모두에게 더 매력적인 웹 사이트를 만들 수 있습니다. 다음은 완료 프로젝트 코드입니다. 읽을 때 따라 이동해야 하는 경우
시작하려면 간단한 Express 기반 Node.js 웹 애플리케이션을 설정합니다. Express은 라우팅 및 템플릿과 같은 기능을 제공하는 미니멀리즘 웹 응용 프로그램 프레임워크입니다. 응용 프로그램의 코드는 GitHub에서 사용할 수 있습니다. 또한 PostgreSQL 데이터베이스를 설치하고 PDF을 저장하도록 설정하십시오.
관련 Acrobat Services개 API
Adobe API 자격 증명 생성 중
먼저, Adobe PDF Embed API(무료 사용) 및 Adobe PDF Services API(6개월 무료, 이후 문서 트랜잭션당 $0.05에 대해 종량제에 대해 자격 증명을 만들어야 합니다. PDF 서비스 API에 대한 자격 증명을 만들 때 "개인화된 코드 샘플 만들기" 옵션을 선택합니다. ZIP 파일을 저장하고 pdftools-api-credentials.json 및 private.key를 Node.js Express 프로젝트의 루트 디렉터리로 추출합니다.
또한 사용 가능한 Embed API에 대한 API 키가 필요합니다. 프로젝트에서 만든 프로젝트로 이동합니다. 그런 다음 프로젝트에 추가 를 클릭하고 API 를 선택합니다. 마지막으로 Embed API PDF 를 클릭합니다.
PDF Embed API의 도메인을 지정합니다. API 키는 public이어야 합니다(브라우저에서 실행한 코드에서 확인). 도메인을 지정하면 다른 도메인의 다른 사용자가 API 키를 사용할 수 없습니다.
"localhost"는 도메인으로 사용할 수 없습니다. "testing.local"과 같은 도메인을 지정하고 컴퓨터에서 hosts 파일을 편집하여 해당 도메인을 사용자 컴퓨터인 127.0.0.1로 리디렉션합니다. 그런 다음 localhost:3000에서 응용 프로그램을 테스트하는 대신 testing.local:3000에서 테스트할 수 있습니다. 완료되면 프로젝트 페이지에서 PDF Embed API에 대한 API 키를 찾습니다.
업로드 양식 및 핸들러 추가
작동하는 Express 애플리케이션 및 API 자격 증명을 사용하면 사용자가 웹 사이트에 문서를 업로드할 수 있는 양식도 필요합니다. 이를 위해 index.jade 템플릿을 편집합니다.
업로드된 채용 공고의 이름 및 추가 정보가 포함된 문서에 대한 입력 필드를 생성합니다.
템플릿의 콘텐츠 블록 내에 다음 양식을 추가합니다.
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")
그런 다음 /upload 작업에 POST 요청에 대한 처리기를 추가합니다. 그런 다음 /upload 경로를 routes/index.js 파일에 추가합니다. 이 경로에 대해 새 파일을 만들 수 있지만 새 파일을 반영하려면 app.js 파일을 업데이트해야 합니다. 이 경로 처리기 내에서 지정된 이름과 업로드된 파일에 액세스할 수 있습니다.
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
});
함수는 비동기적이므로 함수의 await 키워드를 사용할 수 있으므로 API 호출을 수행하는 메서드를 호출할 때 편리합니다.
PDF 서비스 API 사용
PDF 서비스 API를 사용하기 전에 경로 파일의 맨 위에 다음 가져오기를 추가해야 합니다.
const PDFToolsSdk = require('@adobe/documentservices-pdftools-node-sdk');
const { Readable } = require('stream');
가져오기 바로 아래에서 API 자격 증명을 로드하고 실행 콘텐츠를 만들 수 있습니다. 실행 컨텍스트를 다른 작업에 다시 사용할 수 있으므로 한 번만 수행하는 것이 좋습니다.
const credentials = PDFToolsSdk.Credentials
.serviceAccountCredentialsBuilder()
.fromFile("pdftools-api-credentials.json")
.build();
const executionContext = PDFToolsSdk.ExecutionContext.create(credentials);
이제 router.post 블록의 주석에 있는 요청 처리기에서 코드를 작성하기 시작합니다. 먼저 문서를 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!');
대부분의 작업은 동일한 네 단계를 수행합니다. 먼저 해당 클래스의 createNew 메서드를 사용하여 작업 형식을 초기화합니다. 그런 다음 작업에 대한 입력(FileRef)을 생성합니다. 작업의 결과도 FileRef이므로 후속 작업은 이 단계를 건너뛸 수 있습니다. 이 초기 작업의 경우 업로드된 파일의 바이트에서 FileRef를 만듭니다. 셋째, 공정에 입력을 지정해야 합니다. 마지막으로, 작업은 execute 메서드에서 실행 컨텍스트를 매개 변수로 사용하여 실행됩니다. 이 메서드는 결과를 기다릴 수 있도록 Promise를 반환합니다.
코드는 반환된 PDF을 파일에 저장하고 브라우저에 간단한 "성공" 응답을 보냅니다. 파일 이름의 "날짜" 부분은 고유한 파일 이름을 보장합니다. 대상 파일이 있으면 saveAsFile이 오류를 반환합니다.
이미지를 텍스트로 변환하고 PDF 압축
이제 광학 문자 인식(OCR)을 사용하여 이미지를 텍스트로 변환한 다음 결과를 압축합니다. CreatePDF 작업과 유사한 OCR 및 CompressPDF 작업을 사용하여 이 작업을 수행합니다. 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!');
결과가 setInput으로 전달할 수 있는 FileRef이므로 이 작업을 한 번만 수행하면 됩니다.
파일을 하드 디스크에 저장하고 HTTP 응답이 과도하게 단순화된 상태로 반환하는 것보다 더 나은 대안이 있습니다. 대신 Adobe을 데이터베이스에 저장하고 PDF의 무료 PDF Embed API를 사용하여 PDF을 포함하는 웹 페이지를 표시하십시오. 이렇게 하면 구직자가 회사 로고 및 기타 디자인 요소를 완료하여 찾고 볼 수 있도록 고용주의 채용 공고 또는 브로슈어가 웹 사이트에 표시됩니다.
데이터베이스에 PDF 저장
PDF을 PostgreSQL 데이터베이스에 저장합니다. node.js에서 Postgres에 연결하려면 node-postgres 패키지를 가져옵니다. 특정 시점에서 PDF의 내용을 버퍼에 저장해야 하고 FileRef가 스트림에서만 작동하므로 stream-buffers 패키지를 설치합니다. 따라서 스트림 버퍼 패키지를 사용하여 내용을 버퍼에 기록합니다.
npm install pg stream-buffers
이제 채용 공고에 대한 데이터베이스 테이블을 생성합니다. 고유 식별자용 열, 이름용 열 및 첨부된 PDF에 대한 열이 필요합니다. Postgres 명령줄 인터페이스(CLI)에서 데이터베이스 테이블을 생성할 수 있습니다.
CREATE TABLE job_postings (id TEXT PRIMARY KEY, name TEXT NOT NULL, attachment
BYTEA NOT NULL);
Node.js 파일로 돌아갑니다. 파일 위쪽에 가져오기 옵션 추가:
const { Client } = require('pg');
const streamBuffers = require('stream-buffers');
데이터베이스 테이블에 PDF을 저장하려면 업로드 함수를 수정합니다. 마지막 두 줄(saveAsFile 및 send)을 이 코드 조각으로 바꿉니다.
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);
내용을 쓰려면 WritableStreamBuffer를 만듭니다. finish 이벤트를 사용하면 SQL 쿼리를 실행할 시간입니다. node-postgres 패키지는 Buffer 매개 변수를 BYTEA 형식으로 자동 변환합니다. 쿼리가 사용자를 나중에 만든 끝점인 /job/{id}(으)로 리디렉션합니다.
PDF Embed API의 경우 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);
});
PDF 포함
이제 /job/{id} 끝점을 만듭니다. 이 끝점은 요청된 작업 게시의 이름과 포함된 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 });
});
views/ 디렉터리에서 다음 내용으로 job.jade 파일을 만듭니다.
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')
첫 번째 스크립트는 Adobe의 View SDK이며, 이를 통해 PDF을 쉽게 포함할 수 있습니다. 두 번째 스크립트는 in-line one-liner로서 window.embedUrl 값을 Express route 처리기가 제공하는 PDF의 URL로 설정합니다. 다음과 같이 세 번째 스크립트를 직접 만듭니다.
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" }
});
});
이제 문서를 업로드하고 /job/id 페이지로 리디렉션되며 포함된 PDF을 보는 전체 프로세스를 테스트할 수 있습니다. 사용자는 동일한 단계를 통해 채용 공고 또는 기타 문서를 웹 사이트에 추가할 수 있습니다.
업로드된 PDF 문서를 테스트하는
인라인 임베드 동작을 보려면 이 라이브 데모를 확인하세요.
다음 단계
이 실습형 튜토리얼에서는 Acrobat Services과(와) 함께 Node.js를 사용하여 다양한 형식으로 업로드된 채용 공고를 PDF으로 변환하는 방법을 살펴보았습니다. 그 결과 PDF이 웹 페이지에 포함됩니다. 이제 웹사이트에 동일한 기능을 추가하여 고용주가 구직자가 찾을 수 있는 직무 설명, 브로셔 등을 손쉽게 업로드할 수 있습니다. 이러한 역량들은 모든 사람들이 자신의 꿈의 직업을 찾는 데 필요한 정보를 얻을 수 있도록 도와준다.
Acrobat Services을(를) 사용하면 웹 사이트 또는 앱에 주요 문서 처리 기능을 추가할 수 있습니다. 이러한 API로 수행할 수 있는 작업에 대해 자세히 알아보려면 다음 quickstart 설명서를 참조하십시오.
웹 사이트에 친숙한 문서 처리 기능을 추가하려면 무료 체험판에 등록하세요. Adobe PDF Embed API는 항상 무료로 사용할 수 있으며 Adobe PDF Services API는 6개월 동안 무료입니다. 그러면 문서 트랜잭션당 $0.05만 지불하면 비즈니스가 성장함에 따라 사용한 만큼 지불할 수 있습니다.