Use New map collection for output generation (Beta)
Map collection in Adobe Experience Manager Guides enables publishing specialists to organize multiple documents into a single collection, control the output generated for each document, and efficiently generate and publish outputs in batches from a centralized dashboard. It also provides visibility into output generation progress, highlights changes made to maps since their last published output, and allows you to republish content when needed.
The New map collection consolidates the functionality previously spread across the old map collection, and bulk publishing into a single unified interface. Once enabled, you can manage maps, presets, generation history, publishing history, metadata, and collection membership from one location.
Create a map collection and add DITA maps
To create a map collection and add maps to it, perform the following steps:
-
Open the Experience Manager Guides Home page and select New map collections.
The Map collections page opens.
-
On the Map collections page, select Create on the top-right, and provide a Name for your new map collection.
-
Select Create.
A success message is displayed on creation of the map collection.
-
Open the desired map collection you want to add the maps to.
While hovering over the map collection title, you can perform the following actions:
- Generate history: Navigates you directly to the Generated history tab listing all the maps with generated outputs for the defined presets.
- Publish history: Navigates you directly to the Published history tab listing all the maps with published output for the defined presets.
- Rename: Renames the map collection.
-
Select Edit collection and then select Add maps.
-
Select the desired maps and enable the Select available translations toggle to automatically add all available translation copies of that map to the map collection. If the map does not have any translation copies, the default language is added to the map.
-
Select Add.
The map files are listed along with all their available translated copies. For maps that do not have any translated copies, the default language is displayed.
-
Select the required maps, or all the listed maps, and then select the Fetch presets button to retrieve the available presets for the selected maps.
You see a list of all available presets for the selected maps, grouped under two categories: Folder profile presets and Other presets. Folder profile presets are common to all the selected maps, while Other presets are specific to individual maps. For presets under Other presets, the associated map is indicated next to the corresponding toggle.
-
Select Enable all presets or Enable all folder profile presets, depending on your requirement. You can also use the Filter icon on the right to narrow down the list. The filter provides two levels of filtering: Preset types to narrow down the presets listed and Map status to choose any specific maps from the Maps panel.
-
Select Save.
You get a list of all the desired maps with the Map title, corresponding File name, the Language it is available in, and the configured presets.
The Maps and Presets tab presents information on the basis of the selected maps for a specific language in the following columns:
- Preset: Shows the output preset type configured on the map file.
- Baseline: Shows the baseline which is used by the output preset. If no baseline is used, then it shows a hyphen
-. - Modified since generation: Indicates if the DITA map is updated after generation. Based on this information, you can decide if you want to publish the output for this DITA map or not.
- Modified since published: Indicates if the DITA map is updated after the last publishing. Based on this information, you can decide if you want to republish the output for this DITA map or not.
- Last generated: Shows the date and time of the last generated output.
- Last published: Shows the date and time of the last published output.
Filtering options
The following filtering options are available in the right panel on the Maps and presets page:
-
Modified since generation: You can select Yes, No, or Not yet generated. If you select Yes, only the maps that have been modified since generation are shown in the Maps and Presets tab.
-
Modified since publishing: You can select Yes, No, or Not yet generated. If you select Yes, only the maps that have been modified since publishing are shown in the Maps and Presets tab.
-
Presets: Select a preset for which you want to filter out the map files. For example, if you choose AEM Site preset, then only those maps are shown that have the AEM Site output preset configured on them.
-
Language: You can select any of the available language codes and display only the selected language in the Maps and Presets tab.
Generate the output using a map collection
To generate the output using a Map Collection, perform the following steps:
-
Open the Map Collection. You can view the various output presets like the AEM Sites, PDF (including Native PDF), HTML5, EPUB, and Custom presets as per your configuration.
-
To generate output for the selected maps, select the required map files and the specific presets, and then select Generate.
note important IMPORTANT If an output generation process for a preset or DITA map is either in the queue or in progress, you cannot initiate another output generation task for the same preset or map. -
Once the output has been generated, navigate to the Generated history tab to view the list of all generated maps. You can track the generation progress in the Status column, which indicates whether a generation is Executing or Finished.
-
Select Refresh to view the latest status of the generation process. The Status column is updated to reflect the current state of each map and its associated presets:
- Finished (Green): Generation completed successfully.
- Finished (Red): Generation completed with errors. Error details can be viewed in the logs.
- Executing (Blue): Generation is currently in progress.
-
You can also cancel the output generation task till the status of the task is executing by selecting the Cancel generation icon.
-
Additionally, you can view the generated output for maps whose output generation has been completed by selecting the Open Output icon that appears when you hover over the map name, or view the generation logs by selecting the adjacent Logs icon.
Publish the output using a map collection
To publish (if configured) the output using a Map Collection, perform the following steps:
-
Select the desired maps from either the Maps and Presets tab or the Generated history tab and select Publish to.
-
Select the target environment where you want to publish the output: Preview or Publish instance.
-
Switch to the Published history tab to monitor the status of the publishing task.
-
Select Refresh to view the latest status of the task.
-
Once the status changes to Successful, verify the published content in the selected target instance.
Configure the metadata properties
In the map collection, you can configure the metadata properties in bulk for the DITA maps. Select Configure Metadata icon from the Maps and presets tab to open the Asset Metadata page. On the Asset Metadata page, all the maps present in the collection are listed on the left.
Perform the following steps to configure the metadata properties:
-
You can choose the maps you wish to update the metadata for. By default, all the DITA maps present are selected.
-
Once you select the DITA maps, you can view properties like metadata, schedule (de)activation, references, document state, and more.
-
Update the metadata properties.
-
Select Save & Close on the top to save the updates.
-
(Optional) When you update the tags, you can also select Append in the Save & Close dropdown to append the new tags to the existing list.
-
Select Submit from the Save & Close dropdown.
The metadata properties are updated in bulk for the DITA maps you select from the map collection.
The metadata properties are in sync with the file properties. Once you update them, you can view them from the File Properties panel in the Editor.
Parent topic:Output generation