What's New
This section provides an overview of what's new in the latest version of the Ed-Fi API Publisher. For the complete list of changes, see Release Notes.
Updates in API Publisher v1.4 (Latest Release)
.NET 10
The API Publisher now runs on .NET 10, the current long-term support release of
.NET. Install the
.NET 10 runtime
before upgrading a deployment that uses the portable EdFi.ApiPublisher
package. The Windows package includes the runtime, and the Docker image is
built on .NET 10.
Ed-Fi API v8 Support
The API Publisher can now publish from and to Ed-Fi API v8, in any combination with the Ed-Fi ODS/API: from an ODS/API to Ed-Fi API v8, from Ed-Fi API v8 to an ODS/API, and between two Ed-Fi API v8 instances. Support is validated against Ed-Fi API v8.0.
The publisher reads each API's Discovery document to find where it serves its resources and its token endpoint, so a connection needs only the API's base URL, key and secret. See:
- Ed-Fi API v8 for the claim sets, the API client setup and the prerequisites of a target.
- Known Issues Details for the rate limit of an Ed-Fi API v8.0 target and the snapshot and paging behavior of an Ed-Fi API v8.0 source.
Cursor Paging
When the source is an Ed-Fi ODS/API 7.3 or later, the publisher reads each resource with partitioned cursor paging instead of offset paging. Each resource is split into partitions that are read in parallel, and reading a page does not get slower the deeper it is in the resource, which shortens publishing for large resources. Other sources, including Ed-Fi API v8.0, are read with offset paging as before.
Cursor paging is on by default. A run that fails partway can be continued with
--resumeLastRun=true instead of starting again. Use
--disableCursorPaging=true to return to offset paging. See
API Publisher Configuration for the
related options.