orcid_client 0.3.3 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 4fe2358b8ada64c780b263571714a74aeef4ba91
-  data.tar.gz: 78701a53e235101d70cab1e48eb9a3ae27067efc
+SHA256:
+  metadata.gz: 59481495c710df2ed1a634fd0a355b73187767cb3b6bd7ebce7442e087db559b
+  data.tar.gz: 43c60864e1dd8fe3bb4a0d810d9b275f8905d320e9180cd307dbd7dd685bc94f
 SHA512:
-  metadata.gz: a2f9b14146e93959b3acabe80329ed3374f55b5f8211f48dda3d9adb5699cec060a0a499102c558dcb25cf3138a783491014ed9a3d9f2edea6dde575d58a48a7
-  data.tar.gz: a2b96e5069a1a0e9acb845f39c97a9be3a5d08e6689d3050b1e6e236b5b7232c6e65d5db38d283a6186300d7f640e24ae476a22bb0c28c52dfee9eb36cf409f5
+  metadata.gz: 92ce725ede978a6575ce215620f2b28eedb404ae60b4bfa7fb9ba02cb952cd270166912971fe2c114c9eb736e47ef205cd595906690d7aad11d6a38dfd59ba8b
+  data.tar.gz: a3b9133205206e113ae0b08d70c108273e41e19e0be338f023384554f41c64c047fdcee756ac977cb3b6645cb02ca1578b2767aab277335076a921daf4755427

data/.env.example

@@ -1,5 +1,5 @@
 ORCID_API_URL=
-SEARCH_URL=
+SOLR_URL=
 
 # needed to post works
 ACCESS_TOKEN=

data/Gemfile.lock

@@ -1,41 +1,43 @@
 PATH
   remote: .
   specs:
-    orcid_client (0.3.3)
+    orcid_client (0.4.1)
       activesupport (>= 4.2.5, < 6)
-      bolognese (~> 0.9.28)
+      bolognese (~> 0.9.93)
       builder (~> 3.2, >= 3.2.2)
       dotenv (~> 2.1, >= 2.1.1)
-      maremma (~> 3.5, >= 3.5.7)
+      maremma (>= 3.5.7, < 5)
       namae (~> 0.11.3)
