Uploaded image for project: 'Confluence'
  1. Confluence
  2. CONFLUENCE-188

Allow specifying ranges of Confluence objects to read

    XMLWordPrintable

Details

    • New Feature
    • Resolution: Fixed
    • Major
    • 9.35.0
    • 9.34.1
    • XML
    • None
    • Unknown

    Description

      Some use cases include not wanting to read / import all the supported Confluence objects from a package. Typically, restarting a migration from a given object.

      More generally, we may want to be able to import ranges of Confluence objects. These ranges are defined with two IDs (from, to) and whether each of these IDs are excluded.
      We add a input filter stream property, objectIdRanges that allows specifying such ranges described as follows:

      Ranges of Confluence objects to read. Can be used to restore an interrupted migration. Several comma-separated ranges can be given. Note that the order used for these ranges are not increasingly big ids, but in the order they are processed by the Confluence module. This order may change between versions of the parser, but is guaranteed to be the same between different runs using the same version of the Confluence module. Ranges must not overlap. Overlapping ranges are not supported, may lead to surprising results and their behavior is not guaranteed to be stable. In the same vain, ranges must be ordered in the parsing order.

      Examples:

      • [4242,] - only read object id 4242 and all the following ones;
      • (4242,] - same, but exclude object id 4242;
      • [,4242] - read all objects until object id 4242 included;
      • [,4242) - same, but exclude 4242;
      • [4242,2424], [3456,1234] - read objects between 4242 and 2424 both included, then ignore objects until 5656 and read objects between 5656 and 1234 both included (notice how IDs may look disordered).

      More examples of ranges and their meaning:

      • [2, 9] - from object id 2 to object id 9, both included
      • (8, 2] - from object id 8 excluded to object id 2 included
      • [8, 2) - from object id 8 included to object id 2 excluded
      • (8, 2) - objects between object id 8 and object id 2, both excluded
      • [2,] - object id 2 included and all the following objects
      • (4,] - all the objects following object id 4 excluded
      • [,6] - all the following objects until object 6 included
      • [,6) - all the following objects until object 6 excluded
      • [42] - object id 42
      • [] - everything.
      • [,] - everything.
      • (] - everything.
      • (,] - everything.
      • () - empty range.
      • (,) - empty range.
      • [) - empty range.
      • [,) - empty range.
      • (42] - empty range.
      • [42) - empty range.

      Attachments

        Activity

          People

            rjakse Raphaël Jakse
            rjakse Raphaël Jakse
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: