| <?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="-I4UMQVeS-fzpOhgrCHdKFw" |
| name="new_guideline,_sfzMkKlSEd2XsY8-UtPVvw" guid="-I4UMQVeS-fzpOhgrCHdKFw" changeDate="2008-11-02T18:55:12.734-0800" |
| version="7.5.0"> |
| <mainDescription><p>
 |
| <a class="elementLink" href="./../../../core.default.uma_concept.base/guidances/concepts/practice_F5C8EAAB.html"
 |
| guid="_qhCTAFRREd2CWscN8Mx6rg">Practice</a>&nbsp;customizations are stored in a separate plug-ins from
 |
| the&nbsp;practice being customized. Customizations to things that are delayed assigned (role, domain and discipline
 |
| assignments) are defined in Practice Assign plug-ins. All other practice customizations are defined in Practice Extend
 |
| plug-ins. For more information on delayed assignment, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/concepts/delayed_assignment_24142865.html"
 |
| guid="_rlrykJcbEd2sTqxclDgvog">Concept: Delayed Assignment</a>. For more information on Practice Extend and Assign
 |
| plug-ins, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/concepts/practice_lib_plugin_types_3EA8002F.html"
 |
| guid="__428YO6cEdygKbJMUVNEtg">Concept: Practice Library Plug-In Types</a>.
 |
| </p>
 |
| <p>
 |
| There are a number of different ways that you can customize an existing practice.&nbsp;You can:&nbsp;
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| Add a new practice-specific role, task, or work product (and possibly practice-specific processes that assembles
 |
| those elements)
 |
| </li>
 |
| <li>
 |
| Customize (not just by adding guidance) an existing practice-specific role, task, or work product (and possibly
 |
| customizing practice-specific processes that assembles those elements)
 |
| </li>
 |
| <li>
 |
| Add new practice-specific guidance and associate that guidance to an existing practice element
 |
| </li>
 |
| <li>
 |
| Customize existing practice-specific guidance
 |
| </li>
 |
| <li>
 |
| Change the practice role assignments (and customize any practice-specific processes to use the new role
 |
| assignments)
 |
| </li>
 |
| <li>
 |
| Change the practice domain or discipline&nbsp;assignments
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| The following sections describe how you would structure these practice customizations.
 |
| </p>
 |
| <p>
 |
| <strong>Add a new practice-specific work product</strong>
 |
| </p>
 |
| <p>
 |
| Perform the following steps to structure the addition of a new <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/work_product_826E4C22.html"
 |
| guid="_H4JXwB_SEdq6CKKKq4D7YA">work product</a>&nbsp;to the practice:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not exist, create a Practice Extend plug-in to contain the new work product.
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, create the new work product.
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, customize the necessary tasks to include the new work product as an input or an output (see
 |
| <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_method_content_element_87D73FFF.html"
 |
| guid="_5cHsoFJsEd2SzrMjC_svdw">Guideline: Customizing a Method Content Element</a>)..
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, if the new work product is produced by the practice, then you need to specify what <a
 |
| class="elementLink" href="./../../../core.mdev.common.base/guidances/concepts/work_product_slot_D5B44CE7.html"
 |
| guid="_Er1OcJIfEdybeduord13cg">Work Product Slot</a>&nbsp;the work product fills.<br />
 |
| &nbsp;&nbsp;&nbsp;
 |
| </li>
 |
| <li>
 |
| If one does not exist, create a new Assign plug-in to contain the assignment of the work product to a responsible
 |
| role.
 |
| </li>
 |
| <li>
 |
| In the new Assign plug-in, customize the appropriate role to be responsible for the new work product (see <a
 |
| class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_method_content_element_87D73FFF.html"
 |
| guid="_5cHsoFJsEd2SzrMjC_svdw">Guideline: Customizing a Method Content Element</a>).<br />
 |
| &nbsp;&nbsp;&nbsp;&nbsp;
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, if the new work product affects an existing practice-specific process, customize that
 |
| process to include the new work product and&nbsp;the tasks that&nbsp;produce or consume it, as well as any refined
 |
| role assignments&nbsp;(see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_process_E26AC308.html"
 |
| guid="_5e_qMFTMEd2N4vZAlUIPvw">Guideline: Customizing a Process</a>).&nbsp;
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, if you want to include the new new work product and&nbsp;the tasks that&nbsp;produce or
 |
| consume it in a new practice-specific process, create the process (see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_processes_756EDFA.html"
 |
| guid="_Y_JroEyDEdu4NY1n_hCY0w">Guideline: Defining Processes</a>).<br />
 |
| &nbsp;&nbsp;
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, customize the practice guidance element to add an association to the new work product and
 |
| any new practice-specific processes (see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_method_content_element_87D73FFF.html"
 |
| guid="_5cHsoFJsEd2SzrMjC_svdw">Guideline: Customizing a Method Content Element</a>).
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp;
 |
