Cm find 示例

在每个版本控制系统中，我们经常需要获取有关使用情况、正在更改哪些文件或只是搜索特定更改或特定分支的信息。

实现这一点的最佳方法是使用查询。因此，当我们创建 Plastic SCM 时，我们添加了名为 cm find 的非常强大的查询系统命令，该命令允许您获取涉及变更集、分支、标签、合并和代码审查的特定信息。

find 命令还可用于自定义 GUI 中的视图。

本文通过示例介绍了一些可以使用 cm find 命令处理的场景。这些只是您在 Plastic SCM 安装中可以执行的操作的一小部分。每个示例都包含一个问题、一个分步解决方案以及预期输出（以帮助您了解返回的信息类型）。

我们可以检索用户在某个时间跨度内创建的分支，然后我们可以按特定属性进行筛选。

我们开始检索所有可用的分支：

我们只想要我们的分支，所以我们按用户进行筛选：

按用户筛选后，我们现在只需要与此 sprint 相关的分支，因此我们正在寻找在特定日期之后创建的分支：

您可以使用格式化的输出：

最后，我们寻找一个特定的属性。根据我们的内部功能生命周期，每个分支在集成到 main 分支之前必须通过测试。

当分支通过测试时，“test”属性将设置为“passed”，因此，我们按属性名称和属性值进行筛选：

下表显示了当前可用于 cm find branch 命令的不同筛选选项：

* 条件 date 对应于分支视图中的创建日期列。

了解如何使用常量按日期进行筛选。

以下另一个表显示了当前可用于 cm find branch 命令的不同输出选项：

我们可以找到很多关于变更集的信息，注释只是其中之一。如需快速获取信息，我们可以使用 cm log 并执行我们自己的筛选（使用 shell 命令）或让 cm find 代劳。

在此示例中，我们将获取属于一个分支的所有变更集的日期和注释：

所以这里就是所有的变更集，现在我们要寻找“solution”这个词，在这里我们很容易就可以看到它，但是当我们有几百个变更集时，寻找过程将变得缓慢而无聊。为了按特定字词进行筛选，我们使用 SQL 语法 LIKE 和 % 执行近似搜索，因为我们不需要寻找完整的注释：

我们还可以使用以下命令按复制日期查询变更集（稍后我们将看到如何获取上次复制日期）：

returnparent 允许我们获取特定变更集或修订的父级。这样，如果我们想知道在此变更集之前发生了什么，我们可以进行简单的查询：

下表显示了当前可用于 cm find changeset 命令的不同筛选选项：

* 条件 changesetid、date 和 owner 分别对应于变更集视图中的名称、创建日期和创建者列。

了解如何使用常量按日期进行筛选。

以下另一个表显示了当前可用于 cm find changeset 命令的不同输出选项：

对于给定的分支，我们可以按时间顺序获取从相关时间开始以来的所有复制操作。

如果我们只想要最后一个日期，我们可以使用 Powershell 或 Bash 按日期筛选搜索，并选择最后一行。

Powershell：

Bash：

结果：

下表显示了当前可用于 cm find replicationlog 命令的不同筛选选项：

了解如何使用常量按日期进行筛选。

以下另一个表显示了当前可用于 cm find replicationlog 命令的不同输出选项：

我们可以获取所有的标签：

我们可以获取我们在某个分支中创建的所有标签：

在 codice 中，我们保留了一个用于开发的 main 分支和一个用于支持当前和旧版本的“Fix”分支，因此我们可能想找到哪个分支包含特定版本：

我们可以看到，标签 BL237 来自 main 分支。

我们可以获取标签日期，然后查询该时间跨度内在该分支中创建的变更集。获取两个（或更多）标签的信息非常简单：

下表显示了当前可用于 cm find label 命令的不同筛选选项：

* 条件 date 对应于标签视图中的创建日期列。

了解如何使用常量按日期进行筛选。

以下另一个表显示了当前可用于 cm find label 命令的不同输出选项：

这些属性可以无差别应用于分支、变更集和标签。我们首选需要对象 ID。为了获取 ID，我们可以在查询分支时指定 ID：

一旦我们有了 ID，我们就可以使用以下命令获取属性列表：

在本例中，属性名称是“status”，属性值是“Passed”。

我们可以使用一些 Powershell 脚本来组合这两条命令：

或使用 Bash 脚本：

输出将与之前相同：

通过运行以下查询也可以获得相同的输出：

假设我们为一些对象设置了一个特定的属性（在我们的示例中是测试的“status”）。无论包含属性的对象是什么，我们都可以查询这些属性。

