Use the Adobe Creative Cloud Extension

You can use the assets stored in Oracle Content Management in your Adobe Creative Cloud applications and save your Adobe Creative Cloud images as assets in Oracle Content Management.

The extension is available for Adobe Creative Cloud applications (Photoshop, Illustrator, InDesign, Premiere Pro, After Effects, Animate, and Audition) 2018 and higher. It can be downloaded from the Download Apps page in the Oracle Content Management web application.

Note:

If you're using Oracle Content Management Starter Edition, the Adobe Creative Cloud extension isn't supported. To take advantage of the full feature set, upgrade to the Premium Edition.

Feature Overview

Depending on the Adobe application you use, you'll access the extension through different menus, and you'll have access to different features. Here's a description of some of the features, followed by a table showing which features are available in each of the applications.

Link assets—Link assets to the current project.
Embed assets—Copy the assets to the current project.
Edit assets—Drag assets from the Oracle Content Management panel to the application's canvas, editor, or file list.
Upload assets—Drag assets from Windows File Explorer, Mac Finder, or the application panel to the Oracle Content Management panel.
Use workflows—Review, initiate, and respond to workflows.
Use Video Plus—
- Convert standard video assets to Video Plus assets.
- To play the Video Plus film strip, hover over the thumbnail.
- To view the full video in the extension, right-click the asset, and select Video player.
Note:
You can only edit the current version of an asset. Once you have finished editing a Video Plus asset, you can save it as a new asset, or as a revision of the original asset. If you edit out a segment of a video that you may want to use later for a different video, you'll want to save the edited video as a new asset so you can use the original asset for additional videos.

Application	Link Assets	Embed Assets	Edit Assets	Upload Assets	Use Workflows	Use Video Plus
Photoshop	Image assets	Image assets	Image assets	Image assets	Yes	No
Illustrator	Image assets	Image assets	Image assets	Image assets	Yes	No
InDesign	Image assets	Image assets	Image assets	Image assets	Yes	No
Premiere Pro	Image, video, and audio assets	No	Image, video, and audio assets	Image, video, and audio assets	Yes	Yes
After Effects	Image, video, and audio assets	No	Image, video, and audio assets	Image, video, and audio assets	Yes	Yes
Animate	Image, video, and audio assets	No	Image, video, and audio assets	Image, video, and audio assets	Yes	No
Audition	No	Video and audio assets	Video and audio assets	Video and audio assets	No	No

Install the Extension

The extension is installed for all users on the machine, which requires administrative privileges.

To install the extension:

In the Oracle Content Management web application, open your user menu, and click Download Apps.
Under Oracle Content Extension for Adobe, click Download.
Run the installer as a user with administrative privileges.
In the Adobe application, open the Extensions menu. This is a submenu accessed from another menu, such as Window. The location of the menu varies, depending on the application you’re using.
Select Oracle Content on the extension list. A web browser window will open, showing a sign-in page.
Sign in with your account name and password. If you have multiple accounts, select the one you want to use.
Confirm that you want to open Oracle Content.
If you're not signed in automatically, in the web application, click Copy Sign-in Key and paste the value into the box in the dialog.

Note:

Once back in the extension, if you see a message that no repositories are found, it means that either repositories have not yet been configured or no repositories have been shared with you under the account name you used for sign-in.

Customize the Extension

You can change how assets are filtered and other usage details. Click , and then select Preferences.

Note:

In Audition, the extension options (Preferences, Help, About) are available via the command bar.

You can perform the following tasks:

Task	Description
Change the account used	Select Accounts, and then select a different account from the list.
Add an account	Select Accounts, click and enter the URL for the account you're adding. When you click Save you must enter your user name and password to validate the account.
Remove an account	Select Accounts, and select the account you want to remove, then click . Accounts with a lock by them were added using the desktop client and must be removed using the desktop client.
Specify how you want changes to assets to be handled	You can automatically upload any changes to assets or you can handle that manually. For example, if you have an asset linked to a current project and you make local changes to that asset, when the asset is saved, it can be automatically updated in the project.
Manage the list of file extensions that are treated as projects	Select Projects, and then edit the list of project file extensions. Separate each file extension with a semi-colon (;), and don't include the period (.) before the extension.

