Installation

To install Silicon Connector for AEM, simply run the installer provided. This will be something like SiliconConnectorForAEM_1.x.x.pkg for Mac and SiliconConnectorForAEMSetup_1.x.x.exe on Windows.

Configuration

To configure Silicon Connector for AEM, you will need to edit a configuration file called SC.properties. This file is installed by default but is also included as an attachment to this article at the bottom of the page. The file is well documented and can be edited with a standard plain text editor. You'll find the file at

Mac: /Users/username/Library/Preferences/SiliconConnector/SC.properties

Win: C:\Users\username\AppData\Local\SiliconConnector\SC.properties


Credentials

The most common property you'll need to edit in the SC.properties file will be sc.aem_userid and sc.aem_pw. These set the username and password you use to log into AEM. To set these values, remove the leading "#" from the sc.aem_userid=admin and sc.aem_pw=admin lines and replace "admin" with your own credentials.

#—————————————————————————————————————————————————————————————————————————————————————————————————-
# AEM CONNECTOR SETTINGS 
#
# remove the leading # from the property to override the default value
#—————————————————————————————————————————————————————————————————————————————————————————————————-

#sc.aem_userid is the AEM user id to use when connecting to the AEM server
#sc.aem_userid=admin

#sc.aem_pw is the AEM user password to use when connecting to the AEM server
#sc.aem_pw=admin


Proxy

If your organization's network uses a proxy, Silicon Connector for AEM should auto-detect it and work without additional configuration. Depending on the specific network environment, this may not work and you'll need to manually set the proxy configuration in the SC.properties file.

#—————————————————————————————————————————————————————————————————————————————————————————————————-
# ACTIVATION HTTPS PROXY SETTINGS 
#
# remove the leading # from the property and set a valid value to use it
#—————————————————————————————————————————————————————————————————————————————————————————————————-

#sc.https.proxy_auto_detect specifies whether to automatically detect the system’s HTTPS proxy settings (true or false)
#sc.https.proxy_auto_detect=true

#sc.https.proxy_server is the HTTPS proxy server to use
#sc.https.proxy_server=proxyserver.com

#sc.https.proxy_port is the HTTPS proxy port to use
#sc.https.proxy_port=80

#sc.https.proxy_id is the HTTPS proxy user id
#sc.https.proxy_id=user_id

#sc.https.proxy_pw is the HTTPS proxy user password
#sc.https.proxy_pw=password

#sc.https.verify_ssl_certifcate specifies whether to verify the peer's SSL certificate (true or false)
#sc.https.verify_ssl_certifcate=true


Other properties are documented with the comments in the SC.properties file.


Scripting

For enterprise installations, configuration of Silicon Connector for AEM can be automated using scripting. At the bottom of this page, you'll find the reference guide attached.


General use

Activation

When you launch InDesign CC 2017, you will be presented with a dialog telling you that you're using a trial of Silicon Connector for AEM.


If you have purchased a license, click Yes. Another dialog will open where you can enter your license key. The license key will look something like B2SRJ-U2YRC-3ACJG-KF99B-8E9D9.


You can also activate Silicon Connector for AEM with the menu Connector > Activate... from the main InDesign interface. The same dialog will open for entering the license key.



Using Connector from AEM

Silicon Connector for AEM allows drag and drop directly from AEM into your InDesign Document.


If you plan on making use of AEM’s "Renditions" feature, be sure to enable that feature from the Links Panel menu, via Panel Options.


Your AEM Renditions will be named with the file’s resolution appended to the end of the file name you are using. If you are using the original image, the Links panel will display the Rendition as "original".

 


To replace a low-resolution rendition with a higher resolution one, select your placed image and drag a higher resolution rendition on top of that image. You can swap any image from AEM using this select and replace method.

 

Here’s a placed Rendition:

 

Here’s how the ‘Rendition’ appears in the Links Panel:




Using Connector from Adobe InDesign

Opening AEM CC Connector

From the main InDesign menu, choose Window > Extensions > AEM CC Connector 

You will be presented with a log in. Just type in your credentials to start using AEM CC Connector. 


 


If you have not gone through Server Setup, click the Gear icon to launch the dialog. Enter your Server URL and click Add Server to include it to the Log In Server list. Finally, click OK to Log In,and start using AEM CC Connector. If Connector is already up, just choose Register to Log In, or change your server location



If you have already gone through Server Setup, select a server from your Server drop down menu. Enter your User Name and Password, then click OK.



Once logged into AEM CC Connector

The User can navigate from folder to folder to find an image or asset, preform a Search by clicking on the Spy glass, or choosing Search from the AEM CC Connector menu.



Once you’ve found an image to use, drag it into to your InDesign document. Before dropping it onto your page, releasing your mouse button to load your cursor with a thumbnail. Then drag your image to size and place it in your document.





You can also return to previous folders navigated by expanding the top of the AEM CC Connector Panel to reveal the breadcrumb path back to your Home directory.




Once logged into AEM CC Connector

The User can navigate from folder to folder to find an image or asset, preform a Search by clicking on the Spy glass, or choosing Search from the AEM CC Connector menu.


AEM CC Connector Preferences

AEM CC Connector has a number of customizable preferences to enhance your workflow. 



Detail View

To download a copy of an asset from AEM CC Connector, double-click the asset you want to download for an expanded thumbnail of your asset. Then click the download arrow to the left of the thumbnail to begin the download process. For more information, see Download Options above.





AEM CC Connector Menu Listings

The Silicon Connector for Box flyout menu has several options to assist the user:




Working with Connector in Photoshop and Illustrator

Photoshop and Illustrator both have access to AEM CC Connector when you install the program. If you wish to edit an existing file from your AEM account, Drag and Drop your asset from Connector, just like you would in InDesign. A copy of the file will be saved locally at aem_cc_files\downloads  in your Documents folder, and then opened in your Adobe app.  Make your edits in Photoshop or Illustrator and save. Once your local file is saved, choose Upload from the AEM CC Connector flyout menu. You will be presented with the System browser to locate your saved file for upload.




Network Considerations


Since AEM CC Connector  requires network access to AEM 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

/Users/<username>/Library/Preferences/SiliconConnector/ (Mac)

C:\Users\username\AppData\Local\SiliconConnector\ (Win)


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.



Uninstallation

Should you need to uninstall Silicon Connector for AEM, we recommend deactivating first. You can do this using the menu item Connector > Deactivate.


Installing an updated version of Silicon Connector for AEM does not require any manual uninstallation of the previous version or deactivating.


To uninstall Silicon Connector for AEM completely, you'll need to quit InDesign, then remove the following folders:


Mac

/Applications/Adobe InDesign CC 2017/Plug-Ins/SiliconConnectorAEM

/Users/username/Library/Preferences/SiliconConnector


Windows

You can use the Windows Control Panel to uninstall Silicon Connector for AEM like you would any other installed application.


If you need to remove the folders manually, they are in the following locations:

C:\Program Files\Adobe\Adobe InDesign CC 2017\Plug-Ins

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