Nuxeo for Adobe CC

The Nuxeo for Adobe CC connector enables Adobe Creative Cloud users to import assets into an InDesign document directly from the Nuxeo repository. Link to the repository is maintained so as to facilitate updates of the referenced assets. Users can access the assets directly from Illustrator or Photoshop to make edits and trigger update warnings in InDesign.

Hyland University

Watch the related courses on Hyland University:
Adobe CC Connector

Requirements

Nuxeo for Adobe CC is compliant with Adobe CC 2018 and 2019 and requires Nuxeo Platform 9.10 or newer, along with the Nuxeo for Adobe CC marketplace package installed on your Nuxeo instance. Make sure that the Nuxeo DAM addon is installed on your instance and, ideally, that the DAM external template has been included in your Studio package (template should not be required, however).

Support

For support related to the connector, please contact Nuxeo Support via your regular support channels.

Installation

Installation is made of two steps:

Install the server-side Nuxeo Package available from the marketplace.
If you have previously used a Nuxeo Adobe connector, clear the application preferences by pressing and holding Alt+Control+Shift (on Windows) or Option+Command+Shift (on macOS) as you start Photoshop/InDesign/Illustrator
Please contact your Nuxeo Account Executive for access to the local client side plugin installation.

Once the installation done, a new extension "Nuxeo CC Connector" is available on your Photoshop, InDesign or Illustrator application.

Licensing Information

Once Nuxeo for Adobe CC is properly installed, launch InDesign CC 2018/2019/2020 (licensing dialog does not appear in Photoshop or Illustrator) to see a dialog requesting license information:

If you have a license key for Nuxeo CC Connector (provided to you by Nuxeo Sales), click “Yes” to activate now, or click “No” to activate later. You can activate in InDesign later via the Nuxeo dropdown menu item.

If you have questions related to licensing, contact your Nuxeo sales representative or contact Nuxeo at [email protected].

Using Nuxeo CC Connector

Logging into Your Server

From the main InDesign, Photoshop or Illustrator menu, choose Window > Extensions > Nuxeo CC Connector

This will launch Connector and the Server Setup panel.

Initially, you will need to create a server listing for your Nuxeo Instance. Once the listing is created, you can simply select it to log in.
To create your server listing:

Fill in the field New Server Name with a "friendly value" to represent your Nuxeo instance.
Fill in the field New Server URL with the address of your Nuxeo instance (this is the same URL you would use to access your Nuxeo instance via the web. Be sure to include the http/https value and leave off any /nuxeo that might be included).
Click Add Server to List button. You should now see this value in your “Server List”

To login:

Select your server from the list and click Connect. This will launch the Nuxeo login panel.
Enter your username and password and click Log In.

You should now see the connector populated with images that reside in your Nuxeo Instance.

If, however, you see something like this, then contact your Nuxeo Admin to confirm the Nuxeo for Adobe CC marketplace package is installed.

To logout, simply select Log Out from the Nuxeo Connector fly out menu.

You can always access the fly out menu by clicking on the burger menu in the upper right corner of the connector.

Preferences

The connector has a number of customizable preferences to enhance your workflow. Below are the preferences available within InDesign.

Place Options (InDesign only)

Replace Selected on place
- when checked: Replaces any selected object with the asset you drag onto the page.
- When unchecked: Dragging an item to the page, places it as a new object.
Choose between High and Low Resolution on Place

Download Options

Open File on Download
- when checked: Opens any downloaded file if possible (depends on Adobe app).
Save to default folder: Saves downloaded files to your User Documents\nuxeo_connector_files\downloads folder.
- When unchecked: the User will be presented with the System browser to choose a folder.
Choose folder location: Select the location for your downloads.

Asset View

Use Grid view: Displays assets in a gallery.
Use List view: Displays individual assets at width of the Connector panel, providing file name when hovered over the bottom of each asset.

Troubleshooting

Write to log file: When checked, creates a log file in your Documents/nuxeo_connector_files folder
Clear log file: Click this to clear the log file.

Functional Overview

Finding Content (InDesign, Photoshop and Illustrator)

The connector has three tabs, each with slightly different behavior: Search, Browse and Other.

