Defining tagged list formats

• Tagged list formats are used by Content Tagged List content items to format the rendered display of the content item. You specify the tagged list format to use in the List Format field of the Content Tagged List configuration.
• The default tagged list formats shipped with iMIS are always overwritten during upgrades, so the best practice is to create new tagged list formats rather than modifying the default ones. Take care to name your user-created tagged list formats uniquely to prevent iMIS from treating them as standard iMIS tagged list formats during an upgrade. An easy technique to ensure unique naming is to prefix the name with an acronym for your organization, such as ORGSimpleWithHTML.
• The format you define here is applied as a display mask to a single item in a Content Tagged List content item. This format is repeated once for each item content record in the list rendered from the content item. The basic elements of a tagged list format are:
  • One or more content record property labels to explain a following content record property value.
  • One or more content record property values.
  • A single link to the content record itself.
  • HTML fragments.

While none of these elements is actually required by the system, at a minimum you should at least insert the link to the content record itself.

• The content record property values are all read-only values.
• The tagged list format editor is essentially the HTML editor used for Content Html content items, with some iMIS-specific toolbar buttons at the right of the bottom toolbar, and a list of embeddable content record properties at the right of the editor.

If you find some features of the HTML editor confusing, you can download the RadEditor user manual from the Telerik Documentation site.

Edits a content record property value that has been inserted in the editing area in the following possible ways:

• Changes an existing content record property value in the editing area to a different property. You must place your cursor somewhere inside the existing property value before clicking this button.
• Enables you to define a display mask for date-oriented and numeric property values.

Note: While you can use this toolbar button to insert a new property value, it's much easier to insert new values by clicking the red A icons in the Content - Properties list.

• Display Value – Displays the value of the Property. If unchecked, it will leave the text of the property as "Title."
• Property – Specifies the property value in which the editing cursor is positioned. If you select a different property value from the list, it will replace the property value in which the editing cursor is positioned.
• Display Format – Specifies a display mask for date-oriented and numeric property values. To view a list of the syntax you can use for the display mask, click View complete list of Date/Time and Number formats.

Creates a link to the content record itself, enabling you to define the anchor text for the link in various ways.

• Dynamically based on Property – Specifies anchor text that is different for every content record in the rendered Content Tagged List content item. The anchor text will be the selected content record property value.
• Static text – Specifies anchor text that will be the same for every content record in the rendered Content Tagged List content item.
• Display Format – Specifies a display mask for date-oriented and numeric property values if you specify the anchor text to be Dynamically based on Property. To view a list of the syntax you can use for the display mask, click View complete list of Date/Time and Number formats.

Adds an image to the Tagged List Format. This inserts a business-styled image tag on the associated content record, which uses the metatag information to build the image tag.

Note: You must define the metatag image in the content record's Properties tab before you are able to add the metatag image to the Tagged List Format. If no image is associated with the content record, it will show an "image not available" thumbnail.

Note: If you manually enter a link to an image that does not exist or an incorrect file path for an image, your content might not be able to be saved correctly. To ensure you do not have issues saving content that includes references to images, use the Image Manager to upload and manage image files.
It is recommended that you save and Preview your HTML to ensure all content is being saved correctly.

To add an image using the iMIS Dynamic Image Manager, do the following:

1. Go to RiSE > Tagging > Tagged list formats.
2. Create a new Tagged List Format or Edit an existing format.
3. Place the cursor where the image will be inserted in the WYSIWYG editor.
4. Click on the iMIS Dynamic Image Manager icon to specify the source of the dynamic image.
5. Select Metatag Image from the Dynamically based on Property drop-down and Insert.
6. Click Save, and then Publish the tagged list format.

Specifies a single conditional display parameter for any element of the tagged list format (property label, property value, link, or HTML fragment). You must select the entire element before clicking this button. When you insert the conditional parameter, the element is surrounded by braces { } to indicate that it is a conditional display block.

To simulate ELSE arguments for the conditional display of an element, you can copy and paste the element inside a conditional display block to a position immediately following the existing display block, then select the copied element and click this button to create a new conditional display block with a different parameter.

Note: The iMIS Conditional Display Manager is a generic conditional display control shared among several iMIS features. Therefore, you should be careful to choose values that make sense in the context of conditional display of an element in a tagged list format. As a rule, you should use the default values for Data type, Comparison type, and Source. The only value you should change is for the Value drop-down list, to specify the content record property value that you want to ensure is not empty before displaying this element.

Example: Creating a customer message

For this example, the user would like to create a customer message that appears on secured articles for staff only.

1. Highlight the text you wish to use in the Conditional Display Manager.



2. Click the Conditional Display Manager icon.
3. In the Conditional Display Manager, click the drop-down next to Date type and select Boolean.
4. Click the Comparison type drop-down and select Is True.
5. Click the Source drop-down and select Property.
6. Click the Value drop-down and select Content is restricted to members.
7. Click Insert. Clicking insert puts the selected text inside a conditional display that only appears if the content is restricted to members only.

Inserts a graphic icon that is conditionally displayed for an item in a rendered Content Tagged List content item if the Content is restricted to members checkbox is selected in the Properties section of the corresponding content record.

Inserts a graphic icon that is conditionally displayed for an item in a rendered Content Tagged List content item if the Mark as important until field in the Properties section of the corresponding content record contains a value and that date has not yet passed.

Lists the content record properties that can be used as elements in the tagged list format. The list of available properties includes all iMIS content management user-defined fields (UDFs) that are defined in the system.

• P icon – Inserts a pre-defined label for the corresponding content record property. You can modify this label after it has been inserted into the editing area.
• A icon – Inserts a string variable, delimited by brackets [ ], that will display the actual value of the content record property for each item in the rendered Content Tagged List content item. You should not directly edit this string, but you can safely delete it or change it by putting the cursor inside the string and clicking the iMIS Label Manager button on the toolbar.

If edits have been made to the Tagged List formats or you would like to move the social sharing icons to another position, do the following:

1. Go to RiSE > Tagging > Tagged list formats.
2. Select a Tagged list format and click Edit.
3. Select HTML and move the <asp:placeholder runat="server" id="ShareThisTaggedListItem"></asp:placeholder> to the location when you would like the social sharing icons to be placed.

Note: If this code is not in the Tagged list format then the social sharing icons will be added above the content being displayed.