Implementación: Visión general de la API e integraciones recomendadas - Presentación
Angel Montenegro, Ingeniero de Software de ORCID
* Universidades : Creación/actualización de registros, validación de las afiliaciones, diferentes momentos clave en la trayectoria del investigador (lectura de la tesis, nuevo personal y estudiantes, enlaces con el directorio de personal, interacciones con los sistemas de gestión de la información)
* Repositorios: Vista general del soporte DSpace para ORCID
* Agencias de financiación: Captura de identificadores durante la aplicación, intercambio de datos con las plataformas de CV, elaboración de informes, actualización de registros de investigadores
* Editores: Captura de identificadores durante la revisión, incrustación de identificadores en documentos, actualización de registros de investigadores
Introduccion tecnica de la api - 2015 espana seminario tecnico
1. 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
2. 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
3. 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
4. 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
5. 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
6. 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
7. 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
8. 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
9. 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
10. 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
11. 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
12. 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
13. 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
14. 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
15. 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”}
16. 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>
…
17. 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
18. el registro está actualizado
orcid.org
PHOTO: electronic circuit board
www.flickr.com/photos/creative_stock/5227842611
19. 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
20. 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
21. 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