-      nokogiri (~> 1.6, >= 1.6.8)
+      nokogiri (~> 1.8.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (5.1.1)
+    activesupport (5.2.0)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (~> 0.7)
+      i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-    addressable (2.5.1)
-      public_suffix (~> 2.0, >= 2.0.2)
+    addressable (2.5.2)
+      public_suffix (>= 2.0.2, < 4.0)
     benchmark_methods (0.7)
-    bibtex-ruby (4.4.3)
+    bibtex-ruby (4.4.6)
       latex-decode (~> 0.0)
-    bolognese (0.9.28)
+    bolognese (0.9.93)
       activesupport (>= 4.2.5, < 6)
       benchmark_methods (~> 0.7)
       bibtex-ruby (~> 4.1)
       builder (~> 3.2, >= 3.2.2)
       colorize (~> 0.8.1)
       gender_detector (~> 0.1.2)
+      iso8601 (~> 0.9.1)
       json-ld (~> 2.1, >= 2.1.2)
       jsonlint (~> 0.2.0)
       loofah (~> 2.0, >= 2.0.3)
-      maremma (~> 3.5, >= 3.5.7)
+      maremma (>= 3.5.7, < 5)
       namae (~> 0.11.3)
-      nokogiri (~> 1.6, >= 1.6.8)
+      nokogiri (~> 1.8.1)
+      oj (>= 2.8.3)
       postrank-uri (~> 1.0, >= 1.0.18)
       rdf-rdfxml (~> 2.0)
       rdf-turtle (~> 2.2)
@@ -47,122 +49,124 @@ GEM
     concurrent-ruby (1.0.5)
     crack (0.4.3)
       safe_yaml (~> 1.0.0)
+    crass (1.0.4)
     diff-lcs (1.3)
     docile (1.1.5)
-    dotenv (2.2.1)
-    ebnf (1.1.0)
-      rdf (~> 2.0)
+    dotenv (2.2.2)
+    ebnf (1.1.2)
+      rdf (>= 2.2, < 4.0)
       sxp (~> 1.0)
-    excon (0.45.4)
-    faraday (0.9.2)
+    excon (0.62.0)
+    faraday (0.14.0)
       multipart-post (>= 1.2, < 3)
     faraday-encoding (0.0.4)
       faraday
-    faraday_middleware (0.10.1)
+    faraday_middleware (0.12.2)
       faraday (>= 0.7.4, < 1.0)
     gender_detector (0.1.2)
       unicode_utils (>= 1.3.0)
-    haml (5.0.1)
+    haml (5.0.4)
       temple (>= 0.8.0)
       tilt
     hamster (3.0.0)
       concurrent-ruby (~> 1.0)
-    hashdiff (0.3.4)
+    hashdiff (0.3.7)
     htmlentities (4.3.4)
-    i18n (0.8.4)
+    i18n (1.0.0)
+      concurrent-ruby (~> 1.0)
+    iso8601 (0.9.1)
     json (2.1.0)
-    json-ld (2.1.4)
+    json-ld (2.2.1)
       multi_json (~> 1.12)
-      rdf (~> 2.2)
+      rdf (>= 2.2.8, < 4.0)
     jsonlint (0.2.0)
       oj (~> 2)
       trollop (~> 2)
-    latex-decode (0.2.2)
-      unicode (~> 0.4)
+    latex-decode (0.3.1)
     link_header (0.0.8)
-    loofah (2.0.3)
+    loofah (2.2.2)
+      crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
-    maremma (3.5.8)
-      activesupport (>= 4.2.5)
+    maremma (4.0.5)
+      activesupport (>= 4.2.5, < 6)
       addressable (>= 2.3.6)
       builder (~> 3.2, >= 3.2.2)
-      excon (~> 0.45.0)
-      faraday (~> 0.9.2)
-      faraday-encoding (~> 0.0.1)
-      faraday_middleware (~> 0.10.0)
+      excon (~> 0.60)
+      faraday (~> 0.14)
+      faraday-encoding (~> 0.0.4)
+      faraday_middleware (~> 0.12.0)
       multi_json (~> 1.12)
-      nokogiri (~> 1.6, >= 1.6.8)
-      oj (~> 2.18, >= 2.18.1)
-    mini_portile2 (2.1.0)
-    minitest (5.10.2)
-    multi_json (1.12.1)
+      nokogiri (~> 1.8.1)
+      oj (>= 2.8.3)
+    mini_portile2 (2.3.0)
+    minitest (5.11.3)
+    multi_json (1.13.1)
     multipart-post (2.0.0)
     namae (0.11.3)
-    nokogiri (1.7.2)
-      mini_portile2 (~> 2.1.0)
+    nokogiri (1.8.2)
+      mini_portile2 (~> 2.3.0)
     oj (2.18.5)
-    postrank-uri (1.0.22)
+    postrank-uri (1.0.23)
       addressable (>= 2.3.0, < 2.6)
-      nokogiri (>= 1.6.1, < 1.8)
+      nokogiri (>= 1.6.1, < 1.9)
       public_suffix (>= 2.0.0, < 2.1)
     public_suffix (2.0.5)
-    rack (2.0.3)
-    rack-test (0.6.3)
-      rack (>= 1.0)
-    rake (12.0.0)
-    rdf (2.2.6)
+    rack (2.0.4)
+    rack-test (0.8.3)
+      rack (>= 1.0, < 3)
+    rake (12.3.1)
+    rdf (3.0.2)
       hamster (~> 3.0)
       link_header (~> 0.0, >= 0.0.8)
-    rdf-aggregate-repo (2.2.0)
-      rdf (~> 2.0)
-    rdf-rdfa (2.2.2)
+    rdf-aggregate-repo (2.2.1)
+      rdf (>= 2.2, < 4.0)
+    rdf-rdfa (3.0.1)
       haml (~> 5.0)
       htmlentities (~> 4.3)
-      rdf (~> 2.2)
-      rdf-aggregate-repo (~> 2.2)
-      rdf-xsd (~> 2.1)
-    rdf-rdfxml (2.0.0)
+      rdf (~> 3.0)
+      rdf-aggregate-repo (>= 2.2, < 4.0)
+      rdf-xsd (~> 3.0)
+    rdf-rdfxml (2.2.1)
       htmlentities (~> 4.3)
-      rdf (~> 2.0)
-      rdf-rdfa (~> 2.0)
-      rdf-xsd (~> 2.0)
-    rdf-turtle (2.2.0)
+      rdf (>= 2.2, < 4.0)
+      rdf-rdfa (>= 2.2, < 4.0)
+      rdf-xsd (>= 2.2, < 4.0)
+    rdf-turtle (2.2.2)
       ebnf (~> 1.1)
-      rdf (~> 2.2)
-    rdf-xsd (2.2.0)
-      rdf (~> 2.1)
-    rspec (3.6.0)
-      rspec-core (~> 3.6.0)
-      rspec-expectations (~> 3.6.0)
-      rspec-mocks (~> 3.6.0)
-    rspec-core (3.6.0)
-      rspec-support (~> 3.6.0)
-    rspec-expectations (3.6.0)
+      rdf (>= 2.2, < 4.0)
+    rdf-xsd (3.0.0)
+      rdf (~> 3.0)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.1)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.6.0)
-    rspec-mocks (3.6.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.6.0)
-    rspec-support (3.6.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.1)
     safe_yaml (1.0.4)
     simplecov (0.13.0)
       docile (~> 1.1.0)
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
-    simplecov-html (0.10.1)
-    sxp (1.0.0)
-      rdf (~> 2.0)
+    simplecov-html (0.10.2)
+    sxp (1.0.1)
+      rdf (>= 2.2, < 4.0)
     temple (0.8.0)
