Edit the Adobe Experience Manager preferences in the CQPreference.xml file

Know how you can edit the preferences of the Adobe Experience Manager connector in Adobe FrameMaker using the CQPreference.xml file.

You can manage the preferences of the Adobe FrameMaker connector for Adobe Experience Manager using the CQPreference.xml (located in the FrameMaker installation directory).

To update the preferences, open the XML file in an XML or text editor and make change to the following properties, as needed:

Element/Attribute	Values	Default
`<ShowOnlyDam>` `@value` `@folders`	`value="true"` displays only the DAM related folders/assets for which you have read permissions in the Repository Manager. `value="false"` displays all the folders in the Repository Manager. For example, if `@value` is set to `true`, and `@folders` is set to `content,apps` FrameMaker displays only two folders in the content repository: content and apps. If `@value` 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.	`value="true"`
`<SetUserArea>` `@folders`	Specify the AEM application folder where all the FrameMaker files are downloaded from AEM 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: %APPDATA%\ Adobe\Frame Maker\CQ
`<SuppressAlert>` `@value`	`value="true"` suppresses the alert messages, such as missing dependent file alerts while uploading, checking in, and checking out files, and displays the message content in the FrameMaker console window file. `value="false"` does not suppress the alert messages.	`value="false"`
`<FileNameRestrictions>` `@anychar`	`anychar="true"` allows all the characters and special characters in the filenames in the repository. `anychar="false"` lets you specify the allowed characters in the repository filenames using `AlphaNumeric` and `SpecialChars` values. Note: 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`.	`value="false"`
`<AlphaNumeric>`	`true` allows alphanumeric characters in filenames. This preference is relevant only when `<FileNameRestrictions>` `@anychar` is set to `false`.	`true`
`<SpecialChars>` `@value`	List the other characters that are allowed. For example, to allow “-” and “:” in the repository filenames set the value if this field to: “-:”. This preference is relevant only when the `@anychar` attribute for `<FileNameRestrictions>` is set to `false`.	none
`<ShowProgressBar>` `@value`	`value="true"` shows a progress bar for indicating the progress of operations, such as check in, check out, and download. `value="false"` does not display the progress bar.	`value="false"`
`<AddHiddenDependencies>` `@value`	`value="true"` uploads dependencies, such as cross-references, text inset, graphics, hidden through conditional text or filter attribute while uploading a file. `value="false"` ignores all hidden dependencies while uploading a file	`value="false"`
`<ManageReferences>` `@value`	`value="true"` allows you to customize reference handling with menu and UI options `value="false"` maintains existing behavior	`value="true"`
`<AutoRefreshParent>` `@value`	`value="true"` refreshes the parent node (file or folder) in the Repository Manager after each operation, such as check out. `value="false"` does not refresh the parent node automatically. Set `@value` to `false`, if better performance is required.	`value="true"`

Element/Attribute

Values

Default

<ShowOnlyDam>

@value

@folders

value="true" displays only the DAM related folders/assets for which you have read permissions in the Repository Manager.

value="false" displays all the folders in the Repository Manager.

For example, if @value is set to true, and @folders is set to content,apps FrameMaker displays only two folders in the content repository: content and apps. If @value 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.

value="true"

<SetUserArea>

@folders

Specify the AEM application folder where all the FrameMaker files are downloaded from AEM 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: %APPDATA%\ Adobe\Frame Maker\CQ

<SuppressAlert>

@value

value="true" suppresses the alert messages, such as missing dependent file alerts while uploading, checking in, and checking out files, and displays the message content in the FrameMaker console window file.

value="false" does not suppress the alert messages.

value="false"

<FileNameRestrictions>

@anychar

anychar="true" allows all the characters and special characters in the filenames in the repository.

anychar="false" lets you specify the allowed characters in the repository filenames using AlphaNumeric and SpecialChars values.

Note: 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.

value="false"

<AlphaNumeric>

true allows alphanumeric characters in filenames.

This preference is relevant only when <FileNameRestrictions> @anychar is set to false.

true

<SpecialChars>

@value

List the other characters that are allowed. For example, to allow “-” and “:” in the repository filenames set the value if this field to: “-:”.

This preference is relevant only when the @anychar attribute for <FileNameRestrictions> is set to false.

none

<ShowProgressBar>

@value

value="true" shows a progress bar for indicating the progress of operations, such as check in, check out, and download.

value="false" does not display the progress bar.

value="false"

<AddHiddenDependencies>

@value

value="true" uploads dependencies, such as cross-references, text inset, graphics, hidden through conditional text or filter attribute while uploading a file.

value="false" ignores all hidden dependencies while uploading a file

value="false"

<ManageReferences>

@value

value="true" allows you to customize reference handling with menu and UI options

value="false" maintains existing behavior

value="true"

<AutoRefreshParent>

@value

value="true" refreshes the parent node (file or folder) in the Repository Manager after each operation, such as check out.

value="false" does not refresh the parent node automatically.

Set @value to false, if better performance is required.

value="true"