Rally .NET Rest API - 请求pagesize vs limit?

时间:2012-11-15 23:56:48

标签: .net rest rally

从Rally Web服务v1.39(使用.NET Rest API)撤回用户故事 - 我认为设置pagesize值实际上会限制结果集合中的记录数。然而,这似乎没有任何影响。设置限制值确实会影响结果数。

有人可以解释一下有什么区别以及为什么pagesize不能达到我的期望。

public static QueryResult GetProjectUserStories(string projectReference, int start)
{
    var restApi = GetApi();
    var pageSize = (Convert.ToInt32(WebConfigurationManager.AppSettings["RallyPageSize"]));

    var request = new Request("HierarchicalRequirement")
    {
         Fetch = new List<string>()
         {
              "Name",
              "Description",
              "FormattedID",
              "TaskEstimateTotal"
         },
         Query = new Query("Project.Name", Query.Operator.Equals, projectReference),
               PageSize = pageSize,
               Limit = pageSize,
               Start = start
         };


         var queryResult = restApi.Query(request);

         return queryResult;
}

我想也许这可能会被翻译成“FindAll”搜索 - 但为什么会有页面大小属性?

1 个答案:

答案 0 :(得分:2)

页面大小是每个响应中返回的结果数。 WSAPI允许此范围从1到200.当有超过200个结果时,它必须分成多页数据。限制是要返回的最大结果总数。

因此,如果您将页面大小设置为200并且限制为500并且有450个结果,则工具包将为您提出以下请求:

  1. PageSize = 200,Start = 1
  2. PageSize = 200,Start = 201
  3. PageSize = 50,Start = 401
  4. 总共450个结果。