Multi Separator (Separation Provider)

STUB	This article is a stub. It contains minimal information on the topic and should be expanded.

The Multi Separator Separation Provider performs separation using multiple Separation Providers. It allows users to create a list of any of the other Separation Providers. If the first provider on the list fails to separate a page (or, as more often is the case, a series of pages), the next one will be applied. If that fails, the next, and so on.

The first Separation Provider should be considered the "main provider". The subsequent Separation Providers will only attempt to create a document folder if the main provider (or the providers before it) leaves the page as a loose page.

There are several Separation Providers that continue placing pages into a folder after a condition is met. Pattern-Based Separation is the most obvious. If the provider encounters a page with text that matches a regex pattern, it will create a document folder and continue placing subsequent pages into that folder until the pattern is matched again. Once pages are in a folder, none of the subsequent Separation Providers will attempt to execute for the already foldered pages (even if they would have qualified for separation if they were unfoldered).

Be advised, this provider has limited functionality as a practical matter. There are very few circumstances where this provider is used in the real-world. As a practical matter, most users who fall into a scenario where they need to separate using multiple providers will end up using multiple Separate steps to do so.