| <?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="-ip4DsYLn7L_pBfKKD8wxRw" |
| name="customizing_custom_cat,_TNlCkKkfEd2XsY8-UtPVvw" guid="-ip4DsYLn7L_pBfKKD8wxRw" |
| changeDate="2008-11-02T11:42:50.953-0800" version="7.5.0"> |
| <mainDescription><p>
 |
| It is assumed that the <a class="elementLink"
 |
| href="./../../../core.default.uma_concept.base/guidances/termdefinitions/custom_category_554AC4D6.html"
 |
| guid="_eqw94MaFEduMlb2cQZNTYw">custom category</a>&nbsp;being customized cannot be modified directly. Thus, all changes
 |
| must be stored in a separate plug-in from the&nbsp;custom category being customized. To see the resulting changes, you
 |
| need to browse or publish a configuration that includes the original custom category plus the customizations.
 |
| If&nbsp;you can modify the custom category directly, you should follow the guidelines described in <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>.
 |
| </p>
 |
| <p>
 |
| There are a number of different ways that you can customize an existing custom category.&nbsp;You can:&nbsp;
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| Add elements to an existing custom category
 |
| </li>
 |
| <li>
 |
| Re-order the elements in an existing custom category
 |
| </li>
 |
| <li>
 |
| Replace an existing custom category
 |
| </li>
 |
| <li>
 |
| Rename an existing custom category
 |
| </li>
 |
| </ul>
 |
| <p>
 |
| Specific custom category view customization scenarios are described in the remaining sections of this guideline.
 |
| </p>
 |
| <h3>
 |
| Add elements to an existing custom category
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to add a method element to an existing custom category:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If it does not already exist, create a plug-in to contain the custom category customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define a custom category that contributes to the existing custom category. 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>
 |
| <li>
 |
| In the contributor, assign the elements you would like to see added to the category. If you want to add a
 |
| sub-custom category to the category, define a sub-custom category. You can even control the order in which the
 |
| elements appear in the category, relative to the existing elements. For more information on adding elements to a
 |
| custom category, 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>.&nbsp;
 |
| </li>
 |
| </ul>
 |
| <h3>
 |
| Re-order the elements in an existing custom category
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to reorder the elements in an existing custom category:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If it does not already exist, create a plug-in to contain the custom category&nbsp;customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define a custom category and assign all the same elements as the original custom category.
 |
| Re-order the elements in the custom category, as desired. For more information on adding elements to a custom
 |
| category, 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>.&nbsp;
 |
| </li>
 |
| <li>
 |
| Change the definition of the new custom category to replace the original&nbsp;custom category&nbsp;using method
 |
| content variability. 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>.&nbsp;
 |
| </li>
 |
| </ul>
 |
| <h3>
 |
| Replace an existing custom category
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to replace an existing custom category&nbsp;with a new custom category:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If it does not already exist, create a plug-in to contain the custom category&nbsp;customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define a custom category and assign all desired elements to the custom category. Re-order the
 |
| elements in the custom category, as desired. For more information on adding elements to a custom category, 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>.&nbsp;
 |
| </li>
 |
| <li>
 |
| Change the definition of the new custom category to replace the original custom category using method content
 |
| variability. 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>.&nbsp;
 |
| </li>
 |
| </ul>
 |
| <h3>
 |
| Rename an existing custom category
 |
| </h3>
 |
| <p>
 |
| Perform the following steps to rename an existing custom category:
 |
| </p>
 |
| <ul>
 |
| <li>
 |
| If it does not already exist, create a plug-in to contain the custom category customizations.
 |
| </li>
 |
| <li>
 |
| In the new plug-in, define a custom category that extends and replaces the existing custom category using method
 |
| content variability. 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>.&nbsp;
 |
| </li>
 |
| <li>
 |
| Give the new custom category the desired presentation name.
 |
| </li>
 |
| </ul></mainDescription> |
| </org.eclipse.epf.uma:ContentDescription> |
