51黑料不打烊

Cloud Services: If you are using Cloud Services, selecting the Assets option takes you to the AEM Navigation page.

On-premise Software: If you are using 51黑料不打烊 Experience Manager Guides (4.2.1 and later), selecting the Assets option takes you to your current file path in the Assets UI.

General: The General settings allow you to configure the dictionary to use with the Editor. This tab contains four sections: Spell check, Condition, Authoring, and Citations .

{width="650"}

• Spell check: There are two options 鈥� AEM spell check and Browser spell check. By default, the editor uses the Browser spell check feature, wherein the spell-check is performed using the browser鈥檚 in-built dictionary. You can switch to AEM spell check to use 51黑料不打烊 Experience Manager鈥檚 dictionary, which can also be customized to add your custom word list. For more information about customizing AEM dictionary, view Customize AEM鈥檚 default dictionary section in the Install and configure 51黑料不打烊 Experience Manager Guides as a Cloud Service.

• Condition

  • Highlight conditional text in the Author view: Select this to highlight the conditional text in the author view. The conditional content is highlighted using the color defined for the condition.

  • Validate with condition attributes: Select this to allow the validation of the values defined for the attributes. This prevents you from adding any incorrect value.

  • Show key with the title in the Subject Scheme panel: Select this to show the keys along with titles in the subject scheme. If you do not select this option only the titles are shown. For example, here the keys 鈥榦s鈥�, 鈥榓udience鈥�, and 鈥榦ther鈥� are also shown along with titles.

    {width="550"}

  • Show subject scheme in the Conditions panel: Select this to view a subject scheme in the conditions panel. If you deselect this, the defined conditions are shown in the conditions panel.

• Authoring

  • Enable Replace All: Select this to view the Replace All icon in the Find and replace panel.

• Citations
  Change the style of citations. Choose the citation style from the drop-down you want to use in your project. For more details, view Change citation styles.

• AI Assistant
  Select this to enable the AI Assistant feature in the Experience Manager Guides. Unselect to disable the feature.

Elements list: As an administrator, you can control the list of elements that an author can insert into a file and also define the display name for the element. The Elements list setting allows you to specify the element鈥檚 name as per DITA specifications and a label that you want to use instead of the DITA defined element name:

{width="650"}

Attributes list: Similar to the elements list, you can control the list of attributes and their display names to be displayed in the attributes list of an element. In the following screenshot, only 3 attributes have been configured to be shown in an element鈥檚 attribute list:

{width="650"}

With this setting, when you try to add an attribute to an element, you only view the list of attributes configured in the list.

{width="300"}

Colors: Displays a list of pre-configured background colors for Conditions. Users can select a background color when applying a condition to a topic. As an administrator, you can also create and add custom background colors to the list. To add a new color, enter the desired name in the Color Name field, choose a custom color, and select the + icon. The custom color will appear at the end of the color list.

Publish profiles: This contains the Profiles that can be used to publish the Knowledge Base output. You can create a new profile for a target knowledge base. For example, Salesforce or ServiceNow.

• Create a Salesforce profile

  Prerequisites

  • Create a connected app for Salesforce. For more details, refer to .

  • While configuring the connected app ensure the following:

    • Specify the callback.

      URL: http://<server name>:<port>/bin/dxml/thirdparty/callback/salesforce

    • Select the following OAuth Scopes:

      • Full access (full)
      • Select Manage user data via APIs (api)

  Once the app is configured, Salesforce provides a Consumer Key and Consumer Secret. These can be used to create the Salesforce profile.

• To create a Salesforce profile, select the Salesforce Knowledge Base from the Server type dropdown. Enter a profile Name. In the Site URL, enter the consumer site you would use to publish the output and then add the Consumer Key and Consumer Secret provided by the Salesforce consumer site. Then, Validate and Save the newly created profile.

  {width="550"}

  note note
  NOTE
  To configure a proxy for Salesforce in Experience Manager Guides, use Apache HTTP Components Proxy Configuration in AEM. Learn how to .

