| <?xml version="1.0" encoding="UTF-8"?> |
| <org.eclipse.epf.uma:ContentDescription xmi:version="2.0" |
| xmlns:xmi="http://www.omg.org/XMI" xmlns:org.eclipse.epf.uma="http://www.eclipse.org/epf/uma/1.0.5/uma.ecore" |
| xmlns:epf="http://www.eclipse.org/epf" epf:version="1.5.0" xmlns:rmc="http://www.ibm.com/rmc" |
| rmc:version="7.5.0" xmi:id="-iX4p3xdGFx7HgBxeSG1_uA" |
| name="customizing_method_content_element,_5cHsoFJsEd2SzrMjC_svdw" guid="-iX4p3xdGFx7HgBxeSG1_uA" |
| changeDate="2008-11-02T05:07:09.718-0800" version="7.2.0"> |
| <mainDescription><p>
 |
| Any <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/method_content_6972AE81.html"
 |
| guid="_Ts2joB_MEdq6CKKKq4D7YA">method content</a>&nbsp;element can be customized. The different ways you can customize
 |
| an element include:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| adding guidance to existing method content elements
 |
| </li>
 |
| <li>
 |
| adding new roles, tasks and work products
 |
| </li>
 |
| <li>
 |
| adding text and/or relationships to an existing method content element
 |
| </li>
 |
| <li>
 |
| replacing an existing method content element&nbsp;&nbsp;&nbsp;&nbsp;
 |
| </li>
 |
| <li>
 |
| renaming an existing method content element&nbsp;
 |
| </li>
 |
| <li>
 |
| changing method content relationships (e.g., changing&nbsp;the role that is responsible for a work
 |
| product,&nbsp;changing the primary performing role for a task, changing the input and/or output work products of a
 |
| task)&nbsp;
 |
| </li>
 |
| <li>
 |
| deleting existing method content elements&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| It is assumed that the method content element being customized cannot be modified directly. Thus, all changes must be
 |
| stored in a separate plug-in from the method content elements being customized. The customizations are then defined
 |
| using method content variability. To see the resulting changes, you need to browse or publish a configuration that
 |
| includes the element being customized and the customizations. For more information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/using_method_content_variability_DCE37365.html"
 |
| guid="_8YIMYCNQEdycLddDalDmbA">Guideline: Using Method Content Variability</a>. If&nbsp;you can modify the elements
 |
| directly, you should follow the guidelines described in <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_method_content_elements_21A491E3.html"
 |
| guid="_XQqJkCAmEdy1y5bWsXfCCg">Guideline: Defining Method Content Elements</a>.
 |
| </p>
 |
| <p>
 |
| If you customize a method content element that participates in a process, then&nbsp;you will need to customize that
 |
| process to use the customized method content.&nbsp;For more information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_processes_E26AC308.html"
 |
| guid="_5e_qMFTMEd2N4vZAlUIPvw">Guideline: Customizing a Process</a>.
 |
| </p>
 |
| <p>
 |
| If you add a new element that is categorized, then&nbsp;you may need to add the new elements to the appropriate
 |
| standard categories.&nbsp;For more information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/categorizing_method_elements_using_std_cats_854BD33A.html"
 |
| guid="_thsRIMjnEdyoXMhaXAJ-6g">Guideline: Categorizing Method Elements Using Standard Categories</a>.
 |
| </p>
 |
| <p>
 |
| The following sections provide specific information on how to customize method content elements.
 |
| </p>
 |
| <p>
 |
| &nbsp;&nbsp;
 |
| </p>
 |
| <h3>
 |
| Add guidance to an existing method content element
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to add guidance to existing method content elements:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not already exist, define the plug-in to contain the customization
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define the guidance element.&nbsp;For more information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_method_content_elements_21A491E3.html"
 |
| guid="_XQqJkCAmEdy1y5bWsXfCCg">Guideline: Defining Method Content Elements</a>.
 |
