文件Acrobat Services

管理員工錄用信函

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 中繼
  • 開發人員

使用案例主打橫幅

員工錄用信函是員工在您的組織中擁有的第一批體驗之一。 因此，您想要確保錄取通知是品牌化的，但是您不需要每次都從頭開始在文字處理器中建立字母。 Adobe Acrobat ServicesAPI 提供快速、簡單且有效的方式處理產生和傳送錄用信函給新員工🔗的關鍵部分。

您可以學習哪些內容

此實作教學課程逐步設定 Node Express 專案，該專案會顯示網頁表單，供使用者填入員工詳細資訊。 這些詳細數據會透過 Acrobat Services 網頁產生工作信函作為 PDF，並透過Adobe Sign API傳送給客戶以索取簽名。

相關 API 和資源

  • PDF 服務API

  • Adobe檔產生API

  • Adobe Sign API

  • 檔產生Tagger Word載入巨集

  • 專案範例

快速入門

🔗 Node.js是程式設計平臺。隨附一組龐大的資料庫，例如 Express 網頁伺服器。 下載Node.js 並依照步驟安裝這個絕佳的開放原始碼開發環境。

若要在 Node.js 中使用Adobe檔產生API，請前往 「文件產生API 」網站存取您的帳戶或註冊新的帳戶。 您的帳戶 可以免費使用 6 個月，每次 檔交易只要 $0.05，因此您可以免風險試用，然後只會隨著公司成長支付。

登入 Adobe Developer Console 後，按兩下「 建立新專案」。 依預設，該專案命名為「專案 1」。 按兩下「 編輯專案」 按鈕，然後將名稱變更為「Offer Letter Generator」。 画面中央是「 使用您的新專案 」區段開始使用」 若要為您的項目啟用安全性，請採取下列步驟：

按一下 「新增API」。 您會看到一些 API 可供選擇。 在「依產品篩選」 ​區段中，選​ 取「Document Cloud」，然後按兩下一​ 步。

現在，請產生認證以存取API。 認證的格式為 JSON Web Token （JWT）：安全通訊的開放標準。 如果您熟悉 JWT 且已產生金鑰，您可以在這裡上傳公鑰。 或者，請選取 Option 1 ，讓Adobe為您產生密鑰。

產生認證的螢幕擷圖

按兩下「 產生按鍵」 按鈕。 您有要下載的config.zip檔案。 解壓縮封存盤案。 其中包含兩個檔案：certificate_pub.crt 和 private.key。 確保後者安全無虞，因為後者包含您的私人認證，且可能會用於在超出您的控制範圍的情況下產生挑剔的檔。

按​ 「下一步」。否，啟用對 PDF 產生API的存取權。 在「 選取產品描述檔」畫面上 ，檢查 「企業 PDF 服務開發人員」，然後按下「 儲存已設定的API 」按鈕。 現在您已準備好開始使用API。

設定專案

設定節點專案以執行您的程序代碼。 此範例使用 Visual Studio Code （VS Code） 做為編輯器。 建立名為「字母產生器」的檔案夾，然後在 VS Code 中開啟。 從「 檔案」選 單中，選取 「終端機 > 新終端機 」，以在此檔案夾中開啟殼層。 輸入下列項目，檢查節點是否安裝在路徑上：

node -v

您應該會看到您安裝的節點版本。

現在您已安裝開發環境，您可以繼續建立專案。

首先，使用節點封裝管理員 （npm） 初始化專案。 輸入下列內容：

npm init

系統會詢問您關於節點專案的一些問題。 您可以略過上述大多數問題，但請確認專案名稱為「字母產生器」，且專案輸入點 index.js。 選取 「是 」以完成專案初始化。

您現在有一個package.json檔案。 節點會使用此檔案來組織您的專案。 在建立index.js之前，您必須先新增下列Adobe資料庫
命令：

npm install --save @adobe/documentservices-pdftools-node-sdk

項目中應該會新增一個名為「node_modules的新資料夾。 此檔案夾是下載所有資料庫 （在節點中稱為相依性） 的地方。 系統也會更新package.json檔案，並參照「Adobe PDF服務」。

現在，您想要將 Express 安裝為輕量網頁架構。 輸入下列命令：

npm install express –save

和以前一樣，package.json的相依性區段也會隨之更新。

建立錄取通知範本

現在，在專案根目錄中，建立一個名為「app.js」的檔案。 讓我們將下列入門代碼放入其中：