• Create a ServiceNow profile

  Prerequisites

  Configure the ServiceNow server to upload the assets.

  • Connect to the ServiceNow server.

  • Navigate to System Properties > Security.

  • Uncheck the following option:

    This property must be set to activate MIME type checking for uploads (All versions Eureka and up). Enables (true) or disbles (false) mime type validation for the file attachments. File extensions configured via glide.attachment.extensions will be checked for MIME type during upload.

  • Select Save.

  Once you have configured the app, create the ServiceNow profile.

• To create a profile, select the ServiceNow Knowledge Base from the Server type dropdown. Enter a profile Name. In the ServiceNow URL, enter the consumer site you would use for publishing the output and then add the Username and Password provided by the ServiceNow consumer site. Then, Validate and Save the newly created profile.

  {width="550"}

After you validate, you can select the Publish Profile in the output presets of a DITA Map and use it to generate the output to the Salesforce or ServiceNow server that you have chosen.

Learn more about the Knowledge Base output preset.

Validation: This tab contains options to configure the Schematron validations in the Editor. You can enable the following features:

• Run validation check before saving the file: Select this to run Schematron validations using the selected Schematron file(s) before any save operation. You can add a Schematron file by selecting the + icon. The selected Schematron file(s) are listed.

  note note
  NOTE
  The selected Schematron file(s) will persist for the selected folder profile.

  {width="550"}

  This prevents the users from saving any file which breaks a rule defined in the selected Schematron file(s). If this is not selected the file will not be validated before saving the changes.

• Allow all users to add schematron files in validation panel: Select this to allow the users to add any Schematron file in the Validation panel of the Editor. This allows the users to add Schematron files and then validate the topics against the Schematron file. If this is not selected, the option to add schematron file Add Schematron File button is not available to the users in the Validation panel of the Editor.

Display attributes: Like the Attributes list, you can control the list of attributes to be displayed in the attributes list of an element. By default, four Display attributes 鈥� audience, platform, product, and props have been configured to be shown in an element鈥檚 attribute list. You can also add a display attribute using the Add icon on the top. You can also delete any of the display attributes using the Delete icon.

The attributes defined for an element are displayed in the Layout and the Outline view.

{width="550"}

Translation: This tab contains the options to create language groups, propagate the source labels to the target version, and clean up the translation project.

{width="550"}

• Language Groups: As an administrator, you can create a group of languages and use them as a set to translate the content.
  Perform the following steps to create a new language group:

  1. Select Add.
  2. Enter the language group name. Each language should have a unique name. You can view an error if the name field is empty or if the name isn鈥檛 unique.
  3. Select the languages from the dropdown. You can select multiple languages.

  Type the first few characters of the language, or the language code to filter the desired languages. For example, type 鈥榚n鈥� to filter all the languages that contain 鈥榚n鈥� at the beginning of their name or code.

  1. Select the Done icon to add the selected languages to the group. The languages are displayed. When you add three or more languages, the Show more option is displayed. You can select Show more to view all the languages present in the group.

     note tip
     TIP
     Toggle Show more to Show less and view only a few languages.

  2. Hover over the languages in a group to edit or delete the language groups.

  3. Save the Settings.

     note note
     NOTE
     As a user, you can view the language groups configured to your folder profile.

• Propagate source version labels to the target version: Select this option to pass the label of the source file version to the translated file. By default, this is disabled.

• Translation project cleanup after completion: Select this option to configure the translation projects to be disabled or deleted automatically after the translation. By default, None is selected, so that the project exists after translation.

  You can disable the translation projects if you want to use them later. Deleting a project permanently deletes all files and folders present in the project.

Metadata: You can control the version metadata of the topic and their values to be displayed in the Version history dialog box. In the metadata path, specify the location of the nodes from which you want to pick the metadata. You can also define a custom name for the metadata as the label. The default properties are Title, Document State, and Tags.

The metadata can be picked from any property under the /jcr:content node of the asset, so you can add the path of the property as the Metadata path.