下表显示了当前可用于 cm find attributes 命令的不同筛选选项：

* 条件 date 和 type 分别对应于属性视图中的创建日期和名称列。

了解如何使用常量按日期进行筛选。

以下另一个表显示了当前可用于 cm find attributes 命令的不同输出选项：

根据在前一个示例中检索到的特定变更集，我们现在可能想进一步了解包含更改的文件，为此我们可以使用 find revision。

我们指定自定义格式，因为我们只需要文件和文件夹路径：

我们还可以使用一些命令行帮助（Linux 上的 grep 和 Windows Powershell 上的 where）按文件夹进行筛选：

Powershell：

Bash：

然后，输出将如下所示：

我们还可以获取分支的修订信息，在其中搜索分支的所有更改。我们可以先获取一个分支和一个时间跨度的所有已更改项：

稍后我们可以使用我们最喜欢的 shell 工具（在我们的示例中为 Powershell）来筛选该信息。

如果您更喜欢 Bash，代码行如下：

期望的输出如下所示：

下表显示了当前可用于 cm find revisions 命令的不同筛选选项：

了解如何使用常量按日期进行筛选。

以下另一个表显示了当前可用于 cm find revisions 命令的不同输出选项：

合并呢？可以跟踪在特定分支或变更集之间完成的合并。

如果我们想知道一个分支集成在了什么地方，可以输入以下命令：

如果我们想知道具体的分支中集成了哪些分支，所需的命令如下：

先前的命令也可以使用我们的格式标志通过仅返回分支名称来自定义输出，例如，第二个命令将因此变成如下所示：

或：

请记住，find merge 返回所有类型的合并：常规合并、挑拣合并和减法合并。

因此，您可以向给定的分支进行间隔合并：

我们可以通过两个查询（find branches、find merge）和一些 Powershell 破解手段来回答这个问题。将以下代码放在 PS1 文件中并从 Powershell 控制台运行：

下面是一个示例输出：

此代码执行以下操作：

1. 查找这个 sprint 中的所有分支。
2. 查找这个 sprint 中的所有合并，并仅返回源分支。
3. 更改 $allbranches 输出的格式，使两个列表具有相同的格式。
4. 检查“merges”列表是否包含来自 allBranches 列表的分支。如果不包含，则没有集成该分支。

Bash shell 中的等效代码如下：

就其本身而言，这段代码会执行以下操作：

1. 查找属于这个 sprint 的每个分支。
2. 查找属于这个 sprint 的每个合并，仅返回它们的源分支。
3. 打印这个 sprint 中没有位于已合并分支列表中的所有分支。

我们正在寻找这种场景：

我们需要的分支符合以下条件：已经集成到另一个分支中（所以我们必须放弃合并到同一个分支中），但具有待集成的变更集（图片上的橙色变更集），没有问题，我们可以通过一个查询来完成，然后使用一些 Powershell 代码进行一些后期处理：

下面是一个示例输出：

此代码执行以下操作：

1. 获取所有合并以及在特定日期后完成的源变更集。
2. 筛选那些具有相同源和目标的合并。
3. 获取仅包含合并的列表，丢弃已完成的合并。
4. 更改 find branches 输出的格式，使其与 find merge 格式匹配。
5. 比较并筛选那些在该时间间隔内已合并但具有待合并变更集的分支。

如果使用的是 Bash，替代方案如下：

我们执行的操作如下：

1. 将特定日期之后执行的所有合并写入文件（指示源变更集）；同时，将所有源合并分支写入另一个文件。
2. 按分支名称和变更集迭代所有现有分支，只打印那些没有出现在第一个文件中（合并源分支和变更集）但出现在第二个文件中的分支（意味着具有待合并的变更集）。
3. 最后，删除临时文件。

我们正在寻找这种场景：

我们想知道在 1.0 版中直接或间接集成了哪些分支。和以前一样，我们只需要对服务器进行一次查询，并使用更多的一些 powershell 来筛选数据。在这个特定的示例中，我们希望获取已集成到 /main 中的所有分支。

以下是一个示例输出，我们可以看到分支 12299 间接集成到了 4.3.39.406 版中

该脚本的简要说明：

