DITA map report from the Map Console id231HF0Z0NXA
ÃÛ¶¹ÊÓÆµ Experience Manager Guides comes with a feature in the Map console that enables you to check the overall integrity of your map and generate reports for it.
You can view the topic list, manage the metadata of all references, view the multimedia list and fix all the broken links for the current map from the Reports tab in the Map Console which you can access as follows:
-
In the Repository panel, open the DITA map file in Map view.
note note NOTE You can also open a DITA map directly in the Map console tab from the drop-down on the left top of the home page. -
Select the Open in map console icon.
-
Select Reports from the left panel.
You can locate all the four reports from the Reports panel. Based on your requirement you can select any of the reports as shown here.
The Reports panel provides access to four different types of reports. Each report, along with its accessibility and features, is discussed in detail below.
Topic List report
The Topic List report provides detailed information about your topics, such as the reference type, document state, and author.
You can view the topic list report of a map by performing the following steps:
-
Select Topic List from the Reports panel. The list of topics present in the DITA map is displayed.
-
From the Filters panel you can filter your topics based on the Reference type (direct or indirect), Document State (for example if your topics are in Edit, In-Review, or Reviewed state, these are listed) or the Author of the topic.
note note NOTE All the filters provide an exhaustive list of options present in the system. -
You can also use the following topic filtering options to choose to display the following columns in the list:
- Title The title of the topic is specified in the DITA map. You can select the topic to edit it.
- File Name Name of the file.
- UUID The universally unique identifier (UUID) of the file.
- File Location The complete path of the topic.
- Reference Type The type of reference – direct or indirect.
- Document State The state of the topic.
- Author The user who worked last on the topic.
- Parent Map The list of all maps where the topic is directly referenced.
note note NOTE Select Refresh to get a fresh list of topics and view any change in your map file or if any reference within your topic file is updated. -
Select Download to download the snapshot of all the topics in the DITA map. The excel sheet contains the selected columns and the topics filtered in the Topic List view.
Metadata report
The Metadata report provides a detailed report of your references in the current DITA map such as the reference type, document state, tags, file location etc.
You can view the metadata report of a map by performing the following steps:
-
Select Metadata from the Reports panel. The list of all references of a map is displayed along with it’s metadata such as tags, document state, custom metadata. To add a new custom metadata column, refer to Add custom metadata columns section.
-
From the Filters panel you can filter your topics based on the Document State (for example if your topics are in Edit, In-Review, or Reviewed state, these are listed), References (direct or indirect), File Type (Map, Topic, Document, Image, Video and Others) of the reference.
note note NOTE All the filters provide an exhaustive list of options present in the system. -
You can also choose to view only the Files with no tags or also choose specific tags from the Tags filter to view the files associated with them.
-
You can also use the following topic filtering options to choose to display the following columns in the metadata list:
-
Title (selected by default) The title of the referenced file is specified in the DITA map. You can select the file to edit it.
note note NOTE A checked-out icon also appears near the title of a checked-out file. You can hover over the icon to view the name of the user. -
File Name The name of the file.
-
File Location The complete path of the file.
-
UUID The universally unique identifier (UUID) of the file.
-
Tags (selected by default) Tags applied on the file.
note note NOTE By default, you can view two tags for a file. To view more tags, select Show More. Select Show Less to contract the list again. -
Document State (selected by default) The current state of the reference file.
-
Reference Type The type of reference – direct or indirect
-
File Type (selected by default) Type of the source file. The available options are Map, Topic, and Image.
-
Locked by The user who has locked the file.
-
-
Select Download to download the snapshot of all the references in the DITA map. The excel sheet contains the selected columns and the references filtered in the Metadata view.
Manage metadata in bulk from the Metadata report
You can apply tags on an individual topic or use the bulk tagging feature to apply multiple tags on multiple topics, a DITA map, or on a sub-map. You can also change the document state of all selected topics to the next possible common document state.
Update metadata
To update metadata, perform the following steps:
-
To update metadata, select the files for which you want to update. You can select the files that are appearing in the Metadata panel, by checking in the check box appearing adjacent to Title. If you want to select all the records, use the Select all tab above the Title bar as shown below.
note note NOTE You cannot select any checked-out files. A checked-out icon also appears near the title of a checked-out file. You can hover over the icon to view the name of the user. -
Select Manage from the top.
-
If you want to add any new tags, select new tags from the dropdown list to apply them to all selected topics. You can also delete any tag by selecting the cross icon near the tag.
note note NOTE The common tags applied on all the selected topics are listed. -
Select a new document state if you want to change the document state of all the selected references. The drop-down displays the common possible state for all selected topics. For example, if the current state of your topics is In-Review, then you can view Draft, Approved, or Reviewed state.
-
Select Update to update the metadata. A confirmation message is displayed for the metadata whether it is updated successfully or has any failed updates. You also select Download Report to download the snapshot of the report. This snapshot contains the details of the updated status for the selected references.
Add custom metadata columns
This feature enables you to add custom metadata columns as per requirement, which are then displayed in the metadata reports. It also provides enhanced flexibility in metadata reporting. To add new custom metadata column perform the following steps:
-
To add a custom metadata column, select Settings from the three dots on the top-right corner of the metadata page.
-
Select Metadata on the left panel of the pop-up that appears.
-
Add a new custom metadata field as per the requirement using the Add tab.
-
Specify a specific metadata path and an appropriate title for the same which you want to add in the columns of metadata report. For example a custom metadata with the title language and a specific path is added.
note note NOTE If you want to remove a particular metadata column, you can delete it from the list displayed. Additionally, you can edit the Label to alter the display title of column. -
Select Save and Refresh the Metadata view. A new custom column Language is added in the list of Columns in the Filter panel.
note note NOTE Adding a new metadata column also gets reflected in the Version History panel in the Editor. For more information, view Metadata.