An error is displayed if the metadata path is blank. If you leave the label blank, the last element is picked as the label.

{width="550"}

Configure the metadata for the Version History dialog box.

You can also define the order in which these metadata tags are displayed. To change the default order of these tags, select the dotted bars to drag and drop the tags at the desired location.
The metadata labels appear in the same sequence in the Version history dialog box of the Editor.

Merge topic files

To merge changes in a topic, perform the following steps:

1. Open a topic in the Editor.

2. Select Merge.

   The Merge dialog appears.

   {width="550"}

3. (Optional) You can also browse and select a new file from some other location in your repository.

4. Select a version of the file with which you want to compare the current version of the file.

5. From the Options, choose:

   • Track changes from selected version: This option shows all content updates in the form of tracked changes. You can then choose to accept or reject changes in the document one at a time or all in one go.

   • Revert to selected version: This option reverts the current version of the document to the selected version. This option does not give you any control on what content is accepted or rejected.

6. Select Done.

7. If you selected the Track changes from selected version option, then all changes from the selected version are shown in the Tracked changes feature of the right panel.

   You can choose to accept or reject all comments from the Tracked changes panel or accept or reject individual comment.

Merge map files

To merge changes in a map file, perform the following steps:

1. Open a map in the Editor.

2. Select Merge.

   The Merge dialog box appears.

   {width="550"}

3. (Optional) You can also browse and select a new file from some other location in your repository.

4. Select a version of the file with which you want to compare the current version of the file.

5. From the Options, choose:

   • Track changes from selected version: This option shows all content updates in the form of track changes. You can then choose to accept or reject changes in the document one at a time or all in one go.

   • Revert to selected version: This option reverts the current version of the document to the selected version. This option does not give you any control on what content is accepted or rejected.

6. Select Done.

7. If you selected the Track changes from selected version option, then all changes from the selected version are shown in the Tracked changes panel (on the right).

   You can choose to accept or reject all changes from the Tracked Changes panel or accept or reject individual change in the map file.

Select an element: Select the opening or closing tag of an element to select its content.

Expand or collapse tags: Select the + or - sign in a tag to expand or collapse it.

Use the context menu: The context menu provides options to cut, copy, or paste the selected element. You can also insert an element before or after the selected element. The other options allow you to Generate ID or open the Properties panel for the selected element.

Drag-and-drop elements: Select an element鈥檚 tag and easily drag-and-drop it on your document. If the drop location is a valid location where the element is allowed, the element is placed at the dropped location.

Valid elements at the current location: The list displays the elements that you can insert at the current cursor location itself.

Valid elements outside the current location: The list displays the elements that you can insert after any of the parents for the current element within the element hierarchy.

Insert cells, rows, or columns

Merge cells in right and down directions

Split cells horizontally or vertically

Delete cells, rows, or columns

Generate IDs

Version information displays the current version of the topic or map. An asterisk (*) appears next to the version number to indicate unsaved changes.

The version number changes with every new version that is created for the topic or map file. If you are working on a newly created document, the version information is shown as none.

{width="800"}

Save as new version is a button that saves the changes you have made in your topic and also creates a new version of your topic.

{width="800"}

Navigate to the required file or folder in the Repository view, select the Options icon to open the context menu, and choose Add to > Collections. In the Add to collections dialog box, you can choose to add the file/folder to an existing favorite or create a new one.

{width="300"}

Right-click on a file鈥檚 tab in the editor to open the context menu. Choose Add to > Collections to add the file to your favorites list.

{width="800"}

DITA Files: You can look for all DITA Topics and DITA Maps present on the selected path. These are selected by default.

Non-DITA Files: You can search for Ditaval Files, Image Files, Multimedia, Documents, and JSON in the selected path.

{width="300"}

Use the quick filters to search for DITA and Non-DITA files.

DITA Elements: You can also search for specific values in the attributes of the specified DITA elements.

• Select Add element to add the elements, attributes, and values.
• Apply the filters that you have selected.