const express = require('express');
const bodyParser = require('body-parser');
const PDFToolsSdk = require('@adobe/documentservices-pdftools-node-sdk')
const path = require('path');
const app = express();
const port = 8000;
app.use(bodyParser.urlencoded({ extended: true }));
app.get('/', (req, res) => {
res.sendFile(path.join(__dirname + '/index.html'));
});
app.post('/', (req, res) => {
console.log('Got body:', req.body);
res.sendStatus(200);
});
app.listen(port, () => {
console.log(`Candidate offer letter app listening on port ${port}!`)
});

請注意，取得路由會傳回 index.html 檔案。 讓我們建立一個具有該名稱和以下簡單表格的 HTML 檔案。 您可以在稍後看到適合的 CSS 樣式和其他設計元素。 此窗體會提供應聘者產生歡迎信的基本詳細資訊：

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Offer Letter Generator</title>
</head>
<body>
<h1>Enter Candidate Details</h1>
<form action="" method="post">
<div>
<label for="firstname">First name: </label>
<input type="text" name="firstname" id="firstname" required>
</div>
<div>
<label for="lastname">Last name: </label>
<input type="text" name="lastname" id="lastname" required>
</div>
<div>
<label for="salary">Salary ($): </label>
<input type="number" name="salary" id="salary" required>
</div>
<div>
<label for="startdate">Start Date: </label>
<input type="date" name="startdate" id="startdate" required>
</div>
<div>
<input type="submit" value="Generate Letter">
</div>
</form>
</body>
</html>

使用下列命令執行網頁伺服器：

node app.js

您應該會看到「應聘者錄取通知應用程式在埠 8000 上聆聽」訊息。 如果您開啟瀏覽器， http://localhost:8000/表單應如下所示：

網頁窗體的螢幕擷圖

請注意，窗體貼文會自行顯示。 如果填寫資料並按兩下 列資訊， 您應該會在控制臺上看到下列資訊：

Got body: { firstname: 'John',
lastname: 'Doe',
salary: '887888',
startdate: '2021-04-01' }

您會使用網頁服務呼叫來取代此控制台記錄。Acrobat Services首先，您必須根據 JSON 建立資訊模型。 此模型格式如下所示：

{
    "offer_letter": {
    "firstname": "John",
    "lastname": "Doe",
    "salary": "887888",
    "startdate": "2021-04-01"
    }
}

您可以視需要讓這個模型更加精緻，但是對於這個教學課程，請使用這個簡單範例。 此窗體沒有驗證，因為這超出本文的範疇。 若要將表格內文轉換為上述數據模型，請變更 app.post 處理程式方法，以擁有下列程式代碼：

app.post('/', (req, res) => {
const docModel = {'offer_letter': req.body};
generateLetter(docModel);
res.sendStatus(200);
});

第一行可將 JSON 資料轉換為所需的格式。 現在，您將此數據傳遞至 generateLetter 函式。 停止伺服器並在app.js結尾貼上下列程序代碼。 此程式代碼會將 Word 檔作為範本，並以 JSON 檔中的資訊填入佔位元。

// Letter generation function
function generateLetter(jsonDataForMerge) {
try {
// Initial setup, create credentials instance.
const credentials = PDFToolsSdk.Credentials
.serviceAccountCredentialsBuilder()
.fromFile("pdftools-api-credentials.json")
.build();
// Create an ExecutionContext using credentials
const executionContext = PDFToolsSdk.ExecutionContext.create(credentials);
// Create a new DocumentMerge options instance
const documentMerge = PDFToolsSdk.DocumentMerge,
documentMergeOptions = documentMerge.options,
options = new documentMergeOptions.DocumentMergeOptions(jsonDataForMerge,
documentMergeOptions.OutputFormat.PDF);
// Create a new operation instance using the options instance
const documentMergeOperation = documentMerge.Operation.createNew(options)
// Set operation input document template from a source file.
const input = PDFToolsSdk.FileRef.createFromLocalFile(
'resources/OfferLetter-Template.docx');
documentMergeOperation.setInput(input);
// Execute the operation and Save the result to the specified location.
documentMergeOperation.execute(executionContext)
.then(result => result.saveAsFile('output/OfferLetter.pdf'))
.catch(err => {
if(err instanceof PDFToolsSdk.Error.ServiceApiError
|| err instanceof PDFToolsSdk.Error.ServiceUsageError) {
console.log(
'Exception encountered while executing operation', err);
} else {
console.log(
'Exception encountered while executing operation', err);
}
});
} catch (err) {
console.log('Exception encountered while executing operation', err);
}
}