Use the Extension

Before using the extension, make sure you have access to the repositories where the assets you need are stored. A repository manager must share a repository with you in order for you to use the assets there.

To open the extension and sign in:

In the Adobe application, open the Extensions menu. This is a submenu accessed from another menu, such as Window. The location of the menu varies, depending on the application you’re using.
Select Oracle Content on the extension list. A web browser window will open, showing a sign-in page.
Sign in with your account name and password. If you have multiple accounts, select the one you want to use.
Confirm that you want to open Oracle Content.
If you're not signed in automatically, in the web application, click Copy Sign-in Key and paste the value into the box in the dialog.

Note:

You can perform different actions in different areas of the extension. Select a topic to get started:

General Tasks

You can perform the following general tasks in the extension:

Task	Description
Select a view	Assets view—In Assets view you can browse or search for assets, and place them into the Adobe Creative Cloud application. Documents view—In Documents view you can view and manage your Oracle Content Management files and folders.. Links view—In Links view you can see a list of assets that are already linked to the current project. Note: Links view isn't available in Audition.
Filter by item type (Documents view only)	Click , and then, in the item type menu, select the type of items you want to view (all, yours, shared, or favorites).
Sort the item list	Click , and then, in the sort menu, sort by relevance, name, or last updated.
Change the way the item list is displayed	Click , and then, in the view menu, select table view or grid view.

Assets View

You can perform additional tasks in Assets view:

