pdfservices-node-sdk-samples
Samples for the PDF Services Node.js SDK
This sample project helps you get started with the PDF Services Node.js SDK.
The sample JS scripts illustrate how to perform PDF-related actions (such as converting to and from the PDF format) using
the SDK. Please note that the PDF Services Node.js SDK supports only server side use cases.
Prerequisites
The sample application has the following requirements:
-
Node.js : Version 14.0 or above. Node installation instructions can be found
here.
Authentication Setup
The credentials file and corresponding private key file for the samples is pdfservices-api-credentials.json
and private.key
respectively. Before the samples can be run, replace both the files with the ones present in the downloaded zip file at
the end of creation of credentials via Get Started workflow.
The SDK also supports providing the authentication credentials at runtime, without storing them in a config file. Please
refer this section to
know more.
Quota Exhaustion
If you receive ServiceUsageError during the Samples run, it means that trial credentials have exhausted their usage quota.
Please contact us to get paid credentials.
Build with npm
Run the following command to build the project:
npm install
Note that the PDF Services SDK is listed as a dependency in the package.json and will be downloaded automatically.
A Note on Logging
For logging, this SDK uses the log4js API .
Upon running, the SDK searches for a file config/pdfservices-sdk-log4js-config.json
in the working directory, and reads the
logging properties from there. If no configuration file is provided, default logging, i.e. logging INFO logs to the console is enabled. The clients can change the logging settings as per their needs.
Running the samples
The following sub-sections describe how to run the samples. Prior to running the samples, check that the configuration
file is set up as described above and that the project has been built.
The samples code is available under the src
folder. Test
files used by the samples can be found in the resources
folder. When executed, all samples create an output
child folder under the project root directory to store their results.
Create a PDF File
These samples illustrate how to convert files of some formats to PDF. Refer the sdk documentation of create-pdf-operation.js
to see the list of all supported media types which can be converted to PDF.
Create a PDF File From a DOCX File
The sample script create-pdf-from-docx.js
creates a PDF file from a DOCX file.
node src/createpdf/create-pdf-from-docx.js
Create a PDF File From a DOCX File with options
The sample script create-pdf-from-docx-with-options.js
creates a PDF file from a DOCX file by setting documentLanguage as
the language of input file.
node src/createpdf/create-pdf-from-docx-with-options.js
Create a PDF File From a DOCX Readable Stream
The sample script create-pdf-from-docx-stream.js
creates a PDF file from a readable DOCX stream.
node src/createpdf/create-pdf-from-docx-stream.js
Create a PDF File From a DOCX File (Write to an OutputStream)
The sample script create-pdf-from-docx-to-output-stream.js
creates a PDF file from a DOCX file. Instead of saving the result to a
local file, it writes the result to an output stream.
node src/createpdf/create-pdf-from-docx-to-output-stream.js
Create a PDF File From a DOCX File (By providing in-memory Authentication credentials)
The sample script create-pdf-with-inmemory-auth-credentials.js
highlights how to provide in-memory auth credentials
for performing an operation. This enables the clients to fetch the credentials from a secret server during runtime,
instead of storing them in a file.
Before running the sample, authentication credentials need to be updated as per the instructions in the script.
node src/createpdf/create-pdf-with-inmemory-auth-credentials.js
Create a PDF File From a DOCX File(By providing custom value for timeouts)
The sample script create-pdf-with-custom-timeouts
highlights how to provide the custom value for connection timeout and read timeout.
node src/createpdf/create-pdf-with-custom-timeouts.js
Create a PDF File From a PPTX File
The sample script create-pdf-from-pptx.js
creates a PDF file from a PPTX file.
node src/createpdf/create-pdf-from-pptx.js
Create a PDF File From Static HTML (via Zip Archive)
The sample script create-pdf-from-static-html.js
creates a PDF file from a zip file containing the input HTML file and its resources.
Please refer the sdk documentation of create-pdf-operation.js to see instructions on the structure of the zip file.
node src/createpdf/create-pdf-from-static-html.js
Create a PDF File From Static HTML file with inline CSS
The sample script create-pdf-from-html-with-inline-css.js
creates a PDF file from an input HTML file with inline CSS.
node src/createpdf/create-pdf-from-html-with-inline-css.js
Create a PDF File From HTML specified via URL
The sample script create-pdf-from-url.js
creates a PDF file from an HTML specified via URL.
node src/createpdf/create-pdf-from-url.js
Create a PDF File From Dynamic HTML (via Zip Archive)
The sample script create-pdf-from-dynamic-html.js
converts a zip file, containing the input HTML file and its resources, along with the input data to a PDF file. The input data is used by the javascript in the HTML file to manipulate the HTML DOM, thus effectively updating the source HTML file. This mechanism can be used to provide data to the template HTML dynamically and then, convert it into a PDF file.
node src/createpdf/create-pdf-from-dynamic-html.js
Export PDF To Other Formats
These samples illustrate how to export PDF files to other formats. Refer to the documentation of export-pdf-operation.js
and export-pdf-to-images-operation.js for supported export formats.
Export a PDF File To a DOCX File
The sample script export-pdf-to-docx.js
converts a PDF file to a DOCX file.
node src/exportpdf/export-pdf-to-docx.js
Export a PDF file to a DOCX file (apply OCR on the PDF file)
The sample script export-pdf-to-docx-with-ocr-options.js
converts a PDF file to a DOCX file. OCR processing is also performed on the input PDF file to extract text from images in the document.
node src/exportpdf/export-pdf-to-docx-with-ocr-options.js
Export a PDF File To an Image Format (JPEG)
The sample script export-pdf-to-jpeg.js
converts a PDF file’s pages to a list of JPEG images.
node src/exportpdftoimages/export-pdf-to-jpeg.js
Export a PDF File To a Zip of Images (JPEG)
The sample script export-pdf-to-jpeg-zip.js
converts a PDF file’s pages to JPEG images. The resulting file is a ZIP archive containing one image per page of the source PDF file.
node src/exportpdftoimages/export-pdf-to-jpeg-zip.js
Combine PDF Files
These samples illustrate how to combine multiple PDF files into a single PDF file.
Combine Multiple PDF Files
The sample script combine-pdf.js
combines multiple PDF files into a single PDF file. The combined PDF file contains all pages
of the source files.
node src/combinepdf/combine-pdf.js
Combine Specific Pages of Multiple PDF Files
The sample script combine-pdf-with-page-ranges.js
combines specific pages of multiple PDF files into into a single PDF file.
node src/combinepdf/combine-pdf-with-page-ranges.js
OCR PDF File
These samples illustrate how to apply OCR(Optical Character Recognition) to a PDF file and convert it to a searchable copy of your PDF.
The supported input format is application/pdf.
Convert a PDF File into a Searchable PDF File
The sample script ocr-pdf.js
converts a PDF file into a searchable PDF file.
node src/ocr/ocr-pdf.js
Convert a PDF File into a Searchable PDF File while keeping the original image
The sample script ocr-pdf-with-options.js
converts a PDF file to a searchable PDF file with maximum fidelity to the original image and default en-us locale. Refer to the documentation of ocr-options.js
to see the list of supported OCR locales and OCR types.
node src/ocr/ocr-pdf-with-options.js
Compress PDF File
The…