Each tab uses a different page provider, included with the server-side Nuxeo for Adobe CC package, to control behavior. The page providers can be overridden in Nuxeo Studio to reflect your own content model and needs, such as displaying more results per page. For more information on page providers and overriding them, read the related documentation

Search Tab

By default, when logging into the repository via the connector, the first view you see is the search tab. The search bar supports wildcard operations, as in the example, and search the full-text index of the repository (including file names, and metadata fields).

The Search tab allows you to search through all the repository at one time. It uses a page provider adobe-connector-all-images to control the objects searched and the query results.

Once you’ve entered your search terms in the Search field, clicking on the search icon lists the results below.

Results are shown in pages and you can navigate between pages using the arrow keys at the bottom of the panel.

You can also jump to a given page.

Whenever using the connector, if you want to perform a search, you can choose Search from the Nuxeo CC Connector panel fly out menu, or just click on the Search widget.

To see more information about the object, double click the thumbnail to see more information. Each object comes with a detail view containing:

The thumbnail of the asset
Filename/title, creator, usage info (mapped to dc:rights) and the lifecycle state.

To download a copy of an asset from Nuxeo CC Connector, click the blue download arrow to the right of the thumbnail to begin the download process. For more information, see Download Options in Preferences section.

Browse Tab

The Browse tab allows you to browse through the hierarchical setup of the repository. It uses the adobe-connector-browse page provider. While browsing, you can still use the search bar; the search content is limited to the level in the hierarchy that you are currently viewing. You have the choice between a grid view (default) and a list view. You can toggle between view options using the buttons near the search bar.

The browse tab is easy to use by clicking on the folders in the hierarchy. Note that as you click through the repository, a breadcrumb is generated just above the content view, which allows you to easily go back to any point within your path. Simply click on one of the levels to change location. If your path becomes too long to fit the panel, a slider appears to allow you to move “up” or “down” the path.

As indicated earlier, to see more information about an object, double click into the item to see the detail view, where you can also download the file.

Other Tab

By default, the other tab displays the collections you have access to. You will see the search bar here, but it is not supported within collections.

The Other tab, by default, is configured to work with the Collections within your repository. Two separate page providers are used to surface the collections and their content: adobe-connector-other_primary and adobe-connector-other_secondary. It is called "other" because you could configure it to show any "other" two step page provider query you want such as "Favorites".

Working in InDesign

Nuxeo CC Connector Menu Listings (accessed via the burger menu)

The Nuxeo CC Connector fly out menu has several options to assist the user:

About takes you to our website
Refresh re-establishes an updated connection to your current folder
Upload from Disk opens your System Browser to upload an asset to your current Connector folder
Upload Selected uploads locally placed assets in InDesign to your current Connector folder (be sure to use “Relink…” as described below once saved)
Upload InDesign Document uploads open (If saved) InDesign doc to your current Connector folder. You will be presented with an Upload option to either, Upload New File, or Replace.
Compound Doc Info ensures HTTP links record a proper ID on the Nuxeo Server
Upload All Non-HTTP Assets uploads all locally placed InDesign assets from your open InDesign document to your current Connector folder
Relink to Current Folder relinks locally placed InDesign assets to the Current Connector folder, if they can be found there
Preferences opens Nuxeo CC Connector Preferences
About Silicon Publishing takes you to siliconpublishing.com

We can use the above menu items to work with the Nuxeo repository from within the Creative Cloud application

Starting from a new INDD file:

Start with new INDD file
Locate items from within the repository to place
Once you’ve found an image to use, drag it into to your InDesign document (can be from any view).
Before dropping it, releasing your mouse button to load your cursor with the asset’s thumbnail. Then drag your image to size and place it into your document.
If you are a power user who needs InDesign’s Show Import Options for PDF or other image types, hold down the alt/option key when you drag and drop.
For local files, place them as usual, then use the connector menu panel to upload them to the repository.
Select the local files and choose to “upload selected items” in the menu list or
Use the menu list and choose to “upload non-http items”
Once local items are in the repository, be sure to “relink to current location” from the menu list. This will ensure the links are maintained server side.
If you have not already browsed to the location where you want to store the InDesign file, use the browse tab to navigate to your intended destination. Upload the INDD document using the Nuxeo CC Connector fly out menu (Upload Indesign Document).

