{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"The pagination is available in API from ","type":"text"},{"text":"2025-02-26","type":"text","marks":[{"type":"strong"}]},{"text":" and can be used in SDK from version ","type":"text"},{"text":"13.10.0","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The pagination can be enabled on selected API methods by explicitly specifying the ","type":"text"},{"text":"EnablePagination","type":"text","marks":[{"type":"code"}]},{"text":" property on the request object and setting it to value ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". There are two other optional properties. The first one is ","type":"text"},{"text":"PageSize","type":"text","marks":[{"type":"code"}]},{"text":", which defines the size of each page; the value has boundaries from 1 to 5000. A value outside of the boundary will fail the request. The second optional property is ","type":"text"},{"text":"PageIndex","type":"text","marks":[{"type":"code"}]},{"text":", which is used to iterate through pages. The valid value is from 0 to N. Whether another page is available can be determined by comparing the count of returned items with the page size. Whenever the page size and the number of returned items are the same, there is probably a subsequent page. The empty page will return an empty list of results.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The feature is backward compatible, which means the property ","type":"text"},{"text":"EnablePagination","type":"text","marks":[{"type":"code"}]},{"text":" must be set to true to request pagination explicitly. The existing code before the pagination feature remains unaffected.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The results of a paginated method are ordered by creation time in ascending order, from the oldest records to the newest. In this approach, a new entity will never interrupt the pagination and will be added as a new entity on the latest or a new page. Only the delete operation can shift entities toward the beginning of the enumeration. Creating a new entity is much more likely than deleting an existing one. Be aware of filters that can more likely affect the returned entities between pages.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"A delete operation can shift entities on a page, which may lead to skipping some entities. Additionally, filters can further complicate this issue, as any updated entities might be excluded between page requests.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Supported methods","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b6d1f210-6e81-4241-a8f9-35fac1bc10c7"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[216.0]},"content":[{"type":"paragraph","content":[{"text":"API method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[542.0]},"content":[{"type":"paragraph","content":[{"text":"SDK service and method","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[216.0]},"content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://bricknode.atlassian.net/wiki/spaces/API/pages/57639002"}},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[542.0]},"content":[{"type":"paragraph","content":[{"text":"IBfsLegalEntitiesService.GetLegalEntitiesInPagesAsync()","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/Bricknode/Bricknode.Soap.Sdk/blob/028d93dd7b4843ff2f2428bb7cdf07284657f134/Bricknode.Soap.Sdk/Services/IBfsLegalEntitiesService.cs#L26"}}]},{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[216.0]},"content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://bricknode.atlassian.net/wiki/spaces/API/pages/52002947"}},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[542.0]},"content":[{"type":"paragraph","content":[{"text":"IBfsAccountService.GetAccountsInPagesAsync()","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/Bricknode/Bricknode.Soap.Sdk/blob/028d93dd7b4843ff2f2428bb7cdf07284657f134/Bricknode.Soap.Sdk/Services/IBfsAccountService.cs#L35"}}]},{"text":" ","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[216.0]},"content":[{"type":"paragraph","content":[{"type":"inlineCard","attrs":{"url":"https://bricknode.atlassian.net/wiki/spaces/API/pages/58261553"}},{"text":" ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[542.0]},"content":[{"type":"paragraph","content":[{"text":"IBfsAssetService.GetInstrumentsInPagesAsync()","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/Bricknode/Bricknode.Soap.Sdk/blob/028d93dd7b4843ff2f2428bb7cdf07284657f134/Bricknode.Soap.Sdk/Services/IBfsAssetService.cs#L26"}}]},{"text":" ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"New properties on request","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"7b883863-7956-4385-9bd4-f6a8465a0bf1"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"Property","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.0]},"content":[{"type":"paragraph"}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[505.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"EnablePagination","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[505.0]},"content":[{"type":"paragraph","content":[{"text":"It must be set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" to request pagination. The default value is ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":". ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Pagination must be requested explicitly for backward compatibility; existing code remains unaffected.","type":"text"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"PageSize","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[505.0]},"content":[{"type":"paragraph","content":[{"text":"Defines the size of a page; the value has boundaries from 1 to 5000. Negative, zero, and values higher than 5000 are not allowed. The default value is 2000.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[171.0]},"content":[{"type":"paragraph","content":[{"text":"PageIndex","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[83.0]},"content":[{"type":"paragraph","content":[{"text":"optional","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[505.0]},"content":[{"type":"paragraph","content":[{"text":"Used to iterate through pages. The valid value is from 0 to N. Negative values are not allowed. The default value is 0.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example of usage by the SDK","type":"text"}]},{"type":"paragraph","content":[{"text":"The SDK uses ","type":"text"},{"text":"IAsyncEnumerable<>","type":"text","marks":[{"type":"code"}]},{"text":" interface to process the requests for each page asynchronously.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"var entitiesCount = 0;\nvar pageCount = 0;\nvar service = provider.GetRequiredService();\n\nawait foreach (var response in service.GetLegalEntitiesInPagesAsync(new GetPersonArgs()))\n{\n entitiesCount += response.Result.Length;\n pageCount++;\n\n foreach (var entity in response.Result)\n {\n ProcessEntity(entity);\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example of request content","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST {{hostName}}/api/bfsapi.asmx HTTP/1.1\nSOAPAction: \"http://tempuri.org/GetPersons\"\nContent-Type: text/xml; charset=utf-8\n\n\n\n \n \n \n \n {{userName}}\n {{password}}\n \n {{identify}}\n \n true\n true\n true\n true\n true\n true\n true\n \n true\n 0\n 1000\n \n \n \n","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported