introduccion tecnica de la api - 2015 espana seminario tecnico

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

[email protected] 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


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


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


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


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


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


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


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.


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


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


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


permiso concedido

orcid.org

usuario: •  autoriza la conexión

sistema: •  recibe un código de

autorización y el ORCID iD del usuario


intercambia el código

orcid.org

usuario: ninguna

sistema: •  cambia el código de autorización por un access token


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


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


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


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


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 [email protected]


introduccion tecnica de la api - 2015 espana seminario tecnico

Government & Nonprofit