手順 3名(5年)
3. に書き込む ORCID 記録 (投稿)
おめでとう! すべての設定が完了し、iD と権限を収集しています。ここからは楽しい部分です。 このレッスンでは、データを ORCID 記録。
このセクションでは、サンドボックス レコードに「教育」所属を追加します。
次の例では、/education エンドポイントを使用しています。 正しい XML 情報を追加しますが、たとえば雇用や仕事を追加することもできます。 私たちを参照してください Github ドキュメント より多くのサンプル ファイルとエンドポイント、およびそれぞれに必要なアクセス許可については、.
この演習で使用できる Education XML の例を次に示します。
<?xml version="1.0" encoding="UTF-8"?>
<education:education
xmlns:common="http://www.orcid.org/ns/common" xmlns:education="http://www.orcid.org/ns/education"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.orcid.org/ns/education ../education-3.0.xsd ">
<common:department-name>department-name</common:department-name>
<common:role-title>role-title</common:role-title>
<common:start-date>
<common:year>1948</common:year>
<common:month>02</common:month>
<common:day>02</common:day>
</common:start-date>
<common:end-date>
<common:year>1948</common:year>
<common:month>02</common:month>
<common:day>02</common:day>
</common:end-date>
<common:organization>
<common:name>common:name</common:name>
<common:address>
<common:city>common:city</common:city>
<common:region>common:region</common:region>
<common:country>AF</common:country>
</common:address>
<common:disambiguated-organization>
<common:disambiguated-organization-identifier>http://dx.doi.org/10.13039/100000001</common:disambiguated-organization-identifier>
<common:disambiguation-source>FUNDREF</common:disambiguation-source>
</common:disambiguated-organization>
</common:organization>
<common:url>http://tempuri.org</common:url>
<common:external-ids>
<common:external-id>
<common:external-id-type>grant_number</common:external-id-type>
<common:external-id-value>external-identifier-value</common:external-id-value>
<common:external-id-url>http://tempuri.org</common:external-id-url>
<common:external-id-relationship>self</common:external-id-relationship>
</common:external-id>
<common:external-id>
<common:external-id-type>grant_number</common:external-id-type>
<common:external-id-value>external-identifier-value2</common:external-id-value>
<common:external-id-url>http://tempuri.org/2</common:external-id-url>
<common:external-id-relationship>self</common:external-id-relationship>
</common:external-id>
</common:external-ids>
</education:education>
Google Developers OAuth 2.0 Playground のブラウザ タブに戻ります。 タブを開いたままにしなかった場合は、前に保存した URL を使用してセッションを再初期化できます (表示される警告で [OK] をクリックします)。 または、関連フィールドをすべて入力し、以下のスクリーンショットのようになっていることを確認して、通話を再度設定することもできます。
ことを確認してください の監視 あなたの クライアント ID およびクライアント シークレット
Google Oauth Playground 内のステップ 2 の下に、 アクセストークン 記入
以前のトークンがまだ残っている必要があります。または、次のように前の演習から入力することもできます。
Google Developers OAuth 3 プレイグラウンド内のステップ 2 の下にあるクリック ヘッダーの追加をクリックし、以下の値を入力してから、 Add & 閉じる
Header name: Accept
Header value: application/vnd.orcid+xml
ステップ 3: 構成の下 要求 〜へ API、セット HTTPメソッド 〜へ 役職。
リクエストURI フィールド入力:
https://api.sandbox.orcid.org/v3.0/[ORCID ID]/education
交換 [ORCID ID] と iD サンドボックス レコードの場合は、対話する許可を収集した XXXX-XXXX-XXXX-XXXX の形式で指定します。
クリック コンテンツタイプ > カスタム 入力してください
application/vnd.orcid+xml
クリック Add、[OK]をクリックします 閉じる.
クリック リクエスト本文を入力してください.
このセクションの上部にある教育機関の XML をコピーして、 リクエスト本文 テキストボックス:
任意: リクエスト本文 テキスト ボックスで、機関を反映するように XML を編集します。 為に、 使用 RORレジストリ RORを見つける ID あなたの機関のためにn.
クリック 閉じる.
クリック リクエストを送信する.
結果は リクエスト/レスポンス 右側のセクション。 応答の一番下までスクロールします。 HTTP/1.1 201 が作成されました、あなたの学歴が正常に追加されました。 以下に、XML がどのように表示され、下部に 201 作成されたメッセージが表示されるかの例の抜粋を示します。
... <common: month>01</common: month> <common: day>01</common: day>
</ common: start-date> <education:organization>
<common: name>My University</common: name> <common: address>
<common: city>Some City</common:city> <common: region>Region</common: region> <common: country>US</common:country>
</ common: address>
HTTP/1.1 201 Created
Content length. A X-xss-protection: 1; mode=block X-content-type-options: nosniff
Expires: 0
Server: nginx/1.10.0
Connection: keep-alive
Location: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Pragma: no-cache
Cache-control: no-cache, no-store, max-age=0, must-revalidate
Date: Thu, 15 Jun 2017 20:44:09 GMT
Access-control-allow-origin: *
Content-type: application/vnd.orcid+xml: qs=5;charset=UTF-8
X-frame-options: DENY
次のセクションでアイテムを更新するために必要となるコードを保存してください。
putコードを保存します
プット コードは、特定のアイテムを参照する短い数値コードです。 ORCID 記録。
アイテムを研究者の記録に投稿すると、API 応答にそのアイテムの投稿コードが含まれます。 その項目を読み取り、更新、または削除する必要がある場合は、後で使用するために put コードを保存できます。
上の例では、put コードはこの行の末尾の 5 桁です。 場所: http://api.sandbox。orcid.org/v3.0/0000-0002-4456-8947/education 26971
応答にエラーがある場合は、XML タグにタイプミスがないこと、およびその他の詳細がすべて正しく入力されていることを確認してください。 ほんのわずかなタイプミスがすべてを壊す可能性があります。
https://sandbox で Sandbox レコードのパブリック ビューにアクセスします。orcid.org/[ORCID ID] をクリックして、あなたの新しい学歴を確認してください。
ソースには、アフィリエーションを追加した API クライアントの名前が表示されることに注意してください。これは、他のシステムが使用するのに役立つ重要な要素です。 ORCID データは、この情報が信頼できるかどうかを決定します。