Publish Experience Fragments

Create a folder in the Experience Fragments. Use this folder to save the Experience Fragments that you create based on the Experience Fragment templates. For example, sales-experience-fragments.

Select the folder and then select the Properties icon from the top.

Edit the folder’s properties (for example, sales-experience-fragments).

• Title: View or edit the title of the folder.

• Allowed Templates: Contains the list of templates that can be added as child pages of the experiencefragment. To add the allowed template, specify the regular expression for retrieving the required templates in the Allowed Templates field.
  For example:
  /libs/cq/experience-fragments/components/experiencefragment/template

  If you do not define an allowed template for a folder, the templates are picked from the parent folder or the templates folder by default.

• Orderable: Allows you to change the order of the assets inside a folder.
  {width="650"}
  Add the cloud configuration in the folder properties to connect it with the fragment templates.

To generate an Experience Fragment, select New Output from the Outputs section in the File Properties of a topic.

Select Experience Fragment.
{width="300"}

Add a new Experience Fragment from the File Properties of a topic.

In the Generate Experience Fragment dialog box, fill in the following details:
{width="500"}

Add the path, template, and mapping details to publish a topic or its elements as an Experience Fragment. You can overwrite an existing Experience Fragment.

• Path: Browse and select the path of the folder where you want to publish the Experience Fragment. You can also select an existing Experience Fragment and republish it.

• Title: Type the title of the Experience Fragment. By default, the title is populated with the title of the topic. You can edit it. This title is used to generate the name of the Experience Fragment.

• Name: Type the name of the Experience Fragment. By default, the name is populated with the title of the topic, and the spaces are replaced with ‘_’. For example, sample_expereince_fragment. You can edit it. This name is used to generate the URL for the Experience Fragment.

• Template: Select the Experience Fragment template that you want to use to create your Experience Fragment. The templates are picked from the folder that you have configured in the properties.

• Mapping: It picks the mapping from the experienceFragmentMapping.json file and displays it.

  Your administrator can add the mappings in the experienceFragmentMapping.json file. Learn more about how to create a mapping between a topic and an Experience Fragment in the Installation and Configuration Guide.

• You can also select different conditions to publish the content. Select one of the following options:

  • None: Select this option if you don’t want to apply any condition on the published output.
  • Using DITAVAL: Select the DITAVAL file to generate personalized content. You can select the DITAVAL file using the browse dialog or by typing the file path.
  • Using attributes: You can define condition attributes in your DITA topics. Then, select the condition attribute to publish the relevant content.

  note note
  NOTE
  Conditions are enabled only if condition attributes are defined in the topic.

• Select the Overwrite existing content checkbox if your Experience Fragment already exists and you wish to overwrite it. Experience Manager Guides displays an error if you don’t select the checkbox and your Experience Fragment already exists.

Click Generate to publish the Experience Fragment.

You can view the Experience Fragments for a topic under the Outputs section in the File Properties. The Experience Fragments appear according to the date and time of their publishing, with the latest as the first.

{width="300"}

View the Experience Fragments present for a topic and republish them.