Overview: Query Builder for Teamwork

如何

如何访问Comport的查询生成器

导航Metrics > Query Builder访问Comport的查询构建器。点击绿色+创造习惯Metric button and select your connected Teamwork Account from theD.ata Source下拉列表。

these steps

How to use the Query Builder for Teamwork

Teamwork的查询构建器是唯一的，因为它允许您使用查询构建器进行时间跟踪或用于任务的查询构建器。您的选择应依赖于您要构建的自定义指标。

IN THIS SECTION

查询构建器时间跟踪

一种

Custom Metric Name: Enter a name for your Custom Metric. This Custom Metric name will be available in the Designer after saving.

Metric：对于时间跟踪查询构建器，唯一的度量标准选项是“时间”

维度（可选）：尺寸参数根据公共条件重新分类返回的度量值（“时间”）。尺寸的示例是“公司名称”，“项目名称”和“已上薪时间”。

Pro Tip:在度量标准和维度之间添加“by”，以确定适当的自定义度量名称。从上面的度量标准和维度示例，我们可以通过项目名称“按项目名称”创建自定义度量标准“时间”。

D.ate Range：最多选择可用于自定义度量标准的8个日期范围。选择的日期范围是数据与此自定义度量标准同步的唯一时间段。

Compare With(Optional)：选择比较期，以测量每个日期范围，例如“上一段”。比较时段的数据将在所选的每个日期范围内同时同步。

此数据可以在线图表或条形图中使用以显示过去的性能。它还用于计算当前日期范围性能的百分比增长或损失VS比较日期范围性能。如果未选择与参数的比较，则无法为自定义度量显示比较百分比。

Filter by(Optional):Filters restrict the data that gets included in the Custom Metric. All data that is returned is tested against the Filter(s). Multiple Filters can be combined using AND boolean logic.

If the data synced from the Metric and Dimension fields meet the Filter specifications, the data is retained and included in the Custom Metric value. If the data synced from the Metric and Dimension fields don't meet the Filter specifications, the data is excluded from the Custom Metric value.

数据预览: After clicking运行查询，将显示自定义度量标准的数据预览。每日度量标准值显示在本节中，以及底部粗体中的日期范围的总度量值。您可以通过单击数据预览顶部的选项卡来查看不同日期范围的数据预览。

Pro Tip：如果您不知道用于使用案例的哪个过滤器，请使用Dimension + Data Preview进行故障排除，并更有深入了解每个字段的Teamwork帐户返回的数据。了解更多here。

查询构建器的任务

一种

Custom Metric Name: Enter a name for your Custom Metric. This Custom Metric name will be available in the Designer after saving.

Metric：对于任务的查询构建器，度量标准选项是“任务数”和“估计时间”

维度（可选）: The Dimensions parameter re-categorizes the returned Metric value based on common criteria. Examples of Dimensions are "Company Name," "Project Name," and "Status."

Pro Tip:在度量标准和维度之间添加“by”，以确定适当的自定义度量名称。从上面的度量标准和维度示例，我们可以创建自定义度量标准“由公司名称的任务数”，“按项目名称估计时间”或“按状态的任务数”。

D.ate Filter: The Date Filter determines which Tasks will be included in the Custom Metric.

If "Due Date" is selected, the截止日期选项字段将被揭示。在这里，您可以选择自定义度量标准中包含的截止日期。

如果您选择“完成日期”作为D.ate Filter，这D.ate Range字段将被揭示。在这里,你可以n select up to aa Date Range that will be available for the Custom Metric. The Date Range selected is the only periods of time that data is synced for this Custom Metric. Any Tasks completed during the specified Date Range(s) will be included in the Custom Metric.

将此自定义度量标准添加到DataBoard时，将突出和显示的数据仍将引用构建自定义度量时选择的日期范围，但唯一的日期范围选项将为“所有时间”。这是因为在团队合作中，您可以选择广泛的截止日期，或者您可能没有截止日期。

请求参数：选择您是否希望在自定义度量标准中包含已完成的任务，子组织等。

额外的过滤器：Filters restrict the data that gets included in the Custom Metric. All data that is returned is tested against the Filter(s). Multiple Filters can be combined using AND boolean logic.

数据预览：单击“运行查询”后，将显示自定义度量标准的数据预览。每日度量标准值显示在本节中，以及底部粗体中的日期范围的总度量值。您可以通过单击数据预览顶部的选项卡来查看不同日期范围的数据预览。

Pro Tip：如果您不知道使用哪个额外的过滤器为您的用例提供，请使用Dimension + Data Preview进行故障排除，并更有深入了解每个字段的Teamwork帐户返回的数据。了解更多here。

How to create a Custom Teamwork Metric [Example]

在此示例中，我们将创建自定义度量标准，以报告客户＃1的不完整任务，并在当前周设置为期日期。我们不希望在此自定义度量标准中包含任何已完成的任务。

导航Metrics > Query Builder

点击绿色+新查询button

Select the appropriate Teamwork Data Source

In order to accurately explain what this Custom Metric is reporting on, we'll name the Custom Metric " Incomplete Tasks by Company"

We want to report on Tasks so we'll select the任务button

For theMetric我们会选择Number of Tasks

We want a list of Task Names returned, so we'll select任务Name作为方面

Next, we'll selectD.ue Date作为D.ate Filter, andThis Week作为D.ate Range. This will make it so any Tasks with Due Dates set to this week will be returned for the Custom Metric

In the请求参数section, we need to exclude any completed tasks. To do this, we'll set the Attributes包括完成任务and包括已完成的子特写到错误的

10.

Lastly, we want to restrict the Custom Metric to only retain data for Client #1. We'll add a Filter to the额外的过滤器section that specifies公司名称等于客户1

11.

Click运行查询生成A.数据预览自定义度量

12.

一旦我们确认这些是我们正在寻找的结果，我们会点击Save到save the Custom Metric.

如何将自定义团队公制添加到Databoard

Learn how to add a Custom Metric to a Databoardhere。

一种dditional Information

When you add this Custom Metric built using the Query Builder for Tasks to a Databoard, the data synced and displayed will still reference the Date Range you selected when building the Custom Metric but the only Date Range option will be "All Time." This is because within Teamwork you can select a wide range of Due Dates, or you could have no Due Date set.