文件规范

文件规范或 file_spec 是指 IBM® Rational® Synergy 数据库中的一个或多个项目。 您可以将文件规范(项目、目录或文件)设置为以下任何全局格式:

对象名最多可以包含 155 个字符。 对象版本最多可以包含 32 个字符。

工作区引用格式

如果某个对象版本是项目的成员,而项目在文件系统中工作区目录下同步,那么您可以通过对象版本在项目目录结构中的路径来引用对象版本。

这里的示例采用 Windows 路径。 功能与 UNIX 上完全相同。 例如,如果对象版本 main.c-4dir1 目录下项目 jobA-1 的成员,而项目工作区为 c:\users\joe\ccm_tutorial,那么 main.c-4 的工作区引用如下所示:

c:\users\joe\ccm_tutorial\jobA-1\jobA\dir1\main.c
如果当前工作目录为 c:\users\joe\ccm_tutorial\jobA-1\jobA,那么您可以使用相对路径引用对象版本 main.c-4
dir1\main.c

您可以扩充该版本的工作区引用,以引用对象的另一个版本:

  • path\object_name[:version]
  • path\object_name[version_delimiter version]

使用此文件文件规范来引用该对象版本的任何其他版本。

例如,如果 main.c-4 是当前项目的成员,而且包含先行作业 main.c-3,那么您可以通过使用所属于 main.c-4 的相对路径来引用先行作业:

dir1\main.c-3

注: 如果启用 allow_delimiter_in_name 并使用包含 version_delimiter 的第二种格式,则包含版本定界符的完整字段将用作名称,而该版本将成为项目中使用的当前版本。 例如,如果采用版本定界符 -,那么规范 c:\users\joe\ccm_tutorial\jobA-1\jobA\dir1\main.c-23 见获取 main.c-23 的名称。 该名称表示工作区中所使用对象的当前版本。 如果通过指定在路径和名称后使用 :version 格式的任何明确版本来使用 allow_delimiter_in_name,则需要避免可能存在的混淆。

项目引用格式

项目引用格式通过特定项目中的相对路径来引用项目、目录或文件。即使项目不包含已维护的工作区或如果工作区对客户不可视,也可以使用这种格式。 您可以采用以下格式:

  • relative_path@project_spec
  • relative_path:version@project_spec
  • relative_path version_delimiter version@project_spec

其中 relative_path 是使用正斜杠 (/) 或反斜杠 (\) 作为文件分隔符的相对路径,project_spec项目规范version_delimiter 是当前版本定界符(缺省为连字符 -),而 version 是可选的项目版本。如果不指定版本,那么引用的对象是项目中使用的版本。

相对路径相对于项目顶部。 例如,规范 myproject\src\ClientContext.java@myproject:1 是指项目 myproject:1 根目录 myprojectsrc 目录中文件 ClientContext.java 的当前版本。

您可以在相对路径后面指定可选参数。例如,规范 myproject\src\ClientContext.java:23@myproject:1 表示项目 myproject:1 根目录 myproject 下的 src目录中文件 ClientContext.java 的版本 23

注: 如果启用 allow_delimiter_in_name 并使用包含 version_delimiter 的最后一种格式,那么包含版本定界符的完整字段将用作名称,而该版本将称为项目中使用的当前版本。 例如,如果采用版本定界符 -,则那么规范 myproject\src\ClientContext.java-23@myproject:1 将获取名称 ClientContext.java-23。 该名称表示项目中所使用对象的当前版本。 如果通过指定在路径和名称后使用 :version 格式的任何明确版本来使用 allow_delimiter_in_name,则需要避免可能存在的混淆。

反馈