Install and configure the Typefi connector for Adobe Experience Manager

This documentation is intended for the following audiences:

• Administrators, who would install and manage the Typefi connector for Adobe Experience Manager.
• Content authors and editors, who use Adobe Experience Manager Guides* (formerly XML Documentation for Adobe Experience Manager) and want to create InDesign layouts and PDF or other print outputs using Adobe InDesign Server.

You should also have experience working with Typefi workflows in Typefi Server.

^* Adobe Experience Manager Guides was formerly branded as XML Documentation for Adobe Experience Manager. A name change occurred on 11 May 2022. Please note certain references within the documentation may still refer to prior branding but are still applicable to the current offering.

About this guide

Adobe Experience Manager includes Adobe Experience Manager Guides. Adobe Experience Manager Guides provide structured content management capabilities to author, manage and deliver relevant, personalised and consistent experiences for post-sale and support content.

The Typefi connector for Adobe Experience Manager Guides enables you to easily integrate structured DITA content with Adobe InDesign Server. With Typefi, you can:

• Create your own dynamic InDesign templates for automated publishing.
• Publish DITA content to Adobe InDesign Server.
• Fully automate the production of all print and digital outputs, or choose InDesign output for manual intervention.

This documentation provides the instructions to download, install, and configure the Typefi and Adobe Experience Manager connector.

Content structure

The information in this guide is organised as follows:

• About this guide: This section provides an introduction to this guide and how the information is organised.
• Download and install: This section describes how to download and install Adobe Experience Manager 6.5, Experience Manager Guides, and the Typefi connector.
• Configure the Typefi connector: This section explains how to configure the Typefi connector.
• Set up your Typefi workflow: This section describes how to set up your workflow in Typefi Server.
• Run a Typefi job: This explains how to use the Typefi connector.
• Troubleshooting: This section contains troubleshooting advice.
• Additional resources: This section contains a list of other helpful resources.

Download and install

You will need to download and install Adobe Experience Manager 6.5, Adobe Experience Manager Guides 3.8.x, and the Typefi and Adobe Experience Manager connector.

First:

1. Download and install Adobe Experience Manager 6.5. Follow the instructions in Adobe‘s Installation and Configuration Guide (Chapter 2: Install Adobe Experience Manager).
2. Download and install Adobe Experience Manager Guides. Follow the instructions in Adobe's Installation and Configuration Guide (Chapter 2: Download and install XML Documentation solution for the first time).
3. Sign in to the Typefi FTP and download the Typefi connector for Adobe Experience Manager.

The Typefi connector for Adobe Experience Manager requires com.adobe.aem:uber-jar:6.4.0
com. adobe.fmdita-6.5-3.8.166.

Then, install the Typefi connector for Adobe Experience Manager:

1. Sign in to your Adobe Experience Manager instance.
2. Go to the CRX Package Manager. The default URL to access the package manager is: http://<servername>:<port>/crx/packmgr/index.jsp. The Package Manager manages the packages on your local AEM installation. For more information about working with the Package Manager, see How to Work With Packages in Adobe‘s documentation.
3. Install the Typefi and Adobe Experience Manager connector:
   1. Click Adobe Experience Manager to open the Navigation page.
   2. Click the hammer icon along the left of the page to open the Tools page.
   3. Click General.
   4. Click CRXDE Lite.
   5. In the crxde interface, click the Package icon (the middle one along the top).
   6. Click Upload Package.
   7. Upload the installer package you downloaded from the Typefi FTP.
   8. After the package has been uploaded, click Install.

Configure the Typefi connector for Adobe Experience Manager

Go to the Configuration page in your Adobe Experience Manager instance

1. If you‘re not already, sign in to your Adobe Experience Manager instance.
2. Click Adobe Experience Manager. The Navigation page opens.
3. Click the hammer icon along the left of the page. The Tools page opens.
4. Click Operations.
5. Click Web Console. Configurations are listed in alphabetical order.

Complete the configuration

1. Scroll to the bottom and click Typefi Configuration.
   
2. Complete the configuration according to the configuration table:
   

   Property	Type	Value	Required
   Enable config	Boolean	Select to enable	Yes
   Protocol	Pop-up menu	http / https	Yes
   Server	Field	<URL for Typefi Server> Do not include the protocol; for example, "www.domain.com" and not "https://www.domain.com"	Yes
   Endpoint	Field	/api/v3/workflows	Yes
   Output folder	Field	/content/dam/typefi_outputs	Yes
   Default workflow	Field	Leave blank	No (deprecated)
   Username	Field	<Typefi worker account>	Yes
   Password	Field	<Typefi worker password>	Yes

3. Click Save.

Set up your Typefi workflow

1. Sign in to your Typefi Server as an administrator.
2. Install the Ant plug-in. See Install workflow plug-ins and actions for instructions.
3. Create a new Typefi workflow.
4. Add the Run Ant Buildfile action. This action must be the first action in the workflow.
5. Set the Input (required) to input_typefi_aem_dita_bundle.zip.
   
6. Set the Resources (required) to ZIP or XZIP file with DITA to CXML transformation. You must specify at least one resource in this input.
7. Set the Parameters (required) to pass the .ditamap file path and to select the XSL transformation file from Resources. Parameters are a collection of key=value pairs separated by semicolons. These are passed to the Apache Ant buildfile:
   job.dir=${job-folder};entry.xsl.filename=<transform>.xsl;entry.dita.file.subpath="+ditamap file location
   

   Parameter	Description
   job.dir=${job-folder}	Sets the destination to the Typefi job folder.
   entry.xsl.filename=<transform>.xsl	Sets the entry point for the XSL transform (DITA to CXML); a resources file may contain multiple transforms for different document types. This allows you to target a specific document type.
   entry.dita.file.subpath="+ditamap file location	Passes the source DITA map (from Adobe Experience Manager) to the transform. This must be entered exactly as shown (with the "), since the key is passed through as a string, but the value is a substituted placeholder.

8. Add the Create InDesign document or Create InDesign book action and the Input to ${job-folder}/content.cxml.
9. Add other workflow actions as needed.
10. Save your workflow.

Run a Typefi job

1. If you‘re not already, sign back into your Adobe Experience Manager instance.
2. Click Adobe Experience Manager to open the Navigation page.
3. Click Assets.
4. Click Files.
5. Select a .ditamap file.
6. Click Typefi.
   
7. In the Run Typefi Job panel:
   1. Choose PDF only (default) or All files. PDF only returns only the PDF output from Typefi. All files returns both the PDF and the composed InDesign document/book.
   2. Click the Attach button next to Typefi Workflow and select a Typefi workflow to attach.
   3. Click Run. After you click Run, you will be redirected to the Jobs panel. You can view the job status while the job is running and download and view the output files once the job is complete.
8. Click Download to download the output files to your computer, or click View to view the output files.

Review the Adobe Experience Manager Web Console Log files

1. Click the hammer icon along the left of the page to open the Tools page.
2. Click Operations.
3. Click Web Console.
4. In the top navigation bar, choose Status → Log Files.

See also

• Adobe Experience Manager Guides Learn & Support
• XML Documentation for Adobe Experience Manager User Guide
• XML Documentation for Adobe Experience Manager Installation and Configuration Guide
• XML Documentation for Adobe Experience Manager Best Practices Guide
• Package Manager
• Typefi for Adobe Experience Manager webinar recording