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 Typefi Connector for Adobe Experience Manager Guides

Typefi Connector for Adobe Experience Manager Guides enables you to easily integrate Adobe InDesign Server into your omnichannel publishing workflows. With Typefi’s Connector for Adobe Experience Manager Guides, go beyond the out-of-the-box PDF generation capabilities of DITA Open Toolkit, FrameMaker Publishing Server, or even the new native PDF publishing.

• Leverage the design, layout, and typographical capabilities of Adobe InDesign for both technical and marketing communications.
• Build sophisticated and flexible templates with InDesign that don’t compromise design consistency, support for translation services, or rapid time to market.
• Elevate your web-to-print capabilities to improve efficiency while protecting brand integrity.

In this guide

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

The information in this guide is organised as follows:

• About Typefi Connector for AEM Guides: This section introduces the benefits of using the Typefi Connector with AEM guides.
• Download and install: This section describes how to download and install Adobe Experience Manager, 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.
• Apply permissions: This section explains how to apply the necessary permissions to view a manage Typefi workflows in AEM.
• Run a Typefi job: This explains how to use the Typefi Connector.
• Additional resources: This section contains a list of other helpful resources.

Download and install

You will need to download and install Adobe Experience Manager (on-premise or through Adobe Managed Services), Adobe Experience Manager Guides, and the Typefi and Adobe Experience Manager connector. 

Compatibility with Adobe Experience Cloud service is coming soon.

First:

1. Download and install Adobe Experience Manager. 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.

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. See How to Work With Packages in Adobe‘s documentation for more information about working with the Package Manager.
3. Install the Typefi and Adobe Experience Manager connector:

1. 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/v1/workflows	Yes
   Username	Field	<Typefi worker account>	Yes
   Password	Field	<Typefi worker password>	Yes

3. Click Save.

Apply permissions for Adobe Experience Manager

These steps will help you set up the necessary permissions for users and groups in AEM to view and manage Typefi workflow jobs in the path:/content/typefi_jobs. Refer to the Principal View for Permissions Management page for more details about permission management.

1. If you‘re not already, sign in to your Adobe Experience Manager instance as an administrator.
2. Click the hammer icon along the left of the page. The Tools page opens.
3. Click on Security and open the Permissions card.
4. Use the filter to locate the users and groups you want to add or edit permissions. Clicking the name displays assigned permissions.
5. Add Access Control Entries (ACE) by clicking the Add ACE button.

6. Type /content/typefi_jobs in the Path box.
7. Add the following privileges for /content/typefi_jobs:
   • jcr:write
   • jcr:readAccessControl
   • jcr:lockManagement
   • jcr:versionManagement
   • jcr:nodeTypeManagement
   • jcr:retentionManagement
   • jcr:lifecycleManagement
8. Select Allow permission type.
9. Click Add.

Verify permissions and privileges

1. Return to Permissions.
2. Select users or groups that need privileges to the path: /content/typefi_jobs.
3. Verify that permissions are set to allow and all privileges were entered correctly. If needed, make adjustments by clicking the editing tool.

If you are using Adobe Experience Manager Guides, confirm that jcr:read privileges are set for paths: /,/var/dxml, and var/dxml/profiles.

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. Choosing All files returns three file types: the PDF, the composed InDesign document/book, and the most recent CXML used to create the INDD document.
   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 save the output files to your computer, or click View to see a list of returned 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