Task	Description
Select a repository	Select a repository from the drop-down list. Use the search field to find specific repositories.
Filter the assets	To filter, click . Filter assets by collection, and dynamic collections are signified by ), publishing channel, asset type, color (select up to five colors), approval status, whether the asset is in workflow, lock status, and whether the asset is linked to a Documents file. If there are taxonomies associated with the repository, you can also filter by whether the asset has been recategorized. Note: Standard collections are signified by before their names, and dynamic collections are signified by . If there are taxonomies associated with the repository, you'll see the Categories tab. Click this tab to search and filter by category. By default Include All Children is enabled so the filter results will display all images of the selected category and any subcategory. Deselect this option to limit the list exclusively to those images in the selected category. Search for standard property values (for example, created by or description), attribute values from custom asset types, or camera data for images created with a camera on the Fields tab. To search standard property values, select All from the Asset Type menu, select a property from the Field menu, select an Operator, enter a value to search for, and then press Enter. To search attribute values, select an asset type from the Asset Type menu, select an attribute from the Field menu, select an Operator, enter a value, and then press Enter. To search for camera data (such as where the picture was taken or by whom), the digital asset image must have been created with a camera, whether that's an actual camera or a device like a phone, laptop, or webcam. Filter by camera data as you would any other attribute. To add more filters, click Add. Additional filters are additive, as if there was an "or" between the filters. To clear the query parameters, click Clear. To remove a filter, in the search bar, click next to the filter. To pin the filter options to the assets view, click .
Search for assets	To search, click . If smart content is enabled on the repository, Oracle Content Management also searches tags that are automatically applied to images, and, after you add a search term, you'll see recommended keywords under the search box. Click a keyword to add it to your search. This brings images tagged with both words closer to the top of the result list and displays additional images tagged with the added keyword. To find images similar to another image, right-click an image, and then click Find Visually Similar. To find assets categorized similarly to another asset, right-click as asset, and then click Find Categorized Similarly. To pin the search criteria to the assets view, click .
View asset information	Hover over an asset to view the following information such as name, asset type, version, language, and icons representing the asset's status. The asset name. The asset type associated with the asset. The asset version. The asset language. If the asset has been added from Documents, you see . If the asset has been recategorized, you see . You must publish recategorized assets for the category changes to appear in publishing channels. If the asset is locked, you see . If the asset is in workflow, you see . The asset's status.
Open a project	To open a project, right-click it, and then select Open Item. You can control which file extensions are treated as projects in Preferences.
Switch between open projects	You can see all projects you have open in the same instance, regardless of their parent repositories, by clicking at the top right of the extension. Each project lists the project version. Projects that have unsaved changes are indicated with "(*)". Hover your mouse over a project to see what repository it's stored in.
Link the asset to the current project	Right-click the asset, and then select Link Asset. This option isn't available for Audition or if the asset is locked by another user. You can also link an asset by dragging and dropping the asset or clicking the appropriate icon at the bottom of the Asset view.
Move the asset through basic review	If the asset requires review, click Submit for Review. If the asset is already submitted and you're a repository administrator, you can Approve or Reject the asset. If workflows have been assigned to the repository you're viewing, use workflows instead of basic review.
Lock or unlock the asset	You can lock an asset so that no other user can edit the asset or add new versions. Right-click the asset, and then select Lock Asset, or, if you have previously locked the asset, select Unlock Asset.
Edit the asset's name, description, or attributes	You can edit the asset's name, description, or attribute values. Right-click the asset, and then select Edit Attributes. Edit values as necessary.
Convert an asset to a custom asset type	If the asset is based on an out-of-the-box digital asset type (Image, Video, Video Plus, or File), you can convert it to a custom digital asset type. Right-click the asset, and then select Edit Attributes. Choose a custom digital asset type, and then click Save.
Save a project as a new version	Right-click the project, and then select Save as New Version, or click at the bottom of the extension.
Reset changes made to a project	Right-click the project, and then select Download Latest Version, or click at the bottom of the extension. Downloading the latest version of the project overwrites any changes you've made.
Upload a new asset or a new version of an asset	Right-click the asset, and then select Upload Version from Selected Layer or Upload Version from Selected Image. This option isn't available if the asset is locked by another user. When uploading a new asset, it will be uploaded to the repository you're viewing. If you've selected any categories, collections, or channels, they'll be applied automatically to the asset. For new assets, you must also complete the following steps: Edit the name and description as necessary. Choose an asset type to apply to the file. By default, the repository's default language is selected. If this asset is in another language, choose it. The languages shown are those that are allowed in the repository and haven't yet been used for the item. By default, the asset is set as translatable. If you don't want the item to be translatable, select Non-translatable. If the asset includes attributes, enter attribute values as necessary. Click Save.
Refresh an asset added from Documents	For an asset that was added from Documents, you can check if the linked Documents file has been updated, and then refresh the asset to the latest version. You can quickly find all linked assets by selecting Linked in the filters panel. To check for updates and refresh an asset to the latest versions of the Documents file: Right-click the asset, and choose Check for Updates. If the asset can be updated, you see the following information: The asset name. The synchronization status. The current state of the asset. For example, if the asset has been edited, updating the asset will get rid of the asset updates and replace the asset with the current version of the linked Documents file. The current Documents file and version. To refresh the asset to the latest version of the Documents file, click Update. If the asset can't be updated, you see the reason: The asset is already in sync with the linked Documents file. The asset is locked. You don't have update permission for the asset's associated asset type. You don't have at least Viewer permission for the linked Documents file. You selected a localized version of an asset, and the associated asset type doesn't allow separate native media files for each language. In this case, only the master version of the asset can be updated. The updated media file in Documents isn't supported by the asset's associated asset type. To check for updates for a localized version of an asset, do so from the asset's Languages tab. Open the asset, click , and then select Languages.
Add a translation to an asset	To add a translation: Right-click the asset, and choose Manage Languages; or open the asset, click , and then select Languages. Click +. Edit the name and description as necessary. Choose a language for the asset. The languages shown are those that are allowed in the repository and haven't yet been used for the item. If the associated asset type allows a separate native media file for each language, click Add, then select whether to copy the file from an existing language or add a new media file from the selected layer or the selected image. If the asset includes attributes, enter attribute values as necessary. Click Save.
Set asset as translatable or not-translatable	Right-click the asset, and then select Make Item Translatable or Make Item Non-Translatable. When an item is designated as non-translatable, the option to add a language won’t appear on the right-click menu. If you change an item to non-translatable and it has existing translations, all translations are deleted and only the master language version remains.
Delete the project or asset	Right-click the project or asset, and then select Delete Item or Delete Asset.
View the asset in the web	Right-click the asset, and then select Open in the Web, which opens the asset in a browser.
View or edit attributes	To view the attributes associated with an asset, right-click the asset, or open the asset and click , and then select Attributes. To edit the attributes, click .
View categories	If a taxonomy is associated with the repository you're viewing, you can assign categories to the asset by opening the asset, clicking , and then selecting Categories. Categories provide a hierarchical organization that maps to your business structure and allows users to drill-down to find what they need.
View channels	To target the asset to publishing channels, open the asset, click , and then select Channels. To select a channel, click the search bar, and then enter a channel name or select a channel.
View collections	To view the collections an asset is a part of, open the asset, click , and then select Collections. To select a collection, click the search bar, and then enter a collection name or select a collection.
View translations	To view and manage all the translations for an asset, open the asset, click , and then select Languages.
View video	If you're viewing a video asset, open the asset, click , and then select Player.
View properties	To view asset properties, such as version, file size, and whether the asset has been published, right-click the asset, or open the item and click , and then select Properties. The properties also show the asset's language. If the asset is available in more than one language, you can view the properties for another language, by selecting a new language in the language drop-down list. If the digital asset image was created with a camera, whether that's an actual camera or a device like a phone, laptop, or webcam, you'll also see camera data (expand to view). The device embeds this data in the image file. It includes information such as the type of device, who took the picture, the time and date it was taken, where it was taken (GPS location), and camera information such as shutter speed, aperture, and lens information. This information can help you understand how the image was captured and, if you need to retake the picture, how to recreate or improve the image.
Switch version	The asset's version is shown with its properties. If the asset has multiple versions, you can switch between versions by clicking next to the version number and selecting a new version. To make previous version current, view the previous version, and then click Make this version current under the asset status. If the asset type associated with the previous version isn't the same as the asset type associated with the current version, then you won't see the option to make the previous version current.
View renditions	To view all the system and custom renditions associated with an asset, right-click the asset, or open the asset and click , and then select Renditions.
View tags	To assign tags to the asset, open the asset, click , and then select Tags.
View workflows	If workflows have been assigned to the repository you're viewing, you can view the workflows in the extension. To view workflows, open the asset, click , and then select Workflows.

