用户帮助 > 在沙盒中管理您的个人工作区 > 获取沙盒快照
  
获取沙盒快照
CLI EQUIVALENT 
si snapshot
快照会抓取沙盒的当前状态,沙盒中的每个元素均可用 Windchill RV&S 服务器存储库中预先存在的实体进行标识。沙盒快照会创建您可根据其创建构建沙盒或开发路径的项目检查点。由快照创建的检查点的修订版本号包括上一检查点的修订版本号。例如,如果项目的上一检查点具有修订版本号 1.1,则由快照创建的检查点的修订版本号为 1.1.1.1。
要获取沙盒快照,请选择沙盒,然后选择“沙盒” > “快照”
在获取快照时,您可以为快照指定状态或标签,并将其应用于所有沙盒成员。标签是一个由您分配的唯一文本字符串,用于标识由快照创建的项目检查点。标签不能包含冒号 (:)、方括号 ([ ]) 或前导空格。此外,它们不能具有与有效检查点编号相同的格式。
在 GUI 中,默认情况下不显示非活动项目的检查点。如果您想要查看这些检查点,请选择“查看” > “显示非活动开发路径”
沙盒快照在“项目历史记录”视图中会显示为分支项目检查点。
* 
如果沙盒中缺少工作文件,则会显示一则警告,其中列出不会显示在快照中的缺失工作文件。如果要将这些工作文件包括在快照中,请取消该操作并提供工作文件(通过重新同步对应的成员),然后执行快照。
在 GUI 中,默认情况下不显示通过拍摄沙盒快照创建的修订版本。要查看这些检查点,请选择“查看” > “显示非活动开发路径”
沙盒快照的内容
在快照中抓取的沙盒元素集包括下列内容:
用存档标识的沙盒成员及该存档创建时所依据的工作修订版本
已删除但仍在沙盒中的前成员
由项目名称和类型标识的子沙盒
已删除但仍在沙盒中的前子沙盒
示例
已分配 Steve 来创建储蓄计算器的一次构建。他使用构建沙盒来执行本次构建。他发现其构建沙盒所基于的检查点中缺少自述文件。Jen 已在更改包中添加了该自述文件。Steve 使用更改包将该自述文件添加至其沙盒中,然后获取其沙盒的快照以保存配置。
重要考虑事项
要包括在快照中,您在沙盒中不能有工作文件更改。
如果工作文件修订版本不同于成员修订版本,则包括在快照中的会是工作文件修订版本。
无工作文件的成员不会包括在快照中。
在沙盒目录中仍有工作文件的前成员会作为成员显示在快照中。
仍在“沙盒”视图中的前子项目会作为子项目显示在快照中。
Windchill RV&S 始终会将成员工作文件的实际名称用于快照。
您不能获取稀疏沙盒的快照。
“快照沙盒”命令会针对整个沙盒执行,独立于用来显示沙盒内容的筛选器。
您可以比较快照创建的项目检查点与项目历史记录中其他项目检查点(包括快照创建的检查点)之间的差异,但不能比较与沙盒内容之间的差异。
要在获取快照时指定现有的开发路径,您必须使用 CLI。有关详细信息,请参阅 CLI 手册页
沙盒的成员需要与 Windchill RV&S 服务器中的对应存档进行关联。
在递归至沙盒中时,快照代表的目录结构和文件与沙盒完全相同。所有子项目元素会变成相同的类型,不同类型的共享子项目会变成相同类型的共享子项目。
在获取以递归方式包含子沙盒的沙盒快照时,该快照会根据主项目(如果有的话)的上一检查点为子沙盒创建检查点,而不是根据沙盒中的当前子项目创建检查点。成员修订版本不受影响。
在开发环境中使用沙盒快照
有关何时在开发环境中获取快照的建议方案如下:
1. 您目前所处的情形是您在常规沙盒中工作,但应在变型沙盒中工作。
2. 检入(或合并)您对分支所做的更改,而不是检入您对主开发路径所做的更改。
3. 获取沙盒的快照。
4. 通过与快照对应的项目检查点创建开发路径。
5. 通过所创建的开发路径创建变型沙盒,然后在该开发路径上继续工作。
* 
从 CLI 中,您可以在获取快照时指定现有的开发路径。有关详细信息,请参阅 CLI 手册页
在构建环境中使用沙盒快照
有关何时在构建环境中获取快照的建议方案如下:
1. 为项目创建检查点。
2. 为本次构建创建一个构建沙盒。
3. 虽然构建失败,但由于开发仍在继续,因此部分必需成员与上一检查点相比,其修订版本较新。
4. 重新同步必需修订版本以修复本次构建(您可以使用“重新同步更改包”)。
获取沙盒的快照,然后使用快照创建的项目检查点,以便在以后使用构建沙盒(而不是使用原始项目检查点)重新创建本次构建。