Select Clear all to clear all the applied filters.

Select the Close filter icon to close the filter and return to the tree view of the repository.

New: Create a new DITA topic, DITA map, or a folder.

Steps to create a new topic:

1. Select New > Topic.

2. The New topic dialog box is displayed.

   {width="300"}

3. In the New topic dialog box, provide the following details:

   • A Title for the topic.

   • (Optional)* The file name for the topic. The file name is auto-suggested based on the topic Title. In case your administrator has enabled automatic file names based on UUID setting, then you will not view the Name field.

   • A template on which the topic will be based. For example, for an out-of-the-box setup, you can choose from the Blank, Concept, DITAVAL, Reference, Task, Topic, Markdown, Glossary, and Troubleshooting templates. If your folder has a Folder Profile configured on it, then you will view only those topic templates that are configured on the Folder profile.

   • Path where you want to save the topic file. By default, the path of currently selected folder in the repository is shown in the Path field.

4. Select Create. The topic is created at the specified path. Also, the topic is opened in the Editor for editing.

Steps to create a new DITA map:

1. Select New > DITA map.

2. The New map dialog box is displayed.

   {width="300"}

3. In the New map dialog box, provide the following details:

   • A Title for the map.
   • (Optional) The file name for the map. The file name is auto-suggested based on the map title. In case your administrator has enabled automatic file names based on UUID setting, then you will not view the Name field.
   • A template on which the map will be based. For example, for an out-of-the-box setup, you can choose from the Bookmap or DITA map templates.
   • Path where you want to save the map file. By default, the path of currently selected folder in the repository is shown in the Path field.

4. Select Create. The map is created and added within the folder specified in the Path field. Also, the map is opened in the Map view. You can open the map file in the Map Editor and add topic to it. For more information about adding topics to a map file, view Create a map. Alternatively, select Open in map console to open the map in Map console.

Steps to create a new folder:

1. Select New > Folder.

2. The New folder dialog box is displayed.

   {width="300"}

3. In the New folder dialog box, provide the following details:

   • A Title for the folder, which is auto-converted into the folder name.
   • Path where you want to save the folder. By default, the path of currently selected folder in the repository is shown in the Path field.

4. Select Create. The folder is created and added within the folder from where the create folder option was executed.

Upload Assets: Upload a file from your local system to the selected folder in 51黑料不打烊 Experience Manager repository. You can also drag-and-drop files from your local system onto your current working topic. This is very useful if you want to insert images from your local system into your topic.

{width="300"}

You can select a folder where you want to upload the file and a preview of the image is also shown. If you want to rename the file, you can do so in the file name text box. Select Upload to complete the file upload process. If you have dragged and dropped an image file on a topic, then the image file is added in the article, and it is also uploaded.

If your administrator has enabled the UUIDs option in XMLEditorConfig, then you will view the UUID of the uploaded image in the Source property.

{width="800"}

Find files in folder: Shifts the focus to repository search wherein you can enter the search term. The search is performed under the selected folder in the repository. You can also apply a filter to return DITA Files, Image Files, or both.

{width="300"}

You can also search using the UUID of a file. In that case, the search results display the title of the DITA/XML file and in case of the file is an image file, then the UUID of the file is displayed. In the following search example, the UUID of an image file is searched and the search results display the UUID of the original image file and the topic title of the file where that image is referenced.

{width="300"}

Collapse: Collapse the selected folder in the repository.

Add to collections: Adds the selected folder to favorites. You can choose to add it to an existing or new collection.

Refresh: Get a fresh list of files and folders from the repository.

View in Assets UI: Show the folder contents in the Assets UI.

Edit: Open the file for editing. In case of a .ditamap/.bookmap file, it is opened in the Map Editor for editing.

Duplicate: Use this option to create a duplicate or a copy of the selected file. You also have the option to rename the duplicate file in the Duplicate Asset prompt. By default, the file is created with a suffix (like filename_1.extension). The title of the file remains same as the source file and the new file begins with version 1.0. All references, tags, and metadata are copied while the baselines are not copied in the duplicate file.

