EIDR 2.0 SDK Release Notes
1
Introduction..............................................................................................................................................1
2
System Requirements ...............................................................................................................................1
3
API Changes ..............................................................................................................................................1
Previously deprecated functions ................................................................................................................... 1
Party Functions .............................................................................................................................................. 2
4
Miscellaneous Changes .............................................................................................................................2
Schema Changes ............................................................................................................................................ 2
New Tools ...................................................................................................................................................... 3
Version String................................................................................................................................................. 3
5
New Documentation .................................................................................................................................3
1
Introduction
2
System Requirements
These release notes apply to EIDR SDK 2.0 running against Registry version 2.0. For more details on
Registry features, please consult the EIDR 2.0 Release Notes and the EIDR 2.0 Data Fields Reference.
The EIDR SDK and Tools for Java requires Java 6 or higher.
The EIDR SDK and Tools for .NET requires .NET 4.0 Framework Extended or 4.5. The client .NET
Framework will be upgraded to 4.0 if needed.
3
API Changes
Previously deprecated functions
All functions/classes deprecated in 1.2 have been removed.
Proxy support
The java proxy support can be invoked by setting the proxy tags in the eidr-config.xml file. See example
eidr-config.xml file for the required tags.
Operation User Tokens
Operation user tokens are now supported on immediate requests.
Party Functions
Party classes in org.eidr.sdk.api have been deprecated. Please use the location org.eidr.sdk.party
introduced in 1.2.
BasicModificationBase
Org.eidr.sdk.utils.BasicModificationBaseResponse has been deprecated. Registry now correctly handles
CREATE_BASIC so this helper class is no longer needed.
ReplaceRelationship
Org.eidr.sdk.api.ReplaceRelationship has been deprecated. Languages are no longer managed through
inheritance relationships and lightweight relationships can be removed and re-added with no deduplication consequences, so this class is no longer needed.
Flattener
Org.eidr.sdk.utils.formats.Flattener has been added to support CSV style serialization of a resolved
objects. See javadoc for details on its use; and FlattenTool and ResolveMatches for examples of its use.
BulkIngestFile
Org.eidr.sdk.utils.formats.BulkIngestFile has been added to primarily to support RegisterTool and
MatchTool. See the Javadoc for details; and RegisterTool/MatchTool for examples.
Jaxbutils
Org.eidr.sdk.utils.JaxbUtils has been removed. This was a helper class for internal SDK functions. For
converting EIDR objects to and from XML, use the new EidrXMLObjUtils class. For other purposes
(managing application-defined XML and data structures) use Jaxb directly
4
Miscellaneous Changes
Schema Changes
Jaxb 2.2.6 is used for EIDR 2.0 so all accessor methods must agree with the Jaxb 2.2.6 output.
The EIDR schemas have changed substantially, especially around languages and episodic content. The
MovieLabs Common Metadata schema (which is also used by Ultraviolet) is used more extensively,
especially in Manifestations, which have replaced 1.x Encodings. Please see EIDR 2.0 Release Notes and
EIDR Data Fields Reference for a full description of these changes.
SDK 2.0 Release Notes
2
2013-08-19
Schema locations and namespaces have changed.
•
•
EIDR schema
o
Bindings were in org.eidr.schema._1, now in org.eidr.schema
o
New namespace: http://www.eidr.org/schema
Common Metadata schema
o
Bindings were in the com.movielabs.md file, and are now at
com.movielabs.schema.md.v2_1.md
o
New namespace: http://www.movielabs.com/schema/md/v2.1/md
See EIDR schema doc for complete changes of classes/individual member items.
New Tools
FlattenTool replaces the previous FlattenRoots and FlattenSeriesTool. See EIDR 2.0 Tools Overview for
details.
Version String
The version string from the SDK and the Registry is now "2.0".
5
New Documentation
The following documents have been added under the Technical Documentation category at
http://eidr.org/technology since the 1.2 release:
•
The Data Fields Reference (including the validation rules), REST API Reference, Registry User’s
Guide, Registry Programmers Guide, and EIDR Glossary have been updated.
SDK 2.0 Release Notes
3
2013-08-19