Avis important : Le ORCID Le registre est actuellement indisponible pendant que nous mettons à niveau notre matériel. Nous prévoyons que tous les services seront de nouveau en ligne au plus tard à 2 heures UTC. Nous nous excusons pour tout inconvénient.

Connecter la recherche et les chercheurs

Vous êtes ici: Page d'accueil / Mains sur le ORCID API / 3. Écrivez à un ORCID enregistrement (POST)

étapes 3 5 (de XNUMX)

3. Écrivez à un ORCID enregistrement (POST)

Toutes nos félicitations! Vous avez tout configuré et collectez les identifiants et les autorisations - maintenant pour la partie amusante ! Dans cette leçon, vous apprendrez à écrire des données dans un ORCID record.

Dans cette section, nous ajouterons une affiliation "éducation" à votre enregistrement Sandbox.

Dans l'exemple suivant, nous utilisons le point de terminaison /education avec le XML correct pour ajouter l'information, mais vous pouvez tout aussi bien ajouter Emploi ou Travail par exemple. Voir notre Documentation Github pour plus d'exemples de fichiers et de points de terminaison et les autorisations dont vous avez besoin pour chacun.

Voici un exemple de fichier XML pour l'éducation que vous pouvez utiliser pour cet exercice :

<?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>

Revenez à l'onglet du navigateur pour Google Developers OAuth 2.0 Playground. Si vous n'avez pas laissé l'onglet ouvert, vous pouvez réinitialiser la session avec l'URL que vous avez enregistrée précédemment (en cliquant sur OK sur l'avertissement qui s'affiche). Ou vous pouvez configurer à nouveau l'appel en remplissant tous les champs pertinents, en vous assurant qu'ils ressemblent aux captures d'écran ci-dessous :

Assurez-vous que le paramétrage a votre client ID et secret client

Au-dessous de l'étape 2 dans le terrain de jeu google oauth, vous devriez avoir votre jeton d'accès rempli
Il devrait toujours avoir le jeton du précédent ou vous pouvez le remplir à partir de l'exercice précédent comme ceci :

Image montrant une capture d'écran de Google Developers Outh 2.0 Playground avec le texte suivant : Étape 1 Sélectionner et autoriser les API Étape 2 Échanger le code d'autorisation pour les jetons Une fois que vous avez obtenu le code d'autorisation de l'étape 1, cliquez sur le bouton Échanger le code d'autorisation pour les jetons, vous obtiendrez un refresh et un jeton d'accès requis pour accéder aux ressources protégées par OAth. Code d'autorisation : Code d'autorisation Échanger le code d'autorisation pour les jetons Actualiser le jeton : Actualiser le jeton Jeton d'accès : • Actualiser automatiquement le jeton avant qu'il n'expire. Actualiser le jeton d'accès Remarque : OAuth Playground révoquera automatiquement les jetons d'actualisation après 24h. Vous pouvez éviter cela en spécifiant vos propres informations d'authentification d'application à l'aide du panneau de configuration.


Sous l'étape 3 dans le terrain de jeu Google Developers OAuth 2, cliquez sur Ajouter des en-têtes, entrez les valeurs ci-dessous, puis cliquez sur Ajouter et Fermer

Header name: Accept

Header value: application/vnd.orcid+xml

Sous l'étape 3 : Configurer nécessaire à API, ensemble Méthode HTTP à POSTER.

Capture d'écran du terrain de jeu OAuth 2 de Google Developers montrant les informations suivantes : Étape 3 Configurer la requête vers l'API Construisez votre requête HTTP en spécifiant l'URI, la méthode HTTP, les en-têtes, le type de contenu et le corps de la requête. Cliquez ensuite sur le bouton « Envoyer la demande » pour lancer la requête HTTP. Méthode HTTP : POST Ajouter des en-têtes

Dans le URI de la demande champ saisir :

https://api.sandbox.orcid.org/v3.0/[ORCID ID]/education


Remplacer [ORCID ID] avec le iD pour votre enregistrement Sandbox, formatez XXXX-XXXX-XXXX-XXXX avec lequel vous avez obtenu l'autorisation d'interagir.

Cliquez Type de contenu > Personnalisé et entrez 

application/vnd.orcid+xml

Cliquez Ajouter, puis clique Fermer.

Cliquez Saisir le corps de la demande.

Copiez le fichier XML d'affiliation scolaire en haut de cette section et collez-le dans le Corps de la demande zone de texte:

OPTION: Dans le Corps de la demande zone de texte, modifiez le XML pour refléter votre institution. Pour , Utilisez le Registre RDR pour trouver le ROR ID pour votre institutn.

Cliquez Fermer.

Cliquez Envoyez la demande.

Les résultats apparaîtront dans le Demande de réponse partie à droite. Faites défiler vers le bas de la réponse – si vous voyez HTTP/1.1 201 Créé, votre affiliation scolaire a été ajoutée avec succès ! Ci-dessous, vous pouvez voir un extrait d'un exemple de la façon dont le XML apparaîtra avec le message 201 créé en bas. 

... <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

Veuillez enregistrer votre code de mise, il sera nécessaire dans la section suivante pour mettre à jour les éléments ! 

Enregistrez votre put-code

Les codes Put sont des codes numériques courts qui font référence à un élément particulier sur le ORCID record.

Lorsque vous publiez un élément dans l'enregistrement d'un chercheur, la réponse de l'API contiendra le code put de cet élément. Vous pouvez stocker le code put pour l'utiliser plus tard si vous avez besoin de lire, mettre à jour ou supprimer cet élément.

Dans l'exemple ci-dessus, le code put est les 5 chiffres à la fin de cette ligne : Emplacement : http://api.sandbox.orcid.org/v3.0/0000-0002-4456-8947/education 26971

S'il y a une erreur dans votre réponse, vérifiez qu'il n'y a pas de fautes de frappe dans vos balises XML et que vous avez correctement saisi tous les autres détails. La moindre faute de frappe peut tout casser !

Visitez la vue publique de votre enregistrement Sandbox sur https://sandbox.orcid.org/[ORCID ID] pour voir votre nouvelle affiliation scolaire.

Notez que Source affiche le nom du client API qui a ajouté l'affiliation - c'est un élément clé qui aide les autres systèmes à consommer ORCID données déterminent si cette information fait autorité.

Étapes de ce tutoriel