Configuring the Timeline Chart Properties

You can configure the fields that are displayed in the timeline chart for roadmap objects (for example, products) and milestone objects (for example, tasks). Baseline timeline functionality is provided for products and tasks, but you can configure these settings to get the timeline chart for other objects.

See Properties for Timeline Chart Properties.

  1. Create or open the text file for customized properties. For more information, see Editing Properties Using MQL.
  2. To configure the symbolic name of the relationship that is used to retrieve all the milestones for the roadmap object, follow these steps:
    1. Add or edit this line in the file used to import properties into a page object:

      emxProduct.Roadmap.Milestone.Relationship=relationship_RoadmapTask

    2. Set the property to the symbolic name you would like to use.
  3. To configure the attribute on the milestone relationship that is used to retrieve the milestone type information, follow these steps:
    1. Add or edit this line in the file used to import properties into a page object:

      emxProduct.Roadmap.Milestone.Title=attribute_MilestoneType

    2. Set the property to the attribute you would like to use.
  4. To configure the details that are shown for a roadmap object as a tool-tip over the object image, follow these steps for each type:

    If more than one field is to be displayed then it is specified using a comma separated string.

    1. Add or edit these lines in the file used to import properties into a page object:

      emxProduct.Roadmap.Object.Details.type_Products=description
      emxProduct.Roadmap.Object.DetailLabels.type_Products=emxFramework.Basic.Description

      The first setting is used to determine the actual field value to be displayed. The second setting is used to determine the label for the field. If any attribute is to be displayed, then the symbolic name of the attribute must be specified. The label must be a key in the emxProductStringResource.properties page object, to support internationalization.

    2. Set the properties to the details you would like shown. By default, the product description is shown for type Product.
  5. To configure the details that are shown for a milestone object as a tool-tip over the object image, follow these steps for each type:

    If more than one field is to be displayed then it is specified using a comma separated string.

    1. Add or edit these lines in the file used to import properties into a page object:

      emxProduct.Roadmap.Milestone.Details.type_Task=startDate,finishDate
      emxProduct.Roadmap.Milestone.DetailLabels.type_Task=startDate,finishDate

      The first setting is used to determine the actual field value to be displayed. The second setting is used to determine the label for the field.

    2. Set the properties to the details you would like displayed. By default, the start date and end date of the task are displayed in the timeline chart. If any attribute is to be displayed then the symbolic name of the attribute has to be specified. The label must be a key in the application string-resource page object, to support internationalization.

      The two words startdate and finishdate are reserved for this setting and if these words are specified in then the estimated start date and end date of the milestone object will be displayed. But if the milestone is finished then actual start date and actual end date will be displayed. The following attributes of the milestone object will be used for fetching these fields:

      • Task Estimated Start Date
      • Task Estimated End Date
      • Task Actual Start Date
      • Task Actual End Date

  6. To support subtypes of a task in the product roadmap, you need to add a property for each subtype. For example, if you add subtypes of Task Management called Phase and Milestone, you need to add or edit these lines in the file used to import properties into a page object:

    emxProduct.Roadmap.Milestone.Details.type_Phase=startDate,finishDate
    emxProduct.Roadmap.Milestone.DetailLabels.type_Phase=startDate,finishDate
    emxProduct.Roadmap.Milestone.Details.type_Milestone=startDate,finishDate
    emxProduct.Roadmap.Milestone.DetailLabels.type_Milestone=startDate,finishDate

  7. To specify the default image to be used for the roadmap object if there is no primary image set for the object, follow these steps:
    1. Add or edit this line in the file used to import properties into a page object:

      emxProduct.Roadmap.Object.Image.Default=${COMMON_DIR}/images/utilUndefinedImage.gif

    2. Set the property to the location of the image that you would like to use.
  8. To specify the display image for each milestone type, follow these steps:

    The different milestone types are nothing but the range values of the attributes specified in the setting emxProduct.Roadmap.Milestone.Title. For each range value one setting has to be added in the property page object.

    1. Add or edit these lines in the file used to import properties into a page object:

      emxProduct.Roadmap.Milestone.Icon.Start=${COMMON_DIR}/images/iconStatusStarted.gif
      emxProduct.Roadmap.Milestone.Icon.Launch=${COMMON_DIR}/images/iconStatusLaunched.gif
      emxProduct.Roadmap.Milestone.Icon.Milestone=${COMMON_DIR}/images/iconStatusVendorReviewed.gif
      emxProduct.Roadmap.Milestone.Icon.End=${COMMON_DIR}/images/iconStatusFinished.gif

    2. Set the properties to the location image that you would like to use for each milestone type.
  9. To specify the symbolic name of the attribute on the roadmap relationship that is used to retrieve the date preference (Start or Finish) to be used to plot the particular milestone, follow these steps:
    1. Add or edit these lines in the file used to import properties into a page object:

      emxProduct.Roadmap.Milestone.Date=attribute_Date
      emxProduct.Roadmap.Milestone.Date.Start = Start
      emxProduct.Roadmap.Milestone.Date.End = End

    2. Set the properties to the range values that you would like to use for the milestone.
  10. When you are finished updating the text file with all properties that you want to modify, use the text file to modify the emxProductLine.properties page object. For more information, see Editing Properties Using MQL.