Return a collection of forms from ExtractForm and variants

[annelo-msft]

Consider whether this should be pageable

[annelo-msft]

@ctstone , @kristapratico , @samvaity, @jeremymeng , @mayurid, @bojunehsu

[bojunehsu]

Not quite sure how we can make this pageable if the API returns the full set of results at the same time.

[annelo-msft]

@bojunehsu Would you ever support processing so many forms/pages in a single input document at once that you would want to send back the results in difference pages?

[bojunehsu]

We recently bumped up the PDF page limit to 2000. I agree that it will be really nice to support streaming processing for such situations in the future. This would require significant changes to the REST API that APIM cannot easily support today.

That said, at the SDK interface level, it would be great if ExtractForm returns IEnumerable<> or equivalent instead of IList<> even if the underlying implementation today does not support paging. This is assuming it is just as easy for developers to use a paged result as a list result. (IEnumerable in .NET is good. Not sure what is the Python/Java/JS equivalent.)