Alfresco CC Connector allows browsing, searching, uploading and downloading files stored in the Alfresco DAM without having to leave your Adobe Creative Cloud application. It also enables low-level direct http linking to assets stored in Alfresco from Adobe InDesign, providing a workflow that is more efficient than traditional “duplicate and edit” workflows. In short, it gives you the opportunity to use your Alfresco DAM like it should be used - as a single source for all your assets.


Once you have Alfresco set up and configured, you’re ready to install and use Alfresco CC Connector.


Installing Alfresco CC Connector

To install Alfresco CC Connector, close Adobe InDesign and other CC applications. Double-click the installer and follow the prompts to complete the installation.


Alfresco on your local network

If you’re using Alfresco on your local network, you’ll need to add the address of the server. To do this, edit the alfresco_servers.txt and alfresco_sites.txt files. (See Configuring Your Server)


Alfresco on your own computer

By default, Alfresco CC Connector will look for a localhost instance of Alfresco at https://127.0.0.1:8080. If you had to set a custom Tomcat server port because of a conflict, you’ll need to configure the correct values in the alfresco_servers.txt and alfresco_sites.txt files. (See Configuring Your Server)


Configuring Your Server

Make sure InDesign is not running.


You’ll find the alfresco_servers.txt and alfresco_sites.txt configuration files in Documents/alfresco_ce_files/. These are plain text documents and can be opened and edited in a plain text editor and are formatted in JSON format.


alfresco_servers.txt

Open up alfresco_servers.txt in your user ~/Documents/alfresco_ce_files folder.

["http://127.0.0.1:8080"]

By default, it has http://127.0.0.1:8080. You can either change the url or add a new one by copying the current one and add a comma. Example: ["http://127.0.0.1:8080","http://exampleserver.com"].


alfresco_sites.txt

Then open up alfresco_sites.txt in your user ~/Documents/alfresco_ce_files folder. This is the contents, formatted for easier reading.

{  
   "currentSite":{  
      "server":"http://127.0.0.1:8083",
      "path":"/sites/",
      "title":"Local Server"
   },
   "username":"admin",
   "sites":[  
      {  
         "server":"http://127.0.0.1:8083",
         "path":"/sites/",
         "title":"Local Server"
      }
   ]
}

You will see the current site is set to the local server and then lists the sites.  You can add a site, and then change the current site to the one you added.


Save any changes you’ve made and you can now launch InDesign and open the extension and make sure to check “Select a site”.


Getting Started

Now that you're ready to use Connector, launch InDesign and choose Window > Extensions > Alfresco CC Connector from InDesign’s main menu.


You will be presented with a login screen. Insert your credentials and click OK.


Once your Alfresco Community Edition username and password have been accepted, you will be presented with the following:


Choose Local Server if you’re running Alfresco CE on your computer, or the server name if you’re using Alfresco CE on your network. Connector will load and take you to your Home location in the DAM.


You can find some images to work with by navigating from the Home location to Documents > Agency Files > Images.


Create a new document in InDesign and drag & drop an image to your page.


Preferences

Connector offers some Preference options to suit the user's needs.


Place Options

  • Replace selection on place
    • Checked: This causes the item you’ve selected to be replaced with the asset you drag to the page.
    • Unchecked: The asset you drag to the page will be placed as a new layer.
  • Use High Resolution on Place
    • Checked: Places full resolution images on drag & drop.
    • Unchecked: Places low resolution images on drag & drop.


Download Options

  • Open file on download (if possible)
    • Checked: Opens downloaded InDesign files after you have downloaded them to your machine.
    • Unchecked: Leaves InDesign files unopened after downloading them to your machine.
  • Save to alfresco_ce_files/downloads folder
    • Checked: Downloaded files will be saved to Documents/alfresco_ce_files/downloads/.
    • Unchecked: The user will be prompted to choose a location to save their downloaded  files.
  • Edit Offline (Detail view only)
    • Checked: Allows the user to lock a downloaded asset before uploading any changes.
    • Unchecked: Downloads a copy of the asset, leaving the asset in the DAM unlocked.
    • NOTE: To Edit Offline or download a copy of an asset from Alfresco CE, double-click the asset you want to download or edit to get an expanded thumbnail of your asset. Then click the download arrow to the upper left of the thumbnail to lock the asset, or begin the download process.


Upload Options

  • Create new version on upload
    • Checked: Creates a new version of a file if a file of the same name already exists in the DAM.
    • Unchecked: Will overwrite a file if a file with the same name and extension already exist in the DAM.


Asset View:

  • Use Grid View:  Displays assets in a gallery with truncated file names
  • Use List View:  Lists assets with smaller thumbnails and extended file names


Troubleshooting

  • Write to log file: Writes some debugging information to a log file at Documents/alfresco_ce_files/alfresco_log.txt


Alfresco CC Connector Menu

The Alfresco CC Connector flyout menu has several options to assist the user:


  • About provides information about Alfresco CE Connector.
  • Log in displays the Login dialog.
  • Log out logs out the user.
  • Home returns the user to the Home location in the DAM.
  • Back returns the user to the last folder visited.
  • Search opens the Search window.
  • Refresh reloads the contents of the current folder.
  • Upload from Disk opens your System Browser to choose an asset to upload to the folder currently displayed in the Connector panel.
  • Upload Selected uploads a selected non-Http asset from your InDesign document to folder currently displayed in the Connector panel.
  • Upload InDesign Document uploads any saved InDesign document open in InDesign when assets come from the same Connector folder you are uploading to. See *Note
  • Upload All Non-Alfresco uploads any asset in your current InDesign document that is not already linked directly to the Alfresco DAM.
  • Relink to Current Folder will relink any local assets in your InDesign document to assets of the same name in the current folder shown in the Connector panel. If an asset with a matching name is not found in the DAM for any local assets, you will receive an alert telling you.
  • Preferences opens the Preferences window.
  • Sites... opens the Select a Site dialog to change or edit Server Sites.
  • Empty Uploads Folder will empty any files you have saved locally via Uploading through Connector.
  • About Silicon Publishing takes you to siliconpublishing.com.


*NOTE: The Connector panel will upload the InDesign document to the folder displayed in the panel. Make certain that you have uploaded any local assets in the file, and have relinked to the uploaded versions of the assets, and that you have saved the InDesign file after relinking. If the file has not been saved, the previous saved version will be uploaded. If the file contains local asset links, those links will remain local links in the uploaded file. After the file has been uploaded, the Connector panel will close the file and then move the file to the uploads folder in the alfresco_ce_files folder in your Documents folder.


Uninstalling Alfresco CC Connector

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


Mac

Remove the extension folder:
/Library/Application Support/Adobe/CEP/extensions/AlfrescoCCConnector


Remove the plug-in folder:
/Applications/Adobe InDesign CC 2017/Plug-Ins/SiliconConnectorAlfresco


Windows

You can use the Windows Control Panel to uninstall Alfresco CC Connector like you would any other installed application.

If you need to uninstall manually, remove the following folders:


Remove the extension folder:
C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\AlfrescoCCConnector


Remove the plug-in folder:
C:\Program Files\Adobe\Adobe InDesign CC 2017\Plug-Ins\SiliconConnectorAlfresco