ImportSummary

Totals across every series in the file, for a one-line summary.

booksAmbiguousinteger<int32>required

Possible values: >= 0

booksHashMismatchinteger<int32>required

Possible values: >= 0

booksInSelectedLibraries(integer | null)<int32>nullable

Live books in the scoped libraries. None when not scoped.

Possible values: >= 0

booksInUnmatchedSeriesinteger<int32>required

Books counted in books_unmatched only because their whole series did not match.

books_unmatched mixes two outcomes. In a scoped import these are books belonging to other libraries, which is expected. The remainder, books_unmatched - books_in_unmatched_series, are books missed inside a series that did match, which is worth a reader's attention and must not be hidden under the reassuring label.

Possible values: >= 0

booksMatchedinteger<int32>required

Possible values: >= 0

booksMatchedDistinctinteger<int32>required

Distinct destination books matched, for the same reason.

Possible values: >= 0

booksStemMatchedinteger<int32>required

Possible values: >= 0

booksTotalinteger<int32>required

Possible values: >= 0

booksUnmatchedinteger<int32>required

Possible values: >= 0

completionsInsertedinteger<int32>required

Possible values: >= 0

completionsReattachedinteger<int32>required

Possible values: >= 0

progressWritteninteger<int32>required

Possible values: >= 0

ratingsWritteninteger<int32>required

Possible values: >= 0

rowsStrandedinteger<int32>required

Rows left behind on a live book in another library. Non-zero means the import moved less than it appears to have.

Possible values: >= 0

seriesAmbiguousinteger<int32>required

Possible values: >= 0

seriesCommittedinteger<int32>required

Possible values: >= 0

seriesInSelectedLibraries(integer | null)<int32>nullable

Live series in the libraries the import was scoped to. None when the import was not scoped: the denominator would then be every series the reader can see, which measures nothing.

With this set, a file series that did not match is almost always one that belongs to another library, which is expected when a split imports into one of several new libraries, not a matching failure.

Possible values: >= 0

seriesMatchedinteger<int32>required

Possible values: >= 0

seriesMatchedDistinctinteger<int32>required

Distinct destination series that at least one file series resolved to.

series_matched counts file series, and two of those can resolve to one destination series by name, so it can exceed what the destination holds. Coverage of the destination has to count this instead.

Possible values: >= 0

seriesTotalinteger<int32>required

Possible values: >= 0

seriesUnmatchedinteger<int32>required

Possible values: >= 0

sessionsInsertedinteger<int32>required

Possible values: >= 0

sessionsReattachedinteger<int32>required

Possible values: >= 0

wantToReadRestoredinteger<int32>required

Queue entries put back into want-to-read.

Possible values: >= 0

ImportSummary

{
  "booksAmbiguous": 0,
  "booksHashMismatch": 0,
  "booksInSelectedLibraries": 0,
  "booksInUnmatchedSeries": 0,
  "booksMatched": 0,
  "booksMatchedDistinct": 0,
  "booksStemMatched": 0,
  "booksTotal": 0,
  "booksUnmatched": 0,
  "completionsInserted": 0,
  "completionsReattached": 0,
  "progressWritten": 0,
  "ratingsWritten": 0,
  "rowsStranded": 0,
  "seriesAmbiguous": 0,
  "seriesCommitted": 0,
  "seriesInSelectedLibraries": 0,
  "seriesMatched": 0,
  "seriesMatchedDistinct": 0,
  "seriesTotal": 0,
  "seriesUnmatched": 0,
  "sessionsInserted": 0,
  "sessionsReattached": 0,
  "wantToReadRestored": 0
}