# GraphqlQuery 任务

这是一个调用服务器提供的 GraphQL 查询 API 的任务。在编写查询时，可以通过两种方式处理变量，建议使用方法 2。

方法 1：您可以使用来自情境上下文的变量，例如数据和变量，包括[脚本内部变量](../concept/script-internal-variables.md)。此方法适用于应用字符串变量。

```graphql
query {
  fetchWorkOrderHistory(fromDate: "${this.variables.fromDate}", toDate: "${this.variables.toDate}") {
    ...
  }

  searchObjectWithTag(tag: "${this.data.tag}") {
    ...
  }
}
```

方法 2：指定要在 `variables` 中使用的变量，并使用 GraphQL 变量处理方法。`variables` 的值可以指定为情境上下文中数据的访问器。此方法适用于应用对象类型变量。

```graphql
query($filters: [Filter!], $sortings: [Sorting!], $pagination: Pagination, tag: String!) {
  boards(filters: $filters, sortings: $sortings, pagination: $pagination) {
    ...
  }

  searchObjectWithTag(tag: $tag) {
    ...
  }
}
```