1. 我们像以前一样获取列表并删除重复项。
2. 我们使用目标分支、一个空的 visited 列表和一个将帮助我们显示深度的标记来调用 ListAll 函数。此函数的输出通过管道传递给 null，因为我们不会在我们的代码中使用这个值，否则它会显示。
3. 在 ListAll 函数中，我们尝试查找目标与目标窗口匹配的合并。
4. 如果匹配，我们会将相应的项添加到我们的 visited 列表中，然后我们递归调用 ListAll，这次包含我们的合并源。
5. 递归函数返回后，我们根据函数的返回值更新我们的 visited 列表。

在 Bash 下可以使用以下脚本实现相同效果：

这段脚本的简要说明：

1. 我们获取合并列表，删除重复条目，然后将其存储到文件中。
2. 我们准备两个辅助文件：
   1. old_targets，这将保存我们找到的每个目标分支
   2. targets，这将包含我们正在寻找来源的目标分支
3. 我们现在继续查看目标分支是否存在于列表文件中作为目标。如果是这样，我们将存储下一轮的合并源分支（如果之前没有受到影响）。此外，我们会将其打印在屏幕上。
4. 我们增加深度级别并切换目标列表：新的目标列表成为当前的目标列表，当前列表添加到“已使用”列表中。
5. 最后，只留下清理操作以使环境保持原样。

下表显示了当前可用于 cm find merge 命令的不同筛选选项：

了解如何使用常量按日期进行筛选。

以下另一个表显示了当前可用于 cm find merge 命令的不同输出选项：

集成的代码审查功能允许我们获取有关审查状态的信息。在此示例中，我们开始获取我的审查（也就是字面上分配给“我”的审查，其中“我”是指当前用户）。我们也可以像以前一样输入用户名。

随后，我们可以将结果范围限定为具有特定状态（1 = 已批准）的审查：

最后，我们获取在特定的时间范围内完成的审查：

所以我们想将该审查与特定时间跨度内符合以下特定条件的那些审查进行比较：

通过这两个查询，我们可以获得此 sprint 中已批准/所有审查的比率。

下表显示了当前可用于 cm find review 命令的不同筛选选项：

* 条件 date 和 targetid 分别对应于代码审查视图中的创建日期和已审查对象列。

了解如何使用常量按日期进行筛选。

以下另一个表显示了当前可用于 cm find review 命令的不同输出选项：

我们可以获取我的团队成员在去年创建的搁置：

下表显示了当前可用于 cm find shelve 命令的不同筛选选项：

了解如何使用常量按日期进行筛选。

以下另一个表显示了当前可用于 cm find shelve 命令的不同输出选项：

在本文中，我们已经介绍了如何自定义输出，但我们也可以将输出设置为 XML 并将其保存到文件中以供稍后分析。这样，以下命令：

生成以下 XML 内容：

<?xml version="1.0" encoding="utf-8" ?>
<PLASTICQUERY>
  <REVISION>
    <ID>426098</ID>
    <COMMENT></COMMENT>
    <DATE>07/06/2013 16:00:09</DATE>
    <OWNER>roberto</OWNER>
    <TYPE>dir</TYPE>
    <SIZE>0</SIZE>
    <CHANGESET>16716</CHANGESET>
    <PARENT>426069</PARENT>
    <ITEM>d:\linked_replicated\</ITEM>
    <ITEMID>2</ITEMID>
    <BRANCH>br:/main/Fix-4.1/scm12863</BRANCH>
    <PATH>d:\linked_replicated\</PATH>
    <REPOSITORY>codice</REPOSITORY>
    <REPNAME>codice</REPNAME>
    <REPSERVER>localhost:8087</REPSERVER>
    <HASH>kWJO1fm+7RCiZZcgSjM4/Q==</HASH>
  </REVISION>
  <REVISION>
    <ID>426092</ID>
    <COMMENT></COMMENT>
    <DATE>07/06/2013 16:00:09</DATE>
    <OWNER>roberto</OWNER>
    <TYPE>txt</TYPE>
    <SIZE>78238</SIZE>
    <CHANGESET>16716</CHANGESET>
    <PARENT>426056</PARENT>
    <ITEM>d:\linked_replicated\01nerva\src\client\plastic\ActionMenuManager.cs</ITEM>
    <ITEMID>37736</ITEMID>
    <BRANCH>br:/main/Fix-4.1/scm12863</BRANCH>
    <PATH>d:\linked_replicated\01nerva\src\client\plastic\ActionMenuManager.cs</PATH>
    <REPOSITORY>codice</REPOSITORY>
    <REPNAME>codice</REPNAME>
    <REPSERVER>localhost:8087</REPSERVER>
    <HASH>FXmLNV7B9Et1wTGqULWpgQ==</HASH>
  </REVISION>