Documents View

Documents view enables you to view and manage your Oracle Content Management files and folders.

You can perform additional tasks in Documents view:

Task	Description
Create a folder	To create a folder, click , enter a name and optionally a description, then click Save.
Navigate to a folder in the breadcrumb	At the top of the Documents view you see the breadcrumb (the folder path). Click a folder in the path to navigate to that folder.
Search for files or folders	To search for files or folders, next to , enter your search term, and press Enter. By default, you search the folder you're viewing. To search all folders, click , and remove the Current Folder criteria. Right-click a search result to perform actions on the file or folder. In addition to other actions, you can open the item's containing folder.
Open a project	To open a project, right-click it, and then select Open Item. You can control which file extensions are treated as projects in Preferences.
Switch between open projects	You can see all projects you have open in the same instance, regardless of their parent repositories, by clicking at the top right of the extension. Each project lists the project version. Projects that have unsaved changes are indicated with "(*)". Hover your mouse over a project to see what repository it's stored in.
Link a file to the current project (files only)	Right-click a file, and then select Link Item. This option isn't available if the file is locked by another user.
Embed a file in the current project (files only)	Right-click a file, and then select Embed Item. This copies the file to the current project.
Lock or unlock a file (files only)	You can lock a file so that no other user can edit the file or add new versions. Right-click the file, and then select Lock Item, or, if you have previously locked the file, select Unlock File.
Rename a file or folder	Right-click a file or folder, and then select Rename Item.
Add a file or folder to your favorites	Right-click a file or folder, and then select Add to Favorites, or, if you have previously added the item to your favorites, select Remove from Favorites.
Save a project as a new version	Right-click the project, and then select Save as New Version, or click at the bottom of the extension.
Reset changes made to a project	Right-click the project, and then select Download Latest Version, or click at the bottom of the extension. Downloading the latest version of the project overwrites any changes you've made.
Upload a new version of a file (files only)	Right-click a file, and then select Upload Version from Selected Layer or Upload Version from Selected Image. This option isn't available if the file is locked by another user.
Add a file to an asset repository (files only)	You can save a Documents file to an asset repository. Right-click a file, and select Add Item to Assets. Select a destination repository. Edit the name or description as necessary. Select an asset type to apply to the file. By default, the repository's default language is selected and the asset is set as translatable. If this asset is in another language, select it. The available languages are set in the repository. You can also elect to make the item non-translatable. Click Save. A copy of the item will be made and added to the repository as a new asset and so is listed as version one in the repository, regardless of the version number in Documents. For example, if you select v3 of a document and add it as an asset, it will be listed as v0.1 when viewing the asset in the repository. The asset will include on the asset tile, signifying that the asset is linking to a Documents file. If you change the Documents file, it won't automatically affect the asset. However, you can check the asset for updates and update the asset to the newest version of the Documents file at any time. If you permanently delete the Documents file, the asset remains in place, no longer linked to the Documents file.
Delete a project, file, or folder	Right-click a project, file, or folder, and then select Delete Item.
View a file or folder in the web	Right-click a file or folder, and then select Open in the Web, which opens the file or folder in a browser.
View properties	To view item properties, such as file size and owner, right-click the item, and then select Properties.
View tags	To assign tags to the item, right-click the item, select Properties, click , and then select Tags.