| </li>
 |
| <li>
 |
| Determine what method elements the guidance should be associated with/referenced from and where those elements
 |
| exist.&nbsp;
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define an element that contributes to the original and add the association to the guidance in
 |
| the contributor.&nbsp;For more information on contribution, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/using_method_content_variability_DCE37365.html"
 |
| guid="_8YIMYCNQEdycLddDalDmbA">Guideline: Using Method Content Variability</a>.
 |
| </li>
 |
| </ul><br />
 |
| <h3>
 |
| Add a new role
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to add new method <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/role_37A0C602.html"
 |
| guid="_yUefQNnmEdmO6L4XMImrsA">role</a>:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not already exist, create a plug-in to to contain the new role.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, create the new role and specify what work products the role should own. For more information,
 |
| see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_method_content_elements_21A491E3.html"
 |
| guid="_XQqJkCAmEdy1y5bWsXfCCg">Guideline: Defining Method Content Elements</a>.
 |
| </li>
 |
| <li>
 |
| If&nbsp;you want to add the role as a performer of an existing task, in the new plug-in, create a task that
 |
| contributes to the task you want to change. In the contributor, add an association to the new role.
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp;
 |
| </p>
 |
| <h3>
 |
| Add a new task
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to add new method <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/task_6C1FF051.html"
 |
| guid="_x459ktnmEdmO6L4XMImrsA">task</a>:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not already exist, create a plug-in to to contain the new task.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, create the new task, being sure to&nbsp;specify&nbsp;what role performs the task and what work
 |
| products are input and output. For more information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_method_content_elements_21A491E3.html"
 |
| guid="_XQqJkCAmEdy1y5bWsXfCCg">Guideline: Defining Method Content Elements</a>.&nbsp;
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp;&nbsp; &nbsp;
 |
| </p>
 |
| <h3>
 |
| Add a new work product
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to add new method <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/work_product_826E4C22.html"
 |
| guid="_H4JXwB_SEdq6CKKKq4D7YA">work product</a>:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not already exist, create a plug-in to to contain the new work product.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, create the new work product. For more information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_method_content_elements_21A491E3.html"
 |
| guid="_XQqJkCAmEdy1y5bWsXfCCg">Guideline: Defining Method Content Elements</a>.&nbsp;
 |
| </li>
 |
| <li>
 |
| If&nbsp;you want to add the work product as an input or an output&nbsp;of&nbsp;an existing task, in the new
 |
| plug-in, create a task that contributes to the task you want to change. In the contributor, add an association to
 |
| the work product.
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;
 |
| </p>
 |
| <h3>
 |
| Add new&nbsp;text and/or relationships to an existing method content element
 |
| </h3>
 |
| <p>
 |