-    thor (0.19.4)
+    thor (0.20.0)
     thread_safe (0.3.6)
-    tilt (2.0.7)
+    tilt (2.0.8)
     trollop (2.1.2)
-    tzinfo (1.2.3)
+    tzinfo (1.2.5)
       thread_safe (~> 0.1)
-    unicode (0.4.4.4)
     unicode_utils (1.4.0)
-    vcr (3.0.3)
-    webmock (3.0.1)
+    vcr (4.0.0)
+    webmock (3.3.0)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
       hashdiff
@@ -182,4 +186,4 @@ DEPENDENCIES
   webmock (~> 3.0, >= 3.0.1)
 
 BUNDLED WITH
-   1.12.5
+   1.16.1

data/lib/orcid_client/api.rb

@@ -2,7 +2,7 @@ require "uri"
 
 module OrcidClient
   module Api
-    API_VERSION = "2.0"
+    API_VERSION = "2.1"
 
     def get_works(options={})
       return OpenStruct.new(body: { "errors" => [{ "title" => "Access token missing" }] }) unless access_token.present?

data/lib/orcid_client/base.rb

@@ -10,8 +10,9 @@ module OrcidClient
     # load ENV variables from container environment if json file exists
     # see https://github.com/phusion/baseimage-docker#envvar_dumps
     env_json_file = "/etc/container_environment.json"
-    if File.exist?(env_json_file)
-      env_vars = JSON.parse(File.read(env_json_file))
+    json = File.exist?(env_json_file) ? File.read(env_json_file) : ""
+    if json.length >= 2
+      env_vars = JSON.parse(json)
       env_vars.each { |k, v| ENV[k] = v }
     end
 

data/lib/orcid_client/external_identifier.rb

@@ -45,7 +45,7 @@ module OrcidClient
       { :'put-code' => put_code,
         :'visibility' => 'public',
         :'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance',
-        :'xsi:schemaLocation' => 'http://www.orcid.org/ns/external-identifier ../person-external-identifier-2.0.xsd',
+        :'xsi:schemaLocation' => 'http://www.orcid.org/ns/external-identifier ../person-external-identifier-2.1.xsd',
         :'xmlns:common' => 'http://www.orcid.org/ns/common',
         :'xmlns:external-identifier' => 'http://www.orcid.org/ns/external-identifier' }.compact
     end

data/lib/orcid_client/notification.rb

@@ -107,7 +107,7 @@ module OrcidClient
 
     def root_attributes
       { :'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance',
-        :'xsi:schemaLocation' => 'http://www.orcid.org/ns/notification ../notification-permission-2.0.xsd',
+        :'xsi:schemaLocation' => 'http://www.orcid.org/ns/notification ../notification-permission-2.1.xsd',
         :'xmlns:common' => 'http://www.orcid.org/ns/common',
         :'xmlns:notification' => 'http://www.orcid.org/ns/notification' }
     end

data/lib/orcid_client/version.rb

@@ -1,3 +1,3 @@
 module OrcidClient
-  VERSION = "0.3.3"
+  VERSION = "0.4.1"
 end

data/lib/orcid_client/work.rb

@@ -17,30 +17,31 @@ module OrcidClient
 
     include Bolognese::Utils
 