</PLASTICQUERY>
  

此内容稍后可以导入到 Excel 等工具中，并轻松从中获取统计信息。

假设我们想要获取存储库中所有变更集的信息；然后我们可以执行以下命令：

然后，我们可以在 Excel 中加载输出；结果如下：

Excel 包含一个非常有用的实用程序，称为“数据透视表”，可让我们获取更多统计信息。

使用 Excel 中提供的筛选和排序功能，我们可以对变更集用户进行分组，并将这些统计信息转换为图表：

我们也可以按分支分组；通过按分支分组，我们可以了解有多少用户参与，每个用户在每个分支上创建了多少变更集。

find 命令针对每个对象都有一个默认输出，但我们可以定义我们先前看到的自定义输出选项，使用 XML 格式和 --xml 属性检索结果，以及使用 --file 属性将结果保存在文件中以供稍后分析。

一般语法如下：

其中：

• object 几乎可以是系统中的每个对象，具有分支、属性、变更集、标签、合并、审查、修订、用户等。
• conditions 取决于对象。您可以通过键入命令 cm showfindobjects 来获取条件（以及我们可以使用的所有对象）。
• on repositories 参数可用于从一个或多个存储库中获取信息，这些存储库可能与当前工作区匹配，也可能不匹配。我们可以转到任何文件夹（在我们的工作区中、另一个工作区中或没有工作区的文件夹中）并键入： cm find revisions "where branch = 'main/scm12800' on repositories 'codice@localhost:8087'" --nototal 423620 27/05/2013 13:25:53 dirRoberto d:\linked_replicated\#br:/main/scm12800#16582 423621 27/05/2013 13:25:53 dirRoberto d:\linked_replicated\01nerva#br:/main/scm12800#16582 423622 27/05/2013 13:25:53 dirRoberto d:\linked_replicated\01nerva\src#br:/main/scm12800#16582

  只要我们有权查询该存储库，这就会起作用。

  您不仅可以从不同的存储库，还可以从不同的服务器一起进行查询。例如

  cm find "changesets where date >= '2017/11/17' on repositories 'documentation/plasticdocu@localhost:8087','codice@codice@cloud'" --nototal 68621 1451 /main/scm21135 11/20/2017 3:32:31 PM maria documentation/plasticdocu Added documentation about the EOL conversion mechanism. 4821759 132324 /main/SCM21120 11/20/2017 1:41:45 PM pablo codice Added missing config file 4821840 132326 /main/scm21149/scm21150 11/20/2017 1:54:35 PM vsanchezm@codicesoftware.com codice Fix HAL FAILED - Conflicts and user intervention required. Rebase from main. 4821941 132333 /main 11/20/2017 2:38:28 PM hal codice HAL: merged /main/scm21076/scm21084/scm21093 : GTK Gluon: add pending changes view
• options 允许我们指定我们先前看到的输出选项（--format、--xml 或 --file）。

在按日期进行筛选时，可以使用遵循机器本地化设置的日期格式。例如，如果计算机以“MM-dd-yyyy”格式显示日期，则可以在查询中使用“12-31-2019”之类的日期。

还可以使用以下常量来简化查询：

• 'today'：今天的日期。
• yesterday'：昨天的日期。
• this week'：本周星期一的日期。
• this month'：本月第一天的日期。
• this year'：本年 1 月 1 日。
• one day ago'：当前日期前一天。
• one week ago'：当前日期前七天。
• one month ago'：当前日期前一个月。
• n days ago'：当前日期前“n”天。
• n months ago'：当前日期前“n”个月。
• n years ago'：当前日期前“n”年。

以下 where 子句对于类型为 date 的字段有效：

• (...) where date > 'today' (...)
• (...) where date < 'yesterday' (...)
• (...) where date > 'this week' (...)
• (...) where date > 'this month' (...)
• (...) where date < 'one day ago' and date > '3 days ago' (...)
• (...) where date < 'one week ago' and date > '3 weeks ago' (...)
• (...) where date < 'one month ago' and date > '3 months ago' (...)
• (...) where date > '1 year ago' (...)

2019 年 12 月 10 日

• 我们通过添加缺失的双引号修复了一些 cm find 示例。

2018 年 12 月 7 日

• 我们添加了一些新示例。
• 了解如何查找搁置。
• 按日期筛选时可以使用日期常量。

2017 年 11 月 20 日

• 了解如何使用 on repositories 参数从一个或多个存储库进行查询。

2014 年 7 月 1 日

• 发布日期。