那裡有許多解封程序代碼。 我們先做主控一部分：、documentMergeOperation本區段可讓您擷取 JSON 數據，並將其與 Word 檔範本合併。 您可以在 Adobe 網站上🔗使用範例做為參考，但是讓我們建立您自己的簡單範例。開啟 Word 並建立新的空白檔。 您可以根據需要自訂，但至少具有以下功能：

親愛的 X，

我們很樂意為您提供$X一年的位置。 您的起始日期為 X。

歡迎

將檔另存為「OfferLetter-Template.docx」資料夾中名為「resources」的根目錄。 請注意檔中的三個 X。 這些 X 是 JSON 資訊的臨時佔位元。 雖然您可以使用特殊語法來取代這些佔位元，Adobe提供可簡化此任務的 Word 載入巨集。 若要安裝載入巨集，請前往 Adobe Document Generation Tagger Word 増載入巨集 網站。

在 OfferLetter-Template 中，按下新的 「文件產生」 按鈕。 側邊面板隨即開啟。 按一下 「開始使用」。 系統會為您提供要貼上範例 JSON 數據的文字區域。 從上方將 JSON 的「offer-data」片段複製到文字區域。 其看起來應如下所示：

字母和程式代碼的螢幕擷圖

按兩下「 產生標籤」 按鈕。 您有標籤的下拉式選單，可插入檔案中的適當點。 反白標示檔中的第一個 X，然後選取 第一個名稱。 按兩下 「插入文字 」，「親愛的 X」變更為「親愛的 {{`offer_letter`.firstname}}」。 此標籤為正確格式， 適用於 documentMergeOperation。 請繼續進行，並在適當的 X 上新增其餘三個標籤。 不要忘記儲存OfferLetter-template.docx。 看起來應該像這樣：

親愛的 {{`offer_letter`.firstname}} {{`offer_letter`.lastname}}，

我們很樂意為您提供每年 $ {{`offer_letter`.salary}} 的優惠方案。 您的開始日期為 {{`offer_letter`.startdate}}。

歡迎

現在 Word 範本的標記符合 JSON 格式。 例如， {{`offer_letter`.`firstname`}} 在 Word 檔的開頭，會被 JSON 數據的「firstname」區段中的值所取代。

回到您的 generateLetter 功能。 若要保護 REST 呼叫的安全，請在專案根目錄中建立標題為pdftools-api-credentials.json的新檔案。 貼上下列 JSON 數據，並從開發🔗人員控制台的服務帳戶 （JWT） 區段進行詳細數據調整。

{
"client_credentials": {
"client_id": "<YOUR_CLIENT_ID>",
"client_secret": "<YOUR_CLIENT_SECRET>"
},
"service_account_credentials": {
"organization_id": "<YOUR_ORGANIZATION_ID>",
"account_id": "<YOUR_TECHNICAL_ACCOUNT_ID>",
"private_key_file": "<PRIVATE_KEY_FILE_PATH>"
}
}

  • 您可直接從主控台的 「認證詳細數據 」區段複製用戶端 ID、用戶端密碼和組織 ID。

  • 帳戶 ID 是 技術帳戶 ID。

  • 複製您先前在專案中產生的private.key檔案，並在專案private_key_file區段中輸入其名稱
    pdftools-api-credentials.json檔案。 如有希望，您可以在這裡放置私鑰檔案的路徑。 請記得確保安全，因為一旦超出您的控制範圍，可能會使用錯誤。

若要產生含有已填寫 JSON 數據的 PDF，請返回「 輸入應聘者詳細數據 」網頁窗體，然後發佈一些數據。 由於必須從Adobe下載檔，因此需要一點時間，但您應該將標題為OfferLetter.pdf的檔案放入標題為輸出的新檔案夾中。

後續步驟

就是這樣！ 這隻是一個開始。 如果您研究 Word 載入巨集「檔產生」索引標籤標的「進階」區段，您會注意到並非所有佔位元標記都來自相關的 JSON 數據。 您也可以新增簽名標籤。 這些標籤可讓您將產生的檔上傳至 Adobe Sign ，以傳送給新員工並進行簽署。 閱讀 Adobe Sign 快速入門API瞭解如何進行。 此程式很類似，因為您使用的是以 JWT 字元保護的 REST 呼叫。

當組織必須 跨多個地點僱用 季節性員工時，可以將上述的單一檔範例作為申請的基礎。 如所示，主要流程是透過在線應用程式從求職者獲取數據。 數據用於填入錄用信函的欄位，並傳送以索取電子簽名。

Adobe Acrobat Services可免費使用 6 個月，每🔗份檔交易只需支付 $0.05，因此您可以隨業務成長嘗試並擴充錄取通知工作流程。開始 使用
建立您自己的範本， 註冊您的開發人員帳戶。

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