Create a mapping between a topic and a content fragment
- Topics:
- Output Generation
CREATED FOR:
- Experienced
- Admin
Adobe Experience Manager Guides allows you to create a JSON-based mapping between a topic and a content fragment model. You can use JSON-based mapping to publish content present in some or all elements within a topic to a content fragment.
Learn more about how to publish content fragments.
-
To download the contentFragmentMapping.json, log into Adobe Experience Manager as an administrator.
-
Select the Adobe Experience Manager link at the top and choose Tools.
-
Select Guides from the list of tools and select the Folder Profiles.
-
Select the Global Profile tile.
-
Select the XML Editor Configuration tab and select the Edit icon on the top.
-
Select the Download icon to download the contentFragmentMapping.json file on your local system. You can then make changes to the file and then upload the same.
-
You need to follow the following validations:
-
It should be a JSON file
-
It should contain an array containing at least one object, and every object should contain the following:
"name": string
"mapping": array
Each object of mapping must contain the following:
"modelField": string
"xpath": string
"outputType": string
-
-
Save the file and upload it.
Sample file:
[
{
"mapping": [
{
"modelField": "title",
"xpath": "/topic[1]/title[1]",
"outputType": "textContent"
},
{
"modelField": "shortdesc",
"xpath": "/topic[1]/shortdesc[1]",
"outputType": "textContent"
},
{
"modelField": "topicData",
"xpath": "/topic[1]/body[1]",
"outputType": "outerHTML"
}
],
"name": "Full Topic"
},
{
"mapping": [
{
"modelField": "title",
"xpath": "/topic[1]/title[1]",
"outputType": "textContent"
},
{
"modelField": "shortdesc",
"xpath": "/topic[1]/shortdesc[1]",
"outputType": "textContent"
},
{
"modelField": "heroImage",
"xpath": "/topic[1]/body[1]/p[1]/image[1]",
"outputType": "outerHTML"
},
{
"modelField": "dataTable",
"xpath": "/topic[1]/body[1]/table[1]",
"outputType": "outerHTML"
}
],
"name": "Sample Example with XPath"
}
]
You can publish the whole topic with the default mapping. Select the Full Topic
mapping from the dropdown Generate Content Fragment dialog box, and have “topicData” field in the content fragment model.
Experience Manager
- AEM Guides overview
- Disclaimer
- Release Information
- AEM Guides releases roadmap
- Release Notes
- Cloud Services
- Deployment Instructions
- 2025 Releases
- 2024 Releases
- 2023 Releases
- 2022 Releases
- On-prem/Managed Services
- Cloud Services
- User Guide (New UI)
- Introduction
- Home page
- Author content
- Authoring overview
- Ways to Author content using AEM Guides
- Editor
- Introduction to the Editor
- Launch the Editor
- Edit topics in the Editor
- Topic creation and preview
- Know the Editor interface and features
- Additional features in the Editor
- Working with the Editor Settings
- Keyboard shortcuts in the Editor
- Editor views
- Support for Schematron files
- Author Markdown documents from the Editor
- Add citations to your content
- Use data from your data sources
- Document state
- Use labels
- Map Editor
- DITAVAL editor
- Desktop tools for authoring content
- Review content
- Collaborate using Adobe Workfront
- Metadata and tagging
- Map management and publishing
- Map console overview
- Open files in Map console
- Reports
- Content translation
- Output Generation
- Output generation basics
- Output presets in AEM Guides
- Edit, duplicate, or delete an output preset
- Conditionalize content
- Use Baseline
- Manage Global and Folder Profile output presets
- Use variables for setting the Destination Path, Site Name, or File Name options
- Pass on the metadata to the output using DITA-OT
- Generate output
- Use Map Collection for output generation
- Manage output generation process
- Manage publish tasks using the Publish Dashboard
- Basic troubleshooting
- Bulk activation of content
- Output generation of FrameMaker Documents
- AI Assistant in AEM Guides
- Appendix
- User Guide (Old UI)
- Installation and configuration
- On-premise
- On-premise basics
- Download, install, and upgrade
- Work with user groups and security
- Content migration
- Work with custom DITA-OT and specialization
- Configure post processing for a folder
- Configure filenames
- Configure auto-filenames based on UUID
- Configure Regx for valid file name characters
- Configure valid file names for AEM Site output
- Work with topic and map templates
- Work with document states
- Work with the Web Editor configurations
- Customize Web Editor
- Customize toolbar
- Configure default value for the Tags View
- Configure the title for Check in and Check out icons
- Configure display of UUID-based links
- Open DITA topic or map files in same tab
- Configure a custom panel in the left panel
- Configure file auto-save in the Web Editor
- Configure filters for file browse dialog
- Configure prompt to save as a new version on close
- Configure prompt to check in a file on close
- Configure allowed special characters
- Auto-generate element IDs
- Customize AEM’s default dictionary
- Configure text filters
- Configure the number of LimitReads for a query
- Install packages for Article-based publishing
- Configure a data source connector from the user interface
- Set the Advanced Map Editor as default
- Include @navtitle attribute by default
- Configure the option to edit in Oxygen
- Configure additional special characters
- Work with global and folder-level profiles
- Configure versions
- Work with desktop-based XML editors
- Work with output generation settings
- Configure output generation settings
- Download and install aem sites templates
- Overlay HTML tags in AEM Sites output
- Native PDF Publishing
- Configure JVM flags for Native PDF Publishing
- Configure and customize workflows
- Work with translation configurations
- Work with AEM Assets search
- Appendix
- Cloud Services
- About this guide
- Deploy and configure AEM Guides as Cloud Service
- Work with user groups and security
- Content migrate
- Work with custom DITA-OT and specialization
- Configure UUID and non-UUID based filenames
- Work with topic and map templates
- Work with document states
- Work with the Web Editor configurations
- Customize Web Editor
- Customize toolbar
- Configure the AI-powered smart suggestions for authoring
- Configure the AI-powered Smart Help to search content
- Configure default value for the Tags View
- Configure display of UUID-based links
- Configure display of pasted tables
- Open DITA topic or map files in same tab
- Configure a custom panel in the left panel
- Configure file auto-save in the Web Editor
- Configure prompt to save as a new version on close
- Configure prompt to check in a file on close
- Configure allowed special characters
- Auto-generate element IDs
- Customize AEM’s default dictionary
- Configure text filters
- Configure filters for file browse dialog
- Install packages for Article-based publishing
- Configure single topic PDF generation
- Configure Translation feature in the Web Editor
- Configure a data source connector
- Configure a data source connector from the user interface
- Set the Advanced Map Editor as default
- Include @navtitle attribute by default
- Work with global and folder-level profiles
- Configure versions
- Work with desktop-based XML editors
- Configure Workfront
- Work with output generation settings
- Work with custom workflows
- Work with translation configurations
- Work with AEM Assets search
- Appendix
- On-premise
- API Reference
- Introduction
- REST APIs for Output management
- REST API to work with DITA maps
- REST API to register a data source connector
- REST API to work with conditional attributes
- REST APIs for conversion workflow
- REST API for creating and activating packages
- Java-based API to work with output generation
- Java-based APIs to work with DITA maps
- Java-based APIs for conversion workflow
- Java-based APIs to work with baseline and labels
- Java-based API to work with folder profiles
- Java-based API for creating and activating packages
- Post-processing event handler
- Bulk activation complete event handler
- Conversion process event handler
- Knowledge Base
- Expert Session
- Expert Session Overview
- Translate content
- Manage content using baselines
- Author web-based content
- Native PDF publishing essentials
- Reports in AEM Guides
- Content and Template setup
- Learning native PDF publishing - part 1
- Learning native PDF publishing - Hands on lab - BYOS
- Extension Framework of AEM Guides
- External Datasource Integration
- Translate content in Guides - part 2
- Define, Manage and Utilize Metadata
- AEM Sites output variations
- Deployment options and migration to Cloud
- Migrate content from non-uuid to UUID
- Delta content migration
- Smarter PDF Publishing with Native PDF
- New UX and AI Capabilities in AEM Guides
- Articles
- Authoring
- Guides Extention Framework
- External data source
- Publishing
- Workflows
- Translation
- Use Cases
- Expert Session