Deprecated functionality
The following information describes functionality that has been deprecated in Relativity:
Relativity TBD - TBD, 2022
The following functionality is scheduled for deprecation or has been deprecated.
Imaging API
The Imaging API contains several methods that have been deprecated and replaced with new functionality. The following table lists these methods and their replacements. For more information, see Imaging (.NET).
| Interfaces | Deprecated methods | New methods |
|---|---|---|
| IImagingProfileManager | SaveAsync() |
|
| IImagingSetManager | SaveAsync() |
|
| IApplicationFieldCodeManager | SaveAsync() |
|
Due to the versioning of the Imaging API, all of the endpoints have been updated with a new format that includes versioning information and other changes. For examples of the new URL formats, see Imaging API (REST).
Note: Although the legacy Imaging API continues to be supported in the Osier release, we recommend that you implement any new functionality with the versioned Imaging API. See Imaging (.NET) and Imaging API (REST).
Instance Setting Manager API
In the Instance Setting Manager API, the method signatures on the IInstanceSettingManager interface have been deprecated. They no longer require a workspace ID set to -1 to indicate the admin-level context.
The following table lists the deprecated method signatures and their replacements. For more information, see Instance Setting Manager (.NET).
Invariant API
The Invariant API is now private and no longer available for use in custom applications. You can continue to customize applications using the Processing APIs. For more information, see Processing.
Keyboard Shortcuts Manager API
In the Keyboard Shortcuts Manager API, the overloaded GetKeyboardShortcuts() method has been deprecated. It has been replaced with the new ReadAsync() method on the IKeyboardShortcutsManager interface in the Relativity.Review.Server.Versioned.<VersionNumber>.KeyboardShortcuts namespace. For more information, see Keyboard Shortcuts Manager (.NET).
The legacy endpoint for retrieving keyboard shortcuts through REST has also been deprecated. A new URL for this functionality is now available. For more information, see Keyboard Shortcuts Manager (REST).
Password Bank API
The Password Bank API is now deprecated in RelativityOne.
Tab Manager API
The Tab Manager API contains several methods that have been renamed or deprecated. The following table lists these methods and their replacements. For more information, see Tab Manager (.NET).
| Interface | Deprecated methods | New methods |
|---|---|---|
| ITabManager | GetAvailableObjectTypesAsync() | GetEligibleObjectTypesAsync() |
| ITabManager | GetAvailableParentsAsync() | GetEligibleParentTabsAsync() |
| ITabManager | GetDependencyList() | GetDependencyListAsync() on the Object Manager API |
Due to the versioning of the Tab Manager API, all of the endpoints have been updated with a new format that includes versioning information and the changes in the previous table. For examples of the new URL formats, see Tab Manager (REST).
Relativity TBD - TBD, 2022
The following functionality is scheduled for deprecation or has been deprecated.
HTTP headers content types
The HTTP header Content-Type field no longer can be set to application/json;charset/utf-8, or text/json.
Relativity TBD - TBD, 2020
The following functionality is scheduled for deprecation or has been deprecated.
Platform Status tab
The Platform Status tab has been deprecated in the RelativityOne Mayapple release.
Relativity Server 2021 - TBD, 2020
Relativity Server 2021 - TBD, 2020
The following functionality is scheduled for deprecation or has been deprecated.
Application Install API
Application Install API includes the following deprecated features:
- ConflictCorrelationID - The conflict correlation ID is no longer required when submitting resolutions. It has been removed to clean up the contract.
- Options - Use the new ResolutionOptions property instead.
- RenameField - Use the Rename enumeration value instead.
- ArtifactStatus - The ApplicationInstallDetail.ArtifactStatus property has been replaced with ApplicationInstallDetail.Message.
- ResolutionType - The ResolutionType property has been removed.
- GetAllInstallStatusAsync - endpoint has been removed.
Relativity Integration Points API
Relativity Integration Points includes the following deprecated features:
- JQuery version - jQuery v 3.3.1 has been deprecated and replaced with jQuery v3.4.1. The Relativity Integration Points SDK Server 2021 has been updated with this new jQuery library.
- Renamed namespaces - The namespaces for the Integration Points API have been renamed as follows:
New namespace name Deprecated namespace name Relativity.IntegrationPoints.Contracts kCura.IntegrationPoints.Contracts Relativity.IntegrationPoints.Services.Interfaces.Private kCura.IntegrationPoints.Services.Interfaces.Private Relativity.IntegrationPoints.SourceProviderInstaller kCura.IntegrationPoints.SourceProviderInstaller
Note: For compatibility with
Relativity 10.x.xxx.x - TBD, 2020
The following functionality is scheduled for deprecation or has been deprecated.
Object Query Manager API
The Object Query Manager API has been deprecated in the Indigo release. Use the query functionality available through the Object Manager API in your custom code. For more information, see Object Manager (.NET) and Object Manager (REST).
Note: Upgrade any existing custom applications calling this Object Query Manager API to ensure they continue to function properly.
Migrating to the Object Manager API
You can find detailed steps for migrating your custom code using the Object Manager API in Migrating code to the Object Manager API.
Relativity 10.3.287.3 - January 20, 2020
The following functionality is scheduled for deprecation or has been deprecated.
APIs scheduled for deprecation
The View Fields Manager API is scheduled for deprecation in the Relativity Indigo release coming in January 2020:
The View Fields Manager APIs will be removed from the Relativity assemblies. The related documentation will no longer be available in the RelativityOne and Relativity Server Developers sites for the Indigo and higher releases.
Note: Prior to the Indigo release, upgrade any existing custom applications calling this API to ensure they continue to function properly. Consider using similar functionality exposed through the Object Manager API. For more information, see Object Manager (.NET) and Object Manager (REST).
Import API
The following list includes deprecated features and functionality in the Import API:
- Import API SDK removed from Relativity SDK MSI - Beginning with the Relativity Goatsbeard release, the Import API is no longer part of the Relativity Services SDK published in the Community. The Import API SDK is available only as a NuGet package called Relativity.DataExchange.Client.SDK. For more information, Get started with the Import API or Import API migration.
- Deprecated the Relativity.Import.Client NuGet package - Beginning with the Relativity Goatsbeard release, the new NuGet package called Relativity.DataExchange.Client.SDK replaces this legacy Relativity.Import.Client NuGet package. For more information, Get started with the Import API or Import API migration.
Note: You must migrate to the Relativity.DataExchange.Client.SDK package to ensure that your custom applications continue to function properly. If you don't migrate your applications to the new package, they will fail.
- RelativityVersionMismatchException - This exception is now deprecated. In previous versions, it was thrown from the ImportAPI class constructor when the .NET assembly for the Import API didn’t match the Relativity version.
As of the Goatsbeard release, the new RelativityNotSupportedException replaces the RelativityVersionMismatchException. For more information, see Import API migration.
- Deprecated Import API dependencies on kCura.dll and Relativity.dll assemblies - Because the Import API is decoupled from Relativity core, it no longer has dependencies on the kCura.dll and Relativity.dll assemblies. If your Import API application uses objects from the kCura.dll or Relativity.dll assemblies, add a reference to the Relativity.Other package to continue using these components. For more information, see Import API migration.
- Deprecated kCura.OI.FileID assembly - This assembly is no longer supported for file type identification purposes. You must now use the File Identification API in the Relativity.DataExchange.Io API namespace.
Object Query Manager API
The Object Query Manager API is scheduled for deprecation in the Relativity Indigo release coming in January 2020.
Note: Prior to the Indigo release, upgrade any existing custom applications calling this API to ensure that they continue to function properly. Use the query functionality exposed through the Object Manager API. For more information, see Object Manager (.NET) and Object Manager (REST).
Migrating to the Object Manager API
You can find detailed steps for migrating your custom code using the Object Manager API in Migrating code to the Object Manager API.
Relativity 10.2.270.1 - TBD
The following functionality has been deprecated.
Production API
In the Production API, the signature for the CancelJobAsync() method has been updated. The legacy signature of CancelJobAsync(int workspaceArtifactID, int productionArtifactID) is now deprecated. Use the updated CancelJobAsync(ProductionJobRef jobRef) method for any new applications that you want to implement, and for upgrading any existing applications. For more information, see Production Manager (.NET).
Note: The name of the REST endpoint remains CancelJobAsync. However, the format for the JSON request has been updated. For more information, see Production Manager (REST).