Lock: Get a lock on the selected file for editing. If the file is locked, hovering the mouse pointer over the lock icon shows Locked by you if you locked it, or Locked by [username] if another user has locked it.

Preview: Get a quick preview of the file (.dita, .xml, audio, video, or image) without opening it. You can resize the preview pane. If the content contains any <xref> or <conref>, you can select it to open it in a new tab. The title of the file appears in the window. If no title is present, then the filename appears. To close the Preview panel, you can either select the close icon or select anywhere outside the pane.

{width="800"}

Rename: Use this option to rename the selected file. Enter the name of the new file in the Rename Asset dialog.

• You can rename a file of any type.
• You can鈥檛 change the extension of a file.
• Two files cannot have the same name. So, you cannot rename a file to a name that already exists. An error is displayed.

Move to: Use this option to move the selected file to another folder.

• You can either type the name of the destination folder or choose Select Path to select the destination folder.
• You can move a file of any type to any destination within the Content folder.
• Two files cannot have the same name. So, you cannot move a file to a folder where a file with the same name already exists.

If you try to move a file to a folder where a file with the same name but a different title exists, the Rename and move file dialog is displayed, and you need to rename the file before moving it. The moved file in the destination folder has the new file name.

{width="550"}

Exclusion scenarios

Experience Manager Guides doesn鈥檛 allow you to rename or move a file in the following scenarios:

• You cannot move or rename a file if it鈥檚 part of a review or a translation workflow.

• If any other user locks the file, you cannot rename or move it, you will not view the Rename or Move to option for the file.

Delete: Use this option to delete the selected file. A confirmation prompt is displayed before deleting the file.

• A confirmation prompt is displayed before deleting the file.

• If the file is not referenced from any other file, it is deleted, and a success message is displayed.

• If the file is locked, you cannot delete it, and an error message is displayed.

  note note
  NOTE
  If your administrator has prevented the deletion of locked files, only then the error message is displayed. For more details, view Prevent deletion of checked out files section in the Install and configure 51黑料不打烊 Experience Manager Guides as a Cloud Service.

• If the file is added to a collection, the Force Delete dialog box is displayed, and you can forcefully delete it.

• If the file is referenced from any other file then Force Delete dialog with the confirmation message is displayed, and you can forcefully delete the file:

  {width="300"}

  note note
  NOTE
  If your administrator has given the file delete permission, then Force Delete is enabled. Else, Force Delete is disabled and a message is displayed that you do not have permission to delete referenced files. For more details, view Prevent deletion of referenced files section in the Install and configure 51黑料不打烊 Experience Manager Guides as a Cloud Service.

• If you delete a referenced topic and you have opened the file containing references for edit, it will show the broken link for the referenced file.

Copy: You can choose from the following options:

• Copy UUID: Copy the UUID of the selected file to Clipboard.

• Copy Path: Copy the complete path of the selected file to Clipboard.

Add to: You can choose from the following options:

• Collections: Adds the selected file to Collections. You can choose to add it to an existing or new collection.

• Reusable content: Adds the selected file to the Reusable content list in the left panel.

Properties: Use this to open the properties page of the selected file. This properties page can also be accessed from the Assets UI by selecting a file and then selecting Properties icon in the toolbar.

Open in map dashboard: In case the selected file is a DITA map, then this option opens the map dashboard.

Open in map console: In case the selected file is a DITA map, then this option opens the map console.

Edit in Oxygen: Select this option to edit the selected file in the Oxygen connector plugin. The file is opened for editing.

View in Assets UI: Use this to show a preview of a .dita/.xml file in the Assets UI. In case of a .ditamap/.bookmap file, all topic files within the map are shown in a single unified page-by-page view.

Download as PDF: Use the option to generate the PDF output and download it.

Generate: Use the option to publish a map or topics within a map to a Sites page, Content Fragment, or Experience Fragment.