diff --git a/gatsby-browser.js b/gatsby-browser.js index 9e1391723..3d146e8c7 100644 --- a/gatsby-browser.js +++ b/gatsby-browser.js @@ -411,9 +411,11 @@ export const onRouteUpdate = ({ location, prevLocation }) => { ) { pageHeadTittle = "PDF Electronic Seal API Prerequisites"; } - }else if (window.location.pathname.indexOf("overview/") >= 0) { + } else if ( + window.location.pathname.indexOf("overview/") >= 0 + ) { pageHeadTittle = "Overview Introduction"; - } + } if (pageHeadTittle != null) { document .querySelector("footer") diff --git a/gatsby-config.js b/gatsby-config.js index cc1770fcd..fefdd2877 100644 --- a/gatsby-config.js +++ b/gatsby-config.js @@ -276,6 +276,10 @@ module.exports = { { title: 'PDF Electronic Seal', path: 'overview/pdf-services-api/howtos/electronic-seal-api.md' + }, + { + title: 'PDF Watermark', + path: 'overview/pdf-services-api/howtos/pdf-watermark-api.md' } ] } @@ -568,6 +572,10 @@ module.exports = { title: 'Support', path: 'overview/support.md' }, + { + title: 'FAQ', + path: 'overview/faq.md' + }, { title: 'API Status', path: 'overview/status.md' diff --git a/src/pages/overview/faq.md b/src/pages/overview/faq.md new file mode 100644 index 000000000..ab22deb9f --- /dev/null +++ b/src/pages/overview/faq.md @@ -0,0 +1,41 @@ +--- +title: FAQ +--- + +# Frequently Asked Questions (FAQ) + +## 1. How can I get access to Adobe PDF Services API Free Tier if I am using company or school account? + +Invoking PDF Services API requires an Adobe-provided credential. To get one, [click here](https://acrobatservices.adobe.com/dc-integration-creation-app-cdn/main.html?api=pdf-services-api), and complete the workflow. + +#### Step 1: + +**Sign out** if you receive the message, “You don’t have access to PDF Services API”. + +![entp signup failure](./images/entp-singup-failure.jpg) + +#### Step 2: + +**Click on** "Get Credentials" button. + +![get credentials image](./images/get-creds-btn.png) + +#### Step 3: + +**Click on** "Create an account", and **Sign up** using same email. + +![create account](./images/create-account.png) + +#### Step 4: + +**Select** "Personal Account" under account types. + +![personal account](./images/personal-account.jpg) + +#### Step 5: + +**Select** "Personal Profile" to sign in. + +![personal profile](./images/personal-profile.jpg) + +Now you should be able to create credentials to get access to the Adobe PDF Services API Free Tier! \ No newline at end of file diff --git a/src/pages/overview/images/create-account.png b/src/pages/overview/images/create-account.png new file mode 100644 index 000000000..988c94905 Binary files /dev/null and b/src/pages/overview/images/create-account.png differ diff --git a/src/pages/overview/images/entp-singup-failure.jpg b/src/pages/overview/images/entp-singup-failure.jpg new file mode 100644 index 000000000..10aa2731f Binary files /dev/null and b/src/pages/overview/images/entp-singup-failure.jpg differ diff --git a/src/pages/overview/images/get-creds-btn.png b/src/pages/overview/images/get-creds-btn.png new file mode 100644 index 000000000..4860fe76e Binary files /dev/null and b/src/pages/overview/images/get-creds-btn.png differ diff --git a/src/pages/overview/images/personal-account.jpg b/src/pages/overview/images/personal-account.jpg new file mode 100644 index 000000000..98940d7e0 Binary files /dev/null and b/src/pages/overview/images/personal-account.jpg differ diff --git a/src/pages/overview/images/personal-profile.jpg b/src/pages/overview/images/personal-profile.jpg new file mode 100644 index 000000000..3ad34867d Binary files /dev/null and b/src/pages/overview/images/personal-profile.jpg differ diff --git a/src/pages/overview/legacy-documentation/pdf-services-api/releasenotes.md b/src/pages/overview/legacy-documentation/pdf-services-api/releasenotes.md index 0a908263a..46259cf30 100644 --- a/src/pages/overview/legacy-documentation/pdf-services-api/releasenotes.md +++ b/src/pages/overview/legacy-documentation/pdf-services-api/releasenotes.md @@ -1,11 +1,54 @@ --- -title: Release Notes | PDF Services API | Adobe PDF Services +title: Version and Release Notes --- -# Release Notes -This document describes the change history across releases for supported -versions. For details regarding versioning and support policies, see -[Version - Support policy](../pdf-services-api/policies.md). +# Version - Support policy + +This document describes the PDF Services SDK's and Public API's +versioning and support policies. + +## SDK + +### Versioning scheme + +The SDK has a version format of \#.\#.\# (e.g. 1.1.0) where the numbers +correspond to a major release, minor release, and patch/update +(Major.Minor.Patch). Releases are defined as follows: + +- **Major Releases (1.x.x)**: Major releases introduce + backward-incompatible changes to the APIs and interfaces and start + the EOL clock for all previous releases. Developers should plan on + migrating their code prior to the end of life of the previous major + release. +- **Minor Releases (x.1.x)**: Minor releases typically appear + quarterly. Changes are backward compatible to the last major + release. Minor releases introduce new interfaces. Existing + interfaces continue to function but some interfaces may be + deprecated; deprecated interfaces will be removed in a next major + release. +- **Patch Releases (x.x.1)**: Patch releases only deliver critical + security or bug fixes as needed. Patch release changes are rolled + into the next minor release so that developers can update and deploy + new code based on their business requirements. + +## Public API + +### Versioning + +As mentioned on [Public API +Docs](../../apis), +each operation has a unique assetId which is passed in Form Parameters. +Generally, APIs will be enhanced while keeping them backward compatible. +If its functionality can't be enhanced without breaking changes, then +its new version will be released with its own unique assetId. The +supported older API versions info will be present on [Public API +Docs](https://documentcloud.adobe.com/document-services/index.html) + +Additionally, the output for the PDF Extract API is generated by a +machine learning pipeline that is frequently trained to improve +inference of document layout and structure.As a result, while changes to +the output structure are not expected between versions, specific results +may vary as the model output improves. ## Supported versions @@ -27,7 +70,7 @@ repo as follows: ## Migration Guide to PDF Services SDK Refer to the following table for migrating to PDF Services SDK version -2.1.0, you can also refer our Samples( +3.4.0, you can also refer our Samples( [Java](https://www.adobe.com/go/pdftoolsapi_java_samples), [Node JS](https://www.adobe.com/go/pdftoolsapi_node_sample), [.NET](https://www.adobe.com/go/pdftoolsapi_net_samples)). for the @@ -48,10 +91,10 @@ version. ``` UTF-8 - 1.8 - 1.8 - 2.1.0 - 2.1.0 + 11 + 11 + 4.1.0 + 4.1.0 @@ -71,9 +114,9 @@ import com.adobe.pdfservices.operation.ExecutionContext; * NPM package name changed from `@adobe/documentservices-pdftools-node-sdk` to `@adobe/pdfservices-node-sdk` * Update the latest SDK dependency in package.json file of your project - + ``` -"@adobe/pdfservices-node-sdk": "2.1.0" +"@adobe/pdfservices-node-sdk": "4.0.1" ``` * Require the `@adobe/pdfservices-node-sdk` in the Sample file to access the SDK interface @@ -82,7 +125,7 @@ import com.adobe.pdfservices.operation.ExecutionContext; const PDFServicesSdk = require('@adobe/pdfservices-node-sdk'); ``` - + For HTML to PDF Conversions, the PageLayout object is moved inside html object. To access the PageLayout interface use the following code: ``` @@ -97,43 +140,286 @@ const pageLayout = new PDFServicesSdk.CreatePDF.options.html.PageLayout(); ``` - + ``` -* Update the namespaces accordingly in your .cs file as per the new dependency: +* Update the namespaces accordingly in your .cs file as per the new dependency: ```javascript using Adobe.PDFServicesSDK; ``` +### Python changes + +* Add the following dependency in your project’s requirements.txt file: + +``` +pdfservices-sdk~=4.0.0 +``` + + ## Change types Change types include the following: - **New**: Features or implementation changes added in the current - release. + release. - **Changed**: Modified code that changes a feature or implementation - detail. + detail. - **Security**: A patch or bug fixed released in an out-of-band patch. - **Deprecated**: Existing functionality for which support is ending - (or ended). + (or ended). -The new release is backward compatible with the previous release. +Minor and Patch releases are backward compatible with the previous release. Upgrading to the latest SDK should not break existing applications. ## Change history +### 4.0.1 (June 12, 2024; patch release) + +| Change | Language | Description | +|---------|----------|---------------------------------------| +| Changed | NodeJS | Bug fixes and stability improvements. | + +### 3.5.1 (June 05, 2024; patch release) + +| Change | Language | Description | +|---------|----------|---------------------------------------| +| Changed | .NET | Bug fixes and stability improvements. | + +### 4.1.0 (June 04, 2024: minor release) + +| Change | Language | Description | +|--------|----------|------------------------------------------------------------------| +| New | Java | Extend support for external storage and notifier config for all the operations. | + + +### 4.0.0 (May 22, 2024; major release) + +| Change | Language | Description | +|---------|----------|---------------------------------------------------------------------------------------------------------------------------------| +| New | Python | Released Adobe PDF Services Python SDK v4.0.0, introducing new interfaces fully leveraging power of new PDF Services REST APIs. | +| New | Python | Added support for all the operations powered by the Adobe PDF Services APIs. | +| New | Python | Added support for deleting assets and webhook notifiers. | +| New | Python | Removed the need for intermediate result storage for chained operations by eliminating reliance on temporary local storage. | +| New | Python | Extended I/O capabilities by introducing external storage for PDF Services operations. | +| New | Python | Enabled connection to Internet through Proxy, where proxy server settings can be set via Proxy Server Config. | + +### 3.5.0 (May 15, 2024: minor release) + +| Change | Language | Description | +|--------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| New | .NET | Added support to enable or disable "configureAwait" using client config, which will allow developers to specify whether asynchronous continuations should execute on the original synchronization context or not. **Note**: Starting from the next major release, "configureAwait" will be disabled by default and won't be configurable. | + + +### Adobe Document Generation Server Side Release (April 30, 2024: server side release) + +| Change | Language | Description | +|---------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| New | All | Added support for [discard the row in a horizontal table](../document-generation-api/tablewithmarkers/#discard-the-row-in-a-horizontal-table-if-the-condition-evaluates-to-true) in Document Generation API. | + +### 4.0.0 (April, 2024; major release) + +| Change | Language | Description | +|---------|----------|------------------------------------------------------------------------------------------------------------------------------------| +| New | NodeJS | Released Adobe PDF Services Node SDK v4.0.0, introducing new interfaces fully leveraging power of new PDF Services rest APIs. | +| New | NodeJS | Added support for delete asset and webhook notifiers. | +| New | NodeJS | Eliminated need of storage to save intermediate result by removing dependency on temporary storage. | +| New | NodeJS | Extended I/O capabilities by introducing external storage for PDF Services operations. | +| New | NodeJS | Enabled connection to Internet through Proxy, where proxy server settings can be set via "proxyServerConfig" in the client config. | +| Changed | NodeJS | Updated PDF Properties operation to return PDFProperties object along with JSON string. | +| Changed | NodeJS | Updated Extract PDF operation to return content and resource asset along with content JSON object. | + +### Server Side Release (April, 2024; server side release) + +| Change | Language | Description | +|--------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------| +| New | API | Added support for [Webhook Notification](../pdf-services-api/howtos/webhook-notification/) in PDF Properties. | +| New | API | Added support for [External Storage](../pdf-services-api/howtos/pdf-external-storage-sol/) in Extract PDF, Split PDF, PDF Electronic Seal and Auto-Tag PDF. | +| New | API | Added support for [Webhook Notification](../pdf-services-api/howtos/webhook-notification/) for external storage operations. | + +### 2.3.1 (March, 2024; patch release) + +| Change | Language | Description | +|---------|------------------|---------------------------------------------------------------------------------------------------------------------------------| +| New | Python | PDF operations now support configurable timeouts. | + +### 3.4.1 (February, 2024: patch release) + +| Change | Language | Description | +|---------|----------|---------------------------------------------------------------------------------| +| Changed | .NET | Dependent library upgrades and fixed compatibility issues with RestSharp v110+. | + + +### 4.0.0 (January, 2024; major release) +| Change | Language | Description | +|---------|----------|-------------------------------------------------------------------------------------------------------------------------------| +| New | Java | Released Adobe PDF Services Java SDK v4.0.0, introducing new interfaces fully leveraging power of new PDF Services rest APIs. | +| New | Java | Added support for delete asset, refresh download URI, webhook notifiers. | +| New | Java | Eliminated need of storage to save intermediate result by removing dependency on temporary storage. | +| New | Java | Extended I/O capabilities by introducing external storage for a majority of PDF Services operations. | +| Changed | Java | Updated PDF Properties operation to return PDFProperties object along with JSON string. | +| Changed | Java | Updated Extract PDF operation to return content and resource asset along with content JSON object. | + + +### Server Side Release (January, 2024; server side release) + +| Change | Language | Description | +|--------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| New | API | Added support for [Webhook Notification](../pdf-services-api/howtos/webhook-notification/) in all the operations **except** PDF Properties. | + +### Adobe Document Generation Server Side Release (January, 2024: server side release) + +| Change | Language | Description | +|---------|----------|--------------------------------------------------------------------------------------------------------| +| Changed | All | Added support for [Table Tag with Markers](../document-generation-api/tablewithmarkers) in Document Generation API. | + +### 3.5.1 (December, 2023: patch release) + +| Change | Language | Description | +|---------|----------|----------------------------------------------------------------------------------| +| Changed | Java | Dependent library upgrades and fixed compatibility issues with Spring Boot v3.x. | + + +### 3.5.0 (October, 2023: minor release) + +| Change | Language | Description | +|---------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| Changed | Java | Added support for document level permissions and trusted timestamping (using [supported TSAs](../pdf-electronic-seal-api/#supported-timestamping-authorities)) in java sdk for [PDF Electronic Seal API](../pdf-electronic-seal-api/). | + +### Adobe Document Generation Server Side Release (October, 2023; server side release) + +| Change | Language | Description | +|---------|----------|-------------------------------------------------------------------------------------------------------------------| +| Changed | All | Performance Improvements - Available in [REST API](../apis/#tag/Document-Generation) and SDK(s) v3.0.0 and above. | + +### Server Side Release (August, 2023; server side release) + +| Change | Language | Description | +|--------|----------|--------------------------------------------------------------------------------------------------------------------------| +| New | API | Added support for document level permissions and trusted timestamping (using [supported TSAs](../pdf-electronic-seal-api/#supported-timestamping-authorities)) in [PDF Electronic Seal API](../pdf-electronic-seal-api/). | +| New | API | Added support for [External Storage](../pdf-services-api/howtos/pdf-external-storage-sol/) in all the operations **except** Extract PDF, Split PDF, PDF Electronic Seal and Auto-Tag PDF. | + +### 3.4.2 (August, 2023, minor release) + +| Change | Language | Description | +|---------|----------|-----------------------------------| +| Changed | NodeJS | Restructured the internals for improved organization. | + +### 3.4.1 (July, 2023, minor release) + +| Change | Language | Description | +|---------|----------|--------------------------------| +| Changed | NodeJS | Fixed links in README.md file. | + +### 3.4.0 (June, 2023; minor release) + +| Change | Language | Description | +|--------|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------| +| New | Java,NodeJS,.NET | PDF Electronic Seal operation is now available for all the users in PDF Services SDKs and REST APIs. | +| New | Java,NodeJS,.NET | Added support for OAuth based Server to Server credentials in PDF Services SDKs. | +| Changed | Java,NodeJS,.NET | JWT based service account credentials and corresponding SDK interfaces are now deprecated. | + +### Python SDK 2.3.0 (June, 2023; minor release) + +| Change | Language | Description | +|---------|------------------|---------------------------------------------------------------------------------------------------------------------------------| +| New | Python | Added support for OAuth based Server to Server credentials in PDF Services SDKs. | +| Changed | Python | JWT based service account credentials and corresponding SDK interfaces are now deprecated. | + +### Adobe Document Generation Server Side Release (June, 2023; server side release) + +| Change | Language | Description | +|--------|----------|--------------------------------------------------------------------------------------------------------------------------| +| New | API | Added support for [External Storage](../pdf-services-api/howtos/pdf-external-storage-sol/) in Document Generation API. | + +### 3.3.0 (May, 2023; minor release) + +| Change | Language | Description | +|---------|------------------|---------------------------------------------------------------------------------------------------------------------------------| +| New | Java,NodeJS,.NET | PDF Accessibility Auto-Tag operation is now available for all the users in PDF Services SDKs and REST APIs. | +| New | Java | Added the support of Basic Authentication for the Proxy Server configuration. Proxy server settings will now be specified via "proxyServerConfig" in the client config. | +| Changed | Java,NodeJS,.NET | Upgraded third party libraries to fix recently discovered vulnerabilities. | + +### Python SDK 2.2.0 (May, 2023; minor release) + +| Change | Language | Description | +|---------|------------------|---------------------------------------------------------------------------------------------------------------------------------| +| New | Python | PDF Accessibility Auto-Tag operation is now available for all the users in PDF Services SDKs and REST APIs. | + +### Adobe Document Generation Server Side Release (April, 2023; server side release) + +| Change | Language | Description | +|---------|------------------|---------------------------------------------------------------------------------------------------------------------------------| +| Changed | Java,NodeJS,.NET | Modified support for [conditions inside tables](../document-generation-api/complextableconstructs.md#conditions-inside-tables). | + + +### Extract PDF Server Side Release (06 March, 2023; server side release) +| Change | Language | Description | +| ------- | ------------------- | --------------------------------------------------------------------------------------------- | +| Changed | All | Adding support for larger PDF document processing. The new supported limits are 400 pages for non-scanned and 150 for scanned PDF documents. | + +### Adobe Document Generation Server Side Release (March, 2023; server side release) + +| Change | Language | Description | +|--------|------------------|-------------------------------------------------------------------------------------------------------------------------------------| +| New | Java,NodeJS,.NET | Adding support for [dynamic html tables](../document-generation-api/templatetags.md#insert-table-using-table-html-element) feature. | +| New | Java,NodeJS,.NET | Adding support for [row omission](../document-generation-api/complextableconstructs.md#dynamic-table-rows) in tables. | +| New | Java,NodeJS,.NET | Adding support for [conditions inside tables](../document-generation-api/complextableconstructs.md#conditions-inside-tables). | + +### 2.3.0 (February, 2023, minor release) + +| Change | Language | Description | +|---------|----------|------------------------------------------------------------------------------------------------------------------------------| +| Changed | NodeJS | Fixed the response failures with `400` HTTP statusCode and `UNKNOWN` errorCode for NodeJS SDK(s) v2.2.3 and below. | + +### Adobe Document Generation Server Side Release (January, 2023; server side release) + +| Change | Language | Description | +|---------|----------|------------------------------------------------------------------------------------------------------------------------------| +| New | Java,NodeJS,.NET | Adding support for [inline images](../document-generation-api/inlineimages.md#) feature. | +| New | Java,NodeJS,.NET | Adding support for additional constructs in [fragments](../document-generation-api/fragments.md#Other-supported-constructs). | +| Changed | Java,NodeJS,.NET | Adding support for prefix in [text tags](../document-generation-api/templatetags.md#Placeholder-Variables). | + +### Python SDK 2.1.2 (January, 2023, minor release) +| Change | Language | Description | +| ------- | ------------------- | --------------------------------------------------------------------------------------------- | +| New | Python | Added configuration for SDKs to process the documents in the specified region.| +| Changed| Python | Upgraded libraries to fix recently discovered vulnerability. | + + +### 3.2.0 (January, 2023; minor release) +| Change | Language | Description | +| ------- | ------------------- | --------------------------------------------------------------------------------------------- | +| New | Java,NodeJS,.NET | Added configuration for SDKs to process the documents in the specified region. | +| Changed | NodeJS | Upgraded libraries to fix recently discovered vulnerability.. | + +### Python SDK 2.0.0 (December, 2022, major release) +| Change | Language | Description | +| ------- | ------------------- | --------------------------------------------------------------------------------------------- | +| Changed | Python | Released SDK v2.0.0 for Python, based out of the new PDF Services APIs. | + + +### 3.0.0 (September, 2022; major release) +| Change | Language | Description | +| ------- | ------------------- | --------------------------------------------------------------------------------------------- | +| Changed | Java,NodeJS,.NET | Released SDK v3.0.0, based out of the new PDF Services APIs.| +| Changed | Java,NodeJS,.NET | Added the support of OCR locale for Export PDF operation. | +| Changed | Java,NodeJS,.NET | Updated PDF Properties operation to return PDFProperties object. Discontinued the support of returning FileRef and JSON Object.| +| Changed | Java,NodeJS,.NET | Image formats(JPEG and PNG) for Export PDF have been moved from Export PDF operation to ExportPDFToImages operation.| +| New | Java | PDF Electronic Seal operation is now available in Beta PDF Services SDKs.| + ### 2.2.3 (July, 2022; patch release) | Change | Language | Description | | ------- | ------------------- | --------------------------------------------------------------------------------------------- | | Changed | NodeJS | Fixed the issue of sending UNKNOWN error code for extract operation. ### PDF Accessibility Auto-Tag Release - Available under Early Access Program (21 June, 2022) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| New | Java, Python | PDF Accessibility Auto-Tag operation is now available in Beta PDF Services SDKs | +| Change | Language | Description | +| ------- | ------------------- |---------------------------------------------------------------------------------| +| New | Java, Python | PDF Accessibility Auto-Tag operation is now available in Beta PDF Services SDKs | ### Extract PDF Server Side Release (21 June, 2022; server side release) | Change | Language | Description | @@ -204,10 +490,10 @@ Upgrading to the latest SDK should not break existing applications. ### Adobe Document Generation Server Side Release (14 December, 2021; server side release) -| Change | Language | Description | -| ------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| New | All | Adding support for additional tags ( and ) in [styling and formatting](../document-generation-api/stylingformattingtags.md#apply-styling-and-formatting) feature. | -| New | All | Support for [dynamic table constructs](../document-generation-api/dynamictableconstructs.md). | +| Change | Language | Description | +| ------- | -------- |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| New | All | Adding support for additional tags ( and ) in [styling and formatting](../document-generation-api/stylingformattingtags.md#apply-styling-and-formatting) feature. | +| New | All | Support for [dynamic table constructs](../document-generation-api/complextableconstructs.md). | ### Extract PDF Server Side Release (15 November, 2021; server side release) | Change | Language | Description | @@ -218,11 +504,11 @@ Upgrading to the latest SDK should not break existing applications. ### Adobe Document Generation Server Side Release (20 October, 2021; server side release) -| Change | Language | Description | -| ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| New | All | HTML [styling and formatting](../document-generation-api/stylingformattingtags.md#apply-styling-and-formatting) support in json data. | -| New | All | Support for [horizontal tables](../document-generation-api/templatetags.md#dynamically-expand-table-rows-or-columns). | -| New | All | Support for SVG images. | +| Change | Language | Description | +| ------- | -------- |---------------------------------------------------------------------------------------------------------------------------------------| +| New | All | HTML [styling and formatting](../document-generation-api/stylingformattingtags.md#apply-styling-and-formatting) support in json data. | +| New | All | Support for [horizontal tables](../document-generation-api/complextableconstructs.md#dynamically-expand-table-rows-or-columns). | +| New | All | Support for SVG images. | ### Extract PDF Server Side Release (29 September, 2021; server side release) | Change | Language | Description| diff --git a/src/pages/overview/pdf-services-api/howtos/pdf-watermark-api.md b/src/pages/overview/pdf-services-api/howtos/pdf-watermark-api.md new file mode 100644 index 000000000..dcc13d21f --- /dev/null +++ b/src/pages/overview/pdf-services-api/howtos/pdf-watermark-api.md @@ -0,0 +1,80 @@ +--- +title: PDF Watermark | How Tos | PDF Services API | Adobe PDF Services +--- + + +PDF Watermark is currently accessible through the REST API only. + +# PDF Watermark + +A watermark in a document is usually semi-translucent or faded text, a logo, or a pattern placed in the background or foreground of the page for security, authenticity, and branding. + +PDF Watermark API is a cloud based solution to apply watermark on specified pages of a PDF document using a source file. + +![PDF Watermark](../watermark_overview.png) + +## Input Documents : **Required** + +Supported format is PDF (application/pdf). Input PDF with version 1.6 and above is supported. + +### Input Document + +A PDF document to which a watermark will be applied. + +### Watermark Document + +A PDF document whose first page will be used as a watermark for the input document. +The output generated will retain the content along with the watermark from the first page. + +## Watermark Parameters + +### Page ranges (_pageRanges_) + +Specifies the number of pages on which the watermark will be applied. Page numbers are indexed from 1 to N. +The page ranges are specified as an array of objects whose length cannot exceed beyond 20. Each object has the following properties: +* **Start Page** (*start*) : The first page number of the range. Default value is 1. +* **End Page** (*end*) : The last page number of the range. Default value is the last page of the document. +: +### Appearance (_appearance_) + +* **Foreground** (*appearOnForeground*) : Specifies the placement of the watermark on the page. It can appear in the foreground or background. The default value is true, placing the watermark in the foreground. +* **Opacity** (*opacity*) : Specifies the opacity of the watermark, represented as an integer percentage value ranging from 0 to 100. The default value is 100. + +## REST API + +See our public API Reference for [PDF Watermark API](../../../apis/#tag/PDF-Watermark). + +## Apply Watermark on specified pages + +The sample below performs watermark operation applying watermark in foreground on specified pages of a given PDF. + +Please refer the [API usage guide](../gettingstarted.md) to understand how to use our APIs. + + + +#### REST API + +```javascript +curl --location --request POST 'https://pdf-services.adobe.io/operation/addwatermark' \ +--header 'x-api-key: {{Placeholder for client_id}}' \ +--header 'Content-Type: application/json' \ +--header 'Authorization: Bearer {{Placeholder for token}}' \ +--data-raw '{ + "inputDocumentAssetID": "urn:aaid:AS:UE1:54cbf87f-d7f5-4918-8e4b-9f68", + "watermarkDocumentAssetID": "urn:aaid:AS:UE1:54cbf87f-d7f5-4918-8e4b-9f1878678e68", + "pageRanges": [ + { + "start": 2, + "end": 5 + }, + { + "start": 8, + "end": 10 + } + ], + "appearance": { + "opacity": 50, + "appearOnForeground": true + } +}' +``` diff --git a/src/pages/overview/pdf-services-api/watermark_overview.png b/src/pages/overview/pdf-services-api/watermark_overview.png new file mode 100644 index 000000000..c10564405 Binary files /dev/null and b/src/pages/overview/pdf-services-api/watermark_overview.png differ diff --git a/src/pages/overview/releasenotes.md b/src/pages/overview/releasenotes.md index bb786424e..74a20e0e5 100644 --- a/src/pages/overview/releasenotes.md +++ b/src/pages/overview/releasenotes.md @@ -181,406 +181,114 @@ Upgrading to the latest SDK should not break existing applications. ## Change history -### 4.0.1 (June 12, 2024; patch release) +### June 12, 2024; NodeJS SDK 4.0.1 patch release -| Change | Language | Description | -|---------|----------|---------------------------------------| -| Changed | NodeJS | Bug fixes and stability improvements. | +- Bug fixes and stability improvements. -### 3.5.1 (June 05, 2024; patch release) +### June 05, 2024; .NET SDK 3.5.1 patch release -| Change | Language | Description | -|---------|----------|---------------------------------------| -| Changed | .NET | Bug fixes and stability improvements. | +- Bug fixes and stability improvements. -### 4.1.0 (June 04, 2024: minor release) +### June 04, 2024; Java SDK 4.1.0 minor release -| Change | Language | Description | -|--------|----------|------------------------------------------------------------------| -| New | Java | Extend support for external storage and notifier config for all the operations. | +- Extend support for external storage and notifier config for all the operations. +### May 22, 2024; Python SDK 4.0.0 major release -### 4.0.0 (May 22, 2024; major release) +- Released Adobe PDF Services Python SDK v4.0.0, introducing new interfaces fully leveraging power of new PDF Services REST APIs. +- Added support for all the operations powered by the Adobe PDF Services APIs. +- Added support for deleting assets and webhook notifiers. +- Removed the need for intermediate result storage for chained operations by eliminating reliance on temporary local storage. +- Extended I/O capabilities by introducing external storage for PDF Services operations. +- Enabled connection to Internet through Proxy, where proxy server settings can be set via Proxy Server Config. -| Change | Language | Description | -|---------|----------|---------------------------------------------------------------------------------------------------------------------------------| -| New | Python | Released Adobe PDF Services Python SDK v4.0.0, introducing new interfaces fully leveraging power of new PDF Services REST APIs. | -| New | Python | Added support for all the operations powered by the Adobe PDF Services APIs. | -| New | Python | Added support for deleting assets and webhook notifiers. | -| New | Python | Removed the need for intermediate result storage for chained operations by eliminating reliance on temporary local storage. | -| New | Python | Extended I/O capabilities by introducing external storage for PDF Services operations. | -| New | Python | Enabled connection to Internet through Proxy, where proxy server settings can be set via Proxy Server Config. | +### May 15, 2024; .NET SDK 3.5.0 minor release -### 3.5.0 (May 15, 2024: minor release) +- Added support to enable or disable "configureAwait" using client config, which will allow developers to specify whether asynchronous continuations should execute on the original synchronization context or not. **Note**: Starting from the next major release, "configureAwait" will be disabled by default and won't be configurable. -| Change | Language | Description | -|--------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| New | .NET | Added support to enable or disable "configureAwait" using client config, which will allow developers to specify whether asynchronous continuations should execute on the original synchronization context or not. **Note**: Starting from the next major release, "configureAwait" will be disabled by default and won't be configurable. | +### April 30, 2024; Adobe Document Generation Server Side Release +- Added support for [discard the row in a horizontal table](../document-generation-api/tablewithmarkers/#discard-the-row-in-a-horizontal-table-if-the-condition-evaluates-to-true) in Document Generation API. -### Adobe Document Generation Server Side Release (April 30, 2024: server side release) +### April, 2024; NodeJS SDK 4.0.0 major release -| Change | Language | Description | -|---------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| New | All | Added support for [discard the row in a horizontal table](../document-generation-api/tablewithmarkers/#discard-the-row-in-a-horizontal-table-if-the-condition-evaluates-to-true) in Document Generation API. | +- Released Adobe PDF Services Node SDK v4.0.0, introducing new interfaces fully leveraging power of new PDF Services rest APIs. +- Added support for delete asset and webhook notifiers. +- Eliminated need of storage to save intermediate result by removing dependency on temporary storage. +- Extended I/O capabilities by introducing external storage for PDF Services operations. +- Enabled connection to Internet through Proxy, where proxy server settings can be set via "proxyServerConfig" in the client config. +- Updated PDF Properties operation to return PDFProperties object along with JSON string. +- Updated Extract PDF operation to return content and resource asset along with content JSON object. -### 4.0.0 (April, 2024; major release) +### April, 2024; Server Side Release -| Change | Language | Description | -|---------|----------|------------------------------------------------------------------------------------------------------------------------------------| -| New | NodeJS | Released Adobe PDF Services Node SDK v4.0.0, introducing new interfaces fully leveraging power of new PDF Services rest APIs. | -| New | NodeJS | Added support for delete asset and webhook notifiers. | -| New | NodeJS | Eliminated need of storage to save intermediate result by removing dependency on temporary storage. | -| New | NodeJS | Extended I/O capabilities by introducing external storage for PDF Services operations. | -| New | NodeJS | Enabled connection to Internet through Proxy, where proxy server settings can be set via "proxyServerConfig" in the client config. | -| Changed | NodeJS | Updated PDF Properties operation to return PDFProperties object along with JSON string. | -| Changed | NodeJS | Updated Extract PDF operation to return content and resource asset along with content JSON object. | +- Added support for [Webhook Notification](../pdf-services-api/howtos/webhook-notification/) in PDF Properties. +- Added support for [External Storage](../pdf-services-api/howtos/pdf-external-storage-sol/) in Extract PDF, Split PDF, PDF Electronic Seal and Auto-Tag PDF. +- Added support for [Webhook Notification](../pdf-services-api/howtos/webhook-notification/) for external storage operations. -### Server Side Release (April, 2024; server side release) +### March, 2024; Python SDK 2.3.1 patch release -| Change | Language | Description | -|--------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------| -| New | API | Added support for [Webhook Notification](../pdf-services-api/howtos/webhook-notification/) in PDF Properties. | -| New | API | Added support for [External Storage](../pdf-services-api/howtos/pdf-external-storage-sol/) in Extract PDF, Split PDF, PDF Electronic Seal and Auto-Tag PDF. | -| New | API | Added support for [Webhook Notification](../pdf-services-api/howtos/webhook-notification/) for external storage operations. | +- PDF operations now support configurable timeouts. -### 2.3.1 (March, 2024; patch release) +### February, 2024: .NET SDK 3.4.1 patch release -| Change | Language | Description | -|---------|------------------|---------------------------------------------------------------------------------------------------------------------------------| -| New | Python | PDF operations now support configurable timeouts. | +- Dependent library upgrades and fixed compatibility issues with RestSharp v110+. -### 3.4.1 (February, 2024: patch release) -| Change | Language | Description | -|---------|----------|---------------------------------------------------------------------------------| -| Changed | .NET | Dependent library upgrades and fixed compatibility issues with RestSharp v110+. | +### January, 2024; Java SDK 4.0.0 major release +- Released Adobe PDF Services Java SDK v4.0.0, introducing new interfaces fully leveraging power of new PDF Services rest APIs. +- Added support for delete asset, refresh download URI, webhook notifiers. +- Eliminated need of storage to save intermediate result by removing dependency on temporary storage. +- Extended I/O capabilities by introducing external storage for a majority of PDF Services operations. +- Updated PDF Properties operation to return PDFProperties object along with JSON string. +- Updated Extract PDF operation to return content and resource asset along with content JSON object. -### 4.0.0 (January, 2024; major release) -| Change | Language | Description | -|---------|----------|-------------------------------------------------------------------------------------------------------------------------------| -| New | Java | Released Adobe PDF Services Java SDK v4.0.0, introducing new interfaces fully leveraging power of new PDF Services rest APIs. | -| New | Java | Added support for delete asset, refresh download URI, webhook notifiers. | -| New | Java | Eliminated need of storage to save intermediate result by removing dependency on temporary storage. | -| New | Java | Extended I/O capabilities by introducing external storage for a majority of PDF Services operations. | -| Changed | Java | Updated PDF Properties operation to return PDFProperties object along with JSON string. | -| Changed | Java | Updated Extract PDF operation to return content and resource asset along with content JSON object. | +### January, 2024; Server Side Release -### Server Side Release (January, 2024; server side release) +- Added support for [Webhook Notification](../pdf-services-api/howtos/webhook-notification/) in all the operations **except** PDF Properties. -| Change | Language | Description | -|--------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| New | API | Added support for [Webhook Notification](../pdf-services-api/howtos/webhook-notification/) in all the operations **except** PDF Properties. | +### January, 2024: Adobe Document Generation Server Side Release -### Adobe Document Generation Server Side Release (January, 2024: server side release) +- Added support for [Table Tag with Markers](../document-generation-api/tablewithmarkers) in Document Generation API. -| Change | Language | Description | -|---------|----------|--------------------------------------------------------------------------------------------------------| -| Changed | All | Added support for [Table Tag with Markers](../document-generation-api/tablewithmarkers) in Document Generation API. | +### December, 2023: Java SDK 3.5.1 patch release -### 3.5.1 (December, 2023: patch release) +- Dependent library upgrades and fixed compatibility issues with Spring Boot v3.x. -| Change | Language | Description | -|---------|----------|----------------------------------------------------------------------------------| -| Changed | Java | Dependent library upgrades and fixed compatibility issues with Spring Boot v3.x. | +### October, 2023: Java SDK 3.5.0 minor release +- Added support for document level permissions and trusted timestamping (using [supported TSAs](../pdf-electronic-seal-api/#supported-timestamping-authorities)) in java sdk for [PDF Electronic Seal API](../pdf-electronic-seal-api/). -### 3.5.0 (October, 2023: minor release) +### October, 2023; Adobe Document Generation Server Side Release -| Change | Language | Description | -|---------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Changed | Java | Added support for document level permissions and trusted timestamping (using [supported TSAs](../pdf-electronic-seal-api/#supported-timestamping-authorities)) in java sdk for [PDF Electronic Seal API](../pdf-electronic-seal-api/). | +- Performance Improvements - Available in [REST API](../apis/#tag/Document-Generation) and SDK(s) v3.0.0 and above. -### Adobe Document Generation Server Side Release (October, 2023; server side release) +### August, 2023; Server Side Release -| Change | Language | Description | -|---------|----------|-------------------------------------------------------------------------------------------------------------------| -| Changed | All | Performance Improvements - Available in [REST API](../apis/#tag/Document-Generation) and SDK(s) v3.0.0 and above. | +- Added support for document level permissions and trusted timestamping (using [supported TSAs](../pdf-electronic-seal-api/#supported-timestamping-authorities)) in [PDF Electronic Seal API](../pdf-electronic-seal-api/). +- Added support for [External Storage](../pdf-services-api/howtos/pdf-external-storage-sol/) in all the operations **except** Extract PDF, Split PDF, PDF Electronic Seal and Auto-Tag PDF. -### Server Side Release (August, 2023; server side release) +### August, 2023, NodeJS SDK 3.4.2 minor release -| Change | Language | Description | -|--------|----------|--------------------------------------------------------------------------------------------------------------------------| -| New | API | Added support for document level permissions and trusted timestamping (using [supported TSAs](../pdf-electronic-seal-api/#supported-timestamping-authorities)) in [PDF Electronic Seal API](../pdf-electronic-seal-api/). | -| New | API | Added support for [External Storage](../pdf-services-api/howtos/pdf-external-storage-sol/) in all the operations **except** Extract PDF, Split PDF, PDF Electronic Seal and Auto-Tag PDF. | +- Restructured the internals for improved organization. -### 3.4.2 (August, 2023, minor release) +### July, 2023, NodeJS SDK 3.4.1 minor release -| Change | Language | Description | -|---------|----------|-----------------------------------| -| Changed | NodeJS | Restructured the internals for improved organization. | +- Fixed links in README.md file. -### 3.4.1 (July, 2023, minor release) +### June, 2023; Java,NodeJS,.NET SDK 3.4.0 minor release -| Change | Language | Description | -|---------|----------|--------------------------------| -| Changed | NodeJS | Fixed links in README.md file. | +- PDF Electronic Seal operation is now available for all the users in PDF Services SDKs and REST APIs. +- Added support for OAuth based Server to Server credentials in PDF Services SDKs. +- JWT based service account credentials and corresponding SDK interfaces are now deprecated. -### 3.4.0 (June, 2023; minor release) +### June, 2023; Python SDK 2.3.0 minor release -| Change | Language | Description | -|--------|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------| -| New | Java,NodeJS,.NET | PDF Electronic Seal operation is now available for all the users in PDF Services SDKs and REST APIs. | -| New | Java,NodeJS,.NET | Added support for OAuth based Server to Server credentials in PDF Services SDKs. | -| Changed | Java,NodeJS,.NET | JWT based service account credentials and corresponding SDK interfaces are now deprecated. | +- Added support for OAuth based Server to Server credentials in PDF Services SDKs. +- JWT based service account credentials and corresponding SDK interfaces are now deprecated. -### Python SDK 2.3.0 (June, 2023; minor release) +### June, 2023; Adobe Document Generation Server Side Release -| Change | Language | Description | -|---------|------------------|---------------------------------------------------------------------------------------------------------------------------------| -| New | Python | Added support for OAuth based Server to Server credentials in PDF Services SDKs. | -| Changed | Python | JWT based service account credentials and corresponding SDK interfaces are now deprecated. | - -### Adobe Document Generation Server Side Release (June, 2023; server side release) - -| Change | Language | Description | -|--------|----------|--------------------------------------------------------------------------------------------------------------------------| -| New | API | Added support for [External Storage](../pdf-services-api/howtos/pdf-external-storage-sol/) in Document Generation API. | - -### 3.3.0 (May, 2023; minor release) - -| Change | Language | Description | -|---------|------------------|---------------------------------------------------------------------------------------------------------------------------------| -| New | Java,NodeJS,.NET | PDF Accessibility Auto-Tag operation is now available for all the users in PDF Services SDKs and REST APIs. | -| New | Java | Added the support of Basic Authentication for the Proxy Server configuration. Proxy server settings will now be specified via "proxyServerConfig" in the client config. | -| Changed | Java,NodeJS,.NET | Upgraded third party libraries to fix recently discovered vulnerabilities. | - -### Python SDK 2.2.0 (May, 2023; minor release) - -| Change | Language | Description | -|---------|------------------|---------------------------------------------------------------------------------------------------------------------------------| -| New | Python | PDF Accessibility Auto-Tag operation is now available for all the users in PDF Services SDKs and REST APIs. | - -### Adobe Document Generation Server Side Release (April, 2023; server side release) - -| Change | Language | Description | -|---------|------------------|---------------------------------------------------------------------------------------------------------------------------------| -| Changed | Java,NodeJS,.NET | Modified support for [conditions inside tables](../document-generation-api/complextableconstructs.md#conditions-inside-tables). | - - -### Extract PDF Server Side Release (06 March, 2023; server side release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | All | Adding support for larger PDF document processing. The new supported limits are 400 pages for non-scanned and 150 for scanned PDF documents. | - -### Adobe Document Generation Server Side Release (March, 2023; server side release) - -| Change | Language | Description | -|--------|------------------|-------------------------------------------------------------------------------------------------------------------------------------| -| New | Java,NodeJS,.NET | Adding support for [dynamic html tables](../document-generation-api/templatetags.md#insert-table-using-table-html-element) feature. | -| New | Java,NodeJS,.NET | Adding support for [row omission](../document-generation-api/complextableconstructs.md#dynamic-table-rows) in tables. | -| New | Java,NodeJS,.NET | Adding support for [conditions inside tables](../document-generation-api/complextableconstructs.md#conditions-inside-tables). | - -### 2.3.0 (February, 2023, minor release) - -| Change | Language | Description | -|---------|----------|------------------------------------------------------------------------------------------------------------------------------| -| Changed | NodeJS | Fixed the response failures with `400` HTTP statusCode and `UNKNOWN` errorCode for NodeJS SDK(s) v2.2.3 and below. | - -### Adobe Document Generation Server Side Release (January, 2023; server side release) - -| Change | Language | Description | -|---------|----------|------------------------------------------------------------------------------------------------------------------------------| -| New | Java,NodeJS,.NET | Adding support for [inline images](../document-generation-api/inlineimages.md#) feature. | -| New | Java,NodeJS,.NET | Adding support for additional constructs in [fragments](../document-generation-api/fragments.md#Other-supported-constructs). | -| Changed | Java,NodeJS,.NET | Adding support for prefix in [text tags](../document-generation-api/templatetags.md#Placeholder-Variables). | - -### Python SDK 2.1.2 (January, 2023, minor release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| New | Python | Added configuration for SDKs to process the documents in the specified region.| -| Changed| Python | Upgraded libraries to fix recently discovered vulnerability. | - - -### 3.2.0 (January, 2023; minor release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| New | Java,NodeJS,.NET | Added configuration for SDKs to process the documents in the specified region. | -| Changed | NodeJS | Upgraded libraries to fix recently discovered vulnerability.. | - -### Python SDK 2.0.0 (December, 2022, major release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | Python | Released SDK v2.0.0 for Python, based out of the new PDF Services APIs. | - - -### 3.0.0 (September, 2022; major release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | Java,NodeJS,.NET | Released SDK v3.0.0, based out of the new PDF Services APIs.| -| Changed | Java,NodeJS,.NET | Added the support of OCR locale for Export PDF operation. | -| Changed | Java,NodeJS,.NET | Updated PDF Properties operation to return PDFProperties object. Discontinued the support of returning FileRef and JSON Object.| -| Changed | Java,NodeJS,.NET | Image formats(JPEG and PNG) for Export PDF have been moved from Export PDF operation to ExportPDFToImages operation.| -| New | Java | PDF Electronic Seal operation is now available in Beta PDF Services SDKs.| - -### 2.2.3 (July, 2022; patch release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | NodeJS | Fixed the issue of sending UNKNOWN error code for extract operation. - -### PDF Accessibility Auto-Tag Release - Available under Early Access Program (21 June, 2022) -| Change | Language | Description | -| ------- | ------------------- |---------------------------------------------------------------------------------| -| New | Java, Python | PDF Accessibility Auto-Tag operation is now available in Beta PDF Services SDKs | - -### Extract PDF Server Side Release (21 June, 2022; server side release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | All | Enhanced error messages by adding more sub error codes | -| Changed | All | Bug fixes and stability improvements. | - -### Extract PDF Server Side Release (16 May, 2022; server side release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | All | Bug fixes and stability improvements. | - -### 2.2.2 (May, 2022; patch release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | Java, NodeJS | Dependent library upgrades to address vulnerabilities reported in NPM and Maven. | - -### Create PDF Server Side Release (6 April, 2022; server side release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | All | Enhanced support for leveraging embedded TrueType fonts. | - -### Extract PDF Server Side Release (05 April, 2022; server side release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | All | Improved handling of bad PDFs with 50% reduction in frequency of bad PDF errors and improved successful conversion rate. | -| Changed | All | Bug fixes and stability improvements. | - -### 2.2.1 (March, 2022; patch release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | .NET | Dependent library upgrades and SDK internal additional validation checks. | - -### Extract PDF Server Side Release (22 February, 2022; server side release) -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------- | -| Changed | All | Adding support for identification of scanned pages with "is_scanned" field in Extract output. | -| Changed | All | Bug fixes and stability improvements. | - -### 2.2.1 (February, 2022; patch release) - -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Changed | Java | Dependent library upgrades. | - - -### 2.2.1 (January, 2022; patch release) - -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------| -| Changed | Node JS | Enhanced Document Generation interface to support Json Object and Json array as Fragments data. | - -### 2.2.0 (January, 2022; minor release) - -| Change | Language | Description | -| ------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------| -| New | All | Adding support for [fragments](../document-generation-api/fragments.md#) feature. | -| Changed | Java | Java SDK is enabled to connect to Internet through Proxy where proxy server settings can be set via client config. | -| Changed | All | PDF Extract API bug fixes and stability release. | - -### Adobe Document Generation Server Side Release (10 January, 2022; server side release) - -| Change | Language | Description | -| ------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| New | All | Adding support for [fragments](../document-generation-api/fragments.md#) feature. | -| Changed | All | Adding support to add [images](../document-generation-api/templatetags.md#images) (only base64 encoded image data was supported initially) through publicly accessible URLs. | -| Changed | All | Adding support for primitive type [list](../document-generation-api/templatetags.md#lists) - -### Adobe Document Generation Server Side Release (14 December, 2021; server side release) - -| Change | Language | Description | -| ------- | -------- |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| New | All | Adding support for additional tags ( and ) in [styling and formatting](../document-generation-api/stylingformattingtags.md#apply-styling-and-formatting) feature. | -| New | All | Support for [dynamic table constructs](../document-generation-api/complextableconstructs.md). | - -### Extract PDF Server Side Release (15 November, 2021; server side release) -| Change | Language | Description | -| ------- | ------------------- | ---------------------------------------------------------------------------------------------- | -| Changed | All | The option to include styling information is generally available. | -| Changed | All | Identification of scanned content is now performed at the page level rather than per document. | -| Changed | All | Bug fixes and stability improvements. | - -### Adobe Document Generation Server Side Release (20 October, 2021; server side release) - -| Change | Language | Description | -| ------- | -------- |---------------------------------------------------------------------------------------------------------------------------------------| -| New | All | HTML [styling and formatting](../document-generation-api/stylingformattingtags.md#apply-styling-and-formatting) support in json data. | -| New | All | Support for [horizontal tables](../document-generation-api/complextableconstructs.md#dynamically-expand-table-rows-or-columns). | -| New | All | Support for SVG images. | - -### Extract PDF Server Side Release (29 September, 2021; server side release) -| Change | Language | Description| -| ------- | ------------------- | ---------- | -| Changed | All | Support for more descriptive error messages and PDF Extract API bug fixes. | - -### 2.1.0 (September, 2021; minor release) - -| Change | Language | Description | -| ------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| New | .NET | Extract operation is now available in .NET SDK as part of **Adobe.PDFServicesSDK**. | -| New | Java, Node JS, .NET | Support for fetching the properties of a PDF file - metadata including page count, PDF version, file size, compliance levels, font info, permissions and more. | -| New | Java, Node JS, .NET | Support for returning the list of images besides returning ZIP of all image files. | -| New | Java, Node JS, .NET | Support for converting the content hosted on a URL to PDF files. | -| New | Java, Node JS, .NET | Support for converting an HTML file containing inline CSS to PDF files. | - -### Extract PDF Server Side Release (26 Aug, 2021; server side release) -| Change | Language | Description | -| ------- | ------------------- | ----------------------------------------------- | -| Changed | All | PDF Extract API bug fixes and stability release | - -### 2.0.0 (May, 2021; major release) - -| Change | Language | Description | -| ------- | -------- | -------------------------------------------------------------------------------------------------------------- | -| New | All | Extract operation released as part of **pdfservices-sdk** | -| Changed | Java | artifactId changed from pdftools-sdk to **pdfservices-sdk** | -| Changed | Node JS | NPM package name changed from @adobe/documentservices-pdftools-node-sdk to **@adobe/pdfservices-node-sdk** | -| Changed | Node JS | For HTML to PDF Conversions, the PageLayout object interface is moved inside html object. | -| Changed | .NET | Nuget package name changed from Adobe.DocumentServices.PDFTools to **Adobe.PDFServicesSDK** | -| New | Python | Python SDK “pdfservices-sdk” v1.0 is released for ML Services which consists of ExtractPDFOperation currently. | - -### 1.3.0 (March, 2021; minor release) - -| Change | Language | Description | -| ------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| New | All | Added a feature to the create PDF operation to specify the document language of input file. | -| New | All | Added Document Merge Operation that merges a Word based document template with the input JSON data to generate the output document in either Word or PDF format. | -| New | All | Added support to get the developer error codes in exceptions. | -| New | All | Added a feature to the compress PDF operation to reduce the file size based on compression level. | - -### 1.2.0 (September, 2020; minor release) - -| Change | Language | Description | -| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| New | All | Added more features to the password-protect operation to secure a PDF with an owner password and to enable users to restrict features like printing, editing and copying. | -| New | All | Added an operation for removing password protection from a PDF. | -| New | All | Added a split PDF operation that splits a PDF document into multiple smaller documents by simply specifying either the number of files, pages per file, or page ranges. | - -### 1.1.0 (June, 2020; minor release) - -| Change | Language | Description | -| ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- | -| New | All | Added a password-protect operation to securely open a PDF. | -| New | All | Added an operation for inserting a PDF file into an existing PDF. | -| New | All | Added a replace file operation which replaces a PDF with another. | -| New | All | Added an operation for deleting pages from a PDF. | -| New | All | Added a rotate page(s) operation for rotating one or more pages in a PDF. | -| New | All | Added reorder page(s) operation to support rearranging page(s) in a PDF. | -| New | All | Added a compress PDF operation to reduce a PDF file size. | -| New | All | Added a linearize operation to convert a PDF file into a web optimized PDF file for incremental access in network environments. | -| Changed | All | Changed the combine file limit from 12 to 20. | - -### 1.0.0 (March, 2020; First major release) - -| Change | Language | Description | -| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| New | All | Added create PDF operation to create PDF from Office formats, image formats and HTML (doc, docx, ppt, pptx, xls, xlsx, txt, rtf, bmp, gif, tiff, jpeg, png). | -| New | All | Added export PDF operation to export PDF to Office formats and image formats (doc, docx, pptx, rtf, xlsx, jpeg, png). | -| New | All | Added combine PDF files operation. | -| New | All | Added an OCR operation to convert PDF files into a searchable PDF. | +- Added support for [External Storage](../pdf-services-api/howtos/pdf-external-storage-sol/) in Document Generation API. \ No newline at end of file diff --git a/src/pages/overview/security.md b/src/pages/overview/security.md index 5ffb78371..010af7f87 100644 --- a/src/pages/overview/security.md +++ b/src/pages/overview/security.md @@ -207,3 +207,39 @@ The Adobe Privacy Policy describes the privacy practices of Adobe's Services and ## Compliance Our [open, flexible framework](https://www.adobe.com/trust/compliance/adobe-ccf.html) adapts to constantly changing standards and regulations to help provide ongoing compliance across all our products and services. To learn more, please visit this [link](https://www.adobe.com/trust/compliance/compliance-list.html). + +### Adobe PDF Embed API + +Adobe PDF Embed API allows you to embed a PDF viewer in your web applications with only a few lines of code. With options for controlling how a PDF appears and functions, your applications can deliver the rich and compelling digital document experiences to your customers expect and need. + +### Adobe Commitment to Accessibility + +[Adobe Accessibility Principles](https://blog.adobe.com/en/publish/2023/09/26/announcing-adobes-new-accessibility-principles) align with our core values and form the foundation for what we believe — everyone should be able to create, interact, and engage with digital experiences. These principles will serve as our guideposts as we build thoughtful and inclusive technology that makes a difference in people’s lives. + +The Adobe Accessibility Board has been created to set the strategy, review progress and oversee our commitment to supporting people with disabilities. + +### Conformance Statement + +#### Adobe Embed API + +Adobe PDF Embed API is partially conformant with the Web Content Accessibility Guide (WCAG) 2.1 level AA. Adobe internally assessed the accessibility of Adobe Embed PDF using: + +- Automated testing using 3rd party accessibility tools. +- Manual testing covering keyboard interactions and color contrast. + +#### PDF Viewer + +Adobe PDF Viewer is partially conformant with WCAG 2.1 level AA. It is notable that accessible PDF documents are fully supported for viewing with assistive technologies in the Adobe PDF Viewer. + +The Adobe PDF Viewer was fully evaluated against: + +- [Web Content Accessibility Guidelines 2.1](https://www.w3.org/TR/WCAG21/) +- [Revised Section 508 standards published January 18, 2017 and corrected January 22, 2018](https://www.access-board.gov/ict/) +- [EN 301 549 Accessibility requirements suitable for public procurement of ICT products and services in Europe](https://www.etsi.org/deliver/etsi_en/301500_301599/301549/03.01.01_60/en_301549v030101p.pdf), - V3.2.1 (2021-03) + +An annual audit was conducted on Acrobat Web, which includes the PDF Viewer, using a 3rd party vendor. This audit also included testing with native assistive technology users. The resulting Accessibility Conformance Report for Acrobat Web can be found on the [Adobe Accessibility Compliance page](https://www.adobe.com/accessibility/compliance.html). + +Additional testing for Acrobat Web included: + +- Testing integrated into development using automated testing. +- Manual testing conducted on feature work. Some areas of focus include keyboard, color contrast, and testing with assistive technologies.