With the FrameMaker connector for CQ, you can connect to Adobe CQ and use it as a Web Content Management System and use its Digital Asset Management (DAM) capabilities.
With CQ DAM, digital assets are easy to find, share, comment on, revise, and publish. CQ DAM uses globally accessible repositories for shared, permissions-based access to digital media assets. It uses web-based shared workspaces for workflow-based sharing of ideas.
FrameMaker provides you support for editing and updating CQ meta data of DAM FrameMaker assets, which simplifies file and version management. XMP metadata is platform independent and you can customize it to meet your CMS needs. For more information about XMP metadata, see Adobe XMP website.
Both FrameMaker and CQ support XMP. When you upload a FrameMaker binary file (.fm, .mif, or .book) to CQ using DAM, the file info (File > File Info) of the file is added to the CQ metadata of the file.
Once you add file info to a FrameMaker binary file and upload it to CQ DAM, you can right click the asset and see the file info included as its metadata.
Specify the connection details, such as server name, user name, and password to connect to your CMS. Also, specify a unique name for the connection.
The value in the Name field uniquely identifies each connection. All connections are added to the favorites list. The list can store a maximum of eight favorites. If you try to store the ninth connection, the first connection on the list is removed to accommodate it. The connection list works in a first in, first out manner.
The CQ folder structure includes a DAM folder (Content > DAM). To use Digital Asset Management capabilities of CQ, upload the assets into this folder. You can manage your content using folders other than DAM, but folders other than DAM do not support DAM features and workflows.Dependent Files
Adobe CQ understands FrameMaker file dependencies, such as book-chapter relations, cross references, and conrefs. While checking out a file, FrameMaker gives you an option to check out dependent files.
Dependent files for a book (*.book) file are:
- Chapter files in the book
- Generated files in the book (such as table of contents and Index)
- Files connected to any of the files in the book through cross references, and text insets
You can change the following CQ preferences using the CQPreference.xml file (located at FMHome, for example: InstallDir\Program Files \Adobe\AdobeFrameMaker11):
- ShowOnlyDam: Display only DAM related assets in the repository manager or not
- SuppressAlert: Display CQ alerts as alert messages or in the FM console window
- FileNameRestrictions: In the filenames, allow all characters or only the alphanumeric and specified special characters
To set up CQ preferences:
Preference Values Default Value ShowOnlyDam true displays only the DAM related folders\assets for which you have read permissions in Repository Manager.
false displays all the folders in Repository Manager.
For example, if this field is set to true, and folders is set to "content,apps" FrameMaker displays only two folders in the content repository: content and apps. If this field is set to true and folders is set to “content/dam” the content repository displays content as top level folder and dam as a sub-folder.
true SetUserArea folders Mention the CQ application folder where all the FrameMaker files are downloaded from CQ to the local disk. This field is blank by default. When you do not edit this field and keep it blank, the default folder is:
SuppressAlert true suppresses the alert messages, such as missing dependent file alerts while uploading/checkin/checkout files, and displays the message content in the FM console window file.
false does not suppress the alert messages.
false FileNameRestrictions anychar
true allows all the characters and special characters in the filenames in the repository.
false lets you specify the allowed characters in the repository filenames using AlphaNumeric and OtherCharsSpecialChars values.
By default, Unicode is not supported in filenames. To enable Unicode characters in new folder and filenames, switch off the restrictions. (set FileNameRestrictions anychar = true).
false AlphaNumeric This preference is relevant only when AllowedCharInFileName anychar is set to false.
true allows alphanumeric characters in filenames.
true SpecialChars values This preference is relevant only when AllowedCharInFileName anychar is set to false.
List the other characters that are allowed. For example, to allow “-” and “:” in the repository filenames set the value of this field to: “-:”.
none ShowProgressBar valueq true shows a progress bar for displaying the progress of operations, such as check in, check out, download.
false does not display the progress bar.
Enter one or more of the following search criteria:
- Full Text: Enter title of the document to search (You can use wildcard symbols).
- Path: This field has the path of the folder you selected for searching the DAM assets. To select a different DAM folder, edit the path or click browse to select a DAM folder.
- Modified From and To: To search for assets modified during a period, specify the From and To dates. To search for assets created after a particular date, specify the From date. To search for assets created before a particular date, specify the To date.
- Filetypes and ellipsis buttons: To specify the filetypes to be searched for, select Filetypes and select one or more of the four filetypes, FrameMaker Files, Images, Multimedia, and Documents. For the selected filetypes, click the relevant ellipsis buttons to select further filetypes. By default, all the subtypes of the selected filetypes are in the include list. Move items to the Include scroll list. To move an item between scroll lists, select the item and click an arrow or double-click the item. To move all items from one scroll list to the other, Shift-click an arrow.
- Other types: To search for the filetypes other than the ones covered under FrameMaker Files, Images, Multimedia, and Documents, specify the mime-types of the file types separated by commas. For example, application\FrameMaker is mimetype for FrameMaker documents.
- Tags and ellipsis buttons: To search using the metadata tags, select the metadata tag categories, such as Business, Industry, and Lifestyle. Click the relevant ellipsis buttons to select the metadata tags. Move items to the Include scroll list. To move an item between scroll lists, select the item and click an arrow, or double-click the item. To move all items from one scroll list to the other, Shift-click an arrow.
- Other tags: To search using the metadata tags other than the ones covered under the given categories, specify the metadata tags (using full qualified names/CQ TAG IDs) separated by commas, such as stockphotography:business/business_travel.
The CQ folder structured includes a DAM folder (Content > DAM). To use Digital Asset Management capabilities of CQ, upload the assets into this folder. You can manage your content using folders other than DAM, but folders other than DAM do not support DAM features and workflows.
Right-click a folder and select Upload Document. FrameMaker uploads the file and all its dependencies.
Right-click a folder and select Upload Folder. Only one version of each file is created. File having dependency, is uploaded more than once, but CQ Connector creates only one version.
Right-click a file or folder and select Delete. While deleting a file, you can choose to delete its dependent files. If you try to delete a file that has a dependent that is locked, the delete operation fails.
Select a file or folder, right-click, and select Cut or Copy. Then select the intended parent folder in DAM, right click and select Paste. The file\folder is inserted as a child. You can copy any asset in DAM, but you can cut only the ones for which you have modify permissions. to paste an asset in a folder, you need to have modify permissions.
Right-click a folder or file and select Properties. FrameMaker displays the attributes (Properties) panel.
You can perform a simple search on node-name by entering search string in the search field in Repository Manager and clicking search or pressing Enter. You can also use asterisk (*) in search for filenames.
When you upload an asset (file\folder) already present in DAM, FrameMaker creates a minor version of the asset. This happens only if the present asset in DAM is not locked by a user.
- A file locked by Adminin in DAM cannot be copied by a user. Expected: A locked file can be copied by other users.
- Keyboard shortcuts for Cut, Copy, and Paste (Ctrl X, Ctrl C, and Ctrl V) do not work in the CQ Connector UI.
- For NT (non DAM) files, if you check out a file and restart the CMS session (log out and log in), cancel check out does not work.
- Error “Cancel Checkout Failed: Precondition Failed” occurs in the following scenario:
- Checkout a file that has dependents without its dependents.
- Restart the CQ session (Log out and log in).
- Edit the checked out file.
- Cancel checkout for the file.