Version: 10.10.0
Release: Titlis
Release date: June 5th, 2021
Release Notes: picturepark.com/previewrelease

Breaking changes

Feature

Endpoint/Contract

Title

Description

Reference

Content permission sets

ContentRight

New content right ManageHistoricVersions added

  • The new content right gives a user rights to view, delete and download previous versions of a content file.

  • It was added between EditContent and ManagePermissions.

  • All the permission sets with user roles with ManagePermissions right therefore have to have ManageHistoricVersions too.

  • The integer values of the content rights are not in sequence anymore with ManageHistoricVersions having value of 7.

See Contacts.Generated.cs

User

UserRight

New user rights ReadStatisticsWriteStatistics and ExportStatistics added

  • The new user rights give a user rights to read, write and export statistics.

  • For reading, a user requires to have ContentRight.ViewContentRight.EditMetadata is required for write operations.

  • Existing User roles which have UserRight.ManageContent were automatically assigned the new rights ReadStatistics and ExportStatistics.

See Contacts.Generated.cs

Transfer

Upload

Limitation on maximum number of chunks

  • The maximum number of chunks per file is now limited to 2048.

  • To upload larger files, either use streaming (application/octet-stream) uploads with one chunk only or make chunk size adaptive.

  • I.e. to upload a file of size 20GB, the minimum chunk size is 10MB (10MB * 2048 = 20GB).

-

Deprecation

Might be removed in the next version of CP.

None.

Removed

none

Features

Feature

Endpoint/Contract

Title

Description

Reference

Customer

CustomerInfo and LicenseInfo

New LicenseInformation attribute and LicenseInfo contract added

New LicenseInformation attribute containing information about historic versioning state was added to CustomerInfo

See Contracts.Generated.cs

Content

ContentResolveBehavior

New content resolve behavior HistoricVersionCount added

Eponymous ContentDetail attribute will be filled in if this behavior will be used.

See ShouldResolveHistoricVersionCount test in ContentTests.cs

Content

ContentDetail

Attribute HistoricVersionCount added

  • The attribute contains the number of historic versions of the content if requested by using the eponymous resolve behavior when getting content details.

  • The value can be null if the resolve behavior was not used or the user doesn't have permissions to view historic versions or versioning is disabled.

See ShouldResolveHistoricVersionCount test in ContentTests.cs

Content

HistoricVersion

Historic version contract

Contract represending a historic version of a content.

See Contracts.Generated.cs

Content

/content/{id}/versions (GetVersions) endpoint
HistoricVersionSearchRequest and HistoricVersionSearchResult contracts

Get versions endpoint added

Endpoint allowing for listing of historic versions of the content.

See ShouldListHistoricVersions in ContentTests.cs

Content

/content/{id}/versions/{versionId}/file (CreateVersionDownloadLink)

Endpoint to get version download link added

Generates a download link to download the original output for the specific version ID.

See ShouldGetDownloadLinkForHistoricVersions in ContentTests.cs

Content

/content/{id}/versions/{versionId} (DeleteVersion)

Endpoint to delete a historic version added

Endpoint will delete a specific historic version. NB: A last version cannot be deleted if it was generated by XMP writeback.

See ShouldDeleteHistoricVersion in ContentTests.cs

User

UserReviewRequest and UserReviewManyRequest in /users/{id}/review and /users/many/review

New SuppressEmail property added

When set to true, an email notification will not be sent to the users when they are reviewed.

See Contracts.Generated.cs

Customer

CustomerInfo and LicenseInfo

New LicenseInformation attribute and LicenseInfo contract added

New LicenseInformation attribute containing information about content statistics state was added to CustomerInfo.

See Contracts.Generated.cs

Statistics

ExportContentStatisticsRequest
/statistics/contents/export (ExportContentStatistics)

Endpoint and contract added

Allows export of content-specific statistical data.

  • Endpoint triggers export for aggregated content usage information based on supplied filter criteria.

  • Export can be downloaded after completion of BusinessProcess (see next change).

  • Data is provided as a CSV file.

See Contracts.Generated.cs or StatisticsTests.cs for samples

Statistics

/statistics/downloadLink/{referenceId} (ResolveDownloadLink)

Endpoint added

Resolves download url based on successful export.

  • Use ReferenceId of export BusinessProcess.

  • Resulting CSV file contains timestamp, contentId, contentName (optional), apiClient (optional) and recorded usage information.

  • Presence of contentName column depends on ExportContentStatisticsRequest.IncludeContentNames.

  • Presence of apiClient column depends on ExportContentStatisticsRequest.AggregateApiClients.

See Contracts.Generated.cs or StatisticsTests.cs for samples

Statistics

AddContentEventsRequest
/statistics/contents/events (AddContentEvents)

Endpoint and contract added

Allows storage of externally recorded/archived content usage events in aggregated form.

  • Add external or historic events as AddContentEventsRequestItem.

  • Supplied information will internally be aggregated.

See Contracts.Generated.cs or StatisticsTests.cs for samples