Post on 15-Jul-2015
orcid.org Contact Info: p. +1-301-922-9062 a. 10411 Motor City Drive, Suite 750, Bethesda, MD 20817 USA
introducción técnica de la API ORCID workshop técnico, España
2015 enero 27 angel montenegro
a.montenegro@ost.ORCID.org http://orcid.org/0000-0002-7869-831X
Contact Info: p. +1-301-922-9062 a. 10411 Motor City Drive, Suite 750, Bethesda, MD 20817 USA orcid.org
la API de ORCID
orcid.org
• autenticar: obtener un identificador ORCID de un usario autenticado
• leer: leer la información pública y limitada • añadir: publicar nuevos items* en el registro • actualizar: actualizar o borrar items* que previamente
habías añadido
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
*publicaciones, subvenciones, afiliaciones o información biográfica
integración con universidades
orcid.org
ORCID se enlaza cuando... • cuando hay nuevas facultades o estudiantes – se facilita la
creación de iDs • al finalizar una tesis – se añade el iD a la publicación y la
publicación se agrega al record ORCID • cuando un sistema o repositorio actualiza tu perfil – se
sincronizan las actividades del investigador entre los dos sistemas • reportes y evaluaciones – se sincronizan las actividades del
investigador entre los dos sistemas
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
members.orcid.org/research-organizations
integración con otros sistemas
orcid.org
sistemas de información o de perfiles: • se facilita la creación de iDs • guarda y muestra el iD del investigador en su sistema • sincroniza la información biográfica entre los sistemas • sincroniza las actividades del investigador entre los dos
sistemas
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
members.orcid.org/research-organizations
integración con otros sistemas
orcid.org
• repositorios – DSpace 5 objetivos: • asegurarse de que el ORCID iDs ha sido asociado a las nuevas
publicaciones • efectúa eficientemente la actualización por lotes con un
identificador de autor no ambiguo • repositorios – DSpace 5 características:
• añade o actualiza autores por medio de búsqueda y realiza actualizaciones por lotes por medio de archivos csv
• enlaza ORCID iDs y nombres alternativos a la metadata de los autores
• soporta authority key para ORCID
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
wiki.duraspace.org/display/DSDOC5x/ORCID+Integration
integración con agencias de financiación
orcid.org
• aplicaciones: recoge el iD de los aplicantes y su información biográfica
• revisión: recoge el iD y la información biográfica del revisor así como su lista de actividades
• premios y reconocimientos: actualiza los registros de orcid del premiado y el revisor
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
members.orcid.org/funders
integración con los editores
orcid.org
• envío: obtiene el iD y la información biográfica del autor • revisión: obtiene el iD y la información biográfica del
revisor, así como su lista de actividades • producción: incluya el iD en la metadata de la
publicación así como en el documento • publicación: actualice el record de ORCID del autor y el
revisor
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
members.orcid.org/publishers
API tecnologías
orcid.org
• REST: interactúa con el API por medio de llamados HTTP
• OAuth: proceso de autenticación de 3 pasos • XML / JSON: formatos utilizados para el
intercambio de datos
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
el mensaje XML de ORCID
orcid.org
tiene 4 partes: • <orcid-identifier> y <orcid-history>:
información generada por el sistema sobre el registro • <orcid-bio>: información personal sobre el investigador • <orcid-activities>: información sobre el investigador
que incluye publicaciones, subvenciones, vida laboral y educación versiones:
• trabaja en la versión 1.2 • nuevas funcionalidades en release candidates
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
github.com/ORCID/ORCID-Source/blob/master/orcid-model/src/main/resources/README.md
privacidad del usario
orcid.org
la información en el registro ORCID posee diferentes niveles de privacidad, los cuales pueden ser modificados por el dueño del registro. la información del registro (configuración, permisos) es accedida por el dueño del mismo.
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
creando registros con el API
orcid.org
creando bajo demanda • se envía un email pidiéndole registrarse y obtener un
ORCID iD • al presionar el link, el investigador es enviado a la pagina de
registro de ORCID • el usuario crea un nuevo registro ORCID • le concede permisos para agregar información a su registro • el usuario es re direccionado a un sitio que usted define
previamente
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
conectándose con el API
orcid.org
como se añaden actividades al record ORCID • solicite permisos al autor • el autor otorga permisos, su sistema obtiene un código • su sistema intercambia el código por un access token
• utilizando el access token, se lee el record ORCID del autor para proveer información en tu sistema
• el autor selecciona las actividades a añadir • su sistema agrega las actividades al record del autor
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
solicite permisos al autor
orcid.org
usuario: • sigue un link para conectar tu sistema a su registro
ORCID sistema:
• envía al usuario a la URL de autorización
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
permiso concedido
orcid.org
usuario: • autoriza la conexión
sistema: • recibe un código de
autorización y el ORCID iD del usuario
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
intercambia el código
orcid.org
usuario: ninguna
sistema: • cambia el código de autorización por un access token
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
curl -i -L -H 'Accept: application/json' --data 'client_id=0000-0002-9189-9909&client_secret=719b5c31-5681-4dce-a317-ff1bc1e94277&grant_type=authorization_code&code=GU0yrC&redirect_uri=https://developers.google.com/oauthplayground' 'https://api.qa.orcid.org/oauth/token' -k HTTP/1.1 200 OK {"access_token":"0a3ac65f-f8a7-4257-b605-aff0ab37d464", "token_type":"bearer", "refresh_token":"16d75d2d-bb75-4087-8a01-685e5f03faf8", "expires_in":631138518, "scope":"/orcid-profile/read-limited", "orcid":"0000-0003-4153-0078”}
lee el record ORCID
orcid.org
usuario: ninguna
sistema: • usa el access token para leer el registro del usuario • muestra información sobre lo que está en el registro
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
HTTP/1.1 200 OK <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <orcid-message xmlns="http://www.orcid.org/ns/orcid"> <message-version>1.2_rc3</message-version> <orcid-profile type="user"> <orcid-identifier> <uri>http://qa.orcid.org/0000-0003-4153-0078</uri> <path>0000-0003-4153-0078</path> <host>qa.orcid.org</host> </orcid-identifier> …
el autor decide que añadir
orcid.org
usuario: selecciona items para añadir a su registro ORCID sistema: usa el access token para publicar información
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
el registro está actualizado
orcid.org PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
recursos
orcid.org
pasos técnicos para la integración • conseguir credenciales para el sitio de pruebas sandbox
- sandbox.orcid.org • formalizar una integración en sandbox
• trabajar con el personal de ORCID para probar la integración en sandbox
• lanzar su integración en el registro en vivo de ORCID
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
recursos
orcid.org
pasos no técnicos • educar a tus investigadores sobre ORCID
• publicar artículos y notas internas sobre ORCID • usar el logo de ORCID en tus páginas web • compartir material promocional • alojar workshops
• educar a los administradores sobre ORCID • crear documentación para tu integración • publicitar la integración cuando esta sea completada
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611
recursos
orcid.org
• empezar con la guía de la API���http://support.orcid.org/knowledgebase/articles/180285
• ORCID knowledge base • guías generales: http://support.orcid.org/knowledgebase/topics/32828 • tutoriales detallados: http://support.orcid.org/knowledgebase/topics/32831
• grupo de usuarios de la API de ORCID ���https://groups.google.com/forum/#!forum/orcid-api-users
• comprobar otras integraciones���https://orcid.org/organizations/integrators/current
• Soporte en ORCID ���http://support.orcid.org o support@orcid.org
PHOTO: electronic circuit board www.flickr.com/photos/creative_stock/5227842611