| <?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="-2Vi1KjWxO7_4YSVPhYdIgA" |
| name="customizing_standard_categories,_Y_tk0KkVEd2XsY8-UtPVvw" guid="-2Vi1KjWxO7_4YSVPhYdIgA" |
| changeDate="2008-11-02T12:02:50.140-0800" version="7.5.0"> |
| <mainDescription><p>
 |
| It is assumed that the&nbsp;standard category&nbsp;(e.g., <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>) being customized cannot be modified directly. Thus, all changes must be
 |
| stored in a separate plug-in from the&nbsp;standard category being customized. To see the resulting changes, you need
 |
| to browse or publish a configuration that includes the original standard category plus the customizations. If&nbsp;you
 |
| can modify the standard category directly, you should follow the guidelines described in <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>
 |
| There are a number of different ways that you can customize an existing standard category.&nbsp;You can:&nbsp;
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| Assign elements to the category
 |
| </li>
 |
| <li>
 |
| Remove elements from the category
 |
| </li>
 |
| <li>
 |
| Replace an existing standard category with a new standard category
 |
| </li>
 |
| <li>
 |
| Rename the standard category
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| Specific standard category customization scenarios are described in the remaining sections of this guideline.
 |
| </p>
 |
| <h3>
 |
| Assign elements to the category
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to add a method element to an existing standard category:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If it does not already exist, create a plug-in to contain the standard category customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define a standard category that contributes to the existing standard category and assign the
 |
| new elements. 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>. For more information on assigning
 |
| elements to a standard category, 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>.&nbsp;
 |
| </li>
 |
| </ul>
 |
| <h3>
 |
| Remove elements from the category
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to remove a method element from an existing standard category:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If it does not already exist, create a plug-in to contain the standard category customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define a standard category and assign the same elements as in the original standard category,
 |
| except for the element you want to remove. For more information on assigning elements to a standard category, 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>
 |
| Change the definition of the new standard categoy to extends-replace the original standard category. For more
 |
| information on extends-replace, 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>
 |
| <h3>
 |
| Replace an existing standard category with a new&nbsp;standard category
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to replace an existing standard category with a new standard category:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If it does not already exist, create a plug-in to contain the standard category customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define the standard category and assign the desired elements. For more information on assigning
 |
| elements to a standard category, 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>
 |
| Change the definition of the new standard categoy to replace the original standard category. For more information
 |
| on replace, 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>
 |
| <h3>
 |
| Rename an existing standard category
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to rename an existing standard category:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If it does not already exist, create a plug-in to contain the standard category customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define a standard category and give it the desired presentation name. Specify that the new
 |
| standard category is to extend-replace the existing standard category. For more information on extends-replace, 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></mainDescription> |
| </org.eclipse.epf.uma:ContentDescription> |
