Adobe Photoshop modules

Last update: Wed Nov 27 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

User

In an Adobe Workfront Fusion scenario, you can automate workflows that use Adobe Photoshop, as well as connect it to multiple third-party applications and services.

If you need instructions on creating a scenario, see Create a scenario.

For information about modules, see Modules in Adobe Workfront Fusion.

Access requirements

Expand to view access requirements for the functionality in this article.

You must have the following access to use the functionality in this article:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront plan*	Pro or higher
Adobe Workfront license*	Plan, Work
Adobe Workfront Fusion license**	Workfront Fusion for Work Automation and Integration
Product	Your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article.

*To find out what plan, license type, or access you have, contact your Workfront administrator.

**For information on Adobe Workfront Fusion licenses, see [Adobe Workfront Fusion] licenses(https://experienceleague.adobe.com/workfront-fusion/get-started/license-automation-vs-integration.html?lang=en)

Prerequisites

Before you can use the Adobe Photoshop connector, you must ensure that the following prerequisites are met:

You must have an active Adobe Photoshop account.

Adobe Photoshop API information

The Adobe Photoshop connector uses the following:

Base URL

https://image.adobe.io/pie/psdService

API tag

v1.12.31

Create a connection to Adobe Photoshop

To create a connection for your Adobe Photoshop modules:

Click Add next to the Connection box.

Fill in the following fields:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header
Connection name	Enter a name for this connection.
Client ID	Enter your Adobe Client ID. This can be found in the Credentials details section of the Adobe Developer Console.
Client Secret	Enter your Adobe Client Secret. This can be found in the Credentials details section of the Adobe Developer Console.
Technical account ID	Enter your Adobe Technical account ID. This can be found in the Credentials details section of the Adobe Developer Console.
Organization ID	Enter your Adobe Organization ID. This can be found in the Credentials details section of the Adobe Developer Console.
Private key	Enter the private key that was generated when your credentials were created in the Adobe Developer Console. To extract your private key or certificate: Click Extract. Select the type of file you are extracting. Select the file that contains the private key or certificate. Enter the password for the file. Click Save to extract the file and return to the connection setup.

Click Continue to save the connection and return to the module.

Adobe Photoshop modules and their fields

When you configure Adobe Photoshop modules, Workfront Fusion displays the fields listed below. Along with these, additional Adobe Photoshop fields might display, depending on factors such as your access level in the app or service. A bolded title in a module indicates a required field.

If you see the map button above a field or function, you can use it to set variables and functions for that field. For more information, see Map information from one module to another in Adobe Workfront Fusion.

Apply PSD edits
Auto color correct an image
Convert image format
Create a mask
Create a new PSD
Edit text layers
Execute Depth Blur
Execute Photoshop actions
Execute Photoshop actions(JSON)
Execute Product Crop
Get layer info
Make a custom API call
Remove background
Replace a Smart Object
Resize an image
Watermark an image

Apply PSD edits

This action module applies a variety of document and layer level edits.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

(Input) Storage

Select the file service where the file you want to edit is stored.

(Input) File location

Enter or map the URL or path of the file that you want to edit.

(Options > Document > Image size) Height

Enter or map the height of the image in pixels.

(Options > Document > Image size) Width

Enter or map the width of the image in pixels.

(Options > Document > Canvas size) Top

Enter or map, in pixels, the y coordinate of the document's upper-left corner.

(Options > Document > Canvas size) Bottom

Enter or map, in pixels, the y coordinate of the document's lower-right corner.

(Options > Document > Canvas size) Left

Enter or map, in pixels, the x coordinate of the document's upper-left corner.

(Options > Document > Canvas size) Right

Enter or map, in pixels, the x coordinate of the document's lower-right corner.

(Options > Document) Trim

Select Transparent pixels to base the trim on transparent pixels in the image.

(Options) Default font

Enter the full postscript name of the font to be used as the global default for the document. This font will be used for any text layer which has a missing font and no other font has been specifically provided for that layer. If this font is missing, the option specified in Manage missing fonts will take effect.

(Options) Fonts

For each font that the document needs, click Add item and enter the font's storage location and file location.

(Options) Manage missing fonts

Select the action to take if there are one or more missing fonts in the document.

fail: The job will not succeed and the status will be set to failed, with the details of the error provided in the details section in the status.
useDefault: The job will succeed, however, by default all the missing fonts will be replaced with ArialMT.

(Options) Layers

For each layer you want to add, click Add item and and fill in the layer details.

For details about layer options, see Apply PSD Edits in the Adobe Photoshop documentation.

Outputs

For each converted file you want to create, click Add item and enter the storage, location, and type as listed in this table.

(Output) Storage

Select the file service where the you want the new file to be stored.

Selecting Fusion internal storage makes the file available for later modules, but does not make the file available outside of the scenario.

(Output) File location

Enter or map the URL or path of where the new file will be stored. This is only necessary if you have not chosen Fusion internal storage for the output storage.

(Output) Type

Select the file type that you want to convert the file to.

(Output) Overwrite

Select whether the newly edited file will overwrite any output file that already exists. This applies only to files in Adobe storage.

Maximum number of returned results

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Auto color correct an image

This action module auto color corrects the specified image.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

(Input) Storage

Select the file service where the file you want to color correct is stored.

(Input) File location

Enter or map the URL or path of the file that you want to color correct.

(Output) Storage

Select the file service where the you want the new file to be stored.

Selecting Fusion internal storage makes the file available for later modules, but does not make the file available outside of the scenario.

(Output) File location

Enter or map the URL or path of where the new file will be stored. This is only necessary if you have not chosen Fusion internal storage for the output storage.

(Output) Type

Select the file type that you want to convert the file to.

(Output) Overwrite

Select whether the newly edited file will overwrite any output file that already exists. This applies only to files in Adobe storage.

Maximum number of returned results

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Convert image format

This action module converts a file to JPEG, PNG, PSD or TIFF.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

(Input) Storage

Select the file service where the file you want to remove the background from is stored.

(Input) File location

Enter or map the URL or path of the file that you want to remove the background from.

Outputs

For each converted file you want to create, click Add item and enter the storage, location, and type as listed in this table.

(Output) Storage

Select the file service where the you want the new file to be stored.

Selecting Fusion internal storage makes the file available for later modules, but does not make the file available outside of the scenario.

(Output) File location

Enter or map the URL or path of where the new file will be stored. This is only necessary if you have not chosen Fusion internal storage for the output storage.

(Output) Type

Select the file type that you want to convert the file to.

(Output) Overwrite

Select whether the newly edited file will overwrite any output file that already exists. This applies only to files in Adobe storage.

Maximum number of returned results

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Create a mask

This action module returns a PNG file with a mast applied around the subject.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

(Input) Storage

Select the file service where the file you want to create a mask from is stored.

(Input) File location

Enter or map the URL or path of the file that you want to create a mask from.

(Output) Storage

Select the file service where the you want the mask file to be stored.

Selecting Fusion internal storage makes the file available for later modules, but does not make the file available outside of the scenario.

(Output) File location

Enter or map the URL or path of where the mask file will be stored. This is only necessary if you have not chosen Fusion internal storage for the output storage.

Overwrite

Select whether the newly edited file will overwrite any output file that already exists. This applies only to files in Adobe storage.

Color space

Select whether the output image uses RGB or RGBA color.

Mask format

Select whether the mask should be soft (feathered) or binary.

Optimize

Select Performance to optimize for speed, or Batch to allow wait time.

Post process

Version

Default is 4.0

Maximum number of returned results

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Create a new PSD

This action module creates a new PSD with optional layers, and generates renditions or saves as a PSD.

For fields related to this module, see Create a new PSD in the Adobe Photoshop documentation.

Edit text layers

This action module edits text layers on a Photoshop file.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

Input file storage

Select the file service where the file you want to edit is stored.

Input file URL

Enter or map the URL or path of the file that you want to edit.

Manage missing fonts

Select the action to take if there are one or more missing fonts in the document. If the font is not provided, the module uses the default font.

Default font

Layers

For details about layer options, see Edit text layer in the Adobe Photoshop documentation.

Output file storage

Select the file service where the you want the edited file to be stored.

Output file URL

Enter or map the URL or path of where the edited file will be stored.

Output file type

Select the file type for the edited file.

Overwrite

Select whether the newly edited file will overwrite any output file that already exists.

Compression

Select the compression level for the output file.

Execute Photoshop actions (JSON)

This action module executes Photoshop actions using JSON commands.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

(Input) Storage

Select the file service where the file you want to edit is stored.

(Input) File location

Enter or map the URL or path of the file that you want to edit.

Action JSON

Enter the JSON command for the action you want to take.

Fonts / Patterns / Brushes / Additional images

For each font, pattern, brush, or additional image that you want to use in this action, click Add item and enter the item's storage and file location.

Font / Pattern / Brush file URL

Enter or map the URL or path of the file that you want to use.

Outputs file storage

Select the file service where the you want the edited file to be stored.

Selecting Fusion internal storage makes the file available for later modules, but does not make the file available outside of the scenario.

Output file URL

Enter or map the URL or path of where the edited file will be stored. This is only necessary if you have not chosen Fusion internal storage for the output storage.

Output file type

Select the file type for the edited file.

Overwrite

Select whether the newly edited file will overwrite any output file that already exists.

Compression

Select the compression level for the output file.

Outputs

For each converted file you want to create, click Add item and enter the storage, location, and type as listed in this table.

(Output) Storage

Select the file service where the you want the new file to be stored.

(Output) File location

Enter or map the URL or path of where the new file will be stored.

(Output) Type

Select the file type that you want to convert the file to.

(Output) Overwrite

Select whether the newly edited file will overwrite any output file that already exists. This applies only to files in Adobe storage.

Maximum number of returned results

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Execute Depth Blur

This action module executes Depth Blur on the selected file.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

Input file storage

Select the file service where the file you want to edit is stored.

Input file URL

Enter or map the URL or path of the file that you want to edit.

Output file storage

Select the file service where the you want the edited file to be stored.

Output file URL

Enter or map the URL or path of where the edited file will be stored.

Output file type

Select the file type for the edited file.

Other fields

For details about other Depth Blur options, see Execute Depth Blurin the Adobe Photoshop API documentation.

Overwrite

Select whether the newly edited file will overwrite any output file that already exists.

Compression

Select the compression level for the output file.

Execute Photoshop Actions

This action module executes a Photoshop action on the selected image.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

Input file storage

Select the file service where the file you want to edit is stored.

Input file URL

Enter or map the URL or path of the file that you want to edit.

Actions file storage

Select the file service where actions file is stored.

Actions file URL

Enter or map the URL or path of the actions file.

Action name

If you only want to execute a particular action, you may specify which action to play from the ActionSet.

Font / Pattern / Brush storage

Select the file service where the file you want to use is stored.

Font / Pattern / Brush file URL

Enter or map the URL or path of the file that you want to use.

Output file storage

Select the file service where the you want the edited file to be stored.

Output file URL

Enter or map the URL or path of where the edited file will be stored.

Output file type

Select the file type for the edited file.

Overwrite

Select whether the newly edited file will overwrite any output file that already exists.

Compression

Select the compression level for the output file.

Execute Product Crop

This action module executes Product Crop on the selected image.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

Input file storage

Select the file service where the file you want to crop is stored.

Input file URL

Enter or map the URL or path of the file that you want to crop.

Unit

Select whether you want to describe the height and width adjustment in pixels or as a percent.

Width

Enter or map amount of width padding you want to add.

Height

Enter or map amount of height padding you want to add.

Output file storage

Select the file service where the you want the edited file to be stored.

Output file URL

Enter or map the URL or path of where the edited file will be stored.

Output file type

Select the file type for the edited file.

Overwrite

Select whether the newly edited file will overwrite any output file that already exists.

Compression

Select the compression level for the output file.

Get layer info

This action module retrieves layer information from the specified PSD file.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

Input file storage

Select the file service where the file you want to retrieve layer information from is stored.

Input file URL

Enter or map the URL or path of the file that you want to retrieve layer information from.

Thumbnails

Make a custom API call

This action module makes a custom call to the Photoshop API.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

URL

Enter a path relative to https://image.adobe.io/pie/psdService. Example: /photoshopActions

Method

Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in Adobe Workfront Fusion.

Headers

Add the headers of the request in the form of a standard JSON object.

For example, {"Content-type":"application/json"}

Workfront Fusion adds authorization headers automatically.

Query String

Enter the request query string.

Body

Add the body content for the API call in the form of a standard JSON object.

Note:

When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.

Remove background

This action module identifies the main subject of your image and removes the background.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

(Input) Storage

Select the file service where the file you want to remove the background from is stored.

(Input) File location

Enter or map the URL or path of the file that you want to remove the background from.

(Output) Storage

Select the file service where the you want the new file to be stored.

Selecting Fusion internal storage makes the file available for later modules, but does not make the file available outside of the scenario.

(Output) File location

Enter or map the URL or path of where the new file will be stored. This is only necessary if you have not chosen Fusion internal storage for the output storage.

Overwrite

Select whether the newly edited file will overwrite any output file that already exists. This applies only to files in Adobe storage.

Color space

Select whether the output image uses RGB or RGBA color.

Mask format

Select whether the edges of the image should be soft (feathered) or binary.

Optimize

Select Performance to optimize for speed, or Batch to allow wait time.

Post process

Version

Default is 4.0

Maximum number of returned results

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Replace a smart object

This action module replaces a Smart Object within a PSD layer, and generates new renditions.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

(Input) Storage

Select the file service where the Smart Object is stored.

(Input) File location

Enter or map the URL or path of the Smart Object.

Layers

For each layer you want to add to the Smart Object, click Add item and Enter the object's name or ID, the file service where the Smart Object is stored, and the the URL or path of the layer.

For descriptions of the advances settings in this area, see Replace a Smart Object in the Photoshop API documentation

Outputs

For each new rendition you want the module to produce, click Add item and fill in the following fields. You can have a maximum of 25 output files.

(Output) Storage

Select the file service where the you want the new file to be stored.

Selecting Fusion internal storage makes the file available for later modules, but does not make the file available outside of the scenario.

(Output) File location

Enter or map the URL or path of where the new file will be stored. This is only necessary if you have not chosen Fusion internal storage for the output storage.

(Output) Width

The width, in pixels, of the output file. The module will preserve the original aspect ratio.

(Output) Overwrite

Select whether the newly edited file will overwrite any output file that already exists. This applies only to files in Adobe storage.

Maximum number of returned results

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

Resize an image

This action resizes an image, using the same aspect ratio.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

Storage

Select the file service where the file you want to resize is stored.

Selecting Fusion internal storage makes the file available for later modules, but does not make the file available outside of the scenario.

File location

Enter or map the URL or path of the file that you want to resize. This is only necessary if you have not chosen Fusion internal storage for the output storage.

Outputs

For each converted file you want to create, click Add item and enter the storage, location, and other options as listed in this table.

Type

Select the file type that you want to convert the file to.

Width

Enter a number that represents the width, in pixels, of the resized image. Aspect ratio will be preserved.

Max width

When width is 0, Max with can be provided to get the size. Max width takes precedence with it is smaller than the document width.

Overwrite

Select whether the newly edited file will overwrite any output file that already exists. This applies only to files in Adobe storage.

Trim to canvas

Select Yes to trim the renditions to Canvas size, or No to make the renditions Layer Size.

Watermark an image

This action module adds a watermark to the selected image.

Connection

For instructions on creating a connection to Adobe Photoshop, see Create a connection to Adobe Photoshop in this article.

(Base / Input) Storage

Select the file service where the file you want to add a watermark to is stored.

(Base / Input) File location

Enter or map the URL or path of the file that you want to add a watermark to.

(Watermark / Input) Storage

Select the file service where the watermark you want to add is stored.

(Watermark / Input) Storage

Select the file service where the watermark you want to add is stored.

(Watermark / Bounds) Height

Enter or map the desired height of the watermark in pixels.

(Watermark / Bounds) Width

Enter or map the desired width of the watermark in pixels.

(Watermark / Bounds) Left

Enter or map the distance in pixels from the left side of the image that the watermark should be.

(Watermark / Bounds) Top

Enter or map the distance in pixels from the top of the image that the watermark should be.

(Output) Storage

Select the file service where the you want the watermarked file to be stored.

Selecting Fusion internal storage makes the file available for later modules, but does not make the file available outside of the scenario.

(Output) File location

Enter or map the URL or path of where the watermarked file will be stored. This is only necessary if you have not chosen Fusion internal storage for the output storage.

(Output) Type

Select the file type that you want to convert the file to.

(Output) Width

The width, in pixels, of the output file. The module will preserve the original aspect ratio.

(Output) Overwrite

Select whether the newly edited file will overwrite any output file that already exists. This applies only to files in Adobe storage.

Maximum number of returned results

Enter or map the maximum number of records you want the module to return during each scenario execution cycle.

recommendation-more-help

5f00cc6b-2202-40d6-bcd0-3ee0c2316b43