Adding Folders to the StarFlow Extensions Project

If you plan to use different APEs and/or different workflows for different projects and/or views in a given server configuration, you need to place those workflows and APE files in different places within the StarFlow Extensions project.

  • If you store workflow and APE files in the Projects folder, they can be used by all projects on the server unless overridden by files at a lower level.
  • If you create a myproject folder under Projects, all workflow and APE files stored within this folder are used for the project named myproject that reside in the same server configuration as the StarFlow Extensions project.
  • If you create a myview folder under myproject, the workflow and APE files stored within it are used in the myview view for the specified project.

The files that must be checked in to the Projects folder or an appropriate subfolder in the StarFlow Extensions project are name.jar, name.propertyeditor.xml and item_type.Workflow.xml.

If projects and views will use different APEs and/or workflows, then you need to add folders to the StarFlow Extensions project. After you create the folders that you need, you will add workflows and APE files to those folders.

  • Use the Projects folder for workflows and APEs to be used as the default for all projects and views.
  • Use a folder with the name of a specific project to store workflows and APEs to be used by the views in that project—unless a folder and files exists for a specific view.
  • Use a folder with the name of a specific view, such as Beta Release, to store workflows and APEs to be used by that specific view.

The client uses the folder hierarchy to search for resources in all folders. If it does not locate the files it needs, an error message is displayed.

To add a folder to a view using StarTeam Cross-Platform Client:

  1. Right click the Folder tree and select New.

    The New Folder Wizard dialog box appears.

  2. Select a folder from the folder tree to be the parent of the new folder.
  3. Click Next.
    The New Folder Wizard: Folder Name dialog appears.
  4. Enter a name for the child folder in the Folder Name text box. Use a maximum of 254 characters.
  5. Leave the Working Folder field blank. The application creates the working folder using the name of the new folder and the path to its parent’s working folder.
  6. In the Folder Description field, enter a description of up to 254 characters for the new folder.
  7. Click Next. The New Folder Wizard: Child Folders dialog displays the new folder in the New Folder’s Child Folders box. If the working folder has child folders, an application folder is added for each of them.
  8. Do one of the following:
    • To exclude a child folder from your project, select the folder and click Exclude.
    • To exclude all child folders, click Exclude All. To redisplay folders you have excluded, click Reset Folders.
  9. Click Next.

    The New Folder Wizard: StarTeam Folders dialog box displays the view’s folder tree with the new child folder.

  10. Click Finish.
Parent topic: Creating and Configuring the StarFlow Extensions Project