販売プロセスの迅速化
ホワイトペーパーから契約書、契約書まで、購入プロセス全体を通して数多くの文書が必要です。 このチュートリアルでは、以下の方法を学習します。 Adobe Acrobat Services このジャーニー全体のドキュメントエクスペリエンスを統合して、販売を促進できます。
データから契約書と販売注文を生成
販売契約書、契約、およびその他の文書は、特定の条件に基づいて大幅に異なる場合があります。 例えば、販売契約書には、特定の国や州に居住する、または契約書の一部として特定の製品を含めるなど、固有の基準に基づいて特定の用語のみが含まれる場合があります。 これらの文書を手動で作成したり、多くの異なるテンプレートのバリエーションを維持したりすると、変更を手動で確認するための法律費用が大幅に増加する可能性があります。
Adobe文書生成API crmやその他のデータシステムからデータを取得し、そのデータに基づいて販売ドキュメントを動的に生成できます。
資格情報の取得
まず、無料のAdobe PDFサービスの資格情報を登録します。
-
移動 こちら をクリックして資格情報を登録します。
-
Adobe IDを使用してログインします。
-
資格情報名を設定します(例:販売契約書デモ)。
-
サンプルコードをダウンロードする言語を選択します(例:Node.js)。
-
チェックして同意 デベロッパー条件.
-
選択 資格情報の作成.
サンプルファイル、pdfservices-api-credentials.json、認証用のprivate.keyを含むZIPファイルがコンピューターにダウンロードされます。 -
選択 Microsoft Wordアドインを入手 または AppSource をインストールします。
note note NOTE Wordアドインをインストールするには、Microsoft 365内でアドインをインストールする権限が必要です。 権限がない場合は、Microsoft 365管理者に連絡してください。
データ
特定のデータシステムからデータを取得する場合は、そのデータをJSONデータとして出力するか、独自のスキーマを生成する必要があります。 このシナリオでは、事前に作成された次のサンプルデータセットを使用します。
{
"salesOrder": {
"comment": "Make sure to call 555-555-1234 when you arrive. The front door is broken."
},
"company": {
"name":"Home Services Co.",
"address": {
"city": "Homestead",
"state": "NY",
"zip": "14623",
"streetAddress": "123 Demohome Street"
}
},
"customer": {
"address": {
"city": "Seattle",
"state": "WA",
"zip": "98052",
"streetAddress": "20341 Whitworth Institute 405 N. Whitworth"
},
"email": "mailto:jane-doe@xyz.edu",
"jobTitle": "Professor",
"name": "Jane Doe",
"telephone": "(425) 123-4567",
"url": "http://www.janedoe.com"
},
"tax": {
"state":"WA",
"rate": 0.08
},
"referencesOrder": [
{
"description": "Carpet Cleaning Service - 3BR 2BA",
"totalPaymentDue": {
"price": 359.54
},
"orderedItem": {
"description": "Carpet Cleaning Service"
}
},
{
"description": "Home Cleaning Service - 3BR 2BA",
"totalPaymentDue": {
"price": 299.99
},
"orderedItem": {
"description": "House Cleaning Service"
}
}
]
}
文書に基本的なタグを追加する
このシナリオでは、ダウンロード可能な受注文書が使用されます こちら.
-
を開きます SalesOrder.docx Microsoft Wordのサンプル文書。
-
Document Generationプラグインがインストールされている場合は、 文書の生成 をクリックします。 リボンに「ドキュメントの生成」が表示されない場合は、次の手順を実行します。
-
選択 開始する.
-
上記で記述したJSONサンプルデータを JSONデータ フィールドに入力します。
次に、ドキュメント生成タガーパネルに移動して、ドキュメントにタグを配置します。
-
置換するテキストを選択します(例: 会社名)を参照してください。
-
を 文書生成タガー パネルで、「name」を検索します。
-
タグのリストで、「company」の下の「name」を選択します。
-
選択 テキストを挿入.
このプロセスによって、 {{company.name}} タグはJSON内のパスの下にあるため。
code language-none { … "company": { "name":"Home Services Co.", … }, … }
文書内の追加のタグの一部(番地、市区町村、都道府県、郵便番号など)について、これらのアクションを繰り返します。
生成された文書をプレビューする
Microsoft Word内で直接、サンプルJSONデータに基づいて生成された文書をプレビューできます。
-
を 文書生成タガー パネル、選択 文書を生成. 初めてログインするときには、Adobe IDを使用してログインするように求められる場合があります。 選択 ログイン プロンプトに入力し、資格情報を使用してログインします。
-
選択 文書を表示.
-
ブラウザーウィンドウが開き、ドキュメントの結果をプレビューできます。
元のサンプルデータのデータに置き換えられていた文書内のタグを確認できます。
テンプレートに表を追加する
次のシナリオでは、文書内の表に製品リストを追加します。
-
表を配置する位置にカーソルを挿入します。
-
を 文書生成タガー パネル、選択 詳細.
-
展開 テーブルとリスト.
-
を テーブルレコード フィールド、選択 referencesOrder は、すべての製品アイテムをリストする配列です。
-
「列レコードの選択」フィールドで、含める値を入力します description および totalPaymentDue.price フィールドに入力します。
-
選択 表を挿入.
Microsoft Wordの表の場合と同様に、スタイル、サイズ、その他のパラメーターに合わせて表を編集します。
数値計算の追加
数値計算を使用すると、配列などのデータの集合に基づいて合計やその他の計算を計算できます。 このシナリオでは、小計を計算するフィールドを追加します。
- を選択します 0.00ドル 小計のタイトルの横に表示されます。
- を 文書生成タガー パネル、展開 数値計算.
- 未満 計算タイプを選択 を選択します 集約.
- 未満 タイプを選択 を選択します 合計.
- 未満 レコードの選択 を選択します ReferencesOrder.
- アンダー 集計を実行する項目を選択します 、次を選択 totalPaymentsDue.price*.
- 選択 計算の挿入.
このプロセスでは、値の合計を提供する計算タグが挿入されます。 JSONata計算を使用すると、より高度な計算を行うことができます。 次に例を示します。
-
小計:
${{expr($sum(referencesOrder.totalPaymentDue.price))}}
referencesOrder.totalPaymentDue.priceの合計を計算します。 -
消費税:
${{expr($sum(referencesOrder.totalPaymentDue.price)*0.08)}}
価格を計算し、8%で乗算して税金を計算します。 -
ご請求額:
${{expr($sum(referencesOrder.totalPaymentDue.price)*1.08)}}
価格と1.08の倍数を計算して、小計+税を計算します。
コンディショナル条件を追加
コンディショナルセクションを使用すると、特定の条件が満たされた場合にのみ文や段落を含めることができます。 このシナリオでは、特定の状態に一致するセクションのみが含まれます。
-
ドキュメント内で、というセクションを見つけます。 カリフォルニア州のプライバシーに関する声明.
-
カーソルでセクションを選択します。
-
を 文書生成タガー、選択 詳細.
-
展開 条件付きコンテンツ.
-
を レコードの選択 フィールド、検索、選択 customer.address.state.
-
を 演算子の選択 フィールド、選択 =.
-
を 値フィールド、種類 カルシウム.
-
選択 コンディションを挿入.
「カリフォルニア」セクションは、customer.address.state = CAの場合にのみ生成されたドキュメントに表示されます。
次に、「WASHINGTON PRIVACY STATEMENTS」のセクションを選択して、上記の手順を繰り返し、値「CA」を「WA」に置き換えます。
ダイナミック画像を追加する
Document Generation APIを使用すると、データから画像を動的に挿入できます。 これは、異なるサブブランドがあり、特定の業界でより関連性のあるロゴ、ポートレート画像、または画像を変更する場合に便利です。
画像は、dataまたはbase64コンテンツのURLで渡すことができます。 この例ではURLを使用しています。
-
画像を含める場所にカーソルを置きます。
-
を 文書生成タガー パネル、選択 詳細.
-
展開 画像.
-
を タグを選択 フィールド、選択 logo.
-
を オプションの代替テキスト フィールドに、説明(ロゴ)を入力します。 このプロセスでは、次のような画像プレースホルダーが挿入されます。
ただし、既にレイアウトにある画像に対して動的に画像を設定する場合は、次の操作を実行します。
-
挿入されたプレースホルダー画像を右クリックします。
-
選択 代替テキストを編集.
-
パネルで、次のようなテキストをコピーします。
{ "location-path": "logo", "image-props": { "alt-text": "Logo" }}
-
動的にするドキュメント内の別の画像を選択します。
-
画像を右クリックし、 代替テキストを編集.
-
値をパネルに貼り付けます。
この処理では、画像がデータ内のロゴ変数にある画像に置き換えられます。
Acrobat Signのタグを追加する
Adobe Acrobat Signを使用すると、文書に電子サインを取り込むことができます。 Acrobat Signでは、webインターフェイス内でフィールドを簡単にドラッグ&ドロップできますが、テキストタグを使用して、署名やその他のフィールドの配置を制御することもできます。 AdobeのDocument Generation Taggerを使用すると、これらのテキストタグフィールドを簡単に配置できます。
- サンプル文書で署名が必要な場所に移動します。
- 署名が必要な場所にカーソルを挿入します。
- を Adobe文書生成タガー パネル、選択 Adobe Sign.
- を 受信者数を指定 フィールドに受信者の数を設定します(この例では1です)。
- を 受信者 フィールド、選択 署名者 – 1.
- を フィールド 文字を選択 署名.
- 選択 Adobe Signテキストタグを挿入.
タグが文書に挿入されます。
Acrobat Signには、日付フィールドなど、配置できるその他の種類のフィールドがいくつか用意されています。
- を フィールド 文字を選択 日付.
- 文書内の日付の位置の上にカーソルを移動します。
- 選択 Adobe Signテキストタグを挿入.
契約書を生成
これで文書にタグが付き、作業を開始できます。 次のセクションでは、Node.jsのDocument Generation APIサンプルを使用してドキュメントを生成する方法について説明します。ただし、これらは任意の言語で動作します。
資格情報の登録時にダウンロードしたpdfservices-node-sdk-samples-masterを開きます。 pdfservices-api-credentials.jsonとprivate.keyファイルが含まれている必要があります。
- npm installを使用して依存関係をインストールするターミナルを開きます。
- サンプルdata.jsonをresourcesフォルダーにコピーします。
- Wordテンプレートをresourcesフォルダーにコピーします。
- サンプルフォルダーのルートディレクトリに、 generate-salesOrder.jsという名前の新しいファイルを作成します。
const PDFServicesSdk = require('@adobe/pdfservices-node-sdk');
const fs = require('fs');
const path = require('path');
var dataFileName = path.join('resources', '<INSERT JSON FILE');
var outputFileName = path.join('output', 'salesOrder_'+Date.now()+".pdf");
var inputFileName = path.join('resources', '<INSERT DOCX>');
//Loads credentials from the file that you created.
const credentials = PDFServicesSdk.Credentials
.serviceAccountCredentialsBuilder()
.fromFile("pdfservices-api-credentials.json")
.build();
// Setup input data for the document merge process
const jsonString = fs.readFileSync(dataFileName),
jsonDataForMerge = JSON.parse(jsonString);
// Create an ExecutionContext using credentials
const executionContext = PDFServicesSdk.ExecutionContext.create(credentials);
// Create a new DocumentMerge options instance
const documentMerge = PDFServicesSdk.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 = PDFServicesSdk.FileRef.createFromLocalFile(inputFileName);
documentMergeOperation.setInput(input);
// Execute the operation and Save the result to the specified location.
documentMergeOperation.execute(executionContext)
.then(result => result.saveAsFile(outputFileName))
.catch(err => {
if(err instanceof PDFServicesSdk.Error.ServiceApiError
|| err instanceof PDFServicesSdk.Error.ServiceUsageError) {
console.log('Exception encountered while executing operation', err);
} else {
console.log('Exception encountered while executing operation', err);
}
});
- 置換
<INSERT JSON FILE>
/resources内のJSONファイルの名前を使用します。 - 置換
<INSERT DOCX>
にDOCXファイルの名前を付けます。 - を実行するには、ターミナルを使用してノードgenerate-salesOrder.jsを実行します。
出力ファイルは、正しく生成された文書の/outputフォルダーにある必要があります。
詳細オプション
ドキュメントが生成されたら、次のような追加のアクションを実行できます。
- パスワードで文書を保護
- 画像が大きい場合はPDFを圧縮
- 文書で電子サインをキャプチャ
利用可能なその他のアクションについて詳しくは、サンプルファイルの/srcフォルダーにあるスクリプトを参照してください。 様々なアクションに関するドキュメントを確認して、詳細を確認することもできます。
その他の使用例
Adobe Acrobat Services デジタルドキュメントワークフローにより、販売サイクルの多くの部分を合理化できます。
- Adobe PDF Embed APIを使用すると、Webサイトにホワイトペーパーやその他のコンテンツを埋め込むだけでなく、視聴者の分析結果を測定して収集することもできます
- Acrobat Signを使用して、生成された契約書の電子サインを取得
- Adobe PDF Extract APIを使用して、PDF文書から契約書データを抽出します
さらなる学習
さらに学習したいですか? その他の使用方法を確認する Adobe Acrobat Services:
- 詳細情報: 文書
- Adobe Experience Leagueのその他のチュートリアルを見る
- PDFを活用する方法を確認するには、 /srcフォルダー内のサンプルスクリプトを使用します
- フォロー Adobe技術ブログ 最新のヒントとコツ
- 購入する ペーパークリップ(月間ライブストリーム) を使用したオートメーションについて学習するには Adobe Acrobat Services.=======
- 詳細情報: 文書
- Adobe Experience Leagueのその他のチュートリアルを見る
- PDFを活用する方法を確認するには、 /srcフォルダー内のサンプルスクリプトを使用します
- フォロー Adobe技術ブログ 最新のヒントとコツ
- 購入する ペーパークリップ(月間ライブストリーム) を使用したオートメーションについて学習するには Adobe Acrobat Services