-    attr_reader :doi, :orcid, :schema, :access_token, :search_url, :put_code, :validation_errors, :name_detector
+    attr_reader :doi, :orcid, :schema, :access_token, :sandbox, :put_code, :validation_errors, :name_detector
 
     def initialize(doi:, orcid:, access_token:, **options)
       @doi = doi
       @orcid = orcid
       @access_token = access_token
-      @search_url = options.fetch(:search_url, nil) || ENV['SOLR_URL']
+      @sandbox = options.fetch(:sandbox, nil) || ENV['SOLR_URL'] == "https://search.test.datacite.org/api"
       @put_code = options.fetch(:put_code, nil)
     end
 
     SCHEMA = File.expand_path("../../../resources/record_#{API_VERSION}/work-#{API_VERSION}.xsd", __FILE__)
+
     # recognize given name. Can be loaded once as ::NameDetector, e.g. in a Rails initializer
     def name_detector
       @name_detector ||= defined?(::NameDetector) ? ::NameDetector : GenderDetector.new
     end
 
     def metadata
-      @metadata ||= Bolognese::Metadata.new(input: doi, search_url: search_url)
+      @metadata ||= Bolognese::Metadata.new(input: doi, sandbox: sandbox)
     end
 
     def contributors
       Array.wrap(metadata.author).map do |contributor|
         orcid = validate_orcid(contributor.fetch('id', nil))
