Creating a work product

A work product is a term that is used to describe task inputs and outputs.

There are three types of work products:

To create a work product:

  1. Expand the Method Content where you want to create the work product.
  2. Right-click Work Products and select one of the following work product types:
    • New > Artifact
    • New > Outcome
    • New > Deliverable
    The Work Product editor for the work product type that you chose opens and has the Description tab set as the default.
  3. In the Name field, type a unique name for your work product. The work product name is the file name that is in the Library view.
  4. In the Presentation name field, type a presentation name. The presentation name is the name that is in your published content and in the Configuration view. You can also make this name appear in the Library view by toggling the Show Presentation Names Show Presentation Names button button in the Library view toolbar.
  5. In the Brief Description field, type a short description of the new work product.
  6. In the Slots Information section, select the Is Work Product Slot check box to make the work product a slot, or alternatively click the Add button and select one or more work product slots to fulfill your work product.
    Slots Information
    Important: A work product cannot both be a slot and fulfill a slot. When you select the Is Work Product Slot check box, the Add button will be inactive and no work product slots can be added. For detail information about Work Product Slots, see Work Product slot fulfillment.
  7. In the Main Description field, type a more detailed description of the new work product. The main description is a more detailed version of the description that you typed into the Brief Description field. There are three ways to create text for the description:
    • Directly, by typing it manually in the editor.
    • Copying from another similar work product and modifying using the editor.
    • Copying from an HTML source, such as one of the OpenUp Web sites.

    You can use the Rich Text Editor to edit or enter the text for any field that has the Rich Text Editor icon rich text editor icon. Click the icon to access the Rich Text Editor. Click the icon again to close the Rich Text Editor. For more information about the editor, see Rich Text Editor.

  8. Under Notation, enter notations about the Work Product.
    Tip: Artifacts and Deliverables contain the Notation fields. Outcomes do not.
  9. Under Icon, you can select a node icon to appear with the work product in the Library and Configuration views and in the tree browser in a published Web site. The node icon must be 16 x 16 pixels. You can also select a Shape icon to appear at the top of the published Web page for the work product.
  10. Complete the other work product specific fields as needed. For information about adding variability to your work product, see Variability.
  11. Click the Guidance tab. When you select a guidance element, the brief description of the guidance is displayed. Use this part of the editor to add and remove guidance for the work product. To add guidance:
    1. Click Add.
    2. Select the guidance element that you want to add, and click OK.
    To remove guidance:
    1. In the Guidance field, select a guidance element.
    2. Click Remove.
  12. Click the Categories tab. Open the appropriate Select window by clicking Select or Add next to the category lists. Select a single domain or any number of work product kinds or custom categories and click OK. You can remove a work product from a category by selecting it and then clicking the appropriate Remove button.
    Note: A work product can be included in one domain, any number of work product types, and any number of custom categories.
  13. If the work product is a deliverable, you can go to the Deliverable Parts tab and define what the deliverable consists of. This part of the editor only appears for deliverables and it allows you to add other work products as part of the deliverable. When you select a work product, its brief description is displayed.
    1. Click the Deliverable Parts tab.
    2. To add work products, click Add, select the work products that you want to add, and click OK.
    3. To remove a work product, select it in the work products as deliverable parts field, and then click Remove.
  14. If the work product is an artifact, you can define sub-artifacts for it. Artifacts can be composed of sub-artifacts expressing that the definition of this artifact type is composed into sub-artifact definitions, which are part of the overall artifact. For example, the definition of a Use-Case model is composed into the definition of the Use Case artifact and the Actor artifact. To create a sub-artifact, right-click an artifact in the Library view and select New > Artifact. A new artifact editor is opened and the artifacts are displayed in a hierarchy in the Library view.
    Note: When applying a decomposed artifact to a process, the child artifacts are also shown in the process' breakdown structure. You can remove parts for the process as well as removing the sub-artifact descriptors in the process editor.
  15. Click the Preview tab to view the newly created work product. You can save it by closing the editor.