EIDR SYSTEM VERSION 2.1 COMMAND-LINE TOOLS OVERVIEW 2017 Jan. 16 Copyright © 2012-2016 by the Entertainment ID Registry Association (EIDR). Copyrights in this work are licensed under the Creative Commons Attribution – No Derivative Works 3.0 United States License. See http://creativecommons.org/licenses/by-nd/3.0/ for full details. In addition, the operation and use of EIDR is protected by covenants as described in the EIDR Intellectual Property Rights Policy, a copy of which can be found at www.eidr.org. EIDR Command-Line Tools Overview. The content of this manual is furnished for information use only and is subject to change without notice and should not be construed as a commitment by the Entertainment ID Registry Association. The Entertainment ID Registry Association assumes no responsibility or liability for any errors or inaccuracies that may appear in this document. Products and company names mentioned may be trademarks of their respective owners. Feedback on this document can be sent to [email protected] Table of Contents 1. Introduction .................................................................................................................................... 5 Configuration File ......................................................................................................................................... 5 Windows Executables ................................................................................................................................... 6 Tools ............................................................................................................................................................. 6 General Notes................................................................................................................................................ 7 Common Flags .......................................................................................................................................... 7 File Encoding ............................................................................................................................................ 7 ID File Input ............................................................................................................................................. 8 ID Output .................................................................................................................................................. 8 Multiple XML Records .............................................................................................................................. 8 Query Construction ................................................................................................................................... 8 Batch Files ................................................................................................................................................ 9 Deduplication Mode ................................................................................................................................ 10 Single vs. Multiple Input When Writing to the Registry .......................................................................... 10 Logging and Debugging ......................................................................................................................... 12 Namespaces............................................................................................................................................. 13 Schema Locations ................................................................................................................................... 14 2. Tools that Read the Registry ................................................................................................... 15 ResolveTool ................................................................................................................................................ 15 QueryTool ................................................................................................................................................... 16 Example Queries ..................................................................................................................................... 18 FlattenTool .................................................................................................................................................. 20 Flat mode ................................................................................................................................................ 21 Tree mode ............................................................................................................................................... 21 Bulk Mode ............................................................................................................................................... 21 Output format .......................................................................................................................................... 21 PartyTool .................................................................................................................................................... 25 GraphTool ................................................................................................................................................... 27 StatusTool ................................................................................................................................................... 29 AltIDtoEIDR ............................................................................................................................................... 31 3. Creating and Modifying Content Records ........................................................................... 33 RegisterTool ................................................................................................................................................ 33 Examples ................................................................................................................................................. 34 GetModBaseTool/ApplyModBaseTool ...................................................................................................... 40 Get ........................................................................................................................................................... 40 Apply ....................................................................................................................................................... 42 Example .................................................................................................................................................. 42 Notes ....................................................................................................................................................... 44 AltIDTool .................................................................................................................................................... 44 Gchange ...................................................................................................................................................... 48 4. Matching Against the EIDR Database ................................................................................... 50 MatchTool ................................................................................................................................................... 50 ResolveMatches .......................................................................................................................................... 52 ProcessStrongMatches ................................................................................................................................ 53 Example Workflow for Match/Register ...................................................................................................... 56 5. Managing Relationships ............................................................................................................ 61 RemoveRelTool .......................................................................................................................................... 61 AddLWTool ................................................................................................................................................ 61 6. Reversible Administration....................................................................................................... 64 PromoteTool ............................................................................................................................................... 64 7. Irreversible Administration .................................................................................................... 65 DeleteTool................................................................................................................................................... 65 AliasTool .................................................................................................................................................... 65 Appendix 1: FlattenTool Column Names..................................................................................... 66 Appendix 2: Common Problems..................................................................................................... 72 Incorrect Strong Matches ...........................................................................................................................