-        orcid = "http://orcid.org/#{orcid}" if orcid.present?
+        orcid = "https://orcid.org/#{orcid}" if orcid.present?
 
         { orcid: orcid,
           credit_name: contributor.fetch('name', nil),
@@ -179,7 +180,7 @@ module OrcidClient
       { :'put-code' => put_code,
         :'visibility' => 'public',
         :'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance',
-        :'xsi:schemaLocation' => 'http://www.orcid.org/ns/work ../work-2.0.xsd',
+        :'xsi:schemaLocation' => 'http://www.orcid.org/ns/work ../work-2.1.xsd',
         :'xmlns:common' => 'http://www.orcid.org/ns/common',
         :'xmlns:work' => 'http://www.orcid.org/ns/work' }.compact
     end

data/orcid_client.gemspec

@@ -19,9 +19,9 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   # Declary dependencies here, rather than in the Gemfile
-  s.add_dependency 'maremma', '~> 3.5', '>= 3.5.7'
-  s.add_dependency 'bolognese', '~> 0.9.28'
-  s.add_dependency 'nokogiri', '~> 1.6', '>= 1.6.8'
+  s.add_dependency 'maremma', '>= 3.5.7', '< 5'
+  s.add_dependency 'nokogiri', '~> 1.8.1'
+  s.add_dependency 'bolognese', '~> 0.9.93'
   s.add_dependency 'builder', '~> 3.2', '>= 3.2.2'
   s.add_dependency 'namae', '~> 0.11.3'
   s.add_dependency 'activesupport', '>= 4.2.5', '< 6'

data/resources/README.md

@@ -0,0 +1,131 @@
+## ORCID Message (XSD) Readme 
+
+**Contents**
+
+* [XSD Information](#orcid-xsd-information)
+    * [Active Versions & Base URLs](#active-xsd-versions-and-base-urls)
+* [About XSD Updates and Versioning](#about-xsd-updates-and-versioning)
+    * [Staying Informed](#staying-informed)
+    * [Using XSD Versions](#using-xsd-versions)
+* [ORCID-Message XSD Versions Table](#orcid-message-xsd-versions)
+* [Getting Help](#getting-help)
+
+---
+
+# ORCID XSD information
+
+##Active XSD versions and base URLs
+
+#### XSD release version
+
+* **[ORCID Message 2.0](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources/record_2.0)** - [Documentation](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/record_2.0/README.md), [Change log from 1.2](https://members.orcid.org/api/news/xsd-20-update)
+    * API Base URLs - PRODUCTION
+        * Public API:   https://pub.orcid.org/v2.0/
+        * Member API:   https://api.orcid.org/v2.0/
+    * API Base URLs - SANDBOX
+        * Public API:   https://pub.sandbox.orcid.org/v2.0/
+        * Member API:   https://api.sandbox.orcid.org/v2.0/
+
+#### XSD release candidate(s)
+
+* **[ORCID Message 2.0_rc4](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources/record_2.0_rc4)** - _Contains: Minor corrections and updates_ <br/> 
+* **[ORCID Message 2.0_rc3](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources/record_2.0_rc3)** - _Contains: bulk works, activities section endpoints_ <br/> 
+* **[ORCID Message 2.0_rc2](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources/record_2.0_rc2)** - _Contains: Person section, migrates all identifiers to external-identifier_ <br/> 
+* **[ORCID Message 2.0_rc1](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources/record_2.0_rc1)** - _Contains: Peer-review, new format XSD for activities_ <br/><br/>
+    * API Base URLs - PRODUCTION (replace 'X' in the URL with the rc version)
+        * Public API:   https://pub.orcid.org/v2.0_rcX/
+        * Member API:   https://api.orcid.org/v2.0_rcX/
+    * API Base URLs - SANDBOX
+        * Public API:   https://pub.sandbox.orcid.org/v2.0_rcX/
+        * Member API:   https://api.sandbox.orcid.org/v2.0_rcX/
+
+#### XSD deprecated versions
+
+* **[ORCID Message 1.2](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/orcid-message-1.2.xsd)** 
+    * API Base URLs - PRODUCTION
+        * Public API:   https://pub.orcid.org/v1.2/
+        * Member API:   https://api.orcid.org/v1.2/
+    * API Base URLs - SANDBOX
+        * Public API:   https://pub.sandbox.orcid.org/v1.2/
+        * Member API:   https://api.sandbox.orcid.org/v1.2/
+
+
+#### Sunset versions (unavailable, unsupported, should not be used)
+
+* **Version 1.0.x (includes versions 1.0.1 through 1.0.23)** <br>_Sunset Date: March 1, 2014_
+* **[ORCID Message 1.1](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/orcid-message-1.1.xsd)** <br>_Sunset Date: April 1, 2015_
+
+_NOTE:<br />API calls for member to ORCID iD holder authorization using OAuth are not affected by XSD versions. Regardless of the XSD version used, the OAuth endpoints are:_
+
+* _[http://orcid.org/oauth/authorize](http://support.orcid.org/knowledgebase/articles/120107)_
+* _[https://orcid.org/oauth/token](http://support.orcid.org/knowledgebase/articles/119985)_
+
+
+# About XSD Updates and Versioning
+
+
+At any one time there may be several available versions of the XSD available for use:
+
+* _Deprecated Version(s)_ - past version(s) of the XSD. While deprecated versions may still work, developers should be migrating to a current release version. New development should not be done against deprecated versions.
+* _Release Version(s)_ - the XSD version you should be actively migrating to in order to take advantage of either improvements or new functionality.
+* _One or more Release Candidates_ - these versions of the XSD contain in-progress improvements and functionality. They are made available to enable API users to take advantage of new functionality faster than waiting for the next Release Version. These versions are subject to change at any time.
+
+_Which XSD version should I be using?_
+
+The XSD version you should use depends on what you are trying to do. Most developers will use a current Release Version, or be actively migrating to one. However, if you are developing an integration that takes advantage of new functionality or improvement, you likely will need to use one of the Release Candidates.
+
+## Staying informed
+
+You can stay informed of updates to the XSD and API by subscribing to our [API Users Group](https://groups.google.com/forum/?fromgroups#!forum/orcid-api-users) mailing list and forum. 
+
+## Using XSD versions
+
+### <a name="deprecatedVersion"></a>Deprecated version(s)
+
+The deprecated version(s) of the XSD are former versions of the XSD. If you are using a deprecated version, you should be planning a migration to move to a release version. Other things of note about deprecated versions:
+
+* An XSD that has changed to deprecated status will not be removed immediately, though we are actively encouraging all developers to move to the current release version. 
+* Developers on deprecated versions should refer to the migration notes to assist in moving to the latest release version.
+* Future functionality will not be supported in deprecated versions.
+* Future versions may not be backward compatible with deprecated versions.
+* Deprecated versions will have a “sunset date”, after which they will no longer be supported. Developers experiencing problems with deprecated versions will be directed to move to the release version.
+
+### <a name="releaseVersion"></a>Release version(s)
+
+Release versions of the XSD are fully documented, tested, supported and encouraged for use. Of note about release versions:
+
+* Our intent is for release versions of the XSD to have longer lifespans than the very fast pace of ORCID new development.
+* When feasible, we will provide estimates of when the next release version is likely to be available, and what it is likely to contain.
+* While more than one release version may be available at any time, we highly recommend that developers update to the latest release version at least once per year to enjoy optimal XSD stability.
+
+### <a name="releaseCandidate"></a>Release candidate(s)
+
+Release candidate versions of the XSD contain elements and data structures for future functionality, potential changes and other enhancements. Of note about release candidates:
+
+* The version number of release candidates will contain ‘rc’ to indicate that they are release candidates (for example, version 1.2_rc1). The first two numbers indicate the target release version for the candidate. For example, the changes and enhancements in version 1.2_rc1 are being considered for inclusion with release version 1.2.
+* Release candidates are generally unsupported, and have limited documentation.
+* Elements and data structure within a release candidate XSD could change at any time based on development needs and feedback from early adopters.
+* We welcome feedback from any developers working with current release candidates.
+
+
+# ORCID-message XSD versions
+
+| Version/link | Release Date | Sunset date | Notes | Who should be using this version |
+| ------------ | ------------ | ----------- | ----- | -------------------------------- |
+| [ORCID XSD 2.0](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources/record_2.0) | Feb 13, 2017 | | **[Release version](#releaseVersion)**<br><br>CURRENT SUPPORTED VERSION<br/>[Change log from 1.2](https://members.orcid.org/api/news/xsd-20-update) |This is the preferred version. All developers should be using or migrating to this version. [Documentation](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/record_2.0/README.md)|
+| [ORCID XSD 2.0_rc4](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources/record_2.0_rc4) | Jan 24, 2017 | | **[Release candidate version](#releaseCandidate)**<br><br/>_minor fixes and corrections_ | |
+| [ORCID XSD 2.0_rc3](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources/record_2.0_rc3) | Nov 18, 2016 | | **[Release candidate version](#releaseCandidate)**<br><br/>_adds bulk works_ |  |
+| [ORCID XSD 2.0_rc2](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources/record_2.0_rc2) | Jul 20, 2016 | | **[Release candidate version](#releaseCandidate)**<br><br/>_adds person section_ | |
+| [ORCID XSD 2.0_rc1](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources/record_2.0_rc1) | Jul 01, 2015 | | **[Release candidate version](#releaseCandidate)**<br><br/>_adds peer-review section, reformats XSD for activities_ | |
+| [ORCID XSD 1.2](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/orcid-message-1.2.xsd) | Jan 12, 2015 | Late 2017 | **[Deprecated version](#deprecatedVersion)**<br/><br/> | All developers on this version should migrate to version 2.0 |
+| XSD 1.2_rcX | throughout 2014 | Apr 1, 2015 | **[Deprecated versions](#deprecatedVersion)**<br/><br/>[XSD 1.2_rc1](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/orcid-message-1.2_rc1.xsd): _adds elements for education or employment affiliations_<br/>[XSD 1.2_rc2](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/orcid-message-1.2_rc2.xsd): _updates the options for the creation-method field, and adds elements needed for funding_<br/>[XSD 1.2_rc3](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/orcid-message-1.2_rc3.xsd): _restricts the valid language codes to those supported by ORCID, and removes patents as a separate element (included under the works element)_<br/>[XSD 1.2_rc4](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/orcid-message-1.2_rc4.xsd): _provides more details about existing elements, email verification info, organization details that create an ORCID record, and funding agency details for funding element_<br/>[XSD 1.2_rc5](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/orcid-message-1.2_rc5.xsd): _clarifies elements for data provenance - the data source, creation date and modification date; work external IDs are required_<br/>[XSD 1.2_rc6](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/orcid-message-1.2_rc6.xsd): _adds more work types_ | These versions were sunset as of Apr 1, 2015. They are no longer available and should not be used. |
+| [ORCID XSD 1.1](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/orcid-message-1.1.xsd) | Nov 25, 2013 | Apr 1, 2015 | **[Deprecated version](#deprecatedVersion)**<br><br> | This version was sunset as of Apr 1, 2015. It is no longer available and should not be used. |
+| [ORCID XSD 1.0.x](https://github.com/ORCID/ORCID-Source/tree/master/orcid-model/src/main/resources) | various | Mar 1, 2014 | **Sunset version** | These versions were sunset as of March 1, 2014. They are no longer available and should not be used. _(Versions 1.0.1 - 1.0.23)_ |
+
+# Getting help
+
+Technical documentation is included with the read-me file for each version. [Current release documentation](https://github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/record_2.0/README.md)
+
+The [ORCID Member Support Site](https://members.orcid.org) has additional documentation, tutorials and guides, as well as contact for our support team. 
+
+We also invite you to submit questions to the [API Users Group](https://groups.google.com/forum/?fromgroups#!forum/orcid-api-users) mailing list and forum.