step 3 (del 5)
3. Scrivi a un ORCID registrare (POSTA)
Congratulazioni! Hai impostato tutto e stai raccogliendo iD e permessi, ora tocca alla parte divertente! In questa lezione imparerai come scrivere dati su un file ORCID record.
In questa sezione, aggiungeremo un'affiliazione "istruzione" al tuo record Sandbox.
Nell'esempio seguente utilizziamo l'endpoint /education con il XML corretto per aggiungere le informazioni, ma puoi anche aggiungere ad esempio Occupazione o Lavori. Vedi il nostro Documentazione Github per altri file di esempio ed endpoint e le autorizzazioni necessarie per ciascuno.
Ecco un esempio di Education XML che puoi utilizzare per questo esercizio:
<?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>
Torna alla scheda del browser per Google Developers OAuth 2.0 Playground. Se non hai tenuto la scheda aperta, puoi reinizializzare la sessione con l'URL che hai salvato in precedenza (facendo clic su OK sull'avviso visualizzato). Oppure puoi impostare nuovamente la chiamata compilando tutti i campi pertinenti, assicurandoti che assomiglino agli screenshot seguenti:
Assicurarsi che la configurazione ha il tuo cliente ID e segreto del cliente
Sotto il passaggio 2 all'interno del parco giochi di google oauth dovresti avere il tuo token di accesso compilato
Dovrebbe avere ancora il token di prima oppure puoi compilarlo dall'esercizio precedente in questo modo:
Sotto il passaggio 3 all'interno del parco giochi OAuth 2 di Google Developers fai clic Aggiungi intestazioni, inserisci i valori di seguito, quindi fai clic su Aggiungi ed Chiudi
Header name: Accept
Header value: application/vnd.orcid+xml
Sotto il passaggio 3: Configura richiesta a API, impostato Metodo HTTP a INVIARE.
Nel Richiedi URI campo inserisci:
https://api.sandbox.orcid.org/v3.0/[ORCID ID]/education
Sostituire [ORCID ID] con il iD per il tuo record Sandbox, formatta XXXX-XXXX-XXXX-XXXX con cui hai raccolto l'autorizzazione per interagire.
Clicchi Content-type > Custom ed entra
application/vnd.orcid+xml
Clicchi Aggiungi, quindi fare clic Chiudi.
Clicchi Inserisci il corpo della richiesta.
Copia l'XML di affiliazione all'istruzione nella parte superiore di questa sezione e incollalo nel file Ente di richiesta casella di testo:
OPZIONALE: Nel Ente di richiesta casella di testo, modificare l'XML per riflettere la propria istituzione. Per , utilizzare il Registro ROR per trovare il ROR ID per il tuo istituton.
Clicchi Chiudi.
Clicchi Invia la richiesta.
I risultati appariranno nel Richiedere risposta section on the right. Scroll to the bottom of the response – if you see HTTP/1.1 201 creato, la tua affiliazione scolastica è stata aggiunta correttamente! Di seguito puoi vedere un estratto di un esempio di come apparirà l'XML con il messaggio 201 creato in basso.
... <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
Si prega di salvare il codice put che sarà richiesto nella sezione successiva per aggiornare gli articoli!
Salva il tuo codice put
I codici put sono codici numerici brevi che fanno riferimento a un particolare articolo sul ORCID record.
Quando pubblichi un articolo nel record di un ricercatore, la risposta dell'API conterrà il codice di inserimento per quell'articolo. Puoi memorizzare il codice put per usarlo in seguito se devi leggere, aggiornare o eliminare quell'elemento.
Nell'esempio sopra il codice put sono le 5 cifre alla fine di questa riga: Posizione: http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971
Se c'è un errore nella tua risposta, controlla che non ci siano errori di battitura nei tuoi tag XML e che tu abbia inserito correttamente tutti gli altri dettagli. Il minimo errore di battitura può rompere tutto!
Visita la visualizzazione pubblica del tuo record Sandbox su https://sandbox.orcid.org/[ORCID ID] per vedere la tua nuova affiliazione all'istruzione.
Si noti che Source mostra il nome del client API che ha aggiunto l'affiliazione: questo è un elemento chiave che aiuta altri sistemi a consumare ORCID i dati determinano se questa informazione è autorevole.