在工作文件中使用关键字

关键字是可插入基于文本的工作文件中的占位符。此占位符是一个用于表示工作文件中的文本信息的特殊变量（例如，$Date$、$Author$ 和 $State$）。在检出修订版本时可展开关键字（即由其文字值代替）。

要使用关键字，只需将其置于工作文件中的美元符号之间（例如，$Date$），然后将文件重新检入存档。

例如，Chad 要查看他正在文件中编辑备注的相关成员的信息。Chad 可以通过关键字执行此操作。他想使用 $Log$ 关键字。Chad 将首选项设置为在检出成员时启用关键字展开。然后在成员中插入关键字。

您的管理员可能会定义自定义关键字以供您使用。有关自定义关键字的信息，请与您的管理员联系。

如果已启用关键字，则下次您检出修订版本时，Windchill RV&S 会扫描关键字，然后将其替换为合适的信息。

关键字展开是指在检出或查看修订版本时，将信息自动添加或更新至关键字参考的流程。

例如，如果遇到 $Date$ 关键字，则会将修订版本的日期和时间（已在检入时分配）作为关键字的一部分添加至工作文件。展开时，条目会类似于

例如，如果成员 main.c 中包含关键字 $Author$ 和 $State$，则检出 main.c 并发出命令时会出现下列情况：

• “修订版本内容”视图（“成员” > “修订版本” > “查看内容”）

关键字展开在 GUI 中使用“首选项”进行配置。GUI 中的对话框可以覆盖默认设置。

• 管理员可以为 Windchill RV&S 设置策略，以忽略关键字。该策略将覆盖您的关键字设置。Windchill RV&S 不会告知您是否已为您的项目设置该策略。如果关键字不会展开或取消展开，但您需要它们执行此操作，请与您的管理员联系。

• 关键字展开仅适用于文本文件。在二进制文件中会禁用关键字。

关键字前后的文本会保留，使其适用于如上所述的表达式及备注。

如果已启用关键字展开，且您要检出的文本文件包含字符串

Windchill RV&S，在遇到此字符串时，会自动将关键字 $Revision$ 的值添加至格式中，

C 源文件中包括说明会创建名为 "revnum" 的字符串，其中包含文件的修订版本号。然后可以配置程序以在启动时显示此字符串，从而自动显示程序源文件的当前修订版本。

使用 $Revision$ 关键字获取文件的修订版本号是关键字的常见应用之一。其他常见应用包括：

• $Header$ 关键字会提供一行有关修订版本信息的摘要。在备注中包括此信息会使该信息对查看该成员的任何人可用。

• $Log$ 关键字会提供 $Header$ 的同类信息以及修订版本说明。$Log$ 关键字会提供一段时间内对成员所做更改的完整列表。

$<keyword>$ 的关键字格式会导致 Windchill RV&S 在第一个 $ 和下一个 $ 之间替换。如果使用 $<keyword> 格式的关键字，则 Windchill RV&S 会在遇到其他 $ 之前继续替换。在文件再次检出之前，Windchill RV&S 可能不会遇到其他 $。此类型关键字应用会返回与日志记录相似的结果。

如果想要关键字与修订版本中显示的完全一样，则将首选项设置为关闭关键字展开。

您可以在命令行界面中使用 ident 命令查找和显示一个或多个成员中的关键字（展开或取消展开）。有关 ident 命令的详细信息，请参阅 CLI 手册页。

此命令会显示包含关键字的每个成员的名称，以及关键字本身。这样可以提供一个简单的方法，从源文件以及编译对象文件中提取标识信息。