| </p>
 |
| <p>
 |
| <strong>Add a new practice-specific task</strong>
 |
| </p>
 |
| <p>
 |
| Perform the following steps to structure the addition&nbsp;of&nbsp;a new <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/task_6C1FF051.html"
 |
| guid="_x459ktnmEdmO6L4XMImrsA">task</a>&nbsp;to the practice:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not exist, create a new Extends plug-in to contain the new task.
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, create the new task, specifying the tasks input and output work products (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;<br />
 |
| &nbsp;&nbsp; &nbsp;&nbsp;&nbsp;
 |
| </li>
 |
| <li>
 |
| If one does not exist, create a new Assign plug-in to contain the assignment of a performing role to the new task.
 |
| </li>
 |
| <li>
 |
| In the new Assign plug-in, customize the new task to add a primary performing role (see <a
 |
| class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_method_content_element_87D73FFF.html"
 |
| guid="_5cHsoFJsEd2SzrMjC_svdw">Guideline: Customizing a Method Content Element</a>).<br />
 |
| &nbsp;&nbsp;&nbsp;&nbsp;
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, if the new task affects an existing practice-specific process, customize that process to
 |
| include the new&nbsp;task&nbsp;(see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_process_E26AC308.html"
 |
| guid="_5e_qMFTMEd2N4vZAlUIPvw">Guideline: Customizing a Process</a>).&nbsp;&nbsp;&nbsp;
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, if you want to include the new new task in a new practice-specific process, create the
 |
| process (see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_processes_756EDFA.html"
 |
| guid="_Y_JroEyDEdu4NY1n_hCY0w">Guideline: Defining Processes</a>).<br />
 |
| &nbsp;&nbsp;
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, customize the practice guidance element to add an association to the new task and any new
 |
| practice-specific processes (see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_method_content_element_87D73FFF.html"
 |
| guid="_5cHsoFJsEd2SzrMjC_svdw">Guideline: Customizing a Method Content Element</a>).
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp;
 |
| </p>
 |
| <p>
 |
| <strong>Add a new practice-specific role</strong>
 |
| </p>
 |
| <p>
 |
| Perform the following steps to structure the addition of&nbsp;a new <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/role_37A0C602.html"
 |
| guid="_yUefQNnmEdmO6L4XMImrsA">role</a>&nbsp;or <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/work_product_826E4C22.html"
 |
| guid="_H4JXwB_SEdq6CKKKq4D7YA">work product</a>&nbsp;to the practice:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not exist, create a new Assign plug-in to contain the new role.
 |
| </li>
 |
| <li>
 |
| In the new Assign plug-in, create the new role, as well as any role assignments (e.g., responsibility for work
 |
| products, primary performer for tasks).&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>.<br />
 |
| &nbsp;&nbsp;
 |
| </li>
 |
| <li>
 |
| If one does not exist, create a new Extends plug-in to contain practice customizations resulting from the new role.
 |
| </li>
 |
| <li>
 |
| If the new role affects an existing practice-specific process, in the Extends plug-in, customize the process to
 |
| include the new role, the tasks it performs and the work products it is responsible for (see <a
 |
| class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_process_E26AC308.html"
 |
| guid="_5e_qMFTMEd2N4vZAlUIPvw">Guideline: Customizing a Process</a>).&nbsp;
 |
| </li>
 |
| <li>
 |
| If you want to include the new role, the tasks it performs and the work products it is responsible for in a new
 |
| practice-specific process, in the Extends plug-in, create the process (see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_processes_756EDFA.html"
 |
| guid="_Y_JroEyDEdu4NY1n_hCY0w">Guideline: Defining Processes</a>).
 |
| </li>
 |
| <li>
 |
| Associate the role and any new practice-specific processes to the practice guidance element.
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp;
 |
| </p>
 |
| <p>
 |
| <strong>Customize (not just by adding guidance) an existing&nbsp;practice-specific role or work product</strong>
 |
| </p>
 |
| <p>
 |
| Perform the following steps to structure the customization (not just by adding guidance) an
 |
| existing&nbsp;practice-specific <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/role_37A0C602.html"
 |
| guid="_yUefQNnmEdmO6L4XMImrsA">role</a>&nbsp;or <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 exist, create an Extends&nbsp;plug-in to contain the practice customizations.
 |
| </li>
 |
| <li>
 |
| Customize the method content elements (see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_method_content_element_87D73FFF.html"
 |
| guid="_5cHsoFJsEd2SzrMjC_svdw">Guideline: Customizing a Method Content Element</a>).
 |
| </li>
 |
| <li>
 |
| If the customized elements affect an existing practice-specific process, customize that process (see <a
 |
| class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_process_E26AC308.html"
 |
| guid="_5e_qMFTMEd2N4vZAlUIPvw">Guideline: Customizing a Process</a>).
 |
| </li>
 |
| <li>
 |
| If you want to include the customized elements in a new practice-specific process, create the process (see <a
 |
| class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_processes_756EDFA.html"
 |
| guid="_Y_JroEyDEdu4NY1n_hCY0w">Guideline: Defining Processes</a>).&nbsp;
 |
| </li>
 |
| <li>
 |
| Associate any new practice-specific processes to the practice guidance element.
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;
 |
| </p>
 |
| <h3>
 |
| Add new practice-specific guidance
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to structure the addition of <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/guidance_549AC394.html"
 |
| guid="_83ttAB_NEdq6CKKKq4D7YA">guidance</a>&nbsp;to the practice:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If one does not exist, create an Extends plug-in to contain the practice customizations.
 |
| </li>
 |
| <li>
 |
| Create the guidance and associate with the appropriate practice elements (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>
 |
| Associate the guidance to the practice guidance element.&nbsp;
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp; &nbsp;&nbsp;
 |
| </p>
 |
| <h3>
 |
| Customize existing practice-specific guidance
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to structure the customization of&nbsp;existing practice-specific <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 exist, create an Extends plug-in to contain the practice customizations.
 |
| </li>
 |
| <li>
 |
| Customize the guidance (see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/customizing_method_content_element_87D73FFF.html"
 |
| guid="_5cHsoFJsEd2SzrMjC_svdw">Guideline: Customizing a Method Content Element</a>).
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 |
| </p>
 |
| <h3>
 |
| Change the practice role assignments&nbsp;
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to structure the changing of the&nbsp;practice <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/role_37A0C602.html"
 |
| guid="_yUefQNnmEdmO6L4XMImrsA">role</a>&nbsp;assignments (what roles perform what tasks or what roles are responsible
 |
| for what work products):
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| Make a copy of the Practices Assign plug-in to create a new Assign plug-in.
 |
| </li>
 |
| <li>
 |
| In the new Assign plug-in,&nbsp;define any new roles&nbsp;(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>
 |
| In the new Assign plug-in, change the desired task-to primary performing-role assignments and the role-responsible
 |
| for-work product assignments (update the contributors).&nbsp;<br />
 |
| &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;
 |
| </li>
 |
| <li>
 |
| If the practice contains processes that are affected by the role assignment changes, then perform the following to
 |
| update the practice processes to use the new role assignments:
 |
| </li>
 |
| <li style="LIST-STYLE-TYPE: none">
 |
| <ul>
 |
| <li>
 |
| Create an Extends plug-in to contain the practice customizations resulting from the role assignment
 |
| changes.
 |
| </li>
 |
| <li>
 |
| Make a copy of the default configuration for the process to be updated.
 |
| </li>
 |
| <li>
 |
| In the new configuration, add the new Extends plug-in, remove the original Practice Assign plug-in and
 |
| select the new Assign plug-in.
 |
| </li>
 |
| <li>
 |
| In the Extends plug-in, for each affected process in the original practice: 
 |
| <ul>
 |
| <li>
 |
| Create new process by copying the original process
 |
| </li>
 |
| <li>
 |
| Change the default configuration of the new process to the new construction configuration.
 |
| </li>
 |
| <li>
 |
| Synchronize the new process against the new configuration. For more information on descriptors and
 |
| process synchronization, see <a class="elementLinkWithType"
 |
| href="./../../../core.mdev.common.base/guidances/guidelines/defining_processes_756EDFA.html"
 |
| guid="_Y_JroEyDEdu4NY1n_hCY0w">Guideline: Defining Processes</a>. The process now should reflect
 |
| the new role assignments.<br />
 |
| &nbsp;&nbsp;&nbsp;
 |
| </li>
 |
| </ul>
 |
| </li>
 |
| </ul>
 |
| </li>
 |
| </ul>
 |
| <h3>
 |
| Change the practice domain or discipline assignments
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to structure the changing of the&nbsp;practice <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/domain_D8238B93.html"
 |
| guid="_yHEVYdnmEdmO6L4XMImrsA">domain</a>&nbsp;or <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/discipline_7667F451.html"
 |
| guid="_yGUuidnmEdmO6L4XMImrsA">discipline</a>&nbsp;assignments:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| Make a copy of the Practices Assign plug-in to create a new Assign plug-in.
 |
| </li>
 |
| <li>
 |
| In the new Assign plug-in,&nbsp;define any new domains or disciplines (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>).
 |
| </li>
 |
| <li>
 |
| In the new Assign plug-in, change the desired domain to work product or discipline to task categorizations (update
 |
| the contributors).&nbsp;
 |
| </li>
 |
| <li>
 |
| In order to see the standard category changes, you need to browse a configuration that includes the new Assign
 |
| plug-in instead of the original Assign plug-in.
 |
| </li>
 |
| </ul></mainDescription> |
| </org.eclipse.epf.uma:ContentDescription> |