You will be asked if you want to Upload new file or Replace. As a new file, you need to choose Upload new file and then Upload.

If you intend to continue working on this document, immediately after the initial save to the repository, YOU MUST first close the document, then open again by dragging and dropping the file from the panel, into the main InDesign window. This ensures future uploads of the file will be recognized as replacements for this file.

Working with an existing repository InDesign file: To open InDesign files stored in the repository, simply drag and drop the file from the panel to the main view of the application.

After you have worked on your file (following instructions above for placing assets), use the Nuxeo Adobe Connector fly out menu to upload the file as before. Use "Replace" to update the same file in the DAM. Use "New" to create a new file in the DAM.

If you did not open the InDesign file from the Connector panel (via drag and drop) and you choose “Replace”, you will still get a “new”/duplicate file in the repository.

Using the Nuxeo CC Connector includes features within the traditional InDesign Links panel as well.

Choose to work with the high resolution (HQ) or low resolution (LQ) rendition of the file by double clicking the entry in the Nuxeo column in the panel (you might need to expose the column in the “Panel Options” seen in the panel fly out). Be notified when updates have been made to the placed repository items, so that you can update the items in the InDesign document (note - you also see this on the placed image within the document) Select a link and choose to “Reveal in Nuxeo” which will open the file in your Nuxeo web instance to see more information about the file.

Working in Photoshop/Illustrator

Photoshop and Illustrator have both access to Nuxeo CC Connector when you install the program.

If you want to edit an existing file from your Nuxeo account:

Drag and Drop your asset from Connector, just like you would in InDesign.
A copy of the file will be saved locally at nuxeo_connector_files\downloads in your Documents folder, and then opened in your Adobe application.
Make your edits in Photoshop or Illustrator and save.
Once your local file is saved, choose Upload Photoshop (Illustrator) Document from the Nuxeo CC Connector fly out menu.
You will be presented with an option to either, Upload New File, or Replace.

When edits are made to repository content using the Connector, users in InDesign who have placed the content will be notified that updates are available.

Uninstalling Nuxeo CC Connector

Nuxeo CC Connector has two parts: an extension to provide the panel and a plug-in to provide the underlying linking technology.

On Mac

Remove the extension folder:

/Library/Application Support/Adobe/CEP/extensions/NuxeoCCConnector.

Remove the plug-in folder (if used with InDesign, follow the path for the specific CC version):
```
/Applications/Adobe InDesign CC 201x/Plug-Ins/SiliconConnectorNuxeo.
```

On Windows

You can use the Windows Control Panel to uninstall Nuxeo for Adobe CC like you would do with any other installed application. If you need to uninstall manually, you can remove the following folders:

Remove the extension folder:

C:\Program Files (x86)\Common Files\Adobe\CEP\extensions/NuxeoCCConnector.

Remove the plug-in folder (if used with InDesign, follow the path for the specific CC version):
```
C:\Program Files\Adobe\Adobe InDesign CC 201x\Plug-Ins\SiliconConnectorNuxeo.
```

Network Considerations (for Nuxeo Administrators)

Since Nuxeo CC Connector requires network access to Nuxeo and the Silicon Publishing licensing server, there are certain network requirements to consider. You may find that working from home, where there is not proxy or firewall, you can use Silicon Connector for Box without a problem, but at work you run into errors when trying to activate or use it.

Proxy

You can configure your proxy settings in the SC.properties file located in:

mac:

/Users/<username>/Library/Preferences/SiliconConnector/

Windows:

C:\Users\username\AppData\Local\SiliconConnector\

This file can be edited with a basic text editor and is documented with definitions of each property. Properties should be formatted with key=value syntax, e.g. sc.http.proxy_server=proxyserver.com

Firewall

If your company has a firewall, you will need to be sure to whitelist the Silicon Publishing licensing server. The url to whitelist is https://licensing.siliconpublishing.com.

Roadmap

Below are the evolutions and improvements planned for the Nuxeo Adobe Connector.