Showing folder template information

About this task

This subcommand shows information about a folder template.

ccm ft|folder_temp|folder_template -s|-sh|-show (i|info|information) 
        -f|-format format [-nf|-noformat] ([-ch|-column_header] | 
        [-nch|-nocolumn_header]) [-sep|-separator separator]
        folder_template_spec...
ccm ft|folder_temp|folder_template -s|-sh|-show (i|info|information)
        folder_template_spec...
-ch|-column_header
Specifies to use a column header in the output format. See sc_r_h_unnumbered_fs.html#__wp819979 for details.
folder_template_spec
Specifies the folder template to show. See Folder template specification for details.
-f|-format format
Specifies the command output format. See sc_r_h_unnumbered_fs.html#__wp826148 for details.
-gby|-groupby groupformat
Specifies how to group the command output. See sc_r_h_unnumbered_fs.html#__wp819660 for details.
-nch|-nocolumn_header
Specifies not to use a column header in the output format. See sc_r_h_unnumbered_fs.html#__wp819979 for details.
-nf|-noformat
Specifies not to use column alignment. See sc_r_h_unnumbered_fs.html#__wp826095 for details.
-ns|-no_sort
Specifies that the command's output will not be sorted. See sc_r_h_unnumbered_fs.html#__wp819323 for details.
-sep|-separator separator
Specifies a different separator character. See sc_r_h_unnumbered_fs.html#__wp826071 for details.
-sby|-sortby sortspec
Specifies how to sort the command output. See sc_r_h_unnumbered_fs.html#__wp827516 for details.
-u|-unnumbered
Suppresses automatic numbering of the command's output (that is, the output is un-numbered). See sc_r_h_unnumbered_fs.html#__wp827924 for details.

Description and uses

About this task

Folder templates provide a pattern used to create folders. Folders created from a folder template are controlled by that folder template. Therefore, when you make changes to the folder template, the folders controlled by it are updated.

Folder template description

You can give a folder template any description, using any character, except the pipe (|) character. The folder template description can include these keywords in any combination: %owner, %release, %database. A description for a folder template does not have to include keywords. When the description of a folder template does not contain a keyword, all folders created from this folder template will have the same description.

Keyword %release

For example, if you create a folder template whose description is Completed Tasks for Release %release, the keyword %release is expanded to the release value of the projects that are using a process rule containing this folder template. The keyword %release is expanded when this folder template creates a folder. For instance, when a project with release 2.0 uses a process rule that contains a folder template whose description is Completed Tasks for Release %release, the folder created from this template and added to the update properties for the project will have a description of Completed Tasks for Release 2.0.

Keyword %owner

The %owner keyword expands to the owner of the project whose update properties contain folders created from a folder template. For example, if a project owned by jsmith with a release of 3.1 uses a process rule that contains a folder template with a description of %owner’s Completed Tasks for Release %release, a folder with a description of jsmith’s Completed Tasks for Release 3.1 is created from this folder template and added to the update properties for the project.

Keyword %database

The %database keyword expands to the DCM database identifier of the database where the project using the folder was created. For example, if a project owned by jsmith with a release of 3.1 is in a DCM database called Bristol, and is using a process rule that contains a folder template with a description of %owner’s Completed Tasks for Release %release from Database %database, a folder with a description of jsmith’s Completed Tasks for Release 3.1 from Database Bristol is created from this folder template and added to the update properties for the project.


Feedback