Schritt 3 von 5)
3. Schreiben Sie an einen ORCID Datensatz (POST)
Glückwunsch! Sie haben alles eingerichtet und sammeln IDs und Berechtigungen – jetzt kommt der spaßige Teil! In dieser Lektion lernen Sie, wie Sie Daten in ein schreiben ORCID Rekord.
In diesem Abschnitt fügen wir Ihrem Sandbox-Datensatz die Zugehörigkeit „Bildung“ hinzu.
Im folgenden Beispiel verwenden wir den Endpunkt /education mit dem korrektes XML um die Informationen hinzuzufügen, Sie können aber auch beispielsweise „Beschäftigung“ oder „Arbeiten“ hinzufügen. Sehen Sie sich unsere an Github-Dokumentation Weitere Beispieldateien und Endpunkte sowie die Berechtigungen, die Sie jeweils benötigen.
Hier ist ein Beispiel für Bildungs-XML, das Sie für diese Übung verwenden können:
<?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>
Kehren Sie zum Browser-Tab für Google Developers OAuth 2.0 Playground zurück. Wenn Sie die Registerkarte nicht geöffnet gelassen haben, können Sie die Sitzung mit der zuvor gespeicherten URL erneut initialisieren (indem Sie in der angezeigten Warnung auf „OK“ klicken). Oder Sie können den Anruf erneut einrichten, indem Sie alle relevanten Felder ausfüllen und sicherstellen, dass sie wie in den Screenshots unten aussehen:
Stellen Sie sicher, dass die Konfiguration hat dein Auftraggeber ID und Kundengeheimnis
Unter Schritt 2 im Google OAuth-Playground sollten Sie Ihre haben Zugangstoken ausgefüllt
Es sollte entweder noch das Token von früher enthalten sein oder Sie können es wie folgt aus der vorherigen Übung ergänzen:
Klicken Sie unter Schritt 3 im Google Developers OAuth 2-Playground auf Kopfzeilen hinzufügen, geben Sie die Werte unten ein und klicken Sie dann Speichern und Menu
Header name: Accept
Header value: application/vnd.orcid+xml
Unter Schritt 3: Konfigurieren Anforderung zu API, einstellen HTTP-Methode zu POST.
Im URI anfordern Feld eingeben:
https://api.sandbox.orcid.org/v3.0/[ORCID ID]/education
Ersetzen [ORCID ID] mit der iD Geben Sie für Ihren Sandbox-Datensatz das Format XXXX-XXXX-XXXX-XXXX ein, mit dem Sie die Erlaubnis zur Interaktion eingeholt haben.
Klicken Sie auf Kostenlos erhalten und dann auf Installieren. Inhaltstyp > Maßgeschneidert und gib ein
application/vnd.orcid+xml
Klicken Sie auf Kostenlos erhalten und dann auf Installieren. Speichern, dann klick Menu.
Klicken Sie auf Kostenlos erhalten und dann auf Installieren. Geben Sie den Anfragetext ein.
Kopieren Sie die XML-Datei zur Bildungszugehörigkeit oben in diesem Abschnitt und fügen Sie sie in die ein Körper anfordern Textfeld:
OPTIONAL: Im Körper anfordern Bearbeiten Sie im Textfeld die XML-Datei so, dass sie Ihre Institution widerspiegelt. Für , verwenden Sie die ROR-Registrierung um den ROR zu finden ID für Ihr Institutn.
Klicken Sie auf Kostenlos erhalten und dann auf Installieren. Menu.
Klicken Sie auf Kostenlos erhalten und dann auf Installieren. Senden Sie die Anfrage.
Die Ergebnisse werden im angezeigt Anfrage/Antwort section on the right. Scroll to the bottom of the response – if you see HTTP/1.1 201 Erstellt, Ihre Bildungszugehörigkeit wurde erfolgreich hinzugefügt! Unten sehen Sie einen Auszug eines Beispiels dafür, wie das XML mit der 201 erstellten Nachricht unten angezeigt wird.
... <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
Bitte speichern Sie Ihren Put-Code. Er wird im nächsten Abschnitt zum Aktualisieren von Artikeln benötigt!
Speichern Sie Ihren Put-Code
Put-Codes sind kurze numerische Codes, die auf einen bestimmten Artikel verweisen ORCID Rekord.
Wenn Sie ein Element im Datensatz eines Forschers veröffentlichen, enthält die API-Antwort den Put-Code für dieses Element. Sie können den Put-Code speichern, um ihn später zu verwenden, wenn Sie das Element lesen, aktualisieren oder löschen müssen.
Im obigen Beispiel besteht der Put-Code aus den 5 Ziffern am Ende dieser Zeile: Speicherort: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Wenn Ihre Antwort einen Fehler enthält, überprüfen Sie, dass Ihre XML-Tags keine Tippfehler enthalten und dass Sie alle anderen Details korrekt eingegeben haben. Der kleinste Tippfehler kann alles kaputt machen!
Besuchen Sie die öffentliche Ansicht Ihres Sandbox-Datensatzes unter https://sandbox.orcid.org/[ORCID ID], um Ihre neue Bildungszugehörigkeit anzuzeigen.
Beachten Sie, dass Source den Namen des API-Clients anzeigt, der die Zugehörigkeit hinzugefügt hat – dies ist ein Schlüsselelement, das anderen Systemen bei der Nutzung hilft ORCID Daten bestimmen, ob diese Information maßgeblich ist.