Modifying a folder template

Use this subcommand to modify a folder template. System predefined folder templates cannot be modified by a build manager.

When you use an option more than once, the query expression relating to each usage is combined with an "or". For example, specify -release 1.0 -release 2.0 for a query expression of (release='1.0' or release='2.0).

Contributions from different options are combined with "and". For example, specify
-release 1.0 -platform windows for a query expression of (release='1.0') and (platform='windows').

Before you begin

You must be in the build_mgr or ccm_admin role to modify a folder template.

About this task

ccm ft|folder_temp|folder_template -m|-modify 
        [-w|-writable (owner | (build_mgr|build_manager|buildmanager) |
        all | none)] [-mode ((man|manual) | (uq|use_query))]
        ([-must_be_local] |[-nomust_be_local])
        [-desc|-description description] [-cus|-custom custom_query]
        [(-db|-dbid|-database_id database_spec)...]
        [(-plat|-platform platform)...] [(-purpose purpose)...] 
        [(-rel|-release release_spec)...]
        [(-sub|-subsystem subsystem)...]
        [-ts|-scope|-task_scope (user_defined |
        (all_my_assigned|all_owners_assigned) |
        (all_my_assigned_or_completed|all_owners_assigned_or_completed) |
        (all_my_completed|all_owners_completed) |
        (all_my_tasks|all_owners_tasks) | all_completed | all_tasks)]
        (ct_projs|ct_projects|component_task_projects) | 
        (ct_prods|ct_products|component_task_products) | 
        (ct_projs_prods|ct_projects_products | 
        component_task_projects_products))]
        folder_template_spec...
-cus|-custom custom_query
Specifies to include the specified custom query expression in the modified folder template query.
-desc|-description description
When modifying folders from the folder template, specifies a string used after keyword expansion. The description cannot contain newline characters. If you do not specify description, the folder template name is the default value. For details about keyword expansion, see Showing folder template information.
-db|-dbid|-database_id database_spec
Specifies the database ID that is associated with the folder template you are modifying. See Database specification for further details.
folder_template_spec
Specifies the folder template to be modified. See Folder template specification for details.
-mode ((man|manual) | (uq|use_query))
Specifies whether to add tasks to the folder manually or by using a query. Rational Synergy treats changes in mode from manual to query-based in these ways.
  • If you change a manual folder template to a query-based folder template and a query is also defined in the modify command, then the specified query is used.
  • If you change a manual folder template to a query-based folder template and no query is specified in the command:

    * If the folder template was previously query-based, its last query is used.

    * If the folder template was never query-based and there is a user-defined query (default task query), the user-defined query becomes the query.

    * If the folder template was never query-based and there is not a user-defined query (default task query), the query becomes All Tasks Assigned to your_user_name.

-must_be_local
Modifies the folder template so that it must use a local folder for update properties of locally created projects.
-nomust_be_local
Modifies the folder template so that it must use a non-local folder for update properties of locally created projects.
-plat|-platform platform
Specifies to update the folder template query. The new query includes platform='platform'. The platform choices are defined in the CCM_HOME\etc\om_hosts.cfg file (Windows), or $CCM_HOME/etc/om_hosts.cfg file (UNIX). If a folder template applies to multiple platforms, you do not set a platform value.
-purpose purpose
Specifies to create the folder with a task query that includes a query for the specified purpose. See the project_purpose command Showing a project purpose for a detailed description of purposes.

This option typically applies to queries for component tasks that are specified with one of these scopes: component_task_projects, component_task_products, or component_task_projects_products.

-rel|-release release_spec
Specifies to update the folder template with a new query. The query includes release='releasename'. You can set release_spec to multiple releases. See Release specification for further details.
-sub|-subsystem subsystem
Specifies to update the folder template with a new query. The query includes task_subsys='subsystem'.
-ts|-scope|-task_scope
Specifies to use a task query. The task query includes a query expression that depends on the specified scope. The query expression associated with the specified scope also depends on the -database_id option. You can use the following scopes:
  • user_defined

    This scope is defined by the default task query option. If you specify
    -database_id, the query also includes a query expression for tasks modifiable in or completed in the specified database.

  • all_my_assigned|all_owners_assigned

    This scope queries for all tasks assigned to you. If you specify -database_id, the query is for all tasks assigned to you that are modifiable in the specified database.

  • all_my_assigned_or_completed|all_owners_assigned_or_completed

    This scope queries for all tasks assigned to you or completed by you. If you specify -database_id, the query is for all tasks assigned to you and modifiable in the specified database, or completed by you in the specified database.

  • all_my_completed|all_owners_completed

    This scope queries for all tasks completed by you. If you specify -database_id, the query is for all tasks completed by you in the specified database.

  • all_my_tasks|all_owners_tasks

    This scope queries for all tasks for which you are the task resolver. If you specify -database_id, the query is for all tasks for which you are the task resolver and that are modifiable in the specified database or were completed in the specified database.

  • all_completed

    This scope queries for all completed tasks. If you specify -database_id, the query is for all tasks completed in the specified database.

  • all_tasks

    This scope queries for all tasks. If you specify -database_id, the query is for all tasks that are modifiable in the specified database or that were completed in the specified database.

  • component_task_projects|component_task_products| component_task_projects_products

    This scope queries for component tasks for projects, products, or projects and products. If you specify -database_id, the query is for all component tasks that were created in the specified database. If you specify -purpose, the query is for component tasks with the specified purpose.

-w|-writable (owner | (build_mgr|build_manager|buildmanager) | all | none)
Specifies to update the writable property for the folder template. All folders that were created from and are controlled by the folder template are updated to reflect the new permissions.

Feedback