| Anything (text and/or associations can be added to any method content element using contribution, a type of method
 |
| content variability. For more information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/using_method_content_variability_DCE37365.html"
 |
| guid="_8YIMYCNQEdycLddDalDmbA">Guideline: Using Method Content Variability</a>.
 |
| </p>
 |
| <p>
 |
| Perform the following steps to add text and/or associations to an existing method content element:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not already exist, create a plug-in to to contain the method content element additions.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, create an element of the same type as the element you want to add to an make that element
 |
| contribute to the element you want to add to. For example, if I wanted to add an input work product to a task, I
 |
| would create a task contributor.
 |
| </li>
 |
| <li>
 |
| In the contributor, add whatever it is you want to add to the original element. For example, if I wanted to add an
 |
| input work product to a task, I would create a an input work product to the task contributor. For more information,
 |
| see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_method_content_elements_21A491E3.html"
 |
| guid="_XQqJkCAmEdy1y5bWsXfCCg">Guideline: Defining Method Content Elements</a>.&nbsp;&nbsp;<br />
 |
| &nbsp;&nbsp;
 |
| </li>
 |
| </ul>
 |
| <h3>
 |
| Replace an existing method content element
 |
| </h3>
 |
| <p>
 |
| Any method content element can be replaced using replaces, a type of method content variability. For more information,
 |
| see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/using_method_content_variability_DCE37365.html"
 |
| guid="_8YIMYCNQEdycLddDalDmbA">Guideline: Using Method Content Variability</a>.
 |
| </p>
 |
| <p>
 |
| Perform the following steps to replace an existing method content element (e.g., a <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/role_37A0C602.html"
 |
| guid="_yUefQNnmEdmO6L4XMImrsA">role</a>, <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/task_6C1FF051.html"
 |
| guid="_x459ktnmEdmO6L4XMImrsA">task</a>, <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/work_product_826E4C22.html"
 |
| guid="_H4JXwB_SEdq6CKKKq4D7YA">work product</a>&nbsp;or <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/guidance_549AC394.html"
 |
| guid="_83ttAB_NEdq6CKKKq4D7YA">guidance</a>):
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not already exist, create a plug-in to to contain the method content element that will be replacing the
 |
| original.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, create the element you want to replace the existing element with (they must be of the same
 |
| type). For example, if I wanted to replace a task with a new task, I would create a new task.
 |
| </li>
 |
| <li>
 |
| Specify that the new task is to replace the original task (replaces variability).
 |
| </li>
 |
| <li>
 |
| Add the replacers outgoing relationships and textual descriptions. For example, if I wanted to replace task, I
 |
| would specify the task's primary performing role and input and output work products. For more information, see <a
 |
| class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_method_content_elements_21A491E3.html"
 |
| guid="_XQqJkCAmEdy1y5bWsXfCCg">Guideline: Defining Method Content Elements</a>.&nbsp;&nbsp;<br />
 |
| &nbsp;&nbsp;&nbsp;
 |
| </li>
 |
| </ul>
 |
| <h3>
 |
| Rename an existing method content element
 |
| </h3>
 |
| <p>
 |
| Any method content element can be renamed using extends-replaces, a type of method content variability. For more
 |
| information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/using_method_content_variability_DCE37365.html"
 |
| guid="_8YIMYCNQEdycLddDalDmbA">Guideline: Using Method Content Variability</a>.
 |
| </p>
 |
| <p>
 |
| Perform the following steps to rename an existing method content element (e.g., a <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/role_37A0C602.html"
 |
| guid="_yUefQNnmEdmO6L4XMImrsA">role</a>, <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/task_6C1FF051.html"
 |
| guid="_x459ktnmEdmO6L4XMImrsA">task</a>, <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/work_product_826E4C22.html"
 |
| guid="_H4JXwB_SEdq6CKKKq4D7YA">work product</a>&nbsp;or <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/guidance_549AC394.html"
 |
| guid="_83ttAB_NEdq6CKKKq4D7YA">guidance</a>):
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not already exist, create a plug-in to to contain the method content element with the new name.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, create a method content element of the same type as the one you want to rename and give it the
 |
| name you want to use as the new name. For example, if I wanted to rename a task to MyTask, I would create a new
 |
| task and name it MyTask. For more information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_method_content_elements_21A491E3.html"
 |
| guid="_XQqJkCAmEdy1y5bWsXfCCg">Guideline: Defining Method Content Elements</a>.
 |
| </li>
 |
| <li>
 |
| Specify that the new task is to extends-replace the original task (extends-replaces variability).
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;
 |
| </p>
 |
| <h3>
 |
| Change the role that is responsible for a work product
 |
| </h3>
 |
| <p>
 |
| A <a class="elementLink" href="./../../../core.default.uma_concept.base/guidances/termdefinitions/role_37A0C602.html"
 |
| guid="_yUefQNnmEdmO6L4XMImrsA">role</a>&nbsp;may be responsible for one or more work products. A work product may have
 |
| only one responsible role. The role "owns" the role-responsible for-work product association.
 |
| </p>
 |
| <p>
 |
| Perform the following steps to change the responsible role for an existing work product:
 |
| </p>
 |
| <ul class="noindent">
 |
| <li>
 |
| If one does not already exist, create a plug-in to to contain the customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, role and make it contributor to the role that you want to assign the work product to.
 |
| </li>
 |
| <li>
 |
| In the role contributor, add an association to the work product.
 |
| </li>
 |
| <li>
 |
| If there are now two roles that are responsible for the work product, the original responsibility must be removed.
 |
| </li>
 |
| <li>
 |
| Define a role that extends and replaces the original responsible role. In the extends-replaces element, add all of
 |
| the role-responsible for-work product associations that existed in the original role, except for the one your just
 |
| replaced.&nbsp;
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp;&nbsp; &nbsp;
 |
| </p>
 |
| <h3>
 |
| Change the primary performing role for a task
 |
| </h3>
 |
| <p>
 |
| A <a class="elementLink" href="./../../../core.default.uma_concept.base/guidances/termdefinitions/task_6C1FF051.html"
 |
| guid="_x459ktnmEdmO6L4XMImrsA">task</a>&nbsp;may only have one primary performing <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/role_37A0C602.html"
 |
| guid="_yUefQNnmEdmO6L4XMImrsA">role</a>. The task "owns" the task-primarily perform by-role association.
 |
| </p>
 |
| <p>
 |
| Perform the following steps to change the primary performing role for an existing task:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not already exist, create a plug-in to to contain the customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define a task that extends and replaces the original task.
 |
| </li>
 |
| <li>
 |
| In the new task, specify the role as the primary performer. There is no need to make any more changes since every
 |
| task can only have one primary performing role.<br />
 |
| </li>
 |
| </ul>
 |
| <h3>
 |
| Change the input and/or output work products of a task
 |
| </h3>
 |
| <p>
 |
| A <a class="elementLink" href="./../../../core.default.uma_concept.base/guidances/termdefinitions/task_6C1FF051.html"
 |
| guid="_x459ktnmEdmO6L4XMImrsA">task</a>&nbsp;may only have any number of input and output <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/work_product_826E4C22.html"
 |
| guid="_H4JXwB_SEdq6CKKKq4D7YA">work product</a>s. The task "owns" the task-work product associations.
 |
| </p>
 |
| <p>
 |
| Perform the following steps to change the input and/or output work products of an existing task:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not already exist, create a plug-in to to contain the customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define a task that extends and replaces the original task.
 |
| </li>
 |
| <li>
 |
| In the new task, specify the desired input and output work products for the task, including those from the original
 |
| that you want to carry forward, plus the associations to your new work products.&nbsp;<br />
 |
| &nbsp;&nbsp; &nbsp;&nbsp;
 |
| </li>
 |
| </ul>
 |
| <h3>
 |
| Delete existing method content elements
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to remove an existing method element:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not already exist, define a new plug-in to contain the customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, create a custom category; name it something like "do not publish". Assign the elements you want
 |
| removed to that category. For more information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/categorizing_method_elements_using_custom_cats_F66C3F90.html"
 |
| guid="_V7qwIMjpEdyoXMhaXAJ-6g">Guideline: Categorizing Method Elements Using Custom Categories</a>.
 |
| </li>
 |
| <li>
 |
| Define a new <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/method_configuration_C2B8FA8A.html"
 |
| guid="__V7pAMaEEduMlb2cQZNTYw">method configuration</a>&nbsp;that includes everything you want to publish. Specify
 |
| not to publish the new custom category.&nbsp; For more information, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_method_configurations_2B25CEA5.html"
 |
| guid="_l77zcIB-EduaS6LQ8n6xUQ">Guideline: Defining Method Configurations</a>. When you publish that configuration,
 |
| those elements will not appear.
 |
| </li>
 |
| </ul></mainDescription> |
| </org.eclipse.epf.uma:ContentDescription> |