Links View

Note:

Links view isn't available in Audition.

Here are some points to know about Links view:

Displays those assets already linked to the project.
If an asset has a local change, an asterisk is appended to the end of the version number.
If a new version is available in the repository, a notation is made after the version number.

You can perform additional tasks in Links view:

Task	Description
Download the asset	Right-click the asset, and then select Download Latest Version to download the asset to your computer.
Upload a new version of the asset	Right-click the asset, and then select Upload New Version. This option isn't available if the asset is locked by another user.
View properties	To view asset properties, such as file size and whether the asset has been published, right-click the asset, or open the item and click , and then select Properties.
View renditions	To view all the system and custom renditions associated with an asset, right-click the asset, or open the asset and click , and then select Renditions.
View collections	To view the collections an asset is a part of, open the asset and click , and then select Collections.
View channels	To target the asset to publishing channels, open the asset and click , and then select Channels.
View categories	If a taxonomy is associated with the repository you're viewing, you can assign categories to the asset by opening the asset and clicking , and then selecting Categories. Categories provide a hierarchical organization that maps to your business structure and allows users to drill-down to find what they need.
View tags	To assign tags to the asset, open the asset and click , and then select Tags.
View workflows	If workflows have been assigned to the repository you're viewing, you can view the workflows in the extension. To view workflows, open the asset and click , and then select Workflows.
View video	If you're viewing a video asset, open the asset and click , and then select Player.

Attributes

To view the attributes associated with a custom digital asset, right-click the asset or click , and then select Attributes.

To edit attribute values:

Click .
If the asset was created from an out-of-the-box digital asset type (Image, Video, Video Plus, or File), you can convert it to a custom digital asset type by selecting a new asset type.
If the asset is translatable, you can choose the language for the asset. The languages shown are those that are allowed in the repository and haven't yet been used for the item.
Edit the attribute values as necessary, and then click Save.

Languages

To view and manage all the translations for an asset, right-click the asset, and choose Manage Languages; or click , and then select Languages.

Each language is represented by a tile that includes the name, version, type, status, and language.

You can perform the following actions:

Task	Description
Add a translation	To add a translation: Click +. Edit the name and description as necessary. Choose a language for the asset. The languages shown are those that are allowed in the repository and haven't yet been used for the item. If the associated asset type allows a separate native media file for each language, click Add, then select whether to copy the file from an existing language or add a new media file from the selected layer or the selected image. If the asset includes attributes, enter attribute values as necessary. Click Save.
Upload a new version for a translation	Right-click the translation, and then select Upload Version from Selected Layer or Upload Version from Selected Image. This option isn't available if the asset is locked by another user.
Set a language as the master	Right-click the translation, and then select Set as Master.
Set a language as translated	Right-click the translation, and then select Set as Translated.
Delete a translation	Right-click the translation, and then select Delete Translation.

Renditions

To view all the system and custom renditions associated with an asset, right-click the asset or click , and then select Renditions.

If an asset has several versions, you can switch between the latest version and previous versions using the drop-down menu next to the version number. Select a previous version from the drop-down to see renditions of that version. Author and modification date information about selected versions is displayed under the asset title. Previous versions cannot be edited unless first made current by clicking Make this version current. Published assets cannot be edited unless you select Save as new version.

For system renditions, right-click a rendition to perform the following actions:

Copy the rendition to create a customized version of the rendition.
Link the rendition to the current project.

For custom renditions, right-click a rendition to perform the following actions:

Link or embed the rendition to the current project.
Replace the rendition with the selected layer.
Replace the rendition with the selected image.
Delete the rendition.

Note:

Some options won't be available if the asset has been locked by another user.

Use Workflows in the Extension

If workflows have been assigned to the repository you're viewing, you can view the workflows in the extension. To open the workflows panel, right-click the asset or click , and select Workflows. The workflow panel has tabs representing possible workflow states:

Submit (displayed if an asset has no workflows in progress)—Select a workflow from the list of available ones in the selection box and click Submit for Review to initiate a workflow. If the asset has dependencies, you can choose whether to also submit the dependencies for review.
In Progress (replaces the Submit tab once a workflow is initiated for an asset)—A list of steps is displayed showing the progress of the asset through the workflow. Completed steps identify the person and date when an action was taken. If you have a responsibility for a step, the actions you can take are available in a selection box. You must confirm the action when selected and can add an optional comment. When the action is finished the next step, if there is one, is added to the list.
If the workflow has several completed actions, they may be grouped under an expandable heading labeled Audit Trail.

If you want to remove the asset from workflow without completing the workflow, click Cancel Workflow.
Completed (always displayed)—Displays a list of completed workflows for the asset if there are any, and the date each workflow was completed. Completed workflows can include both approved and rejected workflows. Each completed workflow can be expanded to see a detailed list of the actions in the workflow.

Update the Extension

When a new version of the extension is available, you'll see a notification at the top of the extension, prompting you to download it.

You can also check for updates by clicking

, and then selecting Check for Updates. You'll see either a message stating that the extension is up to date or a notification that an update is available, prompting you to download it.

Note:

In Audition, the extension options are available via the command bar.

Troubleshoot the Extension

If you need to report an issue with the plug-in, you can zip up your log files and send them to support. Click , and then select Troubleshooting. You’ll be prompted to save the .zip file of your logs.

Uninstall the Extension

To uninstall the extension on Microsoft Windows:

Open Microsoft Windows Settings, open Apps, and then open Apps & features.
Next to Oracle Content Extension for Adobe, select the app or open the More menu, and click Uninstall.

To uninstall the extension on Apple Mac:

Open a Terminal window at the following location: ~/Library/Application Support/Oracle/Adobe
Enter the following command: sudo bash ./uninstall.sh