Description box in web client

If extended rich text is enabled for your application server, various icons are available to format text in the Description field.

1. To enable extended rich text, complete one of the following steps:
   • In the Advanced Properties page, set the Enable extended rich text presentation property to True. For more information, see Configuring advanced properties.
   • 1. Edit the server-installation-directory\server\conf\ccm\teamserver.properties file.
     2. Stop the server, and then add the following line in the teamserver.properties file: com.ibm.team.workitem.enableExtendedRichTextPresentation=true.
     3. Save the updated teamserver.properties file, then restart the server.

   The following icons are available.

   Toolbar icon	Description
   	Bolds text.
   	Italicizes text.
   	Places a line through text.
   	Places a line under the text.
   	Removes all formatting from the selected text.
   	Inserts a numbered list.
   	Inserts an unordered list.
   	Inserts a horizontal line across the entire length of the Description field.
   	Applies a specific font to text. Select the wanted font from the list.
   	Sets text to a specific size. Select the wanted size from the list.
   	Sets the color of the text. Select the wanted color from the grid.
   	Sets the background color of the text. Select the wanted background color from the grid.
   	Decreases the indentation of the selected text.
   	Increases the indentation of the selected text.
   	Insert the table inline to the description.
   	Inserts image inline to the description. The following types of images are supported: JPEG GIF PNG BMP

2. To add images, inline to the description:
   1. Place your cursor where you want to add an image, and consider the following scenarios:

      Copy-paste a screenshot from the clipboard

      You can capture a screen shot and use the browser context menu or press Ctrl+V on Windows or Cmd+V on Mac to paste it in the description of a work item.

      Copy-paste an image from the file explorer

      You can copy an image file from file explorer by using the browser context menu or press Ctrl+C on Windows and Cmd+C on Mac and paste it in the description of a work item by using the browser context menu or keyboard shortcuts Ctrl+V on Windows and Cmd+V on Mac.

      Browse an existing attachment of the same work item

      1. Click the icon or press Cmd+Shift+2 on Mac and Ctrl+Shift+2 on Windows to open the Insert image box.
      2. In the Attachment on this work item field, select from the filtered list of attachments, the attachment that you want to add as an image or in the Attachment ID field, specify the ID of the attachment. You can preview the image in the Preview box.
      3. In the Alternative text field, specify the alternative text for the image and click OK.

      Browse an existing attachment of another work item

      To add an image added as an attachment in another work item, specify the attachment ID of that image in the Insert image box.

   2. To view or edit the properties of an inline image, double-click the image or select the image and press Cmd+Shift+I on Mac and Ctrl+Shift+I on Windows to open the Insert image box.
3. To add a table in the description field, click the icon or press Ctrl+Alt+T on Windows and Cmd+Alt+T on Mac. Right-click on the table to perform the following actions that are related to tables:
   • Set Table Properties:
     • Set header row/column for the table
     • Set a caption or a table
   • Delete a table.
   • Insert rows and columns.
   • Set cell properties:
     • Merge cells horizontally or vertically by using row and column span.
     • Split cells horizontally or vertically.
     • Set the height or width of individual cells (set column width or row height).
     • Set the cell color.

   Consider the following information to know more about the actions that you can perform on the inline images and tables from various editors.

   Editors	Add an inline image/table	View an inline image/table	Edit an inline image/table	Copy from another work item	Delete an inline image/table
   Work item editor	Y	Y	Y	Y	Y
   Plans inline editor	Y	Y	Y	Y	Y
   Query results inline editor	Y	Y	Y	Y	Y
   Quick planner	N	Y	N	Y	Y
   Eclipse client	N	Y	N	N	N
   Visual studio client	Y	Y	Y	Y	Y
   OSLC creation dialog	Y	Y	Y	Y	Y
   OSLC, REST, or Java™ client	Y	N	Y	Y	Y

   Note:

   • Viewing and editing of inline images and tables is in accordance with the existing extended rich text (ERT) behavior.
   • You cannot copy and paste an image from a work item in one Engineering Workflow Management repository to a work item in another Engineering Workflow Management repository.
   • The history of a work item displays the latest version of the table. It shows changes to the table contents but does not highlight structural changes, such as adding, deleting rows and columns.
   • Tables are not visible if the email format is plain text.
   • You can only see the alt-text of the image in an email.
   • You can view the inline images added in the work item description and large HTML fields of Jazz Reporting Service reports, but not tables.
   • You cannot view the inline images and tables added in the work item description and large HTML fields from IBM® Engineering Lifecycle Optimization - Publishing - generated documents and IBM Engineering Lifecycle Optimization Engineering Insights views.
   • You cannot view existing inline images in the work item history view if the context root is changed as part of the server rename. Any new images added to the work item after the